Transmitir animações em direto para o WLED com DDP, E1.31 ou TPM2.net

O WLED corre em placas ESP32 e ESP8266 e controla tiras e matrizes LED endereçáveis. O Pixel LED Animator 3 pode enviar fotogramas de píxeis para o WLED pela rede em tempo real, para que a animação seja reproduzida em direto em vez de ser copiada para um cartão.

Isso muda o fluxo de trabalho. Pode afinar um efeito enquanto observa a matriz real, testar a cablagem de imediato e executar uma sequência enquanto a transmissão se mantiver ligada.

Como Funciona a Ligação

O Pixel LED Animator envia pacotes UDP com dados de píxeis. O WLED recebe-os, passa para o modo em direto e escreve os valores nos LED. O editor faz a renderização; o WLED faz a saída.

Vários protocolos podem transportar os mesmos fotogramas:

Para o WLED, comece por DDP. Evita contas de universos e envia o fotograma no menor número de pacotes. Use E1.31 quando o WLED fizer parte de uma instalação maior que já fale sACN.

KiNet não é um protocolo do WLED. Destina-se a drivers Color Kinetics e instalações do tipo MADRIX. Não o selecione para uma placa WLED.

Passo 1: Configure o WLED

1. Abra a interface web do WLED.
2. Vá a Config → LED Preferences e defina o número total de LED como width x height.
3. Defina a ordem de cores para corresponder à tira ou ao painel: RGB, GRB, BRG, etc.
4. Abra a configuração 2D Matrix e defina a largura, a altura e a disposição da cablagem do painel. Consoante a versão do WLED, isto está em LED Preferences ou na página dedicada de configuração 2D.
5. Vá a Config → Sync Interfaces e ative DDP. Ative E1.31 ou Art-Net apenas se pensar usá-los.
6. Atribua à placa um endereço IP fixo através de uma reserva DHCP.
7. Teste a matriz com um efeito incorporado do WLED antes de enviar dados externos.

Se o efeito incorporado estiver errado, a transmissão externa também estará errada. Corrija primeiro as dimensões da matriz e a cablagem.

Passo 2: Alinhe a Cablagem no Pixel LED Animator

Abra a janela de streaming e escolha o botão de protocolo WLED.

• WLED IP: o endereço da placa, por exemplo 192.168.4.1 em modo ponto de acesso ou o endereço DHCP na sua LAN.
• Protocol: DDP (Recommended).
• Port: deixe Default, a menos que a sua versão do WLED use uma porta personalizada.
• Wiring pattern: escolha o padrão que corresponde à matriz física: sequencial, serpentina, vertical ou serpentina vertical.
• Brightness: mantenha um limite geral para os testes e aumente-o para o espetáculo.

O padrão de cablagem no editor e a definição da matriz 2D no WLED têm de coincidir. Se um disser serpentina e o outro disser progressivo, a imagem vai rasgar ou espelhar-se em cada linha.

Passo 3: Verifique com Padrões de Teste

Abra o grupo Test Patterns na janela de streaming e envie um padrão:

• Solid verifica a alimentação e a cor básica.
• Chase verifica a ordem e a direção dos píxeis.
• Alternate verifica a cablagem ímpar/par.
• RGB Cycle verifica a ordem de cores.
• Bars verifica o mapeamento de linhas e colunas.
• Gradient revela problemas de banding e gamma.

Envie um padrão antes de transmitir a animação. Uma falha de cablagem vê-se muito mais facilmente numa perseguição do que num efeito plasma em movimento.

Se a imagem estiver espelhada, invertida ou rodada, corrija o padrão de cablagem ou a orientação 2D do WLED. Não compense editando a animação.

Passo 4: Inicie a Transmissão

Prima Start Streaming e observe o medidor de FPS e a visualização da atividade DMX. Depois verifique:

• O primeiro fotograma corresponde à pré-visualização do editor.
• O movimento é fluido, sem falhas visíveis.
• As cores correspondem à paleta.
• A matriz não cintila quando o brilho muda.

O WLED tem um tempo limite para dados em direto. Se a transmissão parar, o WLED volta aos seus efeitos normais após um breve intervalo. É o comportamento esperado, não uma avaria.

Passo 5: Escolha entre Direto e Autónomo

A transmissão é ideal para testes e espetáculos ao vivo. Não é a escolha certa para uma instalação permanente que tenha de arrancar sem computador.

Para reprodução autónoma, exporte a animação terminada e use o formato que o controlador aceita. O guia de formatos de exportação explica os compromissos.

Limites de Rede e Desempenho

A largura de banda bruta de píxeis é fácil de calcular:

width x height x 3 x FPS = bytes per second

Estes números são antes da sobrecarga dos pacotes. O Wi-Fi consegue transportá-los, mas a latência e o jitter importam mais do que o débito bruto. Para matrizes grandes:

• Use Ethernet no ESP32 se a placa o suportar.
• Mantenha o ponto de acesso perto e num canal livre.
• Lembre-se de que a maioria das placas ESP32 é apenas de 2,4 GHz; uma rede de 5 GHz não vai aparecer.
• Desative o isolamento de clientes do router para que o PC consiga chegar à placa.
• Limite o brilho no WLED para não exceder a fonte de alimentação.

Resolução de Problemas

Perguntas Frequentes

O WLED consegue reproduzir um ficheiro de vídeo diretamente? Não no sentido habitual. O WLED mostra dados de píxeis em direto ou os seus próprios efeitos. A reprodução de vídeo exige usermods e hardware específicos, e não é o mesmo que transmitir fotogramas a partir do editor.

Devo usar DDP ou E1.31? Use DDP para uma instalação apenas com WLED. Use E1.31 quando o WLED partilhar a rede com o FPP, uma consola de iluminação ou outros dispositivos sACN.

Posso transmitir pela internet? É possível com um túnel, mas não é recomendado. A transmissão de píxeis é sensível à latência e expõe o controlador à rede. Mantenha-a na LAN.

A animação fica no WLED quando paro a transmissão? Não. A transmissão são dados em direto. Para reprodução autónoma, exporte um ficheiro para o controlador ou use o FPP.

Quantos píxeis consegue gerir o WLED? Depende da placa ESP32, da taxa de fotogramas, da rede e da alimentação. Teste a matriz real à taxa de fotogramas pretendida em vez de confiar num número de catálogo.

Descubra o Pixel LED Animator 3 · Ver todas as integrações · Ler o guia FSEQ para Falcon Player · Comprar a licença vitalícia