Karte und PIN: Zutritt mit einer Home-Assistant-Automation

Die Bridge meldet jede Karte und jedes PIN-Ergebnis über MQTT. Eine Automation prüft die Karte, wartet bis zu 15 Sekunden auf die richtige PIN, öffnet das Schloss und gibt dem Leser grünes oder rotes Licht.

Eine Karte allein kann verloren oder weitergegeben werden. Eine PIN allein kann man jemandem über die Schulter abschauen. Zusammen sind sie ein zweiter Faktor: Die Tür öffnet sich nur, wenn jemand die Karte hat und den Code kennt. Genau das baut diese Anleitung.

Was Sie brauchen

• eine KLOKL Bridge mit einem OSDP-Leser mit Tastenfeld
• Home Assistant mit MQTT-Broker, zum Beispiel dem Mosquitto-Add-on
• ein Schloss oder Relais, das Home Assistant schalten kann

Die beteiligten Topics

Jedes Topic beginnt mit der Geräte-ID Ihrer Bridge. Sie finden sie in der Weboberfläche der Bridge und in Home Assistant beim Gerät. Im Beispiel ist es osdp-reader-3f9a12.

• …/card_data: Nummer der gelesenen Karte
• …/pin_status: „Code akzeptiert“ oder „Code nicht akzeptiert“, nachdem jemand # drückt
• …/cmd/feedback_ok: grüne LED und Summer am Leser
• …/cmd/feedback_denied: rotes Signal am Leser

Schritt 1: Code festlegen

Die Bridge vergleicht die PIN selbst, der Code geht beim Eintippen also nicht über das Netzwerk. Legen Sie den Code einmal fest: In Home Assistant erscheint die Bridge mit einem Textfeld „Access Code“; dort eintragen. Alternativ an …/cmd/access_code senden.

Schritt 2: die Automation

Legen Sie eine neue Automation an, wechseln Sie in den YAML-Modus und fügen Sie Folgendes ein. Geräte-ID, Kartennummern und Schloss-Entität durch Ihre eigenen ersetzen.

1alias: Haustür: Karte und 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

Was passiert

1. Eine Karte wird an den Leser gehalten. Steht ihre Nummer nicht auf der Liste, passiert nichts.
2. Bei einer bekannten Karte wartet die Automation bis zu 15 Sekunden auf „Code akzeptiert“.
3. Richtige PIN rechtzeitig: Das Schloss öffnet, der Leser zeigt Grün.
4. Falsche PIN oder zu spät: Der Leser zeigt Rot, die Tür bleibt zu.

Tipps für den Alltag

• Kartennummern finden Sie, indem Sie jede Karte einmal an den Leser halten und den Sensor „Card Data“ in Home Assistant ablesen.
• Halten Sie die Liste erlaubter Karten an einer Stelle, etwa in einem Template-Sensor oder Helfer, wenn mehrere Automationen sie nutzen.
• Für einen Eingang nur mit Karte lassen Sie den Warteschritt weg und öffnen direkt.
• Ergänzen Sie eine Benachrichtigung bei „Code nicht akzeptiert“, wenn Sie Fehlversuche mitbekommen möchten.

Verkabelung und erster Start stehen in der Dokumentation. Warum die Bridge überhaupt OSDP nutzt: OSDP statt Wiegand.