“homebridge-mi-hygrothermograph”: installare e configurare il plugin per Homebridge

SCOPI DELLA GUIDA:
CONCETTI AFFRONTATI:
  • Installazione e configurazione software
COMPONENTI SOFTWARE UTILIZZATE:
PREREQUISITI:
DISPOSITIVI FISICI UTILIZZATI:
GUIDA MAGGIORMENTE INDICATA PER:

Apple-200x200

Note e disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere effettuata da personale qualificato
  • qualsiasi modifica attuata in proprio è a propria responsabilità personale nonché a proprio rischio e pericolo (la presente guida ha puro scopo didattico)
  • qualsiasi modifica attuata in proprio a un dispositivo ne fa decadere la garanzia.

Abstract

Termometro/Igrometro LCD Bluetooth Xiaomi Mijia - Dimensioni

homebridge-mi-hygrothermograph” concepito per sfruttare le capacità Bluetooth LE del computer sul quale è in esecuzione Homebridge al fine di comunicare con il sensore di temperatura/umidità relativa della Xiaomi LCD Bluetooth, sensore particolarmente apprezzato per prezzo, design, funzionalità, precisione e grado di integrabilità domotica con i maggiori HUB personali.

Abbiamo testato con successo il funzionamento di questo plugin (di cui illustriamo le modalità di integrazione nella presente guida) su hardware Raspberry Pi; altresì non esiste particolare ostacolo nell’implementazione del plugin anche su computer tradizionali con Windows, macOS, Linux: l’importante è che sia presente un’antenna Bluetooth LE compatibile con la libreria open-source “Noble.

Installazione

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

Eseguire il seguente comando – su sistemi unix-based (linux, Raspberry ecc.) da terminale, da sistemi Windows su prompt dei comandi:

sudo npm install -g --unsafe-perm homebridge-mi-hygrothermograph

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

Dopo l’installazione del plugin è necessario installare, in caso non siano già presenti, le librerie accessorie necessarie al suo funzionamento.
Eseguire pertanto il seguente comando:

sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev

In caso di sistemi Windows, rimuovere il prefisso “sudo”.

Configurazione

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

"accessories": [
    {
      "accessory": "Hygrotermograph",
      "name": "Temperatura e umidità"
    }
]

Spiegazione dei campi.

Campo DEFAULT Descrizione
accessory   Richiesto – Dev’essere necessariamente “Hygrotermograph”.
name   Richiesto – Nome dell’accessorio.
address
  Opzionale – Indica l’indirizzo MAC del sensore. Da utilizzare quando sono presenti più sensori.
timeout 15 Opzionale – Numero di minuti oltre i quali un sensore che non risponde venga considerato dalla domotica come “non disponibile”. Impostare 0 per disabilitare la funzionalità (oppure omettere la voce).
humidityName
“Humidity” Opzionale – Nome del sensore dell’umidità presso l’app “Casa”.
temperatureName “Temperature” Opzionale – Nome del sensore di temperatura presso l’app “Casa”.
fakeGatoEnabled false Opzionale – Se riportare o meno informazioni storiche ad uso dell’app Elgato Eve.
mqtt   Opzionale – Topic mqtt presso il quale pubblicare le letture storiche (interessante per un eventuale uso, per esempio, con Node-RED). Spiegato più avanti nella guida.
forceDiscovering
true Opzionale – Forza il discovery del dispositivo dopo un’eventuale perdita di connessione Bluetooth.
forceDiscoveringDelay
2500 Opzionale – Tempo di attesa in millisecondi per l’eventuale discovery automatico dopo un’eventuale perdita di connessione Bluetooth.

La configurazione dell’esempio permette a Homebridge di trovare e collegarsi automaticamente al sensore, senza necessità di indicare puntualmente l’indirizzo MAC del dispositivo.

In caso siano presenti più sensori è invece necessario utilizzare una configurazione analoga a quella che segue:

"accessories": [
    {
      "accessory": "Hygrotermograph",
      "name": "Stanza 1",
      "address": "4c:64:a8:d0:ae:65"
    },
    {
      "accessory": "Hygrotermograph",
      "name": "Stanza 2",
      "address": "2c:34:b3:d4:a1:61"
    }
]

la quale, appunto, elenca puntualmente gli indirizzi MAC dei vari dispositivi.

COME SCOPRIRE GLI INDIRIZZI MAC

Ovviamente per indicare gli indirizzi MAC in configurazione è necessario conoscerli.
In caso si stia utilizzando Raspberry PI (con sistema operativo Raspbian), è semplicemente necessario eseguire il seguente comando:

sudo hcitool lescan

Tale comando visualizza a schermo tutti gli indirizzi MAC rilevati nell’ambiente. Gli indirizzi MAC del termometro Bluetooth di nostro interesse sono quelli etichettati come “MJ_HT_V1“.

Gli utenti Apple macOS possono invece utilizzare tool come Bluetooth Explorer.
Gli utenti Apple iOS possono infine utilizzare l’app (per iPhone/iPad) nRF Connect.

N.b. Gli indirizzi MAC rilevati in questi due ultimi casi (macOS e iOS) viene riportati con un formato del tipo “5C61F8CE-9F0B-4371-B996-5C9AE0E0D14B”.

MQTT

Come suggerito precedentemente, questo plugin presenta anche l’interessante funzionalità di esporre le letture ricevute dal sensore verso topic MQTT da esso pubblicati presso un broker qualunque indicato in configurazione.

Per attivare questa funzionalità è sufficiente aggiungere alla configurazione dell’accessorio/i il seguente blocco:

{
  "mqtt": {
    "url": "127.0.0.1:1883",
    "temperatureTopic": "sensors/temperatura",   
    "humidityTopic": "sensors/umidita",
    "batteryTopic": "sensors/batteria",
    "username": "",
    "password": ""
  }
}

Dove nel campo “url” viene indicato l’ip e porta del nostro broker, nei campi “temperatureTopic“, “humidityTopic e “batteryTopic” rispettivamente i topic da pubblicare contenenti le informazioni relative a temperatura, umidità e stato della batteria del sensore.

Infine, i campi opzionali “username” e “password” permettono di indicare eventuali credenziali d’accesso al broker.

Utilizzo

Gli accessori appaiono su HomeKit come due diversi sensori di temperatura e umidità. Essi possono essere utilizzato con le automazioni tipiche dell’ambiente domotico Apple, specialmente tramite l’app Elgato Eve.

temperatura e umidità presso app "Casa"

Aggiornamento

Per aggiornare il package è sufficiente eseguire il seguente comando:

sudo npm update -g -dev homebridge-mi-hygrothermograph

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


Homebridge IconATTENZIONE: ricorda che sul nostro community FORUM c'è una sezione ad hoc dedica a Homebridge, per qualsiasi dubbio, domanda, informazione nel merito specifico di queste componenti.

Dubbi? Perplessità? Fai un salto sul FORUM o sulla CHAT @DISCORD!
Questa pagina è coperta dalla licenza Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International Licenseil che significa che puoi liberamente condividerlo, senza modificarlo, citando il link della fonte.