Códigos de error de GRBL
Qué significan error:N y alarm:N y cómo borrarlos.
Lo que ves
El panel Console muestra error:N o alarm:N, donde N es un número. La máquina se niega a moverse (alarma) o se negó a aceptar un comando específico (error).
Qué está sucediendo
GRBL tiene respuestas estructuradas de error y alarma. El número es un código que identifica exactamente qué salió mal.
Códigos de error comunes
| Código | Significado | Solución común |
|---|---|---|
error:1 | Se esperaba una letra de comando | Sintaxis de G-code incorrecta. Por lo general, es un error de Beam Bench; repórtalo. |
error:2 | Formato de número incorrecto | Lo mismo. |
error:3 | Comando $ no válido | Envía un comando $ válido. |
error:9 | G-code bloqueado durante una alarma | Borra primero la alarma ($X o Unlock en el panel Move). |
error:15 | El desplazamiento excede el límite suave | El desplazamiento indicado sale del área de trabajo de la máquina (según $130-$132). Comprueba el tamaño de tu proyecto y las dimensiones del área de trabajo de la máquina. |
error:20 | Comando no compatible | El firmware no reconoce ese G-code. Usa un subconjunto compatible con Beam Bench. |
error:22 | Velocidad de avance no establecida | El primer desplazamiento no tenía un valor F. Por lo general, es un error de Beam Bench; repórtalo. |
error:24 | Desplazamiento sin Y | Lo mismo. |
Códigos de alarma comunes
| Código | Significado | Solución común |
|---|---|---|
alarm:1 | Se activó el límite físico | Se activó un interruptor de límite. Aleja el cabezal manualmente y luego selecciona Unlock. |
alarm:2 | El objetivo de movimiento del G-code excede el desplazamiento de la máquina | El trabajo pasó el límite del área de trabajo. Vuelve a encuadrar dentro de los límites. |
alarm:3 | Restablecimiento durante el movimiento | Se produjo un restablecimiento parcial durante el desplazamiento. La posición es incierta; vuelve a hacer home antes de continuar. |
alarm:8 | Falló el homing: el desplazamiento de retirada no logró liberar el interruptor | Un interruptor de límite está atascado o cableado incorrectamente. Inspecciona los interruptores. |
alarm:9 | Falló el homing: no se pudo encontrar el interruptor de límite | El cabezal no llegó a un interruptor de límite dentro de la distancia de homing. Comprueba el cableado de los interruptores, la dirección de homing ($23) y que $132 esté configurado correctamente. |
Solución
Borrar una alarma
En el panel Move, selecciona Unlock cuando la máquina esté en estado de alarma. Esto envía $X a GRBL.
También puedes enviar $X manualmente en el panel Console.
Después de desbloquear, haz home antes de ejecutar cualquier cosa. La máquina ya no confía en su posición.
Encontrar el significado completo de un código que no aparece arriba
El código fuente de GRBL documenta todos los códigos de error y alarma. Busca "GRBL error codes" en línea para consultar la referencia completa correspondiente a tu versión del firmware.
Alarmas repetidas durante el uso normal
Sugieren un problema mecánico o de cableado: un interruptor de límite defectuoso, límites suaves configurados incorrectamente o un motor que se atasca y el controlador lo detecta.
¿Sigues atascado?
- Panel Connection Diagnostics: tráfico y eventos recientes.
- Panel Console: envía
$$para consultar la configuración actual. - Fundamentos de GRBL: repaso de conceptos.
- Referencia de configuración con signo de dólar.
- Publica en el grupo de Facebook el código exacto y el registro reciente.