Códigos de error de WLED: qué significan los errores 7, 8, 9, 12, 19 y 91 y cómo solucionarlos
Todos los códigos de error de WLED, del 1 al 101: qué significa cada mensaje, qué lo provoca en el firmware y cómo arreglarlo. Además, 'issue loading your presets'.
Escrito por Jamie Conde, que desarrolla WLED Max en MeowScript. WLED Max es una app independiente, no está afiliada al proyecto oficial WLED ni cuenta con su respaldo.
WLED muestra los errores como un aviso rojo corto en la parte de abajo de la página web, como Error 8: Effect RAM depleted! El número viene de una lista del firmware (wled00/const.h), y el texto que lo acompaña es toda la explicación que recibes. Esta página recorre cada código de esa lista, qué lo provoca de verdad y qué hacer al respecto.
Primero van los códigos que más se buscan. La tabla completa está más abajo.
El aviso aparece una sola vez. WLED le entrega el error a la primera página o app que le pide su estado a la luz, y luego lo borra. Si Home Assistant o una app del móvil está consultando la luz, puede llevarse el error primero, y tu navegador nunca lo muestra. Recarga la página justo después de que ocurra el problema si quieres ver el código.
Error 7: No RAM for buffer
Solo WLED 16. La luz intentó reservar memoria para los píxeles de un segmento y no había suficiente. Entonces WLED apaga ese segmento, y por eso la gente suele describirlo como “mi segmento desapareció”.
Qué lo causa:
- Demasiados LED para el chip, normalmente un ESP8266 o una matriz 2D grande.
- Muchos segmentos, cada uno con su propio búfer.
- Una imagen o un GIF en una matriz 2D, en compilaciones que pueden reproducirlos. Las imágenes también necesitan memoria.
La solución: baja la cantidad de LED, une los segmentos que no necesitas o pasa las instalaciones grandes a un ESP32. Las placas con PSRAM (muchas placas ESP32-S3 y los módulos ESP32 WROVER) tienen mucho más espacio, porque WLED 16 pone los búferes de píxeles en la PSRAM cuando puede.
Error 8: Effect RAM depleted
WLED 0.15 y 16. Un efecto pidió memoria de trabajo (el espacio temporal que usan efectos como Fire 2012 o los efectos de partículas) y no la obtuvo. WLED limita la memoria total de efectos entre todos los segmentos (en 0.15 en todas las placas, en 16 solo en placas sin PSRAM), así que un efecto pesado en cada uno de varios segmentos puede llegar al límite aunque la luz parezca inactiva.
WLED 16 usa el mismo código para dos situaciones más, y conviene conocer las dos:
- La memoria se mantuvo baja durante 15 segundos. WLED cambia todos los segmentos a Solid para liberar memoria y muestra el error 8. Si la memoria sigue baja a los 30 segundos, elimina todos los segmentos menos uno, y a los 45 segundos reconstruye la tira LED desde cero y vuelve a conectar el Wi-Fi.
- Una salida de LED necesita más memoria de la que WLED permite. Esa salida se añade como marcador de posición, así que sus LED se quedan apagados. Ves el error 8 después de guardar la configuración de LED.
La solución: usa efectos más ligeros (Solid, Solid Pattern y Breathe no necesitan memoria de efectos), menos segmentos con efectos pesados al mismo tiempo o menos LED por salida. Si tus segmentos se convierten solos en Solid, casi siempre es por esto.
Error 9: JSON parsing error
Todas las versiones (el texto del aviso aparece a partir de 0.15). Algo le envió a la luz un JSON que no pudo leer, y la solicitud se rechazó con HTTP 400. No cambió nada en la luz.
Los motivos habituales:
- Comillas tipográficas. Copiaste un comando de una app de notas o de un chat, y
"se convirtió en“y”. Los iPhone lo hacen por defecto con Puntuación inteligente. Pégalo primero en un editor de texto plano o vuelve a escribir las comillas. - Una coma al final, comillas simples o un comentario. JSON no permite ninguno de ellos.
- La solicitud es demasiado grande. El búfer JSON es de unos 10 KB en ESP8266 y de 24 a 32 KB en ESP32, y un preajuste con muchos segmentos o una lista larga de colores de LED individuales puede pasarse y no poder leerse.
- En conexiones WebSocket, un mensaje que llega dividido en varios paquetes. WLED no los vuelve a unir y responde con el error 9.
Si estás escribiendo un preajuste a mano en la interfaz web, el editor de preajustes detecta casi todos estos problemas antes de que lleguen a la luz: recibes “Syntax error in custom JSON API command” en lugar del error 9.
Error 12: Preset not found
Todas las versiones. Algo le pidió a la luz cargar una ranura de preajuste que no existe. Pasa todo el tiempo después de eliminar o renumerar preajustes, porque nada en WLED actualiza lo que apunta a ellos:
- Apply preset at boot en Config›LED & Hardware (LED Preferences en 0.14 y 0.15).
- Los temporizadores, las acciones de botones y los preajustes de Alexa en Config > Time & Macros.
- Las entradas dentro de una lista de reproducción.
- Automatizaciones o scripts de Home Assistant, o un mando a distancia, que envían
{"ps":N}.
Revisa en cada uno de ellos el número de ranura del error. Si la ranura existe y sigues recibiendo el error 12, puede que el propio archivo de preajustes esté dañado; consulta “issue loading your presets” más abajo.
Más sobre los preajustes de encendido y las ranuras en Preajustes de WLED y el preajuste de encendido.
Error 19: A filesystem error has occurred
Todas las versiones. Un fallo general del sistema de archivos. En el código fuente actual viene de un solo lugar: WLED intenta crear un presets.json vacío (al arrancar, o cuando guardas un preajuste y el archivo ha desaparecido), y no se pudo escribir el archivo. En las compilaciones 0.14 y 0.15 con soporte de EEPROM también puede aparecer cuando falla la conversión de preajustes antiguos de una versión muy temprana de WLED (la época de la EEPROM).
Así que el error 19 significa que no se puede escribir en la flash. Normalmente está llena; a veces el sistema de archivos quedó dañado por un corte de luz durante una escritura.
Qué probar, en este orden:
- Guarda una copia de lo que puedas: Config > Security & Updates > Backup configuration, y Backup presets si funciona.
- Libera espacio eliminando preajustes o archivos que subiste (ledmaps, imágenes, paletas personalizadas).
- Si sigue volviendo, haz un restablecimiento de fábrica (en la misma página, marca Factory reset y guarda, lo que borra todos los ajustes y preajustes) o vuelve a flashear desde install.wled.me, y luego restaura tus copias de seguridad.
Error 91: Brownout Restart
WLED 16, solo placas ESP32. El chip se reinició porque su voltaje de alimentación bajó demasiado. WLED lee el motivo del reinicio al arrancar y muestra 91 en la siguiente carga de la página. En un ESP8266 una caída de voltaje se ve como cualquier otra pérdida de energía, así que ahí nunca verás el 91, y 0.14 y 0.15 no lo informan en absoluto.
Con tiras LED, la causa casi siempre es la alimentación:
- La fuente de alimentación es demasiado pequeña para los LED al brillo que usas. El blanco total es el peor caso.
- Cables delgados o largos entre la fuente y el controlador, así que el voltaje cae cuando los LED brillan mucho.
- El controlador se alimenta del puerto USB de un portátil o de un cargador de móvil débil.
- No hay límite de brillo configurado.
La solución: configura Maximum PSU Current (Maximum Current en 0.14) en la página de ajustes de LED para que WLED limite el brillo a lo que tu fuente puede entregar, inyecta energía en los dos extremos de los tramos largos y usa una fuente con algo de margen (aproximadamente 20% por encima de lo que calcules). Los números y las capturas están en Ajustes de WLED desde tu móvil. Si tu luz además se desconecta de la red de vez en cuando, lee también por qué WLED se desconecta.
Error 90: Unexpected Restart
WLED 16. La luz falló o su watchdog la reinició, y lo avisa después de reiniciar. No vale la pena investigar un 90 de vez en cuando.
Si falla una y otra vez, WLED 16 (y 0.15.5) interviene por su cuenta. Después de 5 fallos, cada uno a menos de dos minutos del anterior, lo trata como un reinicio en bucle e intenta, un paso por cada bucle: restaurar la última copia de seguridad buena de la configuración, luego restablecer la configuración y luego (solo ESP32) arrancar el firmware que estaba instalado antes de la última actualización. Así que si tus ajustes se ven distintos después de una serie de reinicios, es por eso.
Las causas habituales son un efecto o un módulo de usuario demasiado pesado para la placa, una configuración de LED equivocada (pines, tipo o cantidad) y problemas de alimentación que no llegan a contar como caída de voltaje. Si empezó justo después de una actualización de firmware, consulta actualizar WLED de forma inalámbrica.
“Sorry, there was an issue loading your presets!”
Este no tiene número. La interfaz web lo muestra en la pestaña Presets cuando no puede leer presets.json, ya sea porque la luz no respondió o porque el archivo ya no es un JSON válido (un corte de luz mientras se guardaba puede causarlo).
- Abre
http://<your-light-ip>/presets.jsonen un navegador. Si ves tus preajustes, el archivo está bien y fue un problema de conexión. Recarga la página. - Si el navegador que usas normalmente ya vio tus preajustes antes, el mensaje también muestra “Here is a backup of the last known good state” con un botón Copy to clipboard (y un botón Restore a partir de 0.15). Esa copia vive en el navegador, no en la luz. Cópiala primero a un lugar seguro y luego restaura.
- Si no, restaura un
presets.jsonguardado en Config > Security & Updates > Restore presets. Eso reemplaza todo el contenido del archivo.
Si te acostumbras a hacer copias de seguridad de la configuración y los preajustes, esto pasa de ser una mala noche a un arreglo de dos minutos.
Todos los códigos de error de WLED
| Código | Texto en la interfaz web | Qué significa | Versiones |
|---|---|---|---|
| 1 | Denied! | Se rechazó un cambio de ajustes porque hay un PIN de configuración y no se introdujo | todas (texto desde 0.15) |
| 2 | (ninguno) | 0.14: un código antiguo de EEPROM, sin uso. 0.15 y 16: “concurrency”, definido pero nunca generado | ninguna en la práctica |
| 3 | Buffer locked! | La luz estaba ocupada con otra solicitud JSON | todas |
| 4 | (vacío) | No implementado: una dirección /json/... que la luz no conoce, o en 16 un efecto solo 2D en una tira 1D o un efecto de partículas 1D en un segmento de un LED, o un archivo de fuente dañado para el texto en desplazamiento | 0.15, 16 |
| 7 | No RAM for buffer! | No hay memoria suficiente para los píxeles de un segmento | 16 |
| 8 | Effect RAM depleted! | No hay memoria suficiente para un efecto, o (16) memoria baja o una salida de LED demasiado grande | 0.15, 16 |
| 9 | JSON parsing error! | La luz recibió un JSON que no pudo leer | todas |
| 10 | Could not mount filesystem! | El sistema de archivos de la flash no arrancó | todas |
| 11 | Not enough space to save preset! | El sistema de archivos está lleno | todas |
| 12 | Preset not found. | Se pidió una ranura de preajuste que no existe | todas |
| 13 | Missing ir.json. | Un mando IR configurado en modo JSON envió un código, pero ir.json no está en la luz | todas |
| 14 | (ninguno) | Falta remote.json; la comprobación está comentada, así que nunca se activa | ninguna en la práctica |
| 19 | A filesystem error has occured. | Fallo general del sistema de archivos, normalmente al crear presets.json | todas |
| 30, 31, 32 | (ninguno) | Sobretemperatura, sobrecorriente, bajo voltaje. Marcados como “not implemented” en el código fuente | ninguna en la práctica |
| 33 a 37 | (ninguno) | Códigos de memoria baja definidos en 16 pero que todavía no se generan (su texto en la interfaz web está comentado) | ninguna en la práctica |
| 90 | Unexpected Restart. | La luz se reinició después de un fallo o un reinicio del watchdog | 16 |
| 91 | Brownout Restart. | La luz se reinició porque bajó su voltaje de alimentación | 16, ESP32 |
| 100 | Note 100: Please reboot WLED to activate changed settings. | Un ajuste de hardware necesita reiniciar (en 16.0.1: cambios de panel HUB75 en ESP32-S3) | 16 |
| 101 | Note 101: Please switch your device off and back on. | Un ajuste de hardware necesita apagar y encender; definido, todavía sin uso en 16.0.1 | 16 |
La interfaz web de 0.14 solo tiene texto para 10, 11, 12, 13 y 19, así que cualquier otro código aparece como “Error N:” sin nada después. Lo mismo pasa con el error 4 en versiones más nuevas. El error ortográfico de “occured” está en el firmware.
El resto, en pocas palabras
Error 1 (Denied). Definiste un PIN en Config > Security & Updates y algo intentó cambiar ajustes sin él. Introduce el PIN en la interfaz web, o en la app o el script que está escribiendo.
Error 3 (Buffer locked). WLED atiende una solicitud JSON a la vez. En 0.15, una segunda solicitud que llega mientras tanto recibe HTTP 503 con el error 3 (en 0.14 solo las lecturas; una escritura simplemente no recibe respuesta). WLED 16 hace esperar a las solicitudes HTTP, pero los clientes WebSocket todavía pueden recibir el error 3. Si lo ves a menudo, algo está consultando mucho: una integración de Home Assistant, varias pestañas del navegador abiertas y una app al mismo tiempo. Cierra lo que no necesites.
Error 10 (Could not mount filesystem). Normalmente el firmware se flasheó con la distribución de flash equivocada para la placa, o el chip de flash está fallando. Vuelve a flashear con el instalador web y deja que borre la placa primero. Pierdes los ajustes y los preajustes, así que restáuralos desde una copia de seguridad. En la práctica, un montaje fallido suele aparecer como error 19, porque WLED intenta crear presets.json de inmediato y eso también falla.
Error 11 (Not enough space). WLED solo guarda un preajuste si hay espacio para una copia completa del archivo más unos 9 KB. Un ESP8266 con muchos preajustes que guardan distribuciones de segmentos se queda sin espacio primero. Elimina los preajustes que no usas o quita los archivos subidos que ya no necesitas.
Error 13 (Missing ir.json). El receptor IR está configurado con el tipo “JSON remote” en Config > LED & Hardware (LED Preferences en 0.14 y 0.15), pero no se subió ningún ir.json. Sube uno o elige el modelo de tu mando a distancia en la lista.
Mensajes de las apps
Las apps no muestran los números de WLED. Usan sus propias palabras, y dos mensajes de WLED Max (iOS y Android) vienen directamente de estados del firmware:
- “El dispositivo está ocupado y no aceptó el cambio.” La luz siguió respondiendo con el error 3, y la app se rindió después de reintentar. Espera unos segundos y vuelve a intentarlo, y busca si hay algo más consultando la luz.
- “El dispositivo envió una respuesta inesperada. Puede que tenga una versión de firmware incompatible.” La luz respondió, pero con un error HTTP o una respuesta que la app no pudo usar. Puede ser un WLED muy antiguo, otro firmware completamente distinto o una luz que se reinició a mitad de la solicitud.
La app también revisa presets.json antes de cambiarlo. Si el archivo está dañado, no lo sobrescribe y en su lugar ofrece guardar una copia del archivo tal cual (iOS: Guardar una copia del archivo; Android: Guardar copia del archivo en el aviso, o Guardar una copia del archivo en la pestaña Preajustes).
Si la luz no responde en absoluto, es un problema de red y no un error de WLED, y La app de WLED no encuentra tus luces repasa las causas.
Preguntas frecuentes
¿Dónde está la lista de códigos de error de WLED? En wled00/const.h del código fuente de WLED, junto a los nombres ERR_. El texto de la interfaz web para cada uno está en wled00/data/index.js.
¿Un error significa que mi placa está rota? Rara vez. La mayoría de los códigos tienen que ver con memoria (7, 8), preajustes (12) o alimentación (91). Los errores 10 y 19 que siguen volviendo después de flashear de nuevo son los que apuntan al hardware.
¿Por qué el error desaparece cuando recargo? WLED borra el error después de informarlo una vez. Solo vuelve si el problema ocurre de nuevo.