Saltar para o conteúdo

Primeiros Passos com Controle de LED no Home Assistant: WLED, MQTT e Automações

Você construiu um controlador WLED, soldou sua fita e ajustou seus segmentos na interface web. A verdadeira mágica começa quando seus LEDs se juntam à sua casa inteligente — diminuindo ao pôr do sol, piscando vermelhos quando a porta abre enquanto você está fora, seguindo seu ritmo circadiano. O Home Assistant transforma o WLED de um controlador independente em um sistema de iluminação inteligente totalmente integrado.

Interface web do WLED mostrando integração com Home Assistant

Por Que Home Assistant + WLED?

Home Assistant é a principal plataforma de casa inteligente open-source — sem dependência de nuvem, tudo roda localmente. WLED é o firmware LED open-source mais popular, e seus desenvolvedores trabalharam intimamente com a comunidade Home Assistant para tornar a integração perfeita.

A combinação oferece:

  • Controle por voz — Alexa, Google Home e HomeKit funcionam imediatamente
  • Agendamentos — acionar predefinições no pôr do sol, nascer do sol ou a qualquer hora
  • Automações — luzes ativadas por movimento, alertas de porta, rotinas de despertar
  • Cenas — salvar e recallar estados de iluminação em múltiplos controladores WLED
  • Zero dependência de nuvem — tudo roda na sua LAN, internet não necessária

Cada recurso do WLED — segmentos, predefinições, brilho, cor, efeitos, velocidade e intensidade — é exposto como entidades nativas do Home Assistant. Nenhuma ponte, nenhum HACS, nenhuma configuração YAML.

Instalando a Integração WLED

A integração nativa do WLED vem com o Home Assistant 2023.5+.

  1. Vá para Configurações → Dispositivos e Serviços → Adicionar Integração
  2. Pesquise por WLED — ele descobre automaticamente instâncias WLED na sua rede via mDNS
  3. Clique para adicionar — a integração conecta automaticamente

Nenhuma configuração manual necessária. A integração lê tudo via HTTP: IP, porta, contagem de LEDs, definições de segmento. Cada segmento WLED se torna uma entidade de luz separada:

light.wled_sala_estar
light.wled_sala_estar_segmento_1 # luz de fundo da TV
light.wled_sala_estar_segmento_2 # luz de prateleira

Múltiplos controladores WLED aparecem cada um como seu próprio dispositivo com luzes por segmento e um interruptor de nível de dispositivo para ligar todo o controlador.

Configurando MQTT (Opcional mas Poderoso)

A integração HTTP nativa pesquisa mudanças de estado. Adicionar MQTT atualiza para atualizações push instantâneas — quando um pressionamento de botão físico acontece no controlador, o Home Assistant vê imediatamente.

Configuração do Mosquitto com um clique: instale o complemento Mosquitto (Configurações → Complementos → Loja de Complementos), inicie-o e configure a integração MQTT em Dispositivos e Serviços.

Habilitar MQTT no WLED: Config → Sincronizar Interfaces → habilitar MQTT, insira o IP e porta do seu broker (1883) e defina um Tópico de Dispositivo único (ex: wled/sala).

Cada mudança de estado agora publica em tempo real. A verdadeira vantagem: outros dispositivos controlam o WLED sem o Home Assistant — um sensor de movimento ESPHome pode publicar em wled/sala/seg/0/col e mudar cores diretamente. O MQTT também expõe predefinições WLED como entidades selecionáveis como select.wled_sala_estar_predefinicao.

Automações Úteis

Cinco automações que transformam LEDs de decorativos em genuinamente úteis.

Acender ao entardecer. Acione o WLED no pôr do sol usando a entidade sun.sun — sem agendamento de horário necessário:

alias: "LEDs Ligados ao Entardecer"
trigger:
  platform: sun
  event: sunset
  offset: "-00:15:00"
action:
  - service: light.turn_on
    target:
      entity_id: light.wled_sala_estar
    data:
      brightness_pct: 40
      color_temp: 400
      mode: single

Ativado por movimento. Clareie LEDs para 80% por 5 minutos quando o movimento disparar:

alias: "LEDs do Corredor por Movimento"
trigger:
  platform: state
  entity_id: binary_sensor.movimento_corredor
  to: "on"
action:
  - service: light.turn_on
    target:
      entity_id: light.wled_corredor
    data:
      brightness_pct: 80
      rgb_color: [255, 220, 180]
  - delay: "00:05:00"
  - service: light.turn_off
    target:
      entity_id: light.wled_corredor

Alerta de porta. Piscar LEDs vermelhos quando a porta da frente abre enquanto a residência está armada para fora:

alias: "Alerta de Porta LEDs"
trigger:
  platform: state
  entity_id: binary_sensor.porta_da_frente
  to: "on"
condition:
  condition: state
  entity_id: alarm_control_panel.alarme_casa
  state: armed_away
action:
  - service: light.turn_on
    target:
      entity_id: light.wled_sala_estar
    data:
      rgb_color: [255, 0, 0]
      effect: "Blink"
      brightness_pct: 100

Luz de despertar. Clareie gradualmente por 15 minutos — mais suave que qualquer despertador de celular:

alias: "Luz de Despertar"
trigger:
  platform: time
  at: "06:30:00"
action:
  - service: light.turn_on
    target:
      entity_id: light.wled_quarto
    data:
      brightness_pct: 1
      kelvin: 2700
  - service: light.turn_on
    target:
      entity_id: light.wled_quarto
    data:
      brightness_pct: 80
      transition: 900
      mode: single

Hora da TV. Diminua LEDs para 10% quando a mídia começa a tocar:

alias: "Dimming para Hora da TV"
trigger:
  platform: state
  entity_id: media_player.tv_sala_estar
  to: "playing"
action:
  - service: light.turn_on
    target:
      entity_id: light.wled_sala_estar
    data:
      brightness_pct: 10
      rgb_color: [255, 100, 50]

Criando Cenas

As predefinições WLED são automaticamente expostas no Home Assistant como entidades semelhantes a cenas. Salve uma predefinição na interface WLED e ela aparece no Home Assistant imediatamente.

  • Noite de Cinema — branco quente a 10%, luz de fundo atrás da TV
  • Festa — brilho total, ciclo de cores, velocidade 200
  • Leitura — branco quente (2700K) a 50%

Acione-as de painéis, tags NFC na sua porta ou inclua-as em uma rotina Boa Noite que apaga luzes, tranca portas e arma o alarme em um comando.

Controle por Voz

O Home Assistant expõe o WLED para Alexa, Google Home e Apple HomeKit através de suas pontes de nuvem ou integrações locais.

  • “Alexa, defina os LEDs da sala para azul”
  • “Hey Google, diminua a fita da cozinha para 20%”

Nenhuma configuração extra do WLED necessária. Exponha segmentos individuais como luzes separadas ou todo o controlador como uma só. Para controle por voz totalmente local, use o pipeline Assist com um satélite de voz ESP32-S3 — nenhuma nuvem envolvida.

Agendamentos Astronômicos

A entidade sol vai além de ligar/desligar simplesmente no pôr do sol. Use atributos de sun.sun para acionar diferentes predefinições com base no horário da noite:

  • Crepúsculo civil (sol 6° abaixo do horizonte) — branco quente a 40%
  • Horário noturno (sol 12°+ abaixo) — vermelho fraco a 10% para visão noturna
  • Alvorada astronômica — transição para cores matinais antes do nascer do sol

Iluminação Adaptativa ajusta a temperatura de cor ao longo do dia — 5000K frio ao meio-dia, 2200K quente à meia-noite. Habilite-a para suas entidades WLED e elas acompanham a curva natural do sol automaticamente.

Para variedade, adicione um script de randomização diária que escolhe uma predefinição de cor diferente cada noite. Seus LEDs nunca são iguais em duas noites seguidas — um toque pequeno que mantém instalações permanentes parecendo novas.