1tlp(8) Power Management tlp(8)
2
6 tlp - apply laptop power saving settings
7
9 tlp command [parameters] [-- CONFIG_PARAM=value ... ]
10
12 tlp applies power saving settings manually and controls battery care
13 features.
14
16 start Initialize tlp and apply power saving settings according to the
17 actual power source. Also use to apply a changed configuration
18 or to leave manual mode.
19 bat Apply the battery settings profile and enter manual mode. Manual
21 mode means that changes to the power source will be ignored un‐
22 til the next reboot or tlp start is issued to resume automatic
23 mode.
24 true Same as bat.
26 ac Apply the AC settings profile and enter manual mode. Manual mode
28 means that changes to the power source will be ignored until the
29 next reboot or tlp start is issued to resume automatic mode.
30 false Same as ac.
32 usb Enable autosuspend for all USB devices except those excluded by
34 default or in the configuration.
35 bayoff Turn off optical drive in UltraBay/MediaBay. The drive may be
37 re-enabled by pulling the eject lever or pushing the media eject
38 button on newer models.
39 Note: charge threshold and recalibration commands below work for spe‐
41 cific laptop vendors and models only. Check the actual support status
42 and the value ranges with tlp-stat -b. For details on charge thresholds
43 also refer to the link at the bottom.
44 setcharge [START_CHARGE_THRESH STOP_CHARGE_THRESH]
46 [BAT0|BAT1|BATx|CMB0]
47 Changes the charge thresholds for the battery temporarily. If
48 your hardware supports only a stop threshold, set the start
49 value to 0. Configured charge thresholds will be restored at
50 the next boot or by using tlp setcharge again but without the
51 threshold arguments.
52 fullcharge [BAT0|BAT1|BATx|CMB0]
54 Charge the battery to full capacity. This is done by applying
55 vendor presets to the charge thresholds temporarily. Configured
56 charge thresholds will be restored at the next boot or by using
57 tlp setcharge without the threshold arguments.
58 chargeonce [BAT0|BAT1] (ThinkPads only)
60 Charge the battery to the stop charge threshold once. This is
61 done by temporarily lifting the start charge threshold. The
62 configured start charge threshold will be restored at the next
63 boot or by using tlp setcharge without the threshold arguments.
64 discharge [BAT0|BAT1] (ThinkPads only)
66 Force complete discharge of the battery.
67 recalibrate [BAT0|BAT1] (ThinkPads only)
69 Battery recalibration: completely discharge the battery and
70 recharge to 100%. The latter is done by temporarily applying
71 vendor presets to the thresholds. Configured thresholds will be
72 restored at the next boot or by using tlp setcharge.
73 diskid Show disk ids for configuration.
75 -- CONFIG_PARAM=value ...
77 Add configuration parameters to temporarily overwrite the system
78 configuration (for this program invocation only).
79
81 For laptops with more than one battery the selection works as follows:
82 BAT0 - Main or internal battery
84 BAT1 - Secondary or replaceable battery
86
88 Change thresholds of the main battery to 70 / 90% temporarily:
89 tlp setcharge 70 90 BAT0
91 Charge the auxiliary battery to full capacity:
93 tlp fullcharge BAT1
95 Recalibrate the main battery:
97 tlp recalibrate BAT0
99
101 /etc/tlp.conf
102 System-wide user configuration file, uncomment parameters here
103 to override default settings and customization files below.
104 /etc/tlp.d/*.conf
106 System-wide drop-in customization files, overriding defaults be‐
107 low.
108 /usr/share/tlp/defaults.conf
110 Intrinsic default settings. DO NOT EDIT this file, instead use
111 one of the above alternatives.
112 /run/tlp/run.conf
114 Effective settings consolidated from all above files. DO NOT
115 CHANGE this file, it is for reference only and regenerated on
116 every invocation of TLP.
117 /etc/default/tlp
119 Obsolete system-wide configuration file. DO NOT USE this file,
120 it is evaluated only when /etc/tlp.conf is non-existent.
121
123 On success, 0 is returned, a non-zero failure code otherwise.
124
126 tlp-stat(8), bluetooth(1), wifi(1), wwan(1).
127 Project homepage: ⟨https://linrunner.de/tlp⟩
129 Charge thresholds: ⟨https://linrunner.de/tlp/settings/battery.html⟩
131
133 (c) 2021 Thomas Koch <linrunner at gmx.net>
134TLP 1.4.0 2021-09-24 tlp(8)