Caractéristiques du protocole Jeweller

Ajax Systems (Kyiv, Ukraine) a développé le protocole Jeweller pour l'écosystème de sécurité intelligent Ajax. Jeweller fonctionne à 868,0-868,6 MHz (bande EU), utilisant TDMA (accès multiple par répartition dans le temps) avec un créneau de transmission fixe attribué à chaque dispositif – communication sans collision à pleine charge du maillage.

Spécifications clés : portée de 2000 m en extérieur (Ajax Hub 2 Plus vers détecteur), intervalle d'interrogation de 7,3 secondes (le hub interroge chaque dispositif, détecte une réponse manquante en 2 cycles d'interrogation), chiffrement AES-128 avec clés par dispositif, canal Wings (bande 2,4 GHz séparée) pour la configuration et les mises à jour OTA sans interférer avec le canal de sécurité 868 MHz. Maximum 100 dispositifs par Hub 2 Plus, 25 hubs Ajax par site (installations multi-hubs).

Configuration de l'Ajax Hub 2 Plus

Hub 2 Plus : double SIM (2G/LTE) + Ethernet. Configuration dans l'application Ajax (iOS/Android). Ajout de dispositifs en scannant le code QR ou en saisissant le numéro de série. Placement des dispositifs : l'application Ajax affiche la qualité du signal en temps réel pendant l'installation – minimum 2 barres de signal requises. En dessous de 2 barres : ajouter un répéteur de portée ReX (répéteur bidirectionnel 868 MHz, alimenté sur secteur, jusqu'à 2 sauts).

Portefeuille de capteurs Jeweller pertinent pour les projets KNX : MotionCam (PIR + caméra, 12 m, photo sur déclenchement), DoorProtect Plus (contact magnétique + capteur de choc + d'inclinaison), GlassProtect (bris de verre, 9 m), LeaksProtect (inondation/eau, 3 points de détection), FireProtect Plus (fumée optique + CO + chaleur), ThermoSensor (surveillance de plage de température), WaterStop (contrôle motorisé de vanne d'eau).

Intégration KNX via l'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

Armement/Désarmement depuis KNX

Commande d'armement Ajax API : POST vers l'endpoint d'armement de l'API ajax.systems avec un corps JSON spécifiant l'ID du groupe et le mode d'armement. Déclenchement depuis KNX : lorsque la GA KNX 8/2/0 (demande d'armement, DPT 1.001) reçoit la valeur 1, Node-RED envoie le HTTP POST vers l'endpoint d'armement Ajax API. Lorsque la GA de présence HVAC KNX passe à 0 (toutes les pièces inoccupées), armez automatiquement la sécurité 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

Vérification photo MotionCam

La fonctionnalité unique de l'Ajax MotionCam : lors de la détection de mouvement en mode armé, la caméra prend une série de photos (rafale de 3 secondes à 2 ips) et les transmet via Jeweller au hub, puis au centre de télésurveillance ou à l'application. Cela permet une vérification visuelle de la cause de l'alarme avant d'envoyer une réponse de sécurité.

Du point de vue KNX : lorsque MotionCam se déclenche, l'API Ajax envoie un webhook avec eventType ALARM et un champ photoUrl associé (URL temporaire, valable 24 heures). Le pont Node-RED peut enregistrer cette URL dans un objet chaîne KNX (DPT 16.001) ou déclencher une notification sur l'écran de gestion du bâtiment.