Difference between revisions of "CPU frequency scaling"

From ArchWiki
Jump to: navigation, search
(Scaling governors: Link to official docs in the kernel source.)
m (CPU frequency driver: Minor typos, cleanup)
 
(87 intermediate revisions by 36 users not shown)
Line 1: Line 1:
 
[[Category:Power management]]
 
[[Category:Power management]]
 
[[Category:CPU]]
 
[[Category:CPU]]
[[cs:CPU Frequency Scaling]]
+
[[ar:CPU frequency scaling]]
 +
[[cs:CPU frequency scaling]]
 
[[de:Cpufrequtils]]
 
[[de:Cpufrequtils]]
[[el:CPU Frequency Scaling]]
+
[[el:CPU frequency scaling]]
[[es:CPU Frequency Scaling]]
+
[[es:CPU frequency scaling]]
 
[[fr:Cpufreq]]
 
[[fr:Cpufreq]]
[[it:CPU Frequency Scaling]]
+
[[it:CPU frequency scaling]]
[[pt:CPU Frequency Scaling]]
+
[[ja:CPU 周波数スケーリング]]
[[ru:CPU Frequency Scaling]]
+
[[pt:CPU frequency scaling]]
[[sk:CPU Frequency Scaling]]
+
[[ru:CPU frequency scaling]]
[[tr:Işlemci_frekansını_ölçekleme]]
+
[[sk:CPU frequency scaling]]
[[zh-CN:CPU Frequency Scaling]]
+
[[tr:Işlemci frekansını ölçekleme]]
{{Article summary start}}
+
[[zh-cn:CPU frequency scaling]]
{{Article summary text|An overview of the popular userspace tools for the kernel [http://www.kernel.org/pub/linux/utils/kernel/cpufreq/cpufreq-info.html CPUfreq] subsystem.}}
+
{{Related articles start}}
{{Article summary heading|Related}}
+
{{Related|Power saving}}
{{Article summary wiki|Laptop Mode Tools|Laptop_Mode_Tools}}
+
{{Related|Laptop Mode Tools}}
{{Article summary wiki|pm-utils}}
+
{{Related|pm-utils}}
{{Article summary wiki|PHC}}
+
{{Related|PHC}}
{{Article summary end}}
+
{{Related articles end}}
  
{{Accuracy|This article needs cleanup in sections: acpid, laptop-mode-tools, and bios limitations.}}
+
CPU frequency scaling enables the operating system to scale the CPU frequency 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.
  
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.
+
CPU frequency scaling is implemented in the Linux kernel, the infrastructure is called ''cpufreq''. Since kernel 3.4 the necessary modules are loaded automatically and the recommended [[#Scaling governors|ondemand governor]] is enabled by default. However, userspace tools like [[#cpupower|cpupower]], [[acpid]], [[Laptop Mode Tools]], or GUI tools provided for your desktop environment, may still be used for advanced configuration.
  
Since kernel 3.4 the necessary modules are loaded automatically and the recommended [[CPU_Frequency_Scaling#Scaling_governors|ondemand governor]] is enabled by default. However, userspace applications like [[#cpupower|cpupower]], [[acpid]], [[laptop-mode-tools]], or GUI tools provided for your desktop environment, may still be used for advanced configuration.
+
== Userspace tools ==
  
== Userspace tools (cpupower) ==
+
=== thermald ===
{{Pkg|cpupower}} 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.
+
The configuration file for {{Pkg|cpupower}} is located in {{ic|/etc/default/cpupower}}. This configuration file is read by a bash script in {{ic|/usr/lib/systemd/scripts/cpupower}} which is activated by {{ic|systemd}} with {{ic|cpupower.service}}. To enable {{Pkg|cpupower}} on boot with {{Pkg|systemd}}, run
+
  
# systemctl enable cpupower.service
+
{{AUR|thermald}} is a Linux daemon used to prevent the overheating of platforms. This daemon monitors temperature and applies compensation using available cooling methods.
  
A frontend for gnome-shell can be found at [https://extensions.gnome.org/extension/444/cpu-freq/ CPU Freq].
+
By default, it monitors CPU temperature using available CPU digital temperature sensors and maintains CPU temperature under control, before HW takes aggressive correction action. If there is a skin temperature sensor in thermal sysfs, then it tries to keep skin temperature under 45C.
  
=== CPU frequency driver ===
+
=== i7z ===
{{Note|As of kernel 3.4; the native cpu module is loaded automatically}}
+
{{Pkg|i7z}} is an i7 (and now i3, i5) (CPU) reporting tool for Linux. It can be launched from a Terminal with the command {{ic|i7z}} or as GUI with {{ic|i7z-gui}}.
  
{{Pkg|cpupower}} requires modules (see table below) to know the limits of the native cpu. To see a full list of available modules, run
+
=== cpupower ===
  
$ ls /lib/modules/$(uname -r)/kernel/drivers/cpufreq/
+
{{Pkg|cpupower}} 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 [[systemd]] service to change the governor at boot.
  
{{Tip|To load the module at boot, run
+
The configuration file for ''cpupower'' is located in {{ic|/etc/default/cpupower}}. This configuration file is read by a bash script in {{ic|/usr/lib/systemd/scripts/cpupower}} which is activated by ''systemd'' with {{ic|cpupower.service}}. You may want to enable {{ic|cpupower.service}} to start at boot.
{{bc|<nowiki>
+
# echo <module> >/etc/modules-load.d/<module>.conf
+
</nowiki>}}}}
+
{{Note|Loading the wrong module will result in an error "No such device"}}
+
Load the appropriate module with
+
  
# modprobe <module>
+
== CPU frequency driver ==
  
{| border="1"
+
{{Note|
 +
* The native CPU module is loaded automatically.
 +
* The {{ic|pstate}} power scaling driver is used automatically for modern Intel CPUs instead of the other drivers below. This driver takes priority over other drivers and is built-in as opposed to being a module. This driver is currently automatically used for Sandy Bridge and newer CPUs. If you encounter a problem while using this driver, add {{ic|intel_pstate&#61;disable}} to your kernel line. You can use the same user space utilities with this driver, '''but cannot control it'''.
 +
* Even P State behavior mentioned above can be influenced with {{ic|/sys/devices/system/cpu/intel_pstate}}, e.g. Intel Turbo Boost can be deactivated with {{ic|# echo 1 > /sys/devices/system/cpu/intel_pstate/no_turbo}} for keeping CPU-Temperatures low.
 +
* Additional control for modern Intel CPUs is available with the [https://01.org/linux-thermal-daemon Linux Thermal Daemon] (available as {{AUR|thermald}}), which proactively controls thermal using P-states, T-states, and the Intel power clamp driver. thermald can also be used for older Intel CPUs. If the latest drivers are not available, then the daemon will revert to x86 model specific registers and the Linux ‘cpufreq subsystem’ to control system cooling.
 +
}}
 +
 
 +
''cpupower'' requires modules to know the limits of the native CPU:
 +
 
 +
{| class="wikitable"
 
!Module!!Description
 
!Module!!Description
 
|-
 
|-
| 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).
+
| intel_pstate || This driver implements a scaling driver with an internal governor for Intel Core (Sandy Bridge and newer) processors.
 
|-
 
|-
| speedstep-lib || CPUFreq drive for Intel speedstep enabled processors (mostly atoms and older pentiums (< 3))  
+
| acpi-cpufreq  || CPUFreq driver which utilizes the ACPI Processor Performance States. This driver also supports the Intel Enhanced SpeedStep (previously supported by the deprecated speedstep-centrino module).
 
|-
 
|-
| powernow-k8  || CPUFreq driver for K8/K10 Athlon64/Opteron/Phenom processors. '''Deprecated since linux 3.7 - Use acpi_cpufreq.'''
+
| speedstep-lib || CPUFreq driver for Intel SpeedStep-enabled processors (mostly Atoms and older Pentiums (< 3))
 
|-
 
|-
| pcc-cpufreq   || This driver supports Processor Clocking Control interface by Hewlett-Packard and Microsoft Corporation which is useful on some Proliant servers.
+
| powernow-k8   || CPUFreq driver for K8/K10 Athlon 64/Opteron/Phenom processors. Since Linux 3.7 'acpi-cpufreq' will automatically be used for more modern CPUs from this family.
 
|-
 
|-
| p4_clockmod   || CPUFreq driver for Intel Pentium 4 / Xeon / Celeron processors.  When enabled it will lower CPU temperature by skipping clocks.<br>You probably want to use a Speedstep driver instead.
+
| 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 which lowers the CPU temperature by skipping clocks. (You probably want to use a SpeedStep driver instead.)
 
|}
 
|}
<br>
 
  
Once the appropriate cpufreq driver is loaded, detailed information about the CPU(s) can be displayed by running
+
To see a full list of available modules, run:
 +
 
 +
$ ls /usr/lib/modules/$(uname -r)/kernel/drivers/cpufreq/
 +
 
 +
Load the appropriate module (see [[Kernel modules]] for details). Once the appropriate cpufreq driver is loaded, detailed information about the CPU(s) can be displayed by running
  
 
  $ cpupower frequency-info
 
  $ cpupower frequency-info
  
=== Scaling governors ===
+
=== Setting maximum and minimum frequencies ===
  
Governors (see table below) are power schemes for the cpu. Only one may be active at a time. For details, see the [https://www.kernel.org/doc/Documentation/cpu-freq/governors.txt official documentation] in the kernel source.
+
In rare cases, it may be necessary to manually set maximum and minimum frequencies.
  
{{Note|The kernel loads {{ic|on_demand}} by default.}}
+
To set the maximum clock frequency (''clock_freq'' is a clock frequency with units: GHz, MHz):
{| border="1"
+
 
!Module!!Description
+
# 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''
 +
 
 +
{{Note|
 +
* To adjust for only a single CPU core, append {{ic|-c ''core_number''}}.
 +
* The governor, maximum and minimum frequencies can be set in {{ic|/etc/default/cpupower}}.
 +
}}
 +
 
 +
== Scaling governors ==
 +
 
 +
{{Note|The modern pstate driver only supports the performance and powersave governors and the performance governor [http://www.phoronix.com/scan.php?page&#61;news_item&px&#61;MTM3NDQ should give better power saving functionality than the old ondemand governor]. }}
 +
 
 +
Governors (see table below) are power schemes for the CPU. Only one may be active at a time. For details, see the [https://www.kernel.org/doc/Documentation/cpu-freq/governors.txt kernel documentation] in the kernel source.
 +
 
 +
{| class="wikitable"
 +
!Governor!!Description
 
|-
 
|-
| cpufreq_ondemand  || Dynamically switch between CPU(s) available if at 95% cpu load
+
| ondemand    || Dynamically switch between CPU(s) available if at 95% cpu load
 
|-
 
|-
| cpufreq_performance || Run the cpu at max frequency
+
| performance  || Run the cpu at max frequency
 
|-
 
|-
| cpufreq_conservative  || Dynamically switch between CPU(s) available if at 75% load
+
| conservative || Dynamically switch between CPU(s) available if at 75% load
 
|-
 
|-
| cpufreq_powersave|| Run the cpu at the minimum frequency
+
| powersave    || Run the cpu at the minimum frequency
 
|-
 
|-
| cpufreq_userspace  || Run the cpu at user specified frequencies
+
| userspace    || Run the cpu at user specified frequencies
 
|}
 
|}
<br>
 
  
{{Tip| To monitor cpu speed in real time, run:
+
Depending on the scaling driver, one of these governors will be loaded by default:
{{bc|<nowiki>
+
* {{ic|ondemand}} for AMD and older Intel CPU.
$ watch grep \"cpu MHz\" /proc/cpuinfo
+
* {{ic|powersave}} for Intel Sandy Bridge and newer CPU.
</nowiki>}}}}
+
  
==== With cpupower ====
+
To activate a particular governor, run:
To load and activate a particular governor, one should run  
+
  
  # cpupower frequency-set -g <governor_without cpufreq_>
+
  # cpupower frequency-set -g ''governor''
  
==== Without cpupower ====
+
{{Note|
{{Tip|To load a governor at boot, run
+
* To adjust for only a single CPU core, append {{ic|-c ''core_number''}} to the command above.
{{bc|<nowiki>
+
* Activating a governor requires that specific [[kernel module]] (named {{ic|cpufreq_''governor''}}) is loaded. As of kernel 3.4, these modules are loaded automatically.
# echo <module> > /etc/modules-load.d/<module>
+
}}
</nowiki>}}}}
+
+
To load a particular governor, one should run
+
  
  # modprobe <governor>
+
Alternatively, you can activate a governor on every available CPU manually:
 +
  # echo ''governor'' | tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor >/dev/null
  
=== Tuning governors (with cpupower) ===
+
{{Tip|To monitor cpu speed in real time, run:
{{Tip|Add the following commands below to {{ic|/etc/default/cpupower}}. <percent> is the percentage of cpu load; <governor> is the cpupower governor}}
+
$ watch grep \"cpu MHz\" /proc/cpuinfo
To set the threshold for stepping up to another frequency
+
}}
  
# echo -n <percent> > /sys/devices/system/cpu/cpufreq/<governor>/up_threshold
+
=== Tuning the ondemand governor ===
  
To set the threshold for stepping down to another frequency
+
See the [https://www.kernel.org/doc/Documentation/cpu-freq/governors.txt kernel documentation] for details.
  
# echo -n <percent> > /sys/devices/system/cpu/cpufreq/<governor>/down_threshold
+
==== Switching threshold ====
  
===== Sampling rate =====
+
To set the threshold for stepping up to another frequency:
The sampling rate determines how frequently the governor checks to tune the cpu
+
Setting {{ic|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
+
# echo -n ''percent'' > /sys/devices/system/cpu/cpufreq/<governor>/up_threshold
  
$ cat /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor
+
To set the threshold for stepping down to another frequency:
  
To set the value, run
+
# echo -n ''percent'' > /sys/devices/system/cpu/cpufreq/<governor>/down_threshold
  
# echo -n <value> > /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor
+
==== Sampling rate ====
  
=== Setting Maximum and Minimum Frequencies ===
+
The sampling rate determines how frequently the governor checks to tune the CPU. {{ic|sampling_down_factor}} is a tunable that multiplies the sampling rate when the CPU is at its highest clock frequency thereby delaying load evaluation and improving performance. Allowed values for {{ic|sampling_down_factor}} are 1 to 100000.  This tunable has no effect on behavior at lower CPU frequencies/loads.
  
{{Note|The governor, maximum, and minimum frequencies can be set in {{ic|/etc/default/cpupower}}. To adjust for only a single cpu core: {{ic| -c <core #>}}. <clock_freq> is a clock frequency with units : GHz,MHz}}
+
To read the value (default = 1), run:
To set the maximum clock frequency
+
  
  # cpupower frequency-set -u <clock_freq>
+
  $ cat /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor
  
To set the minimum clock frequency
+
To set the value, run:
  
  # cpupower frequency-set -d <clock_freq>
+
  # echo -n ''value'' > /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor
  
To set the cpu to run at a specified frequency
+
==== Make changes permanent ====
  
# cpupower frequency-set -f <clock_freq>
+
To have changes persist on system reboot probably the easiest is to use systemd-tmpfiles. For example to set the sampling_down_factor on boot you could create or edit a {{ic|/etc/tmpfiles.d/10-cpu-sampling-down.conf}} file as follow
 +
 
 +
{{hc|/etc/tmpfiles.d/10-cpu-sampling-down.conf|<nowiki>
 +
w /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor - - - - 40
 +
</nowiki>}}
  
 
== Interaction with ACPI events ==
 
== 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]].
+
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 {{ic|/etc/acpi/handler.sh}}. If the {{Pkg|acpid}} package is installed, the file should already exist and be executable. For example, to change the scaling governor from {{ic|performance}} to {{ic|conservative}} when the AC adapter is disconnected and change it back if reconnected:
 
Events are defined in {{ic|/etc/acpi/handler.sh}}. If the {{Pkg|acpid}} package is installed, the file should already exist and be executable. For example, to change the scaling governor from {{ic|performance}} to {{ic|conservative}} when the AC adapter is disconnected and change it back if reconnected:
  
{{hc
+
{{hc|/etc/acpi/handler.sh|<nowiki>
|/etc/acpi/handler.sh
+
|<nowiki>
+
 
[...]
 
[...]
  
ac_adapter)
+
ac_adapter)
    case "$2" in
+
    case "$2" in
        AC*)
+
        AC*)
            case "$4" in
+
            case "$4" in
                00000000)
+
                00000000)
                    echo "conservative" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor     
+
                    echo "conservative" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor     
                    echo -n $minspeed >$setspeed
+
                    echo -n $minspeed >$setspeed
                    #/etc/laptop-mode/laptop-mode start
+
                    #/etc/laptop-mode/laptop-mode start
                ;;
+
                ;;
                00000001)
+
                00000001)
                    echo "performance" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
+
                    echo "performance" >/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
                    echo -n $maxspeed >$setspeed
+
                    echo -n $maxspeed >$setspeed
                    #/etc/laptop-mode/laptop-mode stop
+
                    #/etc/laptop-mode/laptop-mode stop
                ;;
+
                ;;
            esac
+
            esac
        ;;
+
        ;;
        *) logger "ACPI action undefined: $2" ;;
+
        *) logger "ACPI action undefined: $2" ;;
    esac
+
    esac
;;
+
;;
  
 
[...]
 
[...]
 
</nowiki>}}
 
</nowiki>}}
  
 +
== Privilege granting under GNOME ==
  
== Privilege Granting Under GNOME ==
+
{{Out of date|See the note below.}}
{{Note|Systemd introduced logind which handles consolekit and policykit actions. The following code below does not work}}
+
  
[[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 {{ic|/var/lib/polkit-1/localauthority/50-local.d/org.gnome.cpufreqselector.pkla}} and populate it with the following:
+
{{Note|systemd introduced logind which handles consolekit and policykit actions. The following code below does not work. With logind, simply edit in the file {{ic|/usr/share/polkit-1/actions/org.gnome.cpufreqselector.policy}} the <defaults> elements according to your needs and the polkit manual [http://www.freedesktop.org/software/polkit/docs/latest/polkit.8.html].}}
  
{{bc|<nowiki>[org.gnome.cpufreqselector]
+
[[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 following file:
Identity=unix-user:USER
+
 
 +
{{hc|/var/lib/polkit-1/localauthority/50-local.d/org.gnome.cpufreqselector.pkla|2=
 +
[org.gnome.cpufreqselector]
 +
Identity=unix-user:''user''
 
Action=org.gnome.cpufreqselector
 
Action=org.gnome.cpufreqselector
 
ResultAny=no
 
ResultAny=no
 
ResultInactive=no
 
ResultInactive=no
ResultActive=yes</nowiki>}}0
+
ResultActive=yes
 +
}}
  
Where the word {{ic|USER}} is replaced with the username of interest.
+
Where the word ''user'' is replaced with the username of interest.
  
The {{AUR|desktop-privileges}} package in the [[Arch User Repository|AUR]] contains a similar {{ic|.pkla}} file for authorizing all users of the {{ic|power}} [[Users and Groups|group]] to change the governor.
+
The {{AUR|desktop-privileges}} package in the [[AUR]] contains a similar {{ic|.pkla}} file for authorizing all users of the {{ic|power}} [[group]] to change the governor.
 
+
== 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 {{ic|/etc/modules.d/}} directory. (see [[#CPU frequency driver]] above) and then go through the {{ic|/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.
+
  
 
== Troubleshooting ==
 
== Troubleshooting ==
{{accuracy}}
+
 
 +
{{Accuracy}}
 +
 
 
* 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 {{ic|on-demand}} governor 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 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 {{ic|on-demand}} governor 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 {{ic|on-demand}} governor (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]].
+
* Some CPU's may suffer from poor performance with the default settings of the {{ic|on-demand}} governor (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 [[#Switching_threshold|how to change 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.
 
* 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.
Line 211: Line 238:
  
 
=== BIOS frequency limitation ===
 
=== 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 {{ic|/sys/devices/system/cpu/cpu0/cpufreq/bios_limit}} set to a lower value.
 
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 {{ic|/sys/devices/system/cpu/cpu0/cpufreq/bios_limit}} set to a lower value.
  
Line 217: Line 245:
 
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!
 
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 [http://www.thinkwiki.org/wiki/Problem_with_CPU_frequency_scaling thinkpad related info on this topic].
+
Not all BIOS'es limit the CPU-Frequency in this case, but for example most IBM/Lenovo Thinkpads do. Refer to thinkwiki for more [http://www.thinkwiki.org/wiki/Problem_with_CPU_frequency_scaling 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.
 
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.
Line 231: Line 259:
 
{{hc|/etc/modprobe.d/ignore_ppc.conf|2=# If the frequency of your machine gets wrongly limited by BIOS, this should help
 
{{hc|/etc/modprobe.d/ignore_ppc.conf|2=# If the frequency of your machine gets wrongly limited by BIOS, this should help
 
options processor ignore_ppc=1}}
 
options processor ignore_ppc=1}}
 +
 +
== Common issues ==
 +
 +
=== High load ===
 +
 +
{{Expansion|What kernel version? Needs a link to an open bug report, all that I've been able to find with a quick search is [https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1413149].}}
 +
 +
There is a bug in the kernel module {{ic|rtsx_usb_ms}} which causes a constant load over 1.0. Test whether it makes a difference by temporarily removing it {{ic|rmmod rtsx_usb_ms}}
 +
 +
== See also ==
 +
 +
* [https://www.kernel.org/doc/Documentation/cpu-freq/index.txt Linux CPUFreq - kernel documentation]
 +
* [http://www.reddit.com/r/linux/comments/1hdogn/acpi_cpufreq_or_intel_pstates/ Comprehensive explanation of pstate]

Latest revision as of 14:13, 26 May 2016

CPU frequency scaling enables the operating system to scale the CPU frequency 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.

CPU frequency scaling is implemented in the Linux kernel, the infrastructure is called cpufreq. Since kernel 3.4 the necessary modules are loaded automatically and the recommended ondemand governor is enabled by default. However, userspace tools like cpupower, acpid, Laptop Mode Tools, or GUI tools provided for your desktop environment, may still be used for advanced configuration.

Userspace tools

thermald

thermaldAUR is a Linux daemon used to prevent the overheating of platforms. This daemon monitors temperature and applies compensation using available cooling methods.

By default, it monitors CPU temperature using available CPU digital temperature sensors and maintains CPU temperature under control, before HW takes aggressive correction action. If there is a skin temperature sensor in thermal sysfs, then it tries to keep skin temperature under 45C.

i7z

i7z is an i7 (and now i3, i5) (CPU) reporting tool for Linux. It can be launched from a Terminal with the command i7z or as GUI with i7z-gui.

cpupower

cpupower 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 systemd service to change the governor at boot.

The configuration file for cpupower is located in /etc/default/cpupower. This configuration file is read by a bash script in /usr/lib/systemd/scripts/cpupower which is activated by systemd with cpupower.service. You may want to enable cpupower.service to start at boot.

CPU frequency driver

Note:
  • The native CPU module is loaded automatically.
  • The pstate power scaling driver is used automatically for modern Intel CPUs instead of the other drivers below. This driver takes priority over other drivers and is built-in as opposed to being a module. This driver is currently automatically used for Sandy Bridge and newer CPUs. If you encounter a problem while using this driver, add intel_pstate=disable to your kernel line. You can use the same user space utilities with this driver, but cannot control it.
  • Even P State behavior mentioned above can be influenced with /sys/devices/system/cpu/intel_pstate, e.g. Intel Turbo Boost can be deactivated with # echo 1 > /sys/devices/system/cpu/intel_pstate/no_turbo for keeping CPU-Temperatures low.
  • Additional control for modern Intel CPUs is available with the Linux Thermal Daemon (available as thermaldAUR), which proactively controls thermal using P-states, T-states, and the Intel power clamp driver. thermald can also be used for older Intel CPUs. If the latest drivers are not available, then the daemon will revert to x86 model specific registers and the Linux ‘cpufreq subsystem’ to control system cooling.

cpupower requires modules to know the limits of the native CPU:

Module Description
intel_pstate This driver implements a scaling driver with an internal governor for Intel Core (Sandy Bridge and newer) processors.
acpi-cpufreq CPUFreq driver which utilizes the ACPI Processor Performance States. This driver also supports the Intel Enhanced SpeedStep (previously supported by the deprecated speedstep-centrino module).
speedstep-lib CPUFreq driver for Intel SpeedStep-enabled processors (mostly Atoms and older Pentiums (< 3))
powernow-k8 CPUFreq driver for K8/K10 Athlon 64/Opteron/Phenom processors. Since Linux 3.7 'acpi-cpufreq' will automatically be used for more modern CPUs from this family.
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 which lowers the CPU temperature by skipping clocks. (You probably want to use a SpeedStep driver instead.)

To see a full list of available modules, run:

$ ls /usr/lib/modules/$(uname -r)/kernel/drivers/cpufreq/

Load the appropriate module (see Kernel modules for details). Once the appropriate cpufreq driver is loaded, detailed information about the CPU(s) can be displayed by running

$ cpupower frequency-info

Setting maximum and minimum frequencies

In rare cases, it may be necessary to manually set maximum and minimum frequencies.

To set the maximum clock frequency (clock_freq is a clock frequency with units: GHz, MHz):

# 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
Note:
  • To adjust for only a single CPU core, append -c core_number.
  • The governor, maximum and minimum frequencies can be set in /etc/default/cpupower.

Scaling governors

Note: The modern pstate driver only supports the performance and powersave governors and the performance governor should give better power saving functionality than the old ondemand governor.

Governors (see table below) are power schemes for the CPU. Only one may be active at a time. For details, see the kernel documentation in the kernel source.

Governor Description
ondemand Dynamically switch between CPU(s) available if at 95% cpu load
performance Run the cpu at max frequency
conservative Dynamically switch between CPU(s) available if at 75% load
powersave Run the cpu at the minimum frequency
userspace Run the cpu at user specified frequencies

Depending on the scaling driver, one of these governors will be loaded by default:

  • ondemand for AMD and older Intel CPU.
  • powersave for Intel Sandy Bridge and newer CPU.

To activate a particular governor, run:

# cpupower frequency-set -g governor
Note:
  • To adjust for only a single CPU core, append -c core_number to the command above.
  • Activating a governor requires that specific kernel module (named cpufreq_governor) is loaded. As of kernel 3.4, these modules are loaded automatically.

Alternatively, you can activate a governor on every available CPU manually:

# echo governor | tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor >/dev/null
Tip: To monitor cpu speed in real time, run:
$ watch grep \"cpu MHz\" /proc/cpuinfo

Tuning the ondemand governor

See the kernel documentation for details.

Switching threshold

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

Sampling rate

The sampling rate determines how frequently the governor checks to tune the CPU. sampling_down_factor is a tunable that multiplies the sampling rate when the CPU is at its highest clock frequency thereby delaying load evaluation and improving performance. Allowed values for sampling_down_factor are 1 to 100000. 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

Make changes permanent

To have changes persist on system reboot probably the easiest is to use systemd-tmpfiles. For example to set the sampling_down_factor on boot you could create or edit a /etc/tmpfiles.d/10-cpu-sampling-down.conf file as follow

/etc/tmpfiles.d/10-cpu-sampling-down.conf
w /sys/devices/system/cpu/cpufreq/ondemand/sampling_down_factor - - - - 40

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 acpid package is installed, the file should already exist and be executable. For example, to change the scaling governor from performance to conservative when the AC adapter is disconnected and change it back if reconnected:

/etc/acpi/handler.sh
[...]

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

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: See the note below. (Discuss in Talk:CPU frequency scaling#)
Note: systemd introduced logind which handles consolekit and policykit actions. The following code below does not work. With logind, simply edit in the file /usr/share/polkit-1/actions/org.gnome.cpufreqselector.policy the <defaults> elements according to your needs and the polkit manual [1].

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 following file:

/var/lib/polkit-1/localauthority/50-local.d/org.gnome.cpufreqselector.pkla
[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.

The desktop-privilegesAUR package in the AUR contains a similar .pkla file for authorizing all users of the power group to change the governor.

Troubleshooting

Tango-inaccurate.pngThe factual accuracy of this article or section is disputed.Tango-inaccurate.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:CPU frequency scaling#)
  • 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-demand governor 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-demand governor (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 how to change 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/Lenovo 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.

Warning: Make sure you read and understood the section above. CPU frequency limitation is a safety feature of your BIOS and you should not need to work around it.

A special parameter has to be passed to the processor module.

For trying this temporarily change the value in /sys/module/processor/parameters/ignore_ppc from 0 to 1.

For setting it permanent refer to Kernel modules or just read on. Add processor.ignore_ppc=1 to your kernel boot line or create

/etc/modprobe.d/ignore_ppc.conf
# If the frequency of your machine gets wrongly limited by BIOS, this should help
options processor ignore_ppc=1

Common issues

High load

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: What kernel version? Needs a link to an open bug report, all that I've been able to find with a quick search is [2]. (Discuss in Talk:CPU frequency scaling#)

There is a bug in the kernel module rtsx_usb_ms which causes a constant load over 1.0. Test whether it makes a difference by temporarily removing it rmmod rtsx_usb_ms

See also