1.Introduzione
"Monitor HS" è una funzione consultabile da browser con la quale è possibile inviare e ricevere telegrammi da indirizzi di gruppo (IG).
Ogni indirizzo di gruppo rappresenta un oggetto di c. (KNX) 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 richiamabile dalla scheda C.-OBJECTS, che contiene una sola voce (una riga) per indirizzo di gruppo. Questa voce contiene l’indirizzo di gruppo, il valore attuale, il nome dell’oggetto di c. e ulteriori informazioni.
In un secondo elenco richiamabile dalla scheda PROTOCOL vengono protocollati tutti i telegrammi di indirizzi di gruppo contrassegnati in precedenza dall’utente. Questo elenco può essere esportato come file ".csv".
Ogni indirizzo di gruppo rappresenta un oggetto di c. (KNX) 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 richiamabile dalla scheda C.-OBJECTS, che contiene una sola voce (una riga) per indirizzo di gruppo. Questa voce contiene l’indirizzo di gruppo, il valore attuale, il nome dell’oggetto di c. e ulteriori informazioni.
In un secondo elenco richiamabile dalla scheda PROTOCOL vengono protocollati tutti i telegrammi di indirizzi di gruppo contrassegnati in precedenza dall’utente. Questo elenco può essere esportato come file ".csv".
1.1.Requisiti
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 59 o superiore
- Google Chrome, versione 65 o superiore
- Microsoft Edge versione 41 o superiore
- Microsoft Internet Explorer, versione 11 o superiore
- Google Chrome Android 66
- iOS Safari 11
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 sono rilevante le seguenti impostazioni:
Queste e tutte le altre opzioni sono descritte nella guida Expert relativa al gateway OC.
| Impostazione | Obbligo / Opzione | Commento |
|---|---|---|
| Attiva WebSocket | Obbligo | |
| Carica la struttura XML degli oggetti di c. sul dispositivo | Obbligo | |
| Attiva la ricezione di tutti gli oggetti di c. | Opzionale | Se attivata, vengono ricevuti i telegrammi da tutti gli oggetti di c. dotati di indirizzi di gruppo nell’HS/FS, vale a dire che tramite il monitor HS è possibile modificarne i valori. Se non attivata, possono essere ricevuti solo i telegrammi dagli oggetti di c. (con indirizzi di gruppo), per i quali è attivata l’opzione "Ricezione gateway OC". Attenzione Vengono visualizzati solo gli indirizzi di gruppo in C.-OBJECTS che possono essere inviati anche tramite il gateway OC! |
| Attiva l'invio di tutti gli oggetti di c. | Opzionale | Se attivata, possono essere ricevuti i telegrammi inviati dall’HS/FS con modifiche del valore da tutti gli oggetti di c. dotati di indirizzi di gruppo nel monitor HS. Se non attivata, possono essere inviati telegrammi solo ad oggetti di c. (con indirizzi di gruppo), per i quali è attivata l’opzione "Invio gateway OC". |
Richiamo
Per richiamare il monitor HS nel browser accedere al seguente URL:
oppure
HTTPS://HS_IP/opt/hsmonitor/index.htmloppure
HTTPS://HS_IP/opt/hsmonitor/index.html#key=[codice]Login
In determinate circostanze (vedere sotto) viene visualizzata la maschera di login e viene richiesta l’immissione di un codice, prima di poter accedere al monitor HS. Deve essere immesso il codice definito nel progetto per la connessione 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.
Il codice può essere indicato anche direttamente al richiamo del monitor HS come parametro nell’URL (seconda delle possibilità di richiamo sopra indicate).
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.
Il codice può essere indicato anche direttamente al richiamo del monitor HS come parametro nell’URL (seconda delle possibilità di richiamo sopra indicate).
Esempi di richiamo
Esempio di richiamo su HS/FS con indirizzo IP 192.168.0.11 con comunicazione sicura:
Al richiamo è possibile indicare il codice (vedere la maschera Login).
Esempio dello stesso richiamo con indicazione della chiave "my123key":
HTTPS://192.168.0.11/opt/hsmonitor/index.htmlAl richiamo è possibile indicare il codice (vedere la maschera Login).
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: Intestazione
- Area 2: Elenco degli oggetti di c. (scheda C.-OBJECTS)
- Area 3: Maschera Protocollo (scheda PROTOCOL)
2.1.Intestazione
L'intestazione costituisce l'intera parte superiore della pagina web.
Qui si trovano le schede per commutare la visualizzazione, l’indicatore di stato della connessione e il tasto per richiamare la guida.
Qui si trovano le schede per commutare la visualizzazione, l’indicatore di stato della connessione e il tasto per richiamare la guida.
Scheda C.-OBJECTS
Facendo clic sulla scheda viene visualizzato l’elenco degli oggetti di c.. Questa è la visualizzazione iniziale del monitor HS.
Scheda PROTOCOL
Facendo clic sulla scheda viene visualizzato il protocollo dei telegrammi in ingresso.
Ogni voce nell’elenco mostra un telegramma per uno degli oggetti di c. selezionato nell’elenco degli oggetti di c. per la protocollazione (ciò significa che la casella di controllo dell’oggetto di c. in questione nella colonna sinistra è attivata).
Ogni voce nell’elenco mostra un telegramma per uno degli oggetti di c. selezionato nell’elenco degli oggetti di c. per la protocollazione (ciò significa che la casella di controllo dell’oggetto di c. in questione nella colonna sinistra è attivata).
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 l’HS/FS la casella di controllo per la funzione Protocollo di tutti gli oggetti di c. è disattivata e tutti i valori nella colonna "Totale" vengono impostati sullo "0"!
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.Scheda C.-OBJECTS
Facendo clic sulla scheda "C-OBJECTS" viene visualizzato l’elenco degli oggetti di c.
In alto viene visualizzata la riga d’immissione per il filtro degli indirizzi di gruppo.
Sotto viene visualizzato l’elenco degli oggetti di c. abilitati per la visualizzazione nel progetto HS/FS attuale.
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, questa può essere selezionata per diverse azioni.
Se la larghezza dello schermo del dispositivo di visualizzazione attualmente utilizzato o del browser è superiore o uguale a 1024 pixel, a destra accanto all’elenco degli oggetti di c. viene visualizzato un riquadro con i dati relativi all’oggetto di c. attualmente selezionato.
In caso contrario, questo riquadro viene visualizzato come finestra pop-up.
In alto viene visualizzata la riga d’immissione per il filtro degli indirizzi di gruppo.
Sotto viene visualizzato l’elenco degli oggetti di c. abilitati per la visualizzazione nel progetto HS/FS attuale.
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, questa può essere selezionata per diverse azioni.
Se la larghezza dello schermo del dispositivo di visualizzazione attualmente utilizzato o del browser è superiore o uguale a 1024 pixel, a destra accanto all’elenco degli oggetti di c. viene visualizzato un riquadro con i dati relativi all’oggetto di c. attualmente selezionato.
In caso contrario, questo riquadro viene visualizzato come finestra pop-up.
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 delle colonne "IG" e "Nome".
- Per rimuovere il filtro, cancellare il contenuto del campo Filtro.
Avvertenza
La selezione delle righe non influisce sui risultati filtrati.
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 |
|---|---|
[] | Casella di controllo per selezionare le voci da protocollare. Ogni telegramma a questo indirizzo di gruppo viene registrato nel protocollo. Facendo clic sulla casella di controllo nella riga del titolo, tutti gli oggetti di c. attualmente visualizzati nell’elenco (in caso di un filtro attivo solo una parte della totalità!) vengono attivati o disattivati. |
GA | Indirizzo di gruppo in formato x/y/z. |
Name | Nome / denominazione dell’oggetto di c. |
Total | Numero dei telegrammi ricevuti dall'avvio del monitor HS. |
Timestamp | Ora di ricezione dell'ultimo telegramma. |
Value | Valore attuale dell'oggetto di c.. |
2.2.2.Casella info Oggetto di c.
Se la larghezza dello schermo del dispositivo di visualizzazione attualmente utilizzato o del browser è superiore o uguale a 1024 pixel, a destra accanto all’elenco degli oggetti di c. viene visualizzato un riquadro con i dati relativi all’oggetto di c. attualmente selezionato.
In caso contrario, facendo clic su una riga questo riquadro viene visualizzato come finestra pop-up.
Questo riquadro mostra alcuni dati aggiuntivi e offre alcune azioni per l’oggetto di c. attualmente selezionato.
Fanno eccezione gli oggetti di c. con il formato (Type) "date" e "time", che con il monitor HS non possono essere modificati ma solo visualizzati.
Per modificare un oggetto di c., è necessario prima fare clic sulla riga corrispondente nell’elenco degli oggetti di c. La riga viene rappresentata con sfondo grigio.
In caso contrario, facendo clic su una riga questo riquadro viene visualizzato come finestra pop-up.
Questo riquadro mostra alcuni dati aggiuntivi e offre alcune azioni per l’oggetto di c. attualmente selezionato.
Fanno eccezione gli oggetti di c. con il formato (Type) "date" e "time", che con il monitor HS non possono essere modificati ma solo visualizzati.
Per modificare un oggetto di c., è necessario prima fare clic sulla riga corrispondente nell’elenco degli oggetti di c. La riga viene rappresentata con sfondo grigio.
2.2.2.1.Dati visualizzati dell’oggetto di c. attivo
Nel titolo del riquadro viene visualizzato il nome dell’oggetto di c.
Se il riquadro viene rappresentato come pop-up, a destra è presente anche un tasto "Chiudi".
Nel riquadro vengono visualizzate le seguenti informazioni:
Se il riquadro viene rappresentato come pop-up, a destra è presente anche un tasto "Chiudi".
Nel riquadro vengono visualizzate le seguenti informazioni:
GA | Indirizzo di gruppo dell’oggetto di c. |
|---|---|
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.. |
Step | Se in Expert è definito un incremento per questo oggetto di c., questo viene visualizzato qui. Diversamente: 0 |
List | Se in Expert è definito un elenco con valori consentiti per questo oggetto di c., questo viene visualizzato qui. Diversamente: (vuoto) |
2.2.2.2.Azioni
Tramite il riquadro è possibile eseguire diverse azioni per l’oggetto di c. attivo, a seconda delle proprietà dell’oggetto di c.:
- Non per il tipo date o time:
È possibile inviare un telegramma all’indirizzo di gruppo, per modificare il valore dell’oggetto di c.
A seconda dell’impostazione del pulsante visualizzato, il valore inviato viene impostato direttamente oppure (solo nel caso del tipo "integer" e "number") viene aggiunto al valore attuale.
Facendo clic sulla freccia a destra accanto al campo d’immissione "Send" il telegramma con la modifica del valore viene inviato all’HS/FS. - Solo se nell’oggetto di c. per "Incremento" è indicato un valore maggiore di zero:
Mediante i tasti visibili in questo caso "+ Step" e "- Step” è possibile inviare un telegramma indicante che l’oggetto di c. viene modificato del valore indicato nel campo "Step". - Solo se nell’oggetto di c. per "Elenco" è indicato un elenco di valori:
Mediante i tasti visibili in questo caso "^ List" e "v List" è possibile inviare un telegramma indicante che l’oggetto di c. viene impostato sul valore dell’elenco immediatamente superiore o inferiore partendo dal valore attuale.
Avvertenza
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.
2.3.Scheda PROTOCOL
Facendo clic sulla scheda "PROTOCOL" viene visualizzato il protocollo dei telegrammi ricevuti.
In questa maschera viene visualizzato un elenco dei telegrammi in ingresso con assegnazioni di valori per tutti gli oggetti di c. che sono stati attivati nella maschera C.-OBJECTS mediante la casella di controllo nell’elenco "IG".
L’elenco è limitato ad un massimo di 50.000 voci e ordinato in base alla data di ingresso, con la più recente in alto. Il livello di riempimento attuale viene visualizzato in alto a sinistra.
Mediante i simboli a destra al di sopra dell’elenco sono disponibili alcune operazioni.
Mediante il campo di ricerca visualizzato sopra all’elenco è possibile cercare voci nell’elenco e saltarle selezionando i tasti a destra ("Freccia verso l’alto" e "Freccia verso il basso").
In questa maschera viene visualizzato un elenco dei telegrammi in ingresso con assegnazioni di valori per tutti gli oggetti di c. che sono stati attivati nella maschera C.-OBJECTS mediante la casella di controllo nell’elenco "IG".
L’elenco è limitato ad un massimo di 50.000 voci e ordinato in base alla data di ingresso, con la più recente in alto. Il livello di riempimento attuale viene visualizzato in alto a sinistra.
Mediante i simboli a destra al di sopra dell’elenco sono disponibili alcune operazioni.
Mediante il campo di ricerca visualizzato sopra all’elenco è possibile cercare voci nell’elenco e saltarle selezionando i tasti a destra ("Freccia verso l’alto" e "Freccia verso il basso").
2.3.1.Effetti delle azioni sull’elenco
Se la registrazione dei telegrammi ad un indirizzo di gruppo nella maschera C.-OBJECTS viene soppressa (la casella di controllo nella colonna "IG" viene disattivata), questo non influisce sulle righe in quel momento già visualizzate nell’elenco per questo indirizzo di gruppo.
Se il browser viene aggiornato manualmente o anche automaticamente (ad es. in caso di ritrasmissione del progetto all’HS/FS), questo non influisce sulle righe al momento già visualizzate nell’elenco.
Se nel progetto vengono cancellati o modificati oggetti di c. per i quali esistono già delle voci nell’elenco, questo non influisce (né direttamente, né dopo la ritrasmissione del progetto) sulle righe in quel momento già visualizzate nell’elenco per questi indirizzi di gruppo.
Se il browser viene aggiornato manualmente o anche automaticamente (ad es. in caso di ritrasmissione del progetto all’HS/FS), questo non influisce sulle righe al momento già visualizzate nell’elenco.
Se nel progetto vengono cancellati o modificati oggetti di c. per i quali esistono già delle voci nell’elenco, questo non influisce (né direttamente, né dopo la ritrasmissione del progetto) sulle righe in quel momento già visualizzate nell’elenco per questi indirizzi di gruppo.
2.3.2.Operazioni degli elenchi
| Simbolo | Spiegazione |
|---|---|
| [n] / 50000 | livello di riempimento attuale dell’elenco e valore massimo. Se l’elenco è pieno, all’ingresso di un nuovo telegramma il più vecchio viene eliminato. |
| Freccia verso il basso | Download dell’elenco. Si apre una finestra di dialogo File, che consente di salvare l’elenco attuale come file ".csv". |
| Cestino | Svuota l’elenco attualmente visualizzato |
| Log | Con il cursore è possibile interrompere temporaneamente la protocollazione dei telegrammi, senza modificare la selezione effettuata tramite la colonna "IG" nella maschera C.-OBJECTS. Attivando o disattivando la protocollazione, l’elenco non viene svuotato. |
2.3.3.Elenco dei telegrammi in ingresso
Vengono registrati tutti i telegrammi, vale a dire che vengono visualizzati anche i telegrammi che assegnano ad un oggetto di c. lo stesso valore che possiede già.
Significato delle singole colonne:
Significato delle singole colonne:
| Colonna | Spiegazione |
|---|---|
Time | Ora di ricezione dell'ultimo telegramma. |
GA | Indirizzo di gruppo in formato x/y/z. |
Value | Valore attuale dell'oggetto di c.. |
Type | Formato dell'oggetto di c. Sono possibili le seguenti immissioni:
|
Name | Nome / denominazione dell’oggetto di c. |
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: Nell’elenco degli oggetti di c. non vengono visualizzati indirizzi di gruppo.
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:- Attiva 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.