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"，查詢適用於你的韌體版本的完整參考。

這通常提示機械或接線問題：限位開關故障、軟限位設定錯誤，或電機失速且控制器檢測到了這一情況。