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

Introdução

O Home Assistant é uma plataforma popular de casa inteligente open-source. Funciona em Raspberry Pi, computadores, dispositivos NAS, etc., unificando dispositivos de diferentes marcas e protocolos numa ú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 cloud. Os dispositivos continuam a funcionar mesmo quando a internet está indisponível, e os seus padrões de uso e dados das cenas mantêm-se privados.
  
• Ecossistema aberto, suporte a múltiplos 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 numa única interface para criar automações em conjunto.

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

Este blog guia-o por cada método de integração e ajuda-o a escolher o mais adequado às suas necessidades.

1. Dispositivos Zigbee

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

Existem três formas de ligar dispositivos Zigbee ao Home Assistant, abrangendo desde o "controlo local puro" até à "sincronização em dupla plataforma".

1.1 Ligação direta do Dongle

Como funciona: A maioria dos hosts do Home Assistant não tem capacidade de rádio Zigbee integrada — é necessário um Dongle Zigbee (adaptador) para enviar e receber sinais Zigbee. A série SONOFF Dongle é um produto de destaque nesta área.

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

Após configurar o Dongle no Home Assistant através da integração ZHA (Zigbee Home Automation) ou Zigbee2MQTT (Z2M), os dispositivos SONOFF Zigbee são automaticamente detetados 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 utilizadores
  
• Zigbee2MQTT: Funcionalidades mais ricas, ecossistema comunitário maior, suporta mais tipos de dispositivos e opções de personalização

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

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

*Para passos detalhados de configuração ou resoluçã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 pela App eWeLink. Se precisar de gerir dispositivos tanto no Home Assistant como no 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 integrada: gateway Zigbee + Matter Bridge. Pode primeiro adicionar dispositivos Zigbee SONOFF à App eWeLink e depois sincronizá-los com o Home Assistant como "dispositivos Matter locais" via o protocolo Matter Bridge.

Por que escolher o Matter Bridge?

• Controlo em duas plataformas: Os dispositivos são geridos tanto na App eWeLink (controlo remoto, automação de cenas) como no Home Assistant
• Comunicação local: Após sincronização com o Home Assistant, os dispositivos funcionam como dispositivos Matter padrão — a comunicação é totalmente baseada na LAN, sem dependência da cloud
• Suporte amplo a dispositivos: Não só subdispositivos Zigbee — também sincroniza dispositivos Wi-Fi na LAN e comandos remotos de cenas eWeLink-Remote
  

Ideal para:

• Utilizadores que querem controlar dispositivos tanto a partir do Home Assistant como do eWeLink
• Utilizadores já familiarizados com o ecossistema eWeLink que não querem abdicar do controlo remoto via App

1.3 Sincronização MQTT

Ideal para: Utilizadores familiarizados com a integração MQTT do Home Assistant que precisam de preservar capacidades e definições dos dispositivos para 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 têm funcionalidades estendidas específicas do fabricante. Estas funcionalidades podem ser preservadas no modo de ligação direta MQTT, enquanto podem ser simplificadas 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

Os dispositivos Wi-Fi SONOFF incluem vários módulos retrofit, interruptores de parede, tomadas e mais — distribuídos pela casa, controlando luzes em diferentes divisões. Dependendo se um dispositivo suporta o protocolo Matter, existem diferentes formas de os adicionar ao Home Assistant.

2.1 Dispositivos Certificados Matter — Adição Direta

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

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

Passos de configuração:

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

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

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

Uma vez adicionado, o dispositivo aparece no Home Assistant como um dispositivo Matter padrão — todas as funcionalidades padrão (estado do interruptor, controlo 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 ainda quer ver e controlar dispositivos a partir do Home Assistant.

Estes dispositivos podem ser sincronizados com o Home Assistant através do Matter Bridge ou do Complemento eWeLink Smart Home. A funcionalidade do Matter Bridge está descrita acima. O Complemento eWeLink Smart Home funciona ao descarregar o complemento no Home Assistant e iniciar sessão 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 comando de cena local da SONOFF concebida para a App eWeLink. Os dispositivos típicos incluem:

• R5: comando multi-cena, suporta ligação de múltiplos dispositivos ou cenas simultaneamente
• S-mate2: interruptor DIY, concebido para funcionar com interruptores externos

Agora, os dispositivos eWeLink-Remote suportam integração com o Home Assistant via Matter Bridge — pode usá-los como comandos 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 comando remoto.

 

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

Se procura controlo local puro, estável e máximo, a ligação direta por Dongle é a melhor escolha;

Se pretende sinergia entre duas plataformas, Home Assistant e eWeLink, o Matter Bridge proporciona uma experiência mais equilibrada;

Para utilizadores com algumas competências de DIY que querem preservar mais funcionalidades estendidas do dispositivo, o MQTT oferece maior liberdade;

Entretanto, à medida que o ecossistema Matter amadurece, cada vez mais dispositivos Wi-Fi podem alcançar uma experiência de integração "pronta a usar" através da padronização.

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