FB_AdsReadEvents

Der Funktionsbaustein erfragt die aktiven Meldungen des EventLoggers via ADS und stellt sie in Form eines Arrays aEvents zur Verfügung. Wenn die Meldungen im Visualisierungselement Event-Tabelle angezeigt werden sollen, muss das Array aEvents in dessen Eigenschaft Meldungsdatenarray eingetragen werden.

Meldungen mit einer Textlänge kleiner gleich 255 Zeichen können am Ausgang vollständig ausgegeben werden. Meldungen mit einer Textlänge größer 255 Zeichen und kleiner gleich 1023 Zeichen werden mit abgeschnittenem Text ausgegeben. Meldungen mit einer Textlänge größer 1023 Zeichen können nicht ausgegeben werden und der Funktionsbaustein liefert einen Fehler.

Eingänge

VAR_INPUT
    sNetId             : T_AMSNetId;
    bReadEvents        : BOOL;
    nLanguageId        : DWORD;
    eDateAndTimeFormat : E_DateAndTimeFormat;
    tRefreshTime       : TIME
    tTimeout           : TIME
END_VAR

Name	Typ	Beschreibung
sNetId	T_AMSNetId	AmsNetId des Geräts, von dem die Meldungen des EventLoggers abgefragt werden sollen. Falls die Meldungen lokal ausgelesen werden sollen, kann ein Leerstring angegeben werden.
bReadEvents	BOOL	Mit dem Eingang kann die Freigabe zum Auslesen der Meldungen gegeben werden. Mit Rücknahme der Freigabe werden auch die Fehlerausgänge (bError und nErrId) zurückgesetzt.
nLanguageId	DWORD	(Sprach-ID) Definiert, welche Übersetzung des Meldungstextes abgefragt werden soll.
eDateAndTimeFormat	E_DateAndTimeFormat	Definiert, welches Format die Zeitstempel haben sollen. Zur Auswahl stehen: de_De – deutsche Schreibweise: dd.MM.yyyy hh:mm:ss (24 h) en_GB – britische Schreibweise: dd/MM/yyyy hh:mm:ss (12 h) en_US – amerikanische Schreibweise: MM/dd/yyyy hh:mm:ss (12 h)
tRefreshTime	TIME	Definiert die Zeitspanne, nach der die Abfrage der Meldungen wiederholt wird.
tTimeout	TIME	Definiert die Zeitspanne, nach der ein Zeitüberschreitungsfehler ausgelöst wird.

Ausgänge

VAR_OUTPUT
    aEvents         : ARRAY[1..80] OF ST_ReadEvent;
    nNumberOfEvents : UDINT;
    bBusy           : BOOL;
    bDone           : BOOL;
    bError          : BOOL
    nErrorId        : UDINT;
END_VAR

Name	Typ	Beschreibung
aEvents	ARRAY[1..80] OF ST_ReadEvent	Über dieses Array stellt der Funktionsbaustein die ausgelesenen Meldungen zur Verfügung. Maximal können in dem Array 80 Meldungen gespeichert werden. (siehe ST_ReadEvent)
nNumberOfEvents	UDINT	Gibt an, wie viele Meldungen aktuell im Array `aEvents` gespeichert sind.
bBusy	BOOL	Gibt an, ob der Baustein gerade arbeitet.
bDone	BOOL	TRUE, wenn der Baustein gerade nicht arbeitet, aber mindestens einmal gearbeitet hat.
bError	BOOL	Gibt an, ob ein Fehler aufgetreten ist.
nErrorId	UDINT	Gibt die Fehlernummer an.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64, ARM)	Tc2_Utilities (System)