Home Assistant Ajax integrācija – iestatīšana

Priekšnosacījumi:
 - Ajax konts ar reģistrētu centrmezglu
 - Partner API marķieris (no Ajax PRO Desktop API Keys)
 - Home Assistant 2024.1+ ar instalētu HACS

Instalācija:
 1. HACS Integrations Meklēt "Ajax Security"
 2. Instalēt integrāciju, restartēt HA
 3. Settings Integrations Add Integration Ajax Security
 4. Ievadīt API marķieri un izvēlēties centrmezglu(s)

Izveidotās entītijas katram centrmezglam:
 alarm_control_panel.ajax_hub_[id] – bruņošana/atbruņošana/nakts režīms
 binary_sensor.[device_name]_motion – PIR detektori
 binary_sensor.[device_name]_door – durvju/logu kontakti
 binary_sensor.[device_name]_glass – stikla plīšanas detektori
 binary_sensor.[device_name]_tamper – manipulācijas detektori visām ierīcēm
 sensor.[device_name]_battery – akumulatora līmenis (%)
 sensor.[device_name]_signal – signāla stiprums (%)

Aptaujas intervāls: 30 sekundes (HA aptaujā Ajax Cloud)
Trauksmes notikumi, izmantojot webhook: reāllaika push (skatīt zemāk)

configuration.yaml – Ajax kustība uz KNX telegrammu

# Home Assistant configuration.yaml (KNX integrācija)
knx:
 tunnel:
 host: 192.168.1.10 # KNX IP interfeisa adrese
 port: 3671

# automations.yaml – Ajax kustības detektors KNX
automation:
 - alias: "Ajax MotionCam gaitenis KNX gaismas"
 trigger:
 platform: state
 entity_id: binary_sensor.ajax_motioncam_hallway_motion
 to: "on"
 action:
 service: knx.send
 data:
 address: "3/0/5" # KNX gaitenis gaismas GA
 payload: true
 type: "1byte"

 - alias: "Ajax MotionCam gaitenis OFF KNX gaismas izslēgt"
 trigger:
 platform: state
 entity_id: binary_sensor.ajax_motioncam_hallway_motion
 to: "off"
 for: "00:02:00" # 2 minūšu aizture
 action:
 service: knx.send
 data:
 address: "3/0/5"
 payload: false
 type: "1byte"

 - alias: "Ajax signalizācija KNX vispārējā signalizācija"
 trigger:
 platform: state
 entity_id: alarm_control_panel.ajax_hub_main
 to: "triggered"
 action:
 service: knx.send
 data:
 address: "8/0/1" # KNX vispārējā signalizācija GA
 payload: true
 type: "1byte"

KNX "Es aizeju" aina Ajax aktivizēšana

# KNX "Es aizeju" pogas nospiešana (GA 1/0/10 = true)
# izraisa HA automatizāciju aktivizē Ajax

automation:
 - alias: "KNX aiziešanas aina Ajax prombūtnes režīms"
 trigger:
 platform: event
 event_type: knx_event
 event_data:
 address: "1/0/10" # KNX aiziešanas poga GA
 value: true
 action:
 - service: knx.send
 data:
 address: "3/0/0" # Gaismas izslēgt (visas zonas)
 payload: false
 type: "1byte"
 - service: knx.send
 data:
 address: "4/0/0" # HVAC samazināšanas režīms
 payload: false
 type: "1byte"
 - delay: "00:00:30" # 30 sekunžu izejas aizkave
 - service: alarm_control_panel.alarm_arm_away
 target:
 entity_id: alarm_control_panel.ajax_hub_main
 data:
 code: "1234" # Galvenais kods

 - alias: "Ajax aktivizēts KNX apstiprinājums"
 trigger:
 platform: state
 entity_id: alarm_control_panel.ajax_hub_main
 to: "armed_away"
 action:
 service: knx.send
 data:
 address: "1/0/11" # KNX aktivizācijas indikators LED
 payload: true
 type: "1byte"

Ajax webhook JSON dati – trauksmes notikums

// Ajax webhook POST pamatteksts (trauksmes notikums)
{
 "hubId": "HUB-XXXXXXXX",
 "eventType": "ALARM",
 "deviceId": "DEV-12345678",
 "deviceName": "MotionCam Hallway",
 "deviceType": "MotionCam",
 "zoneId": 3,
 "zoneName": "Ground Floor",
 "timestamp": "2025-04-15T14:32:10Z",
 "alarmReason": "MOTION_DETECTED"
}

// Notikumu veidi:
// ALARM – kustība, durvju atvēršana, stikla plīsums
// TAMPER – ierīce atvērta vai noņemta
// ARM – sistēma vai grupa aktivizēta
// DISARM – sistēma vai grupa deaktivizēta
// POWER_LOSS – centrālā mezgla ārējā barošana zudusi
// BATTERY_LOW – ierīces akumulators zem 10%
// SIGNAL_LOSS – ierīces komunikācija zudusi

// Testa webhook (curl):
curl -X POST https://your-ha-instance.duckdns.org/api/webhook/ajax_test \
 -H "Content-Type: application/json" \
 -d '{"eventType":"ALARM","deviceName":"Test","alarmReason":"TEST"}'