1 "log-file": "/var/log/pilight.log" 2 "log-file": "c:/pilight/pilight.log"

Transcript

1 Impostazioni Impostazioni...1 Introduzione...2 Core...2 port...2 standalone...2 pid-file...2 log-file...2 log-level...2 whitelist...3 stats-enable...3 watchdog-enable...3 Percorsi dei moduli...4 action-root...4 function-root...4 hardware-root...4 operator-root...4 protocol-root...4 Webserver...5 webgui-websockets...5 webserver-authentication...5 webserver-cache...5 webserver-enable...5 webserver-http-port...6 webserver-https-port...6 webserver-root...6 webserver-user...6 Firmware...7 firmware-gpio-miso...7 firmware-gpio-mosi...7 firmware-gpio-reset...7 firmware-gpio-sck...7 SMTP...8 smtp-sender...8 smtp-user...8 smtp-password...8 smtp-host...8 smtp-port...9 Varia...9 ntp-servers...9

2 Introduzione Il comportamento e le funzioni di pilight possono essere alterati modificando diverse impostazioni. Tutte le impostazioni sono descritte in questo capitolo raggruppate secondo la loro categoria. Core port 1 "port": 5000 Come impostazione predefinita, pilight utilizza un porta casuale per il suo socket server. Se si desidera una porta fissa utilizzare l'impostazione port. standalone 1 "standalone": 0 All'avvio pilight in primo luogo verifica se ci sono altre istanze in esecuzione all'interno della stessa rete. In caso affermativo, si collegherà alle altre istanze tramite la rete adhoc se già esiste o ne creerà una nuova. Se però non si vuole che pilight si colleghi alla rete adhoc si può forzare l'esecuzione a deamon autonomo impostando standalone a 1. Quando l'esecuzione é in modalità autonoma, il server SSDP è disabilitato. Ciò significa che altri client pilight non saranno in grado di individuarlo utilizzando SSDP. pid-file Linux e *BSD 1 "pid-file": "/var/run/pilight.pid" Il pid-file è usato per memorizzare l'id del processo del daemon. Questa informazione viene usata anche da pilight e costituisce uno dei modi per determinare se il programma sia già in esecuzione o meno. Questa impostazione deve contenere un percorso valido per il pid-file. log-file Linux e *BSD Windows 1 "log-file": "/var/log/pilight.log" 2 "log-file": "c:/pilight/pilight.log" Il log-file è usato da pilight per salvare le varie informazioni raccolte durante l'esecuzione. Queste possono essere utilizzate per il debug di errori o per raccogliere informazioni sulle azioni attivate. Questa impostazione deve contenere un percorso valido per memorizzare il log-file. log-level 1 "log-level": 4 Il log-level indica a pilight quali messaggi deve registrare nel file log. Maggiore è il valore di log-level, più messaggi vengono registrati. Il più alto log-level è 6 e il più basso è 0. Questi diversi log-level corrispondono ai seguenti tipi di messaggio: 0 = emergenza, 1 = allarme, 2 = critico, 3 = errore, 4 = avvertimento, 5 = notifica e 6 = informazioni.

3 whitelist 1 "whitelist": [ "*.*.*.*" ] Tutto il software in grado di utilizzare connessioni socket può comunicare con pilight. Tale software può essere pilight-receive, la WebGUI, o plugin esterni come quelli forniti per esempio da FHEM. Se si desidera limitare i computer della rete che possono connettersi a pilight, si può impostare una whitelist. Questa impostazione deve contenere un elenco di indirizzi IPv4 che sono autorizzati a connettersi con pilight. Tutti gli altri IP saranno bloccati. Se si desidera autorizzare intervalli IPv4, è possibile specificarli utilizzando caratteri jolly. Per esempio, se vogliamo permettere la connessione a tutti gli indirizzi IP che vanno da a possiamo aggiungere alla lista l'indirizzo IP *. Se vogliamo permettere la connessione a tutti gli indirizzi IP che vanno da a possiamo aggiungere l'indirizzo IP 10.0.*.*. Ogni voce whitelist deve contenere un indirizzo IPv4 valido con o senza caratteri jolly. stats-enable 1 "stats-enable": 1 pilight controlla le risorse della CPU e della RAM. Queste informazioni possono essere condivise con clients esterni e sono trasmesse per default tramite connessioni websockets. Se si desidera disabilitare la visualizzazione delle statistiche CPU e RAM e/o si vuole disattivare la comunicazione di queste statistiche sulla connessione websocket bisogna impostare stats-enable a 0. Questa impostazione può essere 0 o 1. watchdog-enable 1 "watchdog-enable": 1 pilight controlla le risorse della CPU e della RAM. Queste informazioni vengono utilizzate per spegnere o terminare pilight quando utilizza troppa CPU o RAM. Se si desidera disattivare questa funzione watchdog e quindi l'interruzione automatica di pilight quando è necessario, impostare watchdog-enable a 0. Questa impostazione può essere 0 o 1.

4 Percorsi dei moduli pilight ha la possibilità di caricare diversi moduli esterni per migliorare la sua funzionalità. Questi moduli sono singoli files e devono essere collocati in cartelle definite. Tuttavia il percorso di queste cartelle può essere cambiato modificando le seguenti impostazioni. Non vi è generalmente alcun motivo per caricare moduli esterni. L'ultima versione di pilight contiene sempre i più recenti protocolli, driver hardware, operatori degli eventi, funzioni e azioni. action-root Linux e *BSD 1 "action-root": "/usr/local/lib/pilight/action" Le azioni evento vengono caricate dalla cartella action-root. L'impostazione action-root deve contenere un percorso valido. function-root Linux e *BSD 1 "function-root": "/usr/local/lib/pilight/function" Le funzioni di evento pilight vengono caricate dalla cartella function-root. L'impostazione function-root deve contenere un percorso valido. hardware-root Linux e *BSD 1 "hardware-root": "/usr/local/lib/pilight/hardware" I driver hardware esterni vengono caricati dalla cartella hardware-root. L'impostazione hardware-root deve contenere un percorso valido. operator-root Linux e *BSD 1 "operator-root": "/usr/local/lib/pilight/operator" Gli operatori evento vengono caricati dalla cartella operators-root. L'impostazione operators-root deve contenere un percorso valido. protocol-root Linux e *BSD 1 "protocol-root": "/usr/local/lib/pilight/protocol" I protocolli pilight esterni vengono caricati dalla cartella protocol-root. L'impostazione protocol-root deve contenere un percorso valido.

5 Webserver Le seguenti impostazioni cambiano il modo in cui il webserver integrato serve la WebGUI interna. Il webserver può anche essere disabilitato completamente. webgui-websockets 1 "webgui-websockets": 1 Per default, la WebGUI comunica con pilight utilizzando WebSockets. Si tratta di una tecnica relativamente nuova che ci permette di ricevere tutti i cambiamenti da pilight invece di dover utilizzare il polling per le modifiche. Il problema è che alcuni vecchi dispositivi e browser non supportano WebSockets, ma supportano la tecnica del polling. Quindi, per disattivare i WebSockets e utilizzare il polling impostare webgui-websockets a 0. Questa impostazione può essere 0 o 1. webserver-authentication 1 "webserver-authentication": [ "username", "password" ] pilight può essere controllato da chiunque abbia accesso alla WebGUI. Se si desidera impedirlo, è possibile proteggere la WebGUI con un nome utente e una password. Il nome utente deve essere in formato testo, la password è criptata SHA256. Utilizzare pilight-sha256 per creare la password cifrata. Gli strumenti di crittografia SHA256 normali non funzionano perché pilight esegue l'hashing della password diverse migliaia volte. pi@pilight ~# pilight-sha256 -p admin 4f32102debed8dabd87e88cf84c752ccb23a74b29f90b42edde05cbc7be41f80 Quindi se vogliamo usare un utente con nome user e la password admin l'impostazione è la seguente: 1 [ "user", "4f32102debed8dabd87e88cf84c752ccb23a74b29f90b42edde05cbc7be41f80" ] webserver-cache 1 "webserver-cache": 1 pilight ha la capacità di memorizzare nella cache tutti i file utilizzati per la WebGUI. Questo riduce la quantità di letture fatte dalla scheda SD su dispositivi come Raspberry Pi e Hummingboard, e rende più veloce in caricamento della WebGUI da dispositivi con una memoria interna lenta come i router. Questa impostazione può essere 0 o 1. webserver-enable 1 "webserver-enable": 1 Il server web pilight può essere disattivato completamente. Questo potrebbe essere utile se non si desidera utilizzare la WebGUI oppure si vuole usare una propria implementazione webserver. Questa impostazione può essere 0 o 1.

6 webserver-http-port 1 "webserver-http-port": 5001 Per default il webserver viene eseguito sulla porta non standard Questo per evitare interferenze con altri webserver in esecuzione sulla porta HTTP predefinita 80. Se si desidera eseguire il webserver sulla porta 80 o qualsiasi altra porta, si può cambiare questa impostazione. La porta specificata deve essere una porta valida e non utilizzata. webserver-https-port non supportato per default 1 "webserver-https-port": 5002 Il webserver non permette connessioni protette per default. Attualmente l'unico modo per avere il supporto HTTPS è compilare manualmente pilight. Il webserver sicuro viene eseguito per default sulla porta non standard Questo viene fatto per evitare interferenze con altri webserver in esecuzione sulla porta HTTPS di default 443. Se si desidera eseguire il webserver sicuro sulla porta 443 o qualsiasi altra porta si può cambiare questa impostazione. La porta specificata deve essere una porta valida e non utilizzata. webserver-root 1 "webserver-root": "/usr/local/share/pilight/" webserver-root indica a pilight dove deve cercare tutti i file che devono essere serviti dal webserver. Questa impostazione deve contenere un percorso valido. webserver-user Linux *BSD 1 "webserver-user": "www-root" 2 "webserver-user": "www" Il server web funziona per default come utente non-root. Questo per evitare l'esecuzione di codice dannoso. Se si vuole forzare l'esecuzione come utente root o come qualsiasi altro utente del sistema è possibile modificare questa impostazione. Questa impostazione deve contenere un utente di sistema valido.

7 Firmware pilight offre pilight-flash, un semplice programma per il flash del firmware di diversi microcontrollori tramite bitbanging o tramite USB. Per programmare microcontrollori con bitbanging sul GPIO sono necessari quattro GPIO. Questi GPIO sono per default configurati per l'utilizzo su un Raspberry Pi. I pin GPIO possono tuttavia essere modificati a seconda del dispositivo che si desidera utilizzare. Ogni pin è denominato secondo le specifiche SPI, tuttavia si possono utilizzare GPIO qualsiasi perché in realtà non viene utilizzato SPI per comunicare con il microcontrollore. Si utilizzano le denominazioni SPI MISO, MOSI, Reset e SCK solo per distinguere i vari pin. Per individuare i GPIO validi per la vostra piattaforma, si prega di fare riferimento alla documentazione firmware-gpio-miso Linux e *BSD 1 "firmware-gpio-miso": 13 Questa impostazione definisce il pin GPIO da utilizzare come MISO. Qualsiasi GPIO valido per la piattaforma può essere utilizzato. firmware-gpio-mosi Linux e *BSD 1 "firmware-gpio-mosi": 12 Questa impostazione definisce il pin GPIO da utilizzare come MOSI. Qualsiasi GPIO valido per la piattaforma può essere utilizzato. firmware-gpio-reset Linux e *BSD 1 "firmware-gpio-reset": 10 Questa impostazione definisce il pin GPIO da utilizzare come Reset. Qualsiasi GPIO valido per la piattaforma può essere utilizzato. firmware-gpio-sck Linux e *BSD 1 "firmware-gpio-sck": 14 Questa impostazione definisce il pin GPIO da utilizzare come SCK. Qualsiasi GPIO valido per la piattaforma può essere utilizzato.

8 SMTP pilight ha la capacità di comunicare con diversi tipi di server di posta. Questo offre a pilight la possibilità di usare per esempio azioni all'interno di regole eventi, in modo da inviare messaggi nel caso di un determinato evento. La maggior parte degli utenti hanno un account fornito dal loro provider di hosting oppure un account gratuito come Gmail. Per esempio nel caso di un account gmail (inesistente) con nome pilight@gmail.com e password foobar, le impostazioni SMTP devono essere configurate in questo modo: 1 "smtp-sender": "pilight@gmail.com", 2 "smtp-host": "smtp.gmail.com", 3 "smtp-port": 465, 4 "smtp-user": "pilight@gmail.com", 5 "smtp-password": "foobar" smtp-sender 1 "smtp-sender": "...@...com" smtp-sender richiede un indirizzo valido. Questo indirizzo è usato per indicare al destinatario l'indirizzo dal quale il messaggio è stato inviato. smtp-user 1 "smtp-user": "...@...com" smtp-user richiede un indirizzo valido. Questo indirizzo viene utilizzato per convalidare i dati dell'account al provider di posta elettronica. smtp-password 1 "smtp-password": "..." smtp-password viene utilizzato assieme all'impostazione smtp-user per la convalida presso il provider di posta elettronica. La password deve essere perciò una password valida per l'account in questione. smtp-host 1 "smtp-host": "smtp.foo.com" L'impostazione smtp-host deve contenere un server host di posta elettronica valido. Normalmente, il nome host è simile al nome del provider.

9 smtp-port 1 "smtp-host": "smtp.foo.com" smtp-port deve indicare una porta del server SMTP valida. Questa può essere 25, 465 o 587. Quando si utilizza la porta 465 pilight comunicherà tramite una connessione protetta, quando si utilizzano le porte 25 o 587 dipenderà dal server come verrà configurata la connessione. Varia ntp-servers 1 "ntp-servers": [ "eu.pool.ntp.org", "uk.pool.ntp.org" ] Una caratteristica importante di qualsiasi installazione di automazione è la possibilità di attivare azioni basate sul tempo. Questi eventi si basano su una data e un'ora corrette. I problemi si verificano quando l'ora di sistema non è impostata sull'ora corretta (per il nostro fuso orario). Questo può accadere in sistemi come il Raspberry Pi, che non dispongono di un RTC che consente di mantenere l'ora e la data quando è spento. Per superare questo problema pilight ha la capacità di recuperare l'ora corretta sincronizzandosi con i server NTP. È possibile scegliere qualsiasi server da Alla lista NTP-server può essere aggiunto un qualsiasi numero di server. pilight cercherà dapprima di eseguire la sincronizzazione con il primo server. Se fallisce proverà con il secondo e così via. Questo processo continuerà fino a quando sarà pervenuta una risposta valida.