KLOKL Bridge
Zamienia czytnik kart OSDP w natywne urządzenie Home Assistant. Karta, klawiatura, LED i brzęczyk, wszystko przez MQTT, wszystko w twojej sieci. Do puszki podtynkowej za czytnikiem albo na szynę DIN.
- Mieści się za czytnikiem
- Podtynkowo
- Z adapterem
- Szyna DIN
- Profesjonalne czytniki
- OSDP · RS-485
- Automatyczne wykrywanie w Home Assistant
- MQTT
Co robi bridge
Sprzęt i firmware to nasza własna praca, od zacisku 12 V po ostatni topic MQTT.
Urządzenie
Mieści się w standardowej puszce podtynkowej, tuż za czytnikiem.
Ten sam moduł zatrzaskujesz na szynie DIN, gdy czytnik jest podłączony do rozdzielnicy.
Na wejściu 12 V; bridge przekazuje zasilanie do czytnika.
Odporna magistrala na długie przewody; przełączany terminator 120 Ω.
Bezpieczniki polimerowe i ochrona przepięciowa na zasilaniu i magistrali.
Zasilanie, Wi-Fi, MQTT/Home Assistant i czytnik w jednym spojrzeniu.
Firmware i diagnostyka bez otwierania modułu.
Zamknięty moduł do puszki podtynkowej za czytnikiem albo na szynę DIN w rozdzielnicy.
Firmware
Ramki, CRC, odpytywanie, zdarzenia karty i klawiatury, sterowanie LED i brzęczykiem zgodnie z OSDP v2.2.
Szyfrowany AES kanał OSDP Secure Channel dla czytników, które go oferują.
Karta plus kod główny: kod jest sprawdzany na bridge. Można go też używać samodzielnie albo zarządzać nim z Home Assistant.
Konfiguracja Wi-Fi przez własny punkt dostępowy, strona stanu i diagnostyka w przeglądarce.
HTTP, HTTPS lub oba, z własnym certyfikatem albo wygenerowanym na urządzeniu.
Nowy firmware przez interfejs WWW.
Sam wraca do Wi-Fi i MQTT bez restartu.
Napisany w C++ od poziomu protokołu, a nie nakładka na cudzą bibliotekę.
Home Assistant
Dane karty, klawiatura, stan PIN i stan czytnika pojawiają się jako czujniki, bez YAML.
„Feedback OK” i „Feedback Denied” sterują diodą LED i brzęczykiem czytnika z poziomu twoich automatyzacji.
Ustaw kod główny z Home Assistant jako encję tekstową.
Wersja firmware, IP, czas pracy, przyczyna restartu i siła sygnału Wi-Fi.
Opcjonalne połączenie z brokerem szyfrowane TLS.
Wyprowadzony z adresu układu, więc kilka czytników nigdy się nie zderzy.
Podłącz go, a czytnik stanie się zwykłym urządzeniem w Home Assistant.
Moduł podtynkowy
Mieści się w standardowej puszce podtynkowej, tuż za czytnikiem.
Zamknięty moduł do puszki podtynkowej za czytnikiem albo na szynę DIN w rozdzielnicy.
Od drzwi do Home Assistant
Przyłóż kartę do czytnika i śledź komunikat. Wszystko dzieje się w twojej własnej sieci: bridge rozmawia z czytnikiem przez OSDP, a z twoim brokerem przez MQTT. Nic nie opuszcza domu.
Czytnik kart
Profesjonalny czytnik OSDP z klawiaturą przy drzwiach. Czyta karty i kody, niczego nie rozstrzyga.
KLOKL Bridge
Rozmawia z czytnikiem przez OSDP, sprawdza kod dostępu na urządzeniu jako drugi składnik i publikuje każde zdarzenie przez MQTT.
…/card_data…/keypad…/pin_status…/cmd/feedback_okTwój broker MQTT
Na przykład dodatek Mosquitto w Home Assistant. Opcjonalnie szyfrowany przez TLS (MQTTS).
- Drzwi wejścioweOtwarte
Home Assistant
Czujniki i przyciski pojawiają się same. Twoja automatyzacja decyduje, kto wejdzie, i otwiera zamek, którego już używasz.
Co przesyła twoja sieć
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_BUZDane techniczne
Firmware v1.0.2. Obudowa według projektu dla pierwszej serii.
| Forma | Zamknięty moduł podtynkowy |
|---|---|
| Montaż | Puszka podtynkowa lub szyna DIN (adapter) |
| Kontroler | ESP32-C3 |
| Łączność bezprzewodowa | Wi-Fi 2,4 GHz |
| Diody stanu | Zasilanie, Wi-Fi, MQTT/HA, czytnik |
| Service | USB-C, przycisk reset |
| Wejście | 12 V DC |
|---|---|
| Zasilanie czytnika | +12 V przekazywane do czytnika |
| Zabezpieczenia | Bezpiecznik polimerowy, ochrona przepięciowa |
| Interfejs | RS-485, automatyczny kierunek |
|---|---|
| Protokół | OSDP v2.2 (IEC 60839-11-5), rola kontrolera |
| Prędkość | 19 200 bodów (DS-K1107AMK) |
| Terminator | 120 Ω, przełączany |
| Testowany czytnik | Hikvision DS-K1107AMK |
| MQTT | MQTT i MQTTS, automatyczne wykrywanie w Home Assistant |
|---|---|
| PIN | Drugi składnik, sprawdzany na urządzeniu |
| Interfejs WWW | HTTP i/lub HTTPS, opcjonalne hasło |
| Updates | Bezprzewodowo przez interfejs WWW |
| Secure Channel | Obsługiwany, jeśli czytnik go oferuje |
Specyfikacja prototypu. Obudowa i szczegóły mogą się zmienić przed pierwszą serią.
Działa w jeden wieczór
Zamontuj. W puszce podtynkowej za czytnikiem albo z adapterem na szynie DIN w rozdzielnicy.
Podłącz przewody. Cztery przewody od czytnika: +12 V, A+, B− i GND. 12 V z zasilacza do drugiego zacisku. Bridge zasila też czytnik.
Połącz. Bridge otwiera własną sieć Wi-Fi o nazwie OSDP-Reader-Setup. Połącz się telefonem, wybierz sieć domową i wpisz swój broker MQTT.
Zautomatyzuj. Home Assistant sam znajduje czytnik. Automatyzacja sprawdza kartę i otwiera twój zamek, na przykład:
trigger: - platform: mqtt topic: osdp-reader-3f9a12/card_data condition: - "{{ trigger.payload in ['0004958372'] }}" action: - service: lock.unlock target: { entity_id: lock.front_door }
Pytania o bridge
Czy bridge potrzebuje chmury albo konta?
Nie. Bridge rozmawia tylko z czytnikiem i z twoim własnym brokerem MQTT. Nie ma po drodze serwera KLOKL ani abonamentu.
Jakie czytniki działają?
Rozwijamy i testujemy z czytnikiem Hikvision DS-K1107AMK (karta i klawiatura, OSDP przez RS-485). Inne czytniki obsługujące OSDP przez RS-485 również powinny działać. Czytniki obsługujące tylko Wiegand nie są wspierane.
Jak korzystać z PIN-u?
Jako drugiego składnika: karta plus kod główny, który zna użytkownik. Bridge sam sprawdza kod i zgłasza wynik; twoja automatyzacja otwiera tylko wtedy, gdy karta i kod się zgadzają. Kod może też działać samodzielnie albo być ustawiany z Home Assistant.
Czy bridge sam otwiera drzwi?
Nie, nie ma przekaźnika. Home Assistant otwiera zamek lub przekaźnik, którego już używasz, na przykład inteligentny zamek albo moduł przekaźnikowy, za pomocą twojej automatyzacji.
Co się stanie, gdy zniknie Wi-Fi?
Bridge dalej rozmawia z czytnikiem i sam łączy się ponownie z Wi-Fi i MQTT, gdy tylko sieć wróci. Do otwarcia potrzebny jest Home Assistant, więc zachowaj zwykłe awaryjne otwieranie zamka (klucz lub kod).
Czy może czytać sektory Mifare?
Standardowy OSDP przesyła numer karty (UID), a nie jej zawartość. Właśnie z tego korzysta bridge.
Kiedy można go kupić?
Przygotowujemy pierwszą małą serię i kampanię crowdfundingową. Zapisz się na listę, a dowiesz się pierwszy.
Bądź przy pierwszej serii
Przygotowujemy pierwszą małą serię produkcyjną i kampanię crowdfundingową. Zostaw e-mail, a napiszemy raz, gdy bridge będzie można zamówić.
Pierwsza seria w przygotowaniu