TC_CoreBoostMonitor

The TwinCAT Core Boost function offers the option of increasing the clock frequency for individual real-time cores (see Settings tab of the real-time settings). This leads to higher power consumption of the real-time cores, which can also lead to an increase in temperature. To ensure that the defined limits of the system are not permanently exceeded, it is advisable to monitor the system.

If TwinCAT Core Boost is used and active, the TC_CoreBoostMonitor function block can be used to query information about individual CPU cores. Frequency throttling of individual CPU cores can also be monitored using the function block.

	Hardware This functionality is currently supported only for Intel® Core™ i CPUs >= 11th generation.

Inputs

Name	Type	Description
nCoreId	DINT	This input is used to set the CPU core to be monitored. The ID is zero-based (0..n). If -1 is specified, the core from which the function block call or its methods are processed is automatically set.

Outputs

Name	Type	Description
bError	BOOL	Becomes TRUE if an error occurs.
hrErrorCode	HRESULT	Returns the error code for the error that has occurred.

Methods

Name	Description
GetAllRtCoreThrottling	Returns via references whether frequency throttling is occurring on any of the real-time cores due to the thermal or power limits being exceeded.
GetCoreFrequency	Returns the configured and current clock frequency of a defined real-time core via references.
GetCoreTemperature	Returns the current temperature, the maximum temperature that has occurred since the start of real-time and the temperature limit of a defined real-time core via references.
GetCoreThrottling	Returns via references whether a defined real-time kernel is currently being throttled due to the thermal or power limits being exceeded.
GetPowerConsumption	Returns the current power consumption or the power consumption limit of the package of a defined real-time core via references. The value is the same for all real-time cores of the same package.

Requirements

Development environment	Target platform	PLC libraries to be integrated (category group)
TwinCAT v3.1.4026.6	PC or CX (x64)	Tc2_Utilities (System) >= 3.7.4.0

Further Information