ZigDash

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

Dwa sposoby przejścia

Drugi adapterTen sam adapter
KosztNowy 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ściaWszystko dalej działa: ZHA zostaje przy starym adapterzeZigbee nie działa, dopóki każde urządzenie nie zostanie ponownie sparowane
TempoPokój po pokoju, nawet przez kilka dniWszystko naraz
PowrótŁatwy: odłącz nowy adapter, ZHA cały czas działałoPrzywróć kopię zapasową ZHA (zobacz Powrót)

Drugi adapter

  1. 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.
  2. Trzymaj oba adaptery z dala od siebie, każdy na przedłużaczu USB.
  3. 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.
  4. Przenoś po jednym pokoju: najpierw sparuj urządzenia zasilane z sieci (żarówki, wtyczki, włączniki podtynkowe: to routery), potem urządzenia na baterie.
  5. Gdy wszystkie urządzenia są przeniesione, wyłącz ZHA (opis poniżej) i zachowaj stary adapter jako zapasowy.

Ten sam adapter

  1. Pobierz kopię zapasową ZHA (zobacz Zanim zaczniesz) tuż przed rozpoczęciem.
  2. Wyłącz ZHA: Ustawienia › Urządzenia oraz usługi › Zigbee Home Automation, ⋮ obok Zigbee Home Automation › Disable. Nie Delete.
  3. Skonfiguruj Zigbee2MQTT na tym samym adapterze (z aplikacjami lub Docker), zostawiając klucz sieci i PAN ID na GENERATE.
  4. Wyłącz urządzenia Zigbee zasilane z sieci włącznikiem na ścianie lub bezpiecznikiem. Inaczej będą dalej szukać starej sieci.
  5. 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

Szczegóły są na stronach o adapterach Zigbee2MQTT.

Home Assistant z aplikacjami (Home Assistant OS)

  1. 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ą.
  2. Dodaj repozytorium Zigbee2MQTT (w sklepie z aplikacjami ⋮ › Repositories: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), potem zainstaluj Zigbee2MQTT.
  3. Na jego karcie Configuration ustaw port szeregowy i adapter według sekcji Twój adapter, na przykład:
    port: /dev/serial/by-id/usb-...
    adapter: ember
    Przy sposobie z drugim adapterem ustaw też kanał (zobacz wyżej) przed pierwszym uruchomieniem.
  4. 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ń

  1. 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.
  2. 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ń.
  3. 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

Powrót

Przetestowane: 17 listopada 2026, z Home Assistant 2026.11 i Sonoff ZBDongle-E, sieć ZHA wróciła dokładnie taka sama (kanał, PAN ID i klucz sieci). Nie sprawdziliśmy jeszcze tego ze sparowanymi urządzeniami, więc zachowaj plik kopii zapasowej.

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.

Daj znać, jak poszło. Ten poradnik jest nowy. Jeśli jakiś krok był błędny albo go brakowało, napisz na [email protected] lub do społeczności.