TwinCAT 3 Eventlogger Interface
Der TwinCAT 3 Eventlogger ist eine Technologie zum Austausch von Ereignissen zwischen verschiedenen TwinCAT-Komponenten und weiteren Systemen. Die Ereignisse werden im TwinCAT-System angelegt und ausgelöst. Die LabVIEW™ Blöcke ermöglichen es, aktuelle TwinCAT-Ereignisse zu empfangen oder aufgezeichnete TwinCAT-Ereignsse aus dem Cache des TwinCAT-Zielsystems auszulesen. Das Zielsystem wird über die AMS-NetId identifiziert. Die ausgelesenen Ereignisse können vom Typ Nachricht oder Alarm sein. Der wesentliche Unterschied zwischen den Ereignistypen besteht darin, dass Nachrichten zustandslos sind, wohingegen Alarme über folgende Zustände verfügen: Not-Raised, Raised, (optional) WaitForConfirmation und (optional) Confirmed oder Reset. Für detailliertere Informationen des TwinCAT 3 Eventloggers sowie für die TwinCAT-seitige Umsetzung, siehe „Technische Einführung“ in TE1000 | TwinCAT 3 Eventlogger.
Das Beispiel TwinCAT 3 Eventlogger Interface.vi beschreibt die Nutzung der TwinCAT-Eventlogger-Blöcke.
Init TwinCAT Eventlogger
Das VI Init TwinCAT Eventlogger initialisiert die TwinCAT-3-Eventlogger-Schnittstelle in LabVIEW™ für ein Zielsystem. Außerdem wird ein Event-Logger-User-Event bereitgestellt, welches den Erhalt von neu erzeugten Ereignissen dynamisch ermöglicht. Das erhaltene User Event muss vom Nutzer nach dem Release des TwinCAT 3 Eventlogger Handle (siehe unten „Release TwinCAT Eventlogger“) freigegeben werden.
Eingang/Ausgang | Bedeutung |
|---|---|
[4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[5] TargetAddr | AMS NetID des TwinCAT Zielsystems |
[6] Eventlogger User Event | User Event Referenznummer auf das vom Init erzeuge Eventlogger Ereignis |
Run TwinCAT Eventlogger
Das VI Run TwinCAT Eventlogger startet die TwinCAT-3-Eventlogger-Schnittstelle. Dieser Block wird so lange ausgeführt, bis die TwinCAT-3-Eventlogger-Schnittstelle gestoppt wird (siehe folgend „Stop TwinCAT Eventlogger“).
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
Stop TwinCAT Eventlogger
Das VI Stop TwinCAT Eventlogger stoppt den Abruf der TwinCAT 3 Eventlogs.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
Release TwinCAT Eventlogger
Das VI Release TwinCAT Eventlogger gibt das Handle auf den TwinCAT 3 Eventlogger aus dem Speicher frei.
Eingang/Ausgang | Bedeutung |
|---|---|
[0] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
TwinCAT Eventlogger Add Filter
Das VI TwinCAT Eventlogger Add Filter fügt einen Filter zu der TwinCAT 3 Eventlogger Schnittstelle hinzu. Bei dem VI handelt es sich um ein polymorphes VI. Dies ermöglicht einen flexiblen Einsatz des VIs abhängig von dem hinzuzufügenden Filter. Sollen mehrere Filter hinzugefügt werden bietet sich die „FilterSettings“ Version des VIs an (alternativ kann das VI auch mehrmals sequentiell aufgerufen werden). Eine Beschreibung der entsprechenden Versionen des VIs können dem LabVIEW Hilfe Fenster für die entsprechenden VIs entnommen werden.
 | Verfügbarkeit (ab TwinCAT 3.1 Build 4026) Die Eventlogger Filter sind für Zielsysteme ab TwinCAT 3.1 Build 4026 verfügbar. |
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[5] EventFilterSettings | Dieser Eingang hängt von der gewählten Option des polymorphen VIs ab. |
[6] Filter Settings | String, der die angewendeten Filter Settings beschreibt (in der Form (COND1 AND COND2 AND …). Kann genutzt werden, um zu prüfen, ob die gewünschten Filter angewendet werden. |
TwinCAT Eventlogger Clear Filter
Das VI TwinCAT Eventlogger Clear Filter entfernt einen Filter von der TwinCAT-3-Eventlogger-Schnittstelle. Bei dem VI handelt es sich um ein polymorphes VI. Dies ermöglicht einen flexiblen Einsatz des VIs abhängig von dem zu entfernenden Filter. Sollen alle Filter entfernt werden, bietet sich die Option „All“ des VIs an. Eine Beschreibung der entsprechenden Optionen können dem LabVIEW Hilfe Fenster entnommen werden.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[5] EventFilterSettings | Dieser Eingang hängt von der gewählten Option des polymorphen VIs ab. |
[6] Filter Settings | String, der die angewendeten Filter Settings beschreibt (in der Form (COND1 AND COND2 AND …). Kann genutzt werden, um zu prüfen, ob die gewünschten Filter angewendet werden. |
TwinCAT Eventlogger Get Filter Settings
Das VI TwinCAT Eventlogger Get Filter Settings liest die aktuell angewendeten Filtereinstellungen von der TwinCAT-3-Eventlogger-Schnittstelle aus.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[6] Filter Settings | String, der die angewendeten Filter Settings beschreibt (in der Form (COND1 AND COND2 AND …). Kann genutzt werden, um zu prüfen, ob die gewünschten Filter angewendet werden. |
TwinCAT Eventlogger Get Logged Events
Das VI TwinCAT Eventlogger Get Logged Events liest die vergangenen aufgezeichneten Events vom konfigurierten TwinCAT-Zielsystem aus. Hierbei werden die konfigurierten Filtereinstellungen berücksichtigt.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[5] Max entries | Anzahl der maximal zu lesenden Events |
[6] Logged Events | Array, das die aufgezeichneten Events enthält |
TwinCAT Eventlogger Get Active Alarms
Das VI TwinCAT Eventlogger Get Active Alarms liest die aktiven Alarme vom konfigurierten TwinCAT-Zielsystem aus. Hierbei werden die nicht angewendeten Filtereinstellungen berücksichtigt.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
[6] Active Alarms | Array, das die aktiven Alarme beinhaltet |
TwinCAT Eventlogger Clear Logged Events Cache
Das VI Clear Logged Events Cache leert den Event Cache auf dem konfigurierten TwinCAT Zielsystem. Diese Operation kann nicht rückgängig gemacht werden und alle im Cache befindlichen Events werden gelöscht.
Eingang/Ausgang | Bedeutung |
|---|---|
[0][4] TwinCAT Eventlogger Handle | Handle auf den TwinCAT Eventlogger |
TwinCAT Eventlogger Event to Table Entry
Das VI TwinCAT Eventlogger Event to Table Entry konvertiert eine Struktur vom Typ “TwinCAT Eventlogger Event” in einen Tabelleneintrag. Alle Elemente der Struktur werden in Strings umgewandelt und in einem String Array zusammengeführt.
Eingang/Ausgang | Bedeutung |
|---|---|
[1] TwinCAT Eventlogger Event | Event-Daten vom Typ „TwinCAT Eventlogger Event” |
[0] Table Entry | String Array, das die jeweiligen Elemente vom TwinCAT Eventlogger Event als String enthält. |