KLOKL Bridge
Convierte un lector de tarjetas OSDP en un dispositivo nativo de Home Assistant. Tarjeta, teclado, LED y zumbador, todo por MQTT, todo en tu propia red. Para la caja empotrada detrás del lector o para el carril DIN.
- Cabe detrás del lector
- Empotrado
- Con el adaptador
- Carril DIN
- Lectores profesionales
- OSDP · RS-485
- Detección automática en Home Assistant
- MQTT
Qué hace el bridge
El hardware y el firmware son trabajo nuestro, desde el borne de 12 voltios hasta el último topic MQTT.
Dispositivo
Cabe en una caja empotrada estándar, justo detrás del lector.
El mismo módulo se encaja en un carril DIN cuando el lector está cableado al cuadro eléctrico.
Entran 12 V; el bridge pasa la alimentación al lector.
Bus robusto para cables largos; terminación de 120 Ω conmutable.
Fusibles rearmables y protección contra sobretensiones en alimentación y bus.
Alimentación, Wi-Fi, MQTT/Home Assistant y lector de un vistazo.
Firmware y diagnóstico sin abrir el módulo.
Un módulo cerrado para la caja empotrada detrás del lector o para el carril DIN del cuadro eléctrico.
Firmware
Tramas, CRC, sondeo, eventos de tarjeta y teclado, control de LED y zumbador según OSDP v2.2.
OSDP Secure Channel cifrado con AES para los lectores que lo ofrecen.
Tarjeta más código maestro: el código se comprueba en el bridge. También puede usarse solo o gestionarse desde Home Assistant.
Configuración de Wi-Fi mediante su propio punto de acceso, página de estado y diagnóstico en el navegador.
HTTP, HTTPS o ambos, con tu propio certificado o uno generado en el dispositivo.
Nuevo firmware a través de la interfaz web.
Vuelve a conectarse al Wi-Fi y a MQTT sin reiniciar.
Escrito en C++ desde el protocolo, no un envoltorio de la biblioteca de otro.
Home Assistant
Datos de tarjeta, teclado, estado del PIN y estado del lector aparecen como sensores, sin YAML.
«Feedback OK» y «Feedback Denied» controlan el LED y el zumbador del lector desde tus automatizaciones.
Define el código maestro desde Home Assistant como entidad de texto.
Versión de firmware, IP, tiempo de funcionamiento, motivo del reinicio y señal Wi-Fi.
Conexión opcional cifrada con TLS a tu broker.
Derivado de la dirección del chip, así varios lectores nunca chocan.
Conéctalo y el lector se convierte en un dispositivo normal de Home Assistant.
Módulo empotrable
Cabe en una caja empotrada estándar, justo detrás del lector.
Un módulo cerrado para la caja empotrada detrás del lector o para el carril DIN del cuadro eléctrico.
De la puerta a Home Assistant
Acerca una tarjeta al lector y sigue el mensaje. Todo ocurre dentro de tu propia red: el bridge habla OSDP con el lector y MQTT con tu broker. Nada sale de casa.
Lector de tarjetas
Un lector OSDP profesional con teclado en la puerta. Lee tarjetas y códigos, no decide nada.
KLOKL Bridge
Habla OSDP con el lector, comprueba el código de acceso en el propio dispositivo como segundo factor y publica cada evento por MQTT.
…/card_data…/keypad…/pin_status…/cmd/feedback_okTu broker MQTT
Por ejemplo, el complemento Mosquitto en Home Assistant. Opcionalmente cifrado con TLS (MQTTS).
- Puerta principalAbierto
Home Assistant
Los sensores y botones aparecen solos. Tu automatización decide quién entra y abre la cerradura que ya usas.
Lo que viaja por tu red
OSDPreader → bridge osdp_RAW card 0004958372MQTTbridge → broker osdp-reader-3f9a12/card_data "0004958372"MQTTbroker → Home Assistant osdp-reader-3f9a12/card_dataHAautomation: card 0004958372 is on the list → unlock, press Feedback OKMQTTHome Assistant → broker osdp-reader-3f9a12/cmd/feedback_ok "PRESS"MQTTbroker → bridge osdp-reader-3f9a12/cmd/feedback_okOSDPbridge → reader osdp_LED green + osdp_BUZDatos técnicos
Firmware v1.0.2. Carcasa según el diseño para la primera serie.
| Forma | Módulo empotrable cerrado |
|---|---|
| Montaje | Caja empotrada o carril DIN (adaptador) |
| Controlador | ESP32-C3 |
| Inalámbrico | Wi-Fi 2,4 GHz |
| LED de estado | Alimentación, Wi-Fi, MQTT/HA, lector |
| Service | USB-C, botón de reinicio |
| Entrada | 12 V DC |
|---|---|
| Alimentación del lector | +12 V transmitidos al lector |
| Protección | Fusible rearmable, protección contra sobretensiones |
| Interfaz | RS-485, dirección automática |
|---|---|
| Protocolo | OSDP v2.2 (IEC 60839-11-5), función de controlador |
| Velocidad | 19.200 baudios (DS-K1107AMK) |
| Terminación | 120 Ω, conmutable |
| Lector probado | Hikvision DS-K1107AMK |
| MQTT | MQTT y MQTTS, detección automática en Home Assistant |
|---|---|
| PIN | Segundo factor, comprobado en el dispositivo |
| Interfaz web | HTTP y/o HTTPS, contraseña opcional |
| Updates | Por aire mediante la interfaz web |
| Secure Channel | Compatible, si el lector lo ofrece |
Especificaciones del prototipo. La carcasa y los detalles pueden cambiar antes de la primera serie.
Funcionando en una tarde
Móntalo. En la caja empotrada detrás del lector o, con el adaptador, en el carril DIN del cuadro eléctrico.
Conéctalo. Cuatro hilos desde el lector: +12 V, A+, B− y GND. 12 V de la fuente al otro borne. El bridge también alimenta al lector.
Conéctalo. El bridge abre su propia red Wi-Fi llamada OSDP-Reader-Setup. Conéctate con el móvil, elige tu red doméstica e introduce tu broker MQTT.
Automatízalo. Home Assistant encuentra el lector por sí solo. Una automatización comprueba la tarjeta y abre tu cerradura, por ejemplo:
trigger: - platform: mqtt topic: osdp-reader-3f9a12/card_data condition: - "{{ trigger.payload in ['0004958372'] }}" action: - service: lock.unlock target: { entity_id: lock.front_door }
Preguntas sobre el bridge
¿El bridge necesita una nube o una cuenta?
No. El bridge solo habla con el lector y con tu propio broker MQTT. No hay ningún servidor de KLOKL de por medio ni suscripción.
¿Qué lectores funcionan?
Desarrollamos y probamos con el Hikvision DS-K1107AMK (tarjeta y teclado, OSDP sobre RS-485). Otros lectores que hablen OSDP sobre RS-485 también deberían funcionar. Los lectores solo Wiegand no son compatibles.
¿Cómo se usa el PIN?
Como segundo factor: tarjeta más un código maestro que conoce el usuario. El bridge comprueba el código y comunica el resultado; tu automatización solo abre cuando tarjeta y código coinciden. El código también puede usarse solo o definirse desde Home Assistant.
¿El bridge abre la puerta por sí mismo?
No, no tiene relé. Home Assistant abre la cerradura o el relé que ya usas, por ejemplo una cerradura inteligente o un módulo de relé, mediante tu automatización.
¿Qué pasa si se cae el Wi-Fi?
El bridge sigue hablando con el lector y se reconecta solo al Wi-Fi y a MQTT en cuanto vuelve la red. Para abrir hace falta Home Assistant, así que mantén la alternativa habitual de tu cerradura (llave o código).
¿Puede leer sectores Mifare?
El OSDP estándar transmite el número de la tarjeta (UID), no su contenido. Eso es lo que usa el bridge.
¿Cuándo puedo comprarlo?
Estamos preparando una primera serie pequeña y una campaña de crowdfunding. Apúntate a la lista y serás el primero en saberlo.
Sé de los primeros en la primera serie
Estamos preparando una primera pequeña tirada y una campaña de crowdfunding. Deja tu correo y te escribiremos una vez, cuando se pueda pedir el bridge.
Primera serie en preparación