Tarjeta y PIN: una automatización de acceso en Home Assistant

El bridge comunica cada tarjeta y cada resultado de PIN por MQTT. Una automatización comprueba la tarjeta, espera hasta 15 segundos el PIN correcto, abre la cerradura y da al lector una señal verde o roja.

Una tarjeta sola puede perderse o prestarse. Un PIN solo puede verse por encima del hombro. Juntos son un segundo factor: la puerta solo se abre para quien tiene la tarjeta y conoce el código. Esta guía construye exactamente eso.

Qué necesitas

• un KLOKL Bridge con un lector OSDP con teclado
• Home Assistant con un broker MQTT, por ejemplo el complemento Mosquitto
• una cerradura o un relé que Home Assistant pueda accionar

Los topics que intervienen

Cada topic empieza con el ID de dispositivo de tu bridge. Lo encuentras en la interfaz web del bridge y en Home Assistant, en el dispositivo. En este ejemplo es osdp-reader-3f9a12.

• …/card_data: número de la tarjeta leída
• …/pin_status: «Code akzeptiert» o «Code nicht akzeptiert» después de pulsar #
• …/cmd/feedback_ok: LED verde y zumbador en el lector
• …/cmd/feedback_denied: señal roja en el lector

Paso 1: definir el código

El bridge compara el PIN por sí mismo, así que el código nunca viaja por la red cuando alguien lo teclea. Define el código una vez: en Home Assistant el bridge aparece con un campo de texto «Access Code»; introdúcelo ahí. Otra opción es publicarlo en …/cmd/access_code.

Paso 2: la automatización

Crea una nueva automatización, cambia al modo YAML y pega lo siguiente. Sustituye el ID del dispositivo, los números de tarjeta y la entidad de la cerradura por los tuyos.

1alias: Puerta principal: tarjeta y 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

Qué ocurre

1. Se acerca una tarjeta al lector. Si su número no está en la lista, no pasa nada.
2. Con una tarjeta conocida, la automatización espera hasta 15 segundos «Code akzeptiert».
3. PIN correcto a tiempo: la cerradura se abre y el lector muestra verde.
4. PIN incorrecto o demasiado tarde: el lector muestra rojo y la puerta sigue cerrada.

Consejos para el día a día

• Para conocer los números de tarjeta, acerca cada tarjeta una vez al lector y lee el sensor «Card Data» en Home Assistant.
• Mantén la lista de tarjetas permitidas en un solo sitio, por ejemplo en un sensor de plantilla o un ayudante, si varias automatizaciones la usan.
• Para una entrada solo con tarjeta, omite el paso de espera y abre directamente.
• Añade una notificación con «Code nicht akzeptiert» si quieres enterarte de los intentos fallidos.

El cableado y el primer arranque se describen en la documentación. Por qué el bridge usa OSDP: OSDP en lugar de Wiegand.