WLED xLights Natal Tempo real Passo a passo

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.

Por

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ê querUse
Efeitos bonitos num beiral, numa árvore ou numa janela, mudando por agendamentoSó o WLED, com predefinições, sequências e temporizadores
Padrões de datas comemorativas como vermelho e branco ou bengala doceSó o WLED, veja padrões de Natal
Várias luzes mostrando o mesmo efeito em sincroniaSó o WLED, com UDP sync
Luzes no ritmo de uma música, batida por batidaxLights
Uma mega árvore, matriz, arcos e beiral agindo como uma única instalaçãoxLights
Um show que roda toda noite por agendamento sem um computadorxLights 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.

DDPE1.31 (sACN)Art-Net
Porta404855686454
Configuração no WLEDnenhuma, sempre ligadoNetwork DMX input, DMX modea mesma, Type Art-Net
Universosnenhum, só um deslocamento de pixel170 pixels RGB por universoo mesmo que o E1.31
RGBWsim no WLED, mas o upload do xLights para WLED recusasim, com DMX mode Multi RGBWsim
Padrão do xLights para WLEDsim

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 lor descrito 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.

  1. Abra a aba Controllers e clique em Add Ethernet. (Ou tente Discover: ele encontra as luzes WLED na sua rede e preenche o resto.)
  2. 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).
  3. Coloque Protocol em DDP. Deixe Keep Channel Numbers desligado.
  4. 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.
  5. Com Auto Size ligado, o xLights calcula a quantidade de canais a partir dos elementos. À mão, é LEDs × 3 para RGB.
  6. 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/state para 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 use lor.

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.

Todos os recursos do WLED Max, nosso app de WLED para iOS e Android, são grátis para uma luz.