Rendere Ambi Climate compatibile Apple HomeKit tramite Homebridge

Abstract

Come purtroppo noto, uno dei più prestigiosi attuatori per condizionatore – l’Ambi Climate – per quanto pregiato non annovera tra le proprie caratteristiche native la compatibilità nativa con Apple HomeKit.

Come spesso capita, questo non è un problema: l’adozione di Homebridge, infatti, consente di rendere compatibile con questo standard molti componenti che non lo prevederebbero. Ambi Climate è tra questi.

Per far ciò è necessario utilizzare non uno ma bensì due plugin (in realtà è possibile usarne anche uno solo a scelta), in quanto:

• “homebridge-ambiclimate-thermostat” integra l’attuatore come termostato & ventilatore vituale;
• “homebridge-ambiclimate” integra l’attuatore come multisensore.

Utilizzare entrambi i plugin consente quindi di dotare la propria app “Casa” di tutte le funzionalità possibili riconducibili al proprio Ambi Climate.

Installazione

L’installazione, come tutti i plugin per Homebridge – è semplicissima.

Eseguire i seguenti due comandi – su sistemi unix-based (linux, Raspberry ecc.) da terminale, da sistemi Windows su prompt dei comandi:

sudo npm install -g homebridge-ambiclimate-thermostat
sudo npm install -g homebridge-ambiclimate

e attendere il termine della procedura. In caso di sistemi Windows, rimuovere il prefisso “sudo”.

Nb. In caso Homebridge sia già in esecuzione come servizio (come descritto nelle nostre guide di installazione), provvedere a interromperlo prima dell’installazione tramite il comando:

sudo systemctl stop homebridge

OAuth Client

Per far sì che entrambi (o singolarmente) i plugin funzionino è necessario chiedere ad Ambi Climate l’erogazione di una coppia di chiavi personali d’accesso che consentano a Homebridge ad accedere al cloud del produttore e, da lì, ottenere indirettamente i dati dal proprio attuatore.

A tal scopo è necessario creare una propria OAuth Application presso l’Ambi Dev Portal. Una volta acceduto tramite la propria utenza Ambi Climate (la stessa utilizzata per configurare l’app mobile), cliccare sotto “OAuth Client” e poi su “Create an App“.

Configurare come segue:

Una volta completata la configurazione nell’elenco dei client oAuth apparirà un voce “Homebridge” ; accedendovi, sarà possibile leggere le due chiavi personali chiamate “Client ID” e “Client Secret“. Segnarsele, torneranno utili a breve.

Configurazione

La configurazione dei plugin prevede l’aggiunta al file di configurazione di Homebridge  di uno o più accessori così configurati:

"accessories": [
    {
        "accessory": "AmbiClimateThermostat",
        "name": "",
        "roomName": "",
        "locationName": "",
        "clientId": "",
        "clientSecret": "",
        "username": "",
        "password": ""
    },
    {
        "accessory": "AmbiClimate",
        "name": "",
        "roomName": "",
        "locationName": "",
        "clientId": "",
        "clientSecret": "",
        "username": "",
        "password": "",
        "onMode": "Comfort",
        "offMode": "Away_Temperature_Upper",
        "offValue": 25
    }
]

Spiegazione dei campi.

Utilizzo

Come spiegato, la co-presenza di entrambi i plugin permettono la definizione di svalariati, diversi accessori. In primis, un termostato e un ventilatore virtuale, in secondo luogo una serie di sensori comodi per la consultazione e per l’automazione.

Aggiornamento

Per aggiornare i plugin è sufficiente eseguire i seguenti comandi:

sudo npm update -g -dev homebridge-ambiclimate-thermostat
sudo npm update -g -dev homebridge-ambiclimate

avendo cura, precedentemente, di aver fermato eventuali esecuzioni di Homebridge in corso.