Zigbee2MQTT 2.0.0: Najczęstsze problemy po aktualizacji i ich rozwiązania

Aktualizacja Zigbee2MQTT do wersji 2.0.0 wprowadziła szereg usprawnień i nowości, ale jak to często bywa, pojawiły się także niespodziewane problemy. Postanowiłem zebrać najczęściej pojawiające się kłopoty i przedstawić Wam sposoby ich rozwiązania. Zaczynajmy!

Typowy problem: Zigbee2MQTT nie chce wystartować

Wyobraźcie sobie sytuację – aktualizujecie oprogramowanie, pełni nadziei na nowe funkcje, a tu… Zigbee2MQTT przestaje działać, a logi rzucają błędami typu:

Error while starting zigbee-herdsman
Failed to start zigbee-herdsman

Spokojnie, jeśli tak masz to nie jesteś jedyny : )

Dlaczego tak się dzieje?

Najczęściej powodem jest brak odpowiedniej konfiguracji adaptera Zigbee w pliku configuration.yaml. W nowej wersji 2.0.0 Zigbee2MQTT wymaga jawnego wskazania, z jakiego adaptera korzystacie.

Jak to naprawić?

1. Otwórz plik configuration.yaml.
2. Znajdź sekcję serial i upewnij się, że wygląda mniej więcej tak:

serial:
adapter: zstack
port: /dev/ttyUSB0

Adapter:

Upewnijcie się, że wybraliście poprawny model, np:

• zstack – dla CC2531, CC2652P.
• ezsp – dla adapterów Sonoff Zigbee 3.0 Dongle Plus.
• deconz – dla ConBee I/II.

Zapisz zmiany, uruchom ponownie Zigbee2MQTT i sprawdź logi.

Problem nr 2: Moje urządzenia zniknęły!

Po aktualizacji Zigbee2MQTT, niektórzy użytkownicy zgłaszają, że ich urządzenia Zigbee zniknęły z konfiguracji. Co się stało? Zmiana w strukturze plików lub problemy z bazą danych mogły spowodować utratę listy urządzeń. No ale jak to naprawić? Są na to dwa sposoby :

1. Kopia zapasowa: Jeśli przed aktualizacją zrobiliście kopie zapasową, wystarczy przywrócić plik configuration.yaml lub folder data.
2. Ponowne parowanie: Niestety, jeśli nie posiadamy kopii zapasowej, konieczne będzie ponowne dodanie urządzeń.

Regularnie twórzcie kopie zapasowe i korzystajcie z narzędzi backupowych w Home Assistant lub proxmox, szczególnie przed aktualizacjami.

Jesteś przed aktualizacją?

Aktualizacja Zigbee z wersji 1.x.x do 2.0.0 to świetna okazja, by poprawić wydajność i kompatybilność. Zanim jednak zdecydujesz się na ten krok, warto przygotować się odpowiednio, by uniknąć nieprzyjemnych niespodzianek. W moim artykule „Jak przygotować się do aktualizacji Zigbee2MQTT 2.0.0” znajdziesz wszystko, co powinieneś wiedzieć, by bezproblemowo przejść przez ten proces. Zajrzyj, jeśli chcesz, by wszystko poszło gładko i bez komplikacji!