Charakterystyka protokołu Jeweller

Ajax Systems (Kijów, Ukraina) opracowało protokół Jeweller dla inteligentnego systemu bezpieczeństwa Ajax. Jeweller działa w paśmie 868,0–868,6 MHz (pasmo EU), wykorzystując TDMA (wielodostęp z podziałem czasowym), gdzie każde urządzenie ma przypisany stały slot transmisyjny – komunikacja bez kolizji przy pełnym obciążeniu sieci mesh.

Kluczowe parametry: zasięg 2000 m na otwartej przestrzeni (Ajax Hub 2 Plus do czujnika), interwał odpytywania 7,3 s (hub odpytuje każde urządzenie, wykrywa brak odpowiedzi w ciągu 2 cykli odpytywania), szyfrowanie AES-128 z kluczami dla każdego urządzenia, kanał Wings (oddzielne pasmo 2,4 GHz) do konfiguracji i aktualizacji OTA bez zakłócania kanału bezpieczeństwa 868 MHz. Maksymalnie 100 urządzeń na Hub 2 Plus, 25 hubów Ajax na lokalizację (instalacje wielohubowe).

Konfiguracja Ajax Hub 2 Plus

Hub 2 Plus: dual SIM (2G/LTE) + Ethernet. Konfiguracja w aplikacji Ajax (iOS/Android). Dodawanie urządzeń poprzez skanowanie kodu QR lub wpisanie numeru seryjnego. Rozmieszczenie urządzeń: aplikacja Ajax pokazuje jakość sygnału w czasie rzeczywistym podczas instalacji – wymagane minimum 2 kreski sygnału. Poniżej 2 kresek: dodaj wzmacniacz zasięgu ReX (dwukierunkowy repeater 868 MHz, zasilany sieciowo, do 2 skoków).

Portfolio czujników Jeweller istotne dla projektów KNX: MotionCam (PIR + kamera, 12 m, zdjęcie przy wyzwoleniu), DoorProtect Plus (kontaktron magnetyczny + czujnik wstrząsów + przechyłu), GlassProtect (stłuczenie szkła, 9 m), LeaksProtect (zalanie/woda, 3 punkty pomiarowe), FireProtect Plus (optyczny dym + CO + ciepło), ThermoSensor (monitorowanie zakresu temperatur), WaterStop (sterowanie motoryzowanym zaworem wody).

Integracja KNX przez API Ajax

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.

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

Uzbrojenie/Rozbrojenie z KNX

Polecenie uzbrojenia Ajax API: POST do punktu końcowego uzbrojenia ajax.systems API z ciałem JSON określającym ID grupy i tryb uzbrojenia. Wyzwalanie z KNX: gdy KNX GA 8/2/0 (żądanie uzbrojenia, DPT 1.001) otrzyma wartość 1, Node-RED wysyła HTTP POST do punktu końcowego uzbrojenia Ajax API. Gdy KNX HVAC presence GA przejdzie na 0 (wszystkie pomieszczenia nie zajęte), automatycznie uzbrój zabezpieczenia Ajax.

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 exports

Weryfikacja zdjęciowa MotionCam

Unikalna cecha Ajax MotionCam: po wykryciu ruchu w trybie czuwania kamera wykonuje serię zdjęć (3-sekundowa seria z prędkością 2 kl./s) i przesyła je przez Jeweller do centrali, a następnie do stacji monitorowania lub aplikacji. Umożliwia to wizualną weryfikację przyczyny alarmu przed wysłaniem służb ochrony.

Z perspektywy KNX: gdy MotionCam zostanie uruchomiony, API Ajax wysyła webhook z eventType ALARM i polem photoUrl (tymczasowy URL, ważny 24 godziny). Mostek Node-RED może zapisać ten URL do obiektu string KNX (DPT 16.001) lub wywołać powiadomienie na ekranie zarządzania budynkiem.