Difference between revisions of "TLP"

From ArchWiki
Jump to: navigation, search
(removed the part to restart after standby, as it didn't work for me)
(ThinkPads only: remove template, updated)
 
(99 intermediate revisions by 33 users not shown)
Line 1: Line 1:
 
[[Category:Power management]]
 
[[Category:Power management]]
'''TLP''' is an advanced power management tool for Linux. It is a pure command line tool with
+
[[ja:TLP]]
automated background tasks and does not contain a GUI.
+
{{Related articles start}}
 +
{{Related|Laptop}}
 +
{{Related|Laptop Mode Tools}}
 +
{{Related articles end}}
  
TLP is available in the AUR: {{aur|tlp}}, {{aur|tlp-rdw}}.  
+
From the [http://linrunner.de/en/tlp/tlp.html project page]:
  
== Features ==
+
: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.
Read the the full documentation at the [http://linrunner.de/tlp project homepage].
+
  
 
== Installation ==
 
== Installation ==
Install the following packages plus dependencies:
 
* [https://aur.archlinux.org/packages/tlp/ tlp] (AUR) – Power saving
 
* [https://aur.archlinux.org/packages/tlp-rdw/ tlp-rdw] (AUR) – optional, Radio Device Wizard
 
* [[Tp_smapi|tp_smapi]] (Community) – optional ''ThinkPad only'', tp-smapi is needed for battery charge thresholds and ThinkPad specific status output of tlp-stat
 
* [https://aur.archlinux.org/packages/dkms-acpi_call-git/ dkms-acpi_call-git] (AUR) – optional ''ThinkPad only'', acpi_call is needed for battery charge thresholds on Sandy Bridge and newer models (X220/T420, X230/T430 et al.)
 
  
== Start ==
+
[[Install]] {{Pkg|tlp}} from the [[official repositories]] - pay attention to its optional dependencies that may help provide additional power saving.
  
After successful installation, you can start TLP by typing:
+
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.
# systemctl start tlp
+
  
To run TLP automatically upon system startup, enable the service via:
+
{{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.}}
# systemctl enable tlp
+
  
{{Note|The above step is also necessary when upgrading to 0.3.8.1 because the service name changed.}}
+
=== ThinkPads only ===
 +
 
 +
For advanced battery functions, i.e. charge thresholds and recalibration, install the following package(s):
 +
 
 +
* {{Pkg|tp_smapi}} – tp-smapi is needed for battery charge thresholds, recalibration and specific status output of tlp-stat
 +
* {{Pkg|acpi_call}} – acpi-call is needed for battery charge thresholds and recalibration on Sandy Bridge and newer models (X220/T420, X230/T430 et al.)
 +
 
 +
See the TLP FAQ, section [http://linrunner.de/en/tlp/docs/tlp-faq.html#kernmod "Which kernel module?"], for details.
 +
 
 +
== 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}}.
 
  
The default configuration provides optimized power saving out of the box. For a full list of options see: [http://linrunner.de/en/tlp/docs/tlp-configuration.html TLP Configuration].  
+
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].
 +
 
 +
=== 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: [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].
 +
 
 +
=== 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 ==
 +
 
 +
* Fan control. See [[Fan speed control]] and [[Thinkpad Fan Control]]
  
To make use of the ThinkPad-specific battery options, install and configure [[Tp_smapi|tp_smapi]] and/or [https://aur.archlinux.org/packages/dkms-acpi_call-git/ acpi_call] (see [[TLP#Installation|Installation]]).
+
* Backlight brightness. See [[Backlight]]
  
== Kernel 2.6.39 ==
+
== See also ==
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
+
You can use PCIe ASPM settings by starting the kernel with
+
pcie_aspm=force
+
  
== External Links ==
+
* [http://linrunner.de/tlp TLP - Linux Advanced Power Management] - Project homepage & documentation.
* [http://linrunner.de/tlp TLP - Linux Advanced Power Management] - Project homepage & documentation
+

Latest revision as of 12:07, 18 September 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 – tp-smapi is needed for battery charge thresholds, recalibration and specific status output of tlp-stat
  • acpi_call – acpi-call is needed for battery charge thresholds and recalibration on Sandy Bridge and newer models (X220/T420, X230/T430 et al.)

See the TLP FAQ, section "Which kernel module?", for details.

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