M-命令

M0：停止或无条件停止

语法

M0 [P<ms>] [S<sec>] [string]

参数

该命令可以在没有任何附加参数的情况下使用。

• P<ms>:过期时间，以毫秒为单位
• S<sec>:过期时间，以秒为单位
• string:显示消息到LCD上，M1为必须参数，M0为可选参数。

例子

M0

M1：睡眠或条件停止

语法

M0 [P<ms>] [S<sec>] [string]

参数

该命令可以在没有任何附加参数的情况下使用。

• P<ms>:过期时间，以毫秒为单位
• S<sec>:过期时间，以秒为单位
• string:显示消息到LCD上，M1为必须参数，M0为可选参数。

例子

M1 S5 

将等待 5 秒并在 LCD 状态行中显示“Waiting for user…”，与M0 S5命令相同。

M1 Hello world

在 LCD 状态行中显示“Hello world”，并等待用户按下 LCD 旋钮。

M17：启用/为所有步进电机供电

语法

参数

该命令可以在没有任何附加参数的情况下使用。

• X：X轴
• Y：Y轴
• Z：Z轴
• E：所有挤出机

例子

M17
M17 X E0

开启步进电机。

M20 - SD 卡文件列表

语法

M20 [ L | T ]

参数

该命令可以在没有任何附加参数的情况下使用。

• L：报告长文件名，而不仅仅是短文件名。需要主机软件解析（Cap:EXTENDED_M20）。
• T：报告时间戳。该值是一个编码为十六进制的 uint32_t。需要主机软件解析（Cap:EXTENDED_M20）。

例子

M20
M20 S2 P"/gcodes/subdir"
M20 L
M20 T

此代码将SD卡根文件夹或G代码目录中的所有文件列出到串口。每行一个名称，例如：

SQUARE.G 
SQCOM.G 
ZCARRI~2.GCO 
CARRIA~1.GCO

请注意，文件列表响应通常是封装的。RepRapFirmware 的标准配置在仿真模式下模仿这种风格：

Begin file list:
SQUARE.G
ZCARRI~2.GCO
End file list
ok

文件大小（以字节为单位）的整数可以附加在文件名后面：

Begin file list:
SQUARE.G 1234
ZCARRI~2.GCO 234
End file list 
ok

OctoPrint 还支持在大小之后显示文件长名称（另见 M33）的附加格式：

Begin file list:
SQUARE.G 1234 SQUARE.G
ZCARRI~2.GCO 234 ZCARRIAGE_V2.GCO
End file list 
ok

注意

如果在 RepRapFirmware 上使用 S2 参数，则文件列表（或可以在输出缓冲区中安装的尽可能多的文件）以 JSON 格式作为名为“files”的单个数组返回，每个名称对应于前面的子目录一个星号，目录在变量“dir”中返回。可选的 R 参数是要开始的文件编号，默认为 0。JSON 响应还返回值“next”，这是未返回的第一个文件的编号，如果返回所有文件，则返回 0。即使有很多文件，调用者也可以枚举所有文件，方法是通过使用前一个响应中的“下一个”值中的 R 进行连续的 M20 S2 调用，每次调用都使用 R，util“下一个”为零。

例子

M20 L

Begin file list
TEST1.GCO 1234 "TEST1.GCO"
DIR_ENTER: /TESTFO~1/ "test folder"
DIR_EXIT
LFNFIL~1.GCO 56789 "LFN file.gcode"
End file list

M20 L T

Begin file list
TEST1.GCO 1234 0x52936b00 "TEST1.GCO"
DIR_ENTER: /TESTFO~1/ "test folder"
DIR_EXIT
LFNFIL~1.GCO 56789 0x52936b08 "LFN file.gcode"
End file list

M20 T

Begin file list
TEST1.GCO 1234 0x52936b00
DIR_ENTER: /TESTFO~1/ "test folder"
DIR_EXIT
LFNFIL~1.GCO 56789 0x52936b08
End file list

M21：初始化 SD 卡

语法

参数

• Pnnn：SD 卡号（仅限 RepRapFirmware，默认为 0）

例子

M21 
M21 P1

初始化指定的 SD 卡。如果在机器开机时加载了 SD 卡，则默认情况下会发生这种情况。必须初始化 SD 卡才能使用其他 SD 功能。

Marlin 2.0.9.4 添加了分别安装 SD 卡或 USB 驱动器的参数S与U

M22：释放 SD 卡

M23：选择 SD 文件

语法

M23 [filename]

例子

M23 filename.gco

指定为 filename.gco 的文件（支持 8.3 命名约定）被选中准备打印。RepRapFirmware 支持长文件名以及 8.3 格式。

M24：开始/恢复SD打印

M25：暂停SD打印

M26：设置 SD 位置

将 SD 卡文件中的位置设置为以字节为单位的索引。该命令预计在 M23 之后和 M24 之前调用。否则此命令的效果是不确定的。

语法

M26 [ S ]

参数

• Snnn从文件开头开始的文件位置（以字节为单位）

例子

M26 S49315

设置从 M23 选择的 SD 卡文件开始的文件偏移量（以字节为单位）。偏移量必须对应于 G 代码命令的开始。

M27：获取 SD 打印状态

语法

M27 [ C ]

参数

• C报告打开文件的名称和长名称（Marlin 1.1.9 及更高版本）
• Sn设置自动报告间隔（Marlin 1.1.9 及更高版本）

例子1

发送命令

M27

报告 SD 打印状态。

返回的消息

Marlin 和 RepRapFirmware 报告以这种格式处理的字节数，可以由 Pronterface 处理：

SD printing byte 2134/235422

如果没有文件正在打印，则仅报告此消息：

Not SD printing.

例子2

在 Marlin 1.1.9 及更高版本中，M27 C报告打开文件的 DOS 8.3 名称和长文件名（如果有）。

发送命令

M27 C

返回消息

Current file: filena~1.gco Filenagotcha.gcode

例子3

在 Marlin 1.1.9 及更高版本M27 Sn中设置自动报告间隔。这需要AUTO_REPORT_SD_STATUS启用配置选项。M115当Cap: AUTO_REPORT_SD_STATUS 1此选项可用时 ，Marlin 会报告此功能。

M27 S2 ; 每 2 秒报告一次 SD 卡状态

M910：TMC2130 初始化

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

M911：设置 TMC2130 保持电流

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

语法

M911 [ X | Y | Z | E ]

参数

• X:X 步进驱动器保持电流值
• Y:Y 步进驱动器保持电流值
• Z:Z 步进驱动器保持电流值
• E:挤出机步进驱动器保持电流值

M912：设置 TMC2130 运行电流

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

语法

M912 [ X | Y | Z | E ]

参数

• X:X 步进驱动器运行电流值
• Y:Y 步进驱动器运行电流值
• Z:Z 步进驱动器运行电流值
• E:挤出机步进驱动器运行电流值

M913：打印 TMC2130 电流

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。显示 TMC2130 电流。

M914：设置 TMC2130 正常模式

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

M915：设置 TMC2130 静音模式

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

M916：设置 TMC2130 Stallguard 灵敏度阈值

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

语法

M916 [ X | Y | Z | E ]

参数

• X:X 步进驱动器失速保护灵敏度阈值
• Y:Y 步进驱动器失速保护灵敏度阈值
• Z:Z 步进驱动器失速保护灵敏度阈值
• E:挤出机步进驱动器失速保护灵敏度阈值

M917：设置 TMC2130 PWM 幅度偏移 (pwm_ampl)

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

语法

M917 [ X | Y | Z | E ]

参数

• X:X 步进驱动器PWM 幅度偏移值
• Y:Y 步进驱动器PWM 幅度偏移值
• Z:Z 步进驱动器PWM 幅度偏移值
• E:挤出机步进驱动器PWM 幅度偏移值

M918: 设置 TMC2130 PWM 幅度梯度 (pwm_grad)

默认情况下不活动，仅当

TMC2130_SERVICE_CODES_M910_M918

在源代码中定义。

语法

M918 [ X | Y | Z | E ]

参数

• X:X 步进驱动器PWM幅度梯度值
• Y:Y 步进驱动器PWM幅度梯度值
• Z:Z 步进驱动器PWM幅度梯度值
• E:挤出机步进驱动器PWM幅度梯度值