Integração e API

Zigbee2MQTT

Equivalente a um tradutor entre rádio Zigbee e mensageria MQTT, Zigbee2MQTT usa um coordenador USB ou de rede para parear dispositivos e publicar estados em tópicos. Integra-se a Mosquitto, Home Assistant e Node-RED, suporta milhares de modelos e expõe recursos por JSON. Opera geralmente em 2,4 GHz no lado Zigbee e 1883/8883 no MQTT. A flexibilidade reduz dependência de hubs, mas exige coordenador compatível, broker, backups e manutenção de firmware.

🔀 Tipos de Comunicação

Zigbee

Rede Zigbee

O coordenador forma a rede, pareia dispositivos, mantém chaves e recebe clusters e atributos pelo rádio IEEE 802.15.4.

MQTT

Broker MQTT

Estados e comandos são publicados em tópicos com payloads JSON, permitindo múltiplos consumidores desacoplados.

Discovery

MQTT discovery

Entidades podem ser criadas automaticamente no Home Assistant com nomes, classes e capacidades apropriadas.

Bridge

API e frontend

Interface web e tópicos de bridge permitem pareamento, configuração, atualização e diagnóstico da rede.

✅ Vantagens Arquiteturais

⚡

Independência de hubs proprietários

Um coordenador compatível substitui várias pontes e mantém os dispositivos em infraestrutura controlada localmente.

⚡

Ampla cobertura de dispositivos

Conversores específicos expõem atributos, comandos e opções de milhares de modelos Zigbee.

⚡

Integração desacoplada

Home Assistant, Node-RED, scripts e bancos podem consumir os mesmos tópicos MQTT.

⚡

Diagnóstico detalhado

Mapa de rede, LQI, rotas, logs e opções avançadas ajudam a investigar falhas de malha.