Découverte

Laisser un pilote balayer à la recherche d'équipements ou de points, ce que chaque balayage demande et renvoie, l'avancement et l'annulation, l'ajout des résultats, la découverte, depuis sa propre page, des tags qui manquent à un équipement, et l'appairage d'un équipement Matter par Bluetooth.

Pour les pilotes dont le protocole permet un vrai balayage, Découvrir trouve les équipements ou les points à votre place au lieu de vous les faire taper. Il vit sur la barre de commandes d'un nœud de pilote (et, pour Modbus RTU, dans la carte Découvrir des unités de la page d'une ligne série, et pour MQTT, dans la carte Découvrir les équipements de la page d'un broker), tandis que tout ce que le balayage prend vit dans la carte Portée du balayage de la page du pilote : la barre porte la commande, la carte porte sa portée. Tout cela demande Configurer Connector : un rôle sans cette permission ne se voit dessiner ni la carte de portée, ni le bouton. Un balayage refuse pendant qu'un essai tient la station ou que le runtime est arrêté. Quand un balayage ne rapporte rien, c'est un résultat de balayage, pas une fonction absente : le bouton n'apparaît que là où un balayage peut produire des résultats. Un équipement que vous avez déjà trouve depuis sa propre page les points qui lui manquent encore, avec Découvrir les tags dans l'en-tête de sa carte Tags (voir Découvrir les tags d'un équipement).

Quels pilotes balaient

Beckhoff ADS, Mitsubishi MC, LoRaWAN, HTTP et Generic serial and TCP n'ont pas de balayage et n'affichent aucun bouton. Le bouton n'apparaît qu'une fois le Connector en fonctionnement, parce que c'est le registre de pilotes du Connector qui répond si un balayage peut tourner, et il n'apparaît que pour les pilotes que cette version installe : si le registre répond avec un assemblage que l'application ne reconnaît pas, le bouton reste absent et la page Événements enregistre que le pilote installé n'est pas celui que cette version livre.

Modbus TCP : la carte Portée du balayage

La carte apparaît sur la page du pilote Modbus TCP : « Identification des équipements en lecture seule; les registres se configurent après l'ajout. »

La ligne sous les champs est le budget : « 2 hôtes × 3 identifiants d'unité = 6 sondages · limite 256 », avec « · 100 ms de silence par hôte. » quand il est posé. Un balayage peut envoyer 256 sondages au plus; au-dessus du budget, la ligne passe au rouge (« Ce balayage enverrait 512 sondages; réduisez la plage réseau ou la plage d'identifiants d'unité à 256 ou moins. ») et Découvrir se grise. Une saisie fautive est nommée de la même façon (« « 10.0.0 » n'est pas une adresse IPv4 valide à quatre octets. », « Le préfixe CIDR doit être compris entre /24 et /32. », « Saisissez au moins un identifiant d'unité (0 à 255). », « La plage d'identifiants d'unité « 9-3 » doit être croissante. »). Changer un champ de portée abandonne les résultats du balayage précédent, parce qu'ils décrivaient une autre portée. Quatre hôtes au plus sont balayés à la fois, une connexion par hôte.

Modbus RTU

Le balayage est sur la page de la ligne, pas sur celle du pilote : ID d'unité de début et ID d'unité de fin (de 1 à 247, croissantes, de 1 à 32 par défaut) et leur propre bouton Découvrir, avec une estimation du pire cas (« 32 sondages · jusqu'à ~32,1 s, dont 4,011 ms de silence avant chaque sondage. »). Le balayage ouvre le port une fois avec les réglages enregistrés de la ligne, sonde chaque unité à son tour, et refuse une ligne active plutôt que de l'interrompre : « Cette ligne est en service. Désactivez-la avant la découverte; Ganter Lab n'interrompt ni ne réactive le bus automatiquement. » Une modification en attente sur la ligne est enregistrée avant que le balayage ne commence; si elle ne peut pas l'être, le balayage ne commence pas (« La découverte n'a pas démarré parce que la modification de la ligne série n'a pas pu être enregistrée. »). La page Lignes série couvre le reste de cette carte.

Redfish et AVEVA PI : le service que le balayage lit

Ni un service Redfish ni un système PI ne s'annoncent sur un réseau que cette station puisse écouter : ces deux balayages lisent donc l'unique service vers lequel vous les pointez, dans la carte Portée du balayage de la page du pilote. Redfish prend l'adresse du service (https://bmc-host, ou https://bmc-host:8443 là où il répond ailleurs) et la lit toujours en HTTPS, parce que les identifiants de l'équipement voyagent avec chaque requête; une adresse qui demande le transport en clair est refusée là où elle est saisie. AVEVA PI prend l'adresse du service et, après un #, l'élément AF d'où part le parcours : https://pi-host/piwebapi#\\AF-SRV\Plant\Line 3. Sans cet élément, il n'y a rien à parcourir : Découvrir se grise donc et dit ce qui est attendu.

Les deux balayages lisent le service sans identifiants, parce qu'ils tournent avant que n'existe l'équipement qui les porterait. Un service qui authentifie chaque requête ne répond donc rien et le balayage ne trouve rien : ajoutez ce service à la main. Un équipement Redfish trouve ensuite ses points avec Découvrir les tags sur sa propre page, qui s'identifie comme l'équipement; les points d'un équipement AVEVA PI s'ajoutent à la main.

Faire tourner un balayage

Pendant le balayage, la page du pilote écrit une ligne d'état et le Découvrir de la barre devient Annuler. L'état vient de deux étapes indépendantes, la découverte des endpoints et le parcours des voies : « Balayage des endpoints… », « Inspection de l'endpoint 2… », « Lecture des voies de opc.tcp://plc:4840… », puis « 3 équipements trouvés. »; un pilote qui mène un balayage à lui indique où il en est et la page compte, « Avancement de la découverte : 1 sur 2… », tandis que les deux balayages Modbus écrivent toute la ligne, parce que le port, l'hôte et l'ID d'unité sont ce que lit celui qui les suit : « Balayage de COM7 · 32 sondages… », « Sondage de l'unité 5 (5 sur 32)… », « Sondage 5 sur 32; unité 5 vérifiée. », « Balayage terminé : 32 sondages. » sur une ligne série, et « Balayage de 2 hôtes × 3 ID d'unité… », « Sondage de 192.168.0.10:502 · unité 3… », « Hôte injoignable 192.168.0.11:502 ignoré. » sur un réseau; le balayage Rockwell nomme les réseaux où la diffusion est partie, « Recherche d'automates Rockwell sur 192.168.0.255, 10.0.0.255… », si bien qu'un résultat nul dit où la question est allée. Un balayage qui s'arrête sur une erreur de pilote garde ce qu'il a trouvé et le dit : « Le balayage s'est arrêté sur une erreur après avoir trouvé 1 équipement. La liste est peut-être incomplète. » Un endpoint dont les voies n'ont pas pu être lues est tout de même listé, avec zéro tag.

Le balayage possède le pilote pendant qu'il tourne : vous ne pouvez pas sélectionner un autre nœud (« Annulez la découverte avant de quitter ce pilote. »), ajouter un équipement ou une ligne, activer ou désactiver des lignes, ni employer les actions de ligne jusqu'à ce qu'il finisse. Les résultats appartiennent à la fenêtre qui a lancé le balayage : un autre onglet de navigateur sur la même station ne les voit pas.

Annuler

Annuler (« Annulation… » une fois pressé) arrête les deux étapes. Les candidats entièrement préparés avant l'annulation restent listés; l'endpoint dont les voies étaient encore en cours de lecture est abandonné. L'état indique « Découverte annulée. » et le journal des actions « Découverte annulée pour OPC UA; 2 résultats terminés conservés. » Le balayage reste occupé jusqu'à ce que le socket, le client ou la session temporaire du pilote se soit refermé; après deux secondes, l'état indique « Attente de la libération des ressources de découverte par le pilote… » plutôt que de prétendre que le balayage est déjà arrêté, parce qu'un pilote ne lâche pas toujours à l'instant où on le lui demande.

Les résultats

La carte Équipements découverts (sur une ligne, Unités découvertes) liste une carte par candidat : un nom modifiable, l'endpoint, et « 2 tags sur 5 sélectionnés ». En dessous, une grille compacte des tags candidats avec une coche Ajouter (cochée par défaut), Tag, Type de donnée et Accès; sans aucun, « Aucun tag signalé. Ajoutez l'équipement pour configurer ses tags dans son éditeur. » Là où le pilote donne à un tag un nom plus court que l'endroit où il a trouvé la voie, la cellule Tag montre cet endroit sur une deuxième ligne sous le nom : en OPC UA, le chemin complet du nœud (voir OPC UA). Rien n'est enregistré tant que vous ne pressez pas Ajouter un équipement sur une carte (« Ajout… » pendant l'exécution) : l'équipement est créé sous un nom unique sur le pilote, avec exactement les tags cochés, la carte quitte la liste, le nouvel équipement est mis en évidence dans le tableau Équipements de la page où le balayage a eu lieu, qui reste à l'écran, et le journal des actions indique « « Pump » ajouté avec 3 tags. » Les tags découverts arrivent en lecture seule ou inscriptibles selon ce que le pilote a rapporté, avec leur type et avec la chaîne par défaut; rien d'autre n'est déduit.

Un candidat qui correspond à un équipement que vous avez déjà est marqué Déjà configuré et propose Ouvrir au lieu d'Ajouter, si bien qu'un balayage ne crée jamais un doublon par accident. Seules les identités stables sont comparées : une unité Modbus RTU sur la même ligne, un nœud de périphérie ou un équipement Sparkplug B sur le même broker, un instrument SCPI sous la même ressource VISA, un équipement NI-DAQmx sous le même nom de NI MAX, un agent SNMP balayé par son équipement ou au même hôte et au même port, un fichier lu dans le même dossier, sous le même nom et de la même façon par un équipement File, une base de données balayée par son propre équipement Database, une CPU Siemens au même hôte qu'un équipement qui la lit par nom, et un identifiant de nœud Matter. Les autres pilotes ne comparent rien, parce qu'un endpoint joignable ne prouve pas qu'il s'agit du même matériel. Un équipement Matter, un agent SNMP, un équipement File, un équipement Database ou un équipement Siemens qui lit par nom configuré accepte encore quelque chose : sa carte liste, cochées, les valeurs que l'équipement publie et pour lesquelles il n'a pas encore de tag, et Ajouter les tags, avant Ouvrir, ajoute celles qui sont cochées à cet équipement (voir Matter, SNMP, File, Database et Siemens S7).

Masquer vide la liste, et attend le balayage : pendant qu'un balayage tourne, il est grisé, parce que vider la liste en plein balayage l'annule aussi et jette tout ce qui avait déjà répondu. Sélectionner un autre pilote, ou changer la portée, la vide également. Pendant un balayage, supprimer un équipement ou un tag et déplacer un équipement dans un dossier se grisent pour la même raison : le balayage tient le pilote, et la commande aurait échoué après votre confirmation. Sur Modbus RTU, l'identifiant d'unité est une colonne à part, et un identifiant déjà configuré sur la ligne est refusé à l'ajout : « L'unité 5 est déjà configurée sur « Line 1 ». »

Découvrir les tags d'un équipement

Un équipement que vous avez déjà lit davantage de ses points sans revenir à la page de son pilote : l'en-tête de sa carte Tags porte Découvrir les tags à côté de Ajouter un tag, partout où son pilote sait lire les points d'un seul équipement. Le balayage ne lit que cet équipement, tel qu'il est enregistré (une modification qui attend encore son enregistrement est enregistrée d'abord), et ne liste que les valeurs qu'il publie et pour lesquelles il n'a pas encore de tag, comparées par le point que chacune lit et jamais par le nom : une valeur que l'équipement lit déjà sous un autre nom n'est pas proposée de nouveau.

AVEVA PI n'affiche pas Découvrir les tags : son parcours part d'un élément AF, qu'aucun équipement ne garde, donc ses points viennent du Découvrir du pilote ou s'ajoutent à la main. Modbus, BACnet, Omron, SCPI et les pilotes sans balayage ne trouvent aucun point et ne l'affichent pas non plus.

Pendant le balayage, Découvrir les tags devient Annuler, une ligne d'état se tient au-dessus de la carte Tags, et le balayage retient le pilote exactement comme le fait le Découvrir du pilote lui-même : les commandes qui ont besoin du pilote restent dessinées, grisées, et disent pourquoi. Découvrir les tags est grisé lui-même tant que la station n'accepte aucun changement, tant qu'un autre balayage ou un appairage retient le pilote (« Un balayage de découverte est en cours sur ce pilote. Attendez qu'il se termine. ») et tant que l'équipement attend encore son adresse ou a un champ que son enregistrement refuse. Il demande Configurer Connector : un rôle sans cette permission ne se voit pas dessiner le bouton.

Ce que le balayage a trouvé apparaît sur une carte Tags découverts juste au-dessus de la carte Tags, chaque valeur cochée, avec Tag, Type de donnée et Accès et, sous un nom, l'emplacement plus long où le pilote a trouvé le point, comme sur les cartes de la page du pilote. Ajouter les tags, dans l'en-tête de la carte, ajoute les valeurs cochées à l'équipement, chacune une fois, numérotée là où un tag de l'équipement porte déjà son nom, et l'enregistre; les nouveaux tags sont mis en évidence dans le tableau de la carte Tags, qui reste à l'écran, et le journal des actions indique « 2 tags ajoutés à « Line PLC ». » Ce qui reste demeure proposé, et Masquer vide la carte. Un équipement qui a déjà un tag pour chaque valeur qu'il publie se le fait dire (« « Line PLC » a déjà un tag pour chaque valeur qu'il publie. »), et aussi un équipement dont le balayage n'a rien lu (« Le balayage n'a trouvé aucune valeur sur « Line PLC ». Vérifiez qu'il répond, puis relancez Découvrir les tags. »). Quitter le pilote vide la carte, comme il vide les résultats du pilote.

Le Découvrir du pilote lui-même continue de trouver les équipements que vous n'avez pas encore, et sa carte Équipements découverts ne change pas.

Appairer un équipement Matter

Matter met l'équipement physique en service par Bluetooth avant qu'il n'existe ici : le premier verbe du pilote Matter est donc Appairer un équipement, et non Ajouter un équipement, et il ouvre un formulaire sur la page du pilote (le menu Nouveau… et le menu du clic droit du pilote offrent la même chose). L'appairage demande Configurer Connector, une radio Bluetooth LE utilisable sur cet ordinateur, et le réseau que l'équipement va joindre, inscrit d'abord sur la carte Réseaux du pilote : un nom de Wi-Fi et son mot de passe, ou un réseau Thread et son jeu de données (voir Réseaux). Tant qu'aucun réseau n'y sert, Appairer un équipement reste grisé avec l'infobulle « Ajoutez d'abord le réseau que l'équipement doit rejoindre. » Le formulaire dit : « Mettez l'équipement physique en mode appairage avant de continuer. L'appairage utilise le Bluetooth de cet ordinateur. »

Appairer un équipement s'active une fois le nom et le code remplis, si un réseau sert et si la station accepte les modifications. Le formulaire parcourt alors cinq étapes, Valider, Trouver, Appairer, Rejoindre le réseau et Enregistrer, avec une ligne d'état en dessous : « Validation du code de configuration et du réseau… », « Recherche de l'équipement par Bluetooth… », « Authentification et appairage de l'équipement… », puis pour un réseau Wi-Fi « Envoi du nom et du mot de passe du réseau Wi-Fi à l'équipement… » et « Attente de l'arrivée de l'équipement sur le réseau Wi-Fi… » (pour un réseau Thread, « Envoi de la configuration du réseau Thread existant… » et « Attente de l'arrivée de l'équipement sur le réseau Thread… »), « Enregistrement du nœud mis en service dans le Fabric local… », « Appairage terminé. » Annuler n'est accepté que jusqu'à la sélection de l'annonce correspondante (« Arrêter avant toute modification de l'équipement »); à partir de là, le bouton indique « Finalisation en toute sécurité… », parce que l'équipement a été changé et que la station doit enregistrer le nœud même si vous partez. Fermer retire le formulaire tant que rien ne tourne.

En cas de succès, l'équipement est créé avec l'identifiant de nœud pour identité et le nom du réseau qu'il a joint dans son champ Réseau en lecture seule, et le journal des actions indique « Équipement Matter « Éclairage de la cuisine » appairé. » La page s'ouvre ensuite sur le pilote Matter, avec le nouvel équipement mis en évidence dans son tableau Équipements, et balaie ce seul équipement : sa carte liste, cochées, les valeurs qu'il publie, à côté de Ajouter les tags, et le balayage se termine par « Cochez les valeurs de « Éclairage de la cuisine » à créer comme tags, puis Ajouter les tags. » Ce que l'équipement offre, et ce que fait chaque valeur, se trouve sur Matter. Le code d'installation n'est jamais enregistré, journalisé ni réaffiché; le mot de passe ou le jeu de données du réseau reste sur la carte Réseaux, enregistré chiffré pour cet utilisateur Windows, et n'atteint jamais l'équipement, son adresse ni le journal. Si le nœud a été mis en service mais que son équipement n'a pas pu être créé, le journal des actions le dit et Découvrir est le chemin de récupération. Les échecs sont dits simplement et le formulaire reste ouvert pour un nouvel essai : un code invalide, un réseau dont le nom, le mot de passe ou le jeu de données n'est pas valide, aucun adaptateur Bluetooth utilisable, un Bluetooth refusé ou éteint, aucun équipement correspondant (« Mettez-le en mode appairage, gardez-le à proximité et réessayez. »), un code d'installation rejeté, un équipement qui joint par l'autre type de réseau ou par câble (rien n'y est écrit), un équipement qui a répondu qu'il n'a pas pu joindre le réseau (un nom de Wi-Fi qu'il n'a pas trouvé, un mot de passe refusé ou un autre refus : il ne garde rien et revient en mode appairage, corrigez donc le réseau et appairez de nouveau), un équipement qui n'a donné aucune réponse et n'a jamais paru sur le réseau local (son nœud reste dans le Fabric et se récupère avec Découvrir), un Fabric qui n'a pas pu être enregistré (quand l'équipement était déjà mis en service : « Ne réinitialisez pas l'équipement tant que le problème de stockage du Fabric n'est pas résolu. »), ou un autre appairage déjà en cours. Ce que chaque échec laisse sur l'équipement est dans Quand l'appairage échoue. Un seul appairage tourne à la fois; pendant qu'il tourne, vous ne pouvez pas quitter le pilote (« Attendez la fin de l'appairage Matter avant de quitter ce pilote. »).

Ce que la découverte ne fait pas

Un balayage n'enregistre jamais rien de lui-même, ne change jamais un équipement existant, et ne se relance jamais tout seul. Il ne déduit ni sous-réseaux, ni plans de registres, ni réglages série, n'active ni ne désactive une ligne ou un broker, et ne retire pas de l'équipement les candidats écartés. Il est refusé pour un pilote que le paquet ne porte pas. Ce que contiennent les résultats de chaque pilote est sur la page de ce pilote, sous Pilotes.