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

NAME

6       tlp - apply laptop power saving settings
7

SYNOPSIS

9       tlp command [parameters] [-- <config> ... ]
10

DESCRIPTION

12       Apply  power saving settings manually and control ThinkPad battery fea‐
13       tures.
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
19       bat    Apply power saving settings for battery power source.
20
21       true   Same as bat.
22
23       ac     Apply power saving settings for AC power source.
24
25       false  Same as ac.
26
27       usb    Enable autosuspend for all USB devices, except blacklisted ones.
28
29       bayoff Turn  off  optical drive in UltraBay/MediaBay.  The drive may be
30              re-enabled by pulling the eject lever or pushing the media eject
31              button on newer models.
32
33       setcharge [START_CHARGE STOP_CHARGE] [BAT0|BAT1] (ThinkPads only)
34              Set charge thresholds of main (BAT0) or auxiliary (BAT1) battery
35              temporarily.  Values must be between  1  and  100,  START_CHARGE
36              must  not  exceed  STOP_CHARGE  -  4.  Configured thresholds are
37              restored upon next system boot-up.  When  called  without  argu‐
38              ments, configured thresholds are set.
39
40       fullcharge [BAT0|BAT1] (ThinkPads only)
41              Set charge thresholds of main (BAT0) or auxiliary (BAT1) battery
42              to factory presets (96/100) temporarily (causing a full charge).
43              Configured thresholds are restored upon next system boot-up.
44
45       chargeonce [BAT0|BAT1] (ThinkPads only)
46              Charge  main  (BAT0)  or  auxiliary  (BAT1)  battery to the stop
47              charge threshold once (bypassing start  threshold).   Configured
48              thresholds are restored upon next system boot-up.
49
50       discharge [BAT0|BAT1] (ThinkPads only)
51              Force complete discharge of main (BAT0) or auxiliary (BAT1) bat‐
52              tery.
53
54       recalibrate [BAT0|BAT1] (ThinkPads only)
55              Battery recalibration: completely discharge main (BAT0) or  aux‐
56              iliary (BAT1) battery and recharge to 100%.
57
58       diskid Show disk ids for configuration.
59
60       -- PARAM=value ...
61              Add parameters to temporarily overwrite the system configuration
62              (for this program invocation only).
63

NOTES

65       For ThinkPads with more than one battery the selection  works  as  fol‐
66       lows:
67
68              BAT0 - Main or internal battery
69
70              BAT1 - Ultrabay, Slice or replaceable battery
71

EXAMPLES

73       Apply thresholds of 70 / 90% to the main battery:
74
75              tlp setcharge 70 90 BAT0
76
77       Charge the auxiliary battery to full capacity:
78
79              tlp fullcharge BAT1
80
81       Recalibrate the main battery:
82
83              tlp recalibrate BAT0
84

FILES

86       /etc/tlp.conf
87              System-wide  user  configuration file, uncomment parameters here
88              to override default settings and customization files below.
89
90       /etc/tlp.d/*.conf
91              System-wide drop-in  customization  files,  overriding  defaults
92              below.
93
94       /usr/share/tlp/defaults.conf
95              Intrinsic  default  settings. DO NOT EDIT this file, instead use
96              one of the above alternatives.
97
98       /run/tlp/run.conf
99              Effective settings consolidated from all  above  files.  DO  NOT
100              CHANGE  this  file,  it is for reference only and regenerated on
101              every invocation of TLP.
102
103       /etc/default/tlp
104              Obsolete system-wide configuration file. DO NOT USE  this  file,
105              it is evaluated only when /etc/tlp.conf is non-existent.
106

EXIT STATUS

108       On success, 0 is returned, a non-zero failure code otherwise.
109

SEE ALSO

111       tlp-stat(8), bluetooth(1), wifi(1), wwan(1).
112
113       Project homepage: ⟨https://linrunner.de⟩
114

AUTHOR

116       (c) 2020 Thomas Koch <linrunner at gmx.net>
117
118
119
120TLP 1.3.0                         2020-01-31                            tlp(8)