Características del protocolo Jeweller

Ajax Systems (Kiev, Ucrania) desarrolló el protocolo Jeweller para el ecosistema de seguridad inteligente Ajax. Jeweller opera en 868,0-868,6 MHz (banda EU), utilizando TDMA (acceso múltiple por división de tiempo) con un intervalo de transmisión fijo asignado a cada dispositivo: comunicación sin colisiones a plena carga de la malla.

Especificaciones clave: alcance de 2000 m en exteriores (Ajax Hub 2 Plus al detector), intervalo de sondeo de 7,3 segundos (el hub sondea cada dispositivo, detecta respuesta faltante en 2 ciclos de sondeo), cifrado AES-128 con claves por dispositivo, canal Wings (banda separada de 2,4 GHz) para configuración y actualizaciones OTA sin interferir con el canal de seguridad de 868 MHz. Máximo 100 dispositivos por Hub 2 Plus, 25 hubs Ajax por sitio (instalaciones multi-hub).

Configuración de Ajax Hub 2 Plus

Hub 2 Plus: doble SIM (2G/LTE) + Ethernet. Configure en la aplicación Ajax (iOS/Android). Agregue dispositivos escaneando el código QR o ingresando el número de serie. Colocación de dispositivos: la aplicación Ajax muestra la calidad de la señal en tiempo real durante la instalación: se requieren al menos 2 barras de señal. Por debajo de 2 barras: agregue un repetidor de alcance ReX (repetidor bidireccional de 868 MHz, alimentado por red, hasta 2 saltos).

Portafolio de sensores Jeweller relevante para proyectos KNX: MotionCam (PIR + cámara, 12 m, foto al dispararse), DoorProtect Plus (contacto magnético + sensor de golpe + inclinación), GlassProtect (rotura de vidrio, 9 m), LeaksProtect (inundación/agua, 3 puntos de detección), FireProtect Plus (humo óptico + CO + calor), ThermoSensor (monitoreo de rango de temperatura), WaterStop (control motorizado de válvula de agua).

Integración KNX a través de la API de 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

Armado/Desarmado desde KNX

Comando de armado Ajax API: POST al endpoint de armado de la API ajax.systems con cuerpo JSON especificando el ID del grupo y el modo de armado. Disparo desde KNX: cuando KNX GA 8/2/0 (solicitud de armado, DPT 1.001) recibe valor 1, Node-RED envía el HTTP POST al endpoint de armado de Ajax API. Cuando la GA de presencia HVAC KNX pasa a 0 (todas las habitaciones desocupadas), armar automáticamente la seguridad 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

Verificación fotográfica MotionCam

La característica única de Ajax MotionCam: al detectar movimiento en modo armado, la cámara toma una serie de fotos (ráfaga de 3 segundos a 2 fps) y las transmite a través de Jeweller al hub, luego al centro de monitoreo o la aplicación. Esto permite la verificación visual de la causa de la alarma antes de enviar una respuesta de seguridad.

Desde la perspectiva KNX: cuando MotionCam se activa, la API Ajax envía un webhook con eventType ALARM y un campo photoUrl asociado (URL temporal, válido por 24 horas). El puente Node-RED puede guardar esta URL en un objeto de cadena KNX (DPT 16.001) o activar una notificación en la pantalla de gestión del edificio.