Przejście z ZHA na Zigbee2MQTT
ZHA to wbudowana obsługa Zigbee w Home Assistant. ZigDash współpracuje z Zigbee2MQTT, więc nie pokaże urządzeń, które są w ZHA. Przejście oznacza ponowne sparowanie urządzeń z Zigbee2MQTT. Home Assistant nadal z nich korzysta, przez integrację MQTT.
Zanim zaczniesz
- Jaka instalacja? Jeśli menu Ustawienia w Home Assistant pokazuje Apps (w starszych wersjach Add-ons), masz Home Assistant OS: zobacz z aplikacjami. Jeśli nie, Home Assistant działa w Dockerze (Container): zobacz Docker.
- Jaki adapter? Otwórz Ustawienia › Urządzenia oraz usługi › Zigbee Home Automation. W sekcji Hubs adapter jest podany według modelu, na przykład SONOFF ZBDongle-E. Potem sprawdź swój adapter.
- Zrób kopię zapasową ZHA. Na tej stronie dotknij ⚙ obok Zigbee Home Automation, potem Download backup. Zachowaj plik. Na tej samej stronie Network information pokazuje kanał, typ radia i port szeregowy.
- Co zmienia się w Home Assistant. Urządzenia wracają jako nowe urządzenia MQTT z nowymi identyfikatorami encji. Automatyzacje, skrypty i dashboardy, które z nich korzystają, trzeba przestawić na nowe urządzenia, a ich historia zaczyna się od nowa. Grupy i powiązania utworzone w ZHA trzeba utworzyć ponownie w Zigbee2MQTT.
- Czas. Każde urządzenie trzeba zresetować i sparować ponownie, jedno po drugim. Nie mamy jeszcze rzetelnych danych o czasie; na mały dom zaplanuj wieczór, na duży więcej.
Dwa sposoby przejścia
| Drugi adapter | Ten sam adapter | |
|---|---|---|
| Koszt | Nowy adapter, około 30–60 € (na przykład Home Assistant Connect ZBT-2 albo SMLIGHT SLZB-06M lub SLZB-07) | Za darmo |
| W trakcie przejścia | Wszystko dalej działa: ZHA zostaje przy starym adapterze | Zigbee nie działa, dopóki każde urządzenie nie zostanie ponownie sparowane |
| Tempo | Pokój po pokoju, nawet przez kilka dni | Wszystko naraz |
| Powrót | Łatwy: odłącz nowy adapter, ZHA cały czas działało | Przywróć kopię zapasową ZHA (zobacz Powrót) |
Drugi adapter
- Skonfiguruj Zigbee2MQTT na nowym adapterze (z aplikacjami lub Docker) z osobną siecią. Wybierz to wszystko przed pierwszym uruchomieniem Zigbee2MQTT, bo późniejsza zmiana kanału może oznaczać ponowne parowanie:
- klucz sieci i PAN ID zostaw na
GENERATE(domyślnie); - wybierz inny kanał niż w ZHA (pokazuje go ⚙ › Network information w ZHA); Home Assistant zaleca 15, 20 lub 25.
- klucz sieci i PAN ID zostaw na
- Trzymaj oba adaptery z dala od siebie, każdy na przedłużaczu USB.
- W Home Assistant OS po podłączeniu nowego adaptera Home Assistant może zaproponować jego konfigurację dla ZHA lub Thread. Zignoruj to: adapter jest dla Zigbee2MQTT.
- Przenoś po jednym pokoju: najpierw sparuj urządzenia zasilane z sieci (żarówki, wtyczki, włączniki podtynkowe: to routery), potem urządzenia na baterie.
- Gdy wszystkie urządzenia są przeniesione, wyłącz ZHA (opis poniżej) i zachowaj stary adapter jako zapasowy.
Ten sam adapter
- Pobierz kopię zapasową ZHA (zobacz Zanim zaczniesz) tuż przed rozpoczęciem.
- Wyłącz ZHA: Ustawienia › Urządzenia oraz usługi › Zigbee Home Automation, ⋮ obok Zigbee Home Automation › Disable. Nie Delete.
- Skonfiguruj Zigbee2MQTT na tym samym adapterze (z aplikacjami lub Docker), zostawiając klucz sieci i PAN ID na
GENERATE. - Wyłącz urządzenia Zigbee zasilane z sieci włącznikiem na ścianie lub bezpiecznikiem. Inaczej będą dalej szukać starej sieci.
- Włączaj je z powrotem po jednym i paruj każde, gdy tylko się włączy. Potem sparuj urządzenia na baterie.
Twój adapter
- Silicon Labs (Home Assistant Connect ZBT-1 i ZBT-2, Home Assistant Yellow, Sonoff ZBDongle-E, SMLIGHT SLZB-06M i SLZB-07):
adapter: ember. ZBT-2 wymaga teżbaudrate: 460800; ZBDongle-E wymagartscts: false; SLZB-06M wymaga firmware'u 20240510 lub nowszego. - Texas Instruments (Sonoff ZBDongle-P, SMLIGHT SLZB-06 i SLZB-06P7):
adapter: zstack. - ConBee lub RaspBee:
adapter: deconz. - CC2531 lub ZiGate: za stare lub już nierozwijane, by zbudować na nich dobrą sieć Zigbee2MQTT. Wybierz sposób z drugim adapterem i kup nowy adapter.
- Adapter sieciowy (SMLIGHT SLZB-06, SLZB-06M, SLZB-07, MR series): ZHA pokazuje go jako
socket://IP:6638; w Zigbee2MQTT totcp://IP:6638, a Docker nie potrzebuje linii z USB. - Multiprotokół (ZBT-1 lub Yellow z Zigbee i Thread działającymi jednocześnie; informuje o tym strona sprzętu w Home Assistant): Zigbee2MQTT nie obsługuje firmware'u multiprotokołowego. Przy sposobie z tym samym adapterem wyłącz multiprotokół jeszcze na ZHA, według procedury samego Home Assistant (ZBT-1, Yellow). Urządzenia Thread, które z niego korzystały, przestaną działać, dopóki nie przejmie ich inny Thread border router. Przy sposobie z drugim adapterem zostaw to bez zmian i kup nowy adapter tylko do Zigbee.
Szczegóły są na stronach o adapterach Zigbee2MQTT.
Home Assistant z aplikacjami (Home Assistant OS)
- W menu Ustawienia › Apps zainstaluj i uruchom Mosquitto broker. Home Assistant zaproponuje wtedy integrację MQTT w menu Ustawienia › Urządzenia oraz usługi: zaakceptuj ją.
- Dodaj repozytorium Zigbee2MQTT (w sklepie z aplikacjami ⋮ › Repositories:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), potem zainstaluj Zigbee2MQTT. - Na jego karcie Configuration ustaw port szeregowy i adapter według sekcji Twój adapter, na przykład:
Przy sposobie z drugim adapterem ustaw też kanał (zobacz wyżej) przed pierwszym uruchomieniem.port: /dev/serial/by-id/usb-... adapter: ember - Uruchom Zigbee2MQTT i otwórz jego stronę WWW ze strony aplikacji. Potem przejdź do parowania.
Home Assistant w Dockerze (bez aplikacji)
Bez aplikacji Mosquitto i Zigbee2MQTT działają jako osobne kontenery obok Home Assistant. W nowym folderze:
1. compose.yaml (wpisz ścieżkę adaptera w devices; pokaże ją 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
Z adapterem sieciowym pomiń devices i linię z udev.
2. mosquitto/config/mosquitto.conf:
listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/
Utwórz użytkownika MQTT (hasło trzeba podać dwa razy; plik musi należeć do własnego użytkownika Mosquitto, inaczej Mosquitto się nie uruchomi):
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 (linie adaptera według sekcji Twój adapter):
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. Przy sposobie z tym samym adapterem ZHA jest już wyłączone (zobacz wyżej). Jeśli kontener samego Home Assistant mapuje adapter, usuń tę linię z jego pliku compose lub z docker run: z adaptera może korzystać tylko jeden kontener.
5. docker compose up -d, potem otwórz http://the-machine:8080: stronę WWW Zigbee2MQTT.
6. W Home Assistant: Ustawienia › Urządzenia oraz usługi › Dodaj integrację › MQTT. Broker: adres IP komputera, port 1883, użytkownik zigbee i hasło.
Parowanie urządzeń
- Na stronie WWW Zigbee2MQTT dotknij Permit join (parowanie jest otwarte przez około cztery minuty). Aby sparować przez router blisko urządzenia, wybierz ten router w menu permit join: przydaje się to przy Aqara i innych kapryśnych urządzeniach.
- Przełącz urządzenie w tryb parowania tak, jak podaje producent: w większości czujników długim naciśnięciem, w żarówkach kilkoma cyklami wyłącz/włącz, w niektórych włącznikach podtynkowych serią przełączeń.
- Gdy się pojawi, nadaj mu nazwę i pokój w Zigbee2MQTT. Potem następne.
Najpierw urządzenia zasilane z sieci, potem urządzenia na baterie, żeby nowa sieć miała trasy.
Po przejściu
- ZigDash: otwórz aplikację i dotknij Znajdź moją instalację. Znajdzie Mosquitto w Twojej sieci; zaloguj się użytkownikiem MQTT. Możesz też wybrać Home Assistant i się zalogować: to teraz też działa, bo Home Assistant ma integrację MQTT.
- Nazwy i pokoje: Ustawienia › Import z Home Assistant w ZigDash pobiera nazwy i pokoje nadane nowym urządzeniom w Home Assistant.
- Home Assistant: przestaw automatyzacje, skrypty i dashboardy na nowe urządzenia. Gdy masz pewność, usuń integrację ZHA.
Powrót
- Drugi adapter: zatrzymaj Zigbee2MQTT i odłącz nowy adapter. ZHA cały czas działało. Urządzenia, które już zostały przeniesione, trzeba ponownie sparować z ZHA.
- Ten sam adapter: zatrzymaj Zigbee2MQTT, potem na stronie ZHA dotknij Enable. ZHA pokaże "Network settings do not match most recent backup" (ustawienia sieci nie zgadzają się z ostatnią kopią zapasową), bo adapter ma teraz sieć Zigbee2MQTT. Otwórz Ustawienia › Naprawy › "Zigbee network settings have changed" (zmieniły się ustawienia sieci Zigbee) i wybierz Restore backup (recommended). Sieć ZHA wraca w dawnej postaci. Urządzenia sparowane z Zigbee2MQTT trzeba ponownie sparować z ZHA. Jeśli żadna naprawa się nie pojawi, użyj ⚙ › Migrate adapter z pobraną kopią zapasową.
Zachowanie sieci bez ponownego parowania
Jest też trzeci sposób: skopiowanie sieci ZHA do Zigbee2MQTT, żeby urządzeń nie trzeba było parować ponownie. Zigbee2MQTT tego nie obsługuje, błędna wartość może skasować sieć, a ma to sens tylko w dużych domach (powiedzmy powyżej 60 urządzeń). Jeśli chcesz o tym poczytać: odpowiedź opiekuna Zigbee2MQTT oraz relacje społeczności w dyskusji 24478 i dyskusji 26716.