.TH tlp 8 2020-01-31 "TLP 1.3.0" "Power Management"
.
.SH NAME
tlp \- apply laptop power saving settings
.
.SH SYNOPSIS
.B tlp \fIcommand\fR \fR[\fIparameters\fR] [-- <config> "..."]
.
.SH DESCRIPTION
Apply power saving settings manually and control ThinkPad battery features.
.
.SH COMMANDS
.
.TP
.B start
Initialize \fBtlp\fR and apply power saving settings according to the actual
power source. Also use to apply a changed configuration.
.
.TP
.B bat
Apply power saving settings for battery power source.
.
.TP
.B true
Same as \fBbat\fR.
.
.TP
.B ac
Apply power saving settings for AC power source.
.
.TP
.B false
Same as \fBac\fR.
.
.TP
.B usb
Enable autosuspend for all USB devices, except blacklisted ones.
.
.TP
.B bayoff
Turn off optical drive in UltraBay/MediaBay.
The drive may be re\-enabled by pulling the eject lever or pushing the media
eject button on newer models.
.
.TP
.B setcharge [START_CHARGE STOP_CHARGE] [BAT0|BAT1] \fR(ThinkPads only)
Set charge thresholds of main (BAT0) or auxiliary (BAT1) battery temporarily.
Values must be between 1 and 100, START_CHARGE must not exceed STOP_CHARGE - 4.
Configured thresholds are restored upon next system boot-up. When called without
arguments, configured thresholds are set.
.
.TP
.B fullcharge [BAT0|BAT1] \fR(ThinkPads only)
Set charge thresholds of main (BAT0) or auxiliary (BAT1) battery to factory
presets (96/100) temporarily (causing a full charge).
Configured thresholds are restored upon next system boot-up.
.
.TP
.B chargeonce [BAT0|BAT1] \fR(ThinkPads only)
Charge main (BAT0) or auxiliary (BAT1) battery to the stop charge threshold once
(bypassing start threshold).
Configured thresholds are restored upon next system boot-up.
.
.TP
.B discharge [BAT0|BAT1] \fR(ThinkPads only)
Force complete discharge of main (BAT0) or auxiliary (BAT1) battery.
.
.TP
.B recalibrate [BAT0|BAT1] \fR(ThinkPads only)
Battery recalibration: completely discharge main (BAT0) or auxiliary (BAT1)
battery and recharge to 100%.
.
.TP
.B diskid
Show disk ids for configuration.
.
.TP
.B \-- PARAM=value "..."
Add parameters to temporarily overwrite the system configuration
(for this program invocation only).
.
.SH NOTES
For ThinkPads with more than one battery the selection works as follows:
.IP
BAT0 \- Main or internal battery
.IP
BAT1 \- Ultrabay, Slice or replaceable battery
.
.SH EXAMPLES
Apply thresholds of 70 / 90% to the main battery:
.IP
tlp setcharge 70 90 BAT0
.PP
Charge the auxiliary battery to full capacity:
.IP
tlp fullcharge BAT1
.PP
Recalibrate the main battery:
.IP
tlp recalibrate BAT0
.
.SH FILES
.I /etc/tlp.conf
.RS
System-wide user configuration file, uncomment parameters here to override
default settings and customization files below.
.PP
.RE
.I /etc/tlp.d/*.conf
.RS
System-wide drop-in customization files, overriding defaults below.
.PP
.RE
.I /usr/share/tlp/defaults.conf
.RS
Intrinsic default settings. DO NOT EDIT this file, instead use one of the above
alternatives.
.PP
.RE
.I /run/tlp/run.conf
.RS
Effective settings consolidated from all above files. DO NOT CHANGE this file,
it is for reference only and regenerated on every invocation of TLP.
.PP
.RE
.I /etc/default/tlp
.RS
Obsolete system-wide configuration file. DO NOT USE this file, it is
evaluated only when /etc/tlp.conf is non-existent.
.
.SH EXIT STATUS
On success, 0 is returned, a non-zero failure code otherwise.
.
.SH SEE ALSO
.BR tlp\-stat (8),
.BR bluetooth (1),
.BR wifi (1),
.BR wwan (1).
.
.PP
.mso www.tmac
.URL "https://linrunner.de" "Project homepage: "
.
.SH AUTHOR
(c) 2020 Thomas Koch <linrunner at gmx.net>