Home Assistant + WLED: crie uma automação de efeitos recuperável

PONTO DE CONTROLE / 01

Dê uma função a cada camada

O WLED gere no controlador a temporização dos píxeis, os segmentos e os efeitos. O Home Assistant gere acima dessa camada o contexto do espaço, os horários e as automações. O fluxo só é fiável quando a entidade WLED exata e o caminho de rede chamado foram verificados.

• Mantenha o protocolo de píxeis, o mapa de segmentos e os efeitos na camada do dispositivo WLED.
• Use o Home Assistant para contexto e comandos, não como substituto do controlador ou do caminho de alimentação.
• Registe em conjunto a entidade, o caminho de integração, o firmware e o comportamento após reinício.

PONTO DE CONTROLE / 02

Torne recuperável um estado WLED conhecido

Guarde no WLED um preset local ou estado de efeito testado antes de criar uma automação complexa. Registe o segmento, o limite de brilho, o efeito, a paleta, o identificador do preset quando for exposto e o comportamento depois de reiniciar o WLED. Um preset é um estado recuperável para uma configuração concreta; não prova o comportamento de outro controlador, firmware ou variante de fita.

• Nomeie o estado pela divisão e pela intenção, não por uma experiência temporária.
• Mantenha brilho e velocidade do efeito dentro do intervalo medido para a instalação.
• Confirme quais os presets ou opções de efeito expostos pela entidade exata do Home Assistant.

PONTO DE CONTROLE / 03

Comece com uma ação previsível

Acione uma entidade, chame um efeito ou preset conhecido e verifique o resultado na instância real do Home Assistant. O exemplo usa uma entidade de luz e uma opção de efeito exposta; substitua os valores pelas entidades e opções que foram realmente testadas. Só depois de estabilizar o caminho adicione presença, multimédia e horários.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

PONTO DE CONTROLE / 04

Teste o caminho de falha e reinício

Teste a automação com o reinício do WLED, o reinício do Home Assistant, a indisponibilidade temporária da rede e o regresso da alimentação do controlador. Decida se a luz fica desligada, regressa a um estado local do WLED ou aguarda um novo comando do Home Assistant. Não descreva a recuperação como automática até obter esse resultado com o controlador, firmware, integração e sequência de alimentação exatos.

• Separe no registo o reinício do dispositivo WLED do reinício do Home Assistant.
• Verifique o estado comunicado pela entidade quando o controlador não está acessível.
• Mantenha uma recuperação local ou manual para manutenção e falhas de rede.

PONTO DE CONTROLE / 05

Adicione cenas e condições sem esconder as responsabilidades

Depois de repetir a ação única, use uma cena do Home Assistant ou condições adicionais para expressar a intenção do espaço. Mantenha visíveis no registo o efeito WLED, a atribuição de segmentos e o limite de brilho. Para vários segmentos, documente qual entidade controla cada segmento e teste ações simultâneas; ligar uma entidade de luz não define automaticamente um espetáculo seguro de vários segmentos.

• Adicione uma condição de cada vez e conserve a ação base para diagnóstico.
• Guarde na nota de montagem a entidade, o efeito ou preset, o âmbito do segmento e a recuperação esperada.
• Trate presença multimédia, horários e painéis como contexto opcional em torno de um caminho de luz testado.

MODOS DE FALHA

O que costuma dar errado

• A automação depende de um nome de efeito ou preset que mudou entre versões de firmware.
• A cena pressupõe canais RGBW ou segmentos que a entidade escolhida não expõe.
• Espera-se que o Home Assistant substitua a temporização do WLED, o controlador ou o caminho de alimentação.
• A primeira ação funciona, mas os reinícios do WLED, do Home Assistant e a perda de rede nunca são testados separadamente.
• Não existe uma recuperação local ou manual documentada após o reinício do controlador ou a falha da integraçã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.