Карта и PIN: автоматизация доступа в Home Assistant

Bridge сообщает по MQTT о каждой карте и каждом результате PIN. Одна автоматизация проверяет карту, ждёт до 15 секунд правильный PIN, открывает замок и даёт считывателю зелёный или красный сигнал.

Карту можно потерять или передать. PIN можно подсмотреть через плечо. Вместе они дают второй фактор: дверь открывается только тому, у кого есть карта и кто знает код. Это руководство строит именно такую схему.

Что понадобится

• KLOKL Bridge с OSDP-считывателем с клавиатурой
• Home Assistant с MQTT-брокером, например дополнением Mosquitto
• замок или реле, которым может управлять Home Assistant

Используемые топики

Каждый топик начинается с ID устройства вашего bridge. Его можно найти в веб-интерфейсе bridge и в Home Assistant на странице устройства. В этом примере это osdp-reader-3f9a12.

• …/card_data: номер считанной карты
• …/pin_status: «Code akzeptiert» или «Code nicht akzeptiert» после нажатия #
• …/cmd/feedback_ok: зелёный светодиод и зуммер на считывателе
• …/cmd/feedback_denied: красный сигнал на считывателе

Шаг 1: задайте код

Bridge сам сравнивает PIN, поэтому при вводе код никогда не передаётся по сети. Задайте код один раз: в Home Assistant у bridge есть текстовое поле «Access Code» — введите код туда. Другой вариант — опубликовать его в …/cmd/access_code.

Шаг 2: автоматизация

Создайте новую автоматизацию, переключитесь в режим YAML и вставьте следующее. Замените ID устройства, номера карт и сущность замка на свои.

1alias: Входная дверь: карта и PIN
2mode: single
3triggers:
4  - trigger: mqtt
5    topic: osdp-reader-3f9a12/card_data
6conditions:
7  - condition: template
8    value_template: "{{ trigger.payload in ['0004958372', '0004958373'] }}"
9actions:
10  - wait_for_trigger:
11      - trigger: mqtt
12        topic: osdp-reader-3f9a12/pin_status
13        payload: "Code akzeptiert"
14    timeout: "00:00:15"
15    continue_on_timeout: true
16  - if:
17      - condition: template
18        value_template: "{{ wait.trigger is not none }}"
19    then:
20      - action: lock.unlock
21        target:
22          entity_id: lock.front_door
23      - action: mqtt.publish
24        data:
25          topic: osdp-reader-3f9a12/cmd/feedback_ok
26          payload: ""
27    else:
28      - action: mqtt.publish
29        data:
30          topic: osdp-reader-3f9a12/cmd/feedback_denied
31          payload: ""
Copy

Что происходит

1. Карту подносят к считывателю. Если её номера нет в списке, ничего не происходит.
2. Для известной карты автоматизация ждёт до 15 секунд «Code akzeptiert».
3. Правильный PIN вовремя: замок открывается, считыватель светится зелёным.
4. Неверный PIN или слишком поздно: считыватель светится красным, дверь остаётся закрытой.

Советы для повседневной работы

• Чтобы узнать номера карт, поднесите каждую карту к считывателю один раз и посмотрите датчик «Card Data» в Home Assistant.
• Храните список разрешённых карт в одном месте, например в шаблонном датчике или вспомогательном элементе, если им пользуются несколько автоматизаций.
• Для входа только по карте пропустите шаг ожидания и открывайте сразу.
• Добавьте уведомление на «Code nicht akzeptiert», если хотите знать о неудачных попытках.

Подключение и первый запуск описаны в документации. Почему bridge вообще использует OSDP: OSDP вместо Wiegand.