‼️Marlin Troubleshooting
Errores comunes en Marlin: mensajes de error, problemas de compilación, fallos de comportamiento y cómo solucionarlos.
English: Use your browser's built-in translation — Chrome and Edge detect the language automatically and offer to translate the page.
Aquí encontrarás los problemas más frecuentes al compilar, flashear o usar Marlin, junto con sus causas y soluciones.
Errores de compilación
#error MOTHERBOARD value is not valid
El valor de MOTHERBOARD en Configuration.h no existe
Busca tu placa en Marlin/src/core/boards.h y usa el valor correcto
#error "Serial port..." is not available
Puerto serial incorrecto para la placa
Revisa SERIAL_PORT en Configuration.h — muchas placas STM32 usan -1 para USB nativo
region 'flash' overflowed
El firmware compilado no cabe en la flash de la placa
Desactiva funciones no necesarias o usa un entorno con más flash (ej: STM32F407VG en vez de STM32F103)
#error "NOZZLE_PARK_FEATURE is required..."
Función dependiente no habilitada
Lee el mensaje de error: indica qué #define habilitar para resolverlo
Cannot open source file "..."
Librería de PlatformIO no descargada
Ejecuta PlatformIO: Clean y vuelve a compilar para que descargue dependencias
Errores al flashear
Puerto COM no aparece
Driver no instalado o cable sin datos
Instala el driver CH340/CP2102 según el chip USB de tu placa; usa cable USB con datos (no solo carga)
avrdude: verification error
Flash incorrecta o protegida
Verifica que el .hex corresponde al procesador correcto (mega2560 ≠ mega1280)
Firmware flasheado pero impresora no arranca
Bootloader corrupto o configuración errónea
Reflashea el bootloader con un programador externo o verifica MOTHERBOARD
Pantalla en blanco tras actualización
Cambio en el protocolo de comunicación o reset EEPROM necesario
Envía M502 + M500 para resetear la EEPROM a valores por defecto
Problemas de comportamiento
Eje se mueve en dirección contraria
INVERT_X_DIR (o Y/Z/E) incorrecto
Cambia el valor true/false del eje correspondiente en Configuration.h
El homing no para / activa el endstop al revés
Lógica de endstop invertida
Cambia X_HOME_DIR o usa #define ENDSTOPPULLUP_XMIN según el tipo (NO/NC)
Printer halted. kill() called
Error crítico de temperatura o protección activada
Revisa los valores de TEMP_SENSOR_* y las protecciones THERMAL_PROTECTION_*
Temperatura errática o -14°C constante
Termistor mal configurado o desconectado
Verifica TEMP_SENSOR_0 — el valor debe coincidir con el termistor instalado
Heating failed al calentar
Calefactor no llega a temperatura en tiempo
Ajusta WATCH_TEMP_INCREASE y WATCH_TEMP_PERIOD o revisa la resistencia del heater
Steps/mm incorrectos tras actualización
EEPROM con valores viejos
Envía M502 para cargar los del firmware y M500 para guardarlos
Probing Failed durante G29
Sonda no alcanza el punto de sondeo
Ajusta X_PROBE_OFFSET_FROM_EXTRUDER / Y_PROBE_OFFSET_FROM_EXTRUDER o los límites de sondeo
Ventilador de capa no responde a M106
EXTRUDER_AUTO_FAN o pin incorrecto
Verifica FAN_PIN en los pins de tu placa; revisa si está controlado por EXTRUDER_AUTO_FAN
ABL/BLTouch no despliega la sonda
Pin de control incorrecto
Verifica SERVO0_PIN o Z_PROBE_PIN en el fichero pins de tu placa
Impresión se desplaza en capas (layer shift)
Corriente de driver insuficiente o sobrecalentamiento
Ajusta #define X_CURRENT en Configuration_adv.h; mejora la ventilación de los drivers
Problemas con la pantalla
Pantalla en blanco (retroiluminación encendida)
Encoder o tipo de pantalla incorrecto
Verifica LCD_LANGUAGE, DISPLAY_CHARSET_HD44780 y el modelo en Configuration.h
Pantalla TFT muestra "No printer attached"
Baudrate incorrecto o SERIAL_PORT_2 no configurado
Ajusta BAUDRATE a 115200 y habilita SERIAL_PORT_2 para la TFT
Menú de nivelación no aparece
Función no compilada
Habilita LCD_BED_LEVELING en Configuration.h
Herramientas de diagnóstico
Pronterface es la herramienta más cómoda para diagnosticar: conecta via USB, envía gcodes y ve los mensajes de respuesta en tiempo real. Más info en la guía de Pronterface.
Guías específicas de esta sección
PronterfaceControl de ventiladores con MOSFET externoReparar pin sensor temperaturaÚltima actualización