Протокол Ajax Systems Jeweller: Беспроводные датчики и KNX автоматизация зданий
Ajax Hub 2 Plus с протоколом Jeweller 868 МГц с двусторонней связью — интеграция беспроводных датчиков MotionCam, DoorProtect и LeaksProtect с KNX через вебхуки Ajax API и мост Node-RED, с постановкой/снятием с охраны через групповые адреса KNX.
Характеристики протокола Jeweller
Компания Ajax Systems (Киев, Украина) разработала протокол Jeweller для экосистемы умной безопасности Ajax. Jeweller работает в диапазоне 868.0-868.6 МГц (частотный диапазон ЕС), используя TDMA (множественный доступ с временным разделением), где каждому устройству назначается фиксированный временной слот — связь без коллизий при полной загрузке сети.
Ключевые характеристики: дальность 2000 м на открытом воздухе (от Ajax Hub 2 Plus до датчика), интервал опроса 7,3 секунды (хаб опрашивает каждое устройство, обнаруживает отсутствие ответа в течение 2 циклов опроса), шифрование AES-128 с индивидуальными ключами для каждого устройства, канал Wings (отдельный 2,4 ГГц) для настройки и OTA-обновлений без помех для канала безопасности 868 МГц. Максимум 100 устройств на Hub 2 Plus, 25 хабов Ajax на объект (многохабовые установки).
Настройка Ajax Hub 2 Plus
Hub 2 Plus: две SIM-карты (2G/LTE) + Ethernet. Настройка в мобильном приложении Ajax (iOS/Android). Добавление устройств сканированием QR-кода или вводом серийного номера. Размещение устройств: приложение Ajax показывает качество сигнала в реальном времени во время установки — требуется минимум 2 деления сигнала. Менее 2 делений: добавьте удлинитель диапазона ReX (двунаправленный повторитель 868 МГц, питание от сети, до 2 прыжков).
Портфель датчиков Jeweller, актуальных для проектов KNX: MotionCam (PIR + камера, 12 м, фото при срабатывании), DoorProtect Plus (магнитный контакт + датчик удара + наклона), GlassProtect (разбитие стекла, 9 м), LeaksProtect (затопление/вода, 3 точки измерения), FireProtect Plus (оптический дым + CO + тепло), ThermoSensor (мониторинг температуры), WaterStop (управление моторизованным клапаном воды).
Интеграция с KNX через Ajax API
Ajax Hub 2 Plus exposes a REST API (Ajax API v1, documented at ajax.systems/developers). Authentication: API token per hub account. Webhook support: configure webhook URL in Ajax app (Hub settings > API > Webhooks). Hub sends HTTP POST to your webhook endpoint on each event: sensor triggered, arm/disarm, tamper, battery low.
Вебхук Node-RED в KNX — сопоставление событий
Webhook payload (simplified):
eventType: "MOTION"
deviceId: "sensor-id-abc"
hubId: "hub-xyz"
timestamp: 1707000000
Node-RED flow:
[http in] POST /ajax-webhook
→ [function] map eventType to KNX GA
MOTION → GA 2/3/1 = 1 (DPT 1.001)
OPEN → GA 2/3/5 = 1 (DPT 1.001)
ALARM → GA 8/0/20 = 1 (DPT 1.001)
TAMPER → GA 8/0/21 = 1 (DPT 1.001)
LOW_BATTERY → GA 8/0/22 = 1 (DPT 1.001)
→ [knx out] send telegram to KNXnet/IP tunnelЗависимость от облака: Вебхуки Ajax API доставляются через облачные серверы ajax.systems. Работа только в локальной сети не поддерживается текущим Ajax API. Если облако ajax.systems недоступно, доставка вебхуков прекращается, и события датчиков KNX не принимаются. Проектируйте логику автоматизации так, чтобы корректно обрабатывать отсутствие событий от датчиков — не полагайтесь на события Ajax для критически важных действий безопасности.
Постановка/снятие с охраны из KNX
Команда Ajax API arm: POST на ajax.systems API arm endpoint с JSON-телом, указывающим ID группы и режим постановки. Запуск из KNX: когда KNX GA 8/2/0 (запрос постановки, DPT 1.001) получает значение 1, Node-RED отправляет HTTP POST на Ajax API arm endpoint. Когда KNX HVAC presence GA переходит в 0 (все помещения не заняты), автоматически поставить на охрану Ajax.
KNX присутствие к Ajax постановка/снятие — логика Node-RED
KNX GA 8/2/0 (arm request) = 1
→ Node-RED HTTP POST to ajax.systems API
→ Body: {"groupId": "all", "state": "ARMED"}
→ Response: 200 OK (armed successfully)
→ KNX GA 8/2/10 (arm confirmed) = 1
KNX GA 5/5/99 (occupancy master) = 0 (unoccupied)
→ Wait 120 seconds (avoid false trigger on brief absence)
→ IF still 0: POST arm command
→ Ajax sends push notification: "System armed"
KNX GA 8/2/0 = 0 (disarm request)
→ POST disarm command to Ajax API
→ KNX GA 8/2/10 = 0 (disarmed confirmed)
Note: disarm requires valid user code in API body
Store code in Node-RED environment variable
never hardcode in flow JSON visible in exportsMotionCam Фотоверификация
Уникальная функция Ajax MotionCam: при обнаружении движения в режиме охраны камера делает серию снимков (3-секундная серия с частотой 2 кадра/с) и передает их по Jeweller на хаб, затем в центр мониторинга или приложение. Это позволяет визуально подтвердить причину тревоги до вызова службы безопасности.
С точки зрения KNX: когда MotionCam срабатывает, Ajax API отправляет вебхук с eventType ALARM и полем photoUrl (временный URL, действителен 24 часа). Мост Node-RED может сохранить этот URL в KNX строковый объект (DPT 16.001) или инициировать уведомление на экран управления зданием.
Преимущество фотоверификации
Центры мониторинга, использующие Ajax PRO Desktop, видят фотографии в течение нескольких секунд после срабатывания тревоги. Уровень ложных тревог резко снижается — движение насекомых, движение штор и уборщиков визуально подтверждаются до вызова полиции или службы безопасности.
Учет GDPR
Фотографии MotionCam хранятся на облачных серверах Ajax. В странах ЕС, регулируемых GDPR, согласуйте с владельцем здания, что жильцы дали согласие на фотосъемку при обнаружении движения. Рассмотрите PIR-датчик Ajax MotionProtect как альтернативу в помещениях, чувствительных к конфиденциальности.
Нужен KNX щит с интеграцией Ajax Jeweller по спецификации?
Мы настраиваем Ajax Hub 2 Plus с интеграцией KNX через мост вебхуков Node-RED — настройка API, сопоставление групповых адресов, логика постановки/снятия и полная документация по вводу в эксплуатацию с тестированием на вашем объекте.
Запросить предложение →