Zigbee Home Automation no Home Assistant
zha
parte do Home Assistant desde 0.44
A integração Zigbee Home Automation conecta dispositivos via hub local, permitindo o controle de sensores, iluminação, climatização e segurança. É usada para monitorar ambientes, automatizar tarefas e integrar dispositivos sem fio à central do Home Assistant.
Utilização típica
- Segurança residencial
- controle de iluminação
- Monitoramento ambiental
- automatização de climatização
Factos sobre esta integração
- Compatível com o Home Assistant
- sim, integração oficial
- Ligação
- Local, sondagem – Fala com o dispositivo na sua própria rede e pede alterações em intervalos regulares.
- Configurar
- na interface do utilizador
- Tipo
- Hub – vários dispositivos por meio de um gateway ou conta
- Instalações
- 144.890 (20,1 % das instalações que partilham estatísticas)
- Categorias
- Alarme, Sensor binário, Botão, Clima, Coberturas, Rastreador de dispositivos, Evento, Ventilador, Hub, Infravermelho, Luz, Bloquear, Número, Seleccionar, Sensor, Sirene, Interruptor, Atualizar, Válvula
- Fornece
- Painel de controle de alarme, Sensor binário, Botão, Clima, Coberturas, Rastreador de dispositivos, Diagnósticos, Evento, Ventilador, Infravermelho, Luz, Bloquear, Número, Seleccionar, Sensor, Sirene, Interruptor, Atualizar, Válvula
- Encontrado automaticamente através de
- Descoberta de rede (Zeroconf), USB
- Mantido por
- @dmulcahey, @adminiuga, @puddly, @TheJulianJES
- Pacotes Python
zha==2.4.2, zha-quirks==2.4.0
Configurar
- Home Assistant pode encontrar esta integração por conta própria: se for sugerido em Definições → Dispositivos e serviços, confirme-o lá.
- No Home Assistant abrir Definições → Dispositivos e serviços.
- Clique em "Adicionar integração" e procure por Zigbee Home Automation.
- Siga o diálogo – pede tudo o que a integração precisa.
Adicionar ao meu Home Assistant
O link passa por my.home-assistant.io e abre o diálogo de configuração em sua própria instância – nenhum endereço nosso está envolvido.
Blueprints que usam esta integração
- Automação Controller - IKEA E2001/E2002 STYRBAR Remote control
- Automação ZHA - Philips Hue Dimmer Switch
- Automação IKEA Rodret Dimmer Controls (ZHA/Z2M)
- Automação Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote
- Automação ZHA - IKEA five button remote for lights
- Automação Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer
Problemas e correções conhecidos
No rastreador de problemas do Home Assistant estão registados para Zigbee Home Automation 45 problemas abertos e 26 correções de erros nos últimos doze meses. Se algo não funcionar, atualize primeiro: a correção mais recente incluída com Home Assistant 2026.10.1.
Abrir
- aberto The LED on the ZBT-2 device isn't working properly. Afeta: Silabs series 2 router
- aberto ZHA events appear in the logbook and can't be excluded.
- aberto The ZHA application controller isn't starting correctly.
- aberto ZHA gets stuck during the initialization process.
- aberto Problema relatado #188325 Afeta: SONOFF ZBMINIL2 SONOFF ZBMINIR2
- aberto Zigbee devices stop working after a Home Assistant update.
- aberto Zigbee blinds sometimes don't respond to control commands. Afeta: Silabs series 2 router
- aberto ZHA occasionally fails to control Zigbee blinds.
Fixo
- fixado em 2026.10.1 The ZHA reconfigure websocket subscription didn't return a result.
- fixado em 2026.10.0 The ZHA Inovelli LED effect didn't work as expected.
- fixado em 2026.7.2 ZHA device triggers didn't recognize specific device quirks.
- fixado em 2026.5.4 ZHA incorrectly blocked minor version downgrades.
- fixado em 2026.5.3 ZHA config entries used a URI without a port.
- fixado em 2026.3.0 ZHA update entities stopped working after a reload.
- fixado em 2026.2.2 ZHA was updated to version 0.0.90.
- fixado em 2026.2.0 ZHA was updated to version 0.0.88.
- fixado em 2025.12.1 ZHA displayed incorrect adapter state messages.
- fixado em 2025.12.1 ZHA didn't show errors when network formation failed.
- fixado em 2025.12.0 ZHA network formation had issues.
- fixado em 2025.11.1 Correcção de erros #155867
Fonte: o rastreador de problemas do Home Assistant, a partir de 2 de Novembro, 2026. As frases são escritas por um modelo de linguagem a partir dos títulos das questões; os próprios relatórios estão no GitHub.
Verifique um dispositivo específico para problemas conhecidos na verificação do produto →
Dispositivos compatíveis
Fonte desta entrada: documentação oficial da integração
A descrição foi escrita por um modelo de linguagem a partir dos fatos aqui listados, não retirado da documentação.