1.Introduction
Moniteur HS est une fonction qu'il est possible d'appeler dans le navigateur et qui sert à recevoir et à envoyer les télégrammes d'adresses de groupes.
Chaque adresse de groupe correspond à un objet de communication interne ou externe (EIB) 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 du Masque Objets de communication qui contient 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 peut contenir en option le nom de l'objet de communication ainsi que des informations complémentaires.
Une seconde liste du Masque Protocole journalise 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 (EIB) 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 du Masque Objets de communication qui contient 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 peut contenir en option le nom de l'objet de communication ainsi que des informations complémentaires.
Une seconde liste du Masque Protocole journalise 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 préalables
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 49
- Google Chrome à partir de la version 52
- Microsoft Edge à partir de la version 38
- Microsoft Internet Explorer à partir de la version 11
- Google Chrome Android
- iOS Safari 10
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
Dans Expert HS/FS, le réglage Accès via WebSocket doit être activé dans la rubrique Données de base -> Réglages du projet -> Réseau -> Passerelle télécom.
Les autres options pouvant être sélectionnées dans ce point sont décrites dans l'Aide Expert de la passerelle télécom.
Les autres options pouvant être sélectionnées dans ce point sont décrites dans l'Aide Expert de la passerelle télécom.
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
Le masque Ouverture de session apparaît au démarrage du moniteur HS. Il est possible d'indiquer ici les clés définies dans le projet Expert pour la liaison de données de la passerelle télécom.
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 d'un paramètre.
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 d'un paramètre.
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 Réglages).
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 Réglages).
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 : Masque Objets de communication
- Zone 3 : Masque Protocole
2.1.En-tête
L'en-tête occupe la zone supérieure complète du site 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.
Registre Objet comm.
Affiche le Masque Objets de communication, avec la liste des objets de communication mis à disposition dans le projet et la barre d'action. Le moniteur HS démarre par cet affichage.
Registre Protocole
Affiche le Masque Protocole.
Chaque entrée de la liste signale un télégramme correspondant à l'un des objets de communication, qui a été repéré dans le Masque Objets de communication pour être journalisé (c.-à-d. que la case à cocher de l'objet de communication concerné de la colonne gauche est activée).
Si le Masque Objets de communication est activé, un badge est affiché en haut à droite de l'onglet de protocole lors de l'arrivée d'un nouveau télégramme ; ce badge indique le nombre de nouveaux télégrammes reçus depuis que le Masque Protocole a été quitté (ou depuis le démarrage du moniteur HS si le masque Protocole n'a pas encore été appelé).
Un nouvel affichage du Masque Protocole provoque la suppression du badge est supprimé et le comptage reprend à '0'.
Chaque entrée de la liste signale un télégramme correspondant à l'un des objets de communication, qui a été repéré dans le Masque Objets de communication pour être journalisé (c.-à-d. que la case à cocher de l'objet de communication concerné de la colonne gauche est activée).
Si le Masque Objets de communication est activé, un badge est affiché en haut à droite de l'onglet de protocole lors de l'arrivée d'un nouveau télégramme ; ce badge indique le nombre de nouveaux télégrammes reçus depuis que le Masque Protocole a été quitté (ou depuis le démarrage du moniteur HS si le masque Protocole n'a pas encore été appelé).
Un nouvel affichage du Masque Protocole provoque la suppression du badge est supprimé et le comptage reprend à '0'.
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
N'oubliez pas que, lors de la nouvelle connexion avec le HS/FS, la case à cocher de la fonction Protocole sera désactivée pour tous les objets de communication et que la colonne « Nbre / Count » sera réglée sur '0' !
La liste de protocole n'est pas effacée en cas d'interruption de la connexion ou de nouvelle connexion !
La liste de protocole n'est pas effacée en cas d'interruption de la connexion ou de nouvelle connexion !
2.2.Masque Objets de communication
C'est ici que s'affiche la liste des objets de communication autorisés à 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 des actions spéciales :
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 des actions spéciales :
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 |
|---|---|
| Colonne 1 | Case à cocher pour l'identification à des fins de journalisation. Chaque objet de communication ainsi activé est enregistré dans le Protocole / Protocol. |
| Adr. gr. | Adresse de groupe au format x/y/z. |
| Nom | Désignation de l'objet de communication. |
| Nbre / Count | Nombre de télégrammes reçus depuis le démarrage du moniteur HS. |
| Heure / Time | Heure de réception du dernier télégramme. |
| Valeur/ Value | Valeur actuelle 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 Expert pour l'objet de communication. |
| Max | Maximum La valeur maximum définie dans Expert pour l'objet de communication. |
| S L | Symbole de 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 s'affiche ici. Si une Liste / List est définie, un L s'affiche. |
2.2.2.Barre d'action
La barre d'action située sur le bord droit du Masque Objets de communication permet de filtrer la liste adjacente et/ou d'affecter de nouvelles valeurs à chaque objet de communication.
En sont exclus les objets de communication au format « date » et « time » qui peuvent être affichés mais pas modifiés par le moniteur HS.
Pour modifier un objet de communication, la ligne correspondante doit avoir été sélectionnée (cliquée) au préalable. La ligne apparaît alors sur fond gris.
En sont exclus les objets de communication au format « date » et « time » qui peuvent être affichés mais pas modifiés par le moniteur HS.
Pour modifier un objet de communication, la ligne correspondante doit avoir été sélectionnée (cliquée) au préalable. La ligne apparaît alors sur fond gris.
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 « Adr. gr. » 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.
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 ».
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 ».
Définir valeur / Send Value
Entrez d'abord une valeur dans le champ de saisie, puis modifiez la valeur de l'objet de communication en conséquence d'un clic sur l'un des deux boutons :
- Absolut(e) : la valeur actuelle de l'objet de communication est réglée sur la valeur saisie.
- Relativ(e) : la valeur saisie est ajoutée à la valeur actuelle de l'objet de communication.
Remarque
Pour soustraire une valeur, entrer un chiffre précédé du signe « - » puis cliquez sur « Relativ(e) ».
Taille de pas / Step
Remarque
Cette boîte de saisie n'est visible que si une taille de pas a été définie dans le projet pour l'objet de communication.
La taille de pas est affichée.
En cliquant sur l'un des deux boutons (« + » ou « - »), la taille de pas est ajoutée à la valeur actuelle de l'objet de communication (bouton « + ») ou en est soustraite (bouton « - »).
En cliquant sur l'un des deux boutons (« + » ou « - »), la taille de pas est ajoutée à la valeur actuelle de l'objet de communication (bouton « + ») ou en est soustraite (bouton « - »).
Liste /List
Remarque
Cette boîte de saisie n'est visible que si une liste a été définie dans le projet pour l'objet de communication.
La liste est affichée.
Avec les boutons « vers le haut » et « vers le bas », vous réglez la valeur actuelle de l'objet de communication sur la prochaine valeur appropriée de la liste.
Avec les boutons « vers le haut » et « vers le bas », vous réglez la valeur actuelle de l'objet de communication sur la prochaine valeur appropriée de la liste.
2.3.Masque Protocole
Ce masque affiche la liste des télégrammes reçus.
De plus, vous avez ici la possibilité de supprimer la liste et/ou de l'exporter.
De plus, vous avez ici la possibilité de supprimer la liste et/ou de l'exporter.
2.3.1.Liste des télégrammes reçus
| Colonne | Explication |
|---|---|
| Heure / Time | Heure à laquelle a eu lieu l'affectation de la valeur. |
| Adr. gr. | Adresse de groupe. |
| Valeur/ Value | La valeur qui a été affectée à l'objet de communication. |
| Nom | La désignation de l'objet de communication. |
| Type | Format de l'objet de communication Les indications suivantes sont possibles :
|
Remarque
La désactivation d'un ou de plusieurs objets de communication n'a aucune incidence sur les lignes figurant déjà dans la liste à ce moment.
Remarque
Que son déclenchement soit manuel ou automatique (p. ex. en cas de nouveau transfert du projet sur le HS/FS), l'actualisation du navigateur n'a aucune incidence sur les affectations de valeur figurant déjà dans la liste à ce moment.
La suppression ou la modification d'objets de communication du projet, pour lesquels des entrées existent déjà dans la liste, n'a aucune incidence sur ces entrées même après un nouveau transfert du projet.
La suppression ou la modification d'objets de communication du projet, pour lesquels des entrées existent déjà dans la liste, n'a aucune incidence sur ces entrées même après un nouveau transfert du projet.
2.3.2.Barre de traitement
Dans la barre de traitement située sur le bord droit du Masque Protocole, vous disposez de possibilités de traitement de la liste et des données représentées.
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 : Aucune adresse de groupe n'est affichée dans le Masque 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 du 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 du projet -> Réseau -> Passerelle télécom
Problème : Certaines adresses de groupe manquent dans le Masque Objets 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.