Gerätesuche

Einen Treiber nach Geräten oder Punkten suchen lassen, was jeder Suchlauf braucht und zurückgibt, Fortschritt und Verhalten beim Abbrechen, Ergebnisse hinzufügen, die fehlenden Tags eines Geräts von seiner eigenen Seite aus suchen und ein Matter-Gerät über Bluetooth koppeln.

Bei Treibern, deren Protokoll einen echten Suchlauf unterstützt, findet Geräte suchen Geräte oder Punkte für Sie, statt dass Sie sie eintippen. Der Befehl wohnt auf der Befehlsleiste eines Treiberknotens (und bei Modbus RTU in der Karte Einheiten suchen auf der Seite einer seriellen Leitung, bei MQTT in der Karte Geräte suchen auf der Seite eines Brokers), während alles, was der Suchlauf nimmt, in der Karte Suchbereich auf der Seite des Treibers wohnt: Die Leiste trägt den Befehl, die Karte trägt seinen Umfang. Alles davon braucht Connector konfigurieren: Einer Rolle ohne dieses Bit werden weder die Karte für den Umfang noch die Schaltfläche gezeichnet. Ein Suchlauf lehnt ab, solange ein Lauf die Station hält oder die Runtime gestoppt ist. Gibt ein Suchlauf nichts zurück, ist das ein Ergebnis des Suchlaufs und keine fehlende Funktion: Die Schaltfläche erscheint nur dort, wo ein Suchlauf Ergebnisse liefern kann. Ein Gerät, das Sie schon haben, findet die Punkte, die ihm noch fehlen, von seiner eigenen Seite aus, mit Tags suchen im Kopf seiner Karte der Tags (siehe Die Tags eines Geräts suchen).

Welche Treiber suchen

Beckhoff ADS, Mitsubishi MC, LoRaWAN, HTTP und Generic serial and TCP haben keinen Suchlauf und zeigen keine Schaltfläche. Die Schaltfläche erscheint erst, wenn der Connector läuft, denn es ist das Treiberverzeichnis des Connectors, das beantwortet, ob ein Suchlauf laufen kann, und sie erscheint nur für die Treiber, die diese Version installiert: Antwortet das Verzeichnis mit einer Programmbibliothek, die die Anwendung nicht kennt, bleibt die Schaltfläche weg, und die Seite Ereignisse hält fest, dass der installierte Treiber nicht der ist, den diese Version ausliefert.

Modbus TCP: die Karte Suchbereich

Die Karte erscheint auf der Seite des Treibers Modbus TCP: "Nur lesende Geräteidentifikation; Register werden nach dem Hinzufügen eingerichtet."

Die Zeile unter den Feldern ist der Rahmen: "2 Hosts × 3 Unit-IDs = 6 Abtastungen · Grenze 256", mit "· 100 ms Ruhe je Host.", wenn gesetzt. Ein Suchlauf darf höchstens 256 Abtastungen senden; über den Rahmen hinaus wird die Zeile rot ("Dieser Suchlauf würde 512 Abtastungen senden; verkleinern Sie den Netz- oder Unit-ID-Bereich auf 256 oder weniger."), und Suchen graut aus. Falsche Eingaben werden ebenso benannt ("'10.0.0' ist keine gültige IPv4-Adresse aus vier Oktetten.", "Das CIDR-Präfix muss zwischen /24 und /32 liegen.", "Geben Sie mindestens eine Unit-ID ein (0-255).", "Der Unit-ID-Bereich '9-3' muss aufsteigen."). Ein Feld des Umfangs zu ändern verwirft die Ergebnisse des vorherigen Suchlaufs, weil sie einen anderen Umfang beschrieben. Höchstens vier Hosts werden zugleich abgesucht, mit einer Verbindung je Host.

Modbus RTU

Der Suchlauf steht auf der Seite der Leitung, nicht auf der des Treibers: Unit-ID von und Unit-ID bis (1 bis 247, aufsteigend, standardmäßig 1 bis 32) und ihre eigene Schaltfläche Suchen, mit einer Schätzung des schlechtesten Falls ("32 Abtastungen · bis zu ~32,1 s, einschließlich 4,011 ms Pause vor jeder Abfrage."). Der Suchlauf öffnet den Anschluss einmal mit den gespeicherten Einstellungen der Leitung, tastet jede Einheit der Reihe nach ab und lehnt eine Leitung in Betrieb ab, statt sie zu unterbrechen: "Diese Leitung ist in Betrieb. Deaktivieren Sie sie vor der Gerätesuche; Ganter Lab unterbricht den Bus nicht und aktiviert ihn nicht von selbst wieder." Eine anstehende Änderung an der Leitung wird gespeichert, bevor der Suchlauf beginnt; geht das nicht, beginnt er nicht ("Die Gerätesuche wurde nicht gestartet, weil die Änderung an der seriellen Leitung nicht gespeichert werden konnte."). Die Seite Serielle Leitungen behandelt den Rest dieser Karte.

Redfish und AVEVA PI: der Dienst, den der Suchlauf liest

Weder ein Redfish-Dienst noch ein PI System kündigt sich in einem Netz an, in dem diese Station lauschen kann, diese beiden Suchläufe lesen also den einen Dienst, auf den Sie sie richten, in der Karte Suchbereich auf der Seite des Treibers. Redfish nimmt die Adresse des Dienstes (https://bmc-host oder https://bmc-host:8443, wo er anderswo antwortet) und liest sie immer über HTTPS, weil die Anmeldedaten des Geräts bei jeder Anfrage mitreisen; eine Adresse, die den unverschlüsselten Weg verlangt, wird dort abgelehnt, wo sie eingetippt wird. AVEVA PI nimmt die Adresse des Dienstes und, nach einem #, das AF-Element, bei dem der Durchlauf beginnt: https://pi-host/piwebapi#\\AF-SRV\Plant\Line 3. Ohne dieses Element gibt es nichts zu durchlaufen, Suchen graut also aus und sagt, was erwartet wird.

Beide Suchläufe lesen den Dienst ohne Anmeldedaten, weil sie laufen, bevor es das Gerät gibt, das sie hielte. Ein Dienst, der jede Anfrage anmeldepflichtig macht, antwortet daher nichts, und der Suchlauf findet nichts: Legen Sie diesen Dienst von Hand an. Ein Redfish-Gerät findet seine Punkte danach mit Tags suchen auf seiner eigenen Seite, das sich so anmeldet wie das Gerät; die Punkte eines AVEVA-PI-Geräts legen Sie von Hand an.

Einen Suchlauf ausführen

Solange der Suchlauf läuft, schreibt die Seite des Treibers eine Statuszeile, und Suchen auf der Leiste wird zu Abbrechen. Der Status kommt aus zwei unabhängigen Stufen, der Suche nach Endpunkten und dem Durchsuchen der Kanäle: "Endpoints werden abgesucht…", "Endpoint 2 wird untersucht…", "Kanäle von opc.tcp://plc:4840 werden gelesen…", dann "3 Geräte gefunden."; ein Treiber, der einen eigenen Suchlauf fährt, meldet, wie weit er ist, und die Seite zählt, "Fortschritt der Gerätesuche: 1 von 2…", während die beiden Modbus-Suchläufe die ganze Zeile schreiben, weil der Anschluss, der Host und die Unit-ID das sind, was jemand beim Zusehen liest: "Suchlauf auf COM7 · 32 Abfragen…", "Unit 5 wird abgefragt (5 von 32)…", "Abfrage 5 von 32; Unit 5 geprüft.", "Suchlauf beendet: 32 Abfragen." auf einer seriellen Leitung und "Suchlauf über 2 Hosts × 3 Unit-IDs…", "192.168.0.10:502 wird abgefragt · Unit 3…", "Nicht erreichbarer Host 192.168.0.11:502 übersprungen." im Netz; der Rockwell-Suchlauf nennt die Netze, in die der Rundruf ging, "Rockwell-Steuerungen werden auf 192.168.0.255, 10.0.0.255 gesucht…", damit ein Ergebnis von null sagt, wohin die Frage ging. Ein Suchlauf, der an einem Fehler des Treibers endet, behält, was er gefunden hat, und sagt es: "Der Suchlauf ist mit einem Fehler abgebrochen, nachdem 1 Gerät gefunden wurde. Die Liste kann unvollständig sein." Ein Endpunkt, dessen Kanäle sich nicht lesen ließen, wird trotzdem aufgeführt, mit null Tags.

Der Suchlauf besitzt den Treiber, solange er läuft: Sie können keinen anderen Knoten wählen ("Brechen Sie die Gerätesuche ab, bevor Sie diesen Treiber verlassen."), kein Gerät und keine Leitung hinzufügen, keine Leitungen aktivieren oder deaktivieren und keine Zeilenbefehle verwenden, bis er endet. Die Ergebnisse gehören dem Fenster, das den Suchlauf gestartet hat: Ein anderer Browser-Tab an derselben Station sieht sie nicht.

Abbrechen

Abbrechen ("Wird abgebrochen…", sobald gedrückt) hält beide Stufen an. Kandidaten, die vor dem Abbruch vollständig vorbereitet waren, bleiben aufgeführt; der Endpunkt, dessen Kanäle noch gelesen wurden, wird verworfen. Der Status liest "Gerätesuche abgebrochen." und das Aktionsprotokoll "Gerätesuche für OPC UA abgebrochen; 2 abgeschlossene Ergebnisse behalten." Der Suchlauf gilt als beschäftigt, bis der vorübergehende Socket, Client oder die Sitzung des Treibers geschlossen ist; nach zwei Sekunden sagt der Status "Es wird darauf gewartet, dass der Treiber seine Ressourcen für die Gerätesuche freigibt…", statt so zu tun, als wäre der Suchlauf schon vorbei, denn ein Treiber lässt nicht immer in dem Augenblick los, in dem er gefragt wird.

Die Ergebnisse

Die Karte Gefundene Geräte (an einer Leitung Gefundene Units) führt eine Karte je Kandidat auf: einen änderbaren Namen, den Endpoint und "2 von 5 Tags ausgewählt". Darunter eine kompakte Tabelle der Kandidaten für Tags mit einem Haken Hinzufügen (standardmäßig gesetzt), Tag, Typ und Zugriff; gibt es keine: "Keine Tags gemeldet. Fügen Sie das Gerät hinzu, um die Tags in seinem Editor einzurichten." Wo der Treiber ein Tag kürzer benennt als den Ort, an dem er den Kanal gefunden hat, zeigt die Zelle Tag diesen Ort in einer zweiten Zeile unter dem Namen: bei OPC UA den ganzen Pfad des Knotens (siehe OPC UA). Nichts wird gespeichert, bis Sie auf einer Karte Gerät hinzufügen drücken ("Wird hinzugefügt…", während es läuft): Das Gerät wird unter einem am Treiber eindeutigen Namen mit genau den angehakten Tags angelegt, die Karte verlässt die Liste, das neue Gerät ist in der Tabelle Geräte der Seite markiert, auf der die Suche lief und die auf dem Bildschirm bleibt, und das Aktionsprotokoll liest "'Pump' mit 3 Tags hinzugefügt." Gefundene Tags kommen nur lesend oder schreibbar an, so wie der Treiber sie gemeldet hat, mit ihrem Typ und mit der Standardkette; sonst wird nichts abgeleitet.

Ein Kandidat, der zu einem Gerät passt, das Sie schon haben, wird als Bereits konfiguriert gekennzeichnet und bietet Öffnen statt Hinzufügen an, ein Suchlauf legt also nie ein versehentliches Duplikat an. Verglichen werden nur feste Identitäten: eine Modbus RTU-Einheit auf derselben Leitung, ein Sparkplug B-Edge-Node oder -Gerät auf demselben Broker, ein SCPI-Messgerät unter derselben VISA-Ressource, ein NI-DAQmx-Gerät unter demselben Namen von NI MAX, ein SNMP-Agent, der über sein Gerät oder am selben Host und Port durchsucht wird, eine Datei, die ein File-Gerät aus demselben Ordner, unter demselben Namen und auf dieselbe Weise liest, eine Datenbank, die über ihr eigenes Database-Gerät durchsucht wird, eine Siemens-CPU am selben Host wie ein Gerät, das sie nach Name liest, und die Node-ID eines Matter-Knotens. Andere Treiber vergleichen nichts, denn ein erreichbarer Endpunkt ist kein Beweis, dass es dieselbe Anlage ist. Ein konfiguriertes Matter-Gerät, ein konfigurierter SNMP-Agent, ein konfiguriertes File-Gerät, ein konfiguriertes Database-Gerät oder ein konfiguriertes Siemens-Gerät, das nach Name liest, nimmt noch etwas auf: Seine Karte führt angehakt die Werte auf, die das Gerät veröffentlicht und für die es noch kein Tag hat, und Tags hinzufügen vor Öffnen fügt die angehakten diesem Gerät hinzu (siehe Matter, SNMP, File, Database und Siemens S7).

Ausblenden leert die Liste und wartet auf den Suchlauf: Solange einer läuft, ist es ausgegraut, denn die Liste mitten im Suchlauf zu leeren bricht ihn auch ab und wirft alles weg, was bereits geantwortet hatte. Einen anderen Treiber zu wählen oder den Umfang zu ändern leert sie ebenfalls. Solange ein Suchlauf läuft, grauen das Löschen eines Geräts oder eines Tags und das Verschieben eines Geräts in einen Ordner mit demselben Grund aus: Der Suchlauf hält den Treiber, und der Befehl wäre fehlgeschlagen, nachdem Sie ihn bestätigt hätten. Bei Modbus RTU ist die Unit-ID eine eigene Spalte, und eine Kennung, die auf der Leitung schon eingerichtet ist, wird beim Hinzufügen abgelehnt: "Unit 5 ist auf 'Line 1' bereits konfiguriert."

Die Tags eines Geräts suchen

Ein Gerät, das Sie schon haben, liest weitere seiner Punkte, ohne dass Sie zur Seite seines Treibers zurückgehen: Der Kopf seiner Karte der Tags trägt Tags suchen neben Tag hinzufügen, wo immer sein Treiber die Punkte eines einzelnen Geräts lesen kann. Der Suchlauf liest nur dieses Gerät, so wie es gespeichert ist (eine Änderung, die noch auf ihr Speichern wartet, wird zuerst gespeichert), und listet nur die Werte auf, die es veröffentlicht und für die es noch kein Tag hat, verglichen nach dem Punkt, den jeder liest, und nie nach dem Namen: Ein Wert, den das Gerät unter einem anderen Namen schon liest, wird nicht noch einmal angeboten.

AVEVA PI zeigt kein Tags suchen: Sein Durchlauf beginnt an einem AF-Element, das kein Gerät hält, deshalb kommen seine Punkte aus dem Geräte suchen des Treibers oder werden von Hand angelegt. Modbus, BACnet, Omron, SCPI und die Treiber ohne Suchlauf finden keine Punkte und zeigen es ebenfalls nicht.

Während der Suchlauf läuft, wird Tags suchen zu Abbrechen, über der Karte der Tags steht eine Statuszeile, und der Suchlauf hält den Treiber genau so wie das Geräte suchen des Treibers selbst: Die Befehle, die den Treiber brauchen, bleiben gezeichnet, ausgegraut, und sagen, warum. Tags suchen ist selbst ausgegraut, solange die Station keine Änderungen annimmt, solange ein anderer Suchlauf oder eine Kopplung den Treiber hält ("Auf diesem Treiber läuft ein Suchlauf. Warten Sie, bis er fertig ist.") und solange das Gerät noch auf seine Adresse wartet oder ein Feld hat, das sein Speichern ablehnt. Es braucht Connector konfigurieren: Einer Rolle ohne dieses Bit wird die Schaltfläche nicht gezeichnet.

Was der Suchlauf gefunden hat, erscheint auf einer Karte Gefundene Tags direkt über der Karte der Tags, jeder Wert angehakt, mit Tag, Typ und Zugriff und unter einem Namen dem längeren Ort, an dem der Treiber den Punkt gefunden hat, wie auf den Karten der Seite des Treibers. Tags hinzufügen im Kopf der Karte fügt die angehakten Werte dem Gerät hinzu, jeden einmal, nummeriert, wo ein Tag des Geräts seinen Namen schon trägt, und speichert es; die neuen Tags sind in der Tabelle der Karte der Tags markiert, die auf dem Bildschirm bleibt, und das Aktionsprotokoll liest "2 Tags zu 'Line PLC' hinzugefügt." Was übrig ist, bleibt angeboten, und Ausblenden leert die Karte. Ein Gerät, das schon für jeden Wert, den es veröffentlicht, ein Tag hat, bekommt das gesagt ("'Line PLC' hat bereits ein Tag für jeden Wert, den es veröffentlicht."), und eines, aus dem der Suchlauf nichts gelesen hat, ebenso ("Die Suche hat auf 'Line PLC' keine Werte gefunden. Prüfen Sie, ob es antwortet, und führen Sie Tags suchen dann erneut aus."). Den Treiber zu verlassen leert die Karte, so wie es die Ergebnisse des Treibers leert.

Das Geräte suchen des Treibers selbst findet weiterhin die Geräte, die Sie noch nicht haben, und seine Karte Gefundene Geräte bleibt unverändert.

Ein Matter-Gerät koppeln

Matter nimmt das physische Gerät über Bluetooth in Betrieb, bevor es hier existiert, der erste Befehl des Treibers Matter ist deshalb Gerät koppeln und nicht Gerät hinzufügen, und er öffnet ein Formular auf der Seite des Treibers (das Menü Neu… und das Rechtsklickmenü des Treibers bieten dasselbe an). Das Koppeln braucht Connector konfigurieren, einen brauchbaren Bluetooth-LE-Funk an diesem Rechner und das Netz, dem das Gerät beitreten soll, vorher auf der Karte Netzwerke des Treibers eingetragen: einen WLAN-Namen und sein Passwort oder ein Thread-Netz und seinen Datensatz (siehe Netzwerke). Solange dort kein Netz dient, bleibt Gerät koppeln ausgegraut, mit dem Tooltip "Fügen Sie zuerst das Netzwerk hinzu, dem das Gerät beitreten soll." Das Formular sagt: "Versetzen Sie das physische Gerät in den Kopplungsmodus, bevor Sie fortfahren. Die Kopplung nutzt Bluetooth auf diesem Rechner."

Gerät koppeln ist freigegeben, sobald Name und Code gefüllt sind, ein Netz dient und die Station Änderungen annimmt. Das Formular geht dann fünf Schritte durch, Prüfen, Finden, Koppeln, Netzwerk beitreten und Speichern, mit einer Statuszeile darunter: "Der Einrichtungscode und das Netzwerk werden geprüft…", "Das Gerät wird über Bluetooth gesucht…", "Das Gerät wird authentifiziert und gekoppelt…", dann bei einem WLAN "Name und Passwort des WLAN werden an das Gerät gesendet…" und "Es wird darauf gewartet, dass das Gerät dem WLAN beitritt…" (bei einem Thread-Netz "Die vorhandene Konfiguration des Thread-Netzwerks wird gesendet…" und "Es wird darauf gewartet, dass das Gerät dem Thread-Netzwerk beitritt…"), "Der in Betrieb genommene Knoten wird im lokalen Fabric gespeichert…", "Kopplung abgeschlossen." Abbrechen wird nur angenommen, bis die passende Ankündigung ausgewählt ist ("Anhalten, bevor das Gerät geändert wird"); von da an liest die Schaltfläche "Wird sicher zu Ende geführt…", weil das Gerät verändert wurde und die Station den Knoten festhalten muss, auch wenn Sie gehen. Schließen blendet das Formular aus, solange nichts läuft.

Bei Erfolg wird das Gerät mit der Node-ID als Identität und mit dem Namen des Netzes, dem es beigetreten ist, in seinem schreibgeschützten Feld Netzwerk angelegt, und das Aktionsprotokoll liest "Matter-Gerät 'Küchenlicht' gekoppelt." Danach öffnet sich die Seite auf dem Treiber Matter, mit dem neuen Gerät markiert in seiner Tabelle Geräte, und durchsucht nur dieses Gerät: Seine Karte führt angehakt die Werte auf, die es veröffentlicht, neben Tags hinzufügen, und die Suche endet mit "Haken Sie die Werte von 'Küchenlicht' an, die zu Tags werden sollen, und dann Tags hinzufügen." Was das Gerät anbietet und was jeder Wert bewirkt, steht unter Matter. Der Einrichtungscode wird nie gespeichert, nie protokolliert und nie wieder gezeigt; Passwort oder Datensatz des Netzes bleiben auf der Karte Netzwerke, verschlüsselt für diesen Windows-Benutzer gespeichert, und erreichen nie das Gerät, seine Adresse oder das Protokoll. Wurde der Knoten in Betrieb genommen, sein Gerät ließ sich aber nicht anlegen, sagt das Aktionsprotokoll es, und Suchen ist der Weg zurück. Fehlschläge werden klar benannt, und das Formular bleibt für einen zweiten Versuch offen: ein ungültiger Code, ein Netz, dessen Name, Passwort oder Datensatz nicht gültig ist, kein brauchbarer Bluetooth-Adapter, verweigertes oder abgeschaltetes Bluetooth, kein passendes Gerät ("Versetzen Sie es in den Kopplungsmodus, halten Sie es in der Nähe und versuchen Sie es erneut."), ein abgelehnter Einrichtungscode, ein Gerät, das über die andere Netzart oder per Kabel beitritt (nichts wird darauf geschrieben), ein Gerät, das geantwortet hat, dass es dem Netz nicht beitreten konnte (ein WLAN-Name, den es nicht fand, ein abgelehntes Passwort oder eine andere Ablehnung: Es behält nichts und ist wieder im Kopplungsmodus, also das Netz korrigieren und erneut koppeln), ein Gerät, das keine Antwort gab und nie im lokalen Netz erschien (sein Knoten bleibt im Fabric und lässt sich mit Suchen zurückholen), ein Fabric, das sich nicht speichern ließ (wenn das Gerät bereits in Betrieb genommen war: "Setzen Sie das Gerät nicht zurück, bis das Problem mit dem Speicher des Fabric behoben ist."), oder eine bereits laufende Kopplung. Was jeder Fehlschlag auf dem Gerät hinterlässt, steht unter Wenn die Kopplung fehlschlägt. Es läuft immer nur eine Kopplung; solange sie läuft, können Sie den Treiber nicht verlassen ("Warten Sie, bis die Matter-Kopplung fertig ist, bevor Sie diesen Treiber verlassen.").

Was die Gerätesuche nicht tut

Ein Suchlauf speichert nie von sich aus etwas, ändert nie ein vorhandenes Gerät und läuft nie von selbst erneut. Er leitet weder Teilnetze noch Registerbelegungen noch serielle Einstellungen ab, aktiviert und deaktiviert keine Leitung und keinen Broker und entfernt verworfene Kandidaten nicht aus der Anlage. Er wird bei einem Treiber abgelehnt, den das Paket nicht mitbringt. Was die Ergebnisse jedes Treibers enthalten, steht auf der Seite dieses Treibers unter Treiber.