WLED y xLights: cuándo lo necesitas, configuración de DDP y cómo recuperar el control
Cuándo basta con WLED y cuándo vale la pena xLights, cómo enviar un show a WLED por DDP o E1.31, qué ajustar en cada lado y cómo WLED recupera el control.
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.
Respuesta rápida: WLED ejecuta efectos por su cuenta; xLights es para shows programados al ritmo de la música en muchos elementos. Funcionan juntos: xLights envía el color de cada píxel por la red y WLED solo lo muestra. En xLights, añade la luz como controlador Ethernet con el fabricante WLED y el protocolo DDP. WLED no necesita ningún ajuste para DDP. Cuando xLights deja de enviar, WLED vuelve a su propio efecto después de 2,5 segundos.
¿De verdad necesitas xLights?
La mayoría de la gente con WLED no. Una regla práctica del foro de WLED lo resume: WLED gestiona muchas instalaciones LED por sí solo, y xLights es la herramienta cuando quieres controlar todo tu jardín como un solo show.
| Quieres | Usa |
|---|---|
| Efectos bonitos en un alero, un árbol o una ventana, que cambian según un horario | Solo WLED, con preajustes, listas de reproducción y temporizadores |
| Patrones de festividades como rojo y blanco o bastón de caramelo | Solo WLED, mira los patrones de Navidad |
| Varias luces mostrando el mismo efecto sincronizado | Solo WLED, con sincronización UDP |
| Luces al ritmo de una canción, golpe por golpe | xLights |
| Un mega árbol, una matriz, arcos y el alero funcionando como una sola instalación | xLights |
| Un show que corre cada noche con un horario y sin ordenador | xLights para crearlo, Falcon Player (FPP) en una Raspberry Pi para reproducirlo |
xLights es gratis y potente, y también es un pasatiempo en sí mismo. Programar una sola canción puede llevar una noche entera. Si solo quieres que la casa se vea bien en diciembre, WLED por sí solo te resuelve casi todo.
Cómo encajan los dos
En un show, WLED deja de ser el cerebro. xLights (o FPP reproduciendo el show) envía un flujo de fotogramas, cada uno con el color de cada píxel. WLED entra en modo en tiempo real: borra la tira, muestra lo que llega e ignora sus propios efectos, preajustes y temporizadores hasta que el flujo se detiene.
Por eso la pregunta más común sobre xLights en el foro de WLED en realidad es “¿por qué mi WLED ignora la app?”. Consulta WLED atascado en modo en tiempo real para ese lado.
¿DDP o E1.31?
WLED acepta tres protocolos para shows. DDP y E1.31 vienen activados de forma predeterminada. Art-Net necesita poner Type en Art-Net en Network DMX input dentro de Sync Interfaces, lo que mueve la escucha del puerto 5568 al 6454, así que E1.31 y Art-Net no pueden estar activados al mismo tiempo.
| DDP | E1.31 (sACN) | Art-Net | |
|---|---|---|---|
| Puerto | 4048 | 5568 | 6454 |
| Ajuste en WLED | ninguno, siempre activado | Network DMX input, DMX mode | lo mismo, Type Art-Net |
| Universos | ninguno, solo un desplazamiento de píxeles | 170 píxeles RGB por universo | igual que E1.31 |
| RGBW | sí en WLED, pero la función de carga de xLights a WLED lo rechaza | sí, con DMX mode Multi RGBW | sí |
| Predeterminado de xLights para WLED | sí |
Usa DDP salvo que tengas un motivo para no hacerlo. Es lo que elige xLights cuando detecta un controlador WLED, no hay universos que alinear y es eficiente. Usa E1.31 para píxeles RGBW, o si tu show está montado sobre universos en FPP.
Configura WLED
Para DDP casi no hay nada que hacer. Revisa esto en Config›LED & Hardware (LED Preferences en 0.14 y 0.15):
- El número de LED y el orden de las salidas coinciden con el cableado real.
- La luz tiene una dirección fija (una reserva DHCP en tu router).
Para E1.31, abre Config›Sync Interfaces y busca Network DMX input en la sección Realtime:
- Type: E1.31 (sACN).
- Start universe: el primer universo que xLights envía a esta luz (1 de forma predeterminada).
- DMX mode: Multi RGB para píxeles RGB, Multi RGBW para RGBW. La documentación de WLED llama a Multi RGB “the mode you want to use for xLights” (el modo que conviene usar con xLights).
- Multicast: igual a lo que envíe xLights. Unicast (desactivado) es más sencillo por Wi-Fi.
El resto de la sección Realtime importa para los dos protocolos:
- Timeout (2500 ms de forma predeterminada): cuánto espera WLED después del último fotograma antes de volver a su propio efecto.
- Force max brightness: muestra el flujo con brillo máximo en lugar del brillo de tu WLED.
- Use main segment only: el flujo pinta solo el segmento principal mientras los demás conservan sus efectos de WLED. Con esto activado, WLED ignora el override
lorque se describe más abajo. - Respect LED Maps (0.15 y posteriores): aplica también tu mapa de LED (ledmap.json) al flujo.
En WLED Max en iPhone, los ajustes de E1.31 y el tiempo de espera están en Ajustes del dispositivo, Interfaces de sincronización, en la sección E1.31 / DMX / Art-Net. En Android está en el mismo lugar: Ajustes del dispositivo, Interfaces de sincronización, E1.31 / DMX / Art-Net. El campo de tiempo de espera de la app cuenta en pasos de 100 ms, así que 25 ahí significa 2500 ms.
Configura xLights
xLights trae WLED incluido como fabricante de controladores, con modelos para placas ESP8266 y ESP32 genéricas y varias placas QuinLED.
- Abre la pestaña Controllers y haz clic en Add Ethernet. (O prueba Discover: encuentra las luces WLED en tu red y llena el resto.)
- Escribe la IP Address de la luz, pon Vendor en WLED y luego Model en WLED con Variant Generic ESP32 o Generic ESP8266, o elige tu placa como Model (QuinLED Dig-Uno, Dig-Quad, Dig-Octa y otras).
- Pon Protocol en DDP. Deja Keep Channel Numbers desactivado.
- Monta tus elementos en la pestaña Layout, luego vuelve al controlador, haz clic en Visualise y arrastra cada elemento al puerto al que está cableado.
- Con Auto Size activado, xLights calcula el número de canales a partir de los elementos. A mano son LED × 3 para RGB.
- Guarda y activa la salida a las luces (el botón de la bombilla en la barra de herramientas).
¿Conviene dejar que xLights cargue la configuración en WLED?
El botón Upload Output escribe la configuración de los puertos (número de LED, pines GPIO, tipo de LED, orden de colores) en WLED y reinicia la luz. Es útil para un controlador nuevo, pero sobrescribe los ajustes de LED de WLED, y en el foro hay informes de que borra los ajustes de GPIO. Si tu WLED ya está configurado y funciona, pon tú mismo el número de LED en WLED y sáltate la carga. En cualquier caso, haz primero una copia de seguridad: copia de seguridad y restauración de WLED.
Dos errores de carga que podrías ver, y qué significan:
- “The DDP ‘Keep Channel Numbers’ option is not support with WLED”: desactiva esa opción.
- “Four Channel Pixles and DDP, do not work well in WLED”: tus elementos son RGBW. Cambia ese controlador a E1.31 y pon el DMX mode de WLED en Multi RGBW.
Wi-Fi, fotogramas por segundo y shows grandes
Transmitir por Wi-Fi funciona con unos pocos controladores. Se complica a medida que el show crece: cada píxel de cada fotograma viaja por Wi-Fi, y en el foro hay hilos que describen shows con una docena de controladores Wi-Fi que bajan a unos pocos fotogramas por segundo.
- Conecta por cable el ordenador o el FPP que envía el show, para que solo el último tramo sea Wi-Fi.
- Activa Suppress Duplicate Frames en el controlador en xLights, para que no se vuelvan a enviar los fotogramas que no cambiaron.
- Para E1.31, la documentación de WLED recomienda no más de 3 universos (510 píxeles RGB) por luz para unos 40 fotogramas por segundo sin tirones, y 9 universos como máximo en ESP8266.
- WLED muestra un fotograma transmitido nuevo como mucho cada 16 ms, lo que lo limita a poco más de 60 fotogramas por segundo, sin importar lo que envíes.
- Para instalaciones grandes, usa placas ESP32, y placas con Ethernet por cable donde puedas.
Recuperar el control después del show
Cuando el flujo se detiene, WLED deja pasar el tiempo de espera (2,5 s de forma predeterminada) y luego vuelve exactamente a lo que estaba haciendo: el mismo efecto, el mismo brillo. Transmitir no cambia ninguno de los ajustes propios de WLED.
Cuando desactivas la salida en xLights, primero envía un fotograma todo en negro. Así que las luces se quedan apagadas durante el tiempo de espera y luego vuelve el efecto de WLED.
Si WLED no vuelve, algo sigue enviando. Encuéntralo en /json/info de la luz (el campo lip muestra la IP del emisor), o anúlalo con lor:
- Envía
{"lor":1}a/json/statepara ignorar el flujo hasta que se detenga, o{"lor":2}para ignorarlo hasta el próximo reinicio. - Envía
{"live":false}para salir del modo en tiempo real de inmediato. Si el emisor sigue transmitiendo, el siguiente paquete vuelve a poner la luz en modo en tiempo real, así que detén el emisor o usalor.
En WLED Max, la pestaña Control muestra un aviso cuando xLights u otra cosa está controlando una luz (“Control externo activo”, en iOS y en Android desde WLED Max 1.1.4). Toca Tomar el control y elige Anular hasta que paren los datos o Anular hasta reiniciar. Son los mismos dos valores de lor. En Android 1.1.2 y anteriores, el aviso muestra el nombre del emisor (”… is controlling this device”, la app entonces solo estaba en inglés) y los dos botones se llaman Until Data Stops y Until Reboot.
Para que el último fotograma se quede en las luces, pon el tiempo de espera en 65000, que WLED interpreta como nunca.
Preguntas frecuentes
¿Necesito xLights para WLED? No. WLED ejecuta efectos, preajustes, listas de reproducción y temporizadores por su cuenta. xLights es para shows sincronizados con música en muchos elementos.
¿Qué puerto usa xLights para WLED? DDP en el puerto 4048, E1.31 en el 5568, Art-Net en el 6454.
¿Tengo que activar DDP en WLED? No. WLED siempre escucha DDP. E1.31 y Art-Net se configuran en Sync Interfaces, en Network DMX input: Type elige E1.31 o Art-Net, y DMX mode no puede estar en Disabled.
¿Por qué WLED se queda apagado después del show? xLights envió un fotograma negro cuando desactivaste la salida, y WLED lo muestra hasta que termina el tiempo de espera. Si se queda apagado más tiempo, otro emisor sigue transmitiendo.
¿Puedo usar los efectos de WLED y xLights juntos? Sí, de dos formas: activa Use main segment only, para que el show corra en un segmento y los demás conserven los efectos de WLED, o deja que WLED funcione normal y cambia a xLights solo mientras se reproduce el show.