Einfache Companion Specification
Dieser Dokumentationsartikel soll Ihnen einen schnellen Einstieg in die Verwendung dieses Produkts ermöglichen. Führen Sie nach erfolgreicher Installation und Lizenzierung die folgenden Schritte aus, um ein erstes Nodeset auf der Grundlage einer Companion Specification zu erstellen.
![]() | OPC UA Base Nodeset Standardmäßig lädt der TwinCAT OPC UA Nodeset Editor automatisch das OPC UA Base Nodeset, das den Namespace http://opcfoundation.org/UA/ definiert. |
![]() | TF6100 TC3 OPC UA Server Dieses Produkt arbeitet mit dem TwinCAT OPC UA Server zusammen, um ein erstelltes Nodeset auszuführen und es im Adressraum des Servers anzuzeigen. Bitte stellen Sie sicher, dass das Produkt TF6100 TC3 OPC UA Server auf Ihrem System installiert ist. |
![]() | Companion Specification Beispiel-Nodeset Als Beispiel für eine Companion Specification wird ein Nodeset verwendet, das einen ObjectType "MyObjectType" mit einigen Membervariablen definiert. Dieses Nodeset kann von unserem TE6100_Samples Repository auf GitHub heruntergeladen werden. |
Das folgende Quickstart-Tutorial führt Sie durch die folgenden Schritte:
- Vorbereitung eines SPS-Projekts
- Neues Projekt anlegen
- Nodeset der Companion Specification importieren
- Objektinstanzen erstellen
- Erstellte Instanzen mit SPS-Variablen verknüpfen
- Deployment des Projekts auf dem TwinCAT OPC UA Server
Vorbereitung eines SPS-Projekts
Erstellen Sie ein neues TwinCAT-Projekt und fügen Sie ein SPS-Projekt hinzu. Erstellen Sie die folgende Datenstruktur im SPS-Projekt und instanziieren Sie sie dreimal im MAIN-Programm.
TYPE ST_MyStructure :
STRUCT
MyBoolean : BOOL;
MyInt16 : INT;
MyFloat : REAL;
END_STRUCT
END_TYPE
PROGRAM MAIN
VAR
MyStruct1 : ST_MyStructure;
MyStruct2 : ST_MyStructure;
MyStruct3 : ST_MyStructure;
END_VAR
Neues Projekt anlegen
Klicken Sie im Menü auf File > New > Project, um ein neues Nodeset-Projekt zu erstellen.

Im folgenden Auswahldialog können Sie den Namen und ein Zielverzeichnis für das neue Projekt angeben.

Nodeset der Companion Specification importieren
Importieren Sie die Datei "te6100_quickstart_companion_specification.xml" aus dem GitHub-Repository in den TwinCAT OPC UA Nodeset Editor, indem Sie im Type Explorer auf die Schaltfläche LoadNodeset klicken.

Der Import lädt das Typmodell aus dem Nodeset in den Type Explorer und zeigt es dort an. Das Typmodell enthält einen ObjectType "MyObjectType", den wir nun instanziieren wollen. Sie können das Textfeld verwenden, um nach dem Namen des Typs zu suchen, oder zu diesem Typ unter dem Node ObjectTypes \ BaseObjectType scrollen.

Objektinstanzen erstellen
Verwenden Sie das Kontextmenü, um einen neuen Ordner im Instance Explorer zu erstellen. Sie können den Ordner umbenennen, indem Sie auf den Ordner doppelklicken und dann das Attribut "Name" im Attribute Explorer ändern. Speichern Sie diese Änderung dann über die Schaltfläche Save in der Symbolleiste des Attribute Explorers.

Dann den Typ "MyObjectType" aus dem Type Explorer per Drag-and-Drop in den erstellten Ordner im Instance Explorer ziehen.

Dadurch wird eine neue Objektinstanz des Typs "MyObjectType" erstellt und in dem erstellten Ordner abgelegt. Alle obligatorischen Membervariablen des Typs werden entsprechend in den Instance Explorer übertragen und dort als Node unterhalb der Objektinstanz angezeigt. Sie können diese Nodes nun mit SPS-Variablen verknüpfen.

Sie können die Instanz über den Attribute Editor umbenennen.
Erstellte Instanzen mit SPS-Variablen verknüpfen
Wir wollen nun die Membervariablen der erstellten Objektinstanz mit Variablen aus unserem vorbereiteten SPS-Projekt verknüpfen. Dazu kann der TwinCAT Target Browser verwendet werden, den Sie im Menü View öffnen können.
Navigieren Sie im Target Browser zum vorbereiteten SPS-Projekt und verknüpfen Sie die einzelnen Membervariablen der Datenstruktur mit den entsprechenden Membervariablen der Objektinstanz, indem Sie sie per Drag-and-Drop auf den entsprechenden Node im Instance Explorer ziehen. Die Datentypen sind hier wie folgt:
Membervariable |
Datentype |
---|---|
Member1 |
Boolean (BOOL) |
Member2 |
Int16 (INT) |
Member3 |
Float (REAL) |
Durch einen Doppelklick auf die Variable können diese Informationen auch über den Attribute Explorer abgerufen werden. Sobald alle Variablen verknüpft sind, kann im nächsten Schritt das Projekt auf dem TwinCAT OPC UA Server aktiviert werden.

Deployment des Projekts auf dem TwinCAT OPC UA Server
Um das Projekt auf den TwinCAT OPC UA Server bereitzustellen, klicken Sie auf die Schaltfläche Export to TwinCAT OPC UA Server in der Symbolleiste des Instance Explorers. Damit wird das Projekt-Nodeset auf den lokal installierten TwinCAT OPC UA Server exportiert und auch eine entsprechende Konfigurationsdatei für den Server erstellt. Bitte stellen Sie sicher, dass Sie den TwinCAT OPC UA Server nach dem Deployment des Nodesets neu starten, damit die Konfiguration geladen wird. Der Adressraum des Servers enthält dann die angelegten Nodes, die mit den entsprechenden SPS-Variablen verknüpft wurden.
