FB_RTMon_LogMark
Der FB_RTMon_LogMark ist ein erweiterter Funktionsbaustein, der das Setzen von „einfachen“ (Zeit-) Marken ermöglicht.
Der FB_RTMon_LogMark erweitert den generischen Funktionsbaustein FB_RTMon_LogMarkBase. Die Information der Kontext-ID wird dabei automatisch durch den ADS-Port des aufrufenden Tasks initialisiert und muss dadurch beim Aufruf nicht mehr berücksichtigt werden. Die verschiedenen Markenoptionen (siehe TcMarkOption) wurden zudem in Methodenaufrufe verpackt, so dass der Baustein ohne das vorherige Anlegen einer Marke auskommt. Lediglich die Marken-ID (Markengruppe) muss vom Anwender mit übergeben werden. Diese wird verwendet, um den Prozess, der dargestellt werden soll, zu identifizieren.
Optional steht noch eine Event-ID zur Verfügung, in welcher der Anwender noch ein Anwender-Datum übergeben kann (z. B. Zustand einer Statemachine, Fehlermeldung, etc.).
Eingänge
VAR_INPUT
nContextId : UINT := TwinCAT_SystemInfoVarList._AppInfo.AdsPort;
bLogCallingTask : BOOL := TRUE; // specifies whether a reference to the calling task should be set with each mark
END_VAR
Name | Typ | Beschreibung |
---|---|---|
nContextId | UINT | Kontext-ID, für welche diese Marke gesetzt werden soll. Der Initialwert ist TwinCAT_SystemInfoVarList._AppInfo.AdsPort. Wird dieser nicht geändert, wird automatisch die ADS-Port-Nummer als Kontext-ID verwendet. |
bLogCallingTask | BOOL | Boolscher Parameter, der definiert, ob für die Marke der ausführende Task mit abgespeichert wird. Der Initialwert ist TRUE. |
Ausgänge
VAR_OUTPUT
bError : BOOL; // TRUE if an error occurred
hrErrorCode : HRESULT; // outputs the error code which occurred
END_VAR
Name | Typ | Beschreibung |
---|---|---|
bError | BOOL | Boolscher Wert, der anzeigt, ob der Baustein im Fehlerzustand ist. |
hrErrorCode | HRESULT | HResult-Error Code. Ist der Ausgang bError true, kann an diesem Ausgang der Fehlercode ausgelesen werden. |