cardápio

🔎 Como adicionar dispositivos Zigbee com o Home Assistant usando a integração ZHA

Introdução

Os SONOFF ZBDongle-P e ZBDongle-E são gateways USB Zigbee projetados para integrar dispositivos Zigbee ao seu ecossistema de casa inteligente. Seja usando o Home Assistant, o iHost ou o Homebridge, esses dongles permitem a integração perfeita de dispositivos Zigbee da SONOFF e de terceiros.

Neste guia, você aprenderá como configurar seu ZBDongle com o Home Assistant usando a integração ZHA , adicionar dispositivos Zigbee e gerenciar sua rede mesh Zigbee com eficiência.

O que você precisa?

  • 1x SONOFF ZBDongle-P ou ZBDongle-E

  • Home Assistant instalado ( iHost , Home Assistant Green, Raspberry Pi, etc.)

  • Porta USB disponível para o dongle

  • Dispositivos Zigbee (por exemplo, plugue inteligente SONOFF, sensor de porta )

1. Insira o ZBDongle em uma porta USB

Comece conectando seu SONOFF ZBDongle à porta USB do seu dispositivo Home Assistant. Neste guia, usaremos um iHost, mas os passos são os mesmos para outras configurações, como o Home Assistant Green ou um Raspberry Pi.

2. Detecte o Dongle

Depois que o dongle estiver conectado e o sistema estiver ligado:

  • Vá para Configurações > Dispositivos e Serviços

  • Uma nova integração chamada ZHA deve aparecer automaticamente.

📝 Observação: caso não apareça, clique em “Adicionar integração” e procure manualmente por ZHA .

3. Inicie a configuração

Clique na integração ZHA e depois:

  • Selecione “Criar rede”


  • Aguarde alguns segundos para que o Home Assistant finalize a instalação

  • Agora você está pronto para começar a adicionar dispositivos Zigbee à sua rede

Com o ZBDongle instalado e o ZHA em execução, é hora de adicionar alguns dispositivos Zigbee.

Neste exemplo, adicionaremos:

  • 1x SONOFF Zigbee Smart Plug (funciona como repetidor)

  • 1x Sensor de porta SONOFF SNZB-04P (dispositivo final)

1. Entre no modo de emparelhamento

Acesse Configurações > Dispositivos e Serviços > Integração ZHA > Adicionar Dispositivo . O Home Assistant agora está monitorando dispositivos em modo de pareamento.



2. Emparelhe cada dispositivo

  • Smart Plug : Pressione e segure o botão por ~5 segundos até que ele entre no modo de emparelhamento. Ele deverá aparecer no Home Assistant em alguns segundos.

  • Sensor de porta : repita o mesmo processo (geralmente segurando o botão de reset/emparelhamento).

Você pode renomear dispositivos, atribuí-los a uma sala e começar a usá-los imediatamente.

📘 Para saber mais sobre as funções e o comportamento dos dispositivos Zigbee, confira o módulo Protocolos de casa inteligente na SONOFF Academy.

Controle e verifique o status do dispositivo

Uma vez adicionado, há duas maneiras de monitorar e controlar dispositivos Zigbee :

1. Na guia Dispositivos

  • Vá para Configurações > Dispositivos e Serviços > Dispositivos

  • Use o filtro para visualizar apenas dispositivos ZHA


2. Na página de integração do ZHA

  • Abra Configurações > Dispositivos e Serviços > ZHA

  • Ver todos os dispositivos pareados através do ZBDongle

  • Clique em qualquer dispositivo para verificar seu status , renomeá-lo ou controlá-lo (por exemplo, ligar/desligar um plugue inteligente)

Gerenciamento de rede Zigbee

O ZBDongle se torna o coordenador da sua rede Zigbee, gerenciando conexões e comunicações entre todos os dispositivos em uma estrutura de malha.

Recursos disponíveis na integração ZHA

  • Alterar canal Zigbee
    Alguns canais Zigbee podem interferir no Wi-Fi. Para um desempenho ideal, escolha um canal sem sobreposição. Você pode alterar isso nas configurações do coordenador .



    Selecione a aba "Rede" para ver e alterar o canal Zigbee, se desejar.



  • Ver mapa da rede Zigbee
    Clique no menu de três pontos (⋮) na página ZHA e selecione "Exibir rede" .
    Você verá uma representação visual da sua rede , mostrando:

    • O coordenador

    • Roteadores (por exemplo, plugues inteligentes que repetem o sinal)

    • Dispositivos finais (por exemplo, sensores de porta)

    • LQI (Indicador de Qualidade do Link) para cada conexão — quanto maior o LQI, mais forte o sinal.




      Aqui, podemos ver a rede Zigbee e as conexões entre os diferentes dispositivos.

📚 Para mais informações sobre a arquitetura Zigbee e o comportamento da malha, confira o módulo Protocolos de casa inteligente na SONOFF Academy.

Conclusão

O SONOFF ZBDongle-P e o ZBDongle-E são ferramentas poderosas para construir uma rede Zigbee flexível, escalável e estável no Home Assistant. Com a integração com o ZHA, você pode facilmente:

  • Adicionar e controlar dispositivos Zigbee

  • Monitore a intensidade do sinal e otimize o posicionamento

  • Visualize e gerencie sua estrutura de rede

  • Evite interferências na seleção de canais personalizados

Não importa se você está apenas começando ou expandindo uma configuração existente, este dongle facilita a integração de dispositivos SONOFF e Zigbee de terceiros ao seu ecossistema de casa inteligente.

Anterior
🔎 Como integrar o SONOFF R5/S-Mate ao Home Assistant?
Próximo
🔎 Como atualizar o firmware Zigbee no ZHA e Z2M
última modificação: 2025-08-19