WLED Firmware OTA ESP8266 ESP32 WLED Max Guía práctica

Actualización OTA de WLED en ESP8266 y ESP02: qué .bin necesitas y por qué falla

El .bin de WLED correcto para ESP8266, ESP02 o ESP01, por qué a las placas de 2 MB les falta espacio y cómo actualizar en dos pasos si falla la OTA.

Por Publicado Actualizado el

Respuesta rápida: usa el archivo de la versión cuyo nombre coincida con la compilación que informa tu luz (el “release” de la página Info de WLED, como ESP8266, ESP02 o ESP32). En ESP8266 la imagen nueva tiene que caber entre el firmware en ejecución y el sistema de archivos, así que las placas de 2 MB (compilaciones ESP02) suelen fallar con “not enough space”. Usa el .bin.gz comprimido, o actualiza en dos pasos: primero la compilación pequeña _min y luego la completa. Las placas de 1 MB (compilaciones ESP01) no tienen actualizaciones inalámbricas. Esas necesitan un cable USB e install.wled.me.

¿Qué compilación tiene tu luz?

Abre la luz en un navegador y toca Info (el botón “i”). Ahí están la versión y el nombre de la compilación. O abre http://<light-ip>/json/info y busca "release", por ejemplo "release":"ESP02" o "release":"ESP32".

/json/info (una parte)
"ver""0.15.1"
"release""ESP02"
"arch""esp8266"

El campo release es el nombre de compilación que debe coincidir cuando descargas.

Los archivos de las versiones en GitHub (github.com/wled/WLED/releases) llevan los mismos nombres:

Nombre de compilaciónHardware típicoFlashActualización inalámbrica
ESP8266D1 mini, NodeMCU4 MBsí, con espacio de sobra
ESP02placas con 2 MB de flash, muchos controladores baratos2 MBsí, pero justo
ESP01ESP-01, ESP-01S1 MBno, compilado sin OTA
ESP32placas de desarrollo ESP32, QuinLED, la mayoría de los controladores4 MBsí
ESP32-S2, S3, C3chips ESP32 más nuevosvaríasí

Quédate con el nombre de compilación que tienes ahora. Cambiar de compilación de forma inalámbrica puede dejarte con pines por defecto equivocados o con una luz que no arranca.

Actualizar en la interfaz web

WLED 16 hace casi todo el trabajo por ti. Ve a Config›Security & Updates y toca Update WLED (o abre http://<light-ip>/update). La página muestra la versión instalada, el nombre de tu release y la versión más reciente. Auto update descarga el archivo correspondiente desde GitHub y lo sube. En ESP32 y en las placas ESP8266 de 4 MB eso es todo. En las placas de 2 MB, lee primero la siguiente sección, porque Auto update elige el .bin normal.

Interfaz web de WLED
Sección Software Update de Security and Updates en WLED: botón Update WLED y la opción marcada Only allow update from same network/WiFi con su advertencia sobre VLAN
Security & Updates, sección Software Update.
Interfaz web de WLED
Página Software Update de WLED: versión instalada WLED 16.0.1, release ESP32, versión más reciente v16.0.1, botón Auto update, carga manual con Choose File, Ignore firmware validation y Upload, y Revert update
La página de actualización en WLED 16.0.1 (una luz ESP32).

En WLED 0.15 y anteriores, o cuando quieres elegir el archivo tú:

  1. Descarga el archivo para tu compilación desde la página de versiones.
  2. Ve a Config > Security & Updates y toca Manual OTA Update (en WLED 16, Update WLED), o abre http://<light-ip>/update.
  3. Elige el archivo y toca Update! (en WLED 16, Upload).
  4. Espera. Sube, escribe y reinicia, normalmente en menos de un minuto. No toques la alimentación mientras tanto.

Antes de todo esto, guarda una copia de seguridad. Security & Updates tiene los botones Backup presets y Backup configuration. Una actualización normal conserva tus ajustes, pero la copia de seguridad toma diez segundos. Copia de seguridad y restauración de la configuración de WLED explica qué contiene cada archivo.

Interfaz web de WLED
Sección Backup and Restore de WLED: texto de advertencia, botón Backup presets, Restore presets con Choose File y Upload, botón Backup configuration, Restore configuration con Choose File y Upload
Los botones de copia de seguridad están más abajo en la misma página Security & Updates.

Solución de problemas: por qué fallan las actualizaciones en ESP8266

La actualización falló: “Not enough space” en placas de 2 MB

El ESP8266 no tiene una partición de actualización fija como el ESP32. La imagen nueva se aloja en el hueco entre el final del firmware en ejecución y el inicio del sistema de archivos. En una placa de 2 MB el sistema de archivos empieza en 1.572.864 bytes (0x180000). Con unos 800 KB de firmware actual, quedan aproximadamente 750 KB para la imagen nueva, y una compilación completa de WLED es más grande. WLED hasta 0.15.1 además reserva un sector extra de 4 KB, así que queda todavía más justo.

01,5 MB2 MB

Por qué a las placas de 2 MB les falta espacio: la imagen nueva tiene que caber en el hueco.

Dos formas de resolverlo:

  • El archivo .bin.gz. El ESP8266 acepta tal cual una imagen comprimida con gzip y la descomprime al arrancar. Es aproximadamente una cuarta parte más pequeña, y a menudo esa es la diferencia entre que quepa o falle.
  • Dos pasos. Instala primero la compilación pequeña ESP02_min (menos funciones, cabe sin problema), reinicia y luego instala la compilación completa ESP02. Con la compilación pequeña en ejecución hay más espacio, así que la completa cabe. Los archivos ESP02_min existen a partir de WLED 16. Las versiones 0.15 no los tienen.

WLED 16 comprueba que el nombre de compilación de lo que subes coincida con la compilación en ejecución, así que pasar de ESP02 a ESP02_min implica marcar Ignore firmware validation en la página de actualización. Es un problema conocido del proyecto (wled/WLED#5576). El camino manual es ESP02, luego ESP02_min.bin.gz y luego ESP02.bin.gz.

Falla de inmediato en ESP01

Las compilaciones ESP01 se compilan sin OTA. No hay a dónde subir nada. Conecta la placa por USB y usa install.wled.me (cómo).

Archivo equivocado

Un .bin de ESP32 en un ESP8266, o al revés, se rechaza si tienes suerte. Si no, la luz no arranca hasta que vuelvas a flashearla por USB. Haz coincidir el nombre de compilación siempre.

La actualización falló con 401 “Access Denied”

Un 401 significa que la luz rechazó la carga antes de leerla. La segunda línea del mensaje dice por qué:

MensajeCausaSolución
Please unlock OTA in security settings!Lock wireless (OTA) software update está marcadoDesmárcalo en Security & Updates (necesita la contraseña OTA)
Please unlock settings using PIN code!Hay un PIN de configuración y este navegador no lo ha introducidoIntroduce el PIN y vuelve a subir el archivo
Client is not on local subnet.Solo WLED 16: la carga vino de otra subred con Only allow update from same network/WiFi marcado, o de una dirección fuera de los rangos privadosActualiza desde un dispositivo en la red de la luz, desmarca la opción o define un PIN de configuración

Las apps y Home Assistant reciben la misma respuesta cuando actualizan la luz. Home Assistant 2026.10 y posteriores muestran el motivo; las versiones anteriores fallaban sin avisar (consulta Soluciones para WLED y Home Assistant).

Bloqueada o en otra subred

Con Lock wireless (OTA) software update marcado en Security & Updates, la luz rechaza las cargas hasta que lo desmarques, y para eso necesitas la contraseña OTA. Con Only allow update from same network/WiFi marcado, rechaza las actualizaciones desde otras subredes. Si tu móvil está en otra VLAN, desmárcalo (o define un PIN, como sugiere la página), o actualiza desde un dispositivo en la red de la luz.

En WLED Max esos mismos dos interruptores son Bloquear actualizaciones OTA y Limitar OTA a la misma subred en Ajustes del dispositivo, Seguridad y actualizaciones.

iOS
Pantalla Seguridad y actualizaciones de WLED Max: Bloquear actualizaciones OTA desactivado, Bloquear configuración Wi-Fi desactivado, Activar ArduinoOTA activado, Limitar OTA a la misma subred activado, contraseña OTA definida (7 caracteres)
Los dos ajustes en WLED Max.

Otros síntomas

Se queda en 0% o se agota el tiempo. Wi-Fi débil en la luz. Acerca el móvil al router (al router, no a la luz), o actualiza desde un ordenador con conexión por cable.

Reinició con la versión anterior. La carga terminó, pero la imagen no se validó. Prueba con el .bin.gz o con el método de dos pasos.

Volvió al modo WLED-AP después. Es raro, pero pasa cuando se pierde la configuración. Conéctate a WLED-AP (contraseña wled1234), vuelve a configurar el Wi-Fi y luego restaura tu copia de seguridad.

Los efectos se ven distintos en WLED 16. Algunos ID de efectos cambiaron (el efecto 77, por ejemplo). WLED Max marca los preajustes que usan el efecto 77 para que sepas cuáles volver a guardar.

Actualizar desde tu móvil

En WLED Max, abre Actualización de firmware manteniendo pulsada la luz en la lista de dispositivos y eligiendo Firmware, o desde el aviso Actualización de firmware disponible. En Android también está en Ajustes del dispositivo.

  1. La app muestra las versiones recientes del repositorio oficial de WLED en GitHub, incluidas las preliminares. No hay selector de estable o beta, así que revisa la versión antes de tocar.
  2. Elige la compilación exacta que informa tu luz (ESP32, ESP8266, ESP02, ESP01, S2, S3 o C3). Si falta ese archivo exacto, recurre al tipo de chip, y Ver todas las compilaciones te deja elegir.
  3. Toca Descargar junto a la versión en Versiones disponibles y luego Instalar junto a ella en Firmware en caché. Las descargas quedan guardadas, así que un firmware que descargaste antes se instala después sin internet.
iOS
Pestaña Dispositivos de WLED Max con Garage Strip marcada como Actualizar y un aviso Actualización de firmware disponible: Garage Strip puede actualizarse a v16.0.1, con los botones No recordarme y Actualizar
El aviso en la lista de dispositivos.

La versión 1.1.4 se encarga por ti de los casos de ESP8266 de arriba, en iOS y Android:

  • Las versiones que necesitan dos pasos en tu placa lo indican en la lista (“Necesita una actualización en dos pasos. Descargar obtiene los dos archivos.”).
  • Cuando la compilación completa no cabe, la app ofrece Iniciar actualización en dos pasos. Instala primero la versión reducida (“Paso 1 de 2: versión reducida”) y luego la completa (“Paso 2 de 2: versión completa”), sin descargas manuales. Si el paso 1 no termina, la luz sigue con su firmware anterior y no cambió nada. Si el paso 2 no termina, la luz sigue funcionando con la versión reducida y Reintentar paso 2 termina el trabajo.
  • Si una versión es demasiado grande para esa placa incluso en dos pasos, la fila dice “Demasiado grande para instalarse por Wi-Fi en esta luz”, no se sube nada y la app sugiere una instalación por USB con install.wled.me.
  • En una compilación sin actualizaciones inalámbricas (ESP01), la app lo dice y te remite a install.wled.me en lugar de fallar a la mitad.
iOS
Lista Actualización de firmware de una luz ESP02: en Versiones disponibles una versión de desarrollo marcada Demasiado grande para instalarse por Wi-Fi en esta luz, luego v16.0.1 y v16.0.0, cada una marcada Necesita una actualización en dos pasos. Descargar obtiene los dos archivos, y después v16.0.0-beta y v0.15.4, cada una con un botón Descargar
Una luz ESP02 en la lista Actualización de firmware. Android muestra las mismas notas.

Cuando se rechaza una actualización, la pantalla sugiere soluciones como borrar la contraseña OTA o permitir actualizaciones desde otra subred. Si una luz tiene una compilación personalizada, el aviso de actualización advierte que instalar una versión oficial reemplaza el firmware personalizado y los módulos de usuario adicionales por el firmware estándar. La app no puede subir tu propio .bin. Para compilaciones personalizadas, usa la interfaz web.

Para enterarte de las nuevas versiones estables para tus luces, activa Actualizaciones de firmware en Ajustes›Preferencias de la app›Notificaciones. Viene desactivado por defecto.

Relacionado: Los ajustes de WLED explicados y por qué una luz WLED se desconecta una y otra vez.