Skip to main content

​
Zigbee (ZHA)

A integração ZHA conecta um coordenador Zigbee ao Portal, permitindo controlar diretamente dispositivos Zigbee (luzes, switches, sensores, cortinas, fechaduras, climatização) sem depender de hubs de fabricantes. Adaptadores suportados:
  • EZSP — Silicon Labs (Sonoff Zigbee 3.0, Home Assistant SkyConnect)
  • Z-Stack — Texas Instruments (CC2531, CC2652)
  • deCONZ — Dresden Elektronik (ConBee II, RaspBee II)
  • ZiGate — ZiGate USB / Ethernet

​
Pre-requisitos

  • Coordenador Zigbee ligado em uma bridge de rede (ex.: ser2net para expor um USB-serial via TCP)
  • Endereço IP/host e porta TCP da bridge
  • Dispositivos Zigbee que serão emparelhados após a criação do entry

​
Configurar

1

Exponha o coordenador na rede

Se o coordenador for USB, use uma bridge tipo ser2net no edge para expor a porta serial via TCP.
2

Adicione a integração

Va em Configurações → Integrações → Adicionar → Zigbee (ZHA).
3

Escolha o tipo do adaptador

Selecione entre ezsp, zstack, deconz ou zigate e informe host e porta TCP.
4

Emparelhe dispositivos

Após o entry ser criado, use o painel Zigbee do Portal para colocar o coordenador em modo de emparelhamento e adicionar seus dispositivos.

​
Recursos

Dispositivos Zigbee emparelhados aparecem como entidades nativas:
  • light — on/off, brilho, cor
  • switch — on/off/toggle
  • cover — abrir/fechar/parar/posicionar
  • climate — modo HVAC, temperatura alvo
  • fan — velocidade
  • lock — trancar/destrancar
  • sensor e binary_sensor — temperatura, umidade, movimento, contato, etc.

​
Como Funciona

O probe apenas valida a conexão TCP com o coordenador — a integração não pré-emparelha dispositivos. Após o entry ser criado, o edge assume o controle do coordenador e cada novo dispositivo Zigbee aparece automaticamente conforme é emparelhado.
Mantenha o coordenador longe de fontes de interferência (roteadores WiFi 2.4 GHz, USB 3.0) para garantir uma malha Zigbee estável.