Jak przygotować się do aktualizacji Zigbee2MQTT 2.0.0

Zmiany w Zigbee2MQTT 2.0.0: Co musisz wiedzieć

Zigbee2MQTT 2.0.0 wprowadza kilka przełomowych zmian, które koncentrują się głównie na usunięciu przestarzałych funkcji, które były deprecjonowane przez lata. Zmiany te mają na celu uproszczenie systemu, zwiększenie wydajności i kompatybilności z nowszymi sieciami Zigbee.

Jak przygotować się do Zigbee2MQTT 2.0.0

Przed aktualizacją z wersji 1.x.x do 2.0.0 warto wprowadzić kilka zmian w swojej konfiguracji, aby zminimalizować ryzyko wystąpienia problemów. Upewnij się, że w pliku configuration.yaml masz następujące ustawienia:

advanced:
  homeassistant_legacy_entity_attributes: false
  homeassistant_legacy_triggers: false
  legacy_api: false
  legacy_availability_payload: false
device_options:
  legacy: false

Dodatkowo, zaleca się jawne dodanie serial.adapter (to o czym wspominam w https://smartownia.pl/zigbee2mqtt-2-0-0-najczestsze-problemy-po-aktualizacji-i-ich-rozwiazania/) do pliku configuration.yaml.

Ważne

Sprawdź swoją aktualną konfigurację. Istnieje duże prawdopodobieństwo, że niektóre z tych wartości już się tam znajdują i są ustawione na false, szczególnie jeśli Twoja sieć działa od kilku lat. Zmiany oznaczone jako „Tylko w przypadku włączonego trybu legacy” można pominąć, jeśli Twoja konfiguracja już ma te ustawienia.

Co nowego

Ogólne zmiany

• Poprawiona wykrywalność adapterów: podczas aktualizacji z Zigbee2MQTT 1.x.x może wystąpić błąd odkrywania adaptera USB (No valid USB adapter found).
• zstack nie jest już domyślnym ustawieniem dla adapterów. Jeśli Zigbee2MQTT nie może się uruchomić, oznacza to, że Twój adapter używa identyfikatora, który nie jest obecnie rozpoznawany przez Zigbee2MQTT. Upewnij się, że ustawisz odpowiedni adapter w konfiguracji.

Instalacje bare-metal (bez Docker/Home Assistant add-on)

• Dla instalacji opartych na Gicie: usunięto plik configuration.yaml z repozytorium, co spowoduje błąd podczas aktualizacji: error: Your local changes to the following files would be overwritten by merge: data/configuration.yaml Aby to naprawić, wykonaj poniższe kroki: git checkout data/configuration.example.yaml mv data/configuration.yaml data/configuration.yaml.bak ./update.sh mv data/configuration.yaml.bak data/configuration.yaml
• Zamiast npm używany jest teraz pnpm, dlatego przed aktualizacją musisz wykonać: npm install -g pnpm Po zaktualizowaniu plików uruchom skrypt ./update.sh. Jeśli Zigbee2MQTT nie uruchomi się z powodu brakujących plików, uruchom polecenie pnpm run clean, a potem ponownie uruchom Zigbee2MQTT.

Home Assistant

• Wszystkie encje blokady dzieci (child lock) są teraz wykrywane jako przełączniki (switch) zamiast blokady (lock).
• Zostały usunięte encje update_state i update_available (zostały zastąpione przez encje update).
• Zewnętrzne konwertery nie mogą już eksponować encji do Home Assistant za pomocą właściwości homeassistant, teraz należy używać exposes.
• Domyślnie Zigbee2MQTT nie nasłuchuje już na temat statusu hass/status w Home Assistant, zamiast tego używany jest homeassistant/status (jeśli homeassistant.status_topic nie jest ustawiony w pliku configuration.yaml).

Tylko w przypadku włączonego trybu legacy

• Wszystkie czujniki kliknięć (sensor.*_click) zostały usunięte. Zamiast tego należy używać wyzwalacza urządzenia MQTT.
• Wszystkie czujniki akcji (sensor.*_action) są teraz domyślnie wyłączone. Zaleca się używać wyzwalacza urządzenia MQTT. Jeśli naprawdę potrzebujesz czujników akcji, dodaj do swojej konfiguracji: homeassistant: legacy_action_sensor: true
• Atrybuty encji (homeassistant.legacy_entity_attributes) zostały usunięte, co oznacza, że encje odkryte przez Zigbee2MQTT nie będą już miały atrybutów encji.

Zmiany urządzeń specyficznych

• Tuya ZY-M100-24G: zmieniono nazwę z occupancy na presence.
• IKEA ICTC-G-1: usunięto czujnik jasności w Home Assistant.
• Aqara SRTS-A01: wartości child_lock zostały zmienione z true/false na LOCK/UNLOCK.

Zmiany w konwerterach zewnętrznych i rozszerzeniach

• Ustawienie external_converters nie jest już używane. Zamiast tego, wszystkie konwertery zewnętrzne w katalogu data/external_converters są teraz automatycznie ładowane.
• Rozszerzenia zewnętrzne są teraz ładowane z data/external_extensions zamiast data/extension.

Zmiany w API MQTT

• Usunięto właściwość update_available ze stanu urządzenia (należy używać update.state).
• Zmieniono nazwę updateAvailable na update_available w odpowiedzi MQTT dla urządzenia.

Usunięte funkcje i ustawienia

• Nowy system aktualizacji konfiguracji automatycznie (re)mówi przestarzałe ustawienia przy pierwszym uruchomieniu Z2M po aktualizacji do 2.0.0.
• Usunięto opcję raportu (advanced.report), funkcję resetu miękkiego (advanced.soft_reset_timeout) oraz ustawienia związane z dostępnością urządzeń.
• Z powodu zmiany sposobu działania OTA, opcja ota.ikea_ota_use_test_url została usunięta.
• Usunięto ustawienia związane z pozwoleniem na dołączenie do sieci, takie jak permit_join_timeout (zostały zastąpione przez permit_join_end).