WLED e xLights: quando você precisa, configuração do DDP e como retomar o controle
Quando o WLED sozinho basta e quando o xLights vale a pena, como mandar o xLights para o WLED por DDP ou E1.31, as configurações que importam dos dois lados e como o WLED retoma o controle depois de um show.
Escrito por Jamie Conde, que desenvolve o WLED Max na MeowScript. O WLED Max é um app independente e não tem afiliação nem endosso do projeto oficial WLED.
Resposta rápida: o WLED roda efeitos sozinho; o xLights é para shows sequenciados com música em muitos elementos. Os dois funcionam juntos: o xLights manda a cor de cada pixel pela rede, e o WLED só mostra. No xLights, adicione a luz como um controlador Ethernet com o fabricante WLED e o protocolo DDP. O WLED não precisa de nenhuma configuração para DDP. Quando o xLights para de mandar, o WLED volta para o próprio efeito depois de 2,5 segundos.
Você precisa mesmo do xLights?
A maioria das pessoas com WLED não precisa. Uma regra prática do fórum do WLED resume bem: o WLED dá conta sozinho de muitas instalações de LED, e o xLights é a ferramenta para quando você quer controlar o quintal inteiro como um único show.
| Você quer | Use |
|---|---|
| Efeitos bonitos num beiral, numa árvore ou numa janela, mudando por agendamento | Só o WLED, com predefinições, sequências e temporizadores |
| Padrões de datas comemorativas como vermelho e branco ou bengala doce | Só o WLED, veja padrões de Natal |
| Várias luzes mostrando o mesmo efeito em sincronia | Só o WLED, com UDP sync |
| Luzes no ritmo de uma música, batida por batida | xLights |
| Uma mega árvore, matriz, arcos e beiral agindo como uma única instalação | xLights |
| Um show que roda toda noite por agendamento sem um computador | xLights para criar, Falcon Player (FPP) num Raspberry Pi para tocar |
O xLights é grátis e poderoso, e também é um hobby por si só. Sequenciar uma música pode levar uma noite. Se você só quer que a casa fique bonita em dezembro, o WLED sozinho já resolve quase tudo.
Como os dois se encaixam
Num show, o WLED deixa de ser o cérebro. O xLights (ou o FPP tocando o show) manda um fluxo de quadros, cada um com a cor de cada pixel. O WLED entra no modo em tempo real: ele limpa a fita, mostra o que chegar e ignora os próprios efeitos, predefinições e temporizadores até o fluxo parar.
Por isso a dúvida mais comum sobre xLights no fórum do WLED é, na verdade, “por que o meu WLED ignora o app?”. Veja WLED preso no modo em tempo real para esse lado.
DDP ou E1.31?
O WLED aceita três protocolos de show. DDP e E1.31 vêm ligados por padrão. O Art-Net precisa do Type em Art-Net em Network DMX input, nas Sync Interfaces, o que muda a escuta da porta 5568 para a 6454, então E1.31 e Art-Net não podem ficar ligados ao mesmo tempo.
| DDP | E1.31 (sACN) | Art-Net | |
|---|---|---|---|
| Porta | 4048 | 5568 | 6454 |
| Configuração no WLED | nenhuma, sempre ligado | Network DMX input, DMX mode | a mesma, Type Art-Net |
| Universos | nenhum, só um deslocamento de pixel | 170 pixels RGB por universo | o mesmo que o E1.31 |
| RGBW | sim no WLED, mas o upload do xLights para WLED recusa | sim, com DMX mode Multi RGBW | sim |
| Padrão do xLights para WLED | sim |
Use DDP, a não ser que tenha um motivo para não usar. É o que o xLights escolhe quando encontra um controlador WLED, não há universos para alinhar e é eficiente. Use E1.31 para pixels RGBW, ou se o seu show é montado em torno de universos no FPP.
Configure o WLED
Para DDP não há quase nada a fazer. Confira isto em Config›LED & Hardware (LED Preferences no 0.14 e no 0.15):
- A quantidade de LEDs e a ordem das saídas batem com a fiação real.
- A luz tem um endereço fixo (uma reserva de DHCP no roteador).
Para E1.31, abra Config›Sync Interfaces e encontre Network DMX input na seção Realtime:
- Type: E1.31 (sACN).
- Start universe: o primeiro universo que o xLights manda para esta luz (1 por padrão).
- DMX mode: Multi RGB para pixels RGB, Multi RGBW para RGBW. A documentação do WLED chama o Multi RGB de “the mode you want to use for xLights”.
- Multicast: igual ao que o xLights manda. Unicast (desligado) é mais simples no Wi-Fi.
O resto da seção Realtime importa para os dois protocolos:
- Timeout (2500 ms por padrão): quanto tempo o WLED espera depois do último quadro antes de voltar para o próprio efeito.
- Force max brightness: mostra o fluxo no brilho máximo em vez do brilho do seu WLED.
- Use main segment only: o fluxo pinta só o segmento principal enquanto os outros mantêm os efeitos do WLED. Com isso ligado, o WLED ignora o override
lordescrito abaixo. - Respect LED Maps (0.15 e mais recentes): aplica o seu mapa de LEDs (ledmap.json) também ao fluxo.
No WLED Max no iPhone, as configurações de E1.31 e o tempo limite ficam em Configurações do dispositivo, Interfaces de sincronização, na seção E1.31 / DMX / Art-Net. No Android é no mesmo lugar: Configurações do dispositivo, Interfaces de sincronização, E1.31 / DMX / Art-Net. O campo de tempo limite do app conta em passos de 100 ms, então 25 ali quer dizer 2500 ms.
Configure o xLights
O xLights tem o WLED embutido como fabricante de controlador, com modelos para placas ESP8266 e ESP32 genéricas e várias placas QuinLED.
- Abra a aba Controllers e clique em Add Ethernet. (Ou tente Discover: ele encontra as luzes WLED na sua rede e preenche o resto.)
- Digite o IP Address da luz, coloque Vendor em WLED, depois Model em WLED com Variant Generic ESP32 ou Generic ESP8266, ou escolha a sua placa como Model (QuinLED Dig-Uno, Dig-Quad, Dig-Octa e outras).
- Coloque Protocol em DDP. Deixe Keep Channel Numbers desligado.
- Monte os seus elementos na aba Layout, depois volte ao controlador, clique em Visualise e arraste cada elemento para a porta em que ele está ligado.
- Com Auto Size ligado, o xLights calcula a quantidade de canais a partir dos elementos. À mão, é LEDs × 3 para RGB.
- Salve e ative a saída para as luzes (o botão de lâmpada na barra de ferramentas).
Vale deixar o xLights fazer upload para o WLED?
O botão Upload Output grava a configuração das portas (quantidade de LEDs, pinos GPIO, tipo de LED, ordem das cores) no WLED e reinicia a luz. Ajuda num controlador novo, mas sobrescreve as configurações de LED do WLED, e há relatos no fórum de ele apagar as configurações de GPIO. Se o seu WLED já está configurado e funcionando, coloque você mesmo a quantidade de LEDs no WLED e pule o upload. De qualquer forma, faça backup antes: backup e restauração do WLED.
Dois erros de upload que você pode ver, e o que eles querem dizer:
- “The DDP ‘Keep Channel Numbers’ option is not support with WLED”: desligue essa opção.
- “Four Channel Pixles and DDP, do not work well in WLED”: os seus elementos são RGBW. Mude esse controlador para E1.31 e coloque o DMX mode do WLED em Multi RGBW.
Wi-Fi, taxa de quadros e shows grandes
Transmitir pelo Wi-Fi funciona para poucos controladores. Fica mais difícil conforme o show cresce: cada pixel de cada quadro passa pela rede sem fio, e tópicos no fórum descrevem shows com uma dúzia de controladores Wi-Fi caindo para poucos quadros por segundo.
- Deixe o computador ou o FPP que manda o show ligado por cabo, para só o último trecho ser Wi-Fi.
- Ative Suppress Duplicate Frames no controlador no xLights, para quadros que não mudaram não serem mandados de novo.
- Para E1.31, a documentação do WLED recomenda no máximo 3 universos (510 pixels RGB) por luz para 40 quadros por segundo sem engasgos, e 9 universos no máximo no ESP8266.
- O WLED mostra um quadro novo do fluxo no máximo uma vez a cada 16 ms, o que limita a pouco mais de 60 quadros por segundo, não importa o que você mande.
- Para instalações grandes, use placas ESP32, e placas com Ethernet cabeada onde der.
Retomando o controle depois do show
Quando o fluxo para, o WLED espera o tempo limite (2,5 s por padrão) e depois volta exatamente para o que estava fazendo: mesmo efeito, mesmo brilho. A transmissão não muda nenhuma configuração do próprio WLED.
Quando você desliga a saída no xLights, ele manda antes um quadro todo preto. Então as luzes apagam durante o tempo limite, e depois o efeito do WLED volta.
Se o WLED não voltar, alguma coisa ainda está mandando. Descubra pelo /json/info da luz (o campo lip mostra o IP de quem manda), ou force por cima:
- Mande
{"lor":1}para/json/statepara ignorar o fluxo até ele parar, ou{"lor":2}para ignorar até a próxima reinicialização. - Mande
{"live":false}para sair do modo em tempo real na hora. Se quem manda ainda estiver transmitindo, o próximo pacote coloca a luz direto no modo em tempo real de novo, então pare quem manda ou uselor.
No WLED Max, a aba Controle mostra uma faixa “Controle externo ativo” quando uma luz está sendo controlada pelo xLights ou por qualquer outra coisa (no iOS, e no Android a partir do WLED Max 1.1.4). Toque em Assumir o controle e escolha Assumir o controle até os dados pararem ou Assumir o controle até reiniciar. São os mesmos dois valores de override. No Android 1.1.2 e anteriores, a faixa mostra o nome de quem está enviando (”… is controlling this device”, na época o app só existia em inglês) e os dois botões se chamam Until Data Stops e Until Reboot.
Para manter o último quadro nas luzes, coloque o tempo limite em 65000, que o WLED trata como nunca.
Perguntas frequentes
Preciso do xLights para o WLED? Não. O WLED roda efeitos, predefinições, sequências e temporizadores sozinho. O xLights é para shows sincronizados com música em muitos elementos.
Qual porta o xLights usa para o WLED? DDP na porta 4048, E1.31 na 5568, Art-Net na 6454.
Tenho que ativar o DDP no WLED? Não. O WLED sempre escuta DDP. E1.31 e Art-Net são configurados em Sync Interfaces, em Network DMX input: Type escolhe E1.31 ou Art-Net, e o DMX mode não pode estar em Disabled.
Por que o WLED fica apagado depois do show? O xLights mandou um quadro preto quando você desligou a saída, e o WLED mostra esse quadro até o tempo limite acabar. Se ficar apagado por mais tempo, outro emissor ainda está transmitindo.
Posso usar efeitos do WLED e o xLights juntos? Pode, de dois jeitos: ative Use main segment only, para o show rodar num segmento e os outros manterem os efeitos do WLED, ou deixe o WLED rodar normalmente e mude para o xLights só enquanto o show toca.