Équipements

La page d'un équipement : son en-tête et ses verbes, la carte Équipement, la carte Connexion avec les champs que chaque pilote montre, les identifiants et les certificats, la grille des Tags avec la modification en lot, la copie d'un équipement, et le traitement des doublons et des collisions de nom.

Un équipement est un matériel auquel la station parle par un pilote : la façon dont on l'atteint, 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 un intervalle de scrutation de 1000 ms, l'identifiant d'unité 1 et le port qu'emploie 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 dans 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 lisent des vides, et aucune erreur de connexion ne peut apparaître avant qu'il y ait 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 met l'équipement en service et se connecte dans une boucle de reprise en arrière-plan, si bien qu'un équipement injoignable ne coûte rien. Ses tags lisent des vides jusqu'à ce que la connexion aboutisse, et la page montre entre-temps la dernière erreur de connexion.

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 avec l'URI de base, l'adresse exacte à laquelle le Connector se connecte, assemblée en direct à partir de 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, alors 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 est manquante, 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'équipement).

La carte Équipement

La carte Connexion

La carte apparaît pour chaque pilote qui déclare des champs de connexion et ne montre que les champs que ce pilote lit. La page de chaque pilote explique ses champs en profondeur; ceci est l'inventaire complet tel que le volet le dessine.

Un équipement Matter montre une carte Connexion différente : Node ID · lecture seule, l'identifiant de nœud sur 64 bits que l'appairage a attribué (ou « Appairage à refaire » quand l'identité enregistrée ne peut pas être lue), Réseau · lecture seule, le nom du réseau que l'équipement a joint 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 porteurs et les community SNMP sont protégés au repos par la protection des données de Windows, par utilisateur : la base de données de configuration ne détient donc 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 masqués dans les messages d'erreur que montre le journal des actions.

Un équipement OPC UA présente son certificat d'équipement 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 le certificat pour l'approuver ou le bloquer. Révoquer une approbation plus tard ferme les connexions qui en dépendaient. Le détail est sur la page de chaque pilote : OPC UA, Redfish, AVEVA PI, HTTP et MQTT.

La carte Commandes

Trois pilotes atteignent un équipement à qui l'on demande de faire des choses autant que de lire : HTTP, Redfish et AVEVA PI. La page de leur équipement porte une carte Commandes entre la carte Connexion et la carte Tags, coiffée de « 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 lancer demandent Configurer Connector, et un rôle sans cette permission ne se voit dessiner ni les champs, ni les verbes.

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

Le groupe de queue porte les deux verbes qui agissent sur cette seule ligne : Exécuter, qui l'envoie et rapporte ce que l'équipement a répondu (« « Reset » a répondu : accepté »), et Supprimer. Exécuter dit pourquoi il est refusé plutôt que 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 qui n'est pas 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 prend elle aussi des commandes, mais les siennes sont fixées par le protocole et viennent du pilote, non 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 est intitulée 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 plus quantité (champs typés). », « ID de nœud, par exemple ns=2;s=Temperature. »), et, pour Configurer Connector, la consigne « 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é après le compte) en Float, ou dans le premier type que le pilote prend en charge, 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 coiffé de son compte. 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 grisée.

Les trois interrupteurs d'étape sont des colonnes comme les champs qu'ils gouvernent, et ils se modifient en lot avec eux : cocher des lignes, taper les coefficients et activer 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 invalide, 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 ne fait qu'étalonner lit la grille mais n'y modifie rien, cellules Étal. et interrupteur Étal. active compris; ses modifications d'étalonnage passent par la page du tag.

La modification en lot

Cochez les lignes à changer, puis modifiez une cellule de n'importe quelle ligne : la nouvelle valeur est appliquée à cette ligne et à chaque ligne cochée, et les coches sont dépensées. Tant que des lignes sont cochées, un bandeau 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 vidées. Trois règles gardent une sélection mêlée honnête : le Nom et l'Adresse ne se répliquent jamais; la cellule Type aligne les champs dépendants de chaque ligne au moment où elle arrive; 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 de texte 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 de l'équipement 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 son intervalle de scrutation. La copie prend le nom de la source tant qu'il est libre sur le pilote, puis « Furnace (2) », « Furnace (3) », et arrive au niveau propre du pilote quel que soit le dossier de la source; une copie Modbus RTU reste sur la même ligne, sous le prochain identifiant 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'équipement sont uniques à l'intérieur d'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 des deux 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 identifiants d'unité différents et partagent alors la cadence de transaction de l'endpoint. Deux équipements Matter peuvent nommer le même identifiant de nœud : la découverte propose d'ouvrir celui qui existe plutôt que d'en créer un autre, mais elle n'interdit pas le second. 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éattribué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.