LAB · Moduł 25
Home Assistant LAB - Dom w praktyce - Garaż i brama - sterowanie, bezpieczeństwo i automatyzacja
Moduł 25: 13 lekcji. Redakcja: 23.09.2026.
Inteligentny garaż i brama w Home Assistant
Kompletny praktyczny LAB, w którym krok po kroku budujemy system sterowania bramą garażową. Zaczynamy od centrali napędu i właściwego wejścia sterującego, później przechodzimy przez Shelly i ESPHome, czujniki położenia, powiadomienia, RFID i NFC, a na końcu rozbudowujemy ten sam sterownik o światło, wykrywanie obecności, Parking Assistant, rozpoznawanie samochodu i temperaturę garażu.
Otwieranie bramy z telefonu wydaje się prostym projektem. W podstawowej wersji rzeczywiście można podłączyć przekaźnik do wejścia sterującego napędu i dodać przycisk do Home Assistant. Taki układ szybko jednak pokazuje swoje ograniczenia.
System powinien wiedzieć, czy brama jest rzeczywiście zamknięta. Powinien poprawnie zachować się po restarcie ESP32 i Home Assistant. Musi również uwzględniać sytuację, w której ktoś użyje fabrycznego pilota, zatrzyma bramę w połowie albo jeden z czujników przestanie odpowiadać.
Dlatego w tym module nie ograniczamy się do prostego sterowania przekaźnikiem. Budujemy kompletny system garażowy, który ma zachowywać się przewidywalnie również podczas awarii, restartów i nietypowych sytuacji.
Podstawową zasadą projektu jest to, że Home Assistant jest dodatkowym sposobem obsługi bramy, ale nie zastępuje fabrycznego sterowania. Pilot, przycisk ścienny, fotokomórki i zabezpieczenia producenta pozostają niezależne.
Zaczynamy od napędu, a nie od Home Assistant
Pierwszym krokiem jest zrozumienie centrali bramy. Wyjaśniamy pojęcia dry contact, NO, NC, COMMON, START, Step-by-Step, OPEN, CLOSE, STOP i BUS. Pokazujemy również, jak czytać instrukcję instalatora i jak znaleźć właściwe wejście sterujące dla konkretnego modelu napędu.
Nie zakładamy, że wszystkie centrale wyglądają tak samo. Nie przyjmujemy też, że COMMON zawsze oznacza GND albo że dwa sąsiednie zaciski można bezpiecznie zewrzeć. Każde połączenie wynika z dokumentacji konkretnego napędu.
Dzięki temu wiedza z pierwszych lekcji przydaje się również wtedy, gdy masz Nice, Hörmann, FAAC, CAME, BFT, WIŚNIOWSKI albo inny napęd.
Dwie ścieżki wykonania
Nie każdy chce budować własny sterownik na ESP32. Dlatego podstawowa część modułu prowadzi dwiema ścieżkami.
Shelly
W tej wersji wykorzystujemy gotowy moduł z wyjściem dry contact. Dodajemy fizyczny czujnik zamknięcia i integrujemy całość z Home Assistant.
- konkretny model Shelly,
- dokładne połączenie z centralą,
- czujnik SATEL B-4S,
- potwierdzenie CLOSED,
- stan NOT CLOSED,
- encja cover,
- diagnostyka urządzenia.
ESPHome
Budujemy własny sterownik oparty na ESP32. Dostaje osobny przekaźnik, dwie krańcówki i fizyczny przycisk lokalny.
- ESP32-DevKitC V4,
- DFRobot DFR0473,
- 2 × SATEL B-4S,
- Schneider XB5AA31,
- state machine bramy,
- watchdog ruchu,
- pełna diagnostyka.
Nie zgadujemy stanu bramy
W tym miejscu zatrzymuję się na chwilę, bo od wiarygodnego odczytu zależą wszystkie późniejsze powiadomienia. Przy napędzie korzystającym z jednego wejścia Step-by-Step bardzo łatwo zbudować układ, który wie tylko, jakie polecenie wysłał, ale nie wie, co naprawdę zrobiła brama.
Jeśli ktoś użyje pilota, zatrzyma bramę w połowie albo napęd zadziała inaczej niż oczekiwaliśmy, historia wysłanych komend przestaje być wiarygodnym źródłem stanu.
W ścieżce ESPHome budujemy więc maszynę stanów, która rozróżnia: CLOSED, OPENING, OPEN, CLOSING, PARTIALLY_OPEN, UNKNOWN oraz ERROR.
Dwie nieaktywne krańcówki nie oznaczają automatycznie ruchu. Mogą również oznaczać bramę zatrzymaną w połowie. Dwie aktywne krańcówki są traktowane jako sprzeczność. Przekroczenie normalnego czasu przejazdu powoduje błąd diagnostyczny.
W całym module stosujemy prostą zasadę: brak informacji nie jest potwierdzeniem bezpiecznego stanu. UNKNOWN i unavailable nie są traktowane jak CLOSED.
Powiadomienia i nadzór w Home Assistant
Po zbudowaniu warstwy fizycznej obie ścieżki spotykają się w Home Assistant. Tworzymy wspólną logikę, która odpowiada przede wszystkim na pytanie: czy mamy potwierdzenie, że brama jest zamknięta.
Brama niezamknięta przez określony czas
Ustawiamy własny próg czasu. System może przypomnieć po kilku lub kilkunastu minutach, a później ponawiać alert, jeśli brama nadal nie ma potwierdzenia CLOSED.
Tryb Noc
Jeśli dom przechodzi w tryb Noc, a brama nie jest potwierdzona jako zamknięta, użytkownik dostaje ostrzeżenie.
Tryb Wyjazd
Przed opuszczeniem domu brak CLOSED jest traktowany jako sytuacja wymagająca uwagi. System informuje, ale nie zamyka bramy bezwarunkowo.
Problemy techniczne
unavailable, błąd state machine, sprzeczne sensory i brak komunikacji są widoczne jako osobne problemy diagnostyczne.
Restart nie może poruszyć bramy
W module testujemy również scenariusze, które często są pomijane w prostych poradnikach.
- restart Home Assistant przy zamkniętej bramie,
- restart HA przy otwartej bramie,
- restart ESP32 podczas ruchu,
- utrata Wi-Fi,
- brak Home Assistant,
- odłączenie sensora,
- sprzeczne wskazania krańcówek,
- zatrzymanie bramy pilotem,
- przekroczenie normalnego czasu przejazdu.
Po restarcie sterownik odczytuje stan fizycznych wejść. Nie wykonuje impulsu tylko po to, aby ustalić pozycję.
RFID i NFC
Do garażu dokładamy również wygodny sposób dostępu. Osobny ESP32 z RC522 odczytuje kartę i przekazuje jej identyfikator do Home Assistant.
Czytnik nie jest bezpośrednio podłączony do wejścia centrali bramy. Home Assistant sprawdza allowlistę, cooldown, tryb serwisowy i aktualny stan bramy.
Dozwolona karta może otworzyć bramę wyłącznie z potwierdzonego CLOSED. Przy stanie OPEN, ruchu, unavailable albo błędzie nie wysyłamy kolejnej komendy.
Osobno pokazujemy obsługę tagów NFC z telefonu przez Home Assistant Companion. RFID i NFC korzystają z podobnej logiki po stronie Home Assistant, ale pozostają dwoma różnymi sposobami odczytu.
UID karty RFID traktujemy jako wygodny identyfikator. Nie przedstawiamy RC522 jako profesjonalnego systemu kontroli dostępu odpornego na klonowanie.
Dashboard do codziennego używania
Po zakończeniu części sprzętowej budujemy osobny dashboard garażu. Korzystamy z układu Sections oraz kart Bubble Card i Mushroom.
Najważniejsze informacje są widoczne od razu:
- stan bramy,
- potwierdzenie CLOSED,
- stan sterownika,
- problem diagnostyczny,
- tryb domu,
- tryb serwisowy,
- świadome pozostawienie bramy otwartej.
Bardziej techniczne informacje trafiają do osobnego popupu diagnostycznego. Nie pokazujemy na głównym ekranie surowego przekaźnika, GPIO ani funkcji, których przypadkowe użycie może zaburzyć normalną pracę bramy.
Po części podstawowej rozbudowujemy ten sam ESP32
Kolejne trzy lekcje nie tworzą nowych sterowników. Rozbudowujemy ten sam główny ESP32 obsługujący bramę. Dzięki temu cały garaż pozostaje jednym spójnym systemem.
Inteligentne światło
Radar HLK-LD2410C wykrywa ruch i obecność osoby stojącej niemal nieruchomo. Światło reaguje lokalnie i działa również bez Home Assistant.
Parking Assistant
VL53L0X mierzy odległość samochodu od końcowego punktu parkowania, a WS2812 pokazuje kierowcy kolejne strefy zbliżania.
Obecność samochodu
Osobny A02YYUW obserwuje stanowisko i rozróżnia OBECNE, BRAK oraz NIEZNANE.
Temperatura garażu
DS18B20 na magistrali 1-Wire monitoruje temperaturę i pozwala wykryć zarówno mróz, jak i utratę samego czujnika.
Światło reagujące na obecność
W garażu zwykły PIR nie zawsze wystarcza. Jeśli przez chwilę stoisz przy samochodzie, pracujesz przy stole albo schylasz się przy kole, klasyczny czujnik ruchu może przestać widzieć aktywność.
Dlatego wykorzystujemy HLK-LD2410C. Radar potrafi raportować zarówno cel poruszający się, jak i nieruchomy. Dzięki temu łatwiej utrzymać światło podczas spokojnej pracy. Radar nie daje jednak pewności obecności w każdym miejscu: sprawdzam martwe strefy, odbicia i reakcję przez przegrody, a fizyczny wybór ON pozostawiam dostępny.
Automatyka światła działa lokalnie w ESPHome. Dodatkowo stosujemy fizyczne sterowanie OFF, AUTO i ON, więc podstawowa obsługa światła nie zależy od działania Home Assistant.
Parking Assistant
Do precyzyjnego parkowania używamy VL53L0X. Najpierw kalibrujemy rzeczywisty punkt zatrzymania dla konkretnego samochodu i garażu.
Następnie dzielimy odległość na kilka stref: DALEKO, ZBLIŻAJ, WOLNO, DOBRZE i ZA BLISKO.
Wynik jest pokazywany lokalnie na WS2812. Kierowca nie musi otwierać Home Assistant ani patrzeć na telefon.
Przed pierwszym testem samochodem sprawdzamy wszystkie strefy na nieruchomej planszy. Dopiero później wykonujemy bardzo wolne próby prawdziwym autem.
Obecność samochodu
Parking Assistant i wykrywanie obecności samochodu to dwa różne zadania. Dlatego nie próbujemy wyciągać obu informacji z jednego sensora.
A02YYUW obserwuje stanowisko poprzecznie. Przy pustym garażu mierzy odległość do przeciwległej ściany. Po zaparkowaniu samochód przecina tę przestrzeń i odczyt staje się wyraźnie krótszy.
System nie ogranicza się jednak do prostego ON/OFF. Rozróżniamy: OBECNE, BRAK i NIEZNANE.
Krótszy dystans potwierdza przeszkodę w wiązce, a nie tożsamość samochodu. Rower lub człowiek też zmieni odczyt. Dlatego kalibruję progi dla stanowiska, sprawdzam te sytuacje i nie używam samego wyniku do zezwolenia na ruch bramy.
Temperatura garażu z DS18B20
Ostatnim elementem rozbudowy jest DS18B20 podłączony do tego samego ESP32. Korzystamy z magistrali 1-Wire i przypisujemy sensor po jego unikalnym adresie.
Dodajemy filtrację, timeout, kontrolę wiarygodności pomiaru i konfigurowalny próg niskiej temperatury.
Home Assistant może poinformować o spadku temperatury albo o sytuacji, w której jednocześnie jest zimno i brama nie ma potwierdzenia CLOSED.
Zebrana temperatura może później służyć także do porównania z rzeczywistym czasem otwierania i zamykania bramy.
13 lekcji krok po kroku
Centrala napędu i właściwe wejście sterujące
Dry contact, NO, NC, COMMON, START, SbS, OPEN, CLOSE, STOP, BUS i praca z instrukcją instalatora.
Wybór rozwiązania
Shelly, BleBox, SONOFF i ESPHome. Porównanie oraz konkretny BOM.
Shelly i napęd bramy
Podłączenie dry contact, zasilanie i pierwsze testy.
Stan bramy dla gotowego sterownika
Czujnik zamknięcia, CLOSED, NOT CLOSED i integracja z Home Assistant.
ESPHome: hardware
ESP32, DFR0473, dwie krańcówki, rezystory i przygotowanie instalacji.
ESPHome: lokalne sterowanie
Przycisk fizyczny, impuls SbS i pomiar czasu przejazdu.
State machine bramy
OPENING, CLOSING, CLOSED, OPEN, PARTIALLY_OPEN, UNKNOWN i ERROR.
Home Assistant i alerty
Brama niezamknięta przez X minut, Noc, Wyjazd, unavailable i restart.
RFID i NFC
RC522, allowlista, cooldown, tryb serwisowy i tagi telefonu.
Dashboard i commissioning
Finalny panel, diagnostyka i pełna próba odbiorowa.
Inteligentne światło
LD2410C, obecność człowieka i lokalna automatyka światła.
Parking Assistant i obecność samochodu
VL53L0X, A02YYUW, WS2812 i kalibracja stanowiska.
DS18B20 i temperatura garażu
1-Wire, diagnostyka, próg niskiej temperatury i finalna rozbudowa dashboardu.
Sprzęt używany w projekcie
W module pracujemy na konkretnych modelach, żeby użytkownik wiedział, czego szukać i jak wygląda element używany w przykładzie.
- Shelly 1 Gen3,
- ESP32-DevKitC V4,
- DFRobot DFR0473,
- SATEL B-4S,
- Schneider XB5AA31,
- Mean Well HDR-15-5,
- Mean Well HDR-15-24,
- ABB EN20-20N-01,
- HLK-LD2410C,
- RC522,
- VL53L0X,
- DFRobot A02YYUW,
- WS2812 i 74AHCT125,
- DS18B20.
Warstwa smart nie zastępuje zabezpieczeń napędu. Fotokomórki, listwy bezpieczeństwa, STOP, ograniczenie siły i pozostałe zabezpieczenia producenta pozostają aktywne. Nie mostkujemy wejść BUS, BlueBUS, PHOTO ani innych obwodów bezpieczeństwa. Prace przy instalacji 230 V wykonuje osoba posiadająca odpowiednie kwalifikacje.
Co powstaje na końcu
Po wykonaniu wybranej ścieżki i zaliczeniu jej prób odbiorowych masz podstawę systemu inteligentnego garażu. Nie trzeba wdrażać wszystkich rozszerzeń, żeby korzystać z niego na co dzień. Brama zachowuje fabryczne sterowanie, a Home Assistant staje się dodatkową warstwą nadzoru i wygody.
Sprawdzamy potwierdzenie położenia bramy, rozpoznawanie stanu niejednoznacznego, brak przypadkowego impulsu po restarcie i sygnalizowanie utraty komunikacji. Czujnik zamknięcia potwierdza tylko pozycję zamkniętą; dwie krańcówki nadal nie mierzą każdego położenia pośredniego.
Home Assistant informuje o niezamkniętej bramie, trybie Noc i Wyjazd. RFID oraz NFC mogą służyć do wejścia. Światło reaguje na obecność człowieka. Parking Assistant pomaga zatrzymać auto w powtarzalnym miejscu. Osobny sensor rozpoznaje obecność samochodu. DS18B20 monitoruje temperaturę garażu.
Całość powstaje warstwami. Najpierw sprzęt, później fizyczny stan, następnie logika i diagnostyka. Dopiero na końcu dochodzą automatyzacje komfortowe i dashboard.
Dla kogo jest ten LAB
Dla osoby, która zna podstawy Home Assistant i chce zbudować kompletny projekt, zamiast poznawać kolejne funkcje w oderwaniu od praktycznego zastosowania.
Nie musisz być programistą. Do samodzielnego montażu niskonapięciowych układów potrzebujesz jednak podstaw bezpiecznych połączeń i sprawdzania napięć; pracę w napędzie oraz przy zasilaniu sieciowym powierzam osobie z odpowiednimi kwalifikacjami. Każdy etap jest opisany krok po kroku, a przed przejściem dalej sprawdzamy, czy poprzednia część rzeczywiście działa.
Możesz wybrać prostszą ścieżkę z gotowym sterownikiem albo zbudować pełną wersję ESPHome. W obu przypadkach celem jest działający i zrozumiały system, a nie sam kod YAML.