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 čipech EFR32MG21 a EFR32MG24 používající protokol EZSP. Tyto čipy podporují i protokol Thread pro Matter zařízení. Produkty s těmito čipy používají i přímo tvůrci Home Assistanta.

Koordinátory s čipem EFR32MG24 (nejnovější generace)

Čip MG24 nabízí vyšší výkon, lepší dosah a vylepšenou stabilitu oproti předchozí generaci MG21.

Home Assistant Connect ZBT-2

USB adaptér - USB koordinátor Zigbee/Thread pro Home Assistant (ZHA/Thread), model NC-ZBT-9741, SoC Silicon Labs MG24 + ESP32-S3 (USB-UART), podpora Zigbee 3.0 a Thread/Matter-over-Thread (v HA), připojení USB-C, napájení 5 V DC/500 mA, frekvence 2400–2483,5 MHz, všesměrová anténa 4,16 dBi (Ø24 × 164 mm), certifikace CE/FCC/RCM, FCC-ID 2A8ZE04, rozměry zařízení 83 × 83 × 179 mm, hmotnost 157 g, kryt polykarbonát, provoz 0–65 °C (anténa −40 až +85 °C), použití interiér, vyžaduje Home Assistant 2

1 199 Kč

Alza.cz→

Sonoff Dongle Plus MG24 Zigbee/Thread

Napájení s pokročilým čipem EFR32MG24, který nabízí bohatší zdroje a vyšší výkon pro rychlejší automatizaci a stabilnější ovládání podřízených zařízení. Výchozí zisk antény 3 dBi, optimalizovaný až na 4,5 dBi pro silnější signál a širší pokrytí.

807 Kč

Aliexpress→

Koordinátory s čipem EFR32MG21 (předchozí generace)

Sonoff Zigbee 3.0 USB Dongle Plus E

USB adaptér pro připojení Zigbee zařízeních k chytré domácnosti. S čipem EFR32MG21.

639 KčSLEVA

Alza.cz→

Jaké produkty s EFR32MG21/MG24 používám?

Já aktuálně používám stále původní ZBT-1 (SkyConnect) s čipem MG21, který mám nastavený pro Zigbee. Nový ZBT-2 s čipem MG24 nabízí vylepšenou anténu a lepší dosah.

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

Phoscon ConBee III

Nová verze USB dongle používající EFR32MG21

858 KčSLEVA

Amazon.de→

Phoscon ConBee II

USB dongle

490 KčSLEVA

Amazon.de→

Phoscon RaspBee II

Raspberry PI shield

785 Kč

Amazon.de→

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 již spíše ConBee III.

Vylepšený deCONZ driver od v2.5.0

Od verze Zigbee2MQTT 2.5.0 byl kompletně přepracován deCONZ driver, což přineslo:

• ✅ Výrazně vylepšenou stabilitu sítě
• ✅ Rychlejší párování nových zařízení
• ✅ Lepší podporu OTA aktualizací
• ✅ Konzistentní chování s ostatními koordinátory

Pokud jste měli v minulosti problémy s ConBee adaptéry, doporučuji vyzkoušet nejnovější verzi Zigbee2MQTT.

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, ZBT-1 (SkyConnect) nebo ZBT-2, doporučuji zkontrolovat verzi firmware. Aktuální doporučená verze je EZSP 8.2.0 (v17), která nabízí:

• ✅ Rychlejší odezvu zařízení
• ✅ Vylepšenou stabilitu sítě
• ✅ Podporu pro nejnovější funkce Zigbee2MQTT
• ✅ Lepší správu paměti pro větší sítě (150+ zařízení)

Důležité před aktualizací

Před aktualizací firmware vytvořte zálohu koordinátoru (viz sekce Zálohování koordinátoru). I když je aktualizace obvykle bezpečná, záloha vás ochrání před neočekávanými problémy.

EZSP Sonoff Dongle Plus E nebo Sonoff Dongle Plus MG24

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 Sonoff Dongle Plus E (EFR32MG21) je potřeba zjistit i verzi 1.1 nebo 1.2 - ta je napsaná přímo na desce adaptéru. Pro Sonoff Dongle Plus MG24 vyberte příslušný model s čipem EFR32MG24.

5. Klikněte na Connect a po chvíli by vám měl naskočit dialog s vaší verzí a poslední dostupnou (EZSP 8.2.0). Klikněte na Upgrade.

   

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

   

7. Je hotovo!

EZSP Home Assistant ZBT-1 (SkyConnect) nebo ZBT-2

Tyto adaptéry už by měly 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

   

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

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

   

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

Vention USB 3.0 Male to Female Extension Cable 0.5m Black

Prodlužovací kabel USB 3.0

98 KčSLEVA

Alza.cz→

Zálohování koordinátoru

Důležité - vytvořte si backup!

Před přidáním prvního zařízení do Zigbee sítě vytvořte si zálohu koordinátoru. Pokud se koordinátor pokazí nebo ho ztratíte, budete moci konfiguraci obnovit na novém koordinátoru bez nutnosti párovat všechna zařízení znovu.

Zigbee2MQTT podporuje automatické zálohování pro koordinátory používající zStack (Texas Instruments) a EmberZNet (Silicon Labs - EZSP/Ember).

Automatické zálohování

1. V Zigbee2MQTT přejděte do Nastavení (ozubené kolečko)
2. Klikněte na záložku Nastavení
3. Najděte sekci Pokročilé -> Backup
4. Zálohování je ve výchozím nastavení zapnuté - zálohy se automaticky vytváří při každé změně v síti

Zálohy najdete v adresáři /config/zigbee2mqtt/ s názvem coordinator_backup.json.

Ruční záloha

Doporučuji si zálohu také pravidelně stahovat a ukládat mimo Home Assistant - například do cloudu nebo na jiný disk. Při kompletním selhání SD karty vám to zachrání hodiny práce.

Obnovení ze zálohy

Pokud potřebujete zálohu obnovit na novém koordinátoru:

1. Vypněte Zigbee2MQTT addon
2. Nahraďte koordinátor novým (ideálně stejného typu)
3. Zkopírujte coordinator_backup.json zpět do /config/zigbee2mqtt/
4. Spusťte Zigbee2MQTT - automaticky detekuje zálohu a nabídne její obnovení

Omezení při obnově

Zálohu můžete obnovit pouze na koordinátor stejného typu (např. EmberZNet na EmberZNet). Nelze přenést zálohu z Texas Instruments na Silicon Labs a naopak.

Migrace mezi koordinátory

Pokud potřebujete upgradovat na novější koordinátor nebo nahradit nefunkční hardware, Zigbee2MQTT nabízí možnost migrace bez nutnosti párovat všechna zařízení znovu. Díky automatickému zálohování můžete koordinátor snadno vyměnit.

Kdy je migrace užitečná?

• ✅ Upgrade na novější generaci (např. z EFR32MG21 na EFR32MG24)
• ✅ Výměna poškozeného koordinátoru
• ✅ Přechod na koordinátor s lepší anténou (např. z běžného donglu na ZBT-2)
• ✅ Přesun na jiný server (při zachování stejného typu koordinátoru)

Podporované migrace

Můžete migrovat pouze mezi koordinátory stejného typu:

• EmberZNet (EZSP/Ember) → EmberZNet ✅
• deCONZ → deCONZ ✅
• ZStack (Texas Instruments) → ZStack ✅

Nelze migrovat mezi různými typy

Nemůžete migrovat mezi různými protokoly:

• ❌ EmberZNet → Texas Instruments
• ❌ Texas Instruments → deCONZ
• ❌ deCONZ → EmberZNet

Pokud chcete přejít na jiný typ koordinátoru, budete muset všechna zařízení znovu spárovat.

Postup migrace

1. Příprava

1. Ověřte, že máte zálohu - automatická záloha by měla být v /config/zigbee2mqtt/coordinator_backup.json
2. Stáhněte si zálohu na svůj počítač pro jistotu
3. Poznamenejte si nastavení koordinátoru (port, adapter type) z konfigurace
4. Naplánujte migraci na dobu, kdy můžete věnovat čas případným problémům

Kontrola zálohy

Před migrací zkontrolujte, že soubor coordinator_backup.json obsahuje data (není prázdný) a je aktuální. Můžete si ho stáhnout přes File Editor nebo SSH.

2. Výměna koordinátoru

1. Vypněte Zigbee2MQTT addon v Home Assistantovi
2. Odpojte starý koordinátor z USB portu
3. Připojte nový koordinátor do stejného nebo jiného USB portu
4. Zjistěte port nového koordinátoru v Nastavení → Systém → Hardware → Veškerý hardware

Ignorování starého koordinátoru

Po fyzické výměně koordinátoru Home Assistant rozpozná nové USB zařízení, ale starý koordinátor zůstane v seznamu hardware. Abyste zabránili zmatení v budoucnu, doporučuji:

1. Přejít do Nastavení → Systém → Hardware → Veškerý hardware
2. Najít starý koordinátor v seznamu (bude označený jako nedostupný)
3. Kliknout na něj a označit jako Ignorovat
4. Restartovat Zigbee2MQTT addon

Tím zajistíte, že Home Assistant nebude pokoušet používat neexistující zařízení a seznam hardware zůstane přehledný.

3. Aktualizace konfigurace

1. Otevřete Nastavení Zigbee2MQTT addonu
2. Aktualizujte serial.port podle nového koordinátoru:

serial:
  port: /dev/serial/by-id/usb-NOVYKORDINATOR-if00-port0
  adapter: ember  # Musí být stejný typ jako u starého!

3. Uložte změny ale zatím addon nespouštějte

4. Obnovení zálohy

1. Zkontrolujte, že coordinator_backup.json je stále v /config/zigbee2mqtt/
2. Pokud jste ho odstranili nebo měli více záloh, zkopírujte správnou zálohu zpět
3. Spusťte Zigbee2MQTT addon
4. Sledujte logy - měli byste vidět:

Zigbee2MQTT:info  Coordinator backup found, restoring...
Zigbee2MQTT:info  Coordinator restored successfully
Zigbee2MQTT:info  Zigbee2MQTT started!

5. Ověření migrace

1. Zkontrolujte Zigbee2MQTT dashboard - všechna zařízení by měla být v seznamu
2. Testujte zařízení - ověřte, že reagují na příkazy
3. Zkontrolujte mapu sítě - měla by odpovídat původní topologii

Čas na zotavení

Po migraci může trvat několik hodin, než se všechna zařízení plně připojí a stabilizují. Bateriová zařízení se probudí až při další komunikaci (stisknutí tlačítka, změna stavu), což může trvat i déle.

Řešení problémů po migraci

Problém	Možná příčina	Řešení
Addon se nespustí	Špatný port nebo adapter	Zkontrolujte serial.port a adapter nastavení
Záloha nebyla nalezena	Chybí soubor	Zkopírujte coordinator_backup.json do /config/zigbee2mqtt/
Některá zařízení nereagují	Ještě se nepřipojila	Počkejte 24 hodin, u router zařízení zkuste reset napájení
Bateriová zařízení offline	Čekají na probuzení	Stiskněte tlačítko nebo vyměňte baterii
Chyba "Incompatible backup"	Jiný typ koordinátoru	Použijte koordinátor stejného typu jako původní

Praktické rady z testování

Na základě zkušeností uživatelů s migrací (zejména na nové koordinátory s Ember driverem):

1. Router zařízení napájená ze sítě se obvykle připojí během 15-60 minut
2. Bateriová zařízení mohou trvat hodiny až dny - závisí na intervalu probuzení
3. Pokud zařízení nereaguje po 24 hodinách, zkuste ho restartovat (odpojit baterii/napájení na 10 sekund)
4. IKEA zařízení jsou někdy problematická - možná budete muset u některých provést reset
5. Starší zařízení bez standardní Zigbee 3.0 certifikace mohou vyžadovat opětovné spárování

Migrace na ZBT-2

Pokud migrujete z ZBT-1 (SkyConnect) na novější ZBT-2, je postup stejný jako výše. Oba používají EmberZNet protokol a záloha je plně kompatibilní.

Výhody upgradu na ZBT-2:

• 📡 Lepší anténa - větší dosah a stabilnější signál
• 🚀 Novější čip EFR32MG24 - vylepšená efektivita a výkon
• 🏠 Originální design Home Assistant - lepší integrace s ekosystémem

Pokud plánujete mít dedikovaný Thread koordinátor pro Matter, můžete ZBT-1 přepnout na Thread a ZBT-2 použít pro Zigbee. Díky migraci nepřijdete o žádná spárovaná zařízení!

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.

   

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:

   

2. Najdeme v seznamu Zigbee2MQTT a klikneme na Nainstalovat.

   

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 Sonoff Dongle Plus E nebo Sonoff Dongle Plus MG24 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 Sonoff Dongle Plus E nebo Sonoff Dongle Plus MG24 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

   

   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 ZBT-1/SkyConnect, ZBT-2, 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.

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

4. Přístup k Zigbee2MQTT webovému rozhraní

Od verze 2.6.2 používá Zigbee2MQTT nové webové rozhraní Windfront, které nahradilo původní frontend. Windfront je modernější, rychlejší a nabízí lepší uživatelskou zkušenost.

Windfront vs. původní frontend

Pokud máte starší verzi Zigbee2MQTT nebo preferujete původní rozhraní, můžete ho stále aktivovat v nastavení. Windfront je však doporučený pro všechny nové instalace.

Po instalaci Zigbee2MQTT addon najdete odkaz na webové rozhraní v:

• Nastavení -> Doplňky -> Zigbee2MQTT -> Otevřít webové UI
• Nebo v postranním panelu Home Assistanta pokud jste si zapnuli "Zobrazit v postranním panelu"

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

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

Průvodce prvním spuštěním (Onboarding)

Nová funkce od verze 2.2.0

Pokud instalujete Zigbee2MQTT poprvé, uvítá vás průvodce prvním spuštěním, který vám pomůže s počáteční konfigurací.

Průvodce vám pomůže nastavit:

1. Základní informace o síti - název, popis
2. Zigbee kanál - s doporučením podle dostupných WiFi sítí
3. Pan ID - unikátní identifikátor vaší Zigbee sítě
4. Zabezpečení sítě - network key pro šifrování komunikace

Ruční konfigurace

Pokud průvodce přeskočíte nebo potřebujete později změnit nastavení, všechny tyto parametry najdete v Nastavení -> Pokročilé -> Síť.

Po dokončení průvodce je Zigbee síť připravená a můžete začít párovat zařízení.

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

Pokročilé nastavení dostupnosti

Kromě základního zapnutí můžete také nastavit:

Interval dotazování:

availability:
  enabled: true
  timeout: 60  # sekund - jak dlouho čekat na odpověď
  interval: 600  # sekund - jak často dotazovat (default 10 minut)

Optimalizace pro bateriová zařízení

Pro bateriová zařízení doporučuji delší interval (např. 1800 sekund = 30 minut), abyste šetřili baterii. Pro zařízení napájená ze sítě můžete použít kratší interval pro rychlejší detekci výpadků.

Blacklist zařízení:

Pokud některá zařízení nechcete monitorovat (např. vzdálené senzory s občasnými výpadky), můžete je vyloučit:

availability:
  enabled: true
  blacklist:
    - 0xa4c1381a9e6ce8fc  # Venkovní senzor
    - outdoor_sensor  # Nebo použít friendly_name

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

Automatické OTA aktualizace zařízení

Zigbee2MQTT podporuje OTA (Over-The-Air) aktualizace firmware přímo z webového rozhraní. Od novějších verzí můžete navíc aktualizace naplánovat na konkrétní čas.

Ruční aktualizace

1. V Zigbee2MQTT přejděte na detail zařízení
2. Pokud je dostupná nová verze firmware, zobrazí se tlačítko Aktualizovat OTA
3. Klikněte a vyčkejte dokončení - může trvat 5-30 minut podle zařízení

Během aktualizace

Během OTA aktualizace:

• ❌ Neodpojujte zařízení od napájení
• ❌ Nerestartujte Zigbee2MQTT
• ✅ Zařízení může být dočasně nedostupné
• ✅ Po dokončení se zařízení samo restartuje

Plánované aktualizace

Pro aktualizaci většího počtu zařízení je užitečné použít plánované aktualizace:

1. V nastavení zařízení najděte sekci OTA aktualizace
2. Nastavte čas zahájení (např. 02:00 v noci)
3. Zigbee2MQTT automaticky zkontroluje a nainstaluje dostupné aktualizace

Hromadné aktualizace

Pokud máte více zařízení stejného typu, můžete aktualizace naplánovat postupně s odstupem 30 minut - zabráníte tak přetížení Zigbee sítě.

Kdy aktualizovat?

Doporučuji aktualizovat firmware pokud:

• ✅ Výrobce opravil známý bug
• ✅ Přidává nové funkce, které potřebujete
• ✅ Zařízení se chová nestabilně

Neaktualizujte pokud:

• ❌ Zařízení funguje perfektně
• ❌ Aktualizace je beta verze
• ❌ V komentářích uživatelé hlásí problémy

Monitorování zdraví Zigbee sítě

Zigbee2MQTT nabízí funkci Health Check, která vám pomůže identifikovat problémy v síti dříve, než způsobí výpadky zařízení.

Co monitoruje?

• 📊 Kvalita spojení - signál mezi koordinátorem a zařízeními
• 🔋 Stav baterií - varování před vybitím
• 🔌 Routery - dostupnost zařízení napájených ze sítě
• ⚠️ Problémová zařízení - opakované výpadky nebo slabý signál

Jak používat Health Check

1. V Zigbee2MQTT přejděte do Menu -> Síť -> Health Check
2. Klikněte na Spustit kontrolu
3. Systém analyzuje síť a zobrazí doporučení

Pravidelná kontrola

Doporučuji spustit Health Check:

• ✅ Jednou měsíčně preventivně
• ✅ Po přidání více nových zařízení
• ✅ Když zaznamenáte problémy s odezvou
• ✅ Po změně fyzického umístění routerů

Interpretace výsledků

Zelená - vše funguje optimálně
Žlutá - mírné problémy, doporučeno řešit
Červená - vážné problémy, vyžaduje okamžitou akci

Časté problémy a řešení:

Problém	Důvod	Řešení
Slabý signál	Velká vzdálenost	Přidat router mezi zařízení
Časté výpadky	Rušení nebo přetížení	Změnit Zigbee kanál
Nízká baterie	Vybití baterie	Vyměnit baterii
Router offline	Výpadek napájení	Zkontrolovat zapojení

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

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.

   

Praktické tipy pro výběr kanálu

Analýza WiFi prostředí

Před změnou Zigbee kanálu si nejdřív zjistěte, které WiFi kanály jsou ve vašem okolí nejvíce obsazené. K tomu můžete použít:

• Android: aplikace WiFi Analyzer
• iOS: aplikace Airport Utility (musí se povolit WiFi scanner v nastavení)
• Windows: příkaz netsh wlan show networks mode=bssid v příkazové řádce
• Linux/Mac: příkaz sudo iwlist wlan0 scan nebo aplikace WiFi Explorer

Po analýze vyberte Zigbee kanál, který je co nejdále od nejsilnějších WiFi sítí.

Kdy změnit Zigbee kanál?

Změnu kanálu zvažte v těchto případech:

1. Přidali jste novou WiFi síť nebo access point - Nová WiFi síť může způsobit rušení na dosud klidném kanálu
2. Zařízení přestala odpovídat - Pokud Zigbee zařízení mají problémy s komunikací, může to být způsobeno rušením
3. Přestěhovali jste se - Nové prostředí = nové WiFi sítě sousedů
4. Router pravidelně mění WiFi kanály - Některé routery mají automatickou optimalizaci kanálů
5. Přidali jste mnoho nových Zigbee zařízení - Větší síť = větší citlivost na rušení

Změna kanálu = přepárování zařízení

Pamatujte, že po změně Zigbee kanálu se musí všechna zařízení znovu automaticky připojit. Většina moderních zařízení se připojí sama během několika hodin, ale některá starší zařízení může být nutné restartovat (vypnout a zapnout napájení) nebo v krajním případě i znovu párovat.

Doporučení: Změnu kanálu provádějte když máte čas zařízení zkontrolovat a případně restartovat.

Doporučené kombinace WiFi a Zigbee kanálů

Následující tabulka ukazuje optimální kombinace pro minimalizaci rušení:

WiFi kanál	Doporučené Zigbee kanály	Vyhnout se kanálům
1	25, 26	11-19
6	11, 25, 26	15-22
11	11, 15, 26	20-26

Zlaté pravidlo

Nejlepší výsledky dosáhnete když:

• WiFi používá kanál 1 nebo 11 (ty nejméně překrývají Zigbee spektrum)
• Zigbee používá kanál 25 nebo 26 (nejvíce odolné vůči WiFi rušení)
• Mezi WiFi AP a Zigbee koordinátorem je alespoň 3 metry vzdálenosti

Pokud používáte WiFi na kanálu 6, máte to složitější - ten překrývá celé Zigbee spektrum. Zkuste WiFi přepnout na kanál 1 nebo 11, pokud to vaše okolí dovoluje.