1.Introduction
Le moniteur HS est une fonction qui est accessible dans le navigateur et permet de recevoir les télégrammes d'adresses de groupes (GA) ou d'envoyer des télégrammes à des adresses de groupes.
Chaque adresse de groupe correspond à un objet de communication interne ou externe (KNX) du HS/FS autorisé dans le logiciel Expert pour être utilisé avec le moniteur HS.
Les adresses de groupes sont représentées dans une liste qui est accessible au moyen de l'onglet C.-OBJECTS et contient exactement une entrée (une ligne) par adresse de groupe. Cette entrée contient l'adresse de groupe, la valeur actuelle, le nom de l'objet de communication ainsi que des informations complémentaires.
Dans une seconde liste, accessible au moyen de l'onglet PROTOCOL, sont journalisés tous les télégrammes des adresses de groupes précédemment marquées par l'utilisateur. Cette liste peut être exportée sou la forme d'un fichier « .csv ».
Chaque adresse de groupe correspond à un objet de communication interne ou externe (KNX) du HS/FS autorisé dans le logiciel Expert pour être utilisé avec le moniteur HS.
Les adresses de groupes sont représentées dans une liste qui est accessible au moyen de l'onglet C.-OBJECTS et contient exactement une entrée (une ligne) par adresse de groupe. Cette entrée contient l'adresse de groupe, la valeur actuelle, le nom de l'objet de communication ainsi que des informations complémentaires.
Dans une seconde liste, accessible au moyen de l'onglet PROTOCOL, sont journalisés tous les télégrammes des adresses de groupes précédemment marquées par l'utilisateur. Cette liste peut être exportée sou la forme d'un fichier « .csv ».
1.1.Conditions
Condition requise pour l'utilisation du moniteur HS :
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 toute modification dans Expert, il est nécessaire de transmettre le projet une nouvelle fois, avec les réglages suivants !
Accès
Pour pouvoir utiliser le moniteur HS, l'un des deux réglages suivants doit être activé dans Expert HS/FS, à la rubrique Données de base -> Réglages du projet -> Interface :
soit
soit
- l'option Tous doit être activée,
- l'option Défini par l'utilisateur est activée
et
la case à cocher hsmonitor est activée.
Configuration
Les réglages importants dans l'Expert HS/FS, dans la rubrique Données de base -> Réglages du projet -> Réseau -> Passerelle télécom, sont les suivants :
Ces options et toutes les autres sont décrites dans l'aide Expert de la passerelle télécom.
| Réglage | Obligatoire / en option | Commentaire |
|---|---|---|
| Activer WebSocket | Obligatoire | |
| Charger la structure XML des objets de communication dans l'appareil | Obligatoire | |
| Activer la réception pour tous les objets de communication | En option | L'activation de cette option entraîne la réception des télégrammes de tous les objets de communication dotés d'adresses de groupes dans le HS/FS, ce qui signifie que leurs valeurs peuvent être modifiées au moyen du moniteur HS. Si l'option n'est pas activée, il est uniquement possible de recevoir des télégrammes d'objets de communication (avec adresses de groupes) pour lesquels l'option « Recevoir via la passerelle télécom » a été activée. Attention Seules les adresses de groupes également autorisées pour l'envoi via la passerelle télécom sont affichées sous C.-OBJECTS ! |
| Activer l'envoi pour tous les objets de communication | En option | Si l'option est activée, les télégrammes envoyés par le HS/FS contenant des valeurs modifiées peuvent être reçus par tous les objets de communication dotés d'adresses de groupes dans le moniteur HS. Si l'option n'est pas activée, il est uniquement possible d'envoyer des télégrammes à des objets de communication (avec adresses de groupes) pour lesquels l'option « Envoyer via la passerelle télécom » a été activée. |
Appel
Le moniteur HS est appelé dans le navigateur via l'URL suivant :
ou
HTTPS://HS_IP/opt/hsmonitor/index.htmlou
HTTPS://HS_IP/opt/hsmonitor/index.html#key=[clé]Ouverture de session
Dans certaines circonstances (voir ci-dessous), le masque d'ouverture de session s'affiche et une clé doit être saisie pour pouvoir accéder au moniteur HS. Vous devez saisir la clé pour la liaison de données de la passerelle télécom définie dans le projet.
Le moniteur HS garde cette clé en mémoire tant que le navigateur est actif.
Le moniteur HS demande que cette clé soit saisie au premier démarrage ou par exemple si la clé a été modifiée suite à une modification du projet et à son nouveau transfert.
La clé peut aussi être indiquée dans l'URL dès l'appel du moniteur HS, sous forme de paramètre (deuxième possibilité d'appel parmi celles décrites ci-dessus).
Le moniteur HS garde cette clé en mémoire tant que le navigateur est actif.
Le moniteur HS demande que cette clé soit saisie au premier démarrage ou par exemple si la clé a été modifiée suite à une modification du projet et à son nouveau transfert.
La clé peut aussi être indiquée dans l'URL dès l'appel du moniteur HS, sous forme de paramètre (deuxième possibilité d'appel parmi celles décrites ci-dessus).
Exemples d'appel
Exemple d'appel sur un HS/FS d'adresse IP 192.168.0.11, avec communication sûre :
La clé peut être saisie au moment de l'appel (voir masque d'ouverture de session).
Exemple du même appel avec indication de la clé « my123key » :
HTTPS://192.168.0.11/opt/hsmonitor/index.htmlLa clé peut être saisie au moment de l'appel (voir masque d'ouverture de session).
Exemple du même appel avec indication de la clé « my123key » :
HTTPS://192.168.0.11/opt/hsmonitor/index.html#key=my123key2.Moniteur HS
La représentation du moniteur HS est divisée en trois zones et un masque en incrustation :
- Zone 1 : En-tête
- Zone 2 : Liste des objets de communication (onglet C.-OBJECTS)
- Zone 3 : Masque Protocole (onglet PROTOCOL)
2.1.En-tête
L'en-tête occupe la zone supérieure complète de la page web.
Il comprend les onglets de commutation de l'affichage, l'indicateur de l'état de connexion et le bouton d'appel de l'Aide.
Il comprend les onglets de commutation de l'affichage, l'indicateur de l'état de connexion et le bouton d'appel de l'Aide.
Onglet C.-OBJECTS
Un clic sur cet onglet permet d'afficher la liste des objets de communication. Le moniteur HS démarre par cet affichage.
Onglet PROTOCOL
Un clic sur cet onglet permet d'afficher le protocole des télégrammes entrés.
Chaque entrée de la liste montre un télégramme correspondant à l'un des objets de communication marqués dans la liste des objets de communication pour être journalisés (c.-à-d. que la case à cocher de l'objet de communication concerné dans la colonne gauche est activée).
Chaque entrée de la liste montre un télégramme correspondant à l'un des objets de communication marqués dans la liste des objets de communication pour être journalisés (c.-à-d. que la case à cocher de l'objet de communication concerné dans la colonne gauche est activée).
Etat de connexion
Un symbole contenant deux flèches jouxte l'inscription « Moniteur HS », à gauche. Ce symbole indique l'état actuel de la connexion entre le moniteur HS (dans le navigateur) et HS/FS.
Ce symbole peut prendre deux couleurs :
Ce symbole peut prendre deux couleurs :
- Vert : la connexion est activée.
- Rouge : la connexion est actuellement désactivée.
Remarque
Veuillez noter qu'à l'établissement de la nouvelle connexion au HS/FS, la case à cocher de la fonction Protocole sera désactivée pour tous les objets de communication et que toutes les valeurs de la colonne « Total » seront mises à '0' !
La liste de protocole n'est pas effacée en cas de coupure de la connexion ou d'établissement d'une nouvelle connexion !
La liste de protocole n'est pas effacée en cas de coupure de la connexion ou d'établissement d'une nouvelle connexion !
2.2.Onglet C.-OBJECTS
Un clic sur l'onglet « C.-OBJECTS » permet d'afficher la liste des objets de communication.
La ligne de saisie du filtre des adresses de groupes s'affiche tout en haut.
Au-dessous apparaît la liste des objets de communication autorisés pour l'affichage dans le projet HS/FS actuel.
Chaque objet de communication est représenté dans la liste par une ligne exactement.
Les indications correspondant à chacune des colonnes de la liste se trouvent dans Liste des objets de communication.
En cliquant sur une ligne, vous pouvez la sélectionner pour effectuer différentes actions.
Si la largeur d'écran du navigateur ou de l'appareil actuellement utilisé pour l'affichage est supérieure ou égale à 1024 pixels, une boîte contenant les informations relatives à l'objet de communication actuellement sélectionné s'affiche à droite de la liste des objets de communication.
Sinon, cette boîte s'affiche sous forme de fenêtre en incrustation.
La ligne de saisie du filtre des adresses de groupes s'affiche tout en haut.
Au-dessous apparaît la liste des objets de communication autorisés pour l'affichage dans le projet HS/FS actuel.
Chaque objet de communication est représenté dans la liste par une ligne exactement.
Les indications correspondant à chacune des colonnes de la liste se trouvent dans Liste des objets de communication.
En cliquant sur une ligne, vous pouvez la sélectionner pour effectuer différentes actions.
Si la largeur d'écran du navigateur ou de l'appareil actuellement utilisé pour l'affichage est supérieure ou égale à 1024 pixels, une boîte contenant les informations relatives à l'objet de communication actuellement sélectionné s'affiche à droite de la liste des objets de communication.
Sinon, cette boîte s'affiche sous forme de fenêtre en incrustation.
Filtre (symbole de loupe)
La liste des objets de communication peut être filtrée. Autrement dit, dès que vous entrez un filtre, seuls les objets de communication correspondant au filtre sont affichés.
- Le filtrage commence dès la saisie du premier signe.
- Le filtre est ensuite actualisé à la saisie de chaque signe supplémentaire.
- Il est possible d'entrer plusieurs filtres séparés par un espace qui seront appliqués avec l'opérateur logique ET.
- L'ordre des filtres mentionnés ne joue aucun rôle.
- Les critères de filtrage sont appliqués aux champs des colonnes « GA » et « Nom ».
- Pour supprimer le filtrage, vider le champ de filtre.
Remarque
La sélection d'une ligne n'a aucune incidence sur le filtrage.
2.2.1.Liste des objets de communication
Liste de tous les objets de communication autorisés dans le projet Expert, triés par adresse de groupe.
Signification de chaque colonne :
Signification de chaque colonne :
| Colonne | Explication |
|---|---|
[] | Case à cocher pour l'identification à des fins de journalisation. Chaque télégramme de cette adresse de groupe est enregistré dans le protocole. Un clic sur la case à cocher dans la ligne de titre permet d'activer ou désactiver tous les objets de communication (ou une seulement une partie d'entre eux si un filtre est actif !) actuellement affichés dans la liste. |
GA | Adresse de groupe au format x/y/z. |
Name | Nom / désignation de l'objet de communication. |
Total | Nombre de télégrammes reçus depuis le démarrage du moniteur HS. |
Timestamp | Heure de réception du dernier télégramme. |
Value | Valeur actuelle de l'objet de communication. |
2.2.2.Infobox d'objet de communication
Si la largeur d'écran du navigateur ou de l'appareil actuellement utilisé pour l'affichage est supérieure ou égale à 1024 pixels, une boîte contenant les informations relatives à l'objet de communication actuellement sélectionné s'affiche à droite de la liste des objets de communication.
Sinon, cette boîte s'affiche sous forme de fenêtre en incrustation lorsque vous cliquez sur une ligne.
Cette boîte contient des informations complémentaires et propose différentes actions pour l'objet de communication actuellement sélectionné.
En sont exclus les objets de communication au format (type) « date » et « time », qui peuvent être affichés mais pas modifiés avec le moniteur HS.
Pour modifier un objet de communication, vous devez au préalable cliquer sur la ligne correspondante dans la liste des objets de communication. La ligne apparaît alors sur fond gris.
Sinon, cette boîte s'affiche sous forme de fenêtre en incrustation lorsque vous cliquez sur une ligne.
Cette boîte contient des informations complémentaires et propose différentes actions pour l'objet de communication actuellement sélectionné.
En sont exclus les objets de communication au format (type) « date » et « time », qui peuvent être affichés mais pas modifiés avec le moniteur HS.
Pour modifier un objet de communication, vous devez au préalable cliquer sur la ligne correspondante dans la liste des objets de communication. La ligne apparaît alors sur fond gris.
2.2.2.1.Données de l'objet de communication actif affichées
Le nom de l'objet de communication s'affiche dans le titre de la boîte.
Si la boîte s'affiche sous forme de fenêtre en incrustation, un bouton « Fermer » apparaît en supplément sur le côté droit.
La boîte affiche les informations suivantes :
Si la boîte s'affiche sous forme de fenêtre en incrustation, un bouton « Fermer » apparaît en supplément sur le côté droit.
La boîte affiche les informations suivantes :
GA | L'adresse de groupe de l'objet de communication. |
|---|---|
Type | Format de l'objet de communication Les indications suivantes sont possibles :
|
Min | Minimum La valeur minimum définie dans l'Expert pour l'objet de communication. |
Max | Maximum La valeur maximum définie dans l'Expert pour l'objet de communication. |
Step | Si une taille de pas a été définie dans l'Expert pour cet objet de communication, elle s'affiche ici. Dans le cas contraire : 0 |
List | Si une liste de valeurs autorisées a été définie dans l'Expert pour cet objet de communication, elle s'affiche ici. Dans le cas contraire : (vide) |
2.2.2.2.Actions
Cette boîte permet d'effectuer plusieurs actions pour l'objet de communication actif, en fonction des propriétés de ce dernier :
- Pas pour le type date ou time :
il est possible d'envoyer un télégramme à l'adresse de groupe pour modifier la valeur de l'objet de communication.
En fonction du réglage du bouton affiché, la valeur envoyée est soit réglée directement soit ajoutée à la valeur actuelle (uniquement pour le type « integer » et « number »).
Un clic sur la flèche à droite du champ de saisie « Send » permet d'envoyer au HS/FS le télégramme contenant la valeur modifiée. - Uniquement si une valeur supérieure à zéro a été indiquée sous « Taille de pas » dans l'objet de communication :
les boutons « + Step » et « - Step » visibles dans ce cas permettent d'envoyer un télégramme modifiant l'objet de communication à raison de la valeur entrée dans le champ « Step ». - Uniquement si une liste de valeurs été indiquée sous « Liste » dans l'objet de communication :
les boutons « ^ List » et « v List » visibles dans ce cas permettent d'envoyer un télégramme réglant l'objet de communication sur la valeur supérieure ou inférieure la plus proche dans la liste, en partant de la valeur actuelle.
Remarque
En cas d'affection de valeurs hors des limites Min/Max définies pour des objets de communication, le comportement de ces objets est décrit dans l'Aide Expert au chapitre « Objets de communication ».
2.3.Onglet PROTOCOL
Un clic sur l'onglet « PROTOCOL »permet d'afficher le protocole des télégrammes reçus.
Ce masque affiche une liste des télégrammes entrés, avec affectations de valeurs, pour tous les objets de communication activés dans le masque C.-OBJECTS au moyen de la case à cocher de la colonne « GA ».
La liste est limitée à 50 000 entrées maximum et classée par date d'entrée, la plus récente apparaissant en haut. Le taux actuel de remplissage s'affiche en haut à gauche.
Les symboles situés à droite au-dessus de la liste permettent d'effectuer différentes opérations.
Le champ de recherche affiché au-dessus de la liste permet de rechercher des entrées dans la liste puis d'y accéder directement au moyen des boutons de droite (« Flèche vers le haut » et « Flèche vers le bas »).
Ce masque affiche une liste des télégrammes entrés, avec affectations de valeurs, pour tous les objets de communication activés dans le masque C.-OBJECTS au moyen de la case à cocher de la colonne « GA ».
La liste est limitée à 50 000 entrées maximum et classée par date d'entrée, la plus récente apparaissant en haut. Le taux actuel de remplissage s'affiche en haut à gauche.
Les symboles situés à droite au-dessus de la liste permettent d'effectuer différentes opérations.
Le champ de recherche affiché au-dessus de la liste permet de rechercher des entrées dans la liste puis d'y accéder directement au moyen des boutons de droite (« Flèche vers le haut » et « Flèche vers le bas »).
2.3.1.Effets de différentes actions sur la liste
L'annulation de l'enregistrement des télégrammes pour une adresse de groupe dans le masque C.-OBJECTS (désactivation de la case à cocher de la colonne « GA ») n'a aucun effet sur les lignes déjà affichées à ce moment dans la liste pour cette adresse de groupe.
L'actualisation du navigateur, qu'elle soit manuelle ou automatique (par ex. en cas de nouveau transfert du projet vers le HS/FS), n'a aucun effet sur les lignes déjà affichées à ce moment dans la liste.
La suppression ou la modification d'objets de communication du projet pour lesquels des entrées existent déjà dans la liste n'a aucun effet (que ce soit directement ou après un nouveau transfert du projet) sur les lignes déjà affichées à ce moment dans la liste pour ces adresses de groupes.
L'actualisation du navigateur, qu'elle soit manuelle ou automatique (par ex. en cas de nouveau transfert du projet vers le HS/FS), n'a aucun effet sur les lignes déjà affichées à ce moment dans la liste.
La suppression ou la modification d'objets de communication du projet pour lesquels des entrées existent déjà dans la liste n'a aucun effet (que ce soit directement ou après un nouveau transfert du projet) sur les lignes déjà affichées à ce moment dans la liste pour ces adresses de groupes.
2.3.2.Actions possibles dans la liste
| Symbole | Explication |
|---|---|
| [n] / 50000 | taux de remplissage actuel de la liste et valeur maximale. Si la liste est pleine, le télégramme le plus ancien est supprimé à la réception d'un nouveau télégramme. |
| Flèche vers le bas | Téléchargement de la liste. Une boîte de dialogue fichiers s'ouvre et permet d'enregistrer la liste actuelle sous forme de fichier « .csv ». |
| Corbeille | Vide la liste actuellement affichée |
| Log | Le curseur permet de désactiver temporairement la journalisation des télégrammes sans modifier la sélection effectuée au moyen de la colonne « GA » du masque C.-OBJECTS. La liste n'est pas vidée à l'activation ou la désactivation de la journalisation. |
2.3.3.Liste des télégrammes entrés
Tous les télégrammes sont enregistrés. Cela signifie que les télégrammes qui ne modifient pas la valeur affectée à un objet de communication s'affichent également.
Signification de chaque colonne :
Signification de chaque colonne :
| Colonne | Explication |
|---|---|
Time | Heure de réception du dernier télégramme. |
GA | Adresse de groupe au format x/y/z. |
Value | Valeur actuelle de l'objet de communication. |
Type | Format de l'objet de communication Les indications suivantes sont possibles :
|
Name | Nom / désignation de l'objet de communication. |
3.FAQ
Problème : Seules les adresses de groupe et les valeurs sont affichées.
Solution : L'option « Transférer la structure XML des objets de communication sur l'appareil » doit être activée dans l'Expert, dans Données de base -> Réglages du projet -> Réseau -> Passerelle télécom.
Problème : Les adresses de groupes ne s'affichent pas dans la liste des objets de communication.
Ce défaut peut avoir différentes causes :
- Défaut dans la configuration de l'accès
- Défaut dans l'agencement de la configuration
- L'adresse IP de l'appareil sur lequel fonctionne le moniteur HS ne figure pas dans la liste des adresses d'expéditeur 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 fonctionne le moniteur HS figure dans la liste des adresses d'expéditeur autorisées, mais la clé qui y est définie n'est pas celle que vous avez indiquée dans le navigateur :
- Appel
- Réglages
- Expert : Données de base -> Réglages de projet -> Réseau -> Passerelle télécom
Problème : Certaines adresses de groupes manquent dans le masque Objet de communication.
Ce défaut peut avoir différentes causes :
- Certaines options sont désactivées dans l'Expert :
Dans Données de base -> Réglages du projet -> Réseau -> Passerelle télécom, l'une des options suivantes ou les deux :- 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 : Pour les objets de communication individuels, activez l'option « Recevoir » et/ou « Envoyer » pour afficher ces objets de communication exactement, ou activez, dans les réglages de la passerelle télécom, les options « Recevoir » et/ou « Envoyer » pour afficher tous les objets de communication avec l'adresse de groupe attribuée, indépendamment des réglages des différents objets de communication. - Vous n'avez attribué aucune adresse de groupe aux objets de communication « manquants » :
Solution : Entrez une adresse de groupe pour chaque objet de communication souhaité dans Données de base -> Objets de communication.