WLED, xLights e FPP: decida que camada é responsável pelo espetáculo

PONTO DE CONTROLE / 01

Atribua um responsável a cada camada e saída

O WLED pode fornecer efeitos ou predefinições locais, o xLights pode definir a temporização de uma sequência e o FPP pode assumir a reprodução agendada quando o hardware e a configuração exatos suportarem esse percurso. Os protocolos de rede transportam dados entre camadas; não decidem qual é responsável por uma saída. Escreva o responsável junto de cada saída, predefinição, sequência e tarefa de reprodução.

• Indique o sistema autorizado a escrever em cada saída durante o funcionamento normal.
• Separe geração de efeitos, autoria da sequência, agendamento e transporte.
• Não deixe dois emissores assumir a mesma saída sem testar explicitamente a transferência.

PONTO DE CONTROLE / 02

Fixe o contrato de pixels e mapeamento antes de criar a sequência

Registe a fita ou o motor de luz exatos, pixels físicos, endereços ou grupos controláveis, ordem de cores, tensão, saída do controlador, percurso do recetor, universo, endereço inicial, canais e atualização pretendida. Uma sequência pode parecer correta no software enquanto a ordem ou o agrupamento instalados são diferentes. Trate a exportação do mapeamento como uma interface versionada entre o ficheiro do espetáculo e o hardware.

• Versione o mapeamento com o espetáculo, firmware e variante configurada exata.
• Mantenha pixels físicos, grupos lógicos e endereços de rede em campos separados.
• Não use o título de um produto ou o nome de um protocolo como prova do mapeamento.

PONTO DE CONTROLE / 03

Escolha deliberadamente o transporte e a temporização

DDP, E1.31, Art-Net e o protocolo do controlador ocupam partes diferentes do percurso de dados. Decida onde a temporização é gerada, que dispositivo recebe o fluxo e como são transportados os limites de universo ou canal. Os nomes não são garantias permutáveis: o controlador, recetor, firmware e configuração do espetáculo exatos devem documentar ou testar o percurso de ligação.

• Registe transporte, universo, intervalo de canais ou endereços e frequência de fotogramas.
• Use uma única fonte de tempo no percurso em direto e documente qualquer transferência agendada.
• Meça a carga de rede e a atualização com a contagem de pixels, brilho e complexidade de cena previstos.

owner: effects | sequence | playback | transport
contract: pixels + groups + color_order + voltage
map: output -> receiver_or_strip -> universe -> address
recovery: stop_playback -> local_mode -> restore_owner

PONTO DE CONTROLE / 04

Crie um percurso de serviço que contorne a reprodução

Um espetáculo não é reparável se um reprodutor ou uma rede avariados impedirem um teste local da luz. Guarde uma predefinição WLED conhecida ou um modo local documentado e defina como isolar uma saída, recetor ou ramo. Teste perda de rede, paragem do reprodutor, reinício do controlador, recuperação da alimentação e regresso ao responsável agendado sem deixar dois sistemas ativos.

• Mantenha uma recuperação local que não dependa da sequência completa.
• Documente a ordem para parar a reprodução e devolver a responsabilidade ao controlador previsto.
• Separe falha de dados de falha de alimentação ao diagnosticar uma saída apagada.

PONTO DE CONTROLE / 05

Coloque em serviço desde uma saída até ao espetáculo completo

Comece com uma saída curta conhecida e verifique preto, branco total, cores, contagem, agrupamento, atualização e reinício. Depois acrescente a sequência e a reprodução, adicionando saídas uma de cada vez. Em cada passo compare o resultado com o mapeamento, meça o comportamento da rede e da alimentação e repita a revisão quando mudar a fita, controlador, recetor, firmware ou versão do espetáculo.

• Guarde um ponto de controlo conhecido antes de adicionar a camada seguinte.
• Teste o brilho máximo pedido e a maior carga de rede que o espetáculo possa criar.
• Entregue o mapa de responsáveis, a exportação do mapeamento, os passos de recuperação e a configuração exata testada.

MODOS DE FALHA

O que costuma dar errado

• WLED e o reprodutor do espetáculo controlam a mesma saída sem uma transferência definida.
• O mapeamento da sequência não corresponde à ordem física dos pixels, ao agrupamento ou à ordem de cores.
• Os limites de transporte, universo, canal e atualização são assumidos pelos nomes e não pelo percurso exato.
• A reprodução falha e não existe modo local para isolar controlador, recetor ou ramo de alimentação.
• Um teste curto de efeitos passa, mas branco total, carga de rede, reinício ou recuperação falham depois da expansão.

BASE TÉCNICA / VERSÃO

Mantenha a decisão atualizada

Este guia é mantido como um registro técnico versionado. Verifique novamente a documentação atual do protocolo e a revisão exata do produto antes de usá-lo em uma instalação de produção.