EUROMAP Device Plugin

Beachten 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.

Um einen neuen EUROMAP-Channel zu erstellen, gehen Sie wie folgt vor:

1. Fügen Sie einen Folder Node unter dem Node EUROMAP Device/Channels hinzu, oder machen Sie einen Rechtsklick auf den EUROMAP Device/Channels-Node und wählen Sie Add Channel aus.
2. Tragen Sie im Add Channel-Dialog die Settings für die EUROMAP-Verbindung ein.
   
3. Nachdem Sie „Save“ geklickt haben, wird die Channel-Node erstellt.
4. Sie können den Kanal starten, indem Sie die Channel-Node auswählen und den Startbutton klicken.
   

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
• Numerische Typen wie 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

Farbe	Bedeutung
	Der Kanal ist gestoppt. Klicken Sie den ►-Button, um ihn zu starten.
	Der Kanal startet oder stoppt gerade oder wartet auf den Verbindungsaufbau.
	Der Kanal ist bereit für Lese-/Schreiboperationen. Sie ihn können durch Klick auf den ◼-Button stoppen.
	Der Kanal läuft, aber die Verbindung ist momentan fehlerhaft. Bitte überprüfen Sie den Statustext für weitere Informationen.

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=[]
...

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.