Équipements

La page d'un équipement : son en-tête et ses verbes, la carte Équipement, la carte Connexion avec les champs que montre chaque pilote, identifiants et certificats, la grille des tags avec la modification en masse, copier un équipement, et comment les doublons et les collisions de noms sont traités.

Un équipement est un matériel auquel la station parle par un pilote : comment on le joint, et les tags qu'on y lit. Sélectionnez une ligne d'équipement dans la colonne Communications, ou pressez Ouvrir sur une ligne d'équipement du tableau d'un pilote, d'une ligne série, d'un broker ou d'un dossier, pour ouvrir sa page. Voir Connector la lit ; Configurer Connector la modifie. Les lignes série ont leur propre page, Lignes série, et les brokers MQTT sont décrits sur MQTT.

Créer un équipement

Un nouvel équipement s'appelle « Nouvel équipement » (puis « Nouvel équipement 2 », et ainsi de suite), il est activé, avec une période de scrutation de 1000 ms, l'ID d'unité 1 et le port qu'utilise son pilote (voir la carte Connexion plus bas ; un équipement du pilote Generic serial and TCP démarre sans port), et il n'est pas ouvert : il apparaît mis en évidence, amené dans la zone visible, dans le tableau Équipements de la page qui le liste (celle du pilote, du dossier, de la ligne ou du broker), et le journal des actions indique « Équipement « Nouvel équipement » ajouté. Ouvrez-le pour modifier ses détails. » Depuis ce tableau, l'écran reste où il est ; depuis Nouveau… ou un clic droit, il va à cette page. Ouvrir sur la ligne, ou sa ligne dans l'arborescence, ouvre l'équipement. Un équipement est refusé sous un pilote que le paquet ne porte pas, et sous Matter, où un équipement ne vient que d'un appairage ou d'une découverte (« Utilisez Appairer un équipement pour ajouter un nouveau nœud Matter, ou Découvrir pour en ajouter un déjà mis en service. »). Chacun de ces gestes se fait sous un pilote déjà ajouté ; ajouter un pilote est décrit sur La liste des pilotes et la page d'un pilote.

Un équipement dont le pilote le joint par un hôte (tout pilote doté du champ Hôte) commence avec cet hôte vide, et la station n'essaie pas de le connecter tant que l'hôte n'est pas saisi : son point reste gris, la ligne et la page affichent « Hôte pas encore saisi », ses tags se lisent comme des vides, et aucune erreur de connexion ne peut apparaître avant qu'il existe une adresse à essayer. Entre-temps, il n'est jamais dirigé vers cet ordinateur ; pour un équipement qui se trouve vraiment sur cet ordinateur, saisissez localhost. Un équipement NI-DAQmx n'a pas d'hôte : il attend de la même façon son Nom de l'équipement, et affiche « Équipement NI-DAQmx pas encore saisi » tant qu'il n'en a pas (voir NI-DAQmx). Un équipement Fluke NetDAQ attend son hôte, puis la Voie de base de son instrument, et affiche « Voie de base pas encore saisie » tant qu'il n'en a pas (voir Fluke NetDAQ). Un équipement File attend son Chemin du dossier, et affiche « Dossier pas encore saisi » tant qu'il n'en a pas (voir File). Un équipement Database attend de savoir où se trouve sa base de données (son serveur et le nom de la base de données, son fichier ou sa source de données), et affiche « Serveur pas encore saisi » tant qu'il n'a pas de serveur (voir Database). Un équipement LoRaWAN attend son DevEUI du capteur (un capteur) ou son EUI de la station (un concentrateur), et affiche « DevEUI pas encore saisi » ou « EUI de la station pas encore saisi » tant qu'il n'en a pas (voir LoRaWAN) ; un identifiant saisi qui ne compte pas 16 chiffres hexadécimaux n'est pas attendu mais refusé.

Une fois qu'il a un hôte, la connexion n'est jamais une étape bloquante : le Connector enrôle l'équipement et se connecte dans une boucle de reprise en arrière-plan, si bien qu'un équipement injoignable ne coûte rien. Ses tags se lisent comme des vides jusqu'à ce que la connexion s'établisse, et la page montre la dernière erreur de connexion en attendant.

L'en-tête

Le nom, la ligne « Un équipement auquel cette station parle : comment il est joint, et les tags lus depuis lui. » et un badge portant l'URI de base, l'adresse exacte à laquelle le Connector se connecte, assemblée en direct depuis la carte Connexion (par exemple modbus+tcp://192.168.0.10:502/1, opc.tcp://plc:4840, simulated://CompressedAir). Un équipement encore sans hôte n'a pas d'URI de base, si bien que le badge est absent jusqu'à ce que l'hôte soit saisi. Le badge est aussi absent tant que les champs ne forment aucune adresse que le pilote accepte, par exemple sur un équipement Modbus RTU dont la ligne manque, ou dont la ligne porte une valeur que sa page n'a pas enregistrée. En dessous, l'un de six avis :

• Pilote absent de ce paquet : « Cet équipement a besoin du pilote …, que cette installation n'inclut pas : il reste donc hors ligne. Ses réglages sont conservés et il peut être supprimé ; rien d'autre ici ne change ce qu'il lit. » Les points de suspension tiennent la place du nom du pilote.
• VISA n'est pas installé sur cet ordinateur (SCPI instruments, un équipement atteint par VISA) : « Cet équipement atteint son instrument par VISA, absent de cet ordinateur : il reste donc hors ligne. Installez NI-VISA ou la Keysight IO Libraries Suite et l'équipement se connecte. Un instrument doté d'un port réseau peut aussi être atteint en TCP. » Voir SCPI instruments.
• NI-DAQmx n'est pas installé sur cet ordinateur (NI-DAQmx, sur un ordinateur qui ne l'a pas) : « Cet équipement est lu par NI-DAQmx, absent de cet ordinateur : il reste donc hors ligne. Ganter Lab n'inclut pas NI-DAQmx : installez-le, gratuitement depuis ni.com, et l'équipement se connecte avec la configuration qu'il a. » Voir NI-DAQmx.
• En attente de l'approbation du certificat (OPC UA, Redfish, AVEVA PI, HTTP en HTTPS, MQTT en TLS) : « Cet équipement a présenté un certificat que cette station n'a jamais approuvé, donc rien n'est encore lu depuis lui. Vérifiez l'empreinte auprès de la personne qui a mis l'équipement en service, puis approuvez-le sous Accès des équipements, sur la page du pilote OPC UA. », avec le pilote de l'équipement nommé, ou pour un équipement MQTT « Le broker de cet équipement a présenté un certificat que cette station n'a jamais approuvé, donc rien n'est encore lu depuis cet équipement. Vérifiez l'empreinte auprès de la personne qui gère le broker, puis approuvez-le sous Accès des équipements, sur la page du pilote MQTT. », avec un bouton Examiner le certificat qui ouvre l'Accès des équipements de la page du pilote sur ce certificat (OPC UA, Redfish, AVEVA PI, HTTP, MQTT).
• Hôte pas encore saisi, un avis neutre sur un équipement activé dont l'hôte est encore vide : « La station n'essaie pas de joindre cet équipement tant qu'il n'a pas d'hôte : rien n'est donc encore lu depuis lui et il n'y a aucune erreur à afficher. Saisissez l'hôte dans la carte Connexion ci-dessous et la station s'y connecte. » Un équipement NI-DAQmx sans nom d'équipement affiche Équipement NI-DAQmx pas encore saisi à la place : « La station n'essaie pas de joindre cet équipement tant qu'il n'a pas le nom d'un équipement NI-DAQmx : rien n'est donc encore lu depuis lui et il n'y a aucune erreur à afficher. Saisissez le nom que NI MAX donne à l'équipement dans la carte Équipement NI-DAQmx ci-dessous et la station s'y connecte. » Un équipement File sans dossier affiche Dossier pas encore saisi : « La station ne lit pas cet équipement tant qu'il n'a pas de dossier : rien n'est donc encore lu depuis lui et il n'y a aucune erreur à afficher. Saisissez le dossier dans la carte Dossier et fichier ci-dessous et la station commence à le lire. » Un équipement Database qui ne dit pas où se trouve sa base de données affiche Serveur pas encore saisi, Nom de la base de données pas encore saisi, Fichier de base de données pas encore saisi ou Source de données pas encore saisie, selon ce qui lui manque encore : « La station n'atteint pas cet équipement tant qu'il ne dit pas où se trouve sa base de données : rien n'est donc encore lu depuis lui et il n'y a aucune erreur à afficher. Saisissez-le dans la carte Base de données ci-dessous (le serveur et le nom de la base de données, le fichier ou la source de données) et la station s'y connecte. »
• Sinon, sur un équipement qui passe par une ligne série ou un broker en erreur, un avis neutre qui y renvoie, « Cet équipement passe par la ligne série Bench bus, qui est en erreur. La page de la ligne indique pourquoi. », ou bien l'erreur propre de l'équipement, en rouge, quand il y en a une (voir Activation et état de santé).

En dessous, l'équipement nomme ses tags qui ont une erreur à eux, après le même marqueur rouge que l'arborescence : « 3 tags en erreur : C3, Opt_Int, T5 », les autres comptés au-delà de trois noms. Le motif de chacun reste sur le tag. Tant que l'équipement n'est pas connecté, il n'en nomme aucun : sa propre erreur dit pourquoi.

La barre de commandes

Le menu du clic droit ajoute Ajouter un tag et Déplacer vers (voir Dossiers d'équipements).

La carte Équipement

La carte Connexion

La carte apparaît pour chaque pilote qui déclare des champs de connexion et n'affiche que les champs que ce pilote lit. La page de chaque pilote explique ses champs en détail ; voici l'inventaire complet, tel que le volet le dessine.

Un équipement Matter montre une carte Connexion différente : Node ID · lecture seule, l'ID de nœud sur 64 bits attribué par l'appairage (ou « Appairage à refaire » quand l'identité conservée ne peut pas être lue), Réseau · lecture seule, le nom du réseau que l'équipement a rejoint lors de son appairage (un équipement appairé avant que Ganter Lab ne l'enregistre, ou ajouté avec Découvrir, dit qu'il n'a pas été enregistré), et État, le mot d'état de santé de l'équipement. Rien n'y est modifiable. Un équipement Simulated n'a aucune carte Connexion. Un équipement du pilote Generic serial and TCP porte deux cartes de plus sous sa carte Connexion, Messages reçus et Somme de contrôle, qui disent comment un message se termine et comment il se vérifie ; voir Generic serial and TCP. Un équipement Omron lu en FINS porte une carte FINS sous sa carte Connexion, avec le transport, le réseau, les nœuds, l'unité et le délai de réponse ; voir Omron. Un équipement du pilote SCPI instruments porte une carte Instrument de mesure sous sa carte Connexion, avec l'identité de l'instrument, le terminateur, le délai de réponse, la confirmation d'écriture et les commandes de préparation ; voir SCPI instruments. Un équipement NI-DAQmx n'a pas de carte Connexion : la carte Équipement NI-DAQmx se trouve à sa place, avec le nom que NI MAX donne à l'équipement et le produit que NI-DAQmx y lit ; voir NI-DAQmx. Un équipement du pilote SNMP porte une carte Agent SNMP sous sa carte Connexion, avec la version, la community ou l'utilisateur SNMPv3 avec son niveau de sécurité, ses protocoles et ses mots de passe, le délai de réponse et les nouvelles tentatives ; voir SNMP. Un équipement File n'a pas de carte Connexion : la carte Dossier et fichier se trouve à sa place, avec le dossier, le fichier et le format, suivie de la carte Texte du fichier et, sur un équipement qui lit un fichier, de la carte Écriture ; voir File. Un équipement Database n'a pas de carte Connexion : la carte Base de données se trouve à sa place, avec le type de base de données et l'endroit où elle se trouve, suivie de la carte Connexion à la base sur toute base de données sauf SQLite ; voir Database.

Identifiants et certificats

Les mots de passe, les jetons bearer et les community SNMP sont protégés au repos par la protection de données Windows propre à l'utilisateur, si bien que la base de configuration ne porte jamais la valeur en clair. Cette protection est liée au compte Windows et à la machine qui ont saisi le secret : sur un autre compte, le champ revient vide avec la note « Illisible sur ce compte Windows : il ne s'ouvre que sur la machine et le compte Windows qui l'ont saisi. Saisissez-le de nouveau ici. » Les identifiants sont remis directement au pilote ; ils n'apparaissent jamais dans l'URI de base ni dans le journal, et ils sont retirés des messages d'erreur que montre le journal des actions.

Un équipement OPC UA présente son certificat de matériel avant qu'une session ne s'ouvre, tout comme le matériel qu'un équipement Redfish, AVEVA PI ou HTTP joint en HTTPS, ou le broker d'un équipement MQTT en TLS. Un certificat auquel Windows ne fait pas confiance et que cette station n'a jamais approuvé n'échoue pas en silence : l'équipement indique « En attente de l'approbation du certificat » dans l'arborescence et sur la page, et le bouton du bandeau ouvre l'Accès des équipements de la page de son pilote sur ce certificat pour l'approuver ou le bloquer. Révoquer une approbation plus tard ferme les connexions qui s'appuyaient dessus. Les détails sont sur la page de chaque pilote : OPC UA, Redfish, AVEVA PI, HTTP et MQTT.

La carte Commandes

Trois pilotes joignent du matériel à qui l'on demande de faire des choses en plus de lire : HTTP, Redfish et AVEVA PI. La page de leur équipement porte une carte Commandes entre les cartes Connexion et Tags, intitulée « Ce que cet équipement peut être invité à faire. Chaque commande nomme le chemin auquel la requête est envoyée, sous l'adresse de l'équipement. » Tout le monde voit la liste ; déclarer, modifier et envoyer demandent Configurer Connector, et un rôle sans cette permission ne voit ni les champs ni les verbes.

Ajouter une commande ajoute une ligne nommée « Commande 1 » (numérotée d'après ce qui existe déjà). Chaque ligne porte :

Le groupe de queue porte les deux verbes qui agissent sur cette ligne seule : Exécuter, qui l'envoie et rapporte ce que le matériel a répondu (« « Réinitialiser » a répondu : accepted »), et Supprimer. Exécuter dit pourquoi elle est refusée au lieu de disparaître : une commande sans chemin (« Cette commande n'a pas encore de chemin, il n'y a donc rien à envoyer. »), une commande éteinte, une commande qui attend encore d'être enregistrée dans le runtime, un équipement non connecté, et la limite d'ingénierie ou d'essai de la station elle-même. Les autres pilotes ne portent pas la carte du tout : une borne de recharge prend aussi des commandes, mais les siennes sont fixées par le protocole et viennent du pilote, pas de ce que vous tapez ici, et un nœud Matter n'en prend aucune, car tout changement sur lui est l'écriture d'un de ses tags.

Envoyer une commande est une écriture sur l'équipement, alors Exécuter passe par le même entonnoir que l'écriture manuelle d'un tag : la commande attend son tour derrière ce que la station est déjà en train de faire, atteint l'équipement par le même chemin qu'un appel venu d'un système extérieur, et chaque envoi est consigné avec ce qui a été demandé, sur quel équipement, et ce qui est revenu. Tant que la station n'accepte plus de travail, l'envoi reçoit une réponse au lieu de rester muet : « La station n'accepte pas de commande en ce moment. » Un Connector qui n'est pas en service répond « Le Connector n'est pas en service, rien ne peut donc être envoyé à l'équipement. », et un refus de l'équipement lui-même est rapporté avec ses propres mots. Une commande que le Connector n'a pas pu exécuter dit ce qu'elle a rencontré dans la langue de la station, comme le dit la ligne rouge d'un équipement : « L'équipement n'est pas connecté, donc rien ne lui a été envoyé. » pour un équipement qui a décroché, l'équipement qui n'a pas répondu à temps, une requête que le réseau a refusée ou le pilote qui a échoué ; le journal technique garde la ligne technique.

La carte Tags

La carte s'intitule Tags, puis « Format d'adresse · <indication> » qui dit comment ce pilote adresse un tag (« Nom de tag libre (par exemple sim/temperature). », « Numéro de registre + quantité (champs typés). », « ID de nœud, par exemple ns=2;s=Temperature. »), et pour Configurer Connector l'instruction « Cochez des lignes, puis modifiez une cellule pour l'appliquer à toutes. Les coches se vident une fois la modification appliquée. » et le bouton Ajouter un tag. Ajouter un tag crée « Tag n° 5 » (numéroté d'après le compte) en Float, ou le premier type que le pilote accepte, en lecture seule. Le tag n'est pas ouvert : il apparaît mis en évidence dans la grille, dans le groupe de son type et amené dans la zone visible, où ses champs se modifient dans la ligne, et son Ouvrir mène à sa page. Le journal des actions indique « Tag ajouté à « Furnace ». » ou, quand le nouveau tag a encore besoin de quelque chose, « Tag ajouté à « Furnace ». Renseignez ses détails dans sa ligne. » Dans le menu Nouveau… de la colonne, l'entrée d'un équipement propose Nouveau tag, et le menu du clic droit sur l'équipement Ajouter un tag : tous deux amènent l'écran à la page de l'équipement et font de même. À côté du bouton Ajouter un tag, là où le pilote de l'équipement sait lire les points d'un seul équipement, se trouve Découvrir les tags : il balaie l'équipement à la recherche des valeurs qu'il publie et propose celles qui n'ont pas encore de tag (voir Découvrir les tags d'un équipement).

La grille

Les lignes sont groupées par type de donnée, dans cet ordre : Numérique, Booléen, Texte et autres, chaque groupe portant son compte en titre. Les colonnes suivent l'ordre des cartes de la page d'un tag ; une cellule qui ne s'applique pas à une ligne (un champ numérique sur un tag booléen) est dessinée vide et inactive.

Les trois interrupteurs d'étape sont des colonnes comme les champs qu'ils gouvernent, et ils se modifient en masse avec eux : cocher des lignes, taper les coefficients et allumer l'étape change ce que ces lignes lisent dans la même modification, sans ouvrir chaque point. Ce que la grille ne porte toujours pas, ce sont les politiques de lecture non exploitable, les assistants deux points, le champ d'écriture et les références croisées : ceux-là sont sur la page du tag. Un rôle qui n'a qu'Étalonner les tags lit la grille mais n'y modifie rien, les cellules d'étalonnage et l'interrupteur Ét. active compris ; ses modifications d'étalonnage passent par la page du tag.

La modification en masse

Cochez les lignes à changer, puis modifiez une cellule de n'importe quelle ligne : la nouvelle valeur est appliquée à cette ligne et à toutes les lignes cochées, et les coches sont consommées. Tant que des lignes sont cochées, une bande au-dessus de la grille indique « 3 lignes sélectionnées. Modifier une cellule l'applique à toutes et efface les coches. » avec un bouton Effacer la sélection. Les coches appartiennent à l'équipement : y revenir plus tard les trouve effacées. Trois règles gardent une sélection mêlée honnête : le nom et l'adresse ne se recopient jamais ; la cellule Type de donnée aligne les champs dépendants de chaque ligne en arrivant ; et une valeur qu'une ligne ne peut pas prendre est refusée pour cette ligne et laissée telle quelle, ce qui permet à une ligne Chaîne de survivre à une nature de signal numérique, et à une ligne entière à une action de limite NaN.

Copier l'équipement

Copier l'équipement crée à partir du sélectionné un équipement qui est à vous : les mêmes champs de connexion et les mêmes identifiants, chaque tag cloné sous une identité neuve avec toute sa chaîne, son état d'activation et sa période de scrutation. La copie prend le nom de la source tant qu'il est libre sur le pilote, puis « Furnace (2) », « Furnace (3) », et atterrit au niveau du pilote lui-même quel que soit le dossier de la source ; une copie Modbus RTU reste sur la même ligne sous le prochain ID d'unité libre, une copie sur une ligne du pilote Generic serial and TCP ou du pilote SCPI instruments reste sur cette ligne, et une copie MQTT sur le même broker, une copie Sparkplug B avec son ID le plus intérieur numéroté de la même façon (« Press1 (2) ») pour que deux équipements du broker ne nomment jamais une même identité. La copie n'est pas ouverte : l'écran va à la page qui la liste (le pilote, la ligne ou le broker), avec la copie mise en évidence dans son tableau Équipements et amenée dans la zone visible, l'original à côté : « « Furnace » a été copié vers « Furnace (2) ». Ouvrez la copie pour la modifier. » Une copie Omron sur une ligne reste sur cette ligne sous le prochain numéro d'unité libre.

Doublons et collisions

Les noms d'équipements sont uniques dans un pilote, sans tenir compte de la casse : les verbes de création s'écartent avec un suffixe numérique, et un renommage vers un nom déjà pris est refusé à la validation. Deux équipements activés sous un même pilote dont les noms se normalisent vers le même segment technique (Line A et Line-A) sont tous deux retirés de la scrutation plutôt qu'un seul l'emporte, et leurs tags ne lisent rien tant que l'un n'est pas renommé ou désactivé. L'identité technique est limitée à 128 caractères : « L'identité technique de l'équipement ne peut pas dépasser 128 caractères. » Deux équipements Modbus TCP peuvent partager un hôte et un port avec des ID d'unité différents et partagent alors le cadencement des transactions de l'endpoint. Deux équipements Matter peuvent nommer le même ID de nœud : la découverte propose d'ouvrir celui qui existe plutôt que d'en créer un second, mais ne l'interdit pas. Deux équipements NI-DAQmx peuvent de même lire le même équipement de NI MAX, par exemple un module à deux intervalles de scrutation.

Ce que la page d'un équipement ne fait pas

Le pilote ne peut pas être changé, le dossier ne se modifie pas ici, et ni la ligne d'un équipement sur une ligne série ni le broker d'un équipement MQTT ne peuvent être réaffectés ; un équipement du pilote Generic serial and TCP passe de TCP à UDP et inversement, et un équipement du pilote SCPI instruments de TCP à VISA, jamais d'une ligne au réseau. Activer un équipement n'active pas ses tags, et désactiver un équipement ne bascule pas les leurs. Il n'y a ni import ni export par équipement, et aucun test de connexion autre qu'activer l'équipement et lire son état de santé et sa dernière erreur. Un équipement Omron passe de UDP à TCP, jamais d'une ligne au réseau.