KLOKL Bridge
Превращает OSDP-считыватель карт в полноценное устройство Home Assistant. Карта, клавиатура, светодиод и зуммер — всё через MQTT, всё в вашей собственной сети. Для монтажной коробки за считывателем или для DIN-рейки.
- Помещается за считывателем
- Скрытый монтаж
- С адаптером
- DIN-рейка
- Профессиональные считыватели
- OSDP · RS-485
- Автообнаружение в Home Assistant
- MQTT
Что делает bridge
Аппаратная часть и прошивка — наша собственная работа, от клеммы 12 В до последнего MQTT-топика.
Устройство
Помещается в стандартную монтажную коробку прямо за считывателем.
Тот же модуль защёлкивается на DIN-рейке, если считыватель подключён к щиту.
На вход 12 В; bridge передаёт питание дальше на считыватель.
Надёжная шина для длинных линий; переключаемый терминатор 120 Ом.
Самовосстанавливающиеся предохранители и защита от перенапряжения по питанию и шине.
Питание, Wi-Fi, MQTT/Home Assistant и считыватель — с одного взгляда.
Прошивка и диагностика без вскрытия модуля.
Закрытый модуль для монтажной коробки за считывателем или для DIN-рейки в распределительном щите.
Firmware
Кадры, CRC, опрос, события карт и клавиатуры, управление светодиодом и зуммером по OSDP v2.2.
Зашифрованный AES канал OSDP Secure Channel для считывателей, которые его поддерживают.
Карта плюс мастер-код: код проверяется на bridge. Его также можно использовать отдельно или задавать из Home Assistant.
Настройка Wi-Fi через собственную точку доступа, страница состояния и диагностика в браузере.
HTTP, HTTPS или оба, с вашим сертификатом или сгенерированным на устройстве.
Новая прошивка через веб-интерфейс.
Само возвращается в Wi-Fi и MQTT без перезагрузки.
Написана на C++ с уровня протокола, а не обёртка вокруг чужой библиотеки.
Home Assistant
Данные карты, клавиатура, статус PIN и статус считывателя появляются как датчики, без YAML.
«Feedback OK» и «Feedback Denied» управляют светодиодом и зуммером считывателя из ваших автоматизаций.
Задавайте мастер-код из Home Assistant как текстовую сущность.
Версия прошивки, IP, время работы, причина перезагрузки и уровень сигнала Wi-Fi.
Опциональное соединение с брокером с шифрованием TLS.
Формируется из адреса чипа, поэтому несколько считывателей никогда не конфликтуют.
Подключите его — и считыватель станет обычным устройством Home Assistant.
Модуль скрытого монтажа
Помещается в стандартную монтажную коробку прямо за считывателем.
Закрытый модуль для монтажной коробки за считывателем или для DIN-рейки в распределительном щите.
От двери до Home Assistant
Поднесите карту к считывателю и следите за сообщением. Всё происходит в вашей собственной сети: bridge общается со считывателем по OSDP, а с вашим брокером — по MQTT. Ничего не покидает дом.
Считыватель карт
Профессиональный OSDP-считыватель с клавиатурой у двери. Он читает карты и коды, но ничего не решает.
KLOKL Bridge
Общается со считывателем по OSDP, проверяет код доступа прямо на устройстве как второй фактор и публикует каждое событие через MQTT.
…/card_data…/keypad…/pin_status…/cmd/feedback_okВаш MQTT-брокер
Например, дополнение Mosquitto в Home Assistant. По желанию с шифрованием TLS (MQTTS).
- Входная дверьОткрыто
Home Assistant
Датчики и кнопки появляются сами. Ваша автоматизация решает, кто войдёт, и открывает замок, которым вы уже пользуетесь.
Что передаётся по вашей сети
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_BUZТехнические данные
Прошивка v1.0.2. Корпус по проекту для первой серии.
| Исполнение | Закрытый модуль скрытого монтажа |
|---|---|
| Монтаж | Монтажная коробка или DIN-рейка (адаптер) |
| Контроллер | ESP32-C3 |
| Беспроводная связь | Wi-Fi 2,4 ГГц |
| Индикаторы состояния | Питание, Wi-Fi, MQTT/HA, считыватель |
| Service | USB-C, кнопка сброса |
| Вход | 12 V DC |
|---|---|
| Питание считывателя | +12 В передаются на считыватель |
| Защита | Самовосстанавливающийся предохранитель, защита от перенапряжения |
| Интерфейс | RS-485, автоматическое направление |
|---|---|
| Протокол | OSDP v2.2 (IEC 60839-11-5), роль контроллера |
| Скорость | 19 200 бод (DS-K1107AMK) |
| Терминатор | 120 Ом, переключаемый |
| Проверенный считыватель | Hikvision DS-K1107AMK |
| MQTT | MQTT и MQTTS, автообнаружение в Home Assistant |
|---|---|
| PIN | Второй фактор, проверяется на устройстве |
| Веб-интерфейс | HTTP и/или HTTPS, опциональный пароль |
| Updates | По воздуху через веб-интерфейс |
| Secure Channel | Поддерживается, если считыватель его предлагает |
Характеристики прототипа. Корпус и детали могут измениться до первой серии.
Работает уже за вечер
Установите. В монтажную коробку за считывателем или с адаптером на DIN-рейку в щите.
Подключите провода. Четыре провода от считывателя: +12 В, A+, B− и GND. 12 В от блока питания — на вторую клемму. Bridge также питает считыватель.
Подключите. Bridge открывает собственную сеть Wi-Fi OSDP-Reader-Setup. Подключитесь к ней с телефона, выберите домашнюю сеть и укажите ваш MQTT-брокер.
Автоматизируйте. Home Assistant сам находит считыватель. Автоматизация проверяет карту и открывает ваш замок, например:
trigger: - platform: mqtt topic: osdp-reader-3f9a12/card_data condition: - "{{ trigger.payload in ['0004958372'] }}" action: - service: lock.unlock target: { entity_id: lock.front_door }
Вопросы о bridge
Нужны ли bridge облако или учётная запись?
Нет. Bridge общается только со считывателем и с вашим собственным MQTT-брокером. Никакого сервера KLOKL посередине и никакой подписки.
Какие считыватели поддерживаются?
Мы разрабатываем и тестируем на Hikvision DS-K1107AMK (карта и клавиатура, OSDP по RS-485). Другие считыватели с OSDP по RS-485 тоже должны работать. Считыватели только с Wiegand не поддерживаются.
Как задуман PIN?
Как второй фактор: карта плюс мастер-код, который знает пользователь. Bridge сам проверяет код и сообщает результат; ваша автоматизация открывает дверь, только если карта и код совпали. Код можно использовать и отдельно или задавать из Home Assistant.
Открывает ли bridge дверь сам?
Нет, у него нет реле. Дверь открывает Home Assistant через вашу автоматизацию — тем замком или реле, которое у вас уже есть, например умным замком или релейным модулем.
Что будет, если пропадёт Wi-Fi?
Bridge продолжает общаться со считывателем и сам переподключается к Wi-Fi и MQTT, как только сеть вернётся. Для открытия нужен Home Assistant, поэтому сохраните обычный резервный способ открытия замка (ключ или код).
Может ли он читать секторы Mifare?
Стандартный OSDP передаёт номер карты (UID), а не её содержимое. Именно его и использует bridge.
Когда можно купить?
Мы готовим первую небольшую серию и краудфандинговую кампанию. Подпишитесь на список — и узнаете первыми.
Будьте в первой серии
Мы готовим первую небольшую партию и краудфандинговую кампанию. Оставьте e-mail — мы напишем один раз, когда bridge можно будет заказать.
Первая серия в подготовке