Aktualizováno: 2026-10-04 · Platí pro: zigbee2mqtt 2.14

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. dok. Z2M Je alternativou k ZHA. Aktuální verze je 2.14.2 (10/2026). dok. Z2M

Jak funguje

Podle dok. Z2M:

• 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í. dok. Z2M
• 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. dok. Z2M
• Síťová konfigurace v configuration.yaml:
  • channel: doporučené jsou ZLL kanály 11, 15, 20 nebo 25.
  • pan_id, ext_pan_id
  • network_key: GENERATE vytvoří náhodný klíč.
  • Zdroj: dok. Z2M
• Adaptéry: použij doporučený adaptér. CC2530 a CC2531 fungují špatně. dok. Z2M
  • Silicon Labs s EmberZNet (např. ZBT-2): adapter: ember. dok. ZBT-2
  • Síťový coordinator SLZB přes TCP socket, hodnoty vypíše generátor konfigurace v SLZB-OS. manuál SLZB-OS
• Migrace do ZHA jde se starým adaptérem i ze zálohy Z2M (coordinator_backup.json), viz Migrace Zigbee coordinatoru. dok. ZBT-2

Gotchas

• Změna network_key vyž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éry zstack a ember. dok. Z2M
• ZHA je v HA aktivní automaticky. Při použití Z2M objevenou ZHA integraci smaž a ignoruj. dok. ZBT-2
• Podporu k Z2M dává komunita Z2M (fórum, Discord), ne Nabu Casa. dok. ZBT-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. dok. Z2M

Integrace

• Home Assistant přes MQTT discovery, Node-RED přes MQTT, ZHA (migrace)

Souvislosti

• Zigbee, ZHA (Zigbee Home Automation), MQTT, 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.