1tlp(8) Power Management tlp(8)
2
3
4
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
20 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
25 true Same as bat.
26
27 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
31 false Same as ac.
32
33 usb Enable autosuspend for all USB devices except those excluded by
34 default or in the configuration.
35
36 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
40 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
45 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
53 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
59 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
65 discharge [BAT0|BAT1] (ThinkPads only)
66 Force complete discharge of the battery.
67
68 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
74 diskid Show disk ids for configuration.
75
76 -- CONFIG_PARAM=value ...
77 Add configuration parameters to override the system configura‐
78 tion for this single program invocation only. They are not kept
79 afterwards.
80
82 For laptops with more than one battery the selection works as follows:
83
84 BAT0 - Main or internal battery
85
86 BAT1 - Secondary or replaceable battery
87
89 Change thresholds of the main battery to 70 / 90% temporarily:
90
91 tlp setcharge 70 90 BAT0
92
93 Charge the auxiliary battery to full capacity:
94
95 tlp fullcharge BAT1
96
97 Recalibrate the main battery:
98
99 tlp recalibrate BAT0
100
102 /etc/tlp.conf
103 System-wide user configuration file, uncomment parameters here
104 to override default settings and customization files below.
105
106 /etc/tlp.d/*.conf
107 System-wide drop-in customization files, overriding defaults be‐
108 low.
109
110 /usr/share/tlp/defaults.conf
111 Intrinsic default settings. DO NOT EDIT this file, instead use
112 one of the above alternatives.
113
114 /run/tlp/run.conf
115 Effective settings consolidated from all above files. DO NOT
116 CHANGE this file, it is for reference only and regenerated on
117 every invocation of TLP.
118
119 /etc/default/tlp
120 Obsolete system-wide configuration file. DO NOT USE this file,
121 it is evaluated only when /etc/tlp.conf is non-existent.
122
124 On success, 0 is returned, a non-zero failure code otherwise.
125
127 tlp-stat(8), bluetooth(1), nfc(1), wifi(1), wwan(1).
128
129 Project homepage: ⟨https://linrunner.de/tlp⟩
130
131 Charge thresholds: ⟨https://linrunner.de/tlp/settings/battery.html⟩
132
134 (c) 2022 Thomas Koch <linrunner at gmx.net>
135
136
137
138TLP 1.5.0 2021-12-18 tlp(8)