KLOKL Bridge
Macht aus einem OSDP-Kartenleser ein echtes Home-Assistant-Gerät. Karte, Tastenfeld, LED und Summer, alles über MQTT, alles in Ihrem eigenen Netz. Für die Unterputzdose hinter dem Leser oder die Hutschiene.
- Passt hinter den Leser
- Unterputz
- Mit Adapter
- Hutschiene
- Professionelle Leser
- OSDP · RS-485
- Home-Assistant-Discovery
- MQTT
Was die Bridge kann
Hardware und Firmware sind unsere eigene Arbeit, von der 12-Volt-Klemme bis zum letzten MQTT-Topic.
Gerät
Passt in eine Standard-Unterputzdose, direkt hinter den Leser.
Dasselbe Modul auf die Hutschiene klipsen, wenn der Leser zum Verteiler verkabelt ist.
12 V hinein; die Bridge reicht die Versorgung an den Leser weiter.
Robuster Bus für lange Leitungen; zuschaltbarer 120-Ω-Abschluss.
Rückstellbare Sicherungen und Überspannungsschutz an Versorgung und Bus.
Strom, WLAN, MQTT/Home Assistant und Leser auf einen Blick.
Firmware und Diagnose, ohne das Modul zu öffnen.
Ein geschlossenes Modul für die Unterputzdose hinter dem Leser oder für die Hutschiene im Verteiler.
Firmware
Framing, CRC, Polling, Karten- und Tastatur-Ereignisse, LED- und Summer-Steuerung nach OSDP v2.2.
AES-verschlüsselter OSDP Secure Channel für Leser, die ihn anbieten.
Karte plus Mastercode: Der Code wird auf der Bridge geprüft. Er lässt sich auch allein nutzen oder aus Home Assistant verwalten.
WLAN-Einrichtung über einen eigenen Access Point, Statusseite und Diagnose im Browser.
HTTP, HTTPS oder beides, mit eigenem oder auf dem Gerät erzeugtem Zertifikat.
Neue Firmware über die Weboberfläche.
Findet ohne Neustart zurück ins WLAN und zum MQTT-Broker.
Von Grund auf in C++ geschrieben, kein Aufsatz auf eine fremde Bibliothek.
Home Assistant
Kartendaten, Tastatur, PIN-Status und Leser-Status erscheinen als Sensoren, ohne YAML.
„Feedback OK“ und „Feedback Denied“ steuern LED und Summer des Lesers aus Ihren Automationen.
Den Mastercode als Text-Entität direkt aus Home Assistant setzen.
Firmware-Version, IP, Laufzeit, Neustart-Grund und WLAN-Signal.
Optional TLS-verschlüsselte Verbindung zum Broker.
Aus der Chip-Adresse abgeleitet, damit sich mehrere Leser nie in die Quere kommen.
Anschließen, verbinden, und der Leser ist ein ganz normales Home-Assistant-Gerät.
Unterputz-Modul
Passt in eine Standard-Unterputzdose, direkt hinter den Leser.
Ein geschlossenes Modul für die Unterputzdose hinter dem Leser oder für die Hutschiene im Verteiler.
Von der Tür bis Home Assistant
Halten Sie eine Karte an den Leser und verfolgen Sie die Nachricht. Alles passiert in Ihrem eigenen Netzwerk: Die Bridge spricht OSDP mit dem Leser und MQTT mit Ihrem Broker. Nichts verlässt das Haus.
Kartenleser
Ein professioneller OSDP-Leser mit Tastenfeld an der Tür. Er liest Karten und Codes, entscheidet aber nichts.
KLOKL Bridge
Spricht OSDP mit dem Leser, prüft den Zugangscode als zweiten Faktor direkt auf dem Gerät und meldet jedes Ereignis per MQTT.
…/card_data…/keypad…/pin_status…/cmd/feedback_okIhr MQTT-Broker
Zum Beispiel das Mosquitto-Add-on in Home Assistant. Auf Wunsch mit TLS verschlüsselt (MQTTS).
- HaustürEntriegelt
Home Assistant
Sensoren und Knöpfe erscheinen von selbst. Ihre Automation entscheidet, wer hineindarf, und öffnet das Schloss, das Sie schon nutzen.
Was dabei über Ihr Netzwerk geht
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_BUZTechnische Daten
Firmware v1.0.2. Gehäuse wie für die erste Serie geplant.
| Bauform | Geschlossenes Unterputz-Modul |
|---|---|
| Montage | Unterputzdose oder Hutschiene (Adapter) |
| Controller | ESP32-C3 |
| Funk | WLAN 2,4 GHz |
| Status-LEDs | Strom, WLAN, MQTT/HA, Leser |
| Service | USB-C, Reset-Taste |
| Eingang | 12 V DC |
|---|---|
| Leser-Versorgung | +12 V an den Leser durchgereicht |
| Schutz | Rückstellbare Sicherung, Überspannungsschutz |
| Schnittstelle | RS-485, automatische Richtung |
|---|---|
| Protokoll | OSDP v2.2 (IEC 60839-11-5), Controller-Rolle |
| Geschwindigkeit | 19.200 Baud (DS-K1107AMK) |
| Abschluss | 120 Ω, zuschaltbar |
| Getesteter Leser | Hikvision DS-K1107AMK |
| MQTT | MQTT und MQTTS, Home-Assistant-Discovery |
|---|---|
| PIN | Zweiter Faktor, Prüfung auf dem Gerät |
| Weboberfläche | HTTP und/oder HTTPS, optionales Passwort |
| Updates | Übers Netzwerk via Weboberfläche |
| Secure Channel | Unterstützt, wenn der Leser ihn anbietet |
Angaben zum Prototyp. Gehäuse und Details können sich bis zur ersten Serie noch ändern.
An einem Abend eingerichtet
Einbauen. In die Unterputzdose hinter dem Leser oder mit dem Adapter auf die Hutschiene im Verteiler.
Anschließen. Vier Adern vom Leser: +12 V, A+, B− und GND. 12 V vom Netzteil in die andere Klemme. Die Bridge versorgt den Leser gleich mit.
Verbinden. Die Bridge öffnet ein eigenes WLAN namens OSDP-Reader-Setup. Mit dem Handy verbinden, Heimnetz auswählen, MQTT-Broker eintragen.
Automatisieren. Home Assistant findet den Leser von selbst. Eine Automation prüft die Karte und öffnet Ihr Schloss, zum Beispiel:
trigger: - platform: mqtt topic: osdp-reader-3f9a12/card_data condition: - "{{ trigger.payload in ['0004958372'] }}" action: - service: lock.unlock target: { entity_id: lock.front_door }
Fragen zur Bridge
Braucht die Bridge eine Cloud oder ein Konto?
Nein. Die Bridge spricht nur mit dem Leser und mit Ihrem eigenen MQTT-Broker. Es gibt keinen KLOKL-Server dazwischen und kein Abo.
Welche Leser funktionieren?
Wir entwickeln und testen mit dem Hikvision DS-K1107AMK (Karte und Tastenfeld, OSDP über RS-485). Andere Leser, die OSDP über RS-485 sprechen, sollten ebenso funktionieren. Reine Wiegand-Leser werden nicht unterstützt.
Wie ist der PIN gedacht?
Als zweiter Faktor: Karte plus ein Mastercode, den die Person kennt. Die Bridge prüft den Code selbst und meldet das Ergebnis; Ihre Automation öffnet nur, wenn Karte und Code stimmen. Der Code lässt sich auch allein nutzen oder aus Home Assistant setzen.
Öffnet die Bridge die Tür selbst?
Nein, sie hat kein Relais. Home Assistant öffnet über Ihre Automation das Schloss oder Relais, das Sie bereits nutzen, etwa ein Smart Lock oder ein Relaismodul.
Was passiert, wenn das WLAN ausfällt?
Die Bridge spricht weiter mit dem Leser und verbindet sich von selbst wieder mit WLAN und MQTT, sobald das Netz zurück ist. Zum Öffnen braucht es Home Assistant; behalten Sie die übliche Rückfallebene Ihres Schlosses (Schlüssel oder Code).
Kann sie Mifare-Sektoren lesen?
Standard-OSDP überträgt die Kartennummer (UID), nicht den Inhalt der Karte. Diese nutzt die Bridge.
Wann kann ich sie kaufen?
Wir bereiten eine erste kleine Serie und eine Crowdfunding-Kampagne vor. Tragen Sie sich ein, dann erfahren Sie es zuerst.
Bei der ersten Serie dabei sein
Wir bereiten eine erste kleine Serie und eine Crowdfunding-Kampagne vor. Hinterlassen Sie Ihre E-Mail, wir schreiben einmal: wenn die Bridge bestellbar ist.
Erste Serie in Vorbereitung