GetCtrlPerf

Description

This function block returns controller CPU performance statistics.

Figure 7-190: GetCtrlPerf

See also:

• Differences Between Functions and Function Blocks
• Calling a Function BlockCAL, CALC, CALNC, CALCN

Arguments

Input

Execute	Description	On the rising edgeA rising edge is the transition of a digital signal from low to high. It is also called positive edge, request to collect the controller's performance data.
	Data type	BOOL
	Range	0,1
	Unit	n/a
	Default	—
DataPointCount	Description	The number of motion manager cycles over which performance statistics will be gathered.
	Data type	UDINT
	Range	2 - 240,000
	Unit	n/a
	Default	—

Output

Done	Description	If True, then the command completed successfully.
	Data type	BOOL
Error	Description	If True, an error has occurred.
	Data type	BOOL
ErrorID	Description	Indicates the error if Error output is set to TRUE.ErrorID = 0 indicates no error, ErrorID = 1 indicates an error
	Data type	INT
MissedCycles	Description	Indicates the number of missing VM cycles.
	Data type	UDINT
MeanVmTime	Description	The mean VM execution time measured in microseconds.
	Data type	LREAL
StdDevVmTime	Description	The standard deviation of the VM execution time measured in microseconds.
	Data type	LREAL
MinVmTime	Description	The minimum VM execution time measured in microseconds.
	Data type	LREAL
MaxVmTime	Description	The maximum VM execution time measured in microseconds.
	Data type	LREAL
MeanMotMgrTime	Description	The mean motion manager execution time measured in microseconds.
	Data type	LREAL
StdDevMotMgrTime	Description	The standard deviation of the motion manager execution time measured in microseconds.
	Data type	LREAL
MinMotMgrTime	Description	The minimum motion manager execution time measured in microseconds.
	Data type	LREAL
MaxMotMgrTime	Description	The maximum motion manager execution time measured in microseconds.
	Data type	LREAL
MeanCpuIdlePct	Description	The mean percentage of time the controller CPU is idle. CPU idle period is measured across all CPU cores. See Figure 6-29: Motion, PLC and Real Time Margin Time Calculations and Figure 6-30: Multiple Core Controller, PLC and Real Time Margin Time Calculations. to see the idle period in relationship to a PLC application execution cycle.
	Data type	LREAL
StdDevCpuIdlePct	Description	The standard deviation of the measurements of the time that the controller CPU is idle. CPU idle period is measured across all cpu cores. See Figure 6-29: Motion, PLC and Real Time Margin Time Calculations and Figure 6-30: Multiple Core Controller, PLC and Real Time Margin Time Calculations. to see the idle period in relationship to a PLC application execution cycle.
	Data type	LREAL
MinCpuIdlePct	Description	The minimum measurement of the time that the controller CPU is idle. CPU idle period is measured across all cpu cores. See Figure 6-29: Motion, PLC and Real Time Margin Time Calculations and Figure 6-30: Multiple Core Controller, PLC and Real Time Margin Time Calculations. to see the idle period in relationship to a PLC application execution cycle.
	Data type	LREAL
MaxCpuIdlePct	Description	The maximum measurement of the time that the controller CPU is idle. CPU idle period is measured across all cpu cores. See Figure 6-29: Motion, PLC and Real Time Margin Time Calculations and Figure 6-30: Multiple Core Controller, PLC and Real Time Margin Time Calculations. to see the idle period in relationship to a PLC application execution cycle.
	Data type	LREAL

Example

FBD

FFLD

Structured Text

//Read controller performance data from last 1000 cycles (1 second at T#1ms update rate)
Inst_GetCtrlPerf( ReadPerformanceData, 1000 );

IF Inst_GetCtrlInfo.Done THEN
MissedCycles:= Inst_GetCtrlPerf.MissedCycles;
MaxVmTimeMs:= Inst_GetCtrlPerf.MaxVmTime;
MaxMotionManagerTime:= Inst_GetCtrlPerf.MaxMotMgrTime;
MeanCPUIdlePercentage:= Inst_GetCtrlPerf.MeanCpuIdlePct;
MaxCPUIdlePercentage:= Inst_GetCtrlPerf.MaxCpuIdlePct;
END_IF;

 [Top]