Guia Completo de Integração do Dispositivo SONOFF com Home Assistant

Introdução

O Home Assistant é uma plataforma popular de casa inteligente de código aberto. Ele roda em Raspberry Pi, computadores, dispositivos NAS, etc., unificando dispositivos de diferentes marcas e protocolos em uma única plataforma.
Duas razões principais para escolher o Home Assistant:

• Operação local, soberania dos dados: Todos os dados permanecem no seu próprio servidor — sem dependência da nuvem. Os dispositivos continuam funcionando mesmo quando a internet está fora do ar, e seus padrões de uso e dados de cena permanecem privados.
  
• Ecossistema aberto, suporte a vários protocolos: O Home Assistant suporta Zigbee, Wi-Fi, Matter, MQTT, Z-Wave e praticamente todos os principais protocolos de casa inteligente — integrando dispositivos de diferentes marcas em uma única interface para criar automações em conjunto.

A SONOFF oferece uma ampla gama de dispositivos: módulos para retrofit DIY, interruptores de parede, termostatos, válvulas de água, diversos sensores e muito mais. Para tornar os dispositivos SONOFF acessíveis aos usuários do Home Assistant, a SONOFF fornece múltiplos caminhos de integração para cada protocolo e tipo de dispositivo.

Este blog explica cada método de integração e ajuda você a escolher o mais adequado para suas necessidades.

1. Dispositivos Zigbee

Zigbee é um protocolo de rede mesh de baixo consumo. Os dispositivos Zigbee da SONOFF incluem vários sensores (movimento PIR, presença humana, temperatura/umidade, etc.), interruptores/tomadas inteligentes, interruptores de parede, termostatos e válvulas de água.

Existem três maneiras de conectar dispositivos Zigbee ao Home Assistant, abrangendo desde "controle local puro" até "sincronização entre duas plataformas".

1.1 Conexão Direta do Dongle

Como funciona: A maioria dos hosts do Home Assistant não possui capacidade de rádio Zigbee embutida — é necessário um Dongle Zigbee (adaptador) para enviar e receber sinais Zigbee. A linha Dongle SONOFF é um produto de destaque nesse segmento.

Dispositivos compatíveis: Quase todos os dispositivos SONOFF Zigbee podem ser conectados via Dongle.
Método de integração:

Após configurar o Dongle no Home Assistant via a integração ZHA (Zigbee Home Automation) ou Zigbee2MQTT (Z2M), os dispositivos SONOFF Zigbee são automaticamente detectados e adicionados como entidades no Home Assistant, prontos para automações e cenas.

• ZHA: Integrado no Home Assistant Core; configuração simples, adequado para a maioria dos usuários
  
• Zigbee2MQTT: Recursos mais ricos, ecossistema comunitário maior, suporta mais tipos de dispositivos e opções de personalização

*Se não tem certeza de qual Dongle escolher, confira o Guia de Seleção de Dongle SONOFF:

https://sonoff.tech/blogs/news/sonoff-zigbee-thread-dongle-choosing-guide

*Para passos detalhados de configuração ou solução de problemas, visite o site dedicado ao Dongle:

https://dongle.sonoff.tech/

⚠️ Importante: Dispositivos Zigbee adicionados via Dongle aparecem apenas no Home Assistant — não podem ser controlados pelo App eWeLink. Se você precisa gerenciar dispositivos tanto pelo Home Assistant quanto pelo eWeLink, veja a opção Matter Bridge abaixo.

1.2 Sincronização Matter Bridge

Como funciona: O ZBBridge-U (Zigbee Bridge Ultra) e o NSPanel Pro da SONOFF são dispositivos com funcionalidade dupla embutida: gateway Zigbee + Matter Bridge. Você pode primeiro adicionar dispositivos Zigbee SONOFF ao App eWeLink e depois sincronizá-los com o Home Assistant como "dispositivos Matter locais" via protocolo Matter Bridge.

Por que escolher o Matter Bridge?

• Controle em duas plataformas: Os dispositivos podem ser gerenciados tanto no App eWeLink (controle remoto, automação de cenas) quanto no Home Assistant
• Comunicação local: Após sincronizar com o Home Assistant, os dispositivos funcionam como dispositivos Matter padrão — a comunicação é totalmente baseada na LAN, sem dependência de nuvem
• Suporte amplo a dispositivos: Não apenas subdispositivos Zigbee — também sincroniza dispositivos Wi-Fi na LAN e controles remotos de cena eWeLink-Remote
  

Ideal para:

• Usuários que desejam controlar dispositivos tanto pelo Home Assistant quanto pelo eWeLink
• Usuários já familiarizados com o ecossistema eWeLink que não querem abrir mão do controle remoto via App

1.3 Sincronização MQTT

Ideal para: Usuários familiarizados com a integração MQTT do Home Assistant que precisam preservar capacidades e configurações do dispositivo além do que o padrão Matter define.
O protocolo Matter define um conjunto padronizado de capacidades de dispositivos (por exemplo, ligar/desligar), mas alguns dispositivos SONOFF possuem recursos estendidos específicos do fabricante. Esses recursos podem ser preservados no modo de conexão direta MQTT, enquanto podem ser simplificados no modo de sincronização Matter Bridge.

Nota: A integração MQTT requer algum conhecimento de configuração e NSPanel Pro ou ZBBridge-U.

*Para passos detalhados de configuração, veja:

https://sonoff.tech/blogs/news/how-to-sync-zigbee-sub-devices-to-home-assistant-via-mqtt

2. Dispositivos Wi-Fi

Dispositivos Wi-Fi SONOFF incluem vários módulos retrofit, interruptores de parede, tomadas e mais — distribuídos pela casa, controlando luzes em diferentes cômodos. Dependendo se o dispositivo suporta o protocolo Matter, existem diferentes formas de adicioná-los ao Home Assistant.

2.1 Dispositivos Certificados Matter — Adição Direta

Ideal para: Dispositivos com selo de certificação Matter (verifique a página do produto ou embalagem para o selo Matter).

Matter é o protocolo de interoperabilidade para casas inteligentes de próxima geração, desenvolvido pela CSA (Connectivity Standards Alliance). Dispositivos certificados Matter têm a vantagem da "padronização": as capacidades do dispositivo são definidas pelo próprio protocolo, então adicioná-los a qualquer plataforma compatível com Matter (Home Assistant, Apple Home, Google Home, etc.) não requer drivers ou plugins adicionais.

Passos para configuração:

1. Certifique-se de que a integração Matter está instalada no Home Assistant (adicione via "Configurações → Dispositivos & Serviços")

2. Abra o App eWeLink com seu dispositivo vinculado e confirme que o dispositivo está online

3. No Home Assistant, procure e adicione um dispositivo Matter, depois escaneie o código QR com o App eWeLink conforme solicitado para completar o pareamento

Uma vez adicionado, o dispositivo aparece no Home Assistant como um dispositivo Matter padrão — todas as funcionalidades padrão (estado do interruptor, controle de brilho, etc.) funcionam imediatamente.

*Documentação oficial do Matter para Home Assistant: 

https://www.home-assistant.io/integrations/matter

2.2 Dispositivos Não-Matter — Sincronização via Matter Bridge ou Complemento eWeLink

Ideal para: Modelos mais antigos sem suporte ao firmware Matter, onde você ainda quer ver e controlar os dispositivos pelo Home Assistant.

Estes dispositivos podem ser sincronizados com o Home Assistant via Matter Bridge ou o Complemento eWeLink Smart Home. A funcionalidade do Matter Bridge está descrita acima. O Complemento eWeLink Smart Home funciona baixando o complemento no Home Assistant e fazendo login na sua conta eWeLink — os dispositivos sincronizados aparecem como cartões de entidade no Home Assistant, suportando operações básicas como alternar interruptores.

Para detalhes do Add-on, veja:

https://github.com/iHost-Open-Source-Project/hassio-ihost-addon

3. Dispositivos eWeLink-Remote

eWeLink-Remote é a solução de controle remoto de cena local da SONOFF projetada para o App eWeLink. Dispositivos típicos incluem:

• R5: controle remoto multi-cena, suporta vincular múltiplos dispositivos ou cenas simultaneamente
• S-mate2: interruptor DIY, projetado para funcionar com interruptores externos

Agora, dispositivos eWeLink-Remote suportam integração com o Home Assistant via Matter Bridge — você pode usá-los como controles remotos de cena locais dentro do Home Assistant.

Como funciona: Use a função Matter Bridge no ZBBridge-U ou NSPanel Pro para sincronizar dispositivos eWeLink-Remote com o Home Assistant, depois configure automações locais acionadas pelo controle remoto.

 

Não existe uma única "resposta certa" para conectar dispositivos SONOFF ao Home Assistant — depende dos seus hábitos de uso e prioridades:

Se você busca controle local puro, estável e definitivo, a conexão direta via Dongle é a melhor escolha;

Se você quer sinergia entre as duas plataformas Home Assistant e eWeLink, o Matter Bridge oferece uma experiência mais equilibrada;

Para usuários com algumas habilidades de DIY que desejam preservar mais recursos estendidos do dispositivo, o MQTT oferece maior liberdade;

Enquanto isso, à medida que o ecossistema Matter amadurece, cada vez mais dispositivos Wi-Fi podem alcançar uma experiência de integração "pronta para uso" por meio da padronização.

A SONOFF continuará a abraçar o ecossistema da comunidade open-source, trazendo para você uma vida inteligente mais conveniente e confortável.