TC_SysLatencyEx

Mit dem Funktionsbaustein TC_SysLatencyEx kann die aktuelle und maximale Latenzzeit eines TwinCAT-CPU-Kerns ermittelt werden. Die Funktion entspricht der Anzeige der TwinCAT-Latenzzeit im TwinCAT-Systemmenü unter den Echtzeiteinstellungen für den entsprechenden CPU-Kern.

Eingänge

VAR_INPUT
    bExecute : BOOL;
    tTimeout : TIME;
    sNetId   : T_AmsNetId;
    nCpuId   : USINT;
END_VAR

Name	Typ	Beschreibung
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout	TIME	Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.
sNetId	T_AmsNetId	AmsNetId (AMS-Netzwerkkennung) des TwinCAT-Rechners, dessen CPU-Auslastung ausgelesen werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
nCpuId	USINT	CPU-ID des zu verwendenden TwinCAT CPU-Kerns, siehe Real-Time \| Settings-Tab

Ausgänge

VAR_INPUT
    bBusy    : BOOL;
    bError   : BOOL;
    nErrorId : UDINT;
    nActual  : UDINT;
    nMaximum : UDINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrorId	UDINT	Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.
nActual	UDINT	Die aktuelle Latenzzeit eines TwinCAT-CPU-Kerns in µs
nMaximum	UDINT	Die maximale Latenzzeit eines TwinCAT CPU-Kerns in µs (Maximale Latenzzeit, die seit dem letzten TwinCAT-Systemstart aufgetreten ist.)

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.4022.14	PC oder CX (x86, x64, Arm^®)	Tc2_Utilities (System) >= 3.3.25.0