In questa guida vedremo come installare l'accesso web al nostro server HomeBridge che ci permetterà di monitorare i parametri di funzionamento del server, gestire il backup e configurare i nostri plugin.

Installazione

Il commando per installare il plugin è:

sudo npm install -g --unsafe-perm homebridge-config-ui-x

Installare il pacchetto con sudo ed usare --unsafe-perm flag.

In caso di errore di installazione procedere rimuovendo il plugin e reinstallandolo con i seguenti comandi:

sudo npm uninstall -g homebridge-config-ui-x 

quindi, 

sudo npm install -g --unsafe-perm homebridge-config-ui-x

Una volta installato e configurato il plugin il server HomeBridge l’interfaccia sarà accessibile digitando nel browser  http://INDIRIZZO_IP_RASPBERRY:8080.

Di default username e password per l'accesso è admin.

Configurazione del file json da aggiungere al file config.json:

"platforms": [    

     {      

          "platform": "config",      

          "name": "Config",      

          "port": 8080,      

          "sudo": true,     

          "theme": "orange"    

    }

]

Il plugin può essere configurato con alcune impostazioni opzionali.

Ne vediamo solo alcune.

Altre le vedremo in future guide quando implementeremo altre funzionalità.

LOG

Homebridge-Config UI X consente di visualizzare I logs di processo di HomeBridge.

I logs possono essere caricati da file o da comando.

Vedremo per adesso quelli da comando consultabili se abbiamo attiva l’opzione di avvio automatico di HomeBridge con systemd.

Di seguito come dovrà essere modificata la configurazione.

"platforms": [    

     {      "platform": "config",      

             "name": "Config",      

             "port": 8080,     

             "sudo": true,     

             "theme": "orange",      

             "restart": "sudo -n systemctl restart homebridge",      

                 "log": {       

                 "method": "systemd",        

                 "service": "homebridge"      

        }    

      }

]

Per consentire il funzionamento del plugin, HomeBridge dovrà essere avviato in "insecure mode" con il seguente comando:

homebridge -I

Se Homebridge è stato configurato per l’avvio con systemd allora si dovrà abilitare l’insecure mode aggiungendo -I alle variabili  HOMEBRIDGE_OPTS nel file/etc/default/homebridge.

HOMEBRIDGE_OPTS=-U /var/lib/homebridge -I

Se la funzione di avvio automatico non è attiva, non sarà necessario inserirla nella configurazione ne modificare il file sopra indicato.

ControlloAccessori

Il plugin può vedere e controllare alcuni tipi di accessori installazti su HomeBridge e possono essere visualizzati sul proprio browser.

L’opzione è funzionante solo quando Homebridge funziona in insecure mode.

Gli accessori controllabili appariranno nella pagina.

FUNZIONI DEL PLUGIN

Stato

Questa finestra mostra i servizi attivi ed il PIN per HomeKit.

Log

Questa finestra mostra il log di sistema. Molto utile per la diagnosi  problemi.

Plugin

Questa finestra permette la gestione completa dei plugin.

Oltre a mostrare i plugin installati, consente di installare di nuovi.

Si possono inoltre disinstallare i plugin inutilizzati o aggiornare ad una versione più recente.

Durante l’installazione, rimozione o upgrade dei plugin il browser mostrerà eventuali problematiche riscontrate.

Configurazione

Questa finestra permette si settare HomeBridge e le proprie piattaforme ed accessori.