Přeskočit na hlavní obsah

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.

zigbeeusb
Sonoff Zigbee 3.0 USB Dongle Plus E

Sonoff Zigbee 3.0 USB Dongle Plus E

USB adaptér pro připojení Zigbee zařízeních k chytré domácnosti.
zigbeeusb
Zigbee ZB-GW04 Adapter

Zigbee ZB-GW04 Adapter

zigbeeusbthread
Home Assistant SkyConnect

Home Assistant SkyConnect

USB adaptér pro připojení Zigbee / Thread zařízeních k chytré domácnosti od tvůrců Home Assistanta.
Jaké produkty s EFR32MG21 používám?

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.

Ukončení podpory firmware EZSP 6.x a < 7.4

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

zigbeeusb
Phoscon ConBee III

Phoscon ConBee III

Nová verze USB dongle používající EFR32MG21
zigbeeusb
Phoscon ConBee II

Phoscon ConBee II

USB dongle
zigbeeusb
Phoscon RaspBee II

Phoscon RaspBee II

Raspberry PI shield
Jaké produkty deCONZu používám?

Od 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
Jaké produkty od Texas Instruments používám?

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ů

info

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

  1. Připojte adaptér do počítače přes USB.

  2. Ujistěte se, že žádná aplikace či proces tento adaptér na počítači nepoužívá.

  3. Otevřete si prohlížeč založený na Chrome a zadejte adresu darkxst.github.io/silabs-firmware-builder

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

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

    Zigbee flash 1

  6. Nový firmware se začne instalovat - neodpojujte adaptér nebo nevypínejte počítač!

    Zigbee flash 2

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

  1. Nainstalujte si add-on Silicon Labs Flasher

    HA flash 1

  2. Zakažte integraci ZHA a nebo vypněte Zigbee2MQTT podle toho co používáte.

  3. V nastavení add-onu vyberte adaptér.

    HA flash 2

  4. Spustte addon a podívejte se do logů zda všechno proběhlo v pořádku. Addon se sám vypne.

  5. Povolte zpátky ZHA nebo spusťte Zigbee2MQTT.

  6. 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í.

usb
Vention USB 3.0 Male to Female Extension Cable 0.5m Black

Vention USB 3.0 Male to Female Extension Cable 0.5m Black

Prodlužovací kabel USB 3.0

Instalace 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í.

  1. V Home Assistantovi zvolíme Nastavení -> Doplňky -> Obchod s doplňky a najdeme v seznamu MQTT a klikneme na Nainstalovat.

    zigbee2mqtt_mqtt 1

  2. Přepneme se do nastavení doplňku a v sekci logins přidáme uživatele a heslo pro MQTT:

    - username: smarthome
    password: smarthome
  3. Doplněk spustíme.

2. Instalace HA doplňku Zigbee2MQTT

  1. 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ář Zigbee2MQTT

    Zigbee2MQTT není součástí standardních repositářů doplňků v Home Assistantovi

    Nebo klikneme na:

    Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.
  2. Najdeme v seznamu Zigbee2MQTT a klikneme na Nainstalovat.

    Zigbee2Mqtt 1

  3. Přepneme se do nastavení doplňku a v sekci mqtt změníme nastavení na:

    server: mqtt://core-mosquitto:1883
    user: smarthome
    password: smarthome

    a 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: deconz

    Pří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: ezsp

    Pokud 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: ember
    Nastavení pro různé koordinátory

    Ná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 ttyU

    Zigbee Adapter USB port

    Nastavení 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.

    Detaily ke změnám

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

Zigbee2Mqtt 1

Pokud by to nefungovalo, pak můžeme MQTT přidat ručně a vyplníme údaje:

Zigbee2Mqtt 2

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.

Systém pojmenovávání zařízení

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

Zigbee2MQTT Pairing

Podobně pak zafunguje párování bateriového senzoru Aqara pohybu od čínského výrobce Xiaomi.

Zigbee2MQTT Pairing 2

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í

Zigbee2MQTT Schema

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.

Zigbee2MQTT Availability

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

Zigbee2MQTT Device Not Available

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.

Zigbee2MQTT Device Setup

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.

Zigbee2MQTT Device Disabled

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

Wifi vs Zigbee

Nastavení v Home Assistantovi

  1. V hlavní levém menu Home Assistanta klikneme na Zigbee2MQTT a vybereme Nastavení

  2. Klikněte na položku Rozšířené

  3. Ručně zapíšeme Zigbee channel.

    ZHA Změna kanálu

Komentáře