📌 Como os dispositivos SONOFF Zigbee funcionam com o Home Assistant

Introdução

Os dispositivos SONOFF Zigbee são uma ótima opção para construir uma rede doméstica inteligente local estável e responsiva. Com o Home Assistant como sua central de automação e um coordenador Zigbee, como o SONOFF Zigbee 3.0 USB Dongle Plus (ZBDongle-E ou ZBDongle-P), você pode controlar dispositivos SONOFF Zigbee, como o interruptor de parede inteligente ZBM5, sem depender da nuvem.

Este guia orientará você na integração dos dispositivos SONOFF Zigbee com o Home Assistant usando dois métodos:

• ZHA (Automação Residencial Zigbee)
• Z2M (Zigbee2MQTT)

Ambos oferecem excelente controle local, suporte de automação e compatibilidade com a linha de produtos SONOFF Zigbee.

Preparação

Antes de começar, certifique-se de ter o seguinte:

• Assistente de casa instalado e funcionando
• UM Coordenador Zigbee (por exemplo, Dongle USB SONOFF Zigbee 3.0 Plus-P / -E )
• Dispositivo SONOFF Zigbee: SONOFF ZBM5

Guia de configuração

Há duas maneiras de usar o SONOFF Zigbee 3.0 USB Dongle Plus para adicionar seus dispositivos Zigbee ao Home Assistant: ZHA ou Zigbee2MQTT.

Aqui vou apresentar

Siga aqui se você usa ZBDongle-E: Adicione ZBDongle-E ao HA

Siga aqui se você usa ZBDongle-P: Adicione ZBDongle-P ao HA

Depois de adicionar o SONOFF Zigbee 3.0 USB Dongle Plus ao Home Assistant, podemos adicionar dispositivos Zigbee ao HA para controle.

via ZHA

Etapa 1: Instalar e configurar o ZHA no Home Assistant

• Acesse o Home Assistant e navegue até Configurações → Dispositivos e serviços.
• Clique em “Adicionar integração” e procure por Zigbee Home Automation (ZHA) .
• Após a conclusão, você verá o ZHA configurado com sucesso no Home Assistant.

Etapa 2: adicione o SONOFF ZBM5 ao Home Assistant

1. No Home Assistant, navegue até Configurações > Dispositivos e serviços > ZHA > dispositivos .

2. Colocar o Coloque o SONOFF ZBM5 no modo de emparelhamento pressionando e segurando o botão físico por 5 segundos até que o LED comece a piscar.
3. Clique em “Adicionar dispositivo” e aguarde o ZHA descobrir o ZBM5.

4. Depois de encontrado, você pode renomear e atribuir o dispositivo a uma sala, se necessário.

via Z2M

Etapa 1: instalar complementos

Ao conectar o HA por meio do complemento Zigbee2MQTT, você precisa instalar os dois complementos a seguir:

1. Corretor Mosquitto (Corretor MQTT)
2. Zigbee2MQTT

Instalar o corretor Mosquitto

Vá para Configurações → Complementos → Loja de complementos e instale o complemento do corretor Mosquitto e inicie-o.

Instalar Zigbee2MQTT

1. Adicionar Repositório

Volte para a loja de complementos, clique em ” ⋮ “ → “ Repositórios “, preencha

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

e clique em Adicionar → Fechar ou clique no botão Adicionar repositório abaixo, clique em Adicionar → Fechar

Link de instalação

Instalar Zigbee2MQTT

Retorne à lista de lojas , encontre Zigbee2MQTT e prossiga com a instalação.

Etapa 2: Configurar Zigbee2MQTT

Abra o complemento Zigbee2MQTT → página Configuração .
Você precisa configurar o tipo de adaptador do dispositivo e o caminho da porta serial em serial.

O seguinte formato:

 adapter: Adapter Type
port: ZBDongle Serial Port Path

Exemplo de configuração:

Para ZBDongle-E (SONOFF Zigbee 3.0 USB Dongle Plus V2):

 adapter: ember
port: /dev/ttyUSB0

Para ZBDongle-P (SONOFF Zigbee 3.0 USB Dongle Plus):

 adapter: zstack
port: /dev/ttyUSB0

⚠️ O caminho da porta serial pode variar dependendo do sistema host. No Linux, você pode encontrar o caminho serial executando:

 ls -l /dev/serial/by-id

Exemplo de saída:

 coolkit@coolkit-All-Series:~$ ls -l /dev/serial/by-id
total  0
lrwxrwxrwx 1 root root 13 3月 31 18:09 usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_76536147c914ef11950378b8bf9df066-if00-port0 -> ../../ttyUSB0

O caminho da porta serial neste caso é:

 /dev/ttyUSB0

Após concluir a configuração, inicie o complemento Zigbee2MQTT . Aguarde cerca de dois minutos e clique para acessar o Console da Interface Web para adicionar e gerenciar dispositivos Zigbee.

Solução de problemas

Dispositivo não encontrado?

Certifique-se de que o ZBDongle seja detectado em /dev/ttyUSB*

Reinicie o Home Assistant após inserir o dongle

Afaste o dongle das portas USB 3.0 ou use um extensor USB

Tempo limite de pareamento?

Certifique-se de que o ZBM5 esteja no modo de emparelhamento (LED piscando)

Desligue e ligue o switch e tente novamente

​

O Z2M não inicia?

Verifique novamente o tipo de adaptador Zigbee e a porta em configuration.yaml

Perguntas frequentes

P: Posso usar o ZBM5 sem internet?
Sim. Tanto o ZHA quanto o Z2M são integrações locais , não sendo necessária nuvem após a configuração.

P: Posso atualizar o firmware do ZBM5 via Home Assistant?
Sim, você pode atualizar o firmware do dispositivo no Home Assistant.

P: Qual é a diferença entre ZHA e Zigbee2MQTT?
O ZHA é mais fácil de usar e integrado ao HA. O Z2M oferece mais controle, registros e suporte a dispositivos. Ambos são compatíveis com SONOFF.

P: Os mesmos recursos estão disponíveis no Home Assistant ao integrar dispositivos via ZHA e Z2M?

R: Não, não são exatamente iguais. Embora tanto o ZHA quanto o Z2M permitam controlar e monitorar dispositivos Zigbee no Home Assistant, existem diferenças no suporte a dispositivos, na flexibilidade de configuração e na exposição de recursos. Os recursos disponíveis podem variar dependendo do dispositivo específico e do método de integração.

P: Posso misturar ZHA e Z2M no mesmo Home Assistant?
Não. Você só pode usar uma integração Zigbee por dongle/instância, a menos que use coordenadores e canais Zigbee separados.