Home Assistant LAB · Dom w praktyce · Rolety zewnętrzne · Lekcja 13
boneIO R01: lokalny przycisk impulsowy GÓRA, DÓŁ i STOP bez Home Assistant
Lokalny przycisk jest podstawowym interfejsem rolety. Konfiguruję go w ESPHome tak, aby GÓRA, DÓŁ i STOP działały także bez Home Assistant. Testuję krótkie i dłuższe naciśnięcia na jednej rolecie, a nie na całym domu, i zapisuję gesty zrozumiałe dla domowników.
Dlaczego ten etap jest ważny
Lokalny przycisk nie jest dodatkiem do Home Assistant, lecz podstawowym interfejsem domownika. Logika klik GÓRA, kolejny klik STOP i analogiczne DÓŁ działa na samym boneIO, dlatego awaria serwera nie odbiera zwykłego sterowania.
W pełnej lekcji zrobisz to krok po kroku
Co zmieniamy względem L12
W podstawowym przykładzie wejść boneIO naciśnięcie przycisku uruchamia akcję, a puszczenie wykonuje STOP. To bardzo dobre zachowanie podczas pierwszego commissioning, ponieważ napęd porusza się tylko wtedy, gdy człowiek świadomie trzyma klawisz. Po potwierdzeniu poprawnego kierunku możemy jednak przejść do wygodniejszego sterowania impulsowego.
Co robi oficjalny przykład boneIO
boneIO w dokumentacji automatyzacji wewnętrznych pokazuje lokalne sterowanie przez stan current_operation komponentu cover. Logika jest bardzo cenna: najpierw sprawdzamy, czy roleta stoi. Jeśli stoi, możemy rozpocząć ruch. Jeśli już się porusza, ta sama akcja może zostać wykorzystana do STOP. Producent pokazuje tę technikę w przykładzie on_multi_click. Dla naszego standardowego pancerza nie potrzebujemy funkcji tilt. Zachowujemy więc najważniejszą część tego wzorca, czyli sprawdzenie COVER_OPERATION_IDLE i lokalne wywołanie OPEN, CLOSE albo STOP.
IN01: jedno naciśnięcie GÓRA ma uruchomić albo zatrzymać
Mapowania pinu nie zmieniamy. IN01 nadal jest pierwszym wejściem ekspandera. Zmieniamy wyłącznie automatyzację. Czytamy ten kod od góry. Po fizycznym naciśnięciu IN01 boneIO tworzy lokalne wywołanie dla cover_01. Jeżeli roleta jest bezczynna, ustawia komendę OPEN. Jeżeli cover raportuje trwający ruch, ustawia STOP. Na końcu call.perform() wykonuje wybraną komendę.
Dlaczego nie korzystamy tutaj z Home Assistant
Kod znajduje się w konfiguracji ESPHome sterownika. Naciśnięcie IN01 nie wysyła najpierw zdarzenia do HA z prośbą o wykonanie automatyzacji. boneIO samo odczytuje wejście i samo wydaje komendę swojemu komponentowi cover_01.
Test przy końcu zakresu
Dojedź do pełnego OPEN. Poczekaj na zatrzymanie napędu na jego krańcówce. Następnie sprawdź zachowanie sterownika. Nie wykonujemy kilkunastu kolejnych kliknięć GÓRA tylko po to, aby słyszeć przekaźnik. Jeżeli roleta jest fizycznie otwarta, normalną następną komendą użytkownika będzie DÓŁ. To samo sprawdzamy na dolnej krańcówce. Prawidłowo ustawione krańcówki silnika pozostają końcowym zabezpieczeniem mechanicznym ruchu.
Dlaczego api.reboot_timeout nadal pozostaje 0s
W L11 pozostawiliśmy api.reboot_timeout: 0s. Nie zmieniamy tego ustawienia. Brak połączenia z API Home Assistant nie powinien być traktowany jako powód do restartowania centralnego sterownika rolet. Lokalna logika ma być dostępna także podczas awarii HA.
Nie skalujemy jeszcze kodu na R02-R08
R01 ma przejść kilka cykli testowych. Otwórz ją, zatrzymaj w połowie, zamknij, zmień kierunek przez sekwencję STOP, wykonaj restart boneIO i test bez HA. Dopiero gdy zachowanie jest naturalne i nie pojawia się przypadkowy ruch, uznajemy profil za wzorzec dla pozostałych wejść.
Pełna wersja zawiera
- Klik GÓRA, klik STOP, klik DÓŁ
- Logika lokalna w ESPHome
- Sterowanie ścienne działa przy wyłączonym HA
- Co zmieniamy względem L12
- Nie zmieniamy żadnego przewodu
- Najpierw robimy kopię działającego YAML
- Co robi oficjalny przykład boneIO
- Usuwamy on_release z IN01 i IN02
- IN01: jedno naciśnięcie GÓRA ma uruchomić albo zatrzymać
- IN02: dokładnie ten sam wzorzec dla DÓŁ
- Co się stanie przy naciśnięciu przeciwnego kierunku podczas ruchu
- Dlaczego nie korzystamy tutaj z Home Assistant
- Walidacja przed instalacją
- Instalujemy po Ethernet i obserwujemy logi
- Test 1: klik GÓRA z pozycji zamkniętej
- Test 2: GÓRA podczas otwierania oznacza STOP
Jak pracujemy w pełnej wersji
Nie przeskakujemy od teorii prosto do gotowego efektu. Zaczynamy od Klik GÓRA, klik STOP, klik DÓŁ, następnie porządkujemy Logika lokalna w ESPHome i dopiero później przechodzimy do Sterowanie ścienne działa przy wyłączonym HA. W praktycznym systemie rolet kolejność ma znaczenie: błąd z początku konfiguracji może wyglądać jak problem Home Assistant dopiero kilka etapów później. Dlatego materiał pokazuje nie tylko co ustawić, ale również po czym rozpoznać poprawny rezultat i kiedy zatrzymać się przed następnym krokiem.
Pełna lekcja łączy wykonanie z diagnostyką. Po drodze wracamy do takich punktów jak Co zmieniamy względem L12 oraz Nie zmieniamy żadnego przewodu. Nie zakładamy, że identyczne ustawienie będzie poprawne w każdym domu. Tam, gdzie wynik zależy od napędu, instalacji, kierunku elewacji, czasu ruchu lub zachowania domowników, dostajesz procedurę pomiaru i strojenia zamiast jednej „magicznej” liczby do skopiowania.
Na końcu etap musi dać się zweryfikować. Jeśli wynik jest inny niż opisany, pełna wersja prowadzi przez sprawdzenie przyczyny przed dołożeniem kolejnej warstwy. Dzięki temu następne lekcje opierają się na sprawdzonym fundamencie, a nie na przypadkowo działającej konfiguracji, która psuje się przy pierwszym restarcie, zmianie pogody albo użyciu fizycznego przycisku.
Co jeszcze sprawdzamy w praktyce
Lokalny przycisk jest tu traktowany jako funkcja podstawowa, a nie gadżet obok dashboardu. W pełnej konfiguracji analizujemy stan bieżącego ruchu Cover 01 i na tej podstawie decydujemy, czy klik ma rozpocząć ruch, czy go zatrzymać. Dzięki temu domownik dostaje zachowanie znane z klasycznego sterownika roletowego, a logika działa na kontrolerze nawet wtedy, gdy serwer Home Assistant jest aktualizowany lub całkowicie wyłączony. To także ważny test architektury: zanim zaczniemy tworzyć automatyzacje pogodowe, zwykłe GÓRA, DÓŁ i STOP muszą być przewidywalne bez żadnej usługi wyższego poziomu.
Efekt po zakończeniu lekcji
R01 działa z dwuklawiszowego przycisku monostabilnego w sposób typowy dla domowej rolety: klik GÓRA uruchamia otwieranie, klik w czasie ruchu zatrzymuje, klik DÓŁ uruchamia zamykanie. Logika nie przechodzi przez Home Assistant. Użytkownik zachowuje lokalny Plan B nawet przy awarii serwera, integracji albo połączenia API.
Chcesz zbudować ten etap razem z kursem?
Ta lekcja jest częścią kursu Smart Home od Zera na platformie MarkLabs E-Learning. Pełna wersja prowadzi przez konfigurację, testy, diagnostykę i przypadki awaryjne bez zostawiania Cię z poleceniem „skonfiguruj to sam”.
Kup dostęp do kursu: 39 zł
Dożywotni dostęp | Wszystkie lekcje | Bez subskrypcji
Zobacz pełny kurs na marklabs.pl/e-learning/