1.Introduzione
"Monitor HS" è una funzione consultabile da browser con la quale è possibile inviare e ricevere telegrammi da indirizzi di gruppo.
Ogni indirizzo di gruppo rappresenta un oggetto di c. (EIB) interno oppure esterno dell'HS/FS, il cui utilizzo con monitor HS è stato abilitato nel software Expert.
Gli indirizzi di gruppo vengono rappresentati in un elenco nella maschera oggetti di c. che presenta una sola voce (una riga) per indirizzo di gruppo. Opzionalmente questa voce può presentare, oltre all'indirizzo di gruppo e al valore attuale, il nome dell'oggetto di c. e ulteriori informazioni.
In un secondo elenco nella maschera protocollo vengono protocollati tutti i telegrammi degli indirizzi di gruppo precedentemente selezionati dall'utente. Questo elenco può essere esportato come file ".csv".
Ogni indirizzo di gruppo rappresenta un oggetto di c. (EIB) interno oppure esterno dell'HS/FS, il cui utilizzo con monitor HS è stato abilitato nel software Expert.
Gli indirizzi di gruppo vengono rappresentati in un elenco nella maschera oggetti di c. che presenta una sola voce (una riga) per indirizzo di gruppo. Opzionalmente questa voce può presentare, oltre all'indirizzo di gruppo e al valore attuale, il nome dell'oggetto di c. e ulteriori informazioni.
In un secondo elenco nella maschera protocollo vengono protocollati tutti i telegrammi degli indirizzi di gruppo precedentemente selezionati dall'utente. Questo elenco può essere esportato come file ".csv".
1.1.Condizioni
Condizione per l'utilizzo del monitor HS:
Hardware e software:
Hardware e software:
- HomeServer o FacilityServer con firmware versione 4.7.x o successiva.
- Software Expert versione 4.7.x o successiva.
- Mozilla Firefox, versione 49 o superiore
- Google Chrome, versione 52 o superiore
- Microsoft Edge versione 38 o superiore
- Microsoft Internet Explorer, versione 11 o superiore
- Google Chrome Android
- iOS Safari 10
1.2.Installazione, setup, accesso e richiamo
Attenzione
Dopo una modifica in Expert delle seguenti impostazioni, il progetto deve essere nuovamente trasmesso!
Accesso
Per poter utilizzare il monitor HS è necessario che sia attivata una delle due impostazioni seguenti in HS/FS Expert (scheda Dati principali -> Impostazioni progetto -> Interfaccia):
O
O
- deve essere attivata l'opzione Tutti
- l'opzione Definito dall'utente
e
deve essere attivata la casella di controllo hsmonitor.
Setup
In HS/FS Expert, percorso Dati principali -> Impostazioni progetto -> Rete -> Gateway OC deve essere attivata l'impostazione Accesso tramite WebSocket!
Le altre opzioni impostabili qui sono descritte nella guida di Expert nella sezione Gateway OC.
Le altre opzioni impostabili qui sono descritte nella guida di Expert nella sezione Gateway OC.
Richiamo
Per richiamare il monitor HS nel browser accedere al seguente URL:
o
HTTPS://HS_IP/opt/hsmonitor/index.htmlo
HTTPS://HS_IP/opt/hsmonitor/index.html#key=[Chiave]Login
All'avvio del monitor HS compare la maschera di login. Qui è possibile indicare la chiave definita nel progetto Expert per il collegamento dati del gateway OC.
Il monitor HS ricorda la chiave fino a che non viene chiuso il browser.
Deve essere inserita questa chiave al primo avvio del monitor HS oppure se la chiave è cambiata, ad esempio a seguito di una modifica nel progetto e del suo nuovo trasferimento.
La chiave può essere inserita anche direttamente richiamando il monitor HS tramite parametro nell'URL.
Il monitor HS ricorda la chiave fino a che non viene chiuso il browser.
Deve essere inserita questa chiave al primo avvio del monitor HS oppure se la chiave è cambiata, ad esempio a seguito di una modifica nel progetto e del suo nuovo trasferimento.
La chiave può essere inserita anche direttamente richiamando il monitor HS tramite parametro nell'URL.
Esempi di richiamo
Esempio di richiamo su HS/FS con indirizzo IP 192.168.0.11 con comunicazione sicura:
Durante il richiamo è possibile indicare la chiave (vedere Impostazioni).
Esempio dello stesso richiamo con indicazione della chiave "my123key":
HTTPS://192.168.0.11/opt/hsmonitor/index.htmlDurante il richiamo è possibile indicare la chiave (vedere Impostazioni).
Esempio dello stesso richiamo con indicazione della chiave "my123key":
HTTPS://192.168.0.11/opt/hsmonitor/index.html#key=my123key2.Monitor HS
La rappresentazione del monitor HS è composta da tre aree e una maschera pop-up:
- Area 1: riga di intestazione
- Area 2: maschera oggetti di c.
- Area 3: maschera protocollo
2.1.Intestazione
L'intestazione costituisce l'intera parte superiore della pagina web.
Qui si trovano i tab per cambiare la visualizzazione, l'indicatore di stato della connessione e il tasto per richiamare la guida.
Qui si trovano i tab per cambiare la visualizzazione, l'indicatore di stato della connessione e il tasto per richiamare la guida.
Tab Oggetti di c.
Mostra la maschera Oggetti di c. con l'elenco degli oggetti di c. a disposizione nel progetto e la barra azioni. Questa è la visualizzazione iniziale del monitor HS.
Tab Protocollo
Mostra la maschera Protocollo.
Ogni voce nell'elenco mostra un telegramma per uno degli oggetti di c. selezionato nella maschera Oggetti di c. per la protocollazione (ovvero è attivata la casella di controllo dell'oggetto di c. in questione nella colonna sinistra).
Se al momento è attiva la maschera Oggetti di c., in alto a destra accanto al tab Protocollo viene visualizzato un badge non appena viene ricevuto un nuovo telegramma. In questo badge viene visualizzato il numero dei telegrammi ricevuti da quando è stata chiusa la maschera Protocollo (o all'avvio del monitor HS se la maschera Protocollo non è ancora stata richiamata).
Quando viene visualizzata nuovamente la maschera Protocollo il badge viene rimosso e il conteggio riparte da zero.
Ogni voce nell'elenco mostra un telegramma per uno degli oggetti di c. selezionato nella maschera Oggetti di c. per la protocollazione (ovvero è attivata la casella di controllo dell'oggetto di c. in questione nella colonna sinistra).
Se al momento è attiva la maschera Oggetti di c., in alto a destra accanto al tab Protocollo viene visualizzato un badge non appena viene ricevuto un nuovo telegramma. In questo badge viene visualizzato il numero dei telegrammi ricevuti da quando è stata chiusa la maschera Protocollo (o all'avvio del monitor HS se la maschera Protocollo non è ancora stata richiamata).
Quando viene visualizzata nuovamente la maschera Protocollo il badge viene rimosso e il conteggio riparte da zero.
Stato della connessione
Accanto alla scritta "Monitor HS", a sinistra, è presente un simbolo con due frecce. Questo simbolo mostra lo stato attuale della connessione tra monitor HS (nel browser) e HS/FS.
Questo simbolo può assumere due colori:
Questo simbolo può assumere due colori:
- Verde: è presente una connessione attiva.
- Rosso: al momento non è presente connessione.
Avvertenza
Tenere presente che in caso di riconnessione con HS/FS la casella di controllo per la funzione Protocollo di tutti gli oggetti di c. è disattivata e la colonna "Num. / Count" viene azzerata!
L'elenco Protocollo non viene cancellato in caso di interruzione della connessione o in caso di riconnessione!
L'elenco Protocollo non viene cancellato in caso di interruzione della connessione o in caso di riconnessione!
2.2.Maschera oggetti di c.
Qui viene visualizzato l'elenco degli oggetti di c. abilitati per la visualizzazione nel progetto HS/FS.
Ogni oggetto di c. viene rappresentato esattamente da una riga dell'elenco.
Le informazioni sulle singole colonne dell'elenco sono indicate al paragrafo Elenco degli oggetti di c..
Facendo clic su una riga è possibile selezionarla per eseguire azioni speciali:
Ogni oggetto di c. viene rappresentato esattamente da una riga dell'elenco.
Le informazioni sulle singole colonne dell'elenco sono indicate al paragrafo Elenco degli oggetti di c..
Facendo clic su una riga è possibile selezionarla per eseguire azioni speciali:
2.2.1.Elenco degli oggetti di c.
Elenco di tutti gli oggetti di c. abilitati nel progetto Expert, ordinati per indirizzo di gruppo.
Significato delle singole colonne:
Significato delle singole colonne:
| Colonna | Spiegazione |
|---|---|
| Colonna 1 | Casella di controllo per selezionare le voci da protocollare. Ogni oggetto di c. selezionato viene registrato nel Protocollo / Protocol. |
| Ind. gruppo | Indirizzo di gruppo in formato x/y/z. |
| Nome | Nome dell'oggetto di c.. |
| Num. / Count | Numero dei telegrammi ricevuti dall'avvio del monitor HS. |
| Ora / Time | Ora di ricezione dell'ultimo telegramma. |
| Valore / Value | Valore attuale dell'oggetto di c.. |
| Tipo / Type | Formato dell'oggetto di c. Sono possibili le seguenti immissioni:
|
| Min | Minimo Valore minimo possibile definito in Expert per l'oggetto di c.. |
| Max | Massimo Valore massimo possibile definito in Expert per l'oggetto di c.. |
| S L | Abbreviazione di Incremento / Step e Elenco / List Se per l'oggetto di c. in questione è stato definito in Expert un incremento / step, qui viene visualizzata una S. Se nell'Expert è definito per l'oggetto di c. in questione un elenco / list, qui viene visualizzata una L. |
2.2.2.Barra azioni
La barra azioni sul bordo destro della maschera Oggetti di c. consente di filtrare la lista accanto e/o assegnare nuovi valori ai singoli oggetti di c..
Ciò non si applica agli oggetti di c. con formato "date" e "time" che non possono venire modificati con monitor HS ma solo visualizzati.
Per modificare un oggetto di c. deve essere prima di tutto selezionata la riga corrispondente facendo clic su di essa. La riga viene rappresentata con sfondo grigio.
Ciò non si applica agli oggetti di c. con formato "date" e "time" che non possono venire modificati con monitor HS ma solo visualizzati.
Per modificare un oggetto di c. deve essere prima di tutto selezionata la riga corrispondente facendo clic su di essa. La riga viene rappresentata con sfondo grigio.
Filtra (simbolo lente di ingrandimento)
È possibile filtrare l'elenco degli oggetti di c.: non appena viene applicato un filtro vengono visualizzati volta volta gli oggetti di c. che soddisfano i criteri del filtro.
- I risultati iniziano ad essere filtrati non appena viene inserito il primo carattere.
- Inserendo il secondo carattere viene aggiornato il filtro.
- È possibile indicare più filtri inserendo spazi: questi presentano collegamento logico AND.
- L'ordine dei filtri indicati non è rilevante.
- I criteri di filtraggio vengono applicati ai campi "Ind. gruppo" e "Nome".
- Per rimuovere il filtro, cancellare il contenuto del campo Filtro.
Avvertenza
La selezione delle righe non influisce sui risultati filtrati.
Nella guida di Expert al capitolo "Oggetti di comunicazione" viene spiegato come si comportano gli oggetti di c. in caso di assegnazione di valori che non rientrano nei limiti min./max. definiti.
Nella guida di Expert al capitolo "Oggetti di comunicazione" viene spiegato come si comportano gli oggetti di c. in caso di assegnazione di valori che non rientrano nei limiti min./max. definiti.
Applica valore / Send Value
Inserire prima di tutto un valore nel campo di immissione: il valore dell'oggetto di c. viene modificato di conseguenza facendo clic su uno dei due pulsanti:
- Assoluto / Absolute: il valore attuale dell'oggetto di c. viene impostato sul valore inserito.
- Relativo / Relative: al valore inserito viene addizionato il valore attuale dell'oggetto di c..
Avvertenza
Per sottrarre un valore inserire il valore anteposto dal segno "-" e fare clic su Relativo / Relative.
Incremento / Step
Avvertenza
Questa casella di immissione è visibile solo se è stato definito un incremento per l'oggetto di c. nel progetto.
Viene visualizzato l'incremento.
Facendo clic su uno dei due pulsanti ("+" o "-") viene aggiunto l'incremento al valore attuale dell'oggetto di c. (pulsante "+") o viene sottratto (pulsante "-").
Facendo clic su uno dei due pulsanti ("+" o "-") viene aggiunto l'incremento al valore attuale dell'oggetto di c. (pulsante "+") o viene sottratto (pulsante "-").
2.3.Maschera Protocollo
In questa maschera viene mostrato l'elenco dei telegrammi ricevuti.
Inoltre è possibile qui cancellare e/o esportare l'elenco.
Inoltre è possibile qui cancellare e/o esportare l'elenco.
2.3.1.Elenco dei telegrammi ricevuti
| Colonna | Spiegazione |
|---|---|
| Ora / Time | Ora in cui è avvenuta l'assegnazione del valore. |
| Ind. gruppo | Indirizzo di gruppo. |
| Valore / Value | Valore assegnato all'oggetto di c.. |
| Nome | Nome dell'oggetto di c.. |
| Tipo / Type | Formato dell'oggetto di c. Sono possibili le seguenti immissioni:
|
Avvertenza
La disattivazione di uno o più oggetti di c. non influisce sulle righe visualizzate in questo momento nell'elenco.
Avvertenza
L'aggiornamento sia manuale che automatico (ad esempio in caso di nuovo trasferimento del progetto all'HS/FS) del browser non influisce sulle assegnazioni di valori visualizzati in questo momento nell'elenco.
La cancellazione o la modifica di oggetti di c. nel progetto per i quali sono già presenti voci nell'elenco, non influisce sulle voci stesse, anche in caso di nuovo trasferimento del progetto.
La cancellazione o la modifica di oggetti di c. nel progetto per i quali sono già presenti voci nell'elenco, non influisce sulle voci stesse, anche in caso di nuovo trasferimento del progetto.
2.3.2.Barra di modifica
Nella barra di modifica sul bordo destro della maschera Protocollo sono disponibili opzioni per la modifica dell'elenco e l'ulteriore elaborazione dei dati rappresentati.
3.FAQ
Problema: vengono solo visualizzati gli indirizzi di gruppo e i valori.
Soluzione: in Expert, in Dati principali -> Impostazioni progetto -> Rete -> Gateway OC deve essere attivata l'opzione "Trasferisci la struttura XML degli oggetti di c. sul dispositivo".
Problema: non vengono visualizzati indirizzi di gruppo nella maschera Oggetti di c..
Questo errore è riconducibile a più cause:
- Errore nella configurazione per l'accesso
- Errore nella configurazione per il setup
- L'indirizzo IP del dispositivo sul quale viene fatto funzionare il monitor HS non è presente nell'elenco degli indirizzi mittente consentiti:
- Expert: Dati principali -> Impostazioni progetto -> Rete -> Gateway OC - L'indirizzo IP del dispositivo sul quale viene fatto funzionare il monitor HS è nell'elenco degli indirizzi mittente consentiti ma la chiave definita nell'elenco è diversa da quella inserita dall'utente nel browser:
- Richiamo
- Impostazioni
- Expert: Dati principali -> Impostazioni progetto -> Rete -> Gateway OC
Problema: non vengono visualizzati tutti gli indirizzi di gruppo nella maschera Oggetti di c..
Questo errore è riconducibile a più cause:
- Alcune opzioni in Expert sono disattivate:
Una o entrambe delle seguenti opzioni in Dati principali -> Impostazioni progetto -> Rete -> Gateway OC:- Attivare la ricezione di tutti gli oggetti di c.
- Attiva l'invio di tutti gli oggetti di c.
- Ricezione gateway OC
- Invio gateway OC
Soluzione: attivare nei singoli oggetti di c. le opzioni di ricezione e/o invio per visualizzare gli oggetti di c. in questione, oppure attivare nelle impostazioni del gateway OC le opzioni di ricezione e/o invio, per poter visualizzare tutti gli oggetti di c. con indirizzo di gruppo assegnato indipendentemente dalle impostazioni dei singoli oggetti di c.. - Non sono stati assegnati indirizzi di gruppo agli oggetti di c. mancanti:
Soluzione: inserire un indirizzo di gruppo per ogni oggetto di c. desiderato in Dati principali -> Oggetti di comunicazione.