Funktion _Getmaximaltaskidruntime - Siemens SIMOTION SCOUT Funktionshandbuch

Programmieren Ablaufsystem/Tasks/Systemtakte
6.3 Funktionen zur Laufzeitmessung von Tasks
6.3.2

Funktion _getMaximalTaskIdRunTime

Die Funktion ist ab Version V3.1 des SIMOTION Kernels verfügbar.
Sie liefert die maximale Laufzeit der Task seit dem letzten STOP-RUN-Übergang,
einschließlich aller Unterbrechungen von höherpriorigen Tasks. Die Task wird über eine
projektweit eindeutige TaskId vorgegeben (siehe Funktion _startTaskId).
Folgende Funktionen unterbrechen die Messung nicht:
● _suspendTaskId
● _disableScheduler (siehe Listenhandbücher der SIMOTION Geräte)
Die ermittelte Laufzeit ist ein Vielfaches des Servo-Takts; bei Laufzeiten kleiner als der
Lagereglertakt wird als Messwert T#MIN (= T#0ms) zurückgegeben.
Die Funktion ist für alle Tasks zulässig. Die Messung wird jedoch nicht unterstützt von der
IPOsynchronousTask und der ShutDownTask. Bei Aufrufen mit diesen Tasks wird als
Messwert T#MIN (= T#0ms) zurückgegeben.
Eine ähnliche Funktion für Versionen des SIMOTION Kernels bis V3.0 ist am Ende des
Abschnitts beschrieben.
Deklaration
_getMaximalTaskIdRunTime (
Eingangsparameter
id
Rückgabewert
Datentyp:
T#MIN (= T#0ms = T#1ms * UDINT#0)
größer T#MIN und kleiner T#MAX
T#MAX (= T#49d_17h_2m_47s_295ms = T#1ms *
UDINT#16#FFFF_FFFF)
280
{ id
}
) : TIME
Datentyp:
Voreinstellung:
TaskId der Task, deren Laufzeit gemessen werden soll (siehe Seite 6-330).
: StructTaskId
(optional)
StructTaskId
TaskId der aktuellen Task, in welcher die Funktion aufgerufen
wird.
TIME
Messung wird nicht unterstützt oder
ist noch nicht beendet.
Größte aufgetretene Laufzeit.
TaskId ist ungültig
Funktionshandbuch, 05/2009
Basisfunktionen