Caratteristiche del protocollo Jeweller

Ajax Systems (Kyiv, Ucraina) ha sviluppato il protocollo Jeweller per l'ecosistema di sicurezza intelligente Ajax. Jeweller opera a 868,0-868,6 MHz (banda EU), utilizzando TDMA (accesso multiplo a divisione di tempo) con un intervallo di trasmissione fisso assegnato a ciascun dispositivo – comunicazione senza collisioni a pieno carico della rete mesh.

Specifiche chiave: portata di 2000 m in campo aperto (Ajax Hub 2 Plus al rivelatore), intervallo di polling di 7,3 secondi (l'Hub interroga ogni dispositivo, rileva la risposta mancante entro 2 cicli di polling), crittografia AES-128 con chiavi per dispositivo, canale Wings (banda 2,4 GHz separata) per configurazione e aggiornamenti OTA senza interferire con il canale di sicurezza a 868 MHz. Massimo 100 dispositivi per Hub 2 Plus, 25 hub Ajax per sito (installazioni multi-hub).

Configurazione di Ajax Hub 2 Plus

Hub 2 Plus: dual SIM (2G/LTE) + Ethernet. Configurazione nell'app Ajax (iOS/Android). Aggiunta dispositivi scansionando il codice QR o inserendo il numero di serie. Posizionamento dispositivi: l'app Ajax mostra la qualità del segnale in tempo reale durante l'installazione – minimo 2 barre di segnale richieste. Sotto 2 barre: aggiungere un ripetitore di portata ReX (ripetitore bidirezionale a 868 MHz, alimentato a rete, fino a 2 hop).

Portafoglio sensori Jeweller rilevante per progetti KNX: MotionCam (PIR + fotocamera, 12 m, foto su attivazione), DoorProtect Plus (contatto magnetico + sensore d'urto + inclinazione), GlassProtect (rottura vetro, 9 m), LeaksProtect (allagamento/acqua, 3 punti di rilevamento), FireProtect Plus (fumo ottico + CO + calore), ThermoSensor (monitoraggio intervallo temperatura), WaterStop (controllo motorizzato valvola acqua).

Integrazione KNX tramite 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

Inserimento/Disinserimento da KNX

Comando di inserimento Ajax API: POST all'endpoint di inserimento dell'API ajax.systems con corpo JSON che specifica l'ID del gruppo e la modalità di inserimento. Attivazione da KNX: quando KNX GA 8/2/0 (richiesta di inserimento, DPT 1.001) riceve valore 1, Node-RED invia l'HTTP POST all'endpoint di inserimento Ajax API. Quando la GA presenza HVAC KNX va a 0 (tutti i locali non occupati), inserire automaticamente la sicurezza 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

Verifica fotografica MotionCam

La caratteristica unica di Ajax MotionCam: al rilevamento di movimento in modalità armata, la fotocamera scatta una serie di foto (burst di 3 secondi a 2 fps) e le trasmette tramite Jeweller all'hub, quindi al centro di monitoraggio o all'app. Ciò consente la verifica visiva della causa dell'allarme prima di inviare una risposta di sicurezza.

Dal punto di vista KNX: quando MotionCam si attiva, l'API Ajax invia un webhook con eventType ALARM e un campo photoUrl associato (URL temporaneo, valido 24 ore). Il bridge Node-RED può salvare questo URL in un oggetto stringa KNX (DPT 16.001) o attivare una notifica sul display di gestione dell'edificio.