Allen-Bradley Device Plugin

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

Ein Allen-Bradley Device Channel repräsentiert die Verbindung zu einer Allen-Bradley SPS.

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

1. Fügen Sie einen Folder Node unter dem Node Allen-Bradley Device/Channels hinzu, oder machen Sie einen Rechtsklick auf den Allen-Bradley Device/Channels-Node und wählen Sie Add Channel aus.
2. Tragen Sie im Add Channel-Dialog die Settings für die Allen-Bradley-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 aus der Allen-Bradley-SPS als Tags gelesen und in diese geschrieben werden.
Die Value Type-Eigenschaft muss dabei auf den entsprechenden Typen des Tags festgelegt werden. Aktuell werden folgenden Tag-Typen unterstützt:

Bei String-Datentypen wird ein ASCII/ISO-8859-1-ähnliches Encoding angenommen (das High Byte des 16-Bit-Chars wird abgeschnitten). Dabei werden zwar Surrogate-Pairs (für Characters außerhalb der Unicode-BMP) nicht korrekt behandelt, jedoch ist damit die Anzahl der Bytes gleich der Länge des Strings.

Beachten Sie: Das jeweilige signierte/unsignierte Pendant eines Datentyps kann auch anstelle dessen verwendet werden. Z.B. kann ein SINT auch als Byte statt als SByte verwendet werden; jedoch wird das MSB (most significant bit) dann anders interpretiert, da dieses bei einem signierten Datentypen das Vorzeichenbit ist.

Über die Path-Eigenschaft des Nodes wird der Name des Tags, optional eine Typangabe, sowie (bei Arrays) optional ein Offset und die Länge der Daten definiert:

<TagName>
<TagName>, <Length>
<TagName>, <Type>
<TagName>, <Type>[<Length>]

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

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

Das obige Bild zeigt das Bedienfeld des Allen-Bradley-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 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 von der SPS auszulesen und das Ergebnis in den Variablen zu speichern.

Häufig vorkommende Fehlertexte:

• PLCTAG_ERR_NOT_FOUND: Das Tag wurde in der SPS nicht gefunden. Überprüfen Sie, ob der Name richtig geschrieben wurde.
• PLCTAG_ERR_BAD_PARAM: Der Typ oder die Syntax des Tags sind nicht korrekt. Überprüfen Sie den Tagnamen und ob der richtige Value Type verwendet wird.
• PLCTAG_ERR_TOO_LARGE: Der gelesene Wert kann nicht in eine Variable von diesem Typ geschrieben, da mehr Daten geliefert wurden, als hineinpassen. Wählen Sie einen Value Type, der dem SPS-Typ entspricht. Falls das Tag eine Struktur ist, geben Sie bitte den Namen des Feldes an, auf das Sie zugreifen möchten.
• PLCTAG_ERR_OUT_OF_BOUNDS: Es wurde versucht, auf Arrayindizes zuzugreifen, die außerhalb des Arraybereichs liegen. Überprüfen Sie die angegebene Länge sowie den Offset des Arrays.
• The operation has timed out.: Der Zugriff zur SPS hat ein bestimmtes Zeitlimit überschritten, oder die SPS ist nicht erreichbar.

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

Der Kanal wird von einem Channel Worker behandelt, der eine TCP-Socket-Verbindung zur SPS herstellt.

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 aus der SPS und schreibt diese in die entsprechenden Codabix-Nodes.

Ähnlich schreibt der Channel Worker auch die Werte in die SPS, wenn ein Client oder Plugin Werte in die Channel-Variablen schreibt.

Damit eine Allen-Bradley-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 Server Plugin verbunden ist und damit eine Subscription für die Allen-Bradley Variablennodes erstellen. In diesen Fällen liest der Channel Worker in regelmäßigen Intervallen die Variablen von der SPS und schreibt den neuen Wert nach einer Wertänderung automatisch in dden entsprechenden Codabix-Node.