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 temporarily overwrite the system
78              configuration (for this program invocation only).
79

NOTES

81       For laptops with more than one battery the selection works as follows:
82
83              BAT0 - Main or internal battery
84
85              BAT1 - Secondary or replaceable battery
86

EXAMPLES

88       Change thresholds of the main battery to 70 / 90% temporarily:
89
90              tlp setcharge 70 90 BAT0
91
92       Charge the auxiliary battery to full capacity:
93
94              tlp fullcharge BAT1
95
96       Recalibrate the main battery:
97
98              tlp recalibrate BAT0
99

FILES

101       /etc/tlp.conf
102              System-wide user configuration file, uncomment  parameters  here
103              to override default settings and customization files below.
104
105       /etc/tlp.d/*.conf
106              System-wide drop-in customization files, overriding defaults be‐
107              low.
108
109       /usr/share/tlp/defaults.conf
110              Intrinsic default settings. DO NOT EDIT this file,  instead  use
111              one of the above alternatives.
112
113       /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
118       /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

EXIT STATUS

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

SEE ALSO

126       tlp-stat(8), bluetooth(1), wifi(1), wwan(1).
127
128       Project homepage: ⟨https://linrunner.de/tlp
129
130       Charge thresholds: ⟨https://linrunner.de/tlp/settings/battery.html
131

AUTHOR

133       (c) 2021 Thomas Koch <linrunner at gmx.net>
134
135
136
137TLP 1.4.0                         2021-09-24                            tlp(8)
Impressum