1.Introduction
HS-Monitor est une fonction appelable dans le navigateur qui permet de recevoir des télégrammes à des adresses de groupes et d'en envoyer à ces adresses.
Chaque adresse de groupe représente un objet de communication soit interne, soit externe (KNX) du HS/FS qui a été validé dans le logiciel Expert pour l'utilisation avec HS-Monitor.
Les adresses de groupes sont affichées dans une liste dans le Masque des objets de communication. Cette liste comprend exactement une entrée (une ligne) par adresse de groupe. En plus de l'adresse de groupe et de la valeur actuelle, cette entrée comporte en option le nom de l'objet de communication ainsi que d'autres informations.
Une deuxième liste dans le Masque des protocoles permet d'enregistrer tous les télégrammes des adresses de groupes préalablement marquées par l'utilisateur. Cette liste peut être exportée en tant que fichier « .csv ».
Chaque adresse de groupe représente un objet de communication soit interne, soit externe (KNX) du HS/FS qui a été validé dans le logiciel Expert pour l'utilisation avec HS-Monitor.
Les adresses de groupes sont affichées dans une liste dans le Masque des objets de communication. Cette liste comprend exactement une entrée (une ligne) par adresse de groupe. En plus de l'adresse de groupe et de la valeur actuelle, cette entrée comporte en option le nom de l'objet de communication ainsi que d'autres informations.
Une deuxième liste dans le Masque des protocoles permet d'enregistrer tous les télégrammes des adresses de groupes préalablement marquées par l'utilisateur. Cette liste peut être exportée en tant que fichier « .csv ».
1.1.Conditions préalables
Condition pour l'utilisation de HS-Monitor :
Matériel et logiciel :
Matériel et logiciel :
- HomeServer ou FacilityServer avec micrologiciel à partir de la version 4.7.x.
- Logiciel Expert à partir de la version 4.7.x.
- Mozilla Firefox à partir de la version 59
- Google Chrome à partir de la version 65
- Microsoft Edge à partir de la version 41
- Microsoft Internet Explorer à partir de la version 11
- Google Chrome Android 66
- iOS Safari 11
1.2.Installation, configuration, accès et appel
Attention
Après une modification des réglages suivants dans l'Expert, le projet doit être retransmis !
Accès
Pour pouvoir utiliser Monteur HS, un des deux réglages suivants dans l'Expert HS/FS doit être activée dans la rubrique Données de base -> Réglages de projet -> Interface :
Soit
Soit
- l'option Tous doit être activée,
- l'option Défini par l'utilisateur doit être activée
et
la case à cocher hsmonitor doit être activée.
Configuration
Dans l'Expert HS/FS, le réglage Accès via WebSocket doit être activé dans la rubrique Données de base -> Réglages de projet -> Réseau -> Passerelle télécom !
Les autres options réglables sous ce point sont décrites dans l'aide Expert relative à la Passerelle télécom.
Les autres options réglables sous ce point sont décrites dans l'aide Expert relative à la Passerelle télécom.
Appel
HS-Monitor est appelé dans le Navigateur par l'URL suivante :
ou
HTTPS://HS_IP/opt/hsmonitor/index.htmlou
HTTPS://HS_IP/opt/hsmonitor/index.html#key=[Clé]Ouvrir une session
Le masque d'ouverture de session apparaît au démarrage du HS-Monitor. Il est possible de saisir ici la clé définie dans le projet Expert pour la liaison de données de la passerelle télécom.
HS-Monitor mémorise cette clé jusqu'à la fermeture du navigateur.
HS-Monitor exige la saisie de cette clé lors du premier démarrage ou lorsque la clé a changée, p. ex. après des modifications dans le projet ou sa retransmission.
Il est également possible d'entrer directement la clé en tant que paramètre dans l'URL lors de l'appel du moniteur HS.
HS-Monitor mémorise cette clé jusqu'à la fermeture du navigateur.
HS-Monitor exige la saisie de cette clé lors du premier démarrage ou lorsque la clé a changée, p. ex. après des modifications dans le projet ou sa retransmission.
Il est également possible d'entrer directement la clé en tant que paramètre dans l'URL lors de l'appel du moniteur HS.
Exemples d'appel
Exemple d'un appel sur un HS/FS avec l'adresse IP 192.168.0.11 avec communication sécurisée :
Lors de l'appel, il est possible de saisir également la clé (voir Réglages).
Exemple pour le même appel avec saisie de la clé « my123key » :
HTTPS://192.168.0.11/opt/hsmonitor/index.htmlLors de l'appel, il est possible de saisir également la clé (voir Réglages).
Exemple pour le même appel avec saisie de la clé « my123key » :
HTTPS://192.168.0.11/opt/hsmonitor/index.html#key=my123key2.HS-Monitor
La représentation du HS-Monitor se divise en trois zones et un masque en incrustation.
- Zone 1 : En-tête
- Zone 2 : Masque des objets de communication
- Zone 3 : Masque des protocoles
2.1.En-tête
L'en-tête représente toute la zone supérieure du site web.
Vous trouverez ici les onglets pour commuter l'affichage, l'indicateur de l'état de la connexion et le bouton pour afficher l'aide.
Vous trouverez ici les onglets pour commuter l'affichage, l'indicateur de l'état de la connexion et le bouton pour afficher l'aide.
Onglet des objets de communication
Affiche le Masque des objets de communication avec la liste des objets de communication disponibles dans le projet et la barre des actions. Cette représentation lance le HS-Monitor.
Onglet des protocoles
Affiche le Masque des protocoles.
Chaque entrée dans la liste affiche un télégramme vers un des objets de communication qui a été marquée dans le Masque des objets de communication (c.-à-d. que la case à cocher de l'objet de communication en question à été activée dans la colonne gauche).
Si le Masque des objets de communication est actuellement actif, un badge s'affiche en haut à droite sur l'onglet des protocoles lorsqu'un nouveau télégramme arrive. Ce badge affiche le nombre des nouveaux télégrammes depuis la fermeture du Masque des protocoles (ou du démarrage du HS-Monitor, si le masque des protocoles n'a pas encore été appelé).
Lors du nouvel affichage du Masque des protocoles, le badge est supprimé et le compte recommence à '0'.
Chaque entrée dans la liste affiche un télégramme vers un des objets de communication qui a été marquée dans le Masque des objets de communication (c.-à-d. que la case à cocher de l'objet de communication en question à été activée dans la colonne gauche).
Si le Masque des objets de communication est actuellement actif, un badge s'affiche en haut à droite sur l'onglet des protocoles lorsqu'un nouveau télégramme arrive. Ce badge affiche le nombre des nouveaux télégrammes depuis la fermeture du Masque des protocoles (ou du démarrage du HS-Monitor, si le masque des protocoles n'a pas encore été appelé).
Lors du nouvel affichage du Masque des protocoles, le badge est supprimé et le compte recommence à '0'.
État de la connexion
À gauche à côté de l'inscription « HS-Monitor » se trouve un symbole qui représente deux flèches. Ce symbole affiche l'état actuel de la connexion entre le HS-Monitor (dans le navigateur) et HS/FS.
Ce symbole peut avoir deux couleurs :
Ce symbole peut avoir deux couleurs :
- Vert : il y a actuellement une connexion.
- Rouge : il n'y a actuellement aucune connexion.
Remarque
Veuillez considérer que lors d'une nouvelle connexion avec le HS/FS, la case à cocher pour la fonction de protocole est désactivée et la colonne « Anz. / Count » est remise sur '0' pour tous les objets de communication !
La liste des protocoles n'est pas effacée lors d'une rupture de la connexion ou lors d'une reconnexion !
La liste des protocoles n'est pas effacée lors d'une rupture de la connexion ou lors d'une reconnexion !
2.2.Masque des objets de communication
Ici s'affiche la liste des objets de communication validés pour l'affichage dans le projet HS/FS actuel.
Chaque objet de communication est représenté par précisément une ligne dans la liste.
Vous trouverez les informations relatives aux différentes colonnes de la liste au point Liste des objets de communication.
Pour sélectionner une ligne pour des Actions spécifiques, il suffit de cliquer sur la ligne.
Chaque objet de communication est représenté par précisément une ligne dans la liste.
Vous trouverez les informations relatives aux différentes colonnes de la liste au point Liste des objets de communication.
Pour sélectionner une ligne pour des Actions spécifiques, il suffit de cliquer sur la ligne.
2.2.1.List des objets de communication
Liste de tous les objets de communication autorisés dans le projet Expert, triés par adresse de groupe.
Signification des différentes colonnes :
Signification des différentes colonnes :
| Colonne | Explication |
|---|---|
| Colonne 1 | Case à cocher pour le marquage pour la consignation. Chaque objet de communication activé ainsi est enregistré dans Protocole / Protocol. |
| Grp.-Adr. | Adresse de groupe au format x/y/z. |
| Name | Désignation de l'objet de communication. |
| Anz. / Count | Nombre des télégrammes reçus depuis le démarrage du HS-Monitor. |
| Zeit / Time | Heure du dernier télégramme reçu. |
| Wert / Value | La valeur actuelle de l'objet de communication. |
| Typ(e) | Format de l'objet de communication Les informations suivantes sont possibles :
|
| Min | Minimum La valeur la plus petite possible définie dans l'Expert pour l'objet de communication. |
| Max | Maximum La valeur la plus grande possible définie dans l'Expert pour l'objet de communication. |
| S L | Marquage pour Taille de pas / Step et Liste / List Si une Taille de pas / Step est définie dans l'Expert pour cet objet de communication, un S est affiché ici. Si une Liste / List est définie dans l'Expert pour cet objet de communication, un L s'affiche ici. |
2.2.2.Barre des actions
La barre des actions sur le bord droit du Masque des objets de communication permet d'attribuer la liste ci-contre à des filtres et/ou de nouvelles valeurs à des objets de communication.
À l'exception des objets de communication au format « date » et « time » qui ne peuvent pas être modifiés, mais uniquement affichés avec le HS-Monitor.
Pour modifier un objet de communication, il faut d'abord sélectionner (cliquer sur) la ligne correspondante. La ligne s'affiche avec un fond gris.
À l'exception des objets de communication au format « date » et « time » qui ne peuvent pas être modifiés, mais uniquement affichés avec le HS-Monitor.
Pour modifier un objet de communication, il faut d'abord sélectionner (cliquer sur) la ligne correspondante. La ligne s'affiche avec un fond gris.
Filtre (symbole de loupe)
Il est possible de filtrer la liste des objets de communication, c.-à-d. que, dès qu'un filtre est appliqué, seuls les objets de communication qui correspondent au filtre s'affichent.
- Le filtrage commence après la saisie du premier caractère.
- Lors de chaque saisie d'un nouveau caractère, le filtre est actualisé.
- Il est possible de saisir plusieurs filtres séparés par des espaces qui sont appliqués avec un connecteur ET logique.
- L'ordre des filtres indiqués n'a aucune importance.
- Les critères de filtrage sont appliqués aux champs « Adr. grp. » et « Nom ».
- Pour annuler le filtre, il suffit de vider le champ de filtrage.
Remarque
La sélection d'une ligne n'a aucune influence sur le filtrage.
Le comportement des objets de communication en cas d'attribution de valeurs situées en dehors des valeurs min/max définies est décrit dans l'aide Expert au chapitre « Objets de communication ».
Le comportement des objets de communication en cas d'attribution de valeurs situées en dehors des valeurs min/max définies est décrit dans l'aide Expert au chapitre « Objets de communication ».
Wert setzen / Send Value
D'abord, il faut saisir une valeur dans le champ de saisie, ensuite, la valeur de l'objet de communication est modifiée en conséquence en cliquant sur un des deux boutons.
- Absolut(e) : La valeur actuelle de l'objet de communication reprend la valeur de la saisie.
- Relativ(e) : La valeur saisie est additionnée à la valeur actuelle de l'objet de communication.
Remarque
Pour soustraire une valeur, il suffit d'entrer un chiffre avec le caractère « moins » devant et de cliquer sur « Relativ(e) ».
Schrittgröße / Step
Remarque
Cette boîte de saisie est uniquement visible lorsqu'une taille de pas a été définie dans le projet pour l'objet de communication.
La taille de pas est affichée.
Le fait de cliquer sur un des deux boutons (« + » ou « - ») permet d'additionner la taille de pas à la valeur actuelle de l'objet de communication (bouton « + ») ou de l'en soustraire (bouton « - »).
Le fait de cliquer sur un des deux boutons (« + » ou « - ») permet d'additionner la taille de pas à la valeur actuelle de l'objet de communication (bouton « + ») ou de l'en soustraire (bouton « - »).
Liste / List
Remarque
Cette boîte de saisie est uniquement visible lorsqu'une liste a été définie dans le projet pour l'objet de communication.
La liste est affichée.
Les boutons « Monter » et « Descendre » permettent de mettre la valeur actuelle de l'objet de communication sur la valeur adaptée suivante de la liste.
Les boutons « Monter » et « Descendre » permettent de mettre la valeur actuelle de l'objet de communication sur la valeur adaptée suivante de la liste.
2.3.Masque des protocoles
Dans ce masque s'affiche la liste des télégrammes reçus.
De plus, vous pouvez ici supprimer et/ou exporter la liste.
De plus, vous pouvez ici supprimer et/ou exporter la liste.
2.3.1.Liste des télégrammes reçus
| Colonne | Explication |
|---|---|
| Zeit / Time | Heure à laquelle l'attribution de la valeur a eu lieu. |
| Grp.-Adr. | Adresse de groupe. |
| Wert / Value | La valeur qui a été attribuée à l'objet de communication. |
| Name | Désignation de l'objet de communication. |
| Typ(e) | Format de l'objet de communication Les informations suivantes sont possibles :
|
Remarque
La désactivation d'un ou de plusieurs objets de communication n'a aucune influence sur les lignes déjà affichées dans la liste à cet instant.
Remarque
L'actualisation du navigateur, aussi bien manuellement qu'automatiquement (p. ex. lors d'une retransmission du projet sur le HS/FS), n'a aucune influence sur les attributions de valeur déjà affichées dans la liste à cet instant.
La suppression ou la modification d'objets de communication dans le projet pour lesquels il y a déjà des entrées dans la liste n'ont aucune influence sur ces entrées même après la retransmission du projet.
La suppression ou la modification d'objets de communication dans le projet pour lesquels il y a déjà des entrées dans la liste n'ont aucune influence sur ces entrées même après la retransmission du projet.
2.3.2.Barre de tâches
Dans la barre de tâches sur le bord droit du Masque des protocoles, vous avez la possibilité d'éditer la liste et d'éditer ultérieurement les données affichées.
3.FAQ
Problème : Seules les adresses de groupe et les valeurs s'affichent.
Solution : Dans l'Expert, l'option « Transmettre la structure XML des objets de communication sur l'appareil » doit être activée sous Données de base -> Réglages de projet -> Réseau -> Passerelle télécom.
Problème : Aucune adresse de groupe ne s'affiche dans le Masque des objets de communication.
Il existe plusieurs causes possibles pour cette erreur :
- Une erreur dans la configuration pour l'Accès.
- Une erreur dans la configuration pour la Configuration.
- L'adresse IP de l'appareil sur lequel HS-Monitor fonctionne ne se trouve pas dans la liste des adresses d'expéditeurs autorisées.
- Expert : Données de base -> Réglages de projet -> Réseau -> Passerelle télécom - L'adresse IP de l'appareil sur lequel HS-Monitor fonctionne se trouve sur la liste des adresses d'expéditeurs autorisées, mais la clé qui y est définie ne correspond pas à la clé que vous avez entrée dans le navigateur :
- Appel
- Réglages
- Expert : Données de base -> Réglages de projet -> Réseau -> Passerelle télécom
Problème : Il manque des adresses de groupe dans le Masque des objets de communication.
Il existe plusieurs causes possibles pour cette erreur :
- Certaines options sont désactivées dans l'Expert :
Une ou les deux options suivantes sous Données de base -> Réglages de projet -> Réseau -> Passerelle télécom :- Activer la réception pour tous les objets de communication
- Activer l'envoi pour tous les objets de communication
- Recevoir via la passerelle télécom
- Envoyer via la passerelle télécom
Solution : Activez pour les différents objets de communication les options pour « Recevoir » et/ou « Envoyer » pour afficher exactement ces objets de communication ou activez dans les réglages de la passerelle télécom les options pour « Recevoir » et/ou « Envoyer » pour afficher tous les objets de communication avec adresse de groupe attribuée indépendamment des réglages des différents objets de communication. - Vous n'avez pas attribué une adresse de groupe aux objets de communication « manquants » :
Solution : Sous Données de base -> Objets de communication, saisissez une adresse de groupe à chaque objet de communication souhaité.