CPU frequency scaling
zh-CN:CPU Frequency Scaling Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary end
cpufreq refers to the kernel infrastructure that implements CPU frequency scaling. This technology enables the operating system to scale the CPU speed up or down in order to save power. CPU frequencies can be scaled automatically depending on the system load, in response to ACPI events, or manually by userspace programs.
Since kernel 3.4 the necessary modules are loaded automatically and the recommended ondemand governor is enabled by default. However, userspace applications like cpupower, acpid, laptop-mode-tools, or GUI tools provided for your desktop environment, may still be used for advanced configuration.
- 1 Cpupower
- 1.1 Configuring Cpu Power Service/Daemon
- 1.2 Interaction with ACPI events
- 1.3 Privilege Granting Under GNOME
- 1.4 Laptop Mode Tools
- 1.5 Troubleshooting
is a set of userspace utilities designed to assist with CPU frequency scaling. The package is not required to use scaling, but is highly recommended because it provides useful command-line utilities and a service to change the governor at boot.
Configuring Cpu Power Service/Daemon
The configuration file for
/etc/conf.d/cpupower. This configuration file is read by a bash script in
/usr/lib/systemd/scripts/cpupower which is activated by
Remember to enable theservice to ensure your saved settings work on bootup :
# systemctl enable cpupower.service
CPU frequency driver
requires modules to know the limits of the native cpu. To see a full list of available modules, run the following:
$ ls /lib/modules/$(uname -r)/kernel/drivers/cpufreq/
The following table is the output of the above command :
# modprobe <module>. To load the module at boot, run
# echo <module> > /etc/modules-load.d/<module>. The following error message is displayed if it is the wrong module :
FATAL: Error inserting <module> ([...]/<module>.ko): No such device
|acpi_cpufreq||CPUFreq driver which utilizes the ACPI Processor Performance States. This driver also supports Intel Enhanced SpeedStep (previously supported by the deprecated speedstep-centrino module).|
|speedstep-lib||CPUFreq drive for Intel speedstep enabled processors (mostly atoms and older pentiums (< 3))|
|powernow-k8||CPUFreq driver for K8/K10 Athlon64/Opteron/Phenom processors.|
|cpufreq-nforce2||CPUFreq driver for FSB changing on nVidia nForce2 platforms. (AMD K7, Socket A)|
|pcc-cpufreq||This driver supports Processor Clocking Control interface by Hewlett-Packard and Microsoft Corporation which is useful on some Proliant servers.|
|p4_clockmod||CPUFreq driver for Intel Pentium 4 / Xeon / Celeron processors. When enabled it will lower CPU temperature by skipping clocks.|
You probably want to use a Speedstep driver instead.
Once the appropriate cpufreq driver is loaded, detailed information about the CPU(s) can be displayed by running
$ cpupower frequency-info
Governors can be thought of as pre-configured power schemes for the CPU. One may load as many governors as desired (only one will be active on a CPU at any given time). All governors must be loaded and only one may be active on a cpu at any given time.
cpufreq_ondemand(default and recommended)
- Dynamically switches between the CPU(s) available clock speeds based on system load
- The performance governor runs the CPU(s) at maximum clock speed
- Similar to
ondemand, but the CPU(s) clock speed switches gradually through all its available frequencies based on system load
- Runs the CPU(s) at minimum speed
- Manually configured clock speeds by user
$ watch grep \"cpu MHz\" /proc/cpuinfoto monitor cpu speed in real time
To load and activate a particular governor, one should run
# cpupower frequency-set -g <governor
cpupower --help or
man cpupower for more information.
# echo <module> > /etc/modules-load.d/<module>
To load a particular governor, one should run
# modprobe <governor>
Or, add a file specifying the desired governor(s) to
/etc/modules-load.d/ and reboot.
/etc/conf.d/cpupower. <percent> is the percentage of cpu load; <governor> is the cpupower governor
To set the threshold for stepping up to another frequency
echo -n <percent> > /sys/devices/system/cpu/cpufreq/<governor>/up_threshold
To set the threshold for stepping down to another frequency
echo -n <percent> > /sys/devices/system/cpu/cpufreq/<governor>/down_threshold
The sampling rate determines how frequently the governor checks to tune the cpu
sampling_down_factor greater than 1 improves performance by reducing the overhead of load evaluation and keeping the CPU at its highest clock frequency due to high load. This tunable has no effect on behavior at lower CPU frequencies/loads.
To read the value (default = 1), run
$ cat /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor.
To set the value, run
echo -n <value> > /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor
Setting Maximum and Minimum Frequencies
/etc/conf.d/cpupower. To adjust for only a single cpu core:
-c <core #>. <clock_freq> is a clock frequency with units : GHz,MHz
To set the maximum clock frequency
cpupower frequency-set -u <clock_freq>
To set the minimum clock frequency
cpupower frequency-set -d <clock_freq>
To set the cpu to run at a specified frequency
cpupower frequency-set -f <clock_freq>
Interaction with ACPI events
Users may configure scaling governors to switch automatically based on different ACPI events such as connecting the AC adapter or closing a laptop lid. A quick example is given below, however it may be worth reading full article on acpid.
Events are defined in
/etc/acpi/handler.sh. If the package is installed, the file should already exist and be executable. For example, to change the scaling governor from
conservative when the AC adapter is disconnected and change it back if reconnected:
[...] ac_adapter) case "$2" in AC*) case "$4" in 00000000) echo "conservative" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor echo -n $minspeed >$setspeed #/etc/laptop-mode/laptop-mode start ;; 00000001) echo "performance" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor echo -n $maxspeed >$setspeed #/etc/laptop-mode/laptop-mode stop ;; esac ;; *) logger "ACPI action undefined: $2" ;; esac ;; [...]
Privilege Granting Under GNOME
GNOME has a nice applet to change the governor on the fly. To use it without the need to enter the root password, simply create
/var/lib/polkit-1/localauthority/50-local.d/org.gnome.cpufreqselector.pkla and populate it with the following:
[org.gnome.cpufreqselector] Identity=unix-user:USER Action=org.gnome.cpufreqselector ResultAny=no ResultInactive=no ResultActive=yes
Where the word
USER is replaced with the username of interest.
Laptop Mode Tools
If you are already using or plan to use Laptop Mode Tools for other power saving solutions, then you may want to let it also manage CPU frequency scaling. To do so, you just have to insert the appropriate frequency driver to the
/etc/modules.d/ directory. (see #CPU frequency driver above) and then go through the
/etc/laptop-mode/conf.d/cpufreq.conf file to define governors, frequencies and policies. You will not need to load other modules and daemons or to set up scaling governors and interaction with ACPI events. Please refer to Laptop Mode Tools for more details.
- Some applications, like ntop, do not respond well to automatic frequency scaling. In the case of ntop it can result in segmentation faults and lots of lost information as even the
on-demandgovernor cannot change the frequency quickly enough when a lot of packets suddenly arrive at the monitored network interface that cannot be handled by the current processor speed.
- Some CPU's may suffer from poor performance with the default settings of the
on-demandgovernor (e.g. flash videos not playing smoothly or stuttering window animations). Instead of completely disabling frequency scaling to resolve these issues, the aggressiveness of frequency scaling can be increased by lowering the up_threshold sysctl variable for each CPU. See #Changing the on-demand governor's threshold.
- Sometimes the on-demand governor may not throttle to the maximum frequency but one step below. This can be solved by setting max_freq value slightly higher than the real maximum. For example, if frequency range of the CPU is from 2.00 GHz to 3.00 GHz, setting max_freq to 3.01 GHz can be a good idea.
- Some combinations of ALSA drivers and sound chips may cause audio skipping as the governor changes between frequencies, switching back to a non-changing governor seems to stop the audio skipping.
BIOS frequency limitation
Some CPU/BIOS configurations may have difficulties to scale to the maximum frequency or scale to higher frequencies at all. This is most likely caused by BIOS events telling the OS to limit the frequency resulting in
/sys/devices/system/cpu/cpu0/cpufreq/bios_limit set to a lower value.
Either you just made a specific Setting in the BIOS Setup Utility, (Frequency, Thermal Management, etc.) you can blame a buggy/outdated BIOS or the BIOS might have a serious reason for throttling the CPU on it's own.
Reasons like that can be (assuming your machine's a notebook) that the battery is removed (or near death) so you're on AC-power only. In this case a weak AC-source might not supply enough electricity to fulfill extreme peak demands by the overall system and as there is no battery to assist this could lead to data loss, data corruption or in worst case even hardware damage!
Not all BIOS'es limit the CPU-Frequency in this case, but for example most IBM/Lenove Thinkpads do. Refer to thinkwiki for more thinkpad related info on this topic.
If you checked there's not just an odd BIOS setting and you know what you're doing you can make the Kernel ignore these BIOS-limitations.
A special parameter has to be passed to the processor module.
For trying this temporarily change the value in
For setting it permanent refer to Kernel modules or just read on.
processor.ignore_ppc=1 to your kernel boot line or create
# If the frequency of your machine gets wrongly limited by BIOS, this should help options processor ignore_ppc=1