intel_lpmd_config.xml - Man Page

Configuration file for intel_lpmd

Synopsis

$(TDCONFDIR)/etc/intel_lpmd/intel_lpmd_config.xml

Description

intel_lpmd_config.xml is a configuration file for the Intel Low Power Mode Daemon. It is used to describe the lp_mode_cpus to use in Low Power Mode, as well as the way to restrict work to those CPUs. It also describes if and how the HFI monitor and utilization monitor works. The location of this file depends on the configuration option used during build time.

lp_mode_cpus is a set of active CPUs when system is in Low Power Mode. This usually equals a group of most power efficient CPUs on a platform to achieve best power saving. When not specified, intel_lpmd tool can detect this automatically. E.g. it uses an E-core Module on Intel Alderlake platform, and it uses the Low Power E-cores on SoC Die on Intel Meteorlake platform.

Mode specifies the way to migrate the tasks to the lp_mode_cpus.

PerformanceDef specifies the default behavior when power setting is set to Performance.

BalancedDef specifies the default behavior when power setting is set to Balanced.

PowersaverDef specifies the default behavior when power setting is set to Power saver.

HfiLpmEnable specifies if the HFI monitor can capture the HFI hints for Low Power Mode.

HfiSuvEnable specifies if the HFI monitor can capture the HFI hints for survivability mode.

util_entry_threshold specifies the system utilization threshold for entering Low Power Mode. The system workload is considered to fit the lp_mode_cpus capacity when system utilization is under this threshold. Setting to 0 or leaving this empty disables the utilization monitor.

util_exit_threshold specifies the CPU utilization threshold for exiting Low Power Mode. The system workload is considered to not fit the lp_mode_cpus capacity when the utilization of the busiest lp_mode_cpus is above this threshold. Setting to 0 or leaving this empty disables the utilization monitor.

EntryDelayMS specifies the sample interval used by the utilization Monitor when system wants to enter Low Power Mode based on system utilization. Setting to 0 or leaving this empty will cause the utilization Monitor to use the default interval, 1000 milli seconds.

ExitDelayMS specifies the sample interval used by the utilization Monitor when system wants to exit Low Power Mode based on CPU utilization. Setting to 0 or leaving this empty will cause the utilization Monitor to use the adaptive value. The adaptive interval is based on CPU utilization. The busier the CPU is, the shorter interval the utilization monitor uses.

EntryHystMS specifies a hysteresis threshold when system is in Low Power Mode. If set, when the previous average time stayed in Low Power Mode is lower than this value, the current enter Low Power Mode request will be ignored because it is expected that the system will exit Low Power Mode soon. Setting to 0 or leaving this empty disables this hysteresis algorithm.

ExitHystMS specifies a hysteresis threshold when system is not in Low Power Mode. If set, when the previous average time stayed out of Low-Power-Mode is lower than this value, the current exit Low Power Mode request will be ignored because it is expected that the system will enter Low Power Mode soon. Setting to 0 or leaving this empty disables this hysteresis algorithm.

File Format

The configuration file format conforms to XML specifications.

<Configuration>
	<!--
		CPU format example: 1,2,4..6,8-10
	-->
	<lp_mode_cpus>Example CPUs</lp_mode_cpus>

	<!--
		Mode values
		0: Cgroup v2
		1: Cgroup v2 isolate
		2: CPU idle injection
	-->
	<Mode>0|1|2</Mode>

	<!--
		Default behavior when Performance power setting is used
		-1: force off. (Never enter Low Power Mode)
		 1: force on. (Always stay in Low Power Mode)
		 0: auto. (opportunistic Low Power Mode enter/exit)
	-->
	<PerformanceDef>-1|0|1</PerformanceDef>

	<!--
		Default behavior when Balanced power setting is used
		-1: force off. (Never enter Low Power Mode)
		 1: force on. (Always stay in Low Power Mode)
		 0: auto. (opportunistic Low Power Mode enter/exit)
	-->
	<BalancedDef>-1|0|1</BalancedDef>

	<!--
		Default behavior when Power saver setting is used
		-1: force off. (Never enter Low Power Mode)
		 1: force on. (Always stay in Low Power Mode)
		 0: auto. (opportunistic Low Power Mode enter/exit)
	-->
	<PowersaverDef>-1|0|1</PowersaverDef>

	<!--
		Use HFI LPM hints
		0 : No
		1 : Yes
	-->
	<HfiLpmEnable>0|1</HfiLpmEnable>

	<!--
		Use HFI SUV hints
		0 : No
		1 : Yes
	-->
	<HfiSuvEnable>0|1</HfiSuvEnable>

	<!--
		System utilization threshold to enter LP mode
		from 0 - 100
	-->
	<util_entry_threshold>Example threshold</util_entry_threshold>

	<!--
		System utilization threshold to exit LP mode
		from 0 - 100
	-->
	<util_exit_threshold>Example threshold</util_exit_threshold>

	<!--
		Entry delay. Minimum delay in non Low Power mode to
		enter LPM mode.
	-->
	<EntryDelayMS>Example delay</EntryDelayMS>

	<!--
		Exit delay. Minimum delay in Low Power mode to
		exit LPM mode.
	-->
	<ExitDelayMS>Example delay</ExitDelayMS>

	<!--
		Lowest hyst average in-LP-mode time in msec to enter LP mode
		0: to disable hyst support
	-->
	<EntryHystMS>Example hyst</EntryHystMS>

	<!--
		Lowest hyst average out-of-LP-mode time in msec to exit LP mode
		0: to disable hyst support
	-->
	<ExitHystMS>Example hyst</ExitHystMS>

</Configuration>

Example Configurations

Example 1: This is the minimum configuration.

Referenced By

intel_lpmd(8).

1 Jun 2023