Modbus Device Plugin

Die gesamte Modbus Device Plugin-Konfiguration befindet sich unter dem Nodepfad /System/Devices/Modbus Device.

Ein Modbus Device Channel repräsentiert die Verbindung zu einem Modbus TCP Server.

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

1. Fügen Sie einen Folder Node unter dem Node Modbus Device/Channels hinzu, oder machen Sie einen Rechtsklick auf den Modbus Device/Channels-Node und wählen Sie Add Channel aus.
2. Tragen Sie im Add Channel-Dialog die Settings für die Modbus TCP 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 Variables-Node können Sie Datenpunktnodes erstellen, die über Modbus gelesen und geschrieben werden.
Die Value Type-Eigenschaft muss dabei auf den entsprechenden Variablentyp festgelegt werden (Boolean, Byte, Int16, UInt16, Int32, UInt32 und die zugehörigen Array-Typen, sowie ab Version 1.5.11 String).

Über die Path-Eigenschaft des Nodes wird die Modbus-Adresse, der Datentyp im Modbus Server und die Länge der Daten (bei Arrays) definiert:

<UnitID>.<Entity><StartAddress>.<Offset>,<Length>,<DataType>

Ein String-Wert kann maximal 255 Zeichen beinhalten. Als String Encoding wird ISO-8859-1 verwendet.
Wird ein String mit [] angegeben, wird der eingegebene Wert als Länge definiert. Die Arraylänge wird dann ignoriert.
Strings können von Holding Register, Coils, Discrete Inputs und Input Registers gelesen werden.
Nur im Holding Register können String-Werte gelesen und geschrieben werden.

Das Modbus Device Plugin liefert je nach zu untersuchender Schicht verschiedene Statusinformationen. Generell werden die kanalbasierten Diagnoseinformationen durch den Verbindungsstatus des Channels zum Modbus produziert. Die variablenbasierten Diagnoseinformationen werden während des Lese-/Schreibzugriffs auf die verschiedenen Variablen produziert.

Um den Status des Modbus-Kanals zu überwachen und zu diagnostizieren, werfen Sie einen Blick auf das folgende Bild:

Das obige Bild zeigt das Bedienfeld des Modbus-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 läuft und es wurde erfolgreich eine Verbindung hergestellt. 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 Variablen 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 über Modbus auszulesen und das Ergebnis in den Variablen zu speichern.

Alle kanalbezogenen Statusinformationen werden auch in die kanalspezifische Logdatei im [LoggingFolder] protokolliert. Jede Logdatei wird nach dem Namensschema Modbus 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 ModbusDevice des Plugins definiert auch den ModbusDeviceChannel und erweitert somit die grundlegenden CodabixDevice und CodabixDeviceChannel Entities. Während das ModbusDevice nur eine Konkretisierung des CodabixDevice darstellt, erweitert der ModbusDeviceChannel den CodabixDeviceChannel mit den Modbus Variable Entities.

Der Kanal wird von einem Channel Worker behandelt, der eine TCP Socket Verbindung zum lokalen Server herstellt. Zur Fehlerdiagnosezwecken überprüft der Worker automatisch alle 10 Sekunden den Status der TCP Socket Verbindung, um den Channel Statuscode und seine Beschreibung zu aktualisieren und Verbindungsfehler zu erkennen.

Der Worker liest standardmäßig keine Werte. Wenn ein Anwender oder Plugin in CoDaBix® einen synchronen Lesevorgang der Channel Variablen anfordert (z.B. mit der „Read actual value“-Funktion in der CoDaBix® Webkonfiguration), liest der Channel Worker diese vom Modbus Server und schreibt diese in die entsprechenden CoDaBix Nodes.

Ähnlich schreibt der Channel Worker auch die Werte in den Modbus Server, wenn ein Client oder Plugin Werte in die Channel Variablen schreibt.

Damit eine Modbus Variable 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 Serverplugin verbunden ist und damit eine Subscription für die Modbus Variablennodes erstellen. In diesen Fällen liest der Channel Worker in regelmäßigen Intervallen die Variablen vom Modbus und schreibt den neuen Wert nach einer Wertänderung automatisch in die entsprechende CoDaBix® Node.

Der Modbus-Datentyp bestimmt, auf welche Modbus-Speicherbereich zugegriffen wird. Dabei werden die Variablenformate Skalar und Array unterstützt.