WLED funciona en placas ESP32 y ESP8266 y controla tiras y matrices LED direccionables. Pixel LED Animator 3 puede enviar fotogramas de píxeles a WLED por la red en tiempo real, de modo que la animación se reproduce en vivo en lugar de copiarse a una tarjeta.
Eso cambia el flujo de trabajo. Puedes ajustar un efecto mirando la matriz real, probar el cableado de inmediato y ejecutar una secuencia mientras dure la conexión de transmisión.
Cómo Funciona la Conexión
Pixel LED Animator envía paquetes UDP con datos de píxeles. WLED los recibe, cambia al modo en vivo y escribe los valores en los LEDs. El editor hace el renderizado; WLED hace la salida.
Varios protocolos pueden transportar los mismos fotogramas:
| Protocolo | Puerto predeterminado | Direccionamiento | Ideal para |
|---|---|---|---|
| DDP | 4048 | Desplazamiento por píxel, sin universos | WLED, la configuración más simple |
| E1.31 / sACN | 5568 | 510 canales por universo | Instalaciones con controladores mixtos, FPP |
| Art-Net | 6454 | 512 canales por universo | Consolas de iluminación, MADRIX |
| TPM2.net | 65506 | Datos de píxeles secuenciales | Jinx, FPP, compilaciones de WLED compatibles |
| KiNet | 6038 | Datos de píxeles secuenciales | Hardware Color Kinetics y MADRIX |
Para WLED, empieza con DDP. Evita los cálculos de universos y envía el fotograma en la menor cantidad de paquetes. Usa E1.31 cuando WLED forme parte de una instalación mayor que ya hable sACN.
KiNet no es un protocolo de WLED. Está pensado para drivers Color Kinetics e instalaciones tipo MADRIX. No lo selecciones para una placa WLED.
Paso 1: Configura WLED
- Abre la interfaz web de WLED.
- Ve a Config → LED Preferences y define el número total de LEDs como
width x height. - Define el orden de colores para que coincida con la tira o el panel: RGB, GRB, BRG, etc.
- Abre la configuración 2D Matrix y define el ancho, la altura y la disposición del cableado del panel. Según la versión de WLED, esto está en LED Preferences o en la página dedicada de configuración 2D.
- Ve a Config → Sync Interfaces y activa DDP. Activa E1.31 o Art-Net solo si piensas usarlos.
- Asigna a la placa una dirección IP fija mediante una reserva DHCP.
- Prueba la matriz con un efecto integrado de WLED antes de enviar datos externos.
Si el efecto integrado se ve mal, la transmisión externa también se verá mal. Corrige primero las dimensiones de la matriz y el cableado.
Paso 2: Iguala el Cableado en Pixel LED Animator
Abre la ventana de transmisión y elige el botón de protocolo WLED.
- WLED IP: la dirección de la placa, por ejemplo
192.168.4.1en modo punto de acceso o la dirección DHCP de tu LAN. - Protocol:
DDP (Recommended). - Port: deja Default a menos que tu versión de WLED use un puerto personalizado.
- Wiring pattern: elige el patrón que coincida con la matriz física: secuencial, serpentina, vertical o serpentina vertical.
- Brightness: mantén un límite general de brillo para las pruebas y súbelo para el espectáculo.
El patrón de cableado del editor y la configuración de matriz 2D de WLED deben coincidir. Si uno dice serpentina y el otro dice progresivo, la imagen se romperá o se reflejará en cada fila.
Paso 3: Verifica con Patrones de Prueba
Abre el grupo Test Patterns en la ventana de transmisión y envía un patrón:
- Solid comprueba la alimentación y el color básico.
- Chase comprueba el orden y la dirección de los píxeles.
- Alternate comprueba el cableado impar/par.
- RGB Cycle comprueba el orden de colores.
- Bars comprueba el mapeo de filas y columnas.
- Gradient revela problemas de banding y gamma.
Envía un patrón antes de transmitir la animación. Un fallo de cableado se ve mucho más fácilmente con una persecución que con un efecto plasma en movimiento.
Si la imagen está reflejada, invertida o rotada, corrige el patrón de cableado o la orientación 2D de WLED. No lo compenses editando la animación.
Paso 4: Inicia la Transmisión
Pulsa Start Streaming y observa el medidor de FPS y la visualización de actividad DMX. Luego comprueba:
- Que el primer fotograma coincida con la vista previa del editor.
- Que el movimiento sea fluido, sin tirones visibles.
- Que los colores coincidan con la paleta.
- Que la matriz no parpadee cuando cambie el brillo.
WLED tiene un tiempo de espera para datos en vivo. Si la transmisión se detiene, WLED vuelve a sus efectos normales tras una breve pausa. Es el comportamiento esperado, no un fallo.
Paso 5: Elige entre En Vivo o Autónomo
La transmisión es ideal para pruebas y espectáculos en vivo. No es la opción adecuada para una instalación permanente que deba arrancar sin una PC.
| Caso de uso | Mejor salida |
|---|---|
| Ajustar un efecto en la matriz real | Flujo DDP en vivo |
| Espectáculo en vivo con una PC | DDP o E1.31 en vivo |
| Instalación autónoma | Video exportado, GIF o archivo de controlador |
| Espectáculo gestionado por FPP | Secuencia FSEQ |
| Controlador con tarjeta SD | XDAT o video |
Para reproducción autónoma, exporta la animación terminada y usa el formato que acepte el controlador. La guía de formatos de exportación cubre las ventajas y desventajas.
Límites de Red y Rendimiento
El ancho de banda de píxeles sin procesar es fácil de calcular:
width x height x 3 x FPS = bytes per second
| Matriz | Tamaño de fotograma | A 30 FPS |
|---|---|---|
32 x 32 | 3.072 bytes | ~0,74 Mbps |
64 x 32 | 6.144 bytes | ~1,47 Mbps |
64 x 64 | 12.288 bytes | ~2,95 Mbps |
128 x 64 | 24.576 bytes | ~5,9 Mbps |
Esas cifras son antes de la sobrecarga de paquetes. El Wi-Fi puede transportarlas, pero la latencia y el jitter importan más que el rendimiento bruto. Para matrices grandes:
- Usa Ethernet en el ESP32 si la placa lo admite.
- Mantén el punto de acceso cerca y en un canal tranquilo.
- Recuerda que la mayoría de las placas ESP32 solo funcionan en 2,4 GHz; una red de 5 GHz no aparecerá.
- Desactiva el aislamiento de clientes del router para que la PC pueda alcanzar la placa.
- Limita el brillo en WLED para no superar la fuente de alimentación.
Solución de Problemas
| Problema | Solución |
|---|---|
| WLED no reacciona | Revisa la IP, activa DDP en WLED y confirma que ambos dispositivos estén en la misma red |
| Solo se actualiza parte de la matriz | El patrón de cableado, las dimensiones de la matriz o el número de universos son incorrectos |
| La imagen está reflejada o rotada | Iguala el patrón de cableado del editor con la orientación 2D de WLED |
| Los colores son incorrectos | Define el orden de colores correcto en WLED |
| Parpadeo o píxeles aleatorios | Inyección de corriente, adaptación de nivel, línea de datos floja o reintentos de Wi-Fi |
| La transmisión se corta a los pocos segundos | Tiempo de espera de datos en vivo de WLED; mantén la transmisión activa y revisa la red |
| La velocidad de fotogramas es baja | Reduce el tamaño del lienzo o los FPS, usa Ethernet y disminuye el tráfico Wi-Fi |
| La placa no aparece en Discover | Firewall, subred o aislamiento del AP; introduce la IP manualmente |
Preguntas Frecuentes
¿Puede WLED reproducir un archivo de video directamente? No en el sentido habitual. WLED muestra datos de píxeles en vivo o sus propios efectos. La reproducción de video requiere usermods y hardware específicos, y no es lo mismo que transmitir fotogramas desde el editor.
¿Debo usar DDP o E1.31? Usa DDP para una instalación solo con WLED. Usa E1.31 cuando WLED comparta la red con FPP, una consola de iluminación u otros dispositivos sACN.
¿Puedo transmitir por internet? Es posible con un túnel, pero no es recomendable. La transmisión de píxeles es sensible a la latencia y expone el controlador a la red. Mantenla en la LAN.
¿La animación permanece en WLED cuando dejo de transmitir? No. La transmisión son datos en vivo. Para reproducción autónoma, exporta un archivo para el controlador o usa FPP.
¿Cuántos píxeles puede manejar WLED? Depende de la placa ESP32, la velocidad de fotogramas, la red y la alimentación. Prueba la matriz real a la velocidad de fotogramas objetivo en lugar de fiarte de una cifra nominal.
Explora Pixel LED Animator 3 · Ver todas las integraciones · Lee la guía FSEQ para Falcon Player · Compra la licencia de por vida
