Manuale interfaccia Web

1.1. Riguardo questo documento

Il presente manuale è stato realizzato per spiegare in dettaglio tutte le funzionalità di WE111, partendo dalle basi fino alle operazioni più complesse.

Questo manuale descrive le funzionalità implementate nella versione software 4.0.0 rilasciata a maggio 2022. Si prega di verificare che la versione del software di WE111 sia allineata con questo manuale, in quanto alcune funzionalità potrebbero differire tra le versioni. La versione del software è mostrata nella pagina System → Info. La versione del software è visualizzata inoltre nel pannello di stato posto a destra, sempre visibile nell’interfaccia web del WE111.

Se questo manuale non copre correttamente un dato argomento, non esitate a contattare il supporto tecnico Nethix per ulteriori informazioni:

Email: support@nethix.com

Telefono: +39 0423 770750

Sito Web: nethix.com

1.2. Panoramica

WE111 è un mini modulo IoT facile da usare fornito di interfaccia Web integrata attraverso la quale può essere gestita ogni singola funzionalità del sistema. Permette di leggere, monitorare e controllare i segnali provenienti da macchinari/sensori ad esso collegati, sfruttando l’I/O presente a bordo del dispositivo (1 ingresso configurabile ed un uscita digitale a relè) ed il protocollo MQTT, tramite il quale il dispositivo può essere messo in comunicazione con qualunque apparecchio compatibile.

Il dispositivo gestisce tutti i segnali acquisiti (indipendentemente dal metodo utilizzato per leggerne il valore) sotto forma di variabili, che rappresentano quindi uno degli elementi cardini del sistema. Una volta definita una variabile, sarà possibile andare a creare condizioni di allarme (Eventi/Azioni) sul superamento soglia, inviare i valori delle variabili ad una o più piattaforme esterne e poter accedere al loro stato/valore in molteplici modi.

La programmazione del dispositivo e delle sue logiche di funzionamento avviene attraverso l’interfaccia Web integrata, raggiungibile sia da locale che da remoto. Non sono quindi richiesti software/driver aggiuntivi.

1.3. Accesso all’interfaccia Web

Per iniziare ad utilizzare il dispositivo sarà innanzitutto necessario accedere all’interfaccia Web integrata (tramite un comune browser), consultare la guida rapida per ulteriori informazioni a riguardo.

Una volta effettuato il login, l’interfaccia si presenterà come da seguente immagine:

Di seguito la spiegazione dei vari elementi che la compongono:

• 1: Il nome del dispositivo. Può essere cambiato in seguito dalla pagina Configuration → General setup → System.
• 2: Il nome dell’utente che ha effettuato l’accesso.
• 3: Icone di sistema. Nell’ordine, da sinistra a destra: accesso alla documentazione online, logout dall’interfaccia Web, riavvio/spegnimento del dispositivo.
• 4: Logo Nethix. Può essere modificato in seguito inserendo quello della propria azienda (da Configuration → General setup → Web Interface).
• 5: Menu dal quale selezionare la pagina a cui si intende accedere.
• 6: Corpo centrale della pagina. Verranno visualizzate informazioni diverse a seconda della pagina selezionata.
• 7: Pannello di stato relativo alla connettività. Riassume lo stato dei servizi che consentono al dispositivo di interfacciarsi con l’esterno.
• 8: Pannello di stato relativo alle informazioni di sistema. Riporta il numero della versione software attualmente caricata nel WE111, il tempo di funzionamento del dispositivo dall’ultimo riavvio/ri-accensione e la data ed ora correnti.
• 9: Footer della pagina. Può essere modificato accedendo alla pagina Configuration → General setup → Web Interface.

2.1. Generic Settings

Esistono molteplici tipologie di variabili, per ciascuna delle quali i parametri possono essere diversi. Solo la sezione Generic Settings è valida per qualsiasi tipo di variabile. Questa sezione è formata dai seguenti campi:

• Name: Nome che si intende assegnare alla variabile. Sono supportati tutti i caratteri alfanumerici ed il carattere “_”.
• Type: Permette di selezionare il tipo di variabile. Per ogni tipo di variabile i parametri da impostare saranno diversi, vedere il capitolo 2.2. Type.
• Variable status: Abilita/disabilita la variabile.
• Cloud sending: Permette di abilitare/disabilitare l’invio del valore della variabile ad un portale/server esterno. Per ulteriori informazioni sull’invio dati, consultare l’apposita sezione 6. Invio dati.
• Non-volatile value: Permette di salvare il valore della variabile ogni X minuti ed ogni volta che il dispositivo viene riavviato o spento via software. Lasciando impostato il valore 0, lo stato della variabile non verrà ripristinato dopo un riavvio/spegnimento.
• MQTT mode: Permette di scegliere il modo in cui la variabile dovrà interfacciarsi con un broker MQTT (consultare la sezione 6.4. MQTT/S per ulteriori informazioni sull’utilizzo di questa funzionalità).

2.2. Type

Le tipologie di variabili che si possono definire sono:

• Analog input: Associata all’ingresso presente in scheda e selezionabile solo se configurato come ingresso analogico. Ulteriori informazioni si trovano al paragrafo 2.3. Variabile Analog Input (AI).
• Digital input: Associata all’ingresso presente in scheda e selezionabile solo se configurato come ingresso digitale. Ulteriori informazioni si trovano al paragrafo 2.4. Variabile Digital Input (DI).
• Digital output: Associata all’uscita digitale (relè) di WE111. Ulteriori informazioni si trovano al paragrafo 2.5. Variabile Digital Output (DO).
• Virtual: Sono variabili virtuali che possono essere create per combinare allarmi, elaborare formule, riportare lo state delle variabili di sistema e altro. Ulteriori informazioni si trovano al paragrafo 2.6. Variabili Virtuali.

2.3. Variabile Analog Input (AI)

Per creare una variabile di tipo AI, occorre innanzitutto configurare l’ingresso nel modo opportuno (vedere 11.1. Configurazione ingresso). Una volta configurato l’ingresso come Analog Input, accedere alla pagina Configuration → Variables. Cliccare quindi il tasto New.

Selezionare Analog input alla voce Type. Nella sezione Generic Settings ci sono le impostazioni comuni per tutti i tipi di variabili. Per la descrizione di tutti i campi facenti parte della sezione, consultare 2.1. Generic Settings.

Passiamo alla sezione nominata Analog Input: Specific Settings.

Il campo Mode permette di impostare il tipo di ingresso analogico selezionando una delle seguenti opzioni: 0-5V, 0-20mA, 4-20mA o NTC. Si dovrà poi specificare un’unità di misura (campo Measurement unit) che verrà visualizzata su eventuali grafici e su Status -> Variables. Tramite i campi Minimum value e Maximum value, si potrà applicare una scalatura alla variabile. Il minimo valore di tensione o corrente verrà associato al valore impostato come Minimum value ed analogamente avverrà per il valore massimo.

ESEMPIO: avendo una sonda di temperatura controllata in tensione, il cui valore minimo sia -20°C e il cui massimo sia 30°C a cui corrispondano rispettivamente 0V e 5V, è possibile configurare il minimo della variabile a -20, il massimo a 30 e visualizzare direttamente la temperatura in gradi. Infine, tramite il campo Decimals sarà possibile specificare il numero di decimali da visualizzare.

Il valore in ingresso viene costantemente controllato da WE111, permettendo quindi un rapido riscontro di eventuali soglie programmate.

2.4. Variabile Digital Input (DI)

Per creare una variabile di tipo DI, occorre innanzitutto configurare l’ingresso nel modo opportuno (vedere 11.1. Configurazione ingresso). Una volta configurato l’ingresso come Digital Input, accedere alla pagina Configuration → Variables. Cliccare quindi il tasto New.

Selezionare Digital Input alla voce Type. Nella sezione Generic Settings ci sono le impostazioni comuni per tutti i tipi di variabili. Per la descrizione di tutti i campi facenti parte della sezione, consultare 2.1. Generic Settings.

Passiamo alla sezione nominata Digital Input: Specific Settings.

Scegliere il modo di funzionamento dal campo Input mode. Le possibili scelte sono:

• Normal
• Counter
• Flow measurement
• Time counter

A seconda della scelta che verrà effettuata, i campi successivi cambieranno di significato.

2.4.1. Normal

Una variabile di tipo DI → Normal è una variabile che consente di visualizzare lo stato del contatto digitale. Sarà quindi possibile definire degli eventi/azioni legati al cambiamento di fronte (da aperto a chiuso e viceversa).

Un ingresso digitale definito come Normal può essere aperto o chiuso. Grazie ai campi Open label e Close label è possibile associare una stringa che verrà visualizzata nella pagina Status → Variables, al fine di rendere immediato per l’utente comprendere in che stato si trovi l’ingresso in questione. Per WE111, l’ingresso è da considerarsi chiuso quando viene ponticellato verso GND, aperto quando invece non vi è continuità tra l’ingresso e GND. L’unico ulteriore campo da configurare sarà Inverted led. Questa impostazione va ad influire sulla visualizzazione della variabile nella pagina Status → Variables. Se l’opzione resta disabilitata, lo stato aperto dell’ingresso verrà associato ad un pallino grigio mentre lo stato chiuso ad uno verde. Se si abilita l’opzione, il funzionamento sarà l’inverso. Per approfondimenti vedere l’apposita sezione 5.1. Variables status.

Note

Nella definizione di eventuali eventi/allarmi, lo stato chiuso dell’ingresso digitale corrisponde al valore 1, lo stato aperto al valore 0.

2.4.2. Counter

Una variabile di tipo DI → Counter è una variabile che consente di contare gli impulsi su in ingresso digitale.

Il primo campo da compilare è Count start ovvero il punto di partenza del contatore. Questo valore verrà preso in considerazione solo la prima volta, nel caso in cui quindi il contatore venisse resettato, ripartirebbe a contare da 0.

• Counter end rappresenta invece il limite massimo da raggiungere per resettare il contatore. Lasciando questo campo a 0, il contatore continuerà ad incrementare senza mai azzerarsi.
• Count increment è invece l’unita di incremento del contatore ad ogni impulso. Ad ogni impulso rilevato dal dispositivo, al valore corrente verrà quindi aggiunta la quantità specificata in questo campo.
• Measurement unit è invece l’unità di misura assegnata al contatore. Verrà visualizzata nei grafici e nella pagina Status → Variables.

L’ultima impostazione da dare è l’Edge trigger, ovvero il fronte da considerare come impulso:

• Falling edge: Il contatore incrementa quando l’ingresso passa da chiuso ad aperto.
• Rising edge: Il contatore incrementa quando l’ingresso passa da aperto a chiuso.
• Rising and falling edge: Il contatore incrementa ad ogni cambiamento di stato dell’ingresso.

2.4.3. Flow measurement

Una variabile di tipo DI → Flow measurement è una variabile che consente di calcolare, ad esempio, la portata di un flusso.

Nel campo Timeout va scritto l’intervallo di tempo massimo (in secondi) tra la ricezione di un impulso e l’altro. Una volta passato il tempo impostato, la variabile verrà azzerata. Impostare un timeout può rendersi utile nel caso in cui, ad esempio, il flusso dovesse per qualche motivo cessare. Senza impostare un timeout, il valore della variabile rimarrebbe infatti quello dell’ultimo impulso ricevuto, dando un’informazione errata a chi dovesse richiederne lo stato, e generando, potenzialmente, dei log non coerenti.

Nel campo Volume va invece impostata l’unità campione che si vuole associare ad un impulso.

Measurement unit permette di impostare un’unità di misura per questa variabile, in Edge trigger invece si potrà selezionare quale fronte considerare come impulso:

• Falling edge se si intende considerare il passaggio da chiuso ad aperto.
• Rising edge se si intende considerare il passaggio da aperto a chiuso.
• Rising and falling edge se si intendono considerare entrambi i fronti.

ESEMPIO:

Supponendo di impostare il timeout a “600” (secondi), l’Edge trigger come Rising edge, l’unità di misura a L/s (litri al secondo) ed il volume a 100, si avrà:

• Ingresso passa da aperto a chiuso, WE111 comincia a contare il tempo.
• Ingresso passa da chiuso ad aperto.
• Ingresso passa da aperto a chiuso dopo 20 secondi.
• WE111 divide il volume campione (100) per il tempo passato (20 secondi) e visualizzerà quindi 5 L/s.
• L’ingresso non cambia più il suo stato per almeno 600 secondi.
• WE111 azzera la variabile e attende eventuali nuovi impulsi prima di ricominciare a contare.

2.4.4. Time counter

Una variabile di tipo DI → Time counter è una variabile che permette di contare il tempo (in secondi) di chiusura/apertura di un contatto, applicazione utile, ad esempio, nel caso in cui si intenda totalizzare il tempo di funzionamento di un macchinario.

Dopo aver selezionato l’Edge trigger da considerare, ricordando che Falling edge è il cambiamento da chiuso ad aperto, Rising edge il contrario e Rising and falling edge entrambi, si dovrà selezionare il tipo di contatore. Le possibilità sono:

• Permanent: dopo aver avviato il conteggio, WE111 continuerà ad incrementare il valore ad ogni secondo, finché non sarà l’utente ad azzerarlo.
• Stop on opposite edge: il conteggio inizierà quando ci sarà un cambiamento di fronte compatibile con la scelta fatta in Edge trigger, si stopperà quando si raggiungerà il fronte opposto, e riprenderà quando raggiungerà il fronte selezionato.
• Reset on opposite edge: il conteggio verrà azzerato al raggiungimento del fronte opposto a quello selezionato, e ripartirà quindi da 0 quando raggiungerà nuovamente il fronte impostato in Edge trigger.

2.5. Variabile Digital Output (DO)

Per creare una variabile di tipo DO, associata quindi all’uscita digitale presente nel dispositivo, occorre innanzitutto accedere alla pagina Configuration → Variables. Cliccando quindi il tasto New, si passa alla pagina in cui è possibile configurare la variabile.

Selezionare quindi Digital Output alla voce Type.

Nella sezione Generic Settings ci sono le impostazioni comuni per tutti i tipi di variabili. Per la descrizione di tutti i campi facenti parte della sezione, consultare 2.1. Generic Settings.

Passiamo alla sezione nominata Digital Output: Specific Settings, dove verrà chiesto di impostare il modo di funzionamento nel campo Output mode. Le opzioni disponibili sono:

• Normally open: Funzionamento normalmente aperto. Open label corrisponderà allo stato aperto del contatto. Close label invece, chiuderà il contatto.
• Normally close: Funzionamento normalmente chiuso. Open label corrisponderà allo stato aperto del contatto. Close label invece, chiuderà il contatto.
• Pulse open: Funzionamento in modalità impulsiva. Open label corrisponderà allo stato aperto del contatto. Close label invece, chiuderà il contatto. Se l’uscita viene chiusa, rimane in questo stato per un numero di secondi pari a quelli impostati nel campo Pulse duration per poi tornare automaticamente allo stato aperto.
• Pulse closed: Funzionamento in modalità impulsiva. Open label corrisponderà allo stato aperto del contatto. Close label invece, chiuderà il contatto. Se l’uscita viene aperta, rimane in questo stato per un numero di secondi pari a quelli impostati nel campo Pulse duration per poi tornare automaticamente allo stato chiuso.

Qualsiasi sia la scelta fatta, nel campo Status change delay (s) vanno impostati i secondi di ritardo prima che l’uscita venga attivata/disattivata in seguito ad uno stimolo.

È importante notare come l’opzione Non-volatile value possa essere combinata all’ Output mode. Se l’opzione è disabilitata, lo stato dell’uscita all’avvio (dopo uno spegnimento o dopo un reboot) dipenderà direttamente dall’ Output mode, e quindi, nel caso di uscita Normally open/Pulse open, il contatto partirà aperto, nel caso di uscita Normally closed/Pulse closed invece, all’avvio il contatto sarà chiuso.

Se l’opzione Non-volatile value è invece abilitata, all’avvio del sistema verrà ripristinato lo stato dell’uscita precedete al riavvio/spegnimento.

Lo stato dell’ uscita digitale può essere modificato associandola ad un evento, con un apposito comando via SMS, Chat, Email, o direttamente da Status → Variables.

2.6. Variabili Virtuali

Le variabili virtuali non sono legate all’I/O del dispositivo e possono essere di vario genere. Lo stato di una variabile virtuale può essere modificato/letto via SMS, Chat, Email, dalla pagina Status -> Variables o se associate ad un evento, ed il loro valore può essere inoltre dato da un espressione matematica. Alcune variabili virtuali permettono di monitorare i parametri del sistema o di modificare da remoto la soglia di intervento di un allarme/evento (ad esempio un setpoint). Altre, infine, possono essere utilizzate per permettere a WE111 di gestire lo stato od il valore proveniente da una misura fatta da un altro dispositivo (Nethix e non, tramite il protocollo MQTT).

Per creare una variabile di tipo Virtual, occorre innanzitutto accedere alla pagina Configuration → Variables. Cliccando quindi il tasto New, si passa alla pagina in cui è possibile configurare la variabile.

Selezionare quindi Virtual alla voce Type.

Nella sezione Generic Settings si trovano le impostazioni comuni per tutti i tipi di variabili. Per la descrizione di tutti i campi facenti parte della sezione, consultare 2.1. Generic Settings.

Passiamo alla sezione nominata Virtual variable: Specific Settings, dove viene data la possibilità di scegliere tra le seguenti tipologie:

• Normal
• Math expression
• Date/time
• System variables

2.6.1. Normal

Selezionando la voce Normal andrà specificata l’unità di misura nel campo Measurement unit ed il numero di decimali da Decimals numbers. Il valore di questa tipologia di variabile potrà essere cambiato manualmente (SMS, Chat, Email o da Status → Variables) e/o automaticamente (tramite l’azione execute command configurabile nella pagina di creazione degli eventi 3.2.4. Azione Execute a Command).

2.6.2. Math expression

Selezionando la voce Math expression oltre a dover specificare l’unità di misura da Measurement unit ed il numero di decimali da Decimals numbers, sarà possibile specificare un’espressione matematica da applicare alla variabile.

Una variabile Virtual → Math expression consente di svolgere calcoli utilizzando costanti o variabili come elementi, e da la possibilità di utilizzare alcune delle più note operazioni matematiche tra cui:

• Addizione (+)
• Sottrazione (-)
• Moltiplicazione (*)
• Divisione (/)
• Elevamento a potenza (^)
• Radice quadrata (sqrt)
• Logaritmo (log)
• Seno (sin)
• Coseno (cos)

oltre a costanti come:

• e (e)
• logaritmo in base 2 di e (log2e)
• logaritmo in base 10 di e (log10e)
• radice quadrata di PI greco (2_sqrtpi)
• radice quadrata di 2 (sqrt)
• radice quadrata di 1/2 (sqrt1_2)

È supportato l’uso di parentesi tonde.

ESEMPIO 1:

“Var1” è il nome di una variabile di qualsiasi tipo (non necessariamente una Virtual) ed il suo valore è 10. Nel campo Math expression potremmo scrivere:

Var1^2

In questo caso, la variabile Virtual assumerebbe valore “100”.

ESEMPIO 2:

Var1 come da esempio precedente, Var2 è un’altra variabile di qualsiasi tipo con valore 15.

Nel campo Math expression potremmo scrivere:

( Var1 * ( Var2 – 10 ) ) / 2

Da cui si otterrebbe: (10 * (15-10)) / 2 → (10*5)/2 → 50 / 2 → 25

Il valore visualizzato dal WE111 sarebbe quindi “25”.

Ad ogni cambiamento di uno dei fattori dell’espressione, il risultato viene ricalcolato immediatamente da WE111.

Una variabile Virtual di tipo Math expression può essere usata come elemento all’interno di un’altra espressione.

2.6.3. Date/time

Selezionando Date/Time la variabile assumerà il valore dei secondi, minuti, ore, giorno del mese, mese, anno, giorno della settimana o giorno dell’anno

Ad esempio selezionando Minutes [0-59] nel campo Date/time mode alle ore 12:35 la variabile assumerà il valore 35.

2.6.4. System variables

Selezionando System variables si potrà specificare l’unità di misura da Measurement unit ed il numero di decimali da Decimals numbers, questo tipo di variabili possono rappresentare:

• GSM CSQ (Indicatore di potenza del segnale dell’operatore telefonico)
• CPU Load (Carico della CPU)
• CPU Speed (Velocità della CPU)
• CPU Temperature (Temperatura della CPU)
• Free Memory (Memoria libera)
• PCB Temperature (Temperatura Circuito Stampato)
• Modem Temperature (Temperatura del Modem)
• V Supply (Tensione di Alimentazione)
• Button (Stato del pulsante, è possibile definire un evento quando viene premuto)

Come per tutte le altre variabili, anche per le variabili di sistema è possibile associare una o più condizione di allarme.

2.7. Bridge tra variabili

WE111 consente di creare bridge tra variabili al fine di replicare il valore o lo stato di una variabile su di un’altra. Supponendo ad esempio di voler leggere il valore dell’ingresso analogico e di replicarlo in una variabile virtuale, le operazioni da fare sarebbero:

• Creare una variabile Analog Input (2.3. Variabile Analog Input (AI)).
• Creare una variabile di tipo Virtual (2.6. Variabili Virtuali).
• Nella pagina di creazione della variabile Analog Input, cliccare il link Advanced.

• Selezionare dal menù Available variables la variabile virtuale creata in precedenza.

In questo modo si otterranno 2 variabili riportanti lo stesso valore. Ad ogni cambiamento di stato/valore della variabile di tipo Analog Input corrisponderà quindi un cambiamento del valore della variabile di tipo virtuale.

3.1. Eventi

Gli eventi permettono a WE111 di accorgersi quando un parametro monitorato raggiunge una soglia d’interesse per l’utente.

Esistono diversi tipi di eventi e per ogni tipo ci sono diversi parametri che permettono di avere una grande flessibilità nel controllo e monitoraggio di un sistema.

Per creare un evento, è sufficiente andare alla pagina Configuration → Events/Actions → Events/Actions e cliccare il tasto New.

Il tasto Delete consente di cancellare uno o più eventi selezionati, con il tasto Update sarà invece possibile apportare eventuali modifiche come abilitazione/disabilitazione di uno o più eventi o il fatto di segnalarli o meno come allarmi ed inviarli ad un portale web. Per poter individuare più rapidamente uno o più eventi, è possibile usare il campo Find che consente di effettuare ricerche per nome.

Andando quindi a creare un evento, dopo aver definito un nome, sarà necessario specificare il tipo di evento tra Variable, Incoming data o Scheduler (vedere 4. Scheduler).

Ci sono alcune opzioni generiche che si possono attivare a seconda della tipologia di evento selezionata: sarà possibile scegliere se abilitare o meno l’evento da Status, se visualizzarlo o meno come allarme dal campo Set as alarm e se inviarlo o meno ad un portale web dal campo Send to portal.

Nel caso in cui si decida di abilitare l’opzione Set as alarm, quando l’evento si verificherà, nella pagina Status → Variables, a fianco al nome delle variabile (precisamente nella colonna Alarm) comparirà una “X” di colore rosso che permetterà di individuare subito un’eventuale condizione critica.

L’opzione Send to portal consente invece di inviare un evento ad un portale web. Quando si verificherà l’evento, WE111 eseguirà la/e azione/i associate ed invierà al portale una stringa contenente il nome dell’evento ed eventuali altre informazioni aggiuntive.

3.1.1. Evento su variabile

Per evento su variabile si intende un evento che si verifica quando una variabile raggiunge un certo valore o un certo stato.

Il comportamento di questo tipo di evento è influenzato dal comportamento delle variabili che gli si andranno ad associare.

Ci si troverà innanzitutto a dover scegliere una variabile dal campo Variable.

Tramite il menu a tendina, sarà possibile scorrere tutte le variabili precedentemente create e selezionare quella su cui si intende programmare un evento.

Il secondo parametro da scegliere è quello legato alla Condition. Le scelte possibili sono una condizione tra EQUAL, NOT EQUAL, GREATER THAN, GREATER OR EQUAL THAN, LESS THAN e LESS OR EQUAL THAN.

Si dovrà ora impostare il valore da considerare come soglia per far scattare l’evento, quindi, anche in base alla variabile selezionata, andrà inserito un valore numerico nel campo Value.

Si potrà impostare un ritardo dal campo Delay. Il valore va espresso in secondi, e la sua utilità è quella di porre un filtro per evitare che un evento scatti subito.

Al fine di eseguire le azioni associate, o comunque di considerare attivo l’evento definito, il valore della variabile (Value) dovrà continuare a soddisfare la condizione definita (Condition) per un tempo non inferiore a Delay.

È inoltre possibile chiedere di ignorare un evento (e le relative azioni associate) trovato attivo in seguito ad uno spegnimento/riavvio del sistema. Per farlo, è sufficiente abilitare l’opzione Skip actions at startup.

3.1.2. Incoming data

Per incoming event si intendono eventi scatenati da input provenienti da fonti esterne:

• SMS
• Email
• Chat

Questa funzionalità da la possibilità di creare comandi personalizzati da poter inviare al dispositivo. I comandi potrebbero essere inviati da utenti o da altri dispositivi.

Dopo aver scelto l’opzione desiderata dal campo Data source, andrà definito il testo del comando personalizzato (da inserire nel campo Message).

Infine, dal campo Users potranno essere scelti gli utenti o i gruppi di utenti abilitati ad inviare il comando in questione.

Le azioni associate ad un evento così definito verranno quindi eseguite alla ricezione del testo riportato nel campo Message, purché inviato da uno degli utenti selezionati.

Note

I comandi devono essere inviati riportando lettere maiuscole e minuscole così come sono state definite in fase di configurazione.

Note

Per consentire ad un utente di inviare comandi al dispositivo, va abilitata la rispettiva voce presente nella pagina di modifica/creazione degli utenti (vedere 7. Utenti).

Note

Nel caso delle Email, il comando da inviare al dispositivo va inserito nell’oggetto, e non nel corpo.

3.2. Azioni

Una volta creato un evento e cliccato Save, comparirà una nuova sezione chiamata Actions con il relativo link Add action.

Cliccando sul suddetto link, si avrà accesso ad una nuova pagina

Da questa nuova pagina è possibile creare un’azione per l’evento appena definito. Le azioni disponibili sono:

• Send Email
• Send Chat
• Send SMS
• Execute a Command
• Send data to cloud
• Reboot
• Poweroff

Tramite i campi Execute action each e Minutes/Hours sarà inoltre possibile richiedere che l’azione venga ripetuta ad intervalli di tempo regolari fino a che l’evento rimane attivo.

Una volta creata un’azione, la si potrà ritrovare nell’elenco posto sotto all’evento. Sarà possibile creare fino a 5 azioni per ogni singolo allarme.

3.2.1. Azione Send Email

Selezionando Send Email, verrà data la possibilità di impostare il testo da inviare nel caso in cui l’evento dovesse verificarsi.

Se esistono già dei messaggi precedentemente utilizzati sarà possibile sceglierli dal campo Message tramite menu a tendina.

Se invece si intende creare un nuovo testo, selezionare Create new message.

Per modificare un messaggio già esistente, basterà accedere alla pagina Configuration → Events/Actions → Messages e selezionare il messaggio che si vuole modificare.

Una volta definito il messaggio, si potrà scegliere a chi inviarlo tra i vari utenti e gruppi disponibili.

Affinché una mail possa essere inviata ad un utente, dopo aver definito l’evento e l’azione che dovrebbero generarla, sono necessari alcuni accorgimenti:

• Connessione ad internet attiva (vedere sezioni 8. Connettività e 10.3. Ping).
• L’utente o gli utenti selezionato/i dovranno essere abilitati a ricevere mail di segnalazione e dovranno aver inoltre specificato un indirizzo email valido (vedere sezione 7. Utenti).
• Il servizio mail dovrà essere opportunamente configurato (vedere sezione 8.3. Email).

Tutti i testi utilizzati nelle varie azioni create, si possono trovare nella pagina Configuration → Events/Actions → Messages.

Da questa pagina, oltre a poter cancellare i messaggi selezionando l’apposita casella e cliccando il tasto Delete, sarà possibile editare uno o più messaggi semplicemente cliccandoci sopra.

Nei messaggi da inviare nel caso in cui si verifichi un certo evento, è possibile richiamare il valore di una o più variabili. Per usufruire di questa possibilità, sarà sufficiente riportare nel testo del messaggio il nome della variabile (rispettando maiuscole e minuscole) preceduto dal carattere $.

ESEMPIO:

Supponiamo di aver creato una variabile di nome Var1 e di volerne richiamare il valore all’interno del messaggio di superamento soglia:

Testo da impostare:

Allarme livello alto. Il livello è di $Var1 metri

Supponiamo inoltre che al momento dell’invio del messaggio la variabile abbia il valore 5.7:

Messaggio che verrà inviato:

Allarme livello alto. Il livello è di 5.7 metri

Da notare infine che all’interno dello stesso messaggio potranno essere richiamati i valori di più variabili.

3.2.2. Azione Send SMS

Selezionando Send SMS, verrà data la possibilità di impostare il testo da inviare nel caso in cui l’evento dovesse verificarsi

Se esistono già dei messaggi precedentemente utilizzati sarà possibile sceglierli dal campo Message tramite menu a tendina.

Se invece si intende creare un nuovo testo, selezionare Create new message.

Per modificare un messaggio già esistente, basterà accedere alla pagina Configuration → Events/Actions → Messages e selezionare il messaggio che si vuole modificare.

Una volta definito il messaggio, si potrà scegliere a chi inviarlo tra i vari utenti e gruppi disponibili.

Affinché un SMS possa essere inviato ad un utente, dopo aver definito l’evento e l’azione che dovrebbero generarlo, sono necessari alcuni accorgimenti:

• Copertura del segnale sufficiente (visibile dal pannello di stato posto sulla destra dell’interfaccia).
• L’utente o gli utenti selezionato/i dovranno essere abilitati a ricevere SMS di segnalazione e dovranno aver inoltre specificato un numero telefonico valido (vedere sezione 7.1. Creare un nuovo utente).
• Il servizio SMS dovrà essere opportunamente configurato (vedere sezione 8.1.1. Connessione dati ed SMS).

Tutti i testi utilizzati nelle varie azioni create, si possono trovare nella pagina Configuration → Events/Actions → Messages.

Da questa pagina, oltre a poter cancellare i messaggi selezionando l’apposita casella e cliccando il tasto Delete, sarà possibile editare uno o più messaggi semplicemente cliccandoci sopra.

Nei messaggi da inviare nel caso in cui si verifichi un certo evento, è possibile richiamare il valore di una o più variabili. Per usufruire di questa possibilità, sarà sufficiente riportare nel testo del messaggio il nome della variabile (rispettando maiuscole e minuscole) preceduto dal carattere $.

ESEMPIO:

Supponiamo di aver creato una variabile di nome Var1 e di volerne richiamare il valore all’interno del messaggio di superamento soglia:

Testo da impostare:

Allarme livello alto. Il livello è di $Var1 metri

Supponiamo inoltre che al momento dell’invio del messaggio la variabile abbia il valore 5.7:

Messaggio che verrà inviato:

Allarme livello alto. Il livello è di 5.7 metri

Da notare infine che all’interno dello stesso messaggio potranno essere richiamati i valori di più variabili.

3.2.3. Azione Send Chat

Selezionando Send Chat, verrà data la possibilità di impostare il testo da inviare nel caso in cui l’evento dovesse verificarsi

Se esistono già dei messaggi precedentemente utilizzati sarà possibile sceglierli dal campo Message tramite menu a tendina.

Se invece si intende creare un nuovo testo, selezionare Create new message.

Per modificare un messaggio già esistente, basterà accedere alla pagina Configuration → Events/Actions → Messages e selezionare il messaggio che si vuole modificare.

Una volta definito il messaggio, si potrà scegliere a chi inviarlo tra i vari utenti e gruppi disponibili.

Affinché il dispositivo possa inviare un messaggio via chat ad un utente, dopo aver definito l’evento e l’azione che dovrebbero generarlo, sono necessari alcuni accorgimenti:

• L’utente o gli utenti selezionato/i dovranno essere abilitati a ricevere messaggi via chat e dovranno aver inoltre specificato un nome chat valido (vedere sezione 7.1. Creare un nuovo utente).
• Il servizio Chat deve essere opportunamente configurato (vedere sezione 8.4. Chat).
• Il dispositivo deve essere connesso alla rete internet (vedere sezioni 8. Connettività e 10.3. Ping).

Tutti i testi utilizzati nelle varie azioni create, si possono trovare nella pagina Configuration → Events/Actions → Messages.

Da questa pagina, oltre a poter cancellare i messaggi selezionando l’apposita casella e cliccando il tasto Delete, sarà possibile editare uno o più messaggi semplicemente cliccandoci sopra.

Nei messaggi da inviare nel caso in cui si verifichi un certo evento, è possibile richiamare il valore di una o più variabili. Per usufruire di questa possibilità, sarà sufficiente riportare nel testo del messaggio il nome della variabile (rispettando maiuscole e minuscole) preceduto dal carattere $.

ESEMPIO:

Supponiamo di aver creato una variabile di nome Var1 e di volerne richiamare il valore all’interno del messaggio di superamento soglia:

Testo da impostare:

Allarme livello alto. Il livello è di $Var1 metri

Supponiamo inoltre che al momento dell’invio del messaggio la variabile abbia il valore 5.7:

Messaggio che verrà inviato:

Allarme livello alto. Il livello è di 5.7 metri

Da notare infine che all’interno dello stesso messaggio potranno essere richiamati i valori di più variabili.

3.2.4. Azione Execute a Command

Selezionando Execute a Command dal campo Type, sarà possibile selezionare una variabile tra quelle presenti nell’elenco sottostante e specificare poi un valore nel campo To.

Così facendo, al verificarsi dell’evento definito, la variabile qui selezionata verrà impostata al valore immesso nel campo To.

Nel menu a tendina Set potrebbero non essere presenti tutte le variabili create. Questo perché il sistema riconosce automaticamente le variabili a cui può essere cambiato il valore:

• Variabili di tipo DO
• Variabili di tipo Virtual

Per ovvi motivi non si troveranno in questo elenco le seguenti variabili:

• Variabili di tipo DI
• Variabili di tipo AI

Tramite un’azione di tipo Execute a Command, sarà possibile creare delle automazioni nel caso in cui si verifichi un certo evento, come ad esempio chiudere il contatto di un uscita nel caso in cui un ingresso analogico dovesse raggiungere una certa soglia.

3.2.5. Azione Send data to cloud

Selezionando Send data to cloud dal campo Type, al verificarsi di un evento verrà inviato al cloud lo stato delle variabili su cui è attiva l’opzione Cloud sending (vedere sezione 2.1. Generic Settings).

Il valore delle variabili verrà immediatamente inviato al cloud selezionato alla pagina Configuration → Cloud → General (vedere sezione 6.3. HTTP/S).

Nel caso in cui fosse attivo l’invio dei dati tramite Email report (vedere sezione 6.6. Email report), verrà generata una nuova riga contenente lo stato delle variabili in quel momento.

In questo caso tuttavia l’invio non sarà immediato, avverrà bensì con le tempistiche impostate dall’utente.

3.2.6. Azione Reboot

Selezionando Reboot dal campo Type, sarà possibile fare in modo che WE111 si riavvii al verificarsi dell’evento associato.

3.2.7. Azione Poweroff

Selezionando Poweroff dal campo Type, sarà possibile fare in modo che WE111 si spenga al verificarsi dell’evento associato.

---

4.1. Execute recurrently

Questa opzione permette di accedere al calendario, in modo tale da poter specificare quando l’azione dovrà essere eseguita.

• Minute: Da questo campo è possibile selezionare il minuto dell’ora (tra 00 e 59) in cui l’azione deve essere eseguita. Si possono selezionare più minuti (anche tutti).
• Hour: Da questo campo sarà possibile selezionare l’ora del giorno in cui eseguire l’azione (tra 0 e 23). Anche in questo caso potranno essere selezionate più opzioni (anche tutte).
• Day of month: Da questo campo sarà possibile selezionare il giorno del mese in cui eseguire l’azione (tra 1 e 31). Si possono selezionare più giorni (anche tutti).
• Day of week: Da questo campo sarà possibile programmare l’esecuzione dell’azione selezionando il giorno della settimana in cui deve essere eseguita. Anche in questo caso sarà possibile selezionare uno o più giorni (anche tutti).
• Month: Il campo Month permette in fine di definire in quale/i mese/i eseguire l’azione, consentendo di selezionare uno o più mesi (anche tutti).

Ad esempio supponiamo di volere eseguire una certa azione ogni 15 minuti:

Dal campo Minute dovranno essere selezionati i numeri 00, 15, 30 e 45.

Supponiamo di voler far si che l’azione non venga eseguita a tutte le ore, ma ad esempio solo tra le 10:00 e le 11:00:

Dal campo Hour dovrà essere selezionato il numero 10.

L’azione non deve essere eseguita tutti i giorni, ma ogni lunedì, e l’ultimo giorno del mese (indipendentemente che cada di lunedì o meno):

Dal campo Day of month selezionare il numero 31, mentre dal campo Day of week selezionare l’opzione Mon (Monday).

Infine, si vuole fare in modo che l’azione venga eseguita solo il primo e l’ultimo mese dell’anno:

Dal campo Month selezionare le opzioni Jan (January) e Dec (December).

Il campo Preview ci da la possibilità di capire quando WE111 dovrà eseguire l’azione. Nel caso del nostro esempio, il campo Preview* dirà:

Execute at 10:00, 10:15, 10:30, 10:45 if the day is 10 or is Monday of January and December

L’azione quindi verrà eseguita ogni lunedì e ogni fine mese di gennaio e febbraio, alle 10:00, 10:15, 10:30 e 10:45.

4.2. Execute every

L’opzione Execute every permette di eseguire un’azione ad intervalli di tempo regolari. Dal campo Unit sarà possibile selezionare l’unità di misura tra Seconds, Minutes, Hours e Days.

• Seconds Inserendo un valore “N” nel campo Value, l’azione verrà eseguita ogni “N” secondi.
• Minutes Inserendo un valore “N” nel campo Value, l’azione verrà eseguita ogni “N” minuti.
• Hours Inserendo un valore “N” nel campo Value, l’azione verrà eseguita ogni “N” ore.
• Days Inserendo un valore “N” nel campo Value, l’azione verrà eseguita ogni “N” giorni.

Ad esempio volendo eseguire una certa azione ad ogni ora:

Dal campo Unit selezionare Hours.

Dal campo Value inserire 1.

Anche in questo caso il campo Preview ci da la possibilità di capire quando verrà eseguita l’azione. Nel caso dell’esempio precedente, il campo Preview dirà:

Execute every hour

L’azione verrà quindi eseguita all’inizio di ogni ora.

4.3. Execute only once

L’opzione Execute only once consente di accedere al calendario per definire quando l’azione dovrà essere eseguita.

Cliccando l’icona posta alla destra del campo Date, si aprirà un calendario che darà la possibilità di selezionare il l’ora, il giorno, il mese e l’anno in cui l’azione dovrà essere eseguita. Una volta eseguita l’azione, l’evento potrà di fatto essere cancellato in quanto verrà eseguito una sola volta.

Se ad esempio si intende eseguire un’azione il 31 Gennaio 2023 alle ore 12:30:00:

Sarà sufficiente scorrere fino alla data desiderata, selezionare il giorno, compilare i campi relativi all’orario e cliccare Ok.

5.1. Variables status

La pagina Status → Variables raccoglie e visualizza tutte le variabili create. Le variabili vengono visualizzate in ordine alfabetico e possono essere eventualmente raggruppate secondo il proprio piacimento.

Per creare uno o più gruppi di variabili è sufficiente andare alla pagina Configuration → Variables → Variables Groups:

Cliccando il tasto New, si accede ad una nuova pagina in cui sono presenti tutte le variabili create.

Si può stabilire con la spunta del campo Hidden, se il gruppo e le variabili al suo interno verranno visualizzati nella pagina Status → Variables, infine si possono scegliere le variabili da includere nel gruppo selezionandole dalla lista Available variables.

Una volta confermato il tutto cliccando il tasto Save, potremo trovare il gruppo appena creato nella pagina Status → Variables.

Dopo aver creato il primo, tutte le variabili che non fanno parte di nessun gruppo verranno incluse nel gruppo Others.

Tornando alla pagina Status → Variables quindi, si troverà una situazione simile a quella dell’immagine qui sotto:

Come si potrà notare, alla destra del nome del gruppo si trovano 2 icone

1. Cancel group: Cliccando questa icona, il gruppo viene eliminato dalla pagina. Tuttavia il gruppo rimane salvato, e tutte le variabili che ne fanno parte continueranno a funzionare.
2. Hide group: Cliccando questa icona, il gruppo viene invece ridotto al solo nome, nascondendo di fatto tutte le variabili. Anche in questo caso il funzionamento delle variabili non viene intaccato.

Sarà possibile visualizzare nuovamente i gruppi nascosti e ripristinare quelli ridotti, cliccando

Posto in fondo alla pagina.

La tabella riportante le variabili è divisa in 7 colonne:

• Name: Nome della variabile.
• Value Valore numerico o mnemonico della variabile.
• Unit: Visualizza l’unità di misura assegnata alla variabile. Per le variabili per cui non esiste l’unità di misura, la colonna rimarrà vuota.
• Set: Permette di impostare un valore (o uno stato) alle variabili scrivibili (DO e Virtual). Nel caso di variabili DO, verranno riportati direttamente gli stati definiti (esempio “aperto” “chiuso”) che si potranno cliccare per cambiare lo stato della variabile. Per le variabili virtual, sarà invece possibile immettere un valore numerico e confermare la scelta cliccando Set.
• Status: Nel caso di variabili DI e DO, verrà mostrata un’icona che darà un immediato riscontro dello stato della variabile: verde o grigia , a seconda dello stato e di come è stata configurata la variabile.
• Alarm: C’è inoltre una colonna che riporta lo stato di allarme di una variabile. L’icona segnala che non ci sono allarmi attivi. L’icona segnala invece la presenza di un evento configurato come allarme.
• Monitor: Per tutte le variabili che dispongono di uno stato leggibile, è possibile cliccare sull’icona posta nella colonna Monitor per visualizzare un grafico in tempo reale in una nuova finestra del browser:

• 1: Nome della variabile selezionata.
• 2: Icona dalla quale sarà possibile cambiare il colore dell’area del grafico.
• 3: Icona dalla quale sarà possibile selezionare la quantità di dati da visualizzare tra: One minute (i dati riferiti all’ultimo minuto), One hour (ultima ora), One day (ultime 24 ore) e Full scale (default, visualizza tutti i dati disponibili da quando la finestra è stata aperta).
• 4: Icona dalla quale sarà possibile scegliere se applicare un filtro ai dati visualizzati andando ad interpolare più punti tra loro.
• 5: Icona dalla quale sarà possibile scegliere di far ripartire l’acquisizione dei dati andando a perdere quelli raccolti fino a quel momento.

5.2. Comandi Set/Get via SMS/Email/Chat

È possibile richiedere o modificare lo stato delle variabili anche utilizzando un’apposita sintassi via SMS, Chat, o Email.

Il fatto che si possa leggere o scrivere un valore, dipende dal tipo di variabile con cui si decide di interagire.

Set NomeVariabile=Valore

Set Var1=5

Set Var1=5 Var2=10 Var3=15

Get NomeVariabile

Get Var1

Get Var1 Var2 Var3

5.3. Comandi personalizzati

Utilizzando la funzione Incoming data è possibile creare dei veri e propri comandi personalizzati, sia per impostare il valore di una o più variabili, che per costruire dei messaggi di stato.

Nel caso si volesse creare un comando personalizzato da poter inviare come testo via SMS, Chat, o Email, sarà sufficiente definire un evento Incoming data (per approfondire vedere 3.1.2. Incoming data) e creare poi delle azioni di tipo Execute a command (vedere 3.2.4. Azione Execute a Command).

In questo modo sarà possibile impostare lo stato di più variabili.

Per creare invece un comando personalizzato in grado di restituire il valore di una o più variabili, sarà possibile utilizzare il carattere $:

Creando un evento di tipo Incoming data, e definendo poi un’azione di tipo Send Email, Send Chat, o Send SMS (vedere 3.2.2. Azione Send SMS, 3.2.3. Azione Send Chat e 3.2.1. Azione Send Email), sarà possibile specificare il messaggio che WE111 dovrà inviare agli utenti selezionati.

6.1. Abilitazione di variabili all’invio dati

Per poter inviare dei dati ad un portale, sarà innanzitutto necessario abilitare la/le variabile/i a questa opzione. Per farlo, dalla pagina di creazione di una variabile, è sufficiente abilitare l’opzione Cloud sending.

Sarà possibile abilitare/disabilitare l’opzione di invio dati al portale anche dalla pagina Configuration → Variables, togliendo/mettendo la spunta dalla colonna Cloud e cliccando poi il tasto Update.

6.2. Configurazione invio dati

Dopo aver scelto quali variabili abilitare all’invio dati, sarà necessario configurare opportunamente tutti i parametri che permettano il corretto funzionamento del sistema, andando alla pagina Configuration → Cloud

Alcune delle informazioni richieste in questa pagina, richiedono una conoscenza minima delle tecniche di invio dati, o il supporto da parte del provider del portale che si intende utilizzare.

Nella prima sezione General, si andranno a definire alcune impostazioni fondamentali come l’abilitazione del servizio e la frequenza di invio.

Senza aver prima definito i parametri richiesti in questa pagina, non sarà possibile proseguire con la configurazione.

• Variables sampling Abilita/disabilita l’invio de valori delle variabili.
• Sampling frequency Permette di selezionare ogni quanto effettuare l’invio.
• Events sampling Permette di abilitare l’invio degli eventi ad un portale.

Una volta abilitato il servizio e deciso il tempo di invio, si potrà decidere di abilitare uno o più metodi e destinazioni tra: HTTP, MQTT e Email report.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Outbox.

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Outbox a Sent. In quest’ultima tabella verranno visualizzate alcune informazioni riguardo alle trasmissioni già inviate da WE111:

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Sent.

6.3. HTTP/S

Dal tab HTTP è possibile attivare l’invio verso il portale offerto da Nethix, o verso un qualunque server esterno.

Selezionando Nethix API dal campo Protocol, ed abilitando l’invio spuntando Enable, si attiverà l’invio verso il portale nethix.co .

Il portale è un servizio offerto da Nethix che tra le altre cose permette di:

• Inviare dati e visualizzare un riassunto di tutti gli impianti.
• Visualizzare il dettaglio relativo ad ogni singolo dispositivo e lo storico, sotto forma di grafico o tabella, dei dati inviati.
• Creare un sinottico che consenta di rappresentare lo stato del dispositivo in maniera più semplice ed intuitiva.
• Stabilire un accesso remoto tra un dispositivo ed il portale, al fine di poter leggere/scrivere il valore delle variabili, laddove non fosse disponibile un IP pubblico.
• Stabilire una connessione VPN tra un PC ed un portale. In questo modo, attivando anche l’accesso remoto, si avrà la possibilità di creare una propria rete VPN con tutti i dispositivi di cui si è in possesso, eliminando eventuali problematiche relative agli indirizzi IP non raggiungibili.

Per ulteriori informazioni, fare riferimento alla relativa documentazione: Portale.

Le impostazioni di default sono:

• Server address: https://nethix.co
• Server port: 443

I parametri corretti verranno comunque indicati da Nethix nel momento in cui si deciderà di attivare il servizio.

In alternativa è possibile abilitare l’invio dei dati verso un server esterno. Per farlo sarà sufficiente scegliere la voce HTTP nel campo Protocol.

In General setup si dovranno definire i seguenti parametri:

• Enable: Abilita/disabilita l’invio.
• User agent: User agent che WE111 userà per autenticarsi nel server.
• Device ID: ID del dispositivo in questione (utile per gestire più WE111 nello stesso server).
• Server address: Indirizzo del server a cui mandare i dati (completo di http://).
• Server port: Porta del server.
• Send mode: Metodo di invio. È possibile scegliere tra POST e GET. Prima di attivare l’opzione, rivolgersi a Nethix per avere un esempio di stringa inviata da WE111.

In Data delivery si potrà specificare il percorso all’interno del server in cui si trova lo script di elaborazione dei dati ricevuti:

• Script address: Nome e percorso completo dello script all’interno del server remoto.
• Manage portal response: WE111 rimane in attesa di eventuali comandi impartiti dal server, ogni qual volta si trova ad effettuare un invio dati.

N.B.: Nel caso dell’invio dati di tipo Server, WE111 userà la stessa frequenza impostata per il campionamento (Configuration → Cloud → General).

6.4. MQTT/S

• Enable: Abilita/disabilita l’invio.
• Broker hostname: Indirizzo del server a cui mandare i dati.
• Broker port: Porta del server (default 1883).
• Username: Nome utente per autenticazione sul server (se necessario).
• Password: Password per autenticazione sul server (se necessario).
• Client ID: Id a cui fa riferimento il Broker per identificare il WE111.
• Topics root: Indirizzo principale di riferimento, in cui saranno salvati i dati.
• QOS (pub): Qualità del servizio nel caso in cui la variabili sia con MQTT mode = Publish (default 0).
• QOS (sub): Qualità del servizio nel caso in cui la variabili sia con MQTT mode = Subscribe (default 0). Il QOS (Quality of Service) va da 0 a 2, 0 il servizio garantisce l’invio del dato al massimo 1 volta (non sempre viene inviato), 1 il servizio garantisce l’invio del dato almeno 1 volta (può essere inviato più volte), 2 il servizio garantisce che il dato venga inserito esattamente 1 volta.
• MQTTS: Abilita/disabilita utilizzo del certificato TLS a seconda delle specifiche del server.

• Publish
• Subscribe

Durante la creazione di una variabile (vedere 2.1. Generic Settings) è possibile specificare quale delle due modalità utilizzare.

PUBLISH

SUBSCRIBE

6.5. MQTT/S Report

Esempio MQTT report:

{
   "Timestamp":"1650421200",
   "Temperature":"27.1",
   "Pressure":"1050",
   "Tank":"13.6",
   "Signal":"85",
}

6.6. Email report

Dal tab Email report è possibile configurare l’invio dei dati raccolti da WE111 ad uno o più indirizzi mail.

• Enable: Abilita/disabilita l’invio.
• Delivery time: Specifica ogni quanto inviare i dati agli utenti abilitati. Da notare che il tempo di invio e di campionamento (campo Sampling frequency nel tab General) possono essere diversi. Sarà ad esempio possibile campionare una variabile ogni minuto ed inviare i dati una sola volta al giorno.

Per far si che il report venga correttamente inviato, è necessario aver configurato correttamente l’account mail associato a WE111 (8.3. Email) ed aver abilitato l’opzione Receive report by email nella configurazione degli utenti a cui si intende inviare la mail (7. Utenti).

7.1. Creare un nuovo utente

Per creare un nuovo utente è necessario andare alla pagina Configuration → Users → Users.

In questa pagina vengono visualizzate alcune informazioni riguardanti gli utenti creati in precedenza:

• Username Lo username da usare per effettuare il login.
• Full name Il nome completo assegnato all’utente.
• Privileges Il livello dell’utente creato (SYSTEM, ADMIN o USER).
• Expire date La data di scadenza dell’utente oltre la quale l’utente verrà disattivato (ma non cancellato).

Dalla colonna Delete sarà invece possibile selezionare uno o più utenti da cancellare cliccando il tasto Delete selected users.

Per editare un utente creato in precedenza sarà sufficiente cliccare sul suo username, per crearne uno nuovo cliccare invece il tasto Add new user.

I parametri da impostare per creare l’utente sono i seguenti:

• Username Lo username da usare per effettuare il login. Non sono ammessi spazi o caratteri speciali (a parte il carattere “_”). È inoltre case sensitive, si raccomanda quindi di fare attenzione all’uso delle maiuscole/minuscole.
• Password La password da usare per effettuare il login (da inserire 2 volte). La password può essere composta da caratteri alfanumerici e caratteri speciali. È inoltre case sensitive, si raccomanda quindi di fare attenzione all’uso delle maiuscole/minuscole.
• Full name Il nome completo assegnato all’utente. Una volta effettuato il login, il Full name verrà riportato in alto a sinistra, a fianco al nome assegnato a WE111. Cliccandoci sopra si accederà direttamente alla pagina di configurazione dell’utente.
• Privileges Il livello da assegnare al cliente tra SYSTEM, ADMIN e USER (vedere 7. Utenti).
• Expire date Permette di specificare una data oltre la quale l’utente non potrà più accedere all’interfaccia né inviare/ricevere comandi e segnalazioni da o verso WE111. Se non si intende definire una data di scadenza per l’utente in questione, lasciare vuoto il campo.
• Phone number Numero di telefono associato all’utente. È fondamentale qualora l’utente intenda inviare/ricevere SMS al/dal dispositivo, in caso contrario è possibile lasciare vuoto il campo. Ricordarsi di inserire il numero telefonico compreso di prefisso nazionale, espresso nel formato +nn (+39 nel caso di numeri italiani).
• Email address Indirizzo mail associato all’utente. È fondamentale qualora l’utente intenda inviare/ricevere mail al/dal dispositivo, in caso contrario è possibile lasciare vuoto il campo.
• Chat name Nome in chat e nome del server di chat associati all’utente (e.g. @mrossi:server.chat). È fondamentale qualora l’utente intenda inviare/ricevere messaggi via chat al/dal dispositivo, in caso contrario è possibile lasciare vuoto il campo.
• Actions In questa sezione si possono abilitare/disabilitare varie opzioni legate all’utente:
  • Receive alarms by SMS Abilitandola, permette all’utente di ricevere allarmi via SMS da parte di WE111, purché precedentemente configurati.
  • Receive alarms by email Abilitandola, permette all’utente di ricevere allarmi via mail da parte di WE111, purché precedentemente configurati.
  • Receive report by email Abilitandola, l’utente in questione riceverà i report via mail da parte del dispositivo, in accordo con le impostazioni definite (6.6. Email report).
  • Send commands by SMS Abilitandola, permette all’utente di inviare comandi a WE111 via SMS.
  • Send commands by email Abilitandola, permette all’utente di inviare comandi a WE111 via mail.
  • Send commands by chat Abilitandola, permette all’utente di inviare comandi a WE111 via chat.
  • Receive remote command Abilitandola, eventuali mail inviate da WE111 all’utente in questione non riporteranno il nome assegnato al dispositivo nell’oggetto. Questo permette di inviare comandi di Set/Get (5.2. Comandi Set/Get via SMS/Email/Chat) tra dispositivi.

7.2. Gruppi di utenti

Nel caso in cui nel sistema fossero presenti molti utenti, la loro gestione, soprattutto per quanto riguarda gli eventi e le azioni, può diventare impegnativa. Al fine di poter semplificare questa situazione, viene data la possibilità di definire dei gruppi di utenti.

Per creare, eliminare ed editare i gruppi di utenti, è necessario andare alla pagina Configuration → Users → Groups.

Da questa pagina si possono innanzitutto visualizzare delle informazioni sui gruppi già precedentemente creati, tra cui:

• Group name Il nome assegnato al gruppo.
• Description La descrizione del gruppo in questione.
• Users Il numero di utenti presenti nel gruppo.

Dalla colonna Delete è invece possibile selezionare uno o più gruppi da eliminare cliccando Delete selected groups.

Per editare un gruppo esistente, cliccare il nome del gruppo desiderato. Se invece si intende creare un nuovo gruppo, cliccare Add new group.

Per creare correttamente un gruppo sono necessarie poche informazioni:

• Group name Il nome assegnato al gruppo.
• Description La descrizione del gruppo in questione.
• Users Campo che consente di selezionare quali utenti faranno parte di questo gruppo. Dopo averli selezionati con il mouse dal box Available users sarà sufficiente cliccare > per mandarli nel box Selected users o < per eliminarli dal gruppo.

Cliccando Save il gruppo verrà creato. Alcune considerazioni da fare riguardo ai gruppi di utenti:

• Un utente può non appartenere a nessun gruppo.
• Un utente può appartenere a più gruppi (anche tutti).
• WE111 è in grado di riconoscere numeri, indirizzi mail, o nomi chat ripetuti. Anche se un utente è presente in più gruppi, in caso di allarme riceverà la segnalazione una sola volta.
• Cancellando un gruppo di utenti, non verranno cancellati gli utenti che appartenevano al gruppo.

8.1. Interfacce di rete

Cliccando su Networking → Interfaces si accederà all’area nella quale sarà possibile stabilire in quale modo WE111 possa accedere alla rete internet.

Nel caso di WE111, l’unica voce selezionabile è Modem.

8.1.1. Connessione dati ed SMS

WE111 consente di stabilire una connessione GPRS/LTE al fine di poter accedere all’interfaccia web del dispositivo da remoto e di inviare dati, messaggi via chat o mail.

Selezionando la voce Networking → Interfaces → Modem verrà data la possibilità di impostare alcuni parametri fondamentali per il funzionamento della connessione data dalla SIM card inserita nel dispositivo.

CONNESSIONE DATI

Nella sezione Connection mode viene data la possibilità di abilitare il servizio e di specificare se la connessione debba essere permanente o su richiesta:

• Always On WE111 manterrà sempre attiva la connessione. Nel caso in cui dovesse cadere (credito insufficiente, segnale assente ecc…) verrà ripristinata nel primo momento utile.
• On demand La connessione verrà attivata solo su richiesta di un utente registrato, tramite l’invio del messaggio Wakeup (9. Comandi di sistema) e avrà una durata di 15 minuti allo scadere dei quali verrà automaticamente terminata. Se sono attivi servizi che richiedano una connessione (invio dati, invio mail, chat ecc…) WE111 stabilirà una connessione temporanea che andrà a terminare automaticamente al termine delle operazioni.

Se il tutto è stato configurato correttamente, dopo pochi minuti la connessione GPRS/LTE verrà attivata. Nel pannello di stato posto sulla destra dell’interfaccia web l’indicatore relativo al GPRS/LTE diverrà verde e sotto ad esso verranno riportati l’uptime della connessione ed il relativo indirizzo IP.

Esistono anche alcuni parametri avanzati ai quali è possibile accedere cliccando l’opzione Advanced:

• Ping enable Se abilitato, consente al dispositivo di effettuare dei ping verso gli indirizzi specificati nei campi Keepalive server a cadenze di tempo regolari. Questo consente al sistema di riconoscere eventuali criticità e di agire al fine di ripristinare quanto prima la connessione. Abilitare questa opzione aumenta il grado di controllo sullo stato della connessione, andando però ad aumentare il traffico dati sulla SIM.
• Keepalive server 1 In questo campo è possibile specificare l’indirizzo primario verso il quale il dispositivo cercherà di effettuare dei ping, nel caso in cui l’opzione Ping enable fosse attiva.
• Keepalive server 2 In questo campo è possibile specificare un secondo indirizzo, nel caso in cui il primo dovesse essere irraggiungibile.
• Address/Control compression Abilita/disabilita la compressione dei campi address/control in fase di negoziazione. Salvo richieste specifiche, si consiglia di non modificare le impostazioni di default (abilitato).

Per assicurarsi che la connessione GPRS/LTE venga stabilita con successo, è importante assicurarsi di aver eseguito tutte le operazioni richieste:

• Predisporre WE111 di una SIM (ricaricabile o a contratto) abilitata al traffico dati.
• Inserire l’APN nel campo APN per gli operatori che lo richiedono.
• Collegare l’antenna in dotazione ed assicurarsi che ci sia una copertura sufficiente.
• Abilitare il servizio GPRS/LTE tramite il campo Enable.

È possibile verificare il funzionamento della connessione usando lo strumento di diagnostica Ping (10.3. Ping).

Ulteriori informazioni sullo stato della connessione si possono trovare andando alla pagina Diagnostics → Networking (10.2. Informazioni sulla connettività).

Dalla sezione SIM configuration si possono impostare alcuni parametri che si rivelano spesso fondamentali per il corretto funzionamento del servizio SMS, oltre che della connessione GPRS/LTE, in accordo con le specifiche dell’operatore telefonico che si intende scegliere.

• APN L’APN è il nome del punto di accesso della rete GPRS/LTE. Cambia a seconda dell’operatore e del contratto in uso con esso (in alcuni casi può non essere necessario). Si tratta di un parametro importante al fine del corretto funzionamento della connessione. Nel caso in cui non fosse noto, contattare il proprio operatore telefonico.
• Username Nome utente da utilizzare per la connessione GPRS/LTE. Salvo casi particolari in cui l’operatore lo richieda, il campo va lasciato vuoto.
• Password Password da utilizzare per la connessione GPRS/LTE. Salvo casi particolari in cui l’operatore lo richieda, il campo va lasciato vuoto.
• SIM number Numero telefonico della SIM inserita nel dispositivo. Non è rilevante ai fini del funzionamento (non viene mai usato da WE111).
• SMS center Centro servizi SMS dell’operatore. Con alcune SIM potrebbe essere non necessario. Nel caso un cui non fosse noto, contattare il proprio operatore telefonico.

SERVIZIO SMS

Dalla sezione SMS configuration, infine, si potrà abilitare/disabilitare il servizio SMS (campo Enable SMS) e scegliere se abilitare o meno l’invio di eventuali segnalazioni via SMS impostate precedentemente (campo Send events) (3. Eventi/Azioni).

Una volta avviato il servizio SMS, sarà possibile testarne il funzionamento tramite la sezione SMS test: inserendo un numero telefonico valido preceduto dal prefisso nazionale (ad esempio +39NNNNNNNNNN nel caso dell’Italia), WE111 cercherà di inviare un SMS avente come testo ” Test message from WE111 “.

Affinché il servizio SMS funzioni correttamente consentendo agli utenti di dialogare con WE111 e al dispositivo di inviare eventuali segnalazioni di allarmi, occorre verificare di aver opportunamente seguito i seguenti passi:

• Impostare il centro servizi SMS nel campo SMS center.
• Abilitare il servizio SMS dal campo Enable SMS
• Abilitare l’invio di SMS su evento (campo Send events)
• Definire almeno un utente e assicurarsi che abbia attive le voci riguardanti la ricezione/invio di SMS (7. Utenti) ed un numero di telefono valido.
• Creare uno o più eventi aventi come azione Send SMS (vedere 3. Eventi/Azioni).
• Assicurarsi che la SIM sia correttamente inserita e che abbia credito sufficiente.
• Assicurarsi che nella SIM non sia presente il codice PIN.
• Assicurarsi che l’antenna sia correttamente inserita e che il segnale sia sufficiente.

Tutti gli SMS inviati e ricevuti possono essere visualizzati nella pagina Status → Services → SMS. Accedendovi, la prima pagina ad essere visualizzata sarà quella relativa agli SMS ricevuti dal dispositivo

Nella tabella visualizzata si troveranno le seguenti informazioni:

• Number Campo in cui verrà visualizzato il mittente del messaggio.
• Reception date Campo in cui verranno riportate data ed ora in cui WE111 ha ricevuto il messaggio.
• Text Campo in cui verrà riportato il testo del messaggio ricevuto.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Inbox.

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Inbox ad Outbox.

Da questa tabella si possono visualizzare tutti i messaggi non ancora inviati da WE111. Le informazioni visualizzate sono le seguenti:

• Number Campo in cui verrà visualizzato il destinatario del messaggio.
• Creation date Campo in cui verranno visualizzate data e ora di creazione del messaggio.
• Text Campo in cui verrà visualizzato il testo del messaggio.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Outbox (messaggi che quindi non verranno inviati da WE111).

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Outbox a Sent. In quest’ultima tabella verranno visualizzate alcune informazioni riguardo agli SMS già inviati da WE111:

• Number Campo in cui verrà visualizzato il destinatario del messaggio inviato.
• Send date Campo in cui verranno visualizzate data e ora in cui WE111 ha inviato il messaggio.
• Text Campo in cui verrà visualizzato il testo del messaggio inviato da WE111.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Sent.

8.2. Servizi attivabili

La sezione Networking → Services del menu consente di abilitare alcuni servizi aggiuntivi che sfrutteranno la connettività del dispositivo:

• Email
• Chat
• VPN
• DNS

8.3. Email

Prima di procedere con la configurazione di WE111, è necessario fare quanto segue:

• Dopo aver scelto il provider da utilizzare (Gmail, Yahoo, altro), recarsi nel suo sito e creare un nuovo account mail valido
• Documentarsi nel sito del provider sui parametri da inserire per configurare correttamente la mail

Una volta creato un nuovo account email, sarà possibile passare alla configurazione di WE111, scegliendo se abilitare le mail in uscita, quelle in entrata oppure entrambe dalla pagina Networking → Services → Email.

Nella sezione Outgoing mail setup si vanno a definire i parametri necessari per l’invio delle mail da parte di WE111:

• Enable outgoing mail service Abilita/disabilita il servizio invio mail.
• Server type Permette di specificare il tipo di server mail (attualmente è disponibile solo la voce SMTP).
• Server address Indirizzo del server mail (ad esempio smtp.gmail.com.).
• Port Numero della porta alla quale accedere (ad esempio 587)
• Email address Indirizzo mail associato a WE111. Questo sarà l’indirizzo visualizzato dagli utenti che riceveranno mail dal dispositivo.
• Username Username dell’account mail associato a WE111.
• Password Password dell’account mail associato a WE111.
• SSL-TLS Crittografia.

Una volta cliccato il tasto Save, nel fondo della pagina verrà visualizzata una nuova sezione chiamata Outgoing mail test dalla quale sarà possibile inviare una mail di prova verso un indirizzo qualsiasi.

Nella sezione Incoming mail setup si potranno invece definire i parametri necessari alla ricezione delle mail inviate dagli utenti abilitati:

• Enable incoming mail service Abilita/disabilita il servizio di ricezione mail.
• Server type Tipo di server mail (attualmente è disponibile solo la voce POP).
• Server address Indirizzo del server mail (ad esempio pop.gmail.com).
• Port Numero della porta alla quale accedere (ade esempio 995).
• Email address Indirizzo mail associato a WE111. I comandi inviati dagli utenti abilitati, dovranno essere diretti a questo indirizzo.
• Username Username dell’account mail associato a WE111.
• Password Username dell’account mail associato a WE111.
• SSL-TLS Crittografia.

Un servizio mail correttamente configurato permetterà a WE111 di poter inviare mail di segnalazione agli utenti interessati (vedere 3.2.1. Azione Send Email), di ricevere comandi da parte degli utenti registrati (vedere 5.2. Comandi Set/Get via SMS/Email/Chat e 9. Comandi di sistema), di inviare/ricevere comandi a/da altri dispositivi e di inviare report programmati (vedere 6.6. Email report).

Tutte le mail inviate e ricevute possono essere visualizzate nella pagina Status → Services → Email. Accedendovi, la prima pagina ad essere visualizzata sarà quella relativa alle mail ricevute dal dispositivo

Nella tabella visualizzata si troveranno le seguenti informazioni:

• Mail address Campo in cui verrà visualizzato il mittente della mail.
• Reception date Campo in cui verranno riportate data ed ora in cui WE111 ha ricevuto la mail.
• Text Campo in cui verrà riportato il testo della mail ricevuta.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Inbox.

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Inbox ad Outbox.

Da questa tabella si possono visualizzare tutte le mail non ancora inviate da WE111. Le informazioni visualizzate sono le seguenti:

• Mail address Campo in cui verrà visualizzato il destinatario della mail.
• Creation date Campo in cui verranno visualizzate data e ora di creazione della mail.
• Attempts Campo in cui verranno visualizzati i tentativi di invio fatti da WE111.
• Text Campo in cui verrà visualizzato il testo della mail.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutte le mail presenti in Outbox (mail che quindi non verranno inviate da WE111).

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Outbox a Sent. In quest’ultima tabella verranno visualizzate alcune informazioni riguardo alle mail già inviate da WE111:

• Mail address Campo in cui verrà visualizzato il destinatario del messaggio inviato.
• Creation date Campo in cui verranno visualizzate data e ora in cui WE111 ha inviato il messaggio.
• Attempts Campo in cui verranno visualizzati i tentativi di invio fatti da WE111 prima di riuscire a mandare la mail.
• Text Campo in cui verrà visualizzato il testo del messaggio inviato da WE111.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Sent.

8.4. Chat

Una volta verificato che il dispositivo sia in grado di connettersi alla rete internet ed aver creato un utente chat da associare a WE111, sarà quindi possibile procedere con la configurazione del servizio recandosi alla pagina Networking → Services → Chat.

Nella sezione Chat service setup si vanno a definire i parametri necessari al funzionamento del servizio:

• Chat enable Abilita/disabilita il servizio chat.
• Chat server Permette di specificare a quale server chat dovrà collegarsi WE111 (ad esempio matrix.org).
• Room name Nome della stanza della chat (ad esempio Home).
• Device username Nome del utente chat da associare a WE111. Il dispositivo invierà e riceverà i messaggi usando questo username.
• Device password Password dell’utente da associare a WE111.
• Sync timeout Timeout espresso in secondi relativo alla sincronizzazione con il server.

Una volta cliccato il tasto Save, nel fondo della pagina verrà visualizzata una nuova sezione chiamata Chat test dalla quale sarà possibile inviare un messaggio via chat di prova verso la chat room nel dispositivo.

Tutti i messaggi inviati e ricevuti via chat dal dispositivo possono essere visualizzati nella pagina Status → Services → Chat. Accedendovi, la prima pagina ad essere visualizzata sarà quella relativa ai messaggi ricevuti dal dispositivo via chat.

Nella tabella visualizzata si troveranno le seguenti informazioni:

• Sender Campo in cui verrà visualizzato il mittente del messaggio.
• Reception date Campo in cui verranno riportate data ed ora in cui WE111 ha ricevuto il messaggio.
• Text Campo in cui verrà riportato il testo del messaggio ricevuto.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Inbox.

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Inbox ad Outbox.

Da questa tabella si possono visualizzare tutti i messaggi non ancora inviati via chat da WE111. Le informazioni visualizzate sono le seguenti:

• Creation date Campo in cui verranno visualizzate data e ora di creazione del messaggio.
• Text Campo in cui verrà visualizzato il testo del messaggio.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Outbox (messaggi che quindi non verranno inviate da WE111).

Cliccando il menu a tendina posto sopra la tabella, sarà possibile passare da Outbox a Sent. In quest’ultima tabella verranno visualizzate alcune informazioni riguardo ai messaggi già inviati da WE111:

• Send date Campo in cui verranno visualizzate data e ora in cui WE111 ha inviato il messaggio.
• Text Campo in cui verrà visualizzato il testo del messaggio inviato da WE111.

In qualsiasi momento sarà possibile cliccare il tasto Refresh al fine di ricaricare le informazioni, o Empty box al fine di eliminare tutti i messaggi presenti in Sent.

@my_username:matrix.org

dove al posto di my_username andrà ovviamente inserito il nome corretto.

8.5. VPN

È possibile abilitare la VPN in due modalità:

• Auto

• VPN Service URL: https://nethix.co
• VPN Service port: 443

Affinché un PC possa connettersi alla VPN fornita da Nethix, in modo tale da poter raggiungere il WE111 a cui ci si intende collegare da remoto, si possono usare i seguenti metodi:

• Client OpenVPN: Scaricare il cliente di OpenVPN dalla pagina ufficiale dello standard (ulteriori informazioni presenti qui).
• QuickTunnel: Scaricare il software gratuito QuickTunnel creato appositamente da Nethix e compatibile con sistemi Windows, macOS e Linux (ulteriori informazioni disponibili nel relativo manuale QuickTunnel).
• Manual

La VPN manuale è invece utilizzata per creare una connessione sicura verso un qualunque altro server VPN compatibile con lo standard OpenVPN.

I parametri da configurare per abilitare una VPN manuale sono i seguenti:

• VPN mode: la modalità della VPN in questo caso Manual
• VPN configuration: è un file di configurazione rilasciato dal gestore del server VPN scelto. Il file dovrà contenere anche i certificati, seguendo lo standard OpenVPN.
• VPN Service user: il nome utente con il quale WE111 dovrà autenticarsi presso il server VPN scelto.
• VPN Service password: la password associata allo username.

8.6. DDNS

WE111 offre inoltre la possibilità di associare la propria connessione con un servizio di DNS dinamico, scegliendo dalla lista dei provider disponibili dalla pagina Networking → Services → DDNS.

• Provider: Da questo campo sarà possibile scegliere il provider da utilizzare.
• Hostname: Indirizzo a cui rispondere il dispositivo dopo essere stato opportunamente configurato (e dopo aver creato un proprio account dal sito del provider scelto).
• Username: Nome utente associato all’account creato dal sito del provider.
• Password: Password associata al nome utente.

10.1. Log di sistema

Dalla pagina Diagnostics → Logs → System è possibile consultare gli ultimi 20 log di sistema.

Nella tabella riportata verranno visualizzate alcune informazioni utili ad avere un riscontro sullo stato del sistema e ad individuare eventuali errori. Per aggiornare la lista dei log visualizzati, cliccare il tasto Refresh.

Nel caso in cui fossero presenti delle segnalazioni di errore, ricontrollare la configurazione del dispositivo ed eventualmente rivolgersi al supporto Nethix.

Dalla pagina Diagnostics → Logs → Boot invece si possono visualizzare i log relativi ai boot di sistema, ovvero tutte le operazioni che vengono eseguite da WE111 ad ogni avvio/riavvio.

Tali informazioni possono essere utili al supporto Nethix in caso di assistenza.

10.2. Informazioni sulla connettività

Dalla pagina Diagnostics → Networking si possono consultare informazioni aggiuntive sullo stato delle connessioni attive.

La pagina è divisa in 3 sezioni: RNDIS Interface, Modem Interface e VPN Interface (se presente).

Ogni sezione riporta una serie di informazioni tecniche relative alla connessione di riferimento.

RNDIS Interface:

• Status Restituirà up se la connessione è stabilita, down se non è attivo il servizio o se WE111 non è riuscito a stabilire una connessione.
• MAC address Visualizza l’indirizzo MAC dell’interfaccia di rete di WE111.
• IP address Indirizzo IP della connessione (in questo caso sarà sempre 192.168.7.1).
• Subnet mask Maschera di sotto-rete.
• Gateway Gateway in uso.
• DNS servers Server DNS disponibili.
• In/out bytes Quantità di traffico effettuato/ricevuto durante la connessione in atto.
• In/out errors Quantità di errori in uscita/entrata durante la connessione in atto.
• Collisions Quantità di collisioni avvenute durante la connessione in atto.

Modem Interface:

• Status Restituirà up se la connessione è stabilita, down se non è attivo il servizio o se WE111 non è riuscito a stabilire una connessione.
• Signal Restituisce il livello del segnale in CSQ. La scala va da 1 a 31, laddove 31 rappresenta il massimo della copertura ed 1 il minimo. Per avere una connessione stabile, è consigliabile avere un segnale minimo di 15-16.
• Network operator Viene riportato il nome dell’operatore telefonico a cui WE111 è agganciato.
• IP address Indirizzo IP della connessione.
• In/out bytes Quantità di traffico effettuato/ricevuto durante la connessione in atto.
• In/out errors Quantità di errori in uscita/entrata durante la connessione in atto.
• Collisions Quantità di collisioni avvenute durante la connessione in atto.

VPN Interface:

• Status Restituirà up se la connessione è stabilita, down se non è attivo il servizio o se WE111 non è riuscito a stabilire una connessione.
• IP address Indirizzo IP della connessione.
• Subnet mask Maschera di sotto-rete.
• In/out bytes Quantità di traffico effettuato/ricevuto durante la connessione in atto.
• In/out errors Quantità di errori in uscita/entrata durante la connessione in atto.
• Collisions Quantità di collisioni avvenute durante la connessione in atto.

10.3. Ping

Nel caso in cui si dovessero riscontrare dei problemi nel comunicare con l’esterno, ad esempio durante l’invio dei dati verso un portale, mail o altro, WE111 da la possibilità di effettuare dei ping verso un qualsiasi host, permettendo di selezionare l’interfaccia di rete da utilizzare.

Per farlo sarà sufficiente accedere alla pagina Diagnostics → Ping.

• Host Inserire in questo campo un hostname valido da raggiungere tramite ping (ad esempio www.google.com).
• Interface Interfaccia di rete da utilizzare per raggiungere l’host definito. A seconda della configurazione del dispositivo e dei servizi attivi, sarà possibile scegliere tra 4G e VPN.
• Count Permette di selezionare il numero di ping da eseguire.

Una volta completati i campi descritti, cliccando Ping si darà inizio all’operazione. I risultati verranno riportati nell’area sottostante, consentendo così all’utente di intercettare eventuali problematiche.

11.1. Configurazione ingresso

WE111 è dotato di un ingresso configurabile via software, in base alle esigenze del cliente. Per cambiare la configurazione dell’ingresso è sufficiente selezionare la pagina Configuration → General Setup.

11.2. Overview della configurazione

WE111 permette di visualizzare una panoramica completa della configurazione fatta dall’utente, accessibile in un’unica pagina, al fine di semplificare la consultazione delle informazioni inserite.

Accedendo infatti alla pagina Configuration → Overview si avrà a disposizione un riassunto completo della configurazione finora fatta suddiviso nelle seguenti aree:

• Variables Verrà riportato l’elenco della variabili create, suddiviso per gruppi di variabili, nel quale sarà possibile accedere ad alcune informazioni fondamentali riguardo la loro configurazione. Le variabili che non sono state associate a nessun gruppo verranno visualizzate sotto No group
• Events Verranno riportati tutti gli eventi e le loro relative azioni associate con dei link che permettono di individuare immediatamente le variabili a cui sono legati e gli utenti a cui sono destinate le azioni
• Users Verrà riportato l’elenco dei gruppi di utenti. Ogni gruppo conterrà informazioni aggiuntive sugli utenti che ne fanno parte. Gli utenti che non sono stati inseriti in nessun gruppo verrà visualizzati sotto No group

Alla destra di ogni voce visualizzata nell’ Overview della configurazione è presente l’icona che permette di espanderne i contenuti e di accedere a dettagli aggiuntivi.

11.3. Impostazioni di sistema

Nella sezione Configuration → General Setup si possono definire alcune impostazioni generali del dispositivo, oltre che attivare alcuni servizi aggiuntivi.

11.3.1. Informazioni sull’impianto

Nella pagina Configuration → General Setup → System, sotto la sezione System, si possono personalizzare i contenuti che verranno visualizzati alla pagina Status → Site appena dopo il login. Queste impostazioni hanno il solo scopo di identificare il dispositivo e non sono obbligatorie.

• Site name Nome attribuito al dispositivo.
• Site id ID numerico attribuito al dispositivo.
• Country Paese/Stato in cui si trova il dispositivo.
• Region Regione/Area in cui si trova il dispositivo.
• Picture Abilitando questa opzione e selezionando un’immagine cliccando Select file, sarà possibile visualizzare un’immagine a scelta una volta effettuato il login (immagine dell’impianto, dell’azienda ecc…). L’immagine scelta verrà visualizzata alla pagina Status -> Site.

11.3.2. Data e ora

Nella pagina Configuration → General Setup → System, sotto la sezione Time/Date, sarà possibile impostare la data e l’ora del dispositivo:

• Installation time/date Permette di specificare data e ora in cui l’impianto è stato installato. Questa informazione ha il solo scopo di identificare il dispositivo e non ha nessuna rilevanza sul funzionamento.
• Set time/date Permette di impostare manualmente la data e l’ora del dispositivo se l’opzione Enable NTP è disattivata.
• Enable NTP Abilita il servizio di sincronizzazione automatica dell’ora. Una volta al giorno, ad ogni riavvio e ad ogni riconnessione, WE111 si collegherà ad un server al fine di ottenere la data e l’ora precisa, in accordo con la proprio timezone.
• Select timezone Permette di impostare la propria timezone.

È inoltre possibile specificare un server NTP diverso da quelli di default, cliccando il link Advanced

11.3.3. Personalizzare l’interfaccia web

Sono possibili alcune personalizzazioni grafiche dell’interfaccia web del dispositivo, valide per tutti gli utenti ed impostabili andando alla pagina Configuration → General Setup → Web Interface.

Nella sezione Web interface theme si può selezionare il tema del dispositivo tra Dark (versione scura) e Light (versione chiara).

Nella sezione Web interface customization si potranno modificare altri elementi del dispositivo:

• Logo Permette di selezionare un’immagine da utilizzare come logo, sostituendo quello Nethix posto in alto a sinistra.
• Prevalent color Colore primario della pagina. (Colore RGB esadecimale es.: #007BC5)
• Font color Colore del testo. (Colore RGB esadecimale es.: #007BC5)
• White icons Disabilitando questa opzione, le icone poste nell’header (help, poweroff, reboot, logout) verranno visualizzate in nero.
• Background color Colore di sfondo della pagina. (Colore RGB esadecimale es.: #007BC5)
• Footer Consente di impostare il footer a proprio piacimento (è consentito l’uso di codice HTML).

Ogni campo che richiede un colore se cliccato farà apparire un color picker con il quale sarà facilmente selezionabile il colore desiderato e verrà inserito in automatico il valore esadecimale corrispondente.

11.4. Informazioni di sistema

Alla pagina System → Info si possono trovare alcune informazioni aggiuntive su WE111. Nella sezione System information, vengono visualizzate alcune informazioni di carattere generale:

• Version Versione attualmente installata nel dispositivo.
• Software serial number Serial number riportato nell’etichetta posta sul retro del dispositivo.
• Hardware serial number Serial number hardware, importante per la registrazione al portale e per l’utilizzo di servizi quali la VPN Nethix.
• Modem Model Modello del modem interno.
• Modem IMEI Codice IMEI del modem interno.
• Modem temperature Temperatura del modem interno.
• CPU temperature Temperatura della CPU.
• Internal temperature Temperatura interna al WE111.
• Device Supply Alimentazione del dispositivo (V).
• Memory usage Stato della memoria RAM.

11.5. Backup/Restore della configurazione

WE111 da la possibilità di effettuare un backup della configurazione fatta sul dispositivo sotto forma di file criptato, andando alla pagina System → Backup/Restore.

Il backup comprende:

• Variabili create
• Eventi e azioni associate
• Impostazioni di Networking
• Utenti creati
• Abilitazione e configurazione servizi

Non verranno invece copiati:

• Log di sistema
• Log dei servizi
• Archivi SMS/Chat/Email/Cloud

Per effettuare il backup, cliccare Backup dalla sezione Download configuration.

Una volta ottenuto un file criptato di backup, lo si potrà caricare su un qualsiasi altro dispositivo allineato con quello di partenza.

Dalla sezione Restore configuration, sarà sufficiente selezionare il file di backup e cliccare Restore. Al termine dell’operazione, si raccomanda di riavviare il dispositivo per rendere effettive tutte le modifiche.

Lo strumento Backup/Restore può risultare utile nel caso in cui si voglia conservare una copia della configurazione, al fine di poterla eventualmente ricaricare nel dispositivo di partenza, o nel caso in cui si debbano installare più dispositivi con la stessa configurazione.

Nel secondo caso (effettuare il Restore su un WE111 diverso da quello da cui è stato generato il Backup), è fondamentale sapere quanto segue:

• Per copiare la configurazione di un WE111 su di un altro, è necessario che i due dispositivi abbiano la stessa versione. In caso contrario contattare il supporto Nethix.

11.6. Eliminare log

La memoria interna di WE111 permette di immagazzinare una grande quantità di dati. Tuttavia, al fine di non appesantire inutilmente il dispositivo, viene data la possibilità di cancellare qualsiasi log presente andando alla pagina System → Reset Logs.

I log che possono essere cancellati sono:

• Chat Elimina tutti i messaggi ricevuti e inviati tramite chat.
• Email Elimina tutte le mail presenti in memoria tra inviate, ricevute ed in coda di invio.
• Portal Elimina tutti i pacchetti mandati ad un portale esterno.
• Commands Elimina tutti i log riferiti agli execute a command (non visualizzabili dall’interfaccia Web).
• SMS Elimina tutti gli SMS presenti in memoria tra inviati, ricevuti ed in coda di invio.
• 4G Elimina tutti i log riferiti alla connessione del modem interno (non visualizzabili dall’interfaccia Web).
• Events Elimina tutti i log riferiti agli eventi/azioni finora verificatisi.

Una volta selezionate una o più categorie, sarà sufficiente cliccare Erase logs per eliminare i log in maniera definitiva dalla memoria del dispositivo.

11.7. Ripristino impostazioni di fabbrica

Nel caso in cui si intenda riportare WE111 alle impostazioni di fabbrica, cancellando tutti i dati salvati, i log ed azzerando completamente la configurazione, è possibile andare alla pagina System → Factory Reset.

Dopo aver cliccato l’unico tasto presente nella pagina, verrà chiesto di confermare la propria scelta prima di procedere. Una volta data conferma, WE111 provvederà a riavviare se stesso, e, una volta fatta la procedura di inizializzazione, tornerà ad essere raggiungibile via USB.

11.8. Aggiornamento del dispositivo

WE111 può essere aggiornato in qualsiasi momento a fronte di una richiesta specifica del cliente o su segnalazione da parte di Nethix stessa.

Gli aggiornamenti possono essere effettuati in 2 diverse modalità: scrivendo il nome della versione e scaricandola dal server ufficiale Nethix (dopo aver contattato il supporto Nethix), o caricando sul dispositivo un file criptato contenente l’aggiornamento (da richiedere al supporto Nethix).

Entrambe le modalità sono utilizzabili andando alla pagina System → Ugprade.

Una volta nota la stringa da inserire, sarà sufficiente inserirla nel campo Version e cliccare il tasto Upgrade relativo.

Il tempo del download dipende direttamente dalla velocità della connessione attiva su WE111. Una volta scaricata la versione, WE111 si riavvierà al fine di procedere con l’installazione. Questa operazione potrebbe richiedere alcuni minuti (circa 3).

Una volta che WE111 sarà tornato raggiungibile, è opportuno accedere all’interfaccia al fine di verificare che l’aggiornamento sia andato a buon fine (è sufficiente controllare pannello di stato).

Dalla sezione Upgrade from file invece, sarà possibile inviare a WE111 un pacchetto criptato contenente l’aggiornamento, dopo averlo scaricato nel proprio PC.

Il pacchetto da utilizzare cambia a seconda della versione di partenza e va richiesto direttamente al supporto Nethix.

Il tempo del download dipende direttamente dalla velocità della connessione attiva su WE111. Una volta scaricata la versione, WE111 si riavvierà al fine di procedere con l’installazione. Questa operazione potrebbe richiedere alcuni minuti (circa 3).

Una volta che WE111 sarà tornato raggiungibile, è opportuno accedere all’interfaccia al fine di verificare che l’aggiornamento sia andato a buon fine (è sufficiente controllare pannello di stato).

11.9. Features

Le features del dispositivo sono una serie di opzioni hardware e software che compongono il sistema.

Per verificare le opzioni attive nel proprio dispositivo, andare alla pagina System → Features.

11.10. Plugins

I plugins sono una serie di pacchetti criptati che consentono di aggiungere/modificare parte della configurazione e delle pagine web disponibili.

Per caricare un plugin o verificare la lista dei plugin attualmente installati nel dispositivo in vostro possesso, accedere alla pagina System → Plugins.

Questo interessante tool consente ad esempio di inviare un pacchetto a WE111, al fine di aggiungere un configurazione pre-confezionata in accordo con le specifiche o le necessità del cliente.

Attraverso un plugin, si potranno aggiungere:

• Variabili
• Formule
• Eventi ed azioni
• Pagine customizzate o dedicate ad una specifica applicazione

La differenza sostanziale tra caricare un plugin o effettuare un restore da un backup di un dispositivo, sta nel fatto che tramite i plugin possono essere aggiunte pagine precedentemente non esistenti nel sistema, e che eventuali variabili, eventi, azioni verranno aggiunte a quelli attualmente esistenti (con il restore si va invece a sovrascrivere la configurazione).

Per conoscere i plugin disponibili o per richiederne di personalizzati, è necessario rivolgersi al supporto Nethix.