> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Zigbee (ZHA)

> Conecte um coordenador Zigbee ao Portal e controle dispositivos Zigbee nativos

# 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

<Steps>
  <Step title="Exponha o coordenador na rede">
    Se o coordenador for USB, use uma bridge tipo `ser2net` no edge para expor a porta serial via TCP.
  </Step>

  <Step title="Adicione a integração">
    Va em **Configurações → Integrações → Adicionar → Zigbee (ZHA)**.
  </Step>

  <Step title="Escolha o tipo do adaptador">
    Selecione entre `ezsp`, `zstack`, `deconz` ou `zigate` e informe host e porta TCP.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

<Info>
  Mantenha o coordenador longe de fontes de interferência (roteadores WiFi 2.4 GHz, USB 3.0) para garantir uma malha Zigbee estável.
</Info>