1.Einführung
HS-Monitor ist eine im Browser aufrufbare Funktion, die Telegramme von Gruppenadressen (GA) empfangen und an Gruppenadressen senden kann.
Jede Gruppenadresse steht entweder für ein internes oder ein externes (KNX) K-Objekt des HS/FS, das in der Experte-Software für die Benutzung mit HS-Monitor freigegeben wurde.
Die Gruppenadressen werden in einer Liste dargestellt, aufrufbar über den Reiter C.-OBJECTS, die jeweils genau einen Eintrag (eine Zeile) pro Gruppenadresse enthält. Dieser Eintrag enthält die Gruppenadresse, den aktuellen Wert, den Namen des K-Objekts und weitere Informationen.
In einer zweiten Liste, aufrufbar über den Reiter PROTOCOL, werden alle Telegramme von zuvor vom Benutzer markierten Gruppenadressen protokolliert. Diese Liste kann als ".csv"-Datei exportiert werden.
Jede Gruppenadresse steht entweder für ein internes oder ein externes (KNX) K-Objekt des HS/FS, das in der Experte-Software für die Benutzung mit HS-Monitor freigegeben wurde.
Die Gruppenadressen werden in einer Liste dargestellt, aufrufbar über den Reiter C.-OBJECTS, die jeweils genau einen Eintrag (eine Zeile) pro Gruppenadresse enthält. Dieser Eintrag enthält die Gruppenadresse, den aktuellen Wert, den Namen des K-Objekts und weitere Informationen.
In einer zweiten Liste, aufrufbar über den Reiter PROTOCOL, werden alle Telegramme von zuvor vom Benutzer markierten Gruppenadressen protokolliert. Diese Liste kann als ".csv"-Datei exportiert werden.
1.1.Voraussetzungen
Voraussetzung für die Nutzung von HS-Monitor:
Hard- und Software:
Hard- und Software:
- Home- oder FacilityServer mit einer Firmware ab Version 4.7.x.
- Experten-Software ab Version 4.7.x.
- Mozilla Firefox ab Version 59
- Google Chrome ab Version 65
- Microsoft Edge ab Version 41
- Microsoft Internet Explorer ab Version 11
- Google Chrome Android 66
- iOS Safari 11
1.2.Installation, Einrichtung, Zugriff und Aufruf
Achtung
Nach einer Änderung im Experte bei den folgenden Einstellungen muss das Projekt neu übertragen werden!
Zugriff
Um HS-Monitor nutzen zu können, muss eine der beiden folgenden Einstellungen im HS/FS-Experte unter der Rubrik Stammdaten -> Projekteinstellungen -> Oberfläche aktiviert werden:
Entweder
Entweder
- muss die Option Alle aktiviert sein,
- die Option Benutzerdefiniert muss aktiviert sein
und
die Checkbox hsmonitor muss aktiviert sein.
Einrichtung
Im HS/FS-Experte unter der Rubrik Stammdaten -> Projekteinstellungen -> Netzwerk -> KO-Gateway sind folgende Einstellungen von Bedeutung:
Diese, und alle weiteren Optionen, werden in der Experte-Hilfe zum KO-Gateway beschrieben.
| Einstellung | Pflicht / Option | Kommentar |
|---|---|---|
| WebSocket aktivieren | Pflicht | |
| XML-Struktur der K-Objekte auf Gerät laden | Pflicht | |
| Empfangen für alle K-Objekte aktivieren | Optional | Falls aktiviert, werden Telegramme von allen mit Gruppenadressen versehenen K-Objekten im HS/FS empfangen, d.h. über HS-Monitor können deren Werte verändert werden. Falls nicht aktiviert, können nur Telegramme von K-Objekten (mit Gruppenadressen) empfangen werden, bei denen die Option "KO-Gateway empfangen" aktiviert ist. Achtung Es werden nur diejenigen Gruppenadressen unter C.-OBJECTS angezeigt, die auch über das KO-Gateway gesendet werden dürfen! |
| Senden für alle K-Objekte aktivieren | Optional | Falls aktiviert, können vom HS/FS gesendete Telegramme mit Wert-Änderungen von allen mit Gruppenadressen versehenen K-Objekten im HS-Monitor empfangen werden. Falls nicht aktiviert, können nur Telegramme an K-Objekte (mit Gruppenadressen) gesendet werden, bei denen die Option "KO-Gateway senden" aktiviert ist. |
Aufruf
HS-Monitor wird im Browser unter der folgenden URL aufgerufen:
oder
HTTPS://HS_IP/opt/hsmonitor/index.htmloder
HTTPS://HS_IP/opt/hsmonitor/index.html#key=[Schlüssel]Login
Bei bestimmten Gelegenheiten (siehe unten) wird die Login Maske angezeigt und die Eingabe eines Schlüssels verlangt, bevor auf HS-Monitor zugegriffen werden kann. Es muss der im Projekt definierte Schlüssel für die KO-Gateway Datenverbindung angegeben werden.
HS-Monitor merkt sich diesen Schlüssel solange, bis der Browser beendet wird.
HS-Monitor verlangt eine Eingabe dieses Schlüssel beim ersten Start, oder wenn sich der Schlüssel, z.B. nach Änderung im Projekt und dessen Neu-Übertragung, geändert hat.
Der Schlüssel kann auch direkt beim Aufruf von HS-Monitor als Parameter in der URL angegeben werden (zweite der o.a. angegebenen Aufruf-Möglichkeiten).
HS-Monitor merkt sich diesen Schlüssel solange, bis der Browser beendet wird.
HS-Monitor verlangt eine Eingabe dieses Schlüssel beim ersten Start, oder wenn sich der Schlüssel, z.B. nach Änderung im Projekt und dessen Neu-Übertragung, geändert hat.
Der Schlüssel kann auch direkt beim Aufruf von HS-Monitor als Parameter in der URL angegeben werden (zweite der o.a. angegebenen Aufruf-Möglichkeiten).
Aufruf-Beispiele
Beispiel für einen Aufruf auf einem HS/FS mit der IP-Adresse 192.168.0.11 mit sicherer Kommunikation:
Beim Aufruf kann der Schlüssel mit angegeben werden (siehe Login Maske).
Beispiel für denselben Aufruf mit Angabe des Schlüssels "my123key":
HTTPS://192.168.0.11/opt/hsmonitor/index.htmlBeim Aufruf kann der Schlüssel mit angegeben werden (siehe Login Maske).
Beispiel für denselben Aufruf mit Angabe des Schlüssels "my123key":
HTTPS://192.168.0.11/opt/hsmonitor/index.html#key=my123key2.HS-Monitor
Die Darstellung des HS-Monitor gliedert sich in drei Bereiche und eine PopUp-Maske:
- Bereich 1: Kopfzeile
- Bereich 2: Liste der K-Objekte (Reiter C.-OBJECTS)
- Bereich 3: Protokoll-Maske (Reiter PROTOCOL)
2.1.Kopfzeile
Die Kopfzeile bildet den kompletten oberen Bereich der Webseite.
Hier befinden sich die Reiter zur Umschaltung der Anzeige, der Verbindungs-Status Anzeiger und der Button für den Aufruf der Hilfe.
Hier befinden sich die Reiter zur Umschaltung der Anzeige, der Verbindungs-Status Anzeiger und der Button für den Aufruf der Hilfe.
Reiter C.-OBJECTS
Bei Klick auf den Reiter wird die Liste der K-Objekte angezeigt. Mit dieser Darstellung startet HS-Monitor.
Reiter PROTOCOL
Bei Klick auf den Reiter wird das Protokoll der eingegangenen Telegramme angezeigt.
Jeder Eintrag in der Liste zeigt ein Telegramm zu einem der K-Objekte an, das in der Liste der K-Objekte zum Protokollieren markiert wurde (d.h., die Checkbox des betreffenden K-Objekts in der linken Spalte ist aktiviert).
Jeder Eintrag in der Liste zeigt ein Telegramm zu einem der K-Objekte an, das in der Liste der K-Objekte zum Protokollieren markiert wurde (d.h., die Checkbox des betreffenden K-Objekts in der linken Spalte ist aktiviert).
Verbindungs-Status
Links neben dem Schriftzug "HS-Monitor" befindet sich ein Symbol, das zwei Pfeile anzeigt. Dieses Symbol zeigt den aktuellen Verbindungs-Status zwischen HS-Monitor (im Browser) und HS/FS an.
Dieses Symbol kann zwei Farben annehmen:
Dieses Symbol kann zwei Farben annehmen:
- Grün: Es besteht eine aktive Verbindung.
- Rot: Es besteht momentan keine Verbindung.
Hinweis
Beachten Sie, dass beim erneuten Verbinden mit dem HS/FS bei allen K-Objekten die Checkbox für die Protokoll-Funktion deaktiviert und alle Werte in der Spalte "Total" auf '0' gesetzt werden!
Die Protokoll-Liste wird bei einem Verbindungs-Abbruch bzw. beim erneuten Verbinden nicht gelöscht!
Die Protokoll-Liste wird bei einem Verbindungs-Abbruch bzw. beim erneuten Verbinden nicht gelöscht!
2.2.Reiter C.-OBJECTS
Bei Klick auf den Reiter "C.-OBJECTS" wird die Liste der K-Objekte angezeigt.
Zuoberst wird die Eingabe-Zeile für den Gruppenadressen-Filter angezeigt.
Darunter wird die Liste der im aktuellen HS/FS-Projekt zum Anzeigen freigegebenen K-Objekte angezeigt.
Jedes K-Objekt wird durch genau eine Zeile in der Liste repräsentiert.
Die Angaben zu den einzelnen Spalten der Liste finden Sie unter dem Punkt Liste der K-Objekte.
Durch Anklicken einer Zeile kann diese für verschiedene Aktionen ausgewählt werden.
Ist die Bildschirmbreite des aktuell verwendeten Anzeige-Geräts oder Browsers größer oder gleich 1024 Pixel, wird eine Box mit den Angaben zum aktuell ausgewählten K-Objekt rechts neben der Liste der K-Objekte angezeigt.
Anderenfalls wird diese Box stattdessen als PopUp-Fenster angezeigt.
Zuoberst wird die Eingabe-Zeile für den Gruppenadressen-Filter angezeigt.
Darunter wird die Liste der im aktuellen HS/FS-Projekt zum Anzeigen freigegebenen K-Objekte angezeigt.
Jedes K-Objekt wird durch genau eine Zeile in der Liste repräsentiert.
Die Angaben zu den einzelnen Spalten der Liste finden Sie unter dem Punkt Liste der K-Objekte.
Durch Anklicken einer Zeile kann diese für verschiedene Aktionen ausgewählt werden.
Ist die Bildschirmbreite des aktuell verwendeten Anzeige-Geräts oder Browsers größer oder gleich 1024 Pixel, wird eine Box mit den Angaben zum aktuell ausgewählten K-Objekt rechts neben der Liste der K-Objekte angezeigt.
Anderenfalls wird diese Box stattdessen als PopUp-Fenster angezeigt.
Filter (Lupen-Symbol)
Die Liste der K-Objekte kann gefiltert werden, d.h. es werden, sobald ein Filter eingegeben wird, nur noch die zum Filter passenden K-Objekte angezeigt.
- Die Filterung beginnt nach der Eingabe des ersten Zeichens.
- Bei der Eingabe jedes weiteren Zeichens wird der Filter aktualisiert.
- Es können mehrere durch Leerzeichen getrennte Filter angegeben werden, die UND-verknüpft angewendet werden.
- Die Reihenfolge der angegebenen Filter spielt keine Rolle.
- Die Filterkriterien werden auf die Felder der Spalten "GA" und "Name" angewendet.
- Um die Filterung aufzuheben, muss das Filterfeld geleert werden.
Hinweis
Das Selektieren einer Zeile hat keinen Einfluss auf die Filterung.
2.2.1.Liste der K-Objekte
Auflistung aller im Experte-Projekt freigegebenen K-Objekte, sortiert nach Gruppenadresse.
Bedeutung der einzelnen Spalten:
Bedeutung der einzelnen Spalten:
| Spalte | Erklärung |
|---|---|
[] | Checkbox für die Kennzeichnung zur Protokollierung. Jedes Telegramm zu dieser Gruppenadresse wird im Protokoll aufgezeichnet. Bei Klick auf die Checkbox in der Titelzeile werden alle in der Liste aktuell angezeigten K-Objekte (bei einem aktiven Filter ist das nur ein Teil der Gesamtmenge!) aktiviert bzw. deaktiviert. |
GA | Gruppenadresse im Format x/y/z. |
Name | Name / Bezeichnung des K-Objekts. |
Total | Anzahl der eingegangenen Telegramme seit Start des HS-Monitor. |
Timestamp | Uhrzeit des letzten eingegangenen Telegramms. |
Value | Aktueller Wert des K-Objekts. |
2.2.2.K-Objekt Infobox
Ist die Bildschirmbreite des aktuell verwendeten Anzeige-Geräts oder Browsers größer oder gleich 1024 Pixel, wird eine Box mit den Angaben zum aktuell ausgewählten K-Objekt rechts neben der Liste der K-Objekte angezeigt.
Anderenfalls wird diese Box beim Klick auf eine Zeile als PopUp-Fenster angezeigt.
Diese Box zeigt einige zusätzliche Angaben und bietet einige Aktionen zum aktuell ausgewählten K-Objekt an.
Ausnahmen sind dabei K-Objekte mit dem Format (Type) "date" und "time", die mit HS-Monitor nicht verändert, sondern nur angezeigt werden können.
Um ein K-Objekt zu verändern, muss zuvor die entsprechende Zeile in der Liste der K-Objekte angeklickt werden. Die Zeile wird dann mit grauem Hintergrund dargestellt.
Anderenfalls wird diese Box beim Klick auf eine Zeile als PopUp-Fenster angezeigt.
Diese Box zeigt einige zusätzliche Angaben und bietet einige Aktionen zum aktuell ausgewählten K-Objekt an.
Ausnahmen sind dabei K-Objekte mit dem Format (Type) "date" und "time", die mit HS-Monitor nicht verändert, sondern nur angezeigt werden können.
Um ein K-Objekt zu verändern, muss zuvor die entsprechende Zeile in der Liste der K-Objekte angeklickt werden. Die Zeile wird dann mit grauem Hintergrund dargestellt.
2.2.2.1.Angezeigte Daten des aktiven K-Objekts
Im Titel der Box wird der Name des K-Objekts angezeigt.
Wird die Box als PopUp dargestellt, ist auf der rechten Seite zusätzlich noch ein "Schließen"-Button vorhanden.
In der Box werden die folgenden Informationen angezeigt:
Wird die Box als PopUp dargestellt, ist auf der rechten Seite zusätzlich noch ein "Schließen"-Button vorhanden.
In der Box werden die folgenden Informationen angezeigt:
GA | Die Gruppenadresse des K-Objekts. |
|---|---|
Type | Format des K-Objekts Folgende Angaben sind möglich:
|
Min | Minimum Der im Experte für das K-Objekt definierte kleinstmögliche Wert. |
Max | Maximum Der im Experte für das K-Objekt definierte größtmögliche Wert. |
Step | Ist im Experte für dieses K-Objekt eine Schrittgröße definiert, wird sie hier angezeigt. Ansonsten: 0 |
List | Ist im Experte für dieses K-Objekt eine Liste mit erlaubten Werten definiert, wird sie hier angezeigt. Ansonsten: (leer) |
2.2.2.2.Aktionen
Über die Box können mehrere Aktionen für das aktive K-Objekt ausgeführt werden, abhängig von den Eigenschaften des K-Objekts:
- Nicht bei Type date oder time:
Es kann ein Telegramm an die Gruppenadresse versendet werden, um den Wert des K-Objekts zu verändern.
Abhängig von der Einstellung des angezeigten Schalters, wird der gesendete Wert entweder direkt gesetzt, oder (nur bei Type "integer" und "number") auf den aktuellen Wert addiert.
Bei Klick auf den Pfeil rechts neben dem Eingabe-Feld "Send" wird das Telegramm mit der Wertänderung an den HS/FS gesendet. - Nur, wenn im K-Objekt bei "Schrittgröße" ein Wert größer als Null angegeben ist:
Über die in diesem Fall sichtbaren Buttons "+ Step" und "- Step", kann ein Telegramm versendet werden, dass das K-Objekt um den im Feld "Step" angegebenen Wert verändert. - Nur, wenn im K-Objekt bei "Liste" ein Werte-Liste angegeben ist:
Über die in diesem Fall sichtbaren Buttons "^ List" und "v List", kann ein Telegramm versendet werden, dass das K-Objekt auf den vom aktuellen Wert ausgehend nächst-höheren bzw. nächst-niedrigeren Listen-Wert setzt.
Hinweis
Das Verhalten von K-Objekten bei Wertzuweisungen außerhalb der für sie definierten Min/Max-Grenzen wird in der Experte-Hilfe im Kapitel "Kommunikationsobjekte" beschrieben.
2.3.Reiter PROTOCOL
Bei Klick auf den Reiter "PROTOCOL" wird das Protokoll der empfangenen Telegramme angezeigt.
In dieser Maske wird eine Liste der eingegangenen Telegramme mit Wertzuweisungen für alle K-Objekte, die in der Maske C.-OBJECTS über die Checkbox in der Spalte "GA" aktiviert wurden, angezeigt.
Die Liste ist auf maximal 50.000 Einträge begrenzt und nach Eingangs-Datum sortiert, neueste oben. Der aktuelle Füllstand wird links oben angezeigt.
Über die Symbole rechts oberhalb der Liste stehen einige Operationen zur Verfügung.
Über das oberhalb der Liste angezeigte Suchfeld können Einträge in der Liste gesucht und über die Buttons rechts ("Pfeil rauf" und "Pfeil runter") angesprungen werden.
In dieser Maske wird eine Liste der eingegangenen Telegramme mit Wertzuweisungen für alle K-Objekte, die in der Maske C.-OBJECTS über die Checkbox in der Spalte "GA" aktiviert wurden, angezeigt.
Die Liste ist auf maximal 50.000 Einträge begrenzt und nach Eingangs-Datum sortiert, neueste oben. Der aktuelle Füllstand wird links oben angezeigt.
Über die Symbole rechts oberhalb der Liste stehen einige Operationen zur Verfügung.
Über das oberhalb der Liste angezeigte Suchfeld können Einträge in der Liste gesucht und über die Buttons rechts ("Pfeil rauf" und "Pfeil runter") angesprungen werden.
2.3.1.Auswirkungen auf die Liste durch Aktionen
Wird die weitere Aufzeichnung der Telegramme zu einer Gruppenadresse in der Maske C.-OBJECTS aufgehoben (Checkbox in Spalte "GA" wird deaktiviert), hat dies keinen Einfluss auf die zu diesem Zeitpunkt bereits in der Liste für diese Gruppenadresse angezeigten Zeilen.
Wird der Browser aktualisiert, entweder manuell, oder auch automatisch (z.B. bei Neu-Übertragung des Projekts auf den HS/FS), hat dies keinen Einfluss auf die zu diesem Zeitpunkt bereits in der Liste angezeigten Zeilen.
Werden K-Objekte im Projekt gelöscht oder geändert, für die bereits Einträge in der Liste bestehen, hat dies (weder direkt, noch nach Neu- Übertragung des Projekts, keinen Einfluss auf die zu diesem Zeitpunkt bereits in der Liste für diese Gruppenadressen angezeigten Zeilen.
Wird der Browser aktualisiert, entweder manuell, oder auch automatisch (z.B. bei Neu-Übertragung des Projekts auf den HS/FS), hat dies keinen Einfluss auf die zu diesem Zeitpunkt bereits in der Liste angezeigten Zeilen.
Werden K-Objekte im Projekt gelöscht oder geändert, für die bereits Einträge in der Liste bestehen, hat dies (weder direkt, noch nach Neu- Übertragung des Projekts, keinen Einfluss auf die zu diesem Zeitpunkt bereits in der Liste für diese Gruppenadressen angezeigten Zeilen.
2.3.2.Listen-Operationen
| Symbol | Erklärung |
|---|---|
| [n] / 50000 | aktueller Füllstand der Liste und Maximalwert. Ist die Liste voll, wird bei Eingang eines neuen Telegramms das älteste entfernt. |
| Pfeil nach unten | Download der Liste. Es wird ein Dateidialog geöffnet, mit dem die aktuelle Liste als ".csv"-Datei gespeichert werden kann. |
| Papierkorb | Leert die aktuell angezeigte Liste |
| Log | Mit dem Schieberegler kann das Protokollieren von Telegrammen zeitweise unterbrochen werden, ohne die über die Spalte "GA" in der Maske C.-OBJECTS getroffenen Auswahl zu verändern. Beim An- oder Abschalten der Protokollierung wird die Liste nicht geleert. |
2.3.3.Liste der eingegangenen Telegramme
Es werden alle Telegramme aufgezeichnet, d.h. es werden auch Telegramme angezeigt, die einem K-Objekt denselben Wert zuweisen, den es berits hat.
Bedeutung der einzelnen Spalten:
Bedeutung der einzelnen Spalten:
| Spalte | Erklärung |
|---|---|
Time | Uhrzeit des letzten eingegangenen Telegramms. |
GA | Gruppenadresse im Format x/y/z. |
Value | Aktueller Wert des K-Objekts. |
Type | Format des K-Objekts Folgende Angaben sind möglich:
|
Name | Name / Bezeichnung des K-Objekts. |
3.FAQ
Problem: Es werden nur die Gruppenadressen und die Werte angezeigt.
Lösung: Im Experte unter Stammdaten -> Projekteinstellungen -> Netzwerk -> KO-Gateway muss die Option "XML-Struktur der K.-Objekte auf Gerät übertragen" aktiviert werden.
Problem: Es werden keine Gruppenadressen in der Liste der K-Objekte angezeigt.
Es gibt mehrere mögliche Ursachen für diesen Fehler:
- Ein Fehler in der Konfiguration für den Zugriff
- Ein Fehler in der Konfiguration für die Einrichtung
- Die IP-Adresse des Geräts, auf dem HS-Monitor läuft, ist nicht in der Liste der erlaubten Absender-Adressen enthalten:
- Experte: Stammdaten -> Projekteinstellungen -> Netzwerk -> KO-Gateway - Die IP-Adresse des Geräts, auf dem HS-Monitor läuft, ist zwar in der Liste der erlaubten Absender-Adressen enthalten, aber der dort definierte Schlüssel ist ein anderer als der, den Sie im Browser angegeben haben:
- Aufruf
- Einstellungen
- Experte: Stammdaten -> Projekteinstellungen -> Netzwerk -> KO-Gateway
Problem: Es fehlen einige Gruppenadressen in der Maske K-Objekte.
Es gibt mehrere mögliche Ursachen für diesen Fehler:
- Im Experte sind bestimmte Optionen deaktiviert:
Unter Stammdaten -> Projekteinstellungen -> Netzwerk -> KO-Gateway eine oder beide der folgenden Optionen:- Empfangen für alle K-Objekte aktivieren
- Senden für alle K-Objekte aktivieren
- KO-Gateway empfangen
- KO-Gateway senden
Lösung: Aktivieren Sie bei den einzelnen K-Objekten die Optionen für "Empfangen" und/oder "Senden", um genau diese K-Objekte anzeigen zu lassen, oder aktivieren Sie in den KO-Gateway-Einstellungen die Optionen für "Empfangen" und/oder "Senden", um unabhängig von den Einstellungen der einzelnen K-Objekte alle K-Objekte mit zugewiesener Gruppenadresse anzeigen zu lassen. - Sie haben den "fehlenden" K-Objekten keine Gruppenadresse zugeordnet:
Lösung: Tragen Sie bei jedem gewünschten K-Objekt unter Stammdaten -> Kommunikationsobjekte eine Gruppenadresse ein.