Difference between revisions of "TLP"

From ArchWiki
Jump to: navigation, search
m (Installation: better grammar)
 
(107 intermediate revisions by 38 users not shown)
Line 1: Line 1:
 
[[Category:Power management]]
 
[[Category:Power management]]
'''TLP''' is a set of scripts that bring you the benefits of advanced power management for Linux without the need to understand every technical detail. The default configuration provides optimized power saving out of the box.
+
[[ja:TLP]]
 +
{{Related articles start}}
 +
{{Related|Laptop}}
 +
{{Related|Laptop Mode Tools}}
 +
{{Related articles end}}
  
It was originally written by linrunner for Ubuntu. {{aur|tlp}} is available in the AUR.
+
From the [http://linrunner.de/en/tlp/tlp.html project page]:
+
Settings depending on the power source ac/bat:
+
* Kernel laptop mode, dirty buffer params and file system commit timeout
+
* Power aware process scheduler for multi-core/multi-threading
+
* Hard disk advanced power magement level (per disk)
+
* SATA aggressive link power management (ALPM)
+
* PCI Express active state power management (PCIe ASPM) - Kernel 2.6.35 and above
+
* Runtime power management for pci/spi/i2c bus devices - Kernel 2.6.35 and above
+
* Radeon graphics KMS power management - Kernel 2.6.35 and above, not fglrx
+
* Wifi power saving mode -  depending on kernel/driver
+
* Power off optical drive in drive bay (on battery)
+
  
Additional functions:
+
:TLP brings you the benefits of advanced power management for Linux without the need to understand every technical detail. TLP comes with a default configuration already optimized for battery life, so you may just install and forget it. Nevertheless TLP is highly customizable to fulfill your specific requirements.
* Hard disk spin down timeout and I/O scheduler (per disk)
+
* USB autosuspend with blacklist
+
* Audio power saving mode - hda_intel, ac97
+
* Disable Wifi, bluetooth or WWAN devices upon system startup and shutdown
+
* Disable Wake On LAN
+
* WWAN state is restored after suspend/hibernate
+
* Untervolting of Intel processors - requires kernel with PHC-Patch
+
* Battery charge thresholds - ThinkPads only
+
* Recalibrate battery - ThinkPads only
+
  
 
== Installation ==
 
== Installation ==
Just install it from the [https://aur.archlinux.org/packages.php?ID=48464l AUR].  
+
 
After successful installation, you can start TLP by typing ''as root/with sudo'':
+
[[Install]] {{Pkg|tlp}} from the [[official repositories]] - pay attention to its optional dependencies that may help provide additional power saving.
tlp start
+
 
To start TLP as a daemon, add '''tlp''' to the DAEMONS section in {{ic|/etc/rc.conf}}
+
To complete TLP's install, you must [[enable]] the systemd services {{ic|tlp.service}} and {{ic|tlp-sleep.service}}. You should also [[disable]] the systemd service {{ic|systemd-rfkill.service}} to avoid conflicts and assure proper operation of TLP's radio device switching options.
DAEMONS=( ... '''tlp''' ...)
+
 
 +
{{Note|{{ic|tlp.service}} starts {{ic|NetworkManager.service}} if it is available: {{bug|43733}}. If you use a different [[List_of_applications#Network_managers|network manager]], [[Systemd#Editing provided units|edit]] {{ic|tlp.service}}in order to remove the service (line {{ic|1=Wants=}}) or [[mask]] it.}}
 +
 
 +
=== ThinkPads only ===
 +
For advanced battery functions, i.e. charge thresholds and recalibration, install the following package(s):
 +
* {{Pkg|tp_smapi}} – needed for X220, T420 and older models
 +
* {{Pkg|acpi_call}} – needed for X220, T420 and newer models
 +
 
 +
== Start ==
 +
 
 +
After installation TLP will be automatically activated upon system start. To start it immediately without reboot or to apply changed settings, use:
 +
 
 +
# tlp start
  
 
== Configuration ==
 
== Configuration ==
The config-file is located at {{ic|/etc/default/tlp}}. A full list of options is documented here: [https://github.com/linrunner/TLP/wiki/TLP-Configuration TLP Configuration]. To make use of the battery-related options, install and configure [[Tp_smapi]].
 
  
== Kernel 2.6.39 ==
+
The configuration file is located at {{ic|/etc/default/tlp}} and provides a "largely" optimized power saving by default. For a full explanation of options see: [http://linrunner.de/en/tlp/docs/tlp-configuration.html TLP configuration]. 
According to this [https://bbs.archlinux.org/viewtopic.php?pid=946633 thread], the kernel 2.6.39 does not allow user-settings to
+
 
/sys/module/pcie_aspm/parameters/policy
+
=== btrfs ===
You can use PCIe ASPM settings by starting the kernel with
+
 
pcie_aspm=force
+
To avoid filesystem corruption on btrfs formatted partitions, set:
== Wi-Fi ==
+
 
Some Intel Wi-Fi cards require to set their powersaving options '''after''' establishing connection. Therefore the original version of TLP adds a script to {{ic|/etc/network/if-up.d/}}, which itself calls (''as root'')
+
SATA_LINKPWR_ON_BAT=max_performance
tlp wifi $IFACE
+
 
where '''$IFACE''' is the current Interface (e.g. wlan0). In Arch Linux, there is no such possibility by default. If you own a wifi card, which is not supported out of the box, please use the post-up methods of your preferred networking manager (like [[netcfg]] oder [[NetworkManager]]).
+
See also these links for discussion on this topic: [https://github.com/linrunner/TLP/issues/128 Github bug report], [https://www.reddit.com/r/archlinux/comments/4f5xvh/saving_power_is_the_btrfs_dataloss_warning_still/ Reddit follow-up discussion].
If TLP sets the powersaving options properly on ac-state changed, you do not need to change anything. Check this, by issuing the following command twice, before and after unplugging your ac adapter:
+
 
iwconfig | grep "Power Management"
+
=== Radio Device Wizard ===
 +
 
 +
The Radio Device Wizard allows a more sophisticated management of radio devices depending on network connect/disconnect events. It requires [[NetworkManager]], {{Pkg|tlp-rdw}} and [[enabling]] {{ic|NetworkManager-dispatcher.service}}.
 +
 
 +
See [http://linrunner.de/en/tlp/docs/tlp-configuration.html#rdw TLP configuration] for details.
 +
 
 +
=== Command line ===
 +
 
 +
TLP provides several command line tools. See [http://linrunner.de/en/tlp/docs/tlp-linux-advanced-power-management.html#commands TLP commands].
 +
 
 +
== Features intentionally excluded ==
  
=== NetworkManager ===
+
* Fan control. See [[Fan speed control]] and [[Thinkpad Fan Control]]
linrunner has created a little script for NetworkManager , which sets the the Powersaving options. It should be located in {{ic|/etc/NetworkManager/dispatcher.d/02_tlp-ifup}}. Again, if everything is working ok, you do not need to add this script!
+
  
#!/bin/sh
+
* Backlight brightness. See [[Backlight]]
# tlp - ifup hook
+
[ -n "$1" ] || exit 0
+
+
IWC=iwconfig
+
TLP=/usr/sbin/tlp
+
[ -x $TLP ] || exit 0
+
+
IFACE="$1"
+
case "$2" in
+
    up)
+
        if [ -z $($IWC $IFACE 2>&1 | grep "no wireless extensions") ]; then
+
            # interface is wifi
+
            $TLP wifi $IFACE
+
        elif [ "${IFACE#usb}" != "$IFACE" -o "${IFACE#hso}" != "$IFACE" -o "${IFACE#ppp}" != "$IFACE" ]; then
+
            # interface is (probably) wwan
+
            $TLP usb
+
        fi
+
        ;;
+
       
+
    *) # do nothing
+
        ;;
+
esac
+
exit 0
+
  
=== netcfg ===
+
== See also ==
Just add
+
POST_UP=tlp wifi $INTERFACE
+
to the config-file.
+
  
== External Links ==
+
* [http://linrunner.de/tlp TLP - Linux Advanced Power Management] - Project homepage & documentation.
* [https://github.com/linrunner/TLP/wiki/TLP-Linux-Advanced-Power-Management TLP Documentation]
+
* [https://github.com/linrunner/TLP/wiki/TLP-Configuration TLP Configuration] - Settings
+
* [https://github.com/linrunner/TLP/blob/master/debian/changelog TLP Changelog]
+
* [https://github.com/linrunner/TLP/wiki/TLP-Developer-Documentation TLP Developer Documentation]
+
* [http://thinkpad-wiki.org/TLP_-_Linux_Stromsparen TLP - Linux Stromsparen] – Dokumentation in deutsch
+

Latest revision as of 17:13, 16 May 2016

Related articles

From the project page:

TLP brings you the benefits of advanced power management for Linux without the need to understand every technical detail. TLP comes with a default configuration already optimized for battery life, so you may just install and forget it. Nevertheless TLP is highly customizable to fulfill your specific requirements.

Installation

Install tlp from the official repositories - pay attention to its optional dependencies that may help provide additional power saving.

To complete TLP's install, you must enable the systemd services tlp.service and tlp-sleep.service. You should also disable the systemd service systemd-rfkill.service to avoid conflicts and assure proper operation of TLP's radio device switching options.

Note: tlp.service starts NetworkManager.service if it is available: FS#43733. If you use a different network manager, edit tlp.servicein order to remove the service (line Wants=) or mask it.

ThinkPads only

For advanced battery functions, i.e. charge thresholds and recalibration, install the following package(s):

  • tp_smapi – needed for X220, T420 and older models
  • acpi_call – needed for X220, T420 and newer models

Start

After installation TLP will be automatically activated upon system start. To start it immediately without reboot or to apply changed settings, use:

# tlp start

Configuration

The configuration file is located at /etc/default/tlp and provides a "largely" optimized power saving by default. For a full explanation of options see: TLP configuration.

btrfs

To avoid filesystem corruption on btrfs formatted partitions, set:

SATA_LINKPWR_ON_BAT=max_performance

See also these links for discussion on this topic: Github bug report, Reddit follow-up discussion.

Radio Device Wizard

The Radio Device Wizard allows a more sophisticated management of radio devices depending on network connect/disconnect events. It requires NetworkManager, tlp-rdw and enabling NetworkManager-dispatcher.service.

See TLP configuration for details.

Command line

TLP provides several command line tools. See TLP commands.

Features intentionally excluded

See also