Pytanie przez radio, odpowiedź z czujnika
Home Assistant to otwarte oprogramowanie do automatyki domowej: zbiera odczyty czujników, steruje urządzeniami i wykonuje automatyzacje, czyli reguły typu „gdy stanie się X, zrób Y”. Sieć Meshtastic może być dla niego dodatkową drogą kontaktu. Z ogrodu albo warsztatu wysyłasz „status”, a po chwili przychodzi przykładowa odpowiedź „Salon: 21,4 °C”. Jedną liczbę dostajesz wtedy bez otwierania panelu automatyki.
Integracja Meshtastic z Home Assistant udostępnia potrzebne elementy: odbiór wiadomości, wyzwalacze automatyzacji (zdarzenia, które ją uruchamiają) oraz wysyłanie odpowiedzi bezpośrednio do węzła lub na kanał. Samo jej zainstalowanie nie tworzy jednak komendy „status”. To użytkownik określa, na jakie pytanie dom ma reagować i skąd pobierać odpowiedź.
Radio przy domu jest pośrednikiem
Do Home Assistant podłącza się urządzenie Meshtastic pełniące funkcję bramy: przez sieć lokalną (TCP), kablem USB (port szeregowy) albo przez Bluetooth. Integracja nie wchodzi w skład Home Assistant. Autorzy zalecają instalację przez HACS (Home Assistant Community Store, katalog rozszerzeń tworzonych przez społeczność). Repozytorium trzeba w nim najpierw dodać jako własne (custom repository; README ma do tego gotowy przycisk), potem zainstalować integrację, uruchomić ponownie Home Assistant i skonfigurować ją w jego interfejsie. Wymagany jest Home Assistant 2024.11 lub nowszy.
Projekt ma status wersji alfa. Najnowsze wydanie to 0.6.1 z 23 kwietnia 2025 r., a od 6 lipca 2025 r. w repozytorium czeka wersja próbna 0.6.2-rc1.
W proponowanym scenariuszu wiadomość dociera radiowo do domowego węzła, a integracja przekazuje ją automatyzacji. Home Assistant przygotowuje odpowiedź i zleca jej wysłanie przez tę samą bramę. Schemat poniżej pokazuje ten przepływ.
Wiadomości to tylko część możliwości. Dla wybranych węzłów integracja tworzy czujniki z ich pomiarami (np. stan baterii czy odczyty telemetrii), pokazuje ich położenie na mapie Home Assistant i zapisuje odebrane wiadomości w dzienniku zdarzeń (logbook). Ma też wbudowanego klienta webowego Meshtastic do ręcznej obsługi bramy. Autorzy ostrzegają, że po jego włączeniu każdy, kto ma dostęp do Home Assistant, może bez logowania sterować bramą, więc funkcja nadaje się tylko do zaufanej sieci.
Co robi automatyzacja
Proponujemy zacząć od jednej informacji, na przykład temperatury. Logika próby jest prosta: sprawdzić, czy nadeszło dokładnie „status”, odczytać wskazany czujnik i złożyć krótką odpowiedź. W Home Assistant czujnik występuje jako encja – nazwany obiekt ze stanem, do którego można odwołać się w konfiguracji.
Szablony Home Assistant to krótkie wstawki w języku Jinja, które system przy każdym uruchomieniu zastępuje bieżącymi danymi. Dzięki nim liczba w komunikacie pochodzi z odczytu czujnika i nie trzeba jej wpisywać na sztywno. W szablonie dostępne są też dane zdarzenia, które uruchomiło automatyzację: treść wiadomości, numer nadawcy i numer bramy. Opisuje to dokumentacja szablonów automatyzacji.
Opis integracji w repozytorium (plik README) zawiera przykłady automatyzacji, które odsyłają odebraną wiadomość jak echo. Przed odpowiedzią autorzy dodają opóźnienie, co najmniej 2 sekundy, a w przykładach 5 albo 10 sekund. Bez niego firmware Meshtastic może odrzucić wiadomość, bo urządzenie jest jeszcze zajęte odbiorem lub wysyłaniem innych pakietów. Identyfikatory urządzeń i numery węzłów z tych przykładów trzeba zastąpić własnymi.
Najpierw próba przy biurku
Przed użyciem w terenie proponujemy sprawdzić trzy sytuacje: poprawne pytanie, wiadomość o innej treści i niedostępny czujnik. W ostatnim przypadku odpowiedź powinna jasno mówić o braku danych. Temperaturę z odpowiedzi porównaj z panelem Home Assistant i sprawdź, czy komunikat wraca do właściwego odbiorcy.
Automat też nadaje
Automatyzacja powinna reagować tylko na wiadomości bezpośrednie z własnego węzła. Odpowiadanie na każdą wiadomość z kanału zaśmieca wspólną sieć, a każda odpowiedź zajmuje czas nadawania bramy. W Polsce brama musi pracować w regionie EU_868 (869,4–869,65 MHz). Obowiązuje tam limit 500 mW e.r.p. razem z zyskiem anteny i 10% czasu nadawania. Firmware Meshtastic liczy ten limit w oknie godzinowym i po jego wyczerpaniu wstrzymuje nadawanie. Ustawienie override_duty_cycle, które go wyłącza, musi pozostać wyłączone.
Scenariusza nie sprawdziliśmy na fizycznym zestawie, więc nie podajemy zasięgu ani czasu odpowiedzi.
Artykuł powstał na podstawie opisu integracji Meshtastic dla Home Assistant w serwisie GitHub, dokumentacji szablonów Home Assistant i dokumentacji ustawień radia Meshtastic.
