Zigbee2MQTT
Zigbee2MQTT je univerzální a navíc open-source řešení na provozování Zigbee mash sítě pro chytrou domácnost. Je možné ho provozovat jak v Home Assistantovi tak i úplně samostatně
Předpokládám, že jste se již seznámili se základy Zigbee a tak byste měli začít výběrem koordinátoru vhodného pro Zigbee2MQTT.
Výběr koordinátoru - doporučený hardware
Zigbee2MQTT si poradí se všemi třemi typy firmware koordinátorů - EZSP, DECONZ i ZSTACK.
1. Koordinátory založené na EmberZNet od Silicon Labs - EZSP
Nejlepší volbou jsou aktuálně koordinátory založené na čipu EFR32MG21 a používající protokol EZSP. Čip by měl do budoucna umožňovat a podporovat i protokol Thread. Tento čip používají pro své produkty i přímo tvůrci Home Assistanta.

Sonoff Zigbee 3.0 USB Dongle Plus E
USB adaptér pro připojení Zigbee zařízeních k chytré domácnosti.
Zigbee ZB-GW04 Adapter

Home Assistant SkyConnect
USB adaptér pro připojení Zigbee / Thread zařízeních k chytré domácnosti od tvůrců Home Assistanta.Já aktuálně používám SkyConnect od Home Assistantu zejména díky tomu, že jsem chtěl být připravený na podporu Threadu přímo v Home Assistentovi co nejdříve.
V budoucích verzích Zigbee2MQTT bude ukončena podpora ovladače ezsp
pro adaptéry s firmware EZSP 6.x a < 7.4. Je proto dobré už nyní firmware zaktualizovat (pokud je to potřeba) a přepnout ovladač na ember
. Možná to vypadá složitě, ale naštěstí to až tak komplikované není a rozhodně nebudete potřebovat něco rozebírat. Jak to udělat se můžete podívat níže do kapitoly Aktualizace firmware EZSP koordinátorů
ezsp: Deprecated driver 'ezsp' currently in use, 'ember' will become the officially supported
EmberZNet driver in the next release
2. Koordinátory založené na deCONZ od Dresden Elektrik - DECONZ

Phoscon ConBee III
Nová verze USB dongle používající EFR32MG21
Phoscon ConBee II
USB dongle
Phoscon RaspBee II
Raspberry PI shieldOd deCONZu mám oba produkty II. generace, ale pokud nemáte nějaký specifický důvod, doporučuji dnes jíž spíše ConBee III.
3. Koordinátory od Texas Instruments - ZSTACK
Nejstarší čipy, které doporučuji jen v případě, že chcete opravdu hodně šetřit. Nutno flashovat firmware a není tedy vhodné pro běžné uživatele.
- CC2652P/R/RB USB dongle s přeflashovaným firmware coordinator od Z-stack
- CC1352P/R USB dongle s přeflashovaným firmware coordinator od Z-stack
V minulosti jsem používal CC2531, který je však již překonaný a jeho dosah nebyl zrovna nejlepší. Aktuálně již nepoužívám žádný produkt z této řady.
Aktualizace firmware EZSP koordinátorů
Tato kapitola se týká pouze EZSP koordinátorů. Pokud plánujete nebo máte jiný tak ji můžete přeskočit a není pro vás relevantní a pokračovat další Instalace koordinátoru.
Pokud máte Zigbee adaptér od Sonoffu nebo ZB-GW04 tak doporučuji ještě zkontrolovat verzi firmware nahraného v tomto adaptéru. Pokud máte verzi nižší než 7.4 tak můžete mít brzy problém. Nová verze navíc nabízí rychlejší odezvu a vylepšenou stabilitu sítě.
EZSP Sonoff nebo ZB-GW04
-
Připojte adaptér do počítače přes USB.
-
Ujistěte se, že žádná aplikace či proces tento adaptér na počítači nepoužívá.
-
Otevřete si prohlížeč založený na Chrome a zadejte adresu darkxst.github.io/silabs-firmware-builder
-
Najděte si svůj adaptér - pro EFR32MG21 je potřeba zjistit i verzi 1.1 nebo 1.2 - ta je napsaná přímo na desce adaptéru.
-
Klikněte na Connect a po chvíli by vám měl naskočit dialog s vaší verzí a poslední dostupnou. Klikněte na Upgrade.
-
Nový firmware se začne instalovat - neodpojujte adaptér nebo nevypínejte počítač!
-
Je hotovo!
EZSP Home Assistant ZBT-1 (SkyConnect)
Tento adaptér už by měl mít v sobě EZSP 7.x, ale pro Zigbee2MQTT a ember
budete potřebovat minimálně 7.4. Doporučuji aktualizaci provést přes add-on Silicon Labs Flasher.
-
Nainstalujte si add-on Silicon Labs Flasher
-
Zakažte integraci ZHA a nebo vypněte Zigbee2MQTT podle toho co používáte.
-
V nastavení add-onu vyberte adaptér.
-
Spustte addon a podívejte se do logů zda všechno proběhlo v pořádku. Addon se sám vypne.
-
Povolte zpátky ZHA nebo spusťte Zigbee2MQTT.
-
Je hotovo!
Adaptéry s verzi EZSP 7.4 a vyšší používají v Zigbee2MQTT nastavení ember
namísto původního ezsp
. Zigbee2MQTT neumožňuje současné použití Zigbee a Thread., tj. adaptéry s multiprotocol EZSP firmwarem nejsou podporované.
Instalace koordinátoru
Budu předpokládat, že jste si vybrali jeden z USB koordinátorů a pak je instalace poměrně jednoduchá. Stačí USB koordinátor zasunout do jednoho z USB portů.
V případě Raspberry doporučuji použít USB 2.0 porty (ty černé) a obecně je lepší koordinátor připojit k počítači přes prodlužovací USB kabel - obojí kvůli menšímu rušení.

Vention USB 3.0 Male to Female Extension Cable 0.5m Black
Prodlužovací kabel USB 3.0Instalace software v Home Assistantovi
Instalace je poměrně vícekroková a může se zadrhnout na několika krocích. Pokud ji ale uděláte podle následujícího manuálu pak byste neměli být překvapeni.
1. Instalace HA doplňku MQTT
Jako první si nainstalujeme broker (zachytávač zpráv), který je pro Zigbee2MQTT zásadní.
-
V Home Assistantovi zvolíme Nastavení -> Doplňky -> Obchod s doplňky a najdeme v seznamu MQTT a klikneme na Nainstalovat.
-
Přepneme se do nastavení doplňku a v sekci logins přidáme
uživatele
aheslo
pro MQTT:- username: smarthome
password: smarthome -
Doplněk spustíme.
2. Instalace HA doplňku Zigbee2MQTT
-
V Home Assistantovi zvolíme Nastavení -> Doplňky -> Obchod s doplňky a menu v pravém horním rohu s třemi tečkami vybereme Repositáře a přidáme:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Repositář Zigbee2MQTTZigbee2MQTT není součástí standardních repositářů doplňků v Home Assistantovi
Nebo klikneme na:
-
Najdeme v seznamu Zigbee2MQTT a klikneme na Nainstalovat.
-
Přepneme se do nastavení doplňku a v sekci mqtt změníme nastavení na:
server: mqtt://core-mosquitto:1883
user: smarthome
password: smarthomea upravíme také sekci serial - do port zadejte ID vašeho USB donglu.
Příklad pro Phoscon ConBee II
serial:
port: >-
/dev/serial/by-id/usb-dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II_DEXXXXXX-if00
adapter: deconzPříklad pro Zigbee ZB-GW04 Adapter se starším firmwarem EZSP 6.x a menší než 7.4
port: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
adapter: ezspPokud máte ještě tento firmware rozhodně byste měli upgradovat, neboť se v budoucnu podpora
ezsp
odstraní.Příklad pro Zigbee ZB-GW04 Adapter s novějším firmwarem EZSP 7.4 a novější
port: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
adapter: emberNastavení pro různé koordinátoryNázev
port
můžeme najít například pomocí menu v Home Assistantovi - Nastavení -> Systém -> Hardware -> Veškerý hardware a najdeme si položku ttyUNastavení
adapter
se liší podle použitého čipu (kategorie viz výše seznam koordinátorů):- EmberZNet od Silicon Labs -
ezsp
pro firmware EZSP 6.x a < 7.4,ember
pro firmware 7.4 >= (koordinátor SkyConnect, Sonoff ...) - deCONz -
deconz
(koordinátory ConBee) - Zstack -
zstack
Zigbee2MQTT 2.0>Nastavení
adapter
je od verze 2.0 v Zigbee2MQTT povinná. Pokud tedy používáte předchozí verzi a tento atribut jste neměli nastavený je potřeba ho přidat, jinak Zigbee2MQTT nenaběhne.zstack
už není výchozí hodnotou. - EmberZNet od Silicon Labs -
-
Doplněk spustíme a nastavíme aby byl v postranním panelu.
V logy bychom měli vidět:
Zigbee2MQTT:info 2023-12-30 18:51:54: Zigbee2MQTT started!
3. Integrace do Home Assistanta
Integrace do Home Assistanta je provedena zprostředkovaně prostřednictvím doplňku MQTT. Pokud jsme udělali vše správně mělo by nám MQTT automaticky naskočit mezi objevené integrace a stačí kliknout na nastavit.
Pokud by to nefungovalo, pak můžeme MQTT přidat ručně a vyplníme údaje:
Párování nového zařízení
Jak je instalace do Home Assistanta u Zigbee2MQTT trochu složitější tak párování nových zařízení je naopak zase nejjednodušší.
Stačí v postranním panelu vybrat Zigbee2MQTT a na hlavní obrazovce kliknout na Povolit připojení (Vše). Nové zařízení by se mělo v seznamu do pár sekund zobrazit samo.
Bohužel systém výchozího pojmenovávání zrovna moc chytrý není a obsahuje unikátní adresu zařízení, která není zrovna popisná.
Podobně pak zafunguje párování bateriového senzoru Aqara pohybu od čínského výrobce Xiaomi.
Zobrazení schématu Zigbee sítě
Jakmile budete mít více Zigbee zařízeních začne být složitější mít o nich přehled. Tady Zigbee2MQTT zase trochu pokulhává a ze všech řešení mi přijde možná i nejhorší.
Mapu schématu Zigbee sítě je potřeba vždy znovu vygenerovat v menu Mapa a volba Načíst mapu. To může trvat několik sekund až minut v závislosti od velikosti sítě.
- Koordinátor - modrá hvězdička
- Zigbee zařízení pod trvalým proudem - modré kolečko s fotkou zařízení
- Zigbee zařízení na baterky - zelené kolečko s fotkou zařízení
Povolení dotazování na dostupnost zařízení
Ve výchozím nastavení je v Zigbee2MQTT zjišťování dostupnosti Zigbee zařízení v síti zakázáno z důvodu snížení provozu na Zigbee síti. Pokud však nemáte extrémně rozsáhlou síť, může být naopak užitečné mít tuto funkci zapnutou. Já ji například používám k tomu, abych dostával notifikace o výpadku zařízení přímo z automatizace Home Assistanta.
Funkci můžeme zapnout přímo z UI Zigbee2MQTT. Přejdeme do Menu ozubeného kola -> Nastavení -> Dostupnost, zatrhneme volbu Enabled a potvrdíme pomocí tlačítka Submit.
Nebo můžeme provést změnu nastavení přímo v souboru configuration.yaml
.
availability:
enabled: true
Dočasné zakázání zařízení v Zigbee síti
Pokud se některé ze zařízení v Zigbee síti stane nedostupným, například pokud ho používáte pouze sezónně, a máte zároveň zapnutou funkci dotazování na dostupnost zařízení, bude to mít nežádoucí efekt v podobě neustále se objevujícího chybového hlášení.
Tohoto problému se zbavíme zakázáním zařízení v Zigbee síti. V nastavení konkrétního zařízení zatrhneme volbu Disabled.
Zařízení se tím vyloučí ze všech dotazování na stav (včetně mapy sítě) a zbavíme se výše uvedené chyby. V seznamu zařízení pak zakázané zařízení poznáme podle přeškrtnutí u obrázku a stavu Zakázáno.
Pokud preferujete zápis přímo do konfiguračního souboru configuration.yaml
pak to můžeme udělat v sekci devices přidáním volby disabled: true
.
devices:
...
'0xa4c1381a9e6ce8fc':
friendly_name: '0xa4c1381a9e6ce8fc'
disabled: true
...
Změna Zigbee kanálu
Správné nastavení kanálu Zigbee sítě je klíčové pro minimalizaci rušení od WiFi sítí, které operují na stejném frekvenčním pásmu.
Překrývání kanálů může vést k výraznému snížení výkonu obou sítí a problémů špatné odezvě jednotlivých zařízení v chytré domácnosti. Doporučuji si zjistit na jakém kanálu máme nejvíce WiFi sítí a vybrat ten, který je nejméně obsazený.
WiFi kanály jsou mnohem širší a proto máme v pásmu 2,4GHz pouze tři, kdežto Zigbee kanálu je rovnou 16. Doporučuji volit kanály na rozhraní WiFi kanálu, tj. Zigbee kanály 11, 15, 20 nebo 25.
Mapování kanálů WiFi vs. Zigbee
Nastavení v Home Assistantovi
-
V hlavní levém menu Home Assistanta klikneme na Zigbee2MQTT a vybereme Nastavení
-
Klikněte na položku Rozšířené
-
Ručně zapíšeme Zigbee channel.
Komentáře