Découverte

Laisser un pilote chercher des équipements ou des points, ce que chaque balayage demande et rapporte, la progression et l'annulation, ajouter les résultats, découvrir depuis sa propre page les tags qui manquent à un équipement, et appairer un équipement Matter par Bluetooth.

Pour les pilotes dont le protocole admet un vrai balayage, Découvrir trouve les équipements ou les points à votre place au lieu de vous les faire taper. La commande vit sur la barre d'un nœud de pilote (et, pour Modbus RTU, dans la carte Découvrir les 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 consomme 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 voit ni la carte de portée ni le bouton. Un balayage refuse tant qu'un essai retient 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 manquante : 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 service, 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 ID d'unité = 6 sondages · limite 256 », avec « · 100 ms de silence par hôte. » quand il est réglé. Un balayage envoie 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'ID d'unité à 256 au plus. ») et Découvrir 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 ID d'unité (0-255). », « La plage d'ID d'unité « 9-3 » doit être croissante. »). Changer un champ de portée jette 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, croissants, 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 le début du balayage ; si elle ne peut pas l'être, le balayage ne démarre 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 PI System ne s'annonce sur un réseau que cette station puisse écouter, si bien que ces deux balayages lisent le seul service que vous leur désignez, 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 quand il répond ailleurs) et la lit toujours en HTTPS, parce que les identifiants de l'équipement voyagent à 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, donc Découvrir grise 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 imprime une ligne d'état et le Découvrir de la barre se change en 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 tant 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 avant qu'il ne 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 écarté. 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 la prise, le client ou la session temporaires du pilote soient fermés ; au bout de 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 ». Dessous, une grille compacte des tags candidats avec une case 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 conservé tant que vous n'avez pas pressé Ajouter un équipement sur une carte (« Ajout… » pendant l'opération) : 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 accessibles en écriture, selon ce que le pilote a rapporté, avec leur type, et avec la chaîne de conversion 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 de doublon accidentel. Seules les identités stables sont rapproché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 ID de nœud Matter. Les autres pilotes ne rapprochent rien, parce qu'un endpoint joignable n'est pas la preuve que c'est le 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 : tant qu'un balayage tourne, le bouton 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 grisent avec la même raison : le balayage possède le pilote, et la commande aurait échoué après que vous l'auriez confirmée. Sur Modbus RTU, l'ID d'unité est une colonne à part, et un ID déjà configuré sur la ligne est refusé à l'ajout : « L'unité 5 est déjà configurée sur « Ligne 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 voit pas 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 voit 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, si bien que le premier verbe du pilote Matter est Appairer un équipement, et non Nouvel équipement, et qu'il ouvre un formulaire sur la page du pilote (le menu Nouveau… et le menu du clic droit du pilote proposent 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 rejoindre, 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 est actif une fois le nom et le code remplis, un réseau qui sert et tant que 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é modifié et que la station doit enregistrer le nœud même si vous partez. Fermer referme le formulaire tant que rien ne tourne.

En cas de succès, l'équipement est créé avec l'ID de nœud pour identité et le nom du réseau qu'il a rejoint 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 propose, et ce que fait chaque valeur, se trouve sur Matter. Le code de configuration n'est jamais conservé, journalisé ni réaffiché ; le mot de passe ou le jeu de données du réseau reste sur la carte Réseaux, conservé 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 rattrapage. Les échecs sont dits sans détour et le formulaire reste ouvert pour un nouvel essai : un code non valide, 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 de configuration rejeté, un équipement qui rejoint 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 rejoindre 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'est jamais apparu sur le réseau local (son nœud reste dans le Fabric et peut être récupéré avec Découvrir), un Fabric qui n'a pas pu être enregistré (quand l'équipement avait déjà été 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 ; tant 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 ne conserve 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 du matériel 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.