tlp - apply laptop power saving settings
tlp command [parameters] [--
CONFIG_PARAM=value ... ]
tlp applies power saving settings manually and controls
battery care features.
- start
- Initialize tlp and apply power saving settings according to the
actual power source. Also use to apply a changed configuration or to leave
manual mode.
- bat
- Apply the battery settings profile and enter manual mode. Manual mode
means that changes to the power source will be ignored until the next
reboot or tlp start is issued to resume automatic mode.
- true
- Same as bat.
- ac
- Apply the AC settings profile and enter manual mode. Manual mode means
that changes to the power source will be ignored until the next reboot or
tlp start is issued to resume automatic mode.
- false
- Same as ac.
- usb
- Enable autosuspend for all USB devices except those excluded by default or
in the configuration.
- bayoff
- Turn off optical drive in UltraBay/MediaBay. The drive may be re-enabled
by pulling the eject lever or pushing the media eject button on newer
models.
Note: charge threshold and recalibration commands below work for
specific laptop vendors and models only. Check the actual support status and
the value ranges with tlp-stat -b. For details on charge thresholds
also refer to the link at the bottom.
- setcharge
[START_CHARGE_THRESH STOP_CHARGE_THRESH]
[BAT0|BAT1|BATx|CMB0]
- Changes the charge thresholds for the battery temporarily. If your
hardware supports only a stop threshold, set the start value to 0.
Configured charge thresholds will be restored at the next boot or by using
tlp setcharge again but without the threshold arguments.
- fullcharge
[BAT0|BAT1|BATx|CMB0]
- Charge the battery to full capacity. This is done by applying vendor
presets to the charge thresholds temporarily. Configured charge thresholds
will be restored at the next boot or by using tlp setcharge without
the threshold arguments.
- chargeonce
[BAT0|BAT1] (ThinkPads only)
- Charge the battery to the stop charge threshold once. This is done by
temporarily lifting the start charge threshold. The configured start
charge threshold will be restored at the next boot or by using tlp
setcharge without the threshold arguments.
- discharge
[BAT0|BAT1] (ThinkPads only)
- Force complete discharge of the battery.
- recalibrate
[BAT0|BAT1] (ThinkPads only)
- Battery recalibration: completely discharge the battery and recharge to
100%. The latter is done by temporarily applying vendor presets to the
thresholds. Configured thresholds will be restored at the next boot or by
using tlp setcharge.
- diskid
- Show disk ids for configuration.
- --
CONFIG_PARAM=value ...
- Add configuration parameters to override the system configuration for this
single program invocation only. They are not kept afterwards.
For laptops with more than one battery the selection works as
follows:
- BAT0 - Main or internal battery
- BAT1 - Secondary or replaceable battery
Change thresholds of the main battery to 70 / 90% temporarily:
- tlp setcharge 70 90 BAT0
Charge the auxiliary battery to full capacity:
- tlp fullcharge BAT1
Recalibrate the main battery:
- tlp recalibrate BAT0
/etc/tlp.conf
System-wide user configuration file, uncomment parameters
here to override default settings and customization files below.
/etc/tlp.d/*.conf
System-wide drop-in customization files, overriding
defaults below.
/usr/share/tlp/defaults.conf
Intrinsic default settings. DO NOT EDIT this file,
instead use one of the above alternatives.
/run/tlp/run.conf
Effective settings consolidated from all above files. DO
NOT CHANGE this file, it is for reference only and regenerated on every
invocation of TLP.
/etc/default/tlp
Obsolete system-wide configuration file. DO NOT USE this
file, it is evaluated only when /etc/tlp.conf is non-existent.
On success, 0 is returned, a non-zero failure code otherwise.
tlp-stat(8), bluetooth(1), nfc(1),
wifi(1), wwan(1).
(c) 2022 Thomas Koch <linrunner at gmx.net>