Quando ho redatto la prima guida per connettere l’allarme Ajax a Home Assistant, dovevo destreggiarmi tra SIA, Jeedom, MQTT, topic a catena… Il risultato funzionava perfettamente, ma era una vera e propria giungla. Oggi, cambiamento totale di scenario: degli sviluppatori hanno messo a punto una integrazione nativa Ajax Home Assistant, installabile tramite HACS, che comunica direttamente con l’API Cloud ufficiale di Ajax. Armamento, disarmamento, notifiche, sensori, relè… tutto si integra in Home Assistant, in tempo (quasi) reale!

Installato a casa mia da qualche giorno, vi propongo di scoprire più nel dettaglio questo plugin tanto atteso…

Riepilogo rapido sulle vecchie metodologie

Fino ad ora, per parlare di Ajax Home Assistant, c’erano due approcci.

Il primo passava tramite l’integrazione SIA Alarm Systems di Home Assistant. L’allarme Ajax era configurato come se Home Assistant fosse un centro di telesorveglianza. Si recuperava lo stato del sistema, alcune informazioni su incendi/inondazioni, e basta. Impossibile pilotare l’allarme, nessun dettaglio su ogni sensore. Era utile soprattutto per attivare alcuni scenari in base allo stato globale dell’allarme, come ad esempio far passare il riscaldamento in modalità eco quando attivavi l’allarme uscendo da casa.

Il secondo metodo, dettagliato nella mia guida precedente, consisteva nell’utilizzare il plugin Ajax su Jeedom, per poi ripubblicare tutte le informazioni in Home Assistant tramite MQTT. Molto più completo, con l’integrazione di quasi tutti i sensori Ajax, ma a costo di un secondo server domotico, di un broker MQTT, di un mapping di decine di topic… Insomma, molto potente, ma decisamente non alla portata di tutti.

Il nuovo plugin cambia completamente le carte in tavola: Ajax Home Assistant diventa un’accoppiata molto più semplice da configurare.

Cosa consente il nuovo plugin Ajax Home Assistant

L’integrazione ajax-hass è un componente personalizzato di Home Assistant che si connette direttamente al Cloud Ajax tramite l’API ufficiale e un flusso gRPC, esattamente come l’app mobile Ajax. Concretamente, il tuo Hub Ajax diventa un “cittadino di prima classe” in Home Assistant, con un vero pannello d’allarme e entità per i sensori, sirene, relè, prese, ecc.

Ottieni in particolare un controllo completo della sicurezza. Il pannello d’allarme di Home Assistant consente l’armamento totale, il disarmamento, la modalità notturna, l’armamento parziale per gruppo, e persino l’armamento forzato quando alcuni sensori rimangono aperti. Un servizio dedicato gestisce il pulsante di panico, che può essere posizionato su un dashboard o su un telecomando virtuale.

Per quanto riguarda il recupero delle informazioni, il plugin espone gli eventi di armamento/disarmamento con il nome dell’utente Ajax, le notifiche di allerta, le rilevazioni di movimento, le aperture di porte e finestre, gli allarmi di incendio o inondazione, oltre a sensori “tecnici” come il livello della batteria, la qualità del segnale, la temperatura o lo stato della connessione. È molto completo.

L’integrazione gestisce anche più hub Ajax nella stessa istanza di Home Assistant se necessario, e l’interfaccia è già tradotta in italiano. Per quanto riguarda il perimetro dei dispositivi, lo sviluppatore sta testando in primo luogo l’Hub 2 Plus e i MotionCam, ma la progettazione si basa sull’API ufficiale di Ajax e la comunità ha già convalidato un buon numero di tastiere, sirene, contatti d’apertura, rilevatori di fumo, ecc.

Ci ritroviamo quindi con un vero tandem Ajax Home Assistant, capace di gestire e monitorare finemente il sistema d’allarme, senza passare da vie secondarie.

Preparare la propria installazione Ajax e Home Assistant

Prima di iniziare, è meglio verificare alcuni requisiti.

Il tuo sistema Ajax deve essere operativo, con un Hub configurato nell’app ufficiale, tutti i rilevatori correttamente aggiunti e nominati, e se possibile i gruppi già definiti (piano terra, piano, garage, ecc.). Più la configurazione Ajax è pulita, più la parte di Home Assistant sarà piacevole da utilizzare.

Per quanto riguarda la domotica, è necessario un Home Assistant aggiornato, con HACS già installato e funzionante, poiché il plugin Ajax Home Assistant è distribuito come integrazione personalizzata. Assicurati anche che la tua istanza di Home Assistant abbia accesso a internet per i server di Ajax, poiché la comunicazione avviene attraverso il Cloud tramite HTTPS e gRPC.

Infine, assicurati che la tua installazione di Home Assistant sia correttamente sicura: password robuste, accesso remoto protetto (reverse proxy, autenticazione, certificato TLS) e backup regolari. Integrare il proprio sistema d’allarme nella domotica è molto utile, ma implica di essere un po’ più rigorosi sulla sicurezza globale dell’infrastruttura.

Installare l’integrazione Ajax tramite HACS

Passiamo al concreto. HACS è già attivo nel tuo Home Assistant? Perfetto, possiamo procedere con l’installazione del plugin Ajax Home Assistant.

Il primo passo consiste nel dichiarare il repository GitHub del plugin in HACS. Nell’interfaccia di Home Assistant, apri HACS, poi la sezione dedicata alle integrazioni. Nell’angolo in alto a destra, un pulsante con tre puntini dà accesso al menu avanzato. Scegliendo l’opzione “Repository personalizzati”, potrai aggiungere un nuovo repository.

Nel campo URL, inserisci l’indirizzo del repository https://github.com/foXaCe/ajax-hass, e seleziona “Integration” come categoria. Conferma, poi chiudi la finestra. La prossima volta che cercherai un’integrazione in HACS, “Ajax Security System” apparirà nella lista.

Ancora in HACS, avvia una ricerca su “Ajax Security System”, apri la scheda corrispondente, poi installala.

HACS scaricherà il componente ajax-hass e lo posizionerà nella cartella custom_components/ajax della tua installazione di Home Assistant.

Una volta completata l’installazione, è necessario riavviare Home Assistant per caricare la nuova integrazione.

Aggiungere l’integrazione Ajax Home Assistant in Home Assistant

Una volta riavviato Home Assistant, possiamo passare alla configurazione. Tutto avviene dall’interfaccia, senza la necessità di YAML, il che è molto comodo!

Apri il menu “Impostazioni”, poi “Dispositivi e servizi”. In fondo alla pagina, utilizza il pulsante “Aggiungi un’integrazione”. Nella casella di ricerca, digita “Ajax”. Dovresti vedere apparire “Ajax Security System” con l’icona corrispondente. Selezionalo per avviare l’assistente di configurazione.

L’integrazione ti chiederà quindi le credenziali del tuo account Ajax, ossia l’indirizzo e-mail e la password utilizzati nell’app ufficiale. Il plugin non ha bisogno di un indirizzo IP locale dell’hub, né di porte esotiche, tutto passa attraverso il Cloud di Ajax.

Segue un’impostazione molto utile: il filtro delle notifiche. Puoi scegliere di non ricevere alcuna notifica in Home Assistant, solo le allerta di intrusione, gli eventi di sicurezza (armamento/disarmamento, allerte tecniche), oppure tutto, inclusi gli eventi dei sensori in tempo reale. Se si prevede di creare molte automazioni Ajax Home Assistant, spesso è interessante partire almeno dagli eventi di sicurezza, per poi regolare in base alle esigenze.

Conferma, aspetta qualche secondo: l’integrazione contatta il Cloud di Ajax e recupera l’elenco dei tuoi hub. Qui, ad esempio, ho 3 diversi sistemi Ajax: posso aggiungerli tutti o selezionare solo quello che mi interessa, come qui “Casa” solamente.

Confermiamo. Il sistema recupera quindi i gruppi e tutti i dispositivi dell’hub selezionati, poi crea le entità corrispondenti in Home Assistant. Possiamo quindi assegnare loro una stanza, se lo desideriamo:

Cosa troviamo in Home Assistant dopo l’integrazione

Una volta che l’integrazione Ajax Home Assistant è attiva, un breve giro in “Dispositivi e servizi” permette di visualizzare il risultato. Ogni Hub Ajax appare come un dispositivo, con un pannello d’allarme principale e un insieme di sensori e attuatori.

Il pannello d’allarme, esposto come entità alarm_control_panel, consente di armare l’intera casa, passare alla modalità notturna, disarmare e utilizzare l’armamento parziale per gruppo se l’hai configurato nell’app Ajax. Questa entità diventa il fulcro dei tuoi scenari di sicurezza.

I rilevatori di movimento sono esposti come binary_sensor classici, che passano allo stato “on” in caso di rilevazione e tornano a “off” dopo il tempo di riposo. I contatti di porte e finestre vengono anche presentati come sensori binari, perfetti per attivare scenari come la disattivazione del riscaldamento se una finestra rimane aperta troppo a lungo.

I rilevatori di fumo, di monossido di carbonio o di inondazione diventano anch’essi entità direttamente utilizzabili.

Le prese e relè Ajax si presentano come interruttori o attuatori, con la possibilità di pilotarli da Home Assistant. Possiamo ad esempio comandare relè Ajax per interrompere l’alimentazione di un dispositivo in caso di incidente.

Per i più esigenti, appare anche tutta una serie di sensori “tecnici”: livello di batteria, forza del segnale radio, temperatura, stato della connessione, ecc. Sono ottime basi per creare un dashboard sulla “salute del sistema Ajax” in Home Assistant.

Esempi di scenari Ajax Home Assistant in azione

Una volta che tutto è integrato in Home Assistant, inizia la parte più interessante: le automazioni. La forza di questa integrazione Ajax Home Assistant è proprio la reattività degli eventi e la possibilità di pilotare l’allarme.

Un primo scenario molto utile consiste nell’armare automaticamente l’allarme quando tutti escono di casa. Si utilizza la presenza delle persone tramite l’app mobile Home Assistant o un altro sistema di presenza, e si avvia un armamento totale non appena l’ultima persona passa a “not_home”.

Un esempio minimalista in YAML potrebbe assomigliare a qualcosa del genere:

automation:
  - alias: "Arma Ajax quando tutti escono"
    trigger:
      - platform: state
        entity_id: group.famille
        to: "not_home"
    action:
      - service: alarm_control_panel.alarm_arm_away
        target:
          entity_id: alarm_control_panel.ajax_alarm_home

Possiamo immaginare l’inverso al ritorno: disarmamento automatico quando arriva la prima persona, accompagnato da una leggera accensione di alcune luci e dalla disattivazione di alcuni scenari di presenza simulata.

Un altro caso d’uso frequente riguarda il riscaldamento. I sensori di apertura Ajax integrati in Home Assistant consentono di interrompere un riscaldamento elettrico o un condizionatore non appena una finestra rimane aperta per più di cinque minuti, per poi riattivare il sistema non appena la finestra viene richiusa. Non c’è bisogno di moltiplicare i sensori Zigbee o Z-Wave per gestire correttamente le aperture.

I rilevatori di movimento Ajax possono anche partecipare alla gestione dell’illuminazione. Possiamo decidere che, solo di notte, il passaggio davanti a un rilevatore nel corridoio attivi una luce notturna o un nastro LED ai piedi del letto, a bassa intensità, per alcuni minuti. L’allarme non viene attivato, ma si riutilizza l’infrastruttura per il comfort. Questo fa parte dei piccoli piaceri della domotica ben integrata.

Infine, il pulsante di panico Ajax esposto come entità “button” può essere posizionato su una dashboard dedicata agli adulti, o addirittura nascosto dietro una scheda protetta da password, ed utilizzato per attivare un’allerta generale: sirene, illuminazione esterna al 100%, invio di notifiche su smartphone, o addirittura chiamata automatica a un vicino attraverso un servizio terzo. In questo tipo di scenario, è ovviamente meglio testare in condizioni reali, ma avvisando tutti prima…

Sicurezza e buone pratiche con Ajax Home Assistant

Integrare Ajax in Home Assistant tramite questo plugin significa che Home Assistant diventa un ulteriore elemento nella catena di sicurezza. Lo sviluppatore ha curato la parte riservatezza: le credenziali sono memorizzate nel sistema crittografato di Home Assistant, la password viene hashata prima di essere inviata ai server di Ajax, le comunicazioni avvengono tramite TLS e nessun dato viene inviato a servizi terzi. L’integrazione è open source e auditabile, il che è rassicurante per un sistema di sicurezza.

Tuttavia, è meglio mantenere alcuni riflessi. Un Home Assistant esposto in modo casuale su internet diventa una porta d’ingresso verso il tuo sistema d’allarme. È quindi cruciale bloccare l’accesso esterno, mantenere aggiornato Home Assistant come l’integrazione di Ajax, e evitare di moltiplicare i conti amministratori. L’armamento forzato, in particolare, deve essere utilizzato con parsimonia, poiché consente di armare il sistema anche in presenza di sensori aperti o in guasto.

Ultimo punto: questo plugin si basa sul Cloud di Ajax. Se la tua connessione internet cade o se i server di Ajax non sono raggiungibili, l’hub continuerà a proteggere la casa, ma il collegamento in tempo reale con Home Assistant verrà interrotto.

In pratica, perché adottare questo plugin Ajax Home Assistant

In sintesi, si passa da un’integrazione “fatta in casa”, dipendente da un secondo sistema domotico, a un plugin dedicato Ajax Home Assistant, mantenuto e molto profondo nella gestione dei dispositivi. L’installazione avviene tramite HACS, la configurazione esclusivamente tramite l’interfaccia, e si ottiene un controllo completo dell’allarme, con recupero degli eventi quasi istantaneo.

Nella vita di tutti i giorni, ciò significa scenari più intelligenti, una vera coerenza tra sicurezza e comfort, e meno duplicazione di sensori in tutta la casa. Per gli installatori, è anche un argomento di peso da presentare ai clienti già equipaggiati con Ajax, che sognano un controllo globale della loro casa con Home Assistant.

E la cosa più piacevole in tutto questo è che, per una volta, “più completo” non è sinonimo di “più complicato”.