Shelly R01 w Home Assistant: integracja, encja cover, pozycja i test dwukierunkowej synchronizacji

Home Assistant pojawia się dopiero po zakończeniu lokalnego commissioning R01. Dzięki temu integracja nie maskuje błędów elektrycznych. Sprawdzasz obie strony komunikacji: komendy HA do rolety oraz ruch lokalny wracający jako aktualny stan do HA.

Home Assistant nie steruje bezpośrednio przekaźnikami O1 i O2. Integracja widzi urządzenie Shelly 2PM Gen3 pracujące w profilu Cover. To Shelly nadal odpowiada lokalnie za kierunki, interlock, krańcówki, kalibrację i obliczanie pozycji. Home Assistant wysyła komendę wyższego poziomu, na przykład OPEN albo ustaw 50%. To rozdzielenie odpowiedzialności jest celowe. Jeżeli HA zostanie zrestartowany, Shelly nadal wie, jak obsłużyć fizyczny przycisk. Jeżeli integracja nie działa, nie próbujemy omijać jej bezpośrednim sterowaniem O1/O2 z automatyzacji.

Do standardowego Shelly 2PM Gen3 nie wpisujemy adresu serwera MQTT, tokena chmurowego ani adresu WebSocket HA. Home Assistant komunikuje się z urządzeniem bezpośrednio w LAN.

W urządzeniu używamy nazwy czytelnej dla człowieka, ale identyfikator techniczny zachowujemy w dokumentacji. Proponowany standard dla R01: Nie wpisujemy elewacji do entity_id, ponieważ roleta jest jednoznacznie przypisana do miejsca. Informacja „Zachód” pozostaje w karcie R01 i późniejszej tabeli automatyki. Jeśli w Twoim domu masz kilka podobnych rolet w jednym pomieszczeniu, możesz rozszerzyć nazwę o lokalizację, na przykład lewa, prawa albo taras.

Jeżeli roleta fizycznie otwiera się, ale HA pokazuje closing, nie poprawiamy tego automatyzacją. Wracamy do mapowania kierunków w Shelly.

Teraz nie dotykamy dashboardu. Stań przy fizycznym przycisku R01 i obserwuj jednocześnie encję w Home Assistant.

Dla urządzeń Shelly Gen2+ integracja ma również encje diagnostyczne, część z nich domyślnie wyłączoną. Aktualna dokumentacja HA wymienia między innymi temperaturę urządzenia, RSSI i uptime jako sensory odpytywane co 60 sekund, jeśli są włączone. Do zwykłego dashboardu rolet nie potrzebujemy ich wszystkich. Na czas commissioning warto jednak rozważyć włączenie:

Restart HA nie może wpływać na podstawowe sterowanie. Jeśli możesz bezpiecznie zrestartować serwer, wykonaj test:

• Oficjalna integracja Shelly
• OPEN, CLOSE, STOP i pozycja z HA
• Ruch lokalny aktualizuje stan Home Assistant
• Co dokładnie integrujemy
• Warunki przed dodaniem integracji
• Najpierw sprawdź, czy HA sam wykrył R01
• Dodanie ręczne, jeśli autodiscovery nie pojawiło się
• Sprawdzamy urządzenie zanim zmienimy entity_id
• Ustalamy finalne nazewnictwo R01
• Co Home Assistant rozumie przez 0% i 100%
• Test OPEN z Home Assistant
• Test CLOSE
• Test STOP
• Test pozycji 25%, 50% i 75% z Home Assistant
• Najważniejszy test: przycisk ścienny ma aktualizować Home Assistant
• Co oznaczają unknown i unavailable

Nie przeskakujemy od teorii prosto do gotowego efektu. Zaczynamy od Oficjalna integracja Shelly, następnie porządkujemy OPEN, CLOSE, STOP i pozycja z HA i dopiero później przechodzimy do Ruch lokalny aktualizuje stan Home Assistant. 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 dokładnie integrujemy oraz Warunki przed dodaniem integracji. 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.

Najważniejszym testem tej integracji nie jest sam przycisk OPEN w dashboardzie. Chcemy udowodnić, że Home Assistant i fizyczna roleta opisują ten sam stan w obie strony. Dlatego po testach z HA wracamy do przycisku na ścianie, zatrzymujemy ruch w połowie i sprawdzamy, czy encja cover reaguje zgodnie z rzeczywistością. Osobno testujemy restart Home Assistant oraz chwilową utratę Wi-Fi. Jeśli lokalny przycisk przestaje działać bez serwera, projekt jest źle ułożony, nawet jeśli dashboard wygląda poprawnie.

Home Assistant ma jedno poprawnie nazwane urządzenie R01 i jedną główną encję typu cover. Testujemy OPEN, CLOSE, STOP i 25/50/75%. Potwierdzamy też najważniejszą cechę całego systemu: kiedy użytkownik naciska fizyczny przycisk, HA aktualizuje stan; kiedy HA jest wyłączony, przycisk nadal steruje roletą.

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”.