Das EUROMAP Device Plugin ermöglicht das Lesen und Schreiben von Werten von Geräten, die die EUROMAP 63-Spezifikation implementieren (dateibasierter Zugriff):
REPORT
-KommandosSET
-KommandosGETID
-KommandosBeachten Sie: Das EUROMAP Device Plugin verwendet dateibasierten Zugriff; daher muss das Session Directory für Codabix zugreifbar sein, damit das Plugin funktioniert. Sie müssen daher eine Erlaubnis zum Zugriff auf diesen Pfad in der Access Security-Sektion der Codabix Projekteinstellungen hinzufügen.
Die gesamte EUROMAP Device Plugin-Konfiguration befindet sich unter dem Nodepfad /System/Devices/EUROMAP Device
.
Ein EUROMAP Device Channel repräsentiert die Verbindung zu einer EUROMAP-Maschine.
Das zu verwendende Protokoll (derzeit wird nur EUROMAP 63 unterstützt).
Der Pfad zum Session-Verzeichnis im lokalen Dateisystem.
Beachten Sie: Damit Codabix auf den Pfad zugreifen darf, müssen Sie eine Lese-+Schreibberechtigung in der Access Security-Sektion der Codabix-Projekteinstellungen hinzufügen.
Die kleinste zu verwendende Session-Zahl.
Die größte (exklusiv) zu verwendende Session-Zahl.
Das Encoding, das beim Lesen von Antwortdateien der Maschine verwendet werden soll, um Zeichen außerhalb des ASCII-Bereichs zu unterstützen.
Das zu verwendende Zeilenende. (Diese Einstellung wird derzeit ignoriert; es wird immer CR+LF verwendet.)
Der zu verwendende Listendelimiter. (Diese Einstellung wird derzeit ignoriert; es wird immer „,“ verwendet.)
Das zu verwendende Kommando-Ende-Zeichen. (Diese Einstellung wird derzeit ignoriert; es wird immer „;“ verwendet.)
Die maximale Anzahl an Jobs, die zur gleichen Zeit aktiv sein können. (Diese Einstellung wird derzeit nicht verwendet.)
Um einen neuen EUROMAP-Channel zu erstellen, gehen Sie wie folgt vor:
EUROMAP Device/Channels
hinzu, oder machen Sie einen Rechtsklick auf den EUROMAP Device/Channels
-Node und wählen Sie Add Channel
aus.Add Channel
-Dialog die Settings für die EUROMAP-Verbindung ein.
Unter dem Parameters
-Node können Sie Datenpunktnodes erstellen, die aus der EUROMAP-Maschine gelesen und diese geschrieben werden können.
Unterstützte Node-Werttypen:
String
Int32
, Double
Boolean
Sie können auch Folder-Nodes erstellen, um Datapoint-Nodes zu gruppieren.
Die Path
-Property des Nodes wird verwendet, um den Parameternamen in der Maschine festzulegen.
Sie können die Browse-Methode aufrufen, um die Maschine zu browsen und automatisch die resultierenden Parameter im Parameters
-Node zu erstellen. Das Browsen wurd durch die Ausführung eines GETID
-Kommandos durchgeführt.
Wenn Parameter-Nodes gelesen werden (durch einen synchronen Lesevorgang oder durch eine Subscription), führt das Plugin ein REPORT
-Kommando aus, das einen einzelnen Sample der Parameter aufzeichnet, und liest dann die resultierende Repotdatei aus.
Die ausgeführte Report-Jobdatei sieht ähnlich aus wie diese:
JOB CbxJ-VCT11NK7SJ7 RESPONSE "CBXJQSQI.RSP"; REPORT CbxR-5A2NH4ETRCA "RP3VK4QQ.log" START IMMEDIATE STOP NEVER PARAMETERS @P1, @P2;
Wenn Parameter-Nodes geschrieben werden, führt das Plugin ein SET
-Kommando aus, das die Parameter auf die angegebenen Werte setzt. Das ausgeführte Set-Kommando sieht ähnlich aus wie dieses:
JOB CbxJ-LRC9LR6NF9A RESPONSE "CBXJ6RR7.RSP"; SET @P1 "Abcd"; SET @P2 123.45;
Das EUROMAP Device Plugin liefert je nach zu untersuchender Schicht verschiedene Statusinformationen. Generell werden die kanalbasierten Diagnoseinformationen durch Prüfen, ob der Zugriff auf das angegebene Session-Directory erlaubt ist, produziert. Die parameterbasierten Diagnoseinformationen werden während des Lese-/Schreibzugriffs auf die verschiedenen Parameter produziert.
Um den Status des EUROMAP-Kanals zu überwachen und zu diagnostizieren, werfen Sie einen Blick auf das folgende Bild:
Das obige Bild zeigt das Bedienfeld des EUROMAP-Kanals, das alle statusrelevanten Informationen anzeigt. Das Bedienfeld aktualisiert automatisch seine Statusinformation, wenn ein neuer Status verfügbar ist.
Statuskreis
Um den Status der verschiedenen Parameter zu überwachen und zu diagnostizieren, werfen Sie einen Blick auf die in Codabix angezeigte Status
-Eigenschaft der Spalte.
Benutzen Sie den Button „Read actual Value“, um die Werte von der Maschine auszulesen und das Ergebnis in den Parametern zu speichern.
Alle kanalbezogenen Statusinformationen werden auch in die kanalspezifische Logdatei im [LoggingFolder]
protokolliert. Jede Logdatei wird nach dem Namensschema EUROMAP Device.<ChannelName>.log
benannt.
Der Inhalt einer solchen Logdatei kann wie folgt aussehen:
... 2018-04-11 11:32:37.0 +2: [Error] Error (Severity=High): Code=[-1], Text=[The operation has timed-out.], Details=[] ...
Wie jedes Device Plugin erweitert das EUROMAP Device Plugin das Codabix Device Modell.
Der Device Typ EuromapDevice
des Plugins definiert auch den EuromapDeviceChannel
und erweitert somit die grundlegenden CodabixDevice
und CodabixDeviceChannel
Entities. Während das EuromapDevice
nur eine Konkretisierung des CodabixDevice
darstellt, erweitert der EuromapDeviceChannel
den CodabixDeviceChannel
mit den EUROMAP Parameter Entities.
Der Kanal wird von einem Channel Worker behandelt, der Dateien über das Session-Verzeichnis mit einer Maschine austauscht, um Jobs zu starten und die von der Maschine erzeugten Antwortdateien einzulesen.
Der Worker liest standardmäßig keine Werte. Wenn ein Anwender oder Plugin in Codabix einen synchronen Lesevorgang der Channel
-Parameter anfordert (z.B. mit der „Read actual value“-Funktion in der Codabix Webkonfiguration), liest der Channel Worker diese aus der dazugehörigen Maschine und schreibt diese in die entsprechenden Codabix-Nodes.
Ähnlich schreibt der Channel Worker auch die Werte in die Maschine, wenn ein Client oder Plugin Werte in die Channel
-Parameter schreibt.
Damit ein EUROMAP-Parameter regelmäßig gelesen wird, können Sie in der Webkonfiguration bei dem Node „History Options“ auf Yes
stellen (was eine interne Subscription erstellt),
oder Sie können zum Beispiel einen OPC UA Client verwenden, der mit dem OPC UA Server Plugin verbunden ist und damit eine Subscription für die EUROMAP-Parameternodes erstellen.
In diesen Fällen liest der Channel Worker in regelmäßigen Intervallen die Parameter von der Maschine und schreibt den neuen Wert nach einer Wertänderung automatisch
in den entsprechenden Codabix-Node.
Name | Pfad | Zweck / Verwendung |
---|---|---|
AssemblyFolder | <CodabixInstallDir>/plugins/EuromapDevicePlugin/ | Beinhaltet die Plugin-Assemblydatei. |
ConfigFolder | <CodabixProjectDir>/plugins/EuromapDevicePlugin/ | Beinhaltet die Plugin-Konfigurationsdatei. |
LoggingFolder | <CodabixProjectDir>/log/ | Beinhaltet die Plugin-Logdateien. |
Typ | Pfad | Zweck / Verwendung |
---|---|---|
Assembly | [AssemblyFolder]/CoDaBix.EuromapDevicePlugin.dll | Die Plugin-Assembly Datei. |
Logging | [LoggingFolder]/EUROMAP Device.<ChannelName>.log | Die Logdatei. |
Datum | 2020-12-07 |
---|---|
Version | 1.0 |
Name | EUROMAP Device Plugin |
---|---|
Node | /System/Devices/EUROMAP Device |
Version | 1.0.0 |
Name | CoDaBix.EuromapDevicePlugin.dll |
---|---|
Datum | 2020-12-07 |
Version | 1.0.0.0 |