This tool was originally developed to fix Linux CPU throttling issues affecting Lenovo T480 / T480s / X1C6 as described here.
The CPU package power limit (PL1/2) is forced to a value of 44 W (29 W on battery) and the temperature trip point to 95 'C (85 'C on battery) by overriding default values in MSR and MCHBAR every 5 seconds (30 on battery) to block the Embedded Controller from resetting these values to default.
On systems where the EC doesn't reset the values (ex: ASUS Zenbook UX430UNR), the power limit can be altered by using the official intel_rapl driver (see Static fix for more information)
Other users have confirmed that the tool is also working for these laptops:
I will keep this list updated.
I suggest you to use the excellent s-tui tool to check and monitor the CPU usage, frequency, power and temperature under load!
The tool supports undervolting the CPU by configuring voltage offsets for CPU, cache, GPU, System Agent and Analog I/O planes. The tool will re-apply undervolt on resume from standby and hibernate by listening to DBus signals. You can now either use the
UNDERVOLT key in config to set global values or the
UNDERVOLT.BATTERY keys to selectively set undervolt values for the two power profiles.
The tool now supports overriding the IccMax by configuring the maximum allowed current for CPU, cache and GPU planes. The tool will re-apply IccMax on resume from standby and hibernate. You can now either use the
ICCMAX key in config to set global values or the
ICCMAX.BATTERY keys to selectively set current values for the two power profiles. NOTE: the values specified in the config file are the actual current limit of your system, so those are not a offset from the default values as for the undervolt. As such, you should first find your system default values with the
I have found that under load my CPU was not always hitting max turbo frequency, in particular when using one/two cores only. For instance, when running prime95 (1 core, test #1) my CPU is limited to about 3500 MHz over the theoretical 4000 MHz maximum. The reason is the value for the HWP energy performance hints. By default TLP sets this value to
balance_performance on AC in order to reduce the power consumption/heat in idle. By setting this value to
performance I was able to reach 3900 MHz in the prime95 single core test, achieving a +400 MHz boost. Since this value forces the CPU to full speed even during idle, a new experimental feature allows to automatically set HWP to performance under load and revert it to balanced when idle. This feature can be enabled (in AC mode only) by setting to
HWP_Mode parameter in the lenovo_fix config file : https://github.com/erpalma/throttled/blob/master/etc/lenovo_fix.conf#L41 .
I have run Geekbench 4 and now I can get a score of 5391/17265! On
balance_performance I can reach only 4672/16129, so 15% improvement in single core and 7% in multicore, not bad ;)
On a lot of modern CPUs from Intel one can configure the TDP up or down based on predefined profiles. This is what this option does. For a i7-8650U normal would be 15W, up profile is setting it to 25W and down to 10W. You can lookup the values of your CPU at the Intel product website.
A stripped down version of the python module
python-periphery is now built-in and it is used for accessing the MCHBAR register by memory mapped I/O. You also need
gobject python bindings for listening to dbus signals on resume from sleep/hibernate.
Some time ago a feature called Kernel Lockdown was added to Linux. Kernel Lockdown automatically enables some security measures when Secure Boot is enabled, among them restricted access to MSR and PCI BAR via /dev/mem, which this tool requires. There are two ways to get around this: You can either disable Secure Boot in your firmware settings, or disable the Kernel Lockdown LSM.
The LSM can be disabled this way: Check the contents of the file
/sys/kernel/security/lsm (example contents:
capability,lockdown,yama). Take the contents of the file, remove
lockdown and add the rest as a kernel parameter, like this:
lsm=capability,yama. Reboot and Kernel Lockdown will be disabled!
As of Linux 5.9, kernel messages will be logged whenever the script writes to MSR registers. These aren't a problem for now, but there's some indication that future kernels may restrict MSR writes from userspace by default. This is being tracked by issue #215. The messages will look something like:
[ 324.833543] msr: Write to unrecognized MSR 0x1a2 by python3 Please report to email@example.com
Note that some kernels (e.g. linux-hardened) will prevent from writing to
/dev/mem too. Specifically, you need a kernel with
As discovered by DEvil0000 the Linux Thermal Monitor (thermald) can conflict with the purpose of this tool. In particular, thermald might be pre-installed (e.g. on Ubuntu) and configured in such a way to keep the CPU temperature below a certain threshold (~80 'C) by applying throtthling or messing up with RAPL or other CPU-specific registers. I strongly suggest to either disable/uninstall it or to review its default configuration.
The tool is now running with Python3 by default (tested w/ 3.6) and a virtualenv is automatically created in
/opt/lenovo_fix. Python2 should probably still work.
pacman -S throttled sudo systemctl enable --now lenovo_fix.service
Thanks to felixonmars for creating and maintaining this package.
makepkg -si sudo rc-update add lenovo_fix default sudo rc-service lenovo_fix start
sudo apt install git build-essential python3-dev libdbus-glib-1-dev libgirepository1.0-dev libcairo2-dev python3-venv python3-wheel git clone https://github.com/erpalma/throttled.git sudo ./throttled/install.sh
If you own a X1C6 you can also check a tutorial for Ubuntu 18.04 here.
You should make sure that thermald is not setting it back down. Stopping/disabling it will do the trick:
sudo systemctl stop thermald.service sudo systemctl disable thermald.service
If you want to keep it disabled even after a package update you should also run:
sudo systemctl mask thermald.service
sudo dnf copr enable abn/throttled sudo dnf install -y throttled sudo systemctl enable --now throttled
If you prefer to install from source, you can use the following commands.
sudo dnf install python3-cairo-devel cairo-gobject-devel gobject-introspection-devel dbus-glib-devel python3-devel make libX11-devel git clone https://github.com/erpalma/throttled.git sudo ./throttled/install.sh
Feedback about Fedora installation is welcome.
User brycecordill reported that the following dependencies are required for installing in openSUSE, tested on openSUSE 15.0 Leap.
sudo zypper install gcc make python3-devel dbus-1-glib-devel python3-cairo-devel cairo-devel python3-gobject-cairo gobject-introspection-devel git clone https://github.com/erpalma/throttled.git sudo ./throttled/install.sh
An overlay is available.
layman -o https://github.com/erpalma/throttled-overlay/raw/master/repositories.xml -f -a throttled sudo emerge -av sys-power/throttled systemctl enable throttled.service systemctl start throttled.service
sudo eopkg it -c system.devel sudo eopkg it git python3-devel dbus-glib-devel python3-cairo-devel libcairo-devel python3-gobject-devel git clone https://github.com/erpalma/throttled.git sudo ./throttled/install.sh
The installation itself will create a runit service as lenovo_fix, enable it and start it. Before installation, make sure dbus is running
sv up dbus.
sudo xbps-install -Sy gcc git python3-devel dbus-glib-devel libgirepository-devel cairo-devel python3-wheel pkg-config make git clone https://github.com/erpalma/throttled.git sudo ./throttled/install.sh
To permanently stop and disable the execution just issue:
systemctl stop lenovo_fix.service systemctl disable lenovo_fix.service
If you're running runit instead of systemd:
sv down lenovo_fix rm /var/service/lenovo_fix
If you're using OpenRC instead of systemd:
rc-service lenovo_fix stop rc-update del lenovo_fix default
If you also need to remove the tool from the system:
rm -rf /opt/lenovo_fix /etc/systemd/system/lenovo_fix.service # to purge also the config file rm /etc/lenovo_fix.conf
On Arch you should probably use
pacman -R lenovo-throttling-fix-git instead.
If you update the tool you should manually check your config file for changes or additional features and modify it accordingly. The update process is then as simple as:
cd throttled git pull sudo ./install.sh sudo systemctl restart lenovo_fix.service OpenRC: sudo rc-service lenovo_fix restart
The configuration has moved to
/etc/lenovo_fix.conf. Makefile does not overwrite your previous config file, so you need to manually check for differences in config file structure when updating the tool. If you want to overwrite the config with new defaults just issue
sudo cp etc/lenovo_fix.conf /etc. There exist two profiles
BATTERY and the tool can be totally disabled by setting
Enabled: False in the
GENERAL section. Undervolt is applied if any voltage plane in the config file (section UNDERVOLT) was set. Notice that the offset is in mV and only undervolting (i.e. negative values) is supported.
All fields accept floating point values as well as integers.
My T480s with i7-8550u is stable with:
[UNDERVOLT] # CPU core voltage offset (mV) CORE: -105 # Integrated GPU voltage offset (mV) GPU: -85 # CPU cache voltage offset (mV) CACHE: -105 # System Agent voltage offset (mV) UNCORE: -85 # Analog I/O voltage offset (mV) ANALOGIO: 0
IMPORTANT: Please notice that my system is stable with these values. Your notebook might crash even with slight undervolting! You should test your system and slowly incresing undervolt to find the maximum stable value for your CPU. You can check this tutorial if you don't know where to start.
With the flag
--monitor the tool constantly monitors the throttling status, indicating the cause among thermal limit, power limit, current limit or cross-origin. The last cause is often related to an external event (e.g. by the GPU). The update rate can be adjusted and defaults to 1 second. Example output:
./lenovo_fix.py --monitor [I] Detected CPU architecture: Intel Kaby Lake (R) [I] Loading config file. [I] Starting main loop. [D] Undervolt offsets: CORE: -105.00 mV | GPU: -85.00 mV | CACHE: -105.00 mV | UNCORE: -85.00 mV | ANALOGIO: 0.00 mV [D] IccMax: CORE: 64.00 A | GPU: 31.00 A | CACHE: 6.00 A [D] Realtime monitoring of throttling causes: [AC] Thermal: OK - Power: OK - Current: OK - Cross-domain (e.g. GPU): OK || VCore: 549 mV - Package: 2.6 W - Graphics: 0.4 W - DRAM: 1.2 W
You can alternatively set the power limits using intel_rapl driver (modifying MCHBAR values requires Linux 5.3+). Bear in mind, some embedded controllers (EC) control the power limit values and will reset them from time to time):
# MSR # PL1 echo 44000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_0_power_limit_uw # 44 watt echo 28000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_0_time_window_us # 28 sec # PL2 echo 44000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_1_power_limit_uw # 44 watt echo 2440 | sudo tee /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_1_time_window_us # 0.00244 sec # MCHBAR # PL1 echo 44000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_0_power_limit_uw # 44 watt # ^ Only required change on a ASUS Zenbook UX430UNR echo 28000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_0_time_window_us # 28 sec # PL2 echo 44000000 | sudo tee /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_1_power_limit_uw # 44 watt echo 2440 | sudo tee /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_1_time_window_us # 0.00244 sec
If you want to change the values automatic on boot you can use systemd-tmpfiles:
# /etc/tmpfiles.d/power_limit.conf # MSR # PL1 w /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_0_power_limit_uw - - - - 44000000 w /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_0_time_window_us - - - - 28000000 # PL2 w /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_1_power_limit_uw - - - - 44000000 w /sys/devices/virtual/powercap/intel-rapl/intel-rapl:0/constraint_1_time_window_us - - - - 2440 # MCHBAR # PL1 w /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_0_power_limit_uw - - - - 44000000 # ^ Only required change on a ASUS Zenbook UX430UNR w /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_0_time_window_us - - - - 28000000 # PL2 w /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_1_power_limit_uw - - - - 44000000 w /sys/devices/virtual/powercap/intel-rapl-mmio/intel-rapl-mmio:0/constraint_1_time_window_us - - - - 2440
You can enable the
--debug option to read back written values and check if the tool is working properly. At the statup it will also show the CPUs platform info which contains information about multiplier values and features present for this CPU. Additionally the tool will print the thermal status per core which is handy when it comes to figuring out the reason for CPU throttle. Status fields stands for the current throttle reason or condition and log shows if this was a throttle reason since the last interval.
This is an example output:
./lenovo_fix.py --debug [D] cpu platform info: maximum non turbo ratio = 20 [D] cpu platform info: maximum efficiency ratio = 4 [D] cpu platform info: minimum operating ratio = 4 [D] cpu platform info: feature ppin cap = 0 [D] cpu platform info: feature programmable turbo ratio = 1 [D] cpu platform info: feature programmable tdp limit = 1 [D] cpu platform info: number of additional tdp profiles = 2 [D] cpu platform info: feature programmable temperature target = 1 [D] cpu platform info: feature low power mode = 1 [D] TEMPERATURE_TARGET - write 0xf - read 0xf [D] Undervolt plane CORE - write 0xf2800000 - read 0xf2800000 [D] Undervolt plane GPU - write 0xf5200000 - read 0xf5200000 [D] Undervolt plane CACHE - write 0xf2800000 - read 0xf2800000 [D] Undervolt plane UNCORE - write 0xf5200000 - read 0xf5200000 [D] Undervolt plane ANALOGIO - write 0x0 - read 0x0 [D] MSR PACKAGE_POWER_LIMIT - write 0xcc816000dc80e8 - read 0xcc816000dc80e8 [D] MCHBAR PACKAGE_POWER_LIMIT - write 0xcc816000dc80e8 - read 0xcc816000dc80e8 [D] TEMPERATURE_TARGET - write 0xf - read 0xf [D] core 0 thermal status: thermal throttle status = 0 [D] core 0 thermal status: thermal throttle log = 1 [D] core 0 thermal status: prochot or forcepr event = 0 [D] core 0 thermal status: prochot or forcepr log = 0 [D] core 0 thermal status: crit temp status = 0 [D] core 0 thermal status: crit temp log = 0 [D] core 0 thermal status: thermal threshold1 status = 0 [D] core 0 thermal status: thermal threshold1 log = 1 [D] core 0 thermal status: thermal threshold2 status = 0 [D] core 0 thermal status: thermal threshold2 log = 1 [D] core 0 thermal status: power limit status = 0 [D] core 0 thermal status: power limit log = 1 [D] core 0 thermal status: current limit status = 0 [D] core 0 thermal status: current limit log = 0 [D] core 0 thermal status: cross domain limit status = 0 [D] core 0 thermal status: cross domain limit log = 0 [D] core 0 thermal status: cpu temp = 44 [D] core 0 thermal status: temp resolution = 1 [D] core 0 thermal status: reading valid = 1 .....
Auto reload config on changes (unless it's deleted) can be enabled/disabled in the config
[General] Autoreload = True
Tools provided by your notebook manufacturer like Dell Power Manager tend to persist their settings to the system board. If you ever had it running under Windows and activated a cool/quiet/silent/saving profile, this setting will still be active when running linux, throttling your system.
On my Dell Latitude 5591, not even a BIOS reset to manufacturar default killed the active
This script overrides the default values set by Lenovo. I'm using it without any problem, but it is still experimental so use it at your own risk.