Aktualizacja firmware OTA urządzeń Zigbee w Home Assistant: automatyczne updaty

Jak działa aktualizacja firmware OTA w Zigbee i dlaczego ma znaczenie

Zigbee to protokół, który od lat działa w cieniu Wi-Fi i Bluetootha. Mało kto zdaje sobie sprawę, że urządzenia Zigbee też mają firmware, który można aktualizować. OTA (Over-The-Air) to mechanizm, dzięki któremu producent dostarcza nową wersję oprogramowania bezpośrednio przez sieć Zigbee, bez kabli i bez wyjmowania urządzenia ze ściany.

Jak to wygląda w praktyce? Koordynator wysyła plik firmware do urządzenia, które zapisuje go w pamięci i restartuje się z nowym oprogramowaniem. Brzmi prosto. Tylko że w świecie Zigbee diabeł tkwi w szczegółach.

Nie każdy producent udostępnia pliki OTA publicznie. Nie każde urządzenie obsługuje aktualizacje bezprzewodowe. A niektóre aktualizacje potrafią trwać godzinami, bo przepustowość sieci Zigbee jest ograniczona. Typowy scenariusz: masz czujnik temperatury, który od dwóch lat działa bez zarzutu, ale producent wydał poprawkę bezpieczeństwa. Bez OTA zostajesz z dziurą, o której nawet nie wiesz.

Moim zdaniem aktualizacje OTA mają największy sens w przypadku urządzeń stale zasilanych, takich jak przekaźniki czy żarówki, ponieważ tam ryzyko przerwania jest minimalne, a zysk w postaci poprawek błędów i nowych funkcji bywa odczuwalny. W przypadku czujników bateryjnych lepszym wyborem często okazuje się ręczna wymiana lub pozostawienie starego firmware, bo próba aktualizacji może rozładować baterię szybciej niż cokolwiek innego.

Dlaczego to ma znaczenie dla użytkownika Home Assistant? Bo automatyczne aktualizacje mogą działać w tle, ale wymagają świadomej konfiguracji. Bez tego zostajesz z urządzeniami, które nigdy nie dostaną poprawek. A co jeśli się okaże, że twoja sieć Zigbee pada ofiarą błędu, który producent naprawił pół roku temu? Właśnie dlatego warto zrozumieć, jak ten mechanizm działa od podszewki.

Przygotowanie Home Assistant i koordynatora do aktualizacji OTA

Zanim zaczniesz klikać cokolwiek w panelu, sprawdź dwie rzeczy: wersję Home Assistant i stan koordynatora Zigbee. Bez tego aktualizacja OTA może się wysypać w połowie. A przerwany flash to nie żarty.

Home Assistant powinien być aktualny. Starsze wydania mają czasem bugi w obsłudze OTA cluster, przez co urządzenie pobiera obraz, ale go nie zapisuje. Sprawdź też, czy masz włączoną obsługę OTA w konfiguracji integracji Zigbee. W ZHA to opcja w ustawieniach radia, w Zigbee2MQTT parametr w pliku konfiguracyjnym.

Koordynator to drugi filar. Diabeł tkwi w szczegółach: nie każdy adapter radzi sobie z dużymi obrazami firmware. Starsze CC2531 mają za mało pamięci i potrafią się zadławić przy plikach powyżej 100 kB.

Mój wybór? Moim zdaniem koordynatory z chipem CC2652 wypadają lepiej niż starsze CC2531, ponieważ mają więcej pamięci i nie gubią pakietów przy dłuższych transferach. Różnica jest odczuwalna, gdy aktualizujesz kilka urządzeń pod rząd.

Zanim ruszysz z aktualizacją, zrób jedną rzecz: backup bazy danych Zigbee. Jeśli koordynator padnie w trakcie, odtworzysz sieć w kilka minut. Bez kopii czeka cię ponowne parowanie wszystkiego.

Automatyczne aktualizacje firmware w Zigbee2MQTT i ZHA

Obie integracje potrafią sprawdzić, czy producent wypuścił nowszy firmware, i podmienić go bez twojego udziału. Tylko że mechanika działania jest zupełnie inna. Zigbee2MQTT korzysta z plików OTA hostowanych lokalnie lub pobieranych z repozytorium projektu, a ZHA sięga po firmware przez backend Zigpy i zewnętrzne serwery producentów.

W Zigbee2MQTT aktualizacje włączasz w pliku konfiguracyjnym. Domyślnie ta funkcja jest wyłączona, głównie po to, żeby nie zaskoczyć nikogo restar­tem urządzenia w środku nocy. W ZHA nie ma jednego przełącznika. Część koordynatorów i urządzeń wymaga ręcznego wywołania przez usługę, a automat działa tylko dla wybranych modeli.

Typowy przypadek wygląda tak: masz kilkanaście czujników i przełączników, producent wypuszcza poprawkę naprawiającą rozłączanie się z siecią, a ty dowiadujesz się o tym po fakcie. Automat załatwia sprawę, ale kosztem kontroli. Warto najpierw sprawdzić, co dokładnie zmienia nowy firmware.

Moim zdaniem lepszym wyborem bywa włączenie automatycznych aktualizacji tylko w wyznaczonym oknie, na przykład między 3:00 a 5:00, niż zostawienie ich na całą dobę. Powód jest prosty: aktualizacja restartuje urządzenie, a to potrafi wywołać falę zdarzeń w automatyzacjach opartych na obecności. W nocy ryzyko, że coś istotnego przestanie działać, jest po prostu mniejsze.

Ręczne wymuszanie i monitorowanie postępu aktualizacji OTA

Automat działa, dopóki działa. Gdy urządzenie nie chce złapać nowego firmware, zostaje ręka i konsola. W Z2M pojedynczy czujnik aktualizujesz przez zigbee2mqtt/bridge/request/device/ota_update/update, podając nazwę urządzenia w payloadzie. Wywołanie leci jako wiadomość MQTT, więc możesz je odpalić z Narzędzi deweloperskich w Home Assistant.

Coś jest nie tak, gdy po kilku minutach status nadal pokazuje „idle”. Wtedy warto sprawdzić trzy rzeczy: czy plik OTA faktycznie leży w katalogu, czy urządzenie ma dobry zasięg i czy nie śpi na baterii w trybie deep sleep.

Monitorowanie sprowadza się do jednego tematu: zigbee2mqtt/bridge/response/device/ota_update/update. Tam pojawia się status i ewentualny błąd. Moim zdaniem lepiej obserwować ten topic niż polegać na karcie urządzenia w panelu, ponieważ surowa odpowiedź pokazuje dokładny powód odrzucenia, a UI często go gubi.

Typowy przykład: aktualizujesz czujnik temperatury, transfer dochodzi do kilkudziesięciu procent i staje. Urządzenie zasnęło. Trzeba je obudzić przyciskiem i puścić update ponownie. Bez owijania w bawełnę: cierpliwość to połowa sukcesu.

Rozwiązywanie problemów z aktualizacjami OTA w Home Assistant

Najczęstszy problem? Aktualizacja startuje, mieli przez chwilę i kończy się błędem albo po cichu nic się nie dzieje. W większości przypadków winowajcą jest słaby zasięg sieci Zigbee w miejscu montażu urządzenia. Firmware leci przez mesh, więc każdy skok między routerami to kolejna szansa na zgubiony pakiet. Diabeł tkwi w szczegółach, ale diagnoza zwykle sprowadza się do kilku powtarzalnych przyczyn.

Zanim zaczniesz grzebać w konfiguracji, sprawdź, czy w ogóle masz włączoną obsługę OTA. W Zigbee2MQTT to opcja ota: enabled w pliku konfiguracyjnym, a w ZHA odpowiedni przełącznik w ustawieniach integracji. Bez tego przycisk aktualizacji po prostu nie pojawi się przy urządzeniu. To banalne, ale wiele osób szuka głębiej, gdy problem leży na powierzchni.

Urządzenia bateryjne to osobna kategoria problemów. Większość z nich śpi, żeby oszczędzać energię, a transfer firmware wymaga dłuższego przebudzenia. Jeśli czujnik przerwie połączenie w trakcie, aktualizacja się nie dokończy. Moim zdaniem lepiej zaplanować OTA dla takich urządzeń na moment, gdy możesz je fizycznie wybudzić, niż liczyć na automat, który zadziała w tle, ponieważ sen urządzenia jest tu twardym ograniczeniem sprzętowym, a nie kwestią konfiguracji.

Gdy nic nie pomaga, sięgnij po logi. W Zigbee2MQTT poziom debug pokaże, na którym etapie transfer się wykrzacza. To nie czarna magia, tylko kilka linijek, które mówią wprost, czy problem jest w sieci, w pliku, czy w samym urządzeniu.

Najczęściej zadawane pytania (FAQ)

Czy aktualizacja firmware przez OTA w Home Assistant jest bezpieczna? Krótka odpowiedź: tak, jeśli masz świadomość, co się dzieje w tle. Proces polega na wysłaniu pliku przez koordynator Zigbee do urządzenia, a urządzenie samo się restartuje po zapisie. Brzmi prosto. Tylko że przerwanie w złym momencie potrafi zostawić czujnik w stanie, z którego nie wstanie bez ręcznej interwencji.

Najwięcej wątpliwości budzi kwestia chmury. Wiele osób zakłada, że OTA wymaga konta producenta. Nie wymaga, pod warunkiem że plik firmware leży lokalnie. To zmienia wszystko, jeśli zależy ci na niezależności od serwerów zewnętrznych szerzej opisaliśmy to w artykule "Zigbee2mqtt instalacja konfiguracja ha".

• Czy muszę włączyć automatyczne aktualizacje? Nie musisz. Możesz zostawić ręczne zatwierdzanie i sprawdzać dostępne wersje raz na kilka tygodni.
• Skąd Home Assistant bierze pliki firmware? Z lokalnego repozytorium, które sam wskażesz, albo z indeksu OTA, jeśli korzystasz z gotowej integracji.
• Co się stanie, gdy zabraknie prądu w trakcie updatu? Urządzenie może wymagać ponownego sparowania, a w gorszym scenariuszu trzeba je przywrócić do ustawień fabrycznych.
• Czy wszystkie urządzenia Zigbee obsługują OTA? Nie. Część tanich czujników w ogóle nie ma tej funkcji, niezależnie od tego, jak skonfigurujesz sieć.
• Czy aktualizacja wpłynie na moje automatyzacje? Zwykle nie, ale nazwy encji mogą się zmienić po dużym skoku wersji. Warto sprawdzić logi po restarcie.

Moim zdaniem lepiej aktualizować urządzenia partiami niż wszystko naraz, ponieważ pojedynczy błąd nie kładzie całej sieci, a łatwiej wychwycić, który model sprawia problemy. Wyobraź sobie sytuację, w której aktualizujesz dwadzieścia czujników jednocześnie, a jeden z nich przestaje odpowiadać. Przy partiach po trzy, cztery sztuki od razu wiesz, gdzie szukać.

Zanim ruszysz z OTA, zajrzyj do wpisu o instalacji i konfiguracji Zigbee2MQTT w Home Assistant. Podstawa sieci musi działać stabilnie, inaczej diabeł tkwi w szczegółach, których nie przewidzisz.