Helpery w Home Assistant: input_boolean, timer i counter w automatyzacjach

Czym są helpery w Home Assistant i po co je stosować?

Helpery to wbudowane komponenty Home Assistant, które przechowują pojedynczą, prostą wartość: stan włączony lub wyłączony, liczbę albo czas. Zamiast każdorazowo pisać skomplikowane warunki w automatyzacji, tworzysz raz helper, a potem odwołujesz się do niego z każdego scenariusza. To trochę jak zmienne w programowaniu, tylko dostępne bez pisania ani jednej linijki kodu YAML.

Po co to w ogóle komplikować? Bo bez helperów szybko gubisz się we własnych automatyzacjach. Wyobraź sobie sytuację, w której chcesz zablokować działanie sceny "wyłącz światło w salonie", gdy ktoś ogląda film. Piszesz warunek, potem drugi, trzeci dla innego pokoju. Za chwilę masz pięć automatyzacji z tym samym, skopiowanym warunkiem. Mylne założenie. Wystarczy jeden input_boolean o nazwie "tryb filmowy", który przełączasz jedną automatyzacją, a reszta tylko sprawdza jego stan.

Najczęściej używane helpery to:

• input_boolean, czyli prosty przełącznik, który trzyma wartość logiczną prawda lub fałsz, idealny do włączania trybów nocnych albo blokad.
• timer, który odlicza czas do zera i pozwala wywołać akcję po jego zakończeniu, na przykład automatyczne wyłączenie czajnika po 5 minutach.
• counter, czyli licznik, który zwiększa lub zmniejsza wartość o jeden, przydatny do zliczania osób w domu albo cykli pracy pralki.
• input_number, który przechowuje wartość liczbową z zadanego zakresu, na przykład temperaturę docelową w sypialni.
• input_datetime, który zapamiętuje konkretną datę i godzinę, na przykład termin przeglądu pieca.

Każdy z nich wyświetlisz na panelu jako zwykłą kartę, a stan możesz zmieniać ręcznie albo automatyzacją. I tu dochodzimy do sedna sprawy. Źródłem bywa nie sam helper, a logika, która go obsługuje. Częsty błąd: zapominasz o restore state, czyli odtworzeniu stanu po restarcie systemu. Bez tego po awarii prądu twój input_boolean wróci do wartości domyślnej, a cała automatyzacja zacznie działać inaczej niż planowałeś.

Moim zdaniem timer bywa lepszym wyborem niż input_boolean z automatyzacją opóźniającą, ponieważ sam raportuje pozostały czas i pozwala na przerwanie bez pisania dodatkowych warunków. W praktyce wygląda to tak: chcesz, żeby wentylator w łazience działał 10 minut po wyjściu. Z input_boolean musisz ręcznie pilnować czasu w automatyzacji. Z timerem ustawiasz czas, a on sam wyzwala zdarzenie timer.finished. Prościej się nie da. To nie czarna magia, tylko kwestia doboru narzędzia do konkretnej potrzeby.

Na koniec jedna uwaga. Helpery kuszą prostotą, ale nie przesadzaj z ich liczbą. Kilkadziesiąt przełączników w konfiguracji robi się nieczytelne, a każdy z nich zajmuje trochę pamięci. Trzymaj się zasady: dodajesz helper tylko wtedy, gdy używasz go w co najmniej dwóch automatyzacjach. Wtedy naprawdę działa na twoją korzyść.

input_boolean – wirtualne przełączniki w praktycznych automatyzacjach

input_boolean to wirtualny przełącznik, który działa jak fizyczny włącznik światła, ale nie wymaga żadnego okablowania. W Home Assistant znajdziesz go w zakładce ustawień jako helper, a jego stan możesz odczytywać i zmieniać w automatyzacjach. To fundament, na którym buduje się wiele zaawansowanych scen, bo pozwala przechowywać informację o trybie pracy całego domu.

Najczęstsze zastosowanie to tryb "domu" i "poza domem". Zamiast pisać skomplikowane warunki w każdej automatyzacji osobno, tworzysz jeden przełącznik, który steruje całą grupą scen. Kiedy wychodzisz, ustawiasz go na "off", a wszystkie automatyzacje reagują odpowiednio: światła gasną, ogrzewanie zwalnia, rolety się zamykają. To czysta logika, która oszczędza czas i nerwy przy konfiguracji.

Wyobraź sobie sytuację, w której masz w salonie czujnik ruchu. Bez helpera światło włączałoby się za każdym razem, gdy przechodzi kot. Z input_boolean o nazwie "tryb_kinowy" możesz jednym kliknięciem zablokować działanie czujnika na czas seansu. Stan przełącznika możesz też zmieniać głosowo przez Asystenta Google lub Alexę, co czyni go świetnym interfejsem dla domowników niezaznajomionych z technologią.

Spójrz na porównanie, które pokazuje, kiedy warto sięgnąć po input_boolean, a kiedy lepiej zastosować inne narzędzie:

Moim zdaniem input_boolean działa lepiej niż template sensor w sytuacjach, gdzie potrzebujesz prostego przełącznika z interfejsem użytkownika. Template sensor to świetne narzędzie do obliczeń, ale nie do ręcznego sterowania. Helper daje ci gotowy suwak w interfejsie, historię zmian i możliwość dodania do pulpitu jednym kliknięciem. Diabeł tkwi w szczegółach, a tutaj szczegóły są dopracowane.

Warto też pamiętać o integracji z panelami dotykowymi i aplikacjami mobilnymi. Stan input_boolean możesz wyświetlić na ekranie tabletu zamontowanym przy drzwiach wejściowych. Dzięki temu domownicy widzą, jaki tryb jest aktywny i mogą go zmienić bez zaglądania do aplikacji. To duża wygoda, zwłaszcza gdy masz w domu osoby, które nie chcą uczyć się obsługi Home Assistant od podstaw.

timer – jak zarządzać odliczaniem czasu w scenariuszach smart home

Wyobraź sobie sytuację, w której chcesz, żeby światło w garażu zgasło samo po pięciu minutach od otwarcia drzwi. Oczywiście, można to rozwiązać w automatyzacji, używając opóźnienia i warunku. Ale co, jeśli ktoś wejdzie do garażu ponownie w trakcie odliczania? Czas zacznie się od nowa, a może się okazać, że światło zgaśnie w najmniej odpowiednim momencie. Właśnie do takich scenariuszy służy helper typu timer.

Timer w Home Assistant to wirtualny minutnik, który działa podobnie do kuchennego. Możesz go uruchomić, zatrzymać, wznowić lub anulować, a wszystko to odbywa się za pomocą prostych akcji w automatyzacjach. Największa przewaga nad zwykłym opóźnieniem polega na tym, że timer ma swój stan, który możesz odczytać. Możesz sprawdzić, czy odliczanie trwa, albo ile czasu zostało, i na tej podstawie sterować innymi urządzeniami. To zmienia sposób myślenia o sekwencjach czasowych.

Zanim przejdziesz do praktyki, poznaj podstawowe akcje dla timera:

• timer.start uruchamia odliczanie, a jeśli podasz parametr duration, ustawisz nowy czas trwania.
• timer.pause wstrzymuje odliczanie w danym momencie, zapamiętując pozostały czas.
• timer.cancel całkowicie zatrzymuje timer i resetuje go do stanu nieaktywnego.
• timer.finish kończy odliczanie natychmiast, co wywołuje zdarzenie timer.finished.

Częstym błędem jest uruchamianie timera w pętli, gdy automatyzacja wyzwala się od zmian jego stanu. Wtedy ryzykujesz zapętlenie. Bez owijania w bawełnę: trzymaj się zasady, że timer uruchamia się przez konkretne zdarzenie, na przykład ruch z czujnika, a nie przez stan samego timera. Brzmi prosto? Cóż, wiele osób zgłasza problemy właśnie z tego powodu.

Timer sprawdza się lepiej niż klasyczne opóźnienia w scenariuszach, gdzie czas ma być dynamiczny i zależny od warunków. Możesz go użyć na przykład do wentylacji: włączasz ją na 15 minut po wykryciu wilgoci, ale każde kolejne wykrycie wilgoci wydłuża działanie o kolejne 5 minut. Z samym delay takiej logiki nie zbudujesz prosto. Warto też pamiętać, że timer można powiązać z encją pomocniczą w interfejsie, co daje ci wizualną kontrolę nad odliczaniem, a to duża wygoda podczas testowania automatyzacji.

counter – liczniki zdarzeń i ich zastosowanie w zaawansowanych regułach

Counter to helper, który działa jak cyfrowy licznik. Możesz go zwiększać, zmniejszać i resetować do zera. Brzmi banalnie, ale to jedno z najpotężniejszych narzędzi do budowania logiki warunkowej w automatyzacjach. Dzięki niemu możesz policzyć, ile razy dane zdarzenie wystąpiło w ciągu dnia, tygodnia albo od ostatniego resetu. To podstawa do tworzenia reguł, które reagują dopiero po przekroczeniu progu, a nie przy pierwszym sygnale.

Typowy przykład: wyobraź sobie sytuację, w której chcesz otrzymać powiadomienie o otwartych drzwiach lodówki, ale dopiero gdy są otwarte dłużej niż dwie minuty. Możesz to osiągnąć za pomocą timera, ale co jeśli chcesz wiedzieć, że w ciągu godziny drzwi były otwierane więcej niż pięć razy? Wtedy counter staje się nieoceniony. Każde otwarcie zwiększa licznik, a automatyzacja sprawdza jego wartość po upływie ustalonego czasu. Jeśli przekroczy próg, dostajesz alert o potencjalnym problemie z chłodzeniem. To prosta logika, która realnie pomaga wychwycić awarię, zanim zepsuje się jedzenie.

W porównaniu z input_boolean, który przechowuje tylko dwie wartości (true lub false), counter daje ci skalę. Możesz zliczać uruchomienia pralki, cykle nawadniania ogrodu albo próby wejścia do domu. W połączeniu z warunkami czasowymi tworzy to zaawansowane scenariusze, których nie da się zrealizować na prostych przełącznikach. A co jeśli chcesz zresetować licznik o północy? Wystarczy automatyzacja wywoływana o konkretnej godzinie, która ustawia wartość na zero.

Counter sprawdza się lepiej niż timer w większości scenariuszy związanych z wykrywaniem anomalii, ponieważ liczba zdarzeń w przedziale czasu mówi więcej niż pojedynczy pomiar czasu trwania. Timer odpowie na pytanie "jak długo", a counter na "jak często". Ta druga perspektywa bywa dużo bardziej przydatna w automatyce domowej. Counter pomaga je dostrzec.

Łączenie helperów: przykład kompleksowej automatyzacji krok po kroku

Wyobraź sobie sytuację, w której chcesz, żeby światło w garażu gasło automatycznie po wyjściu z domu, ale tylko wtedy, gdy nikt nie został w środku. Pojedynczy input_boolean to za mało. Potrzebujesz kilku stanów naraz: czy ktoś jest w domu, czy garaż był ostatnio używany, i czy minął już czas bezpieczny. Tu zaczyna się zabawa w łączenie helperów.

Budujesz logikę warstwowo. Counter zlicza osoby w strefie, input_boolean przechowuje stan systemu, a timer wymusza opóźnienie. Działają razem, ale każdy pełni inną rolę. Bez tego kombinowania automatyzacja albo wyłączy światło za wcześnie, albo będzie świecić całą noc. Trudno powiedzieć, która opcja gorsza.

Kluczowa zasada: helpery komunikują się przez automatyzacje, nie bezpośrednio. Każdy z nich to osobny byt, a Ty piszesz reguły przejść między nimi. Częsty scenariusz wygląda tak: counter osiąga zero, to wyzwala start timera, a jego koniec odpala usługę wyłączenia światła.

Moim zdaniem counter sprawdza się lepiej niż input_boolean w miejscach, gdzie liczy się liczba osób lub zdarzeń. Boolean daje tylko zero albo jedynkę, a counter daje pełną kontrolę nad wartością. Dla garażu z dwoma wejściami to różnica między "ktoś może tam być" a "wiem dokładnie, że jest jedna osoba". Brzmi prosto, ale oszczędza nerwów przy skomplikowanych instalacjach. Zresztą, po co zgadywać, skoro można policzyć?

Najczęściej zadawane pytania (FAQ)

Czy helpery spowalniają działanie Home Assistant? W praktyce nie odczujesz różnicy. To lekkie obiekty, które trzymają stan w pamięci. Problem pojawia się dopiero przy setkach automatyzacji na jednym helperze, ale to rzadki scenariusz.

Jak długo helpery przechowują historię zmian? Domyślnie Home Assistant trzyma historię przez okres określony w konfiguracji purgera, zwykle 10 dni. Dla input_boolean i timera to aż nadto, ale dla countera przydaje się dłuższy okres, szczególnie gdy liczysz np. cykle prania to zagadnienie szczegółowo omawiamy w artykule "Home assistant template sensor jak tworzyc".

• Czy mogę użyć input_boolean do sterowania ogrzewaniem? Tak, to częsta praktyka. Traktuj go jak wirtualny przełącznik, który włącza i wyłącza tryb komfortu. Tylko że zamiast fizycznego przekaźnika sterujesz regułami klimatyzacji.
• Timer zniknie po restarcie systemu? Niestety tak. Stan timera nie jest trwały, po ponownym uruchomieniu Home Assistant wraca do wartości początkowych. Jeśli zależy ci na czasie pozostałym do końca, zapisz go w osobnym helperze lub użyj automatyzacji z wyzwalaniami opartymi na czasie.
• Jak zresetować counter bez dotykania interfejsu? Najprościej wywołać usługę counter.reset z poziomu automatyzacji lub panelu Developer Tools. Możesz też ustawić wartość ręcznie przez counter.set_value, co daje pełną kontrolę.

Który helper wybrać do prostego włącznika światła w łazience? Zwykle input_boolean wystarczy, ale do zaawansowanego harmonogramu lepszy bywa timer. Timer działa lepiej niż input_boolean w scenariuszach z automatycznym wyłączeniem po upływie czasu, bo nie musisz pisać dodatkowych warunków. A jeśli potrzebujesz zliczać zdarzenia, np. ile razy drzwi były otwarte, to już rola countera.

Brzmi prosto? Cóż, większość użytkowników zaczyna od input_boolean, a potem odkrywa, że timer i counter dają więcej możliwości w integracjach. Wyobraź sobie sytuację, w której chcesz, aby światło gasło po 5 minutach od wykrycia ruchu, ale tylko dwa razy na godzinę. Sam input_boolean tego nie załatwi, a timer zliczy czas, a counter ograniczy częstotliwość.