1tlp(8)                         Power Management                         tlp(8)
2
3
4

NAME

6       tlp - apply laptop power saving settings
7

SYNOPSIS

9       tlp command [parameters] [-- CONFIG_PARAM=value ... ]
10

DESCRIPTION

12       tlp  applies  power  saving settings manually and controls battery care
13       features.
14

COMMANDS

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

NOTES

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

EXAMPLES

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

FILES

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

EXIT STATUS

124       On success, 0 is returned, a non-zero failure code otherwise.
125

SEE ALSO

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

AUTHOR

134       (c) 2022 Thomas Koch <linrunner at gmx.net>
135
136
137
138TLP 1.5.0                         2021-12-18                            tlp(8)