Battery Care
What is “Battery Life”?
Battery life is the amount of time your device runs before it needs to be recharged, it’s also called battery runtime. It’s the task of TLP’s power saving features to extend it.
In contrast battery lifespan is the amount of time your battery lasts until it needs to be replaced. This is where battery care comes in.
What is “Battery Care”?
In Version 1.3 and below it is called “Battery Features”.
The purpose of battery care on laptops is to reduce the loss of capacity due to wear from ongoing battery operation i.e. to prolongate the battery lifespan. This can be achieved by:
Limiting the maximum charge level to below 100%: stop charge threshold
After a short discharge, prevent the charging process from continuing as soon as the charger is connected: start charge threshold
Recalibration: helps keeping charge level (SOC) readings and battery runtime estimates accurate by setting new “full charge” and “full discharge” anchors in the battery controller
Battery care does not comprise additional power saving.
How does it work?
The process of battery charging is not directly controlled by TLP, but by the embedded controller (EC) of your laptop. This makes the process work even when the laptop is switched off or no operating system is running. The contribution of TLP is to write the threshold values into the corresponding control registers of the EC using a hardware specific kernel driver.
The charging process is determined by the charge thresholds:
Start charge threshold (START_CHARGE_THRESH_BATx): battery charge level below which charging will begin when connecting the charger.
Stop charge threshold (STOP_CHARGE_TRESH_BATx): battery charge level above which charging will stop while the charger is connected.
You cannot change the basic behavior described above, because it is hard-coded into the EC firmware by the vendor. However, you can control it by setting thresholds using TLP.
Charge thresholds written into the EC registers are persistently stored in the hardware of many vendors. Which means they are retained when another operating system is started - provided they are not changed by software installed there and the hardware actually supports persistence.
What charge thresholds do not do
They do not exercise any control over the discharging of the battery, this depends solely on whether AC is connected and if the laptop is switched on
In particular, with AC connected, a battery with a charge level higher than the stop charge threshold will not be discharged to the stop charge threshold, nor will there be a (cyclic) discharge down to the start charge threshold
See also
The level of battery care support depends on laptop vendor or brand, Linux kernel version and TLP version - consult Battery Care Vendor Specifics for details
Settings: Battery Care
Commands: Battery Care
Why does the battery not begin to discharge when the stop threshold is reached?
What is the purpose of battery charge thresholds?
See above.
How do battery charge thresholds work?
See above.
How to choose good battery charge thresholds?
Note
Newer ThinkPad models may not need charge thresholds due to dualmode battery firmware – a Lenovo staff member states at Lenovo Forums [1]: “The battery firmware itself will recognize the scenario where the battery is ALWAYS fully charged 100% (over a period of many weeks) and adjust the full charge capacity downwards in a way to maintain maximum battery health. This is something that happens automatically in the battery firmware. There is nothing that a user needs to do manually, to maximize battery health on these batteries. For this reason, we don’t provide any utility to manually manage battery charge thresholds […]”
Factory settings for ThinkPad battery thresholds are as follows: when plugged in the battery starts charging at 96%, and stops at 100%. These settings are optimized for maximum runtime, but having a battery hold a lot of power will decrease its capacity over the years. To alleviate this problem, the start/stop charge thresholds can be adjusted – at the cost of a more or less reduced battery runtime.
It all depends on how you use your laptop, or more precisely, on the minimal runtime you’re ready to accept when you’re on the road. In the end, it all comes down to a runtime vs. lifespan trade-off.
If the laptop is plugged most of the time and rarely unplugged, maximizing battery lifetime at the cost of a greatly reduced runtime may be acceptable, with values like starting charge at 40% and stopping at 50%.
On the contrary, if you use it unplugged most of the time, starting charge at 85% and stopping at 90% would allow for a much longer runtime and still give a lifespan benefit over the factory settings.
Sources:
Default TLP settings (only if you uncomment the relevant lines) are slightly more protective regarding lifespan, with 75/80% charge thresholds.
Note
Please always consider that the start threshold is the critical constraint for runtime, because it defines the lowest charge level that can occur while plugged. Remember that TLP provides a command (tlp fullcharge) to fully charge the battery, when you need to temporarily maximize runtime (for example in case of a trip).
How to enable charge thresholds?
It is not enough to set charge thresholds once with the tlp setcharge command. To make charge thresholds permanent, even if the hardware does not have the ability to keep them persistent, you have to enter them into the configuration file, for example /etc/tlp.conf:
START_CHARGE_THRESH_BAT0=75
STOP_CHARGE_THRESH_BAT0=80
Then apply your changed configuration with the command
sudo tlp start
See also
Please check Battery Care Vendor Specifics for permitted threshold values of your laptop.
How can I check if my configured charge thresholds are working?
The output of tlp-stat -b shows two characteristics for the positive case:
An active battery care driver for the charge thresholds
The actual charge threshold(s) – read back from the embedded controller
So if there is a line containing Supported features: charge threshold(s) and the displayed threshold(s) match(es) the one(s) you configured, then the charging logic has properly received them. The article Battery Care Vendor Specifics shows tlp-stat -b sample outputs for all supported hardware to compare. If your tlp-stat -b output does not contain the required characteristics, check the following sections for solutions.
However, if despite a correctly set up system the charge threshold(s) do(es) not work as you expect them to, then you should first compare your idea of the charging process with the description above and subsequently check the sections further down for possible explanations.
Note
On some models the displayed threshold values do not correspond to the configured ones, although they work as they should – refer to ThinkPad E / L / S / Yoga series.
Which external kernel module do I need for my ThinkPad?
Note
thinkpad_acpi is not an external kernel module and you do not normally have to worry about it. It is contained in the Linux kernel and all distributions provide it as part of their kernel packages. ThinkPads load it automatically at boot time.
Prerequisite: make sure to install the most recent version of TLP for accurate recommendations.
Check the bottom of the output of tlp-stat -b, section ‘Recommendations’, for the following lines
Install tp-smapi kernel modules for ThinkPad battery thresholds and recalibration
Install acpi_call kernel module for ThinkPad battery thresholds and recalibration
Install acpi_call kernel module for ThinkPad battery recalibration
and install the required external kernel module package as explained in Installation for your distribution.
Almost all ThinkPad models need only one of the above kernel modules. You may check the output of tlp-stat -b for lines like:
tpacpi-bat = inactive (ThinkPad not supported)
tp-smapi = inactive (ThinkPad not supported)
and remove the unnecessary module package (tpacpi-bat means acpi_call). However it doesn’t really hurt to keep both.
natacpi – Ultimate solution at the horizon
Starting with kernel 4.17 tpacpi-bat gets superseded by a new, native kernel API called natacpi (contained in the ubiquitious kernel module thinkpad_acpi) which supports charge thresholds so far. tlp-stat -b indicates this as follows:
Version 1.3
+++ Battery Features
natacpi = active (data, thresholds)
tpacpi-bat = active (recalibrate)
tp-smapi = inactive (ThinkPad not supported)
...
/sys/class/power_supply/BAT0/charge_start_threshold = 96 [%]
/sys/class/power_supply/BAT0/charge_stop_threshold = 100 [%]
tpacpi-bat.BAT0.forceDischarge = 0
Version 1.4
+++ Battery Care
Plugin: thinkpad
Supported features: charge thresholds, recalibration
Driver usage:
* natacpi (thinkpad_acpi) = active (charge thresholds)
* tpacpi-bat (acpi_call) = active (recalibration)
...
/sys/class/power_supply/BAT0/charge_control_start_threshold = 96 [%]
/sys/class/power_supply/BAT0/charge_control_end_threshold = 100 [%]
tpacpi-bat.BAT0.forceDischarge = 0
Version 1.5 or higher with kernel 5.17 or higher
Kernel 5.17 adds recalibration and completes natacpi. tpacpi-bat and the external kernel module acpi_call together with the distribution-specific packages become superfluous. tlp-stat -b now looks like this:
+++ Battery Care
Plugin: thinkpad
Supported features: charge thresholds, recalibration
Driver usage:
* natacpi (thinkpad_acpi) = active (charge thresholds, recalibration)
...
/sys/class/power_supply/BAT0/charge_control_start_threshold = 96 [%]
/sys/class/power_supply/BAT0/charge_control_end_threshold = 100 [%]
/sys/class/power_supply/BAT0/charge_behaviour = [auto] inhibit-charge force-discharge
See also
Battery Care Vendor Specifics - Details on hardware support
tpacpi-bat – Source code for the tool that is included in TLP to provide battery recalibration for ThinkPads since model year 2011 - e.g. T420/X220 and newer
acpi_call – Source code of the external kernel module required by tpacpi-bat
tp-smapi – Documentation for the external kernel modules required for ThinkPads until model year 2011
Are ThinkPads with Coreboot / Libreboot supported?
Some models are not recognized as ThinkPads because of an incorrect model string provided by Coreboot/Libreboot. As a result battery care is not activated (see Issue #657). Sample output of tlp-stat:
-- TLP 1.5.0 --------------------------------------------
+++ Battery Care
Plugin: generic
Supported features: none available
...
/sys/class/power_supply/BAT0/charge_control_start_threshold = 0 [%]
/sys/class/power_supply/BAT0/charge_control_end_threshold = 100 [%]
When the recognition works, the capabilities are limited:
Charge thresholds: work.
Recalibration: not supported (see Issues #547, #626). Sample output of tlp-stat:
/sys/class/power_supply/BAT1/charge_behaviour = [auto]
Battery status: battery values energy_full_design, energy_full and energy_now are missing from the tlp-stat -b output because Coreboot/Libreboot supply incorrect data to the Linux kernel (see Issue #657); sample output:
+++ Battery Care Plugin: thinkpad Supported features: charge thresholds, recalibration Driver usage: * natacpi (thinkpad_acpi) = active (charge thresholds, recalibration) Parameter value ranges: * START_CHARGE_THRESH_BAT0/1: 0(off)..96(default)..99 * STOP_CHARGE_THRESH_BAT0/1: 1..100(default) +++ ThinkPad Battery Status: BAT0 (Ultrabay / Slice / Replaceable) /sys/class/power_supply/BAT1/manufacturer = SONY /sys/class/power_supply/BAT1/model_name = 42T4967 /sys/class/power_supply/BAT1/cycle_count = 0 (or not supported) /sys/class/power_supply/BAT1/status = Discharging < energy data missing here > /sys/class/power_supply/BAT1/charge_control_start_threshold = 50 [%] /sys/class/power_supply/BAT1/charge_control_end_threshold = 60 [%] /sys/class/power_supply/BAT1/charge_behaviour = [auto]
Why is my battery charged up to 100% – ignoring the charge thresholds?
Possible causes are:
Laptop is not supported
Battery Care Vendor Specifics lists supported hardware and explains the prerequisites.
Kernel module thinkpad_acpi is not loaded
ThinkPads only
Symptoms:
--- TLP 1.5.0 --------------------------------------------
+++ Battery Care
Plugin: generic
Supported features: none available
or
--- TLP 1.3.1 --------------------------------------------
+++ Battery Features: Charge Thresholds and Recalibrate
natacpi = inactive (laptop not supported)
tpacpi-bat = inactive (laptop not supported)
tp-smapi = inactive (laptop not supported)
Load attempt with sudo modprobe thinkpad_acpi reveals
modprobe: ERROR: could not insert 'thinkpad_acpi': Invalid argument
Cause: your system configuration contains broken boot options for thinkpad_acpi.
Solution: check and correct your GRUB config (distribution dependent) or module config files (/etc/modprobe.d/*.conf).
External kernel module is not installed
ThinkPads only
Symptom: tlp-stat -b shows
tpacpi-bat = inactive (kernel module 'acpi_call' not installed)
or
tp-smapi = inactive (kernel module 'tp_smapi' not installed)
Solution: read Which external kernel module do I need for my ThinkPad? and install the necessary packages. If tlp-stat -b still claims ‘not installed’ after installing the appropriate package, reinstall the package via shell command and check the output for errors. See below for possible causes.
Fedora release upgrade
ThinkPads only
It may be necessary to rebuild the kernel modules (as root):
akmods --force
Installation of package acpi-call-dkms failed
ThinkPads only
Important
acpi_call and derived packages are not provided by the TLP project. Please don’t file bug reports for them in the TLP issue tracker.
Symptoms: tlp-stat -b shows
tpacpi-bat = inactive (kernel module 'acpi_call' not installed)
Package install shows
Setting up acpi-call-dkms ...
Error! Bad return status for module build on kernel: ...
Solution: upgrade the package:
Debian and Ubuntu derivatives
Kernel ≥ 5.13 needs at least package version 1.2.2-1 (Debian Sid/Bookworm or Ubuntu 22.04 or TLP PPA)
Kernel ≥ 5.6 needs at least package version 1.1.0-5ubuntu0.1 (Ubuntu 20.04) or 1.1.0-6 (Debian Bullseye/Buster Backports, Ubuntu 21.10)
Kernel module acpi-call is not loaded
ThinkPads only
Symptom: tlp-stat -b shows
tpacpi-bat = inactive (kernel module 'acpi_call' load error)
Solution: try to load manually with
sudo modprobe -v acpi_call
and use adequate forums to resolve your issue with acpi-call.
Note
You may need to disable Secure Boot when acpi-call refuses to load. Check your distribution’s Installation instructions.
Installation of package tp-smapi-dkms failed
ThinkPads only
Important
tp-smapi and derived packages are not provided by the TLP project. Please don’t file bug reports for them in the TLP issue tracker.
Symptoms (Ubuntu): tlp-stat -b shows
tp-smapi = inactive (kernel module 'tp_smapi' not installed)
Package install shows
Setting up tp-smapi-dkms ...
Error! Your kernel headers for kernel X.Y.0-NN-generic cannot be found.
Please install the linux-headers-X.Y.0-NN-generic package
Solution: install package linux-generic-headers.
Symptoms: tlp-stat -b shows
tp-smapi = inactive (kernel module 'tp_smapi' not installed)
Package install shows
Setting up tp-smapi-dkms ...
Error! Bad return status for module build on kernel: ...
Solution: upgrade the package:
Kernel module tp-smapi is not loaded
ThinkPads only
Symptom: tlp-stat -b shows
tp-smapi = inactive (kernel module 'tp_smapi' load error)
Solution: try to load manually with
sudo modprobe -v tp_smapi
and check tp-smapi Troubleshooting for a solution matching the error message or use adequate forums to resolve your issue with tp-smapi.
Note
You may need to disable Secure Boot when tp-smapi refuses to load, check your distribution’s Installation instructions
Libreboot does not support tp-smapi
tp-smapi does not support newer models, check Which external kernel module do I need for my ThinkPad?
ThinkPad E495
Symptom: thresholds have been written to the Embedded Controller (EC), tlp-stat -b reads them back as configured (see Issue #454):
/sys/class/power_supply/BAT0/charge_start_threshold = 45 [%]
/sys/class/power_supply/BAT0/charge_stop_threshold = 60 [%]
Yet they do not work.
Cause: bug in Lenovo’s EC firmware.
Workaround:
Update BIOS (contains EC firmware) to 1.16 or higher
Remove thresholds once from EC with tlp fullcharge
Leave the thresholds enabled in the config file
Reboot, which will restore the configured thresholds
ThinkPad T430(s)/T530/W530/X230 (and all later models)
Solutions:
Install a kernel ≥ 4.19 to make natacpi available
TLP automatically uses tpacpi-bat when the kernel module acpi_call is available, see Which external kernel module do I need for my ThinkPad?
ThinkPad T420(s)/T520/W520/X220
tp-smapi doesn’t support start threshold and recalibration on Sandy Bridge generation ThinkPads. Symptoms are:
tlp-stat -b shows
/sys/devices/platform/smapi/BAT0/start_charge_thresh = (not available)
tlp setcharge/tlp fullcharge show the message
start => Warning: cannot set threshold.
tlp discharge/recalibrate show the message
Error: discharge function not available for this laptop.
Solutions:
Install a kernel ≥ 4.19 to make natacpi available
TLP automatically uses tpacpi-bat when the kernel module acpi_call is available, see Which external kernel module do I need for my ThinkPad?
ThinkPad L420/520, L512, SL300/400/500, X121e
These models are neither supported by tp-smapi nor by tpacpi-bat or natacpi. Please refrain from opening issues.
ASUS laptops: stop charge threshold isn’t set at boot
Symptom: Battery stop charge threshold isn’t set at boot. But manually running tlp start or tlp setcharge sets the threshold.
Cause: kernel module asus_wmi is loaded too late in the boot sequence.
Solution: add the module to the Initramfs. The procedure depends on your distribution, for Arch Linux/Manjaro see Issue #602.
Battery has been removed
By removing (and re-inserting) the battery the charge thresholds may be reset to vendor specific defaults. To restore TLP’s settings use
sudo tlp setcharge
(see Battery Care) or
Restart system
Shutdown and power off system
Charge thresholds shown by tlp-stat -b do not correspond to the configured ones
Possible causes are:
Configuration was not activated
After changes to the configuration it is necessary to reboot. Alternatively use
sudo tlp start
or
sudo tlp setcharge
to activate the thresholds.
ThinkPad E / L / S / Yoga series
Also affected: ThinkPad Edge series, 11, SL410/510
On these models the threshold values shown by tlp-stat -b do not correspond to the written values. For example the settings
START_CHARGE_THRESH_BAT0=75
STOP_CHARGE_THRESH_BAT0=80
may show up as
/sys/class/power_supply/BAT0/charge_start_threshold = 75 [%]
/sys/class/power_supply/BAT0/charge_stop_threshold = 74 [%]
The described behavior is caused by the EC firmware, not by TLP. Nonetheless the charge thresholds work as configured.
Start threshold does not apply after change
Affected hardware: ThinkPads X240, Yoga 12 (based on user feedback)
Workaround: activating a new start threshold may require to discharge the battery below the old start threshold after writing the new threshold, i.e. via tlp setcharge or reboot (see Issue #173).
Do charge thresholds work even when TLP is not running or the laptop is powered off?
Yes. The charging process is not controlled by software running on behalf of the operating system but by the embedded controller (EC). TLP only passes the threshold values to the EC firmware using the appropriate driver. Once stored in the EC, the thresholds also take effect when the laptop is switched off. See below for removal.
A general explanation of charge thresholds is given above.
What exactly does the start charge threshold START_CHARGE_THRESH_BATx do?
The start charge threshold ensures that the battery is not recharged immediately after every short discharge process. The charging process starts only when the previous discharge was below the value of START_CHARGE_THRESH_BATx.
A general explanation of charge thresholds is given above.
How to disable the charge thresholds?
As explained above, in many cases the charge thresholds are persistently stored in the hardware. Therefore, it is not sufficient to simply remove the thresholds from the configuration (by the way, disabling or uninstalling TLP is not enough either). In fact, two steps are necessary for deactivation:
Removing the charge thresholds from the configuration by inserting a leading #
#START_CHARGE_THRESH_BAT0=75
#STOP_CHARGE_THRESH_BAT0=80
Reverting to vendor specific defaults with the command
sudo tlp fullcharge
Disabling the charge thresholds does not work
Affected hardware: ThinkPads E580, T480s, X1 Carbon 6th (based on user feedback)
Symptom: after resetting the thresholds as described above, tlp-stat -b shows the stop threshold unchanged.
Cause: after applying a stop threshold value < 100, Lenovo’s EC firmware does not accept values higher than the previously set value.
Solution: update EC firmware (contained in BIOS update)
T480s: ECP 1.13 (BIOS 1.31) or higher
X1 Carbon 6th: ECP 1.12 (BIOS 1.37) or higher
Workaround (without BIOS update):
Disable the threshold configuration as decribed above
Power off the laptop via shutdown
Unplug AC power
Power on the laptop
At the Lenovo logo: press Enter, F1 to enter the BIOS setup
Go to: Config → Power → Disable Built-in Battery, Enter, Y laptop will power off
Connect AC
Power on laptop
Check with tlp-stat -b – thresholds should be at factory settings 96/100% now
When unsuccessful, repeat the whole procedure
Misc Thinkpad battery malfunctions
Affected hardware: ThinkPad T480, X280 et. al.
Sometimes ThinkPads show symptoms where one would actually suspect a defect of the battery or the system board. Users have reported, for example:
External battery BAT1 stopped discharging and stays at 100%. This means that the computer shuts off when BAT0 dies, even though the external has charge left. Reference: Arch Linux forum.
Spontaneous shutdown when removing the external battery BAT1, although the internal battery BAT0 is charged. Reference: Issue #690.
Battery does not charge although the charger is connected and no charge threshold is active.
Possible cause: malfunction of the EC firmware, which controls all charging operations independently of the operating system.
Solutions:
Press the emergency reset hole (button) on the bottom of the ThinkPad with a paper clip
Update EC firmware
Erratic battery behavior on ThinkPad T420(s)/T520/W520/X220 (and all later models)
Symptom: some users report severely reduced battery capacity or sudden drops of the charge level from around 30% to zero when employing charge thresholds.
Probable cause: conflict with dualmode battery firmware (refer to How to choose good battery charge thresholds?).
Solution: remove battery thresholds completely or use only the start threshold by setting the stop threshold to 100%:
START_CHARGE_THRESH_BAT0=75
STOP_CHARGE_THRESH_BAT0=100
Then recalibrate the battery once.
Note
This is a software only issue, no harm is done to the battery.
How to designate the battery to discharge when battery powered?
For ThinkPads with two batteries the embedded controller (EC) alone determines the order in which the batteries are used (discharged) and charged as well as the switching point. Furthermore the Lenovo EC firmware offers no way to change the behaviour (except indirectly via charge thresholds and force-discharge of course). In addition, the behavior may differ depending on the model.
The above means that selecting the active battery for ThinkPads - also called “battery balancing” - is impossible because the EC firmware offers no way to do this, neither manual nor automatic.
tlp fullcharge BAT1 stops at ~80%
Affected hardware: ThinkPad T440s (based on user feedback)
Symptom: despite the stop threshold is set to 100% either by configuration or by tlp fullcharge/setcharge, charging of BAT1 stops at around 80%. As soon as BAT1 reaches 80%, charging commences with BAT0 until 100%, afterwards BAT1 continues until 100%. If a stop threshold is set for BAT0, the last step may never happen.
No solution: Lenovo’s EC firmware offers no possibility to change the behaviour (see above).
Why does the battery not begin to discharge when the stop threshold is reached?
Author’s remark: sometimes users trap into this misunderstanding without me having understood how it happens. This is the attempt to lead them out again.
The task of the stop threshold is to reduce battery wear by limiting the charge level below 100%. So charging stops at the threshold and the battery will not be discharged as long as the charger remains connected.
This is the behaviour designated by the vendor. It cannot (and should not) be changed, because repeated discharge of the battery during operation on AC power would lead to absurdly high wear (i.e. charging cycles) without any benefit being derived from it.
A general explanation of charge thresholds is given above.
My battery does not charge anymore after recalibration showing X% remaining capacity constantly
ThinkPads only
Most probable cause: battery is defect – and was it even before the recalibration attempt.
tlp recalibrate terminates with an error message
ThinkPads only
Impact: recalibration does not work at all without a full discharge to tell the battery controller (the one in the battery) where the actual 0% is.
Symptom 1:
Warning: battery BAT0 was not discharged completely -- AC/charger removed.
Solution: first make sure AC power is connected during the whole process then try a different charger.
Symptom 2:
Error: battery BAT0 was not discharged completely i.e. terminated by the firmware -- check your hardware.
Cause: this is a hardware issue either with your battery (likely), charger or laptop.
Solution: first try another battery pack then a different charger. If this does not remedy the situation, a system board defect could be the reason.
Note
If the discharge process regularly stops at 1%, for example, you may prefer to ignore the problem because it is minor. Nevertheless, a battery or hardware defect could be present in this case.
Why does the panel applet show the battery state “charging” despite charge thresholds are effective?
ThinkPads only
Existing panel applets query upowerd or the standard kernel interface which do not reflect the charging condition correctly as soon as charge thresholds intervene.
In this situation tlp-stat -b shows
“Idle” - Version 1.4 and newer
“Unknown (threshold effective)” - Version 1.3
for /sys/class/power_supply/BATx/status.
For ThinkPad models supporting tp-smapi, the correct state “Idle” is shown for /sys/devices/platform/smapi/BATx/state.
Why does tlp-stat -b display “cycle_count = (not supported)”?
Cycle count is not available for all laptops. Positive exceptions are older ThinkPads supporting tp-smapi and certain newer hardware.
Note
For new batteries with zero cycles, tlp-stat -b displays (not supported) too. This is because the kernel output does not distinguish zero cycles from unsupported, it is 0 in both cases. With supported hardware the display works again as soon as the battery has at least one cycle.