GRBL错误代码

你看到的情况

Console panel显示error:N或alarm:N，其中N为数字。机器拒绝移动（报警），或拒绝接受特定命令（错误）。

GRBL具有结构化的错误和报警响应。这个数字是一个代码，用于标识具体出了什幺问题。

代码	含义	常见修复方法
`error:1`	应为命令字母	G-code语法错误。通常是Beam Bench的进程错误，请报告此问题。
`error:2`	数字格式错误	同上。
`error:3`	无效的`$`命令	发送有效的`$`命令。
`error:9`	报警期间G-code被锁定	先清除报警（发送`$X`，或在Move panel中点击Unlock）。
`error:15`	移动超出软限位	命令的移动超出了机器工作台范围（参见`$130-$132`）。检查项目尺寸和机器工作台尺寸。
`error:20`	不支持的命令	固件不识别该G-code。请使用Beam Bench支持的G-code子集。
`error:22`	未设置进给速度	首次移动没有`F`值。通常是Beam Bench的进程错误，请报告此问题。
`error:24`	未包含Y的移动	同上。

代码	含义	常见修复方法
`alarm:1`	触发硬限位	撞到了限位开关。手动将激光头移开，然后点击Unlock。
`alarm:2`	代码移动目标超出机器进程	作业超出了工作台边界。重新走框，确保在边界内。
`alarm:3`	移动过程中复位	移动过程中发生了软复位。位置不确定，继续前先回零。
`alarm:8`	回零失败：脱离移动未能离开限位开关	限位开关卡住或接线错误。检查限位开关。
`alarm:9`	回零失败：无法找到限位开关	激光头在回零距离内未到达限位开关。检查开关接线、回零方向（`$23`），并确认`$132`设置正确。

在Move panel中，机器处于报警状态时点击Unlock。这会向GRBL发送$X。

或者在Console panel中手动发送$X。

解锁后，在执行任何操作前先回零。机器不再信任其位置。

GRBL的源代码记录了每个错误代码和报警代码的说明。在线搜索"GRBL error codes"，查找适用于你的固件版本的完整参考。

这通常提示机械或接线问题：限位开关故障、软限位设置错误，或电机失速且控制器检测到了这一情况。