Scopi della guida:
Concetti affrontati:
|
Componenti software utilizzate:
Prerequisiti:
Dispositivi fisici utilizzati:
|
GUIDA maggiormente indicatA per:
|
|
NOTE E DISCLAIMER
|
|
Abstract
“homebridge-airnow” è un plugin nato per dotare la propria domotica personale basata su Homebridge di uno o più sensori virtuali di qualità dell’aria. Tale sensore virtuale attinge i dati da due siti web i quali collezionano i dati di inquinamento della migliaia di centraline di rilevazione presenti sul globo terrestre.
Sarà quindi sufficiente individuare la centralina più vicina al nostro ambiente domotico, appuntarsi le coordinate (vedremo nell’articolo come) e configurare tale dato nel file di configurazione di Homebridge.
Ovviamente, tale rilevamento sarà da considerasi a campione e non puntuale.
Installazione
L’installazione, come tutti i plugin – è semplicissima.
Eseguire il seguente comando – su sistemi unix-based (linux, Raspberry ecc.) da terminale, da sistemi windows su prompt dei comandi:
npm install -g homebridge-airnow
e attendere il termine della procedura.
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
Configurazione
La configurazione del plugin prevede l’aggiunta al file di configurazione di Homebridge di uno o più accessori così configurati:
"accessories": [
{
"accessory": "airnow",
"name": "AirNow",
"provider": "airnow",
"airnow_api": "XXXXXX",
"zipcode": "02860",
"distance": "25",
"aqicn_api": "XXXXXX",
"aqicn_city": "@245",
"polling": "30"
}
]
Spiegazione dei campi.
| Campo | Descrizione |
|---|---|
| accessory | Richiesto – Dev’essere necessariamente “airnow” (tutto minuscolo). |
| name | Richiesto – Nome dell’accessorio |
| provider | Richiesto – Nome della sorgente dati, la quale può essere: airnow, aqicn. Il default è airnow. |
| airnow_api | Opzionale – Richiesto per AirNow.gov. Indica LA TUA CHIAVE API fornita tramite la registrazione e la richiesta sul sito. AirNow censisce solo le centraline degli Stati Uniti. |
| zipcode | Opzionale – Richiesto e necessario per AirNow. Si tratta CAP dell’area geografica censita. |
| distance | Opzionale – Richiesto per AirNow – Il raggio di azione della centralina. Il default è 25 miglia. |
| aqicn_api | Opzionale – Richiesto per Aqicn.org. Indica LA TUA CHIAVE API fornita tramite la registrazione e la richiesta sul sito. Aqicn censisce tutto il mondo, Europa inclusa. |
| aqicn_city | Opzionale – Usato solo da Aqicn.org. Serve a indicare il codice della centralina specifica dal quale si vuole attingere, ricavato da http://aqicn.org/city/all. È possibile alternativamente indicare “here”, il quale utilizzerà la geolocalizzazione ottenuta tramite l’IP dell’installazione Homebridge e sceglierà la centralina più vicina.
Il codice @code di aqicn_city dell’esempio a seguire è di Reseda, a Los Angeles, è @245. Basta posizionarsi col mouse sul nome della città/centralina e visualizzare, in basso a sinistra nel browser, il numero del codice.
|
| polling | Opzionale – Intervallo di censimento, in minuti. Il default è 0, ovvero spento, nessun censimento automatico. Il valore consigliato è 30. |
Utilizzo
L’accessorio appare su HomeKit come un sensore di qualità dell’aria. Può essere utilizzato con le automazioni tipiche dell’ambiente domotico Apple.
Aggiornamento
Per aggiornare il package è sufficiente eseguire il seguente comando:
sudo npm update -g -dev homebridge-airnow
avendo cura, precedentemente, di aver fermato eventuali esecuzioni di Homebridge in corso.
| Questa pagina è redatta, manutenuta e aggiornata dallo staff di inDomus, un gruppo di persone molto diverse tra loro che trovi, per domande e supporto, sul forum e sulla chat del sito. Alcuni link sono taggati in qualità di affiliati Amazon e riceviamo un compenso dagli acquisti idonei, utile al sostenimento del sito, ma le nostre recensioni sono tutte indipendenti e non sponsorizzate. Se ti sei perso, a tua disposizione c'è la mappa. |