Panel Alarmowy
Panel alarmowy to strefowy system alarmowy z maszyną stanów. Monitoruje strefy wejściowe, zarządza stanami uzbrajania/rozbrajania z timerami i steruje urządzeniami wyjściowymi (syrena, powiadomienie, światło) przy wyzwoleniu.
Encja jest eksponowana do Home Assistant jako alarm_control_panel z obsługą kodów PIN.
Koncepcje
Strefy (zones)
Strefa grupuje wejścia sterownika i definiuje w jakich trybach uzbrojenia jest aktywna. Każda strefa może opcjonalnie używać opóźnienia wejścia (entry delay) — daje to czas na rozbrojenie alarmu przed wyzwoleniem.
Każde wejście w strefie może być skonfigurowane jako:
- NC (Normally Closed) — normalnie zamknięte — wyzwolenie następuje po rozwarciu obwodu
- NO (Normally Open) — normalnie otwarte — wyzwolenie następuje po zwarciu obwodu
Tryby uzbrojenia
Panel obsługuje 3 tryby uzbrojenia:
- armed_away — Pełne uzbrojenie, wszystkie skonfigurowane strefy aktywne
- armed_home — Uzbrojenie domowe, aktywne tylko strefy przypisane do tego trybu
- armed_night — Uzbrojenie nocne, aktywne tylko strefy przypisane do tego trybu
Blokada uzbrojenia
Panel automatycznie blokuje możliwość uzbrojenia jeśli którekolwiek z wejść w aktywnych strefach jest w stanie wyzwolonym. Zapobiega to uzbrojeniu alarmu w sytuacji gdy np. drzwi lub okno jest otwarte.
Timery
| Timer | Domyślnie | Opis |
|---|---|---|
| Czas uzbrajania | 30s | Czas oczekiwania po komendzie uzbrojenia zanim alarm przejdzie w stan uzbrojony. |
| Opóźnienie wejścia | 30s | Czas po wyzwoleniu strefy z opóźnieniem zanim alarm przejdzie w stan wyzwolony. |
| Czas wyzwolenia | 5min | Czas przez jaki alarm pozostaje wyzwolony zanim automatycznie się rozbroi. |
Wyjścia alarmowe
Wyjścia aktywowane przy wyzwoleniu alarmu. Każde wyjście ma przypisany typ:
| Typ | Opis |
|---|---|
siren | Syrena alarmowa |
notification | Powiadomienie |
light | Oświetlenie (np. migające światło) |
custom | Niestandardowe wyjście |
Kody PIN
Lista kodów PIN z przypisanymi nazwami użytkowników. Kody są używane do uzbrajania/rozbrajania alarmu. Nazwa użytkownika jest zapisywana w logach — umożliwia identyfikację osoby która rozbroiła alarm. Opcjonalnie kod może być wymagany również do uzbrojenia (opcja code_arm_required).
Ustawienia Panelu Alarmowego — Podstawowe
| Nazwa opcji | Opis |
|---|---|
| ID | Unikalny identyfikator panelu alarmowego. |
| Nazwa | Nazwa wyświetlana w Home Assistant. |
| Obszar/Pokój | Wybór odpowiedniego obszaru. |
| Strefy | Lista stref z przypisanymi wejściami i trybami uzbrojenia. |
| Wyjścia | Lista wyjść aktywowanych przy wyzwoleniu alarmu. |
Ustawienia Panelu Alarmowego — Zaawansowane
| Nazwa opcji | Opis |
|---|---|
| Czas uzbrajania | Czas oczekiwania po komendzie uzbrojenia. Przykład: 30s. |
| Opóźnienie wejścia | Czas opóźnienia wejścia przed wyzwoleniem. Przykład: 30s. |
| Czas wyzwolenia | Czas przez jaki alarm pozostaje wyzwolony. Przykład: 5min. |
| Kody PIN | Lista kodów PIN z nazwami użytkowników. |
| Kod wymagany do uzbrojenia | Czy kod PIN jest wymagany również do uzbrojenia alarmu. |
Przykładowa konfiguracja YAML — Panel Alarmowy
template:
- id: alarm_dom
name: Alarm Domowy
platform: alarm_control_panel
arming_time: 30s
delay_time: 30s
trigger_time: 5min
code_arm_required: false
codes:
- name: Jan
code: "1234"
- name: Anna
code: "5678"
zones:
- name: Strefa Wejściowa
inputs:
- id: IN_01
type: normally_closed
- id: IN_02
type: normally_closed
arm_modes:
- armed_away
- armed_home
- armed_night
entry_delay: true
- name: Strefa Okien
inputs:
- id: IN_03
type: normally_closed
- id: IN_04
type: normally_open
arm_modes:
- armed_away
- armed_night
entry_delay: false
outputs:
- id: OUT_05
type: siren
- id: OUT_06
type: light
area: domZmienne konfiguracyjne — Panel Alarmowy
- id (Opcjonalne, string) — Unikalny identyfikator panelu alarmowego. Generowany automatycznie jeśli nie podany.
- name (Opcjonalne, string) — Nazwa wyświetlana w Home Assistant. Jeśli nie ustawiona, używa ID.
- platform (Wymagane, string) — Musi być ustawione na
alarm_control_panel. - codes (Opcjonalne, lista) — Lista kodów PIN z nazwami użytkowników.
- name (Wymagane, string) — Nazwa użytkownika (używana w logach do identyfikacji osoby).
- code (Wymagane, string) — Numeryczny kod PIN.
- code_arm_required (Opcjonalne, boolean, domyślnie:
false) — Czy kod PIN jest wymagany również do uzbrojenia alarmu. - arming_time (Opcjonalne, timeperiod) — Czas oczekiwania po komendzie uzbrojenia zanim alarm przejdzie w stan uzbrojony. Przykład:
30s. - delay_time (Opcjonalne, timeperiod) — Czas opóźnienia wejścia przed wyzwoleniem alarmu. Przykład:
30s. - trigger_time (Opcjonalne, timeperiod) — Czas przez jaki alarm pozostaje wyzwolony zanim automatycznie się rozbroi. Przykład:
5min. - zones (Opcjonalne, lista) — Lista stref alarmowych.
- name (Wymagane, string) — Nazwa strefy.
- inputs (Opcjonalne, lista) — Lista wejść przypisanych do strefy.
- id (Wymagane, string) — ID wejścia sterownika.
- type (Opcjonalne, string, dozwolone:
['normally_closed', 'normally_open'], domyślnie:normally_closed) — Typ obwodu wejścia (NC/NO).
- arm_modes (Opcjonalne, lista string, dozwolone:
['armed_away', 'armed_home', 'armed_night']) — Tryby uzbrojenia w których strefa jest aktywna. - entry_delay (Opcjonalne, boolean, domyślnie:
false) — Czy strefa używa opóźnienia wejścia przed wyzwoleniem.
- outputs (Opcjonalne, lista) — Lista wyjść aktywowanych przy wyzwoleniu alarmu.
- id (Wymagane, string) — ID wyjścia (przekaźnika).
- type (Opcjonalne, string, dozwolone:
['siren', 'notification', 'light', 'custom'], domyślnie:siren) — Typ wyjścia alarmowego.
- area (Opcjonalne, string) — Odniesienie do ID obszaru zdefiniowanego w sekcji
areas. Tworzy pod-urządzenie powiązane z głównym urządzeniem BoneIO.