Intellihome
CSEN

Aktualizováno: 2026-10-04 · Platí pro: home-assistant >=2025.11 (deCONZ: >=2025.10.1); slzb-os 2.9–3.x

Migrace Zigbee coordinatoru

Cíl: přenést existující Zigbee síť na nový coordinator (např. Home Assistant Connect ZBT-2 nebo síťový SLZB) nebo do jiného softwaru (Zigbee2MQTT / deCONZ → ZHA) tak, aby nebylo nutné znovu párovat všechna zařízení.
Předpoklady: HA 2025.11+, volný USB port (případně USB hub), čerstvá záloha HA. Home Assistant Connect ZBT-2 (Nabu Casa Support) User Documentation for Home Assistant Connect ZBT-2 (DRAFT)

Jak to funguje

Který postup zvolit

Výchozí stav Postup
ZHA, starý adaptér funguje A
Zigbee2MQTT, starý adaptér funguje B, pak A
Zigbee2MQTT, starý adaptér už nemáš C (ze zálohy Z2M)
deCONZ (ConBee / RaspBee) D, pak A
Z2M nebo ZHA zůstává, mění se jen CC26xx adaptér (např. na SLZB) E

Zdroj: Home Assistant Connect ZBT-2 (Nabu Casa Support), SLZB-OS (SMLIGHT Manuals).

Před migrací (vždy)

  1. Udělej zálohu HA. Obsahuje i nastavení Zigbee coordinatoru ze ZHA. User Documentation for Home Assistant Connect ZBT-2 (DRAFT)
  2. Nový adaptér připoj přes USB prodlužku, dál od USB 3.0, SSD a routeru. U HA Container ho namapuj do kontejneru. Home Assistant Connect ZBT-2 (Nabu Casa Support)
  3. Syntéza: zapiš si, která zařízení jsou bateriová. Ta se po migraci nejčastěji musí párovat znovu.

Postup A: ZHA → nový adaptér

Podle Home Assistant Connect ZBT-2 (Nabu Casa Support):

  1. Settings > Devices & services. HA nový adaptér objeví, zvol Add.
  2. V dialogu vyber Migrate Zigbee to a new adapter.
  3. Zvol Recommended installation. HA zazálohuje starý adaptér a jeho nastavení nahraje na nový.
  4. Hotovo. Zařízení se znovu připojí, obvykle do hodiny. Pomůže je vypnout a zapnout.
  5. Starý adaptér odpoj.

Alternativa ze ZHA: v integraci ZHA ozubené kolo → Migrate adapter → Migrate to a new adapter → vybrat port nového adaptéru → Migrate automatically (recommended). Přes Advanced migration jde obnovit i starší zálohu. Home Assistant Connect ZBT-2 (Nabu Casa Support)

Postup B: Zigbee2MQTT → ZHA (se starým adaptérem)

Podle Home Assistant Connect ZBT-2 (Nabu Casa Support):

  1. Zastav Z2M app (Settings > Apps).
  2. Odstraň Z2M zařízení z MQTT: buď smaž celou MQTT integraci (pokud MQTT nepoužíváš jinde), nebo jednotlivá zařízení. Jinak v HA zůstanou mrtvá zařízení z MQTT discovery.
  3. Přidej integraci ZHA a vyber sériový port starého adaptéru.
  4. Advanced setup → Keep adapter network settings. ZHA tím převezme síť ze starého adaptéru.
  5. Pokračuj postupem A.

Postup C: Zigbee2MQTT ze zálohy (starý adaptér už nemáš)

Podle Home Assistant Connect ZBT-2 (Nabu Casa Support):

  1. V Z2M web UI Settings > Tools > Request Z2M backup a stáhni ho. V ZIP souboru je coordinator_backup.json.
  2. Zastav Z2M a odstraň Z2M zařízení z MQTT (jako v B, krok 2).
  3. Připoj nový adaptér, Add → Use as Zigbee adapter → Custom → Zigbee Home Automation.
  4. V dialogu Network Formation zvol Upload a manual backup a nahraj coordinator_backup.json.
  5. Přiřaď coordinator do oblasti a počkej, až se zařízení připojí (obvykle do hodiny).
  6. Migrovaná zařízení mají nová entity ID a ztratí ručně zadaná jména. Uprav automatizace a dashboardy.

Postup D: deCONZ → ZHA

Podle Home Assistant Connect ZBT-2 (Nabu Casa Support):

  1. Aktualizuj firmware ConBee / RaspBee na 26720700 nebo novější (deCONZ app → Settings > Gateway). HA musí být 2025.10.1+.
  2. V deCONZ app vypni Start on boot a zvol Stop. Smaž integraci deCONZ.
  3. Přidej ZHA na ConBee adaptéru → Advanced setup → Keep adapter network settings.
  4. Počkej, až se zařízení připojí. Bateriová může být nutné spárovat ručně.
  5. Pokračuj postupem A.

Postup E: výměna CC26xx adaptéru beze změny softwaru (např. na SLZB)

Podle SLZB-OS (SMLIGHT Manuals), pro adaptéry s čipem CC26xx (např. CC2652P7):

  1. Zastav Z2M nebo ZHA a vypni starý coordinator.
  2. Vypni všechny Zigbee routery aspoň na 15 s (třeba krátce vypnout jistič).
  3. Zapni nový coordinator, pak routery, pak spusť Z2M nebo ZHA s novým adaptérem.
  4. Zařízení by se měla připojit do 5–10 minut.
  5. Pokud ne: v SLZB-OS nastav novému coordinatoru IEEE adresu starého (ADVANCED: Adapter IEEE address change) a kroky 1–4 zopakuj. Nefunguje v USB režimu.

Syntéza: s ZHA je jednodušší použít postup A a jako nový port zadat socket SLZB. Hodnoty vypíše generátor konfigurace v SLZB-OS. SLZB-OS (SMLIGHT Manuals) Viz Home Assistant Connect SLZB.

Co se nepřenese

Ověření

Rollback

Troubleshooting

Souvislosti

Zdroje