Zigbee2MQTT
Co to je: Samostatná služba, která obsluhuje Zigbee coordinator a překládá mezi Zigbee a MQTT. Díky tomu ji může použít Home Assistant, Node-RED nebo cokoliv, co umí MQTT.1 Je alternativou k ZHA. Aktuální verze je 2.14.2 (10/2026).1
Jak funguje
Podle dok. Z2M1:
- Při spárování si Z2M zařízení „vyzpovídá“: zjistí, co je zač, jaké má endpointy a clustery. Converters (Zigbee-Herdsman-Converters) pak pro každý model určují, co se má bindovat a jak se to převede na MQTT. Většina zařízení používá generické converters.
- Zařízení vysílá zprávu, Z2M ji pošle jako MQTT zprávu a o tom, co se má stát, rozhoduje MQTT controller (HA, Node-RED).
- Frontend: webové UI pro párování, binding, skupiny a mapu sítě.
Klíčové vlastnosti
- Párování: permit join se ve frontendu otevře na 254 s. Jde vybrat konkrétní router, přes který se zařízení připojí.1
- Binding a skupiny: zařízení se ovládají přímo (stmívač → žárovka nebo skupina), i když HA, Z2M nebo coordinator nejedou. Z2M při bindingu nastaví reporting.1
- Síťová konfigurace v
configuration.yaml:channel: doporučené jsou ZLL kanály 11, 15, 20 nebo 25.pan_id,ext_pan_idnetwork_key:GENERATEvytvoří náhodný klíč.- Zdroj: dok. Z2M1
- Adaptéry: použij doporučený adaptér. CC2530 a CC2531 fungují špatně.1
- Migrace do ZHA jde se starým adaptérem i ze zálohy Z2M (
coordinator_backup.json), viz Migrace Zigbee coordinatoru.2
Gotchas
- Změna
network_keyvyžaduje znovuspárování všech zařízení. Změna kanálu může vyžadovat znovuspárování části zařízení a funguje jen s adaptéryzstackaember.1 - ZHA je v HA aktivní automaticky. Při použití Z2M objevenou ZHA integraci smaž a ignoruj.2
- Podporu k Z2M dává komunita Z2M (fórum, Discord), ne Nabu Casa.2
- Z2M nepotřebuje moc prostředků, ale na slabém HW (např. Raspberry Pi 3 spolu s HA) může být výkon problém.1
Integrace
- Home Assistant přes MQTT discovery, Node-RED přes MQTT, ZHA (migrace)
Souvislosti
- Zigbee, ZHA (Zigbee Home Automation), MQTT, Mosquitto, Mosquitto na Umbrelu krok za krokem, Migrace Zigbee coordinatoru
Zdroje
- Zigbee2MQTT documentation (Zigbee network, stabilita, binding, párování) ↗ — dokumentace Zigbee2MQTT (síť, binding, párování, konfigurace, adaptéry).
- Home Assistant Connect ZBT-2 (Nabu Casa Support) ↗ — ember adaptér, migrace do ZHA.
- SLZB-OS (SMLIGHT Manuals) ↗ — síťový coordinator.
Intellihome