Intellihome
ZHA (Zigbee Home Automation)
Co to je: Nativní Zigbee integrace v Home Assistantu. Je to hardwarově nezávislá Zigbee brána, která nahradí většinu proprietárních hubů a bridgů výrobců. Vytvoří jednu Zigbee síť, do které přidáš většinu Zigbee zařízení. dok. HA Alternativou je Zigbee2MQTT.
Klíčové vlastnosti
- Coordinator: USB adaptér (např. Connect ZBT-2), nebo síťový coordinator přes TCP socket, typicky
tcp://<ip>:6638. dok. HA manuál SLZB-OS - Instalace: při přidání adaptéru v HA odpovídá volba Recommended instalaci se ZHA. ZHA je v HA aktivní automaticky. dok. ZBT-2
- Skupiny a binding: ZHA umí Zigbee skupiny i přímý binding zařízení (vypínač → žárovka). dok. HA
- OTA aktualizace firmwaru zařízení jsou zapnuté ve výchozím stavu a nabízejí se jako běžné Update entity. Funguje to jen u výrobců, kteří firmware zveřejňují. dok. HA
- Zálohy: ZHA zálohuje Zigbee síť automaticky. Ruční zálohu uděláš v Network Settings. Po obnově zálohy HA jde ZHA překonfigurovat nebo migrovat na nový coordinator bez ztráty zařízení. dok. HA Záloha obsahuje i síťový klíč a je součástí záloh HA. draft ZBT-2
- Migrace mezi adaptéry (EZSP Silicon Labs, ZNP Texas Instruments, deCONZ) funguje, pokud je záloha ze ZHA. Ze Z2M nebo deCONZ se nejdřív migruje do ZHA přes starý adaptér. dok. HA dok. ZBT-2 Postupy: Migrace Zigbee coordinatoru.
- Nestandardní zařízení: zařízení, která nedodržují ZCL, obsluhují ZHA Device Handlers („quirks“). Když zařízení nemá všechny entity, zkus ho znovu spárovat a pak hledej nebo požádej o quirk. dok. HA
Kanál
- Doporučení dokumentace zní: kanál neměnit. Pokud ho měníš, volba Smart jednorázově projde kanály a vybere nejlepší. Přednost mají 15, 20 a 25. dok. HA
- Rušení a volba kanálu vůči Wi-Fi: viz Zigbee.
Gotchas
- Jediný coordinator a jediná síť. ZHA neobslouží dva adaptéry naráz a coordinator nesmí používat jiná aplikace. Druhý adaptér jde jen s jiným řešením (deCONZ, Z2M). dok. HA dok. ZBT-2
- Zařízení může být jen v jedné Zigbee síti. Zařízení dřív spárovaná jinde (Z2M, hub výrobce) je nutné resetovat do továrního nastavení. dok. HA
- ZHA nepodporuje Zigbee Green Power (ZGP). dok. ZBT-2
- Při použití Z2M objevenou ZHA integraci smaž a ignoruj, jinak se budou prát o adaptér. dok. ZBT-2
- Odebrání integrace ZHA adaptér neresetuje a síťový klíč na něm zůstane. draft ZBT-2
- Párování: nejdřív zařízení napájená ze sítě (routery), pak bateriová. Slabá síť může párování znemožnit. Ruší hlavně USB 3.x porty, zařízení a nestíněné kabely. dok. HA
Integrace
- Home Assistant, Connect ZBT-2, síťové coordinatory SLZB
Souvislosti
Zdroje
- Home Assistant documentation (instalace, pojmy, zálohy, MQTT, ZHA, SMLIGHT, UniFi): dokumentace integrace ZHA.
- Home Assistant Connect ZBT-2 (Nabu Casa Support): instalace, migrace, single instance, ZGP.
- User Documentation for Home Assistant Connect ZBT-2 (DRAFT): zálohy a odebrání integrace (draft, superseded).
- SLZB-OS (SMLIGHT Manuals): síťový coordinator přes socket.