FB_AdsReadEvents

FB_AdsReadEvents 1:

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.

VAR_INPUT

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

sNetId: 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: 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: (Sprach-ID) Definiert, welche Übersetzung des Meldungstextes abgefragt werden soll.

eDateAndTimeFormat: Definiert, welches Format die Zeitstempel haben sollen. Zur Auswahl stehen:

tRefreshTime: Definiert die Zeitspanne, nach der die Abfrage der Meldungen wiederholt wird.

tTimeout: Definiert die Zeitspanne, nach der ein Zeitüberschreitungsfehler ausgelöst wird.

VAR_OUTPUT

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

aEvents: Ü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: Gibt an, wie viele Meldungen aktuell im Array aEvents gespeichert sind.

bBusy: Gibt an, ob der Baustein gerade arbeitet.

bDone: TRUE, wenn der Baustein gerade nicht arbeitet, aber mindestens einmal gearbeitet hat.

bError: Gibt an, ob ein Fehler aufgetreten ist.

nErrorId: Gibt die Fehlernummer an.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken (Kategoriegruppe)

TwinCAT v3.1.0

PC oder CX (x86, x64, ARM)

Tc2_Utilities (System)