Integracja systemu alarmowego DSC z Home Assistant przez moduł ESP to tani, elastyczny i niezależny sposób na pełną kontrolę nad bezpieczeństwem domu. Centrala DSC serii POWER jest sprawdzona i niezawodna, a połączenie jej z Home Assistant za pomocą ESP otwiera szerokie możliwości automatyzacji i monitoringu. Co istotne, całość zbudujesz za ułamek ceny dedykowanych modułów (np. ETHM‑1 od SATEL‑a). W tym poradniku pokazujemy krok po kroku, jak to zrobić.
- Czemu warto zintegrować alarm DSC z Home Assistant?
- Wymagane komponenty
- Koszty – porównanie rozwiązań
- Krok 1 – przygotowanie środowiska
- Krok 2 – schemat elektryczny i montaż
- Najważniejsza część – jak podłączyć ESP do magistrali KEYBUS
- Schemat połączeń
- Szczegóły rezystorów i tranzystora
- Krok 3 – konfiguracja pliku YAML
- Krok 4 – kompilacja i wgranie oprogramowania
- Krok 5 – podłączenie fizyczne
- Krok 6 – konfiguracja panelu alarmowego w Home Assistant
- Funkcjonalność panelu
- Zaawansowane scenariusze
- Rozwiązywanie problemów
- Porównanie – DSC + ESP vs alternatywy
- Wskazówki i triki
- Bezpieczeństwo
Czemu warto zintegrować alarm DSC z Home Assistant?
Poniżej najważniejsze korzyści integracji:
- pełna kontrola alarmu – zbrojenie, rozbrojenie i podgląd stanu bezpośrednio w Home Assistant;
- automatyzacja – zaawansowane scenariusze, np. zbrojenie o określonej godzinie lub po wyjściu domowników;
- niski koszt – rozwiązanie kosztuje kilkadziesiąt zamiast kilkuset złotych;
- niezależność – brak wymogu korzystania z chmury producenta;
- elastyczność – możliwość dopasowania konfiguracji do własnych potrzeb.
Wymagane komponenty
Aby zbudować system, przygotuj poniższe elementy elektroniczne:
- mikrokontroler ESP – WeMos D1 Mini, ESP8266 lub ESP32 (koszt: 20–40 PLN);
- rezystory – łącznie 5 sztuk (wartości podane w sekcji montażu);
- tranzystor NPN – np. 2N2222 lub odpowiednik;
- przetwornica DC/DC – 12 V na 3,3 V (ok. 10–20 PLN);
- przewody połączeniowe – do wykonania połączeń.
Do uruchomienia oprogramowania będą potrzebne następujące narzędzia i pliki:
- Home Assistant – zainstalowany i uruchomiony;
- ESPHome – dodatek do Home Assistant;
- pliki z repozytorium –
dscalarm.yamloraz folderdscKeybusInterface.
Koszty – porównanie rozwiązań
Poniższa tabela zestawia koszty naszego wariantu DIY z alternatywami:
| Rozwiązanie | Koszt |
|---|---|
| Moduł ESP + komponenty | ~60–100 PLN |
| ETHM‑1 (SATEL) | 800–1200 PLN |
| Centrala DSC + instalacja | Tysiące złotych |
Różnica jest wyraźna – wariant ESP bywa co najmniej 10 razy tańszy.
Krok 1 – przygotowanie środowiska
Instalacja ESPHome
Wykonaj instalację dodatku w Home Assistant:
- Otwórz Home Assistant.
- Przejdź do Ustawienia > Dodatki.
- Wyszukaj ESPHome i zainstaluj dodatek.
- Uruchom ESPHome.
Pobieranie plików
Przejdź do repozytorium GitHub Dilberta66 (esphome-dsckeybus) i pobierz plik dscalarm.yaml oraz folder dscKeybusInterface (wraz z podkatalogami).
Krok 2 – schemat elektryczny i montaż
Najważniejsza część – jak podłączyć ESP do magistrali KEYBUS
Magistrala KEYBUS ma cztery zaciski dostępne w centrali DSC lub na panelu. Oznaczenia i kolory to:
- R – RED (czerwony);
- B – BLACK (czarny);
- Y – YELLOW (żółty);
- G – GREEN (zielony).
Schemat połączeń
Podłącz ESP zgodnie z poniższym schematem:
Centrala DSC (KEYBUS)
├─ R (Red/+12V) ──→ przetwornica DC/DC ──→ ESP (3,3 V)
├─ B (Black/GND) ──→ GND ESP
├─ Y (Yellow) ──→ [dzielnik napięcia] ──→ GPIO ESP (np. GPIO4)
└─ G (Green) ──→ [rezystor + tranzystor] ──→ GPIO ESP (np. GPIO5)
Szczegóły rezystorów i tranzystora
Poniżej niezbędne elementy dla poziomów logicznych KEYBUS (ok. 12 V) i ESP (3,3 V):
- dzielnik napięcia dla linii Yellow (Y) – rezystor do masy: 10 kΩ, rezystor w kierunku GPIO: 10 kΩ, efekt: ok. 3,3 V na wejściu ESP;
- wyjście dla linii Green (G) – tranzystor NPN (2N2222 lub podobny), rezystor bazy: 1 kΩ, rezystor pull‑up do +12 V: 4,7 kΩ;
- rezystor ochronny – 470 Ω na wejściu sygnału.
Krok 3 – konfiguracja pliku YAML
Po skopiowaniu plików do folderu /config/esphome w Home Assistant otwórz dscalarm.yaml i uzupełnij parametry:
1. Kod dostępu do alarmu
Ustaw własny kod w sekcji substitutions:
substitutions:
dsc_code: "1234" # Wstaw swój 4‑cyfrowy kod dostępu
2. Konfiguracja Wi‑Fi
Skonfiguruj połączenie sieciowe (opcjonalnie z adresem statycznym):
wifi:
ssid: "Twoja-siec-WiFi"
password: "haslo-wifi"
# Opcjonalnie: statyczne IP
manual_ip:
static_ip: 192.168.1.100
gateway: 192.168.1.1
subnet: 255.255.255.0
3. Zmiana portów GPIO
Domyślnie używane są piny: GPIO4 – linia Yellow (Y), GPIO5 – linia Green (G). Jeśli korzystasz z innych pinów, zaktualizuj konfigurację:
dscKeybusInterface:
yellow_pin: GPIO4
green_pin: GPIO5
4. Konfiguracja stref alarmowych
Każda strefa (zone) odpowiada konkretnemu czujnikowi w systemie. Przykładowa konfiguracja:
binary_sensor:
- platform: dsc
zone_num: 1
name: "Wejście główne"
device_class: door
- platform: dsc
zone_num: 2
name: "Okno salon"
device_class: window
Dodaj lub edytuj strefy tak, aby odpowiadały Twojej instalacji alarmowej.
Krok 4 – kompilacja i wgranie oprogramowania
Kompilacja
Przygotuj firmware w ESPHome:
- Otwórz ESPHome w Home Assistant.
- Kliknij Nowy projekt lub Edytuj istniejący.
- Wklej zawartość dscalarm.yaml.
- Kliknij Kompiluj.
- Poczekaj na wygenerowanie pliku .bin.
Wgranie do ESP
Opcja 1: przez USB (pierwsze wgranie)
- Pobierz wygenerowany plik binarny.
- Otwórz ESPHome Web Flasher (web.esphome.io).
- Podłącz ESP przez USB do komputera.
- Wybierz port i wgraj firmware.
Opcja 2: OTA (over‑the‑air) – po pierwszym wgraniu przez USB kolejne aktualizacje możesz instalować zdalnie, wybierając projekt w ESPHome i wybierając polecenie instalacji OTA.
Krok 5 – podłączenie fizyczne
Po wgraniu oprogramowania wykonaj podstawowe czynności kontrolne i końcowe podłączenia:
- Sprawdź w ESPHome, czy moduł jest online.
- Podłącz przewody do magistrali KEYBUS w centrali lub na klawiaturze.
- Zrestartuj ESP (przycisk RESET lub z poziomu ESPHome).
Po poprawnym podłączeniu ESP działa jak dodatkowy, zdalny panel do obsługi alarmu.
Krok 6 – konfiguracja panelu alarmowego w Home Assistant
Dodanie do configuration.yaml
Dodaj platformę panelu alarmowego:
alarm_control_panel:
- platform: dsc
Używanie gotowego szablonu
Dodaj kartę panelu alarmowego na pulpicie:
- Przejdź do Ustawienia > Pulpity.
- Utwórz nowy pulpit lub edytuj istniejący.
- Dodaj kartę Panel alarmowy.
- Wybierz jednostkę alarmową z integracji DSC.
Funkcjonalność panelu
Panel w Home Assistant umożliwia:
- zbrojenie pełne – pełna ochrona wszystkich stref;
- zbrojenie nocne – ochrona obwodowa podczas snu;
- zbrojenie domowe – aktywacja wybranych stref (np. zewnętrznych);
- rozbrojenie – wymaga potwierdzenia kodem;
- monitorowanie stanu – podgląd aktualnego statusu i zdarzeń;
- widok stref – szybka identyfikacja wywołanego sensora.
Zbrojenie przez automatyzację
Przykład automatycznego zbrojenia i rozbrajania o ustalonych godzinach:
automation:
- alias: "Zbrojenie alarmu o 22:00"
trigger:
platform: time
at: "22:00:00"
action:
service: alarm_control_panel.alarm_arm_full
target:
entity_id: alarm_control_panel.dsc_alarm
- alias: "Rozbrojenie o 7:00"
trigger:
platform: time
at: "07:00:00"
action:
service: alarm_control_panel.alarm_disarm
target:
entity_id: alarm_control_panel.dsc_alarm
data:
code: "1234"
Zaawansowane scenariusze
1. Alerty SMS/push
Przykład powiadomienia o naruszeniu strefy:
automation:
- alias: "Alert przy naruszeniu strefy"
trigger:
platform: state
entity_id: binary_sensor.dsc_zone_1
to: "on"
action:
service: notify.mobile_app
data:
message: "ALARM! Wejście główne zostało otwarte!"
title: "Naruszenie bezpieczeństwa"
2. Integracja z kamerami
Włączenie nagrywania po wywołaniu alarmu:
automation:
- alias: "Włącz kamerę przy alarmie"
trigger:
platform: state
entity_id: alarm_control_panel.dsc_alarm
to: "triggered"
action:
service: switch.turn_on
target:
entity_id: switch.kamera_nagrywanie
3. Scena – wychodzę z domu
Przykładowa scena zmieniająca wiele elementów naraz:
scene:
- name: "Wychodzę"
entities:
light.wszystkie_lampy: "off"
lock.drzwi_frontowe: "locked"
alarm_control_panel.dsc_alarm:
state: "armed_away"
Rozwiązywanie problemów
Moduł ESP nie pojawia się online
Sprawdź poniższe kwestie:
- poprawność SSID i hasła Wi‑Fi w konfiguracji,
- logi ESPHome (otwórz projekt i wybierz Logi),
- przywrócenie ustawień fabrycznych modułu (jeśli konieczne).
Alarm nie reaguje na polecenia
Rozważ następujące kroki:
- zweryfikuj kod dostępu ustawiony w YAML,
- sprawdź przewody KEYBUS i jakość połączeń,
- potwierdź poprawne wartości i wpięcie rezystorów oraz tranzystora.
Strefy nie odpowiadają
Upewnij się, że numery stref w YAML pokrywają się z konfiguracją centrali oraz że przypisane piny GPIO nie kolidują z innymi peryferiami.
Słabe zasilanie
Jeśli ESP samoczynnie się restartuje, sprawdź stabilność przetwornicy DC/DC (czy dostarcza stałe 3,3 V) i rozważ dodanie kondensatora tantalowego 100 µF możliwie blisko pinów zasilania ESP.
Porównanie – DSC + ESP vs alternatywy
Envisalink
Wady –
- koszt: 400–600 PLN,
- wymagana dodatkowa subskrypcja,
- uzależnienie od chmury.
Zalety – łatwa instalacja; oficjalne wsparcie producenta.
Werdykt – droższe i mniej elastyczne niż ESP.
ETHM‑1 (SATEL)
Wady –
- koszt: 800–1200 PLN,
- pracochłonna konfiguracja,
- ograniczona elastyczność.
Zalety – dedykowany moduł; dobre wsparcie dla polskich systemów.
Werdykt – rozwiązanie „na wyrost” dla większości użytkowników.
Rozwiązanie ESP (nasze)
Zalety –
- koszt: 60–100 PLN,
- pełna elastyczność,
- niezależność od chmury,
- bezpośrednia integracja z Home Assistant.
Wady –
- wymaga podstawowej wiedzy technicznej,
- konieczna samodzielna instalacja elektroniki,
- brak oficjalnego wsparcia producenta.
Werdykt – najlepszy wybór dla majsterkowiczów i entuzjastów.
Wskazówki i triki
1. Backup konfiguracji
Zawsze wykonuj kopię zapasową pliku dscalarm.yaml przed zmianami:
# W terminalu Home Assistant
cp /config/esphome/dscalarm.yaml /config/backups/dscalarm_backup.yaml
2. Testowanie bez alarmu
Konfigurację YAML możesz przetestować bez fizycznego alarmu, dodając czujniki testowe:
binary_sensor:
- platform: template
name: "Test strefa 1"
lambda: 'return false;'
3. Logowanie i diagnostyka
Włącz rozszerzone logowanie w ESPHome, aby łatwiej diagnozować problemy:
logger:
level: DEBUG
4. Dostęp zdalny
Do zdalnego dostępu możesz użyć Nabu Casa (łatwa konfiguracja i oficjalne wsparcie) lub zestawu WireGuard + reverse proxy (rozwiązanie dla zaawansowanych użytkowników).
Bezpieczeństwo
Ważne zasady
Pamiętaj o kluczowych zasadach bezpieczeństwa:
- nigdy nie publikuj kodu dostępu do alarmu w publicznych repozytoriach,
- używaj zmiennych
!secretw Home Assistant, - włącz uwierzytelnianie w Home Assistant i mocne hasła,
- zmień domyślny kod dostępu alarmu na unikalny.
Plik secrets.yaml
Skonfiguruj plik secrets.yaml w katalogu konfiguracyjnym:
# /config/secrets.yaml
dsc_code: "1234"
dsc_wifi_pass: "moje-haslo-wifi"
Następnie użyj zmiennych w dscalarm.yaml:
substitutions:
dsc_code: !secret dsc_code