Přechod ze ZHA na Zigbee2MQTT
ZHA je vlastní Zigbee v Home Assistantu. ZigDash pracuje se Zigbee2MQTT, takže nemůže zobrazit zařízení, která jsou v ZHA. Přechod znamená znovu spárovat zařízení se Zigbee2MQTT. Home Assistant je pak dál používá přes svou integraci MQTT.
Než začneš
- Jaká instalace? Pokud nabídka Nastavení v Home Assistantu ukazuje Apps (ve starších verzích Add-ons), máš Home Assistant OS: viz s aplikacemi. Pokud ne, Home Assistant běží v Dockeru (Container): viz Docker.
- Jaký adaptér? Otevři Nastavení › Zařízení a služby › Zigbee Home Automation. V části Hubs je adaptér uvedený podle modelu, například SONOFF ZBDongle-E. Pak se podívej na svůj adaptér.
- Zálohuj ZHA. Na té stránce klepni na ⚙ vedle Zigbee Home Automation a pak na Download backup. Soubor si nech. Na stejné stránce ukazuje Network information kanál, typ rádia a sériový port.
- Co se změní v Home Assistantu. Zařízení se vrátí jako nová zařízení MQTT s novými ID entit. Automatizace, skripty a dashboardy, které je používají, musíš přesměrovat na nová zařízení a jejich historie začne znovu. Skupiny a vazby vytvořené v ZHA je potřeba vytvořit znovu v Zigbee2MQTT.
- Čas. Každé zařízení se resetuje a znovu spáruje, jedno po druhém. Poctivé odhady času zatím nemáme; na malou domácnost počítej s jedním večerem, na velkou s víc.
Dva způsoby přechodu
| Druhý adaptér | Stejný adaptér | |
|---|---|---|
| Cena | Nový adaptér, asi 30–60 € (například Home Assistant Connect ZBT-2 nebo SMLIGHT SLZB-06M či SLZB-07) | Zdarma |
| Během přechodu | Všechno dál funguje: ZHA si nechává starý adaptér | Zigbee nefunguje, dokud každé zařízení znovu nespáruješ |
| Tempo | Místnost po místnosti, klidně i během několika dní | Všechno najednou |
| Návrat zpět | Snadný: odpoj nový adaptér, ZHA nikdy nepřestalo běžet | Obnov zálohu ZHA (viz Návrat zpět) |
Druhý adaptér
- Nastav Zigbee2MQTT na novém adaptéru (s aplikacemi nebo Docker) s vlastní sítí. Tohle všechno zvol před prvním spuštěním Zigbee2MQTT, protože pozdější změna kanálu může znamenat nové párování:
- síťový klíč a PAN ID nech na
GENERATE(výchozí hodnota); - vyber jiný kanál, než má ZHA (ukáže ho ⚙ › Network information u ZHA); Home Assistant doporučuje 15, 20 nebo 25.
- síťový klíč a PAN ID nech na
- Oba adaptéry drž od sebe, každý na USB prodlužovacím kabelu.
- V Home Assistant OS ti Home Assistant po připojení nového adaptéru může nabídnout jeho nastavení pro ZHA nebo Thread. Ignoruj to: adaptér je pro Zigbee2MQTT.
- Přesouvej jednu místnost po druhé: nejdřív spáruj zařízení napájená ze sítě (žárovky, zásuvky, vypínače ve zdi: jsou to routery), pak bateriová zařízení.
- Až přesuneš všechna zařízení, zakaž ZHA (postup níže) a starý adaptér si nech jako náhradní.
Stejný adaptér
- Stáhni zálohu ZHA (viz Než začneš) těsně předtím, než začneš.
- Zakaž ZHA: Nastavení › Zařízení a služby › Zigbee Home Automation, ⋮ vedle Zigbee Home Automation › Disable. Ne Delete.
- Nastav Zigbee2MQTT na stejném adaptéru (s aplikacemi nebo Docker), síťový klíč a PAN ID nech na
GENERATE. - Vypni zařízení Zigbee napájená ze sítě vypínačem na zdi nebo jističem. Jinak budou dál hledat starou síť.
- Zapínej je zpátky jedno po druhém a každé spáruj, jakmile naběhne. Pak spáruj bateriová zařízení.
Tvůj adaptér
- Silicon Labs (Home Assistant Connect ZBT-1 a ZBT-2, Home Assistant Yellow, Sonoff ZBDongle-E, SMLIGHT SLZB-06M a SLZB-07):
adapter: ember. ZBT-2 potřebuje navícbaudrate: 460800; ZBDongle-E potřebujertscts: false; SLZB-06M potřebuje firmware 20240510 nebo novější. - Texas Instruments (Sonoff ZBDongle-P, SMLIGHT SLZB-06 a SLZB-06P7):
adapter: zstack. - ConBee nebo RaspBee:
adapter: deconz. - CC2531 nebo ZiGate: na dobrou síť Zigbee2MQTT jsou příliš staré nebo už nejsou udržované. Zvol způsob s druhým adaptérem a pořiď nový adaptér.
- Síťový adaptér (SMLIGHT SLZB-06, SLZB-06M, SLZB-07, MR series): ZHA ho ukazuje jako
socket://IP:6638; v Zigbee2MQTT je totcp://IP:6638a Docker nepotřebuje řádek pro USB. - Multiprotokol (ZBT-1 nebo Yellow, na kterých běží Zigbee a Thread současně; uvádí to stránka hardwaru v Home Assistantu): Zigbee2MQTT neumí používat multiprotokolový firmware. Při způsobu se stejným adaptérem vypni multiprotokol ještě na ZHA, postupem od samotného Home Assistantu (ZBT-1, Yellow). Zařízení Thread, která ho používala, přestanou fungovat, dokud je nepřevezme jiný Thread border router. Při způsobu s druhým adaptérem ho nech být a nový adaptér kup jen pro Zigbee.
Podrobnosti najdeš na stránkách o adaptérech Zigbee2MQTT.
Home Assistant s aplikacemi (Home Assistant OS)
- V Nastavení › Apps nainstaluj a spusť Mosquitto broker. Home Assistant pak nabídne integraci MQTT v Nastavení › Zařízení a služby: přijmi ji.
- Přidej repozitář Zigbee2MQTT (v obchodě s aplikacemi ⋮ › Repositories:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), pak nainstaluj Zigbee2MQTT. - Na jeho kartě Configuration nastav sériový port a adaptér podle části Tvůj adaptér, například:
Při způsobu s druhým adaptérem nastav před prvním spuštěním i kanál (viz výše).port: /dev/serial/by-id/usb-... adapter: ember - Spusť Zigbee2MQTT a otevři jeho webovou stránku ze stránky aplikace. Pak přejdi k párování.
Home Assistant v Dockeru (bez aplikací)
Bez aplikací běží Mosquitto a Zigbee2MQTT jako samostatné kontejnery vedle Home Assistantu. V nové složce:
1. compose.yaml (do devices zadej cestu k adaptéru; ukáže ji ls /dev/serial/by-id/):
services:
mosquitto:
image: eclipse-mosquitto:2
restart: unless-stopped
ports:
- 1883:1883
volumes:
- ./mosquitto/config:/mosquitto/config
- ./mosquitto/data:/mosquitto/data
zigbee2mqtt:
image: ghcr.io/koenkk/zigbee2mqtt
restart: unless-stopped
depends_on:
- mosquitto
ports:
- 8080:8080
volumes:
- ./zigbee2mqtt:/app/data
- /run/udev:/run/udev:ro
environment:
- TZ=Europe/Berlin
devices:
- /dev/serial/by-id/usb-...:/dev/ttyACM0
Se síťovým adaptérem vynech devices a řádek s udev.
2. mosquitto/config/mosquitto.conf:
listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/
Vytvoř uživatele MQTT (heslo se zadává dvakrát; soubor musí patřit vlastnímu uživateli Mosquitta, jinak se Mosquitto nespustí):
docker run -it --rm -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto:2 \
sh -c "mosquitto_passwd -c /mosquitto/config/passwd zigbee && chown mosquitto:mosquitto /mosquitto/config/passwd"
3. zigbee2mqtt/configuration.yaml (řádky pro adaptér podle části Tvůj adaptér):
homeassistant:
enabled: true
frontend:
enabled: true
port: 8080
mqtt:
server: mqtt://mosquitto:1883
user: zigbee
password: your-password
serial:
port: /dev/ttyACM0 # a network adapter: tcp://IP:6638
adapter: ember
advanced:
network_key: GENERATE
pan_id: GENERATE
ext_pan_id: GENERATE
channel: 20 # second adapter: not ZHA's channel
4. Při způsobu se stejným adaptérem je teď ZHA zakázané (viz výše). Pokud kontejner samotného Home Assistantu mapuje adaptér, odstraň ten řádek z jeho compose souboru nebo z docker run: adaptér může používat jen jeden kontejner.
5. docker compose up -d, pak otevři http://the-machine:8080: webovou stránku Zigbee2MQTT.
6. V Home Assistantu: Nastavení › Zařízení a služby › Přidat integraci › MQTT. Broker: IP adresa počítače, port 1883, uživatel zigbee a heslo.
Párování zařízení
- Na webové stránce Zigbee2MQTT klepni na Permit join (párování zůstane otevřené asi čtyři minuty). Chceš-li párovat přes router blízko zařízení, vyber ten router v nabídce permit join: hodí se to pro Aqara a jiná vybíravá zařízení.
- Přepni zařízení do režimu párování podle návodu výrobce: u většiny senzorů dlouhým stiskem, u žárovek několikerým vypnutím a zapnutím, u některých vypínačů ve zdi sérií přepnutí.
- Až se objeví, dej mu v Zigbee2MQTT jméno a místnost. Pak další.
Nejdřív zařízení napájená ze sítě, potom bateriová, aby nová síť měla trasy.
Po přechodu
- ZigDash: otevři ho a klepni na Najít moje zařízení. Najde Mosquitto ve tvé síti; přihlas se uživatelem MQTT. Nebo zvol Home Assistant a přihlas se: to teď funguje také, protože Home Assistant má integraci MQTT.
- Názvy a místnosti: Nastavení › Import z Home Assistantu v ZigDash přenese názvy a místnosti, které jsi novým zařízením dal v Home Assistantu.
- Home Assistant: přesměruj automatizace, skripty a dashboardy na nová zařízení. Až si budeš jistý, smaž integraci ZHA.
Návrat zpět
- Druhý adaptér: zastav Zigbee2MQTT a odpoj nový adaptér. ZHA nikdy nepřestalo běžet. Zařízení, která už jsi přesunul, je potřeba znovu spárovat se ZHA.
- Stejný adaptér: zastav Zigbee2MQTT a pak na stránce ZHA klepni na Enable. ZHA hlásí "Network settings do not match most recent backup" (nastavení sítě neodpovídá poslední záloze), protože adaptér teď drží síť Zigbee2MQTT. Otevři Nastavení › Opravy › "Zigbee network settings have changed" (nastavení sítě Zigbee se změnilo) a zvol Restore backup (recommended). Síť ZHA se vrátí tak, jak byla. Zařízení, která jsi spároval se Zigbee2MQTT, je potřeba znovu spárovat se ZHA. Pokud se žádná oprava neobjeví, použij ⚙ › Migrate adapter se zálohou, kterou jsi stáhl.
Zachování sítě bez nového párování
Existuje i třetí způsob: zkopírovat síť ZHA do Zigbee2MQTT, aby zařízení nebylo nutné znovu párovat. Zigbee2MQTT ho nepodporuje, chybná hodnota může síť smazat a dává smysl jen u velkých domácností (řekněme nad 60 zařízení). Pokud si o tom chceš přečíst: odpověď správce Zigbee2MQTT a zkušenosti komunity v diskusi 24478 a diskusi 26716.