Jump to content

# TLP

2 languages

- 日本語
- 中文（简体）

From ArchWiki

Related articles

- Laptop
- Laptop Mode Tools
- Powertop

From the project page:

  TLP is a feature-rich command line utility for Linux, saving laptop battery power without the need to delve deeper into technical details.

  TLP’s default settings are already optimized for battery life and implement Powertop’s recommendations out of the box. So you may just install and forget it.

  Nevertheless TLP is highly customizable to fulfil your specific requirements.

TLP intentionally excludes some settings from the project, notably Fan speed control and Backlight.

## Installation

Install the tlp package. Installing the optional dependencies may help provide additional power saving.

Enable/start `tlp.service`.

One should also mask the service `systemd-rfkill.service` and socket `systemd-rfkill.socket` to avoid conflicts and ensure proper operation of TLP's radio device switching options.

### Radio Device Wizard (tlp-rdw)

When using the Radio Device Wizard (tlp-rdw), it is required to use NetworkManager and enabling `NetworkManager-dispatcher.service`.

See TLP settings for details.

### Front end

- tlpuiAUR is a GTK user interface for TLP written in Python.
- slimbookbatteryAUR is a different GTK interface that works with additional drivers like AMD and NVIDIA.

### ThinkPads only

Controlling the charge thresholds using D-Bus without root privileges is possible using threshyAUR and its example Qt user interface threshy-guiAUR.

#### Before Sandy Bridge (until 2010)

For ThinkPads before model year 2011, the tp_smapi kernel module is required. See tp_smapi#Installation for kernel-specific installation instructions.

## Configuration

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

### USB autosuspend

When starting TLP with the default configuration, some USB devices such as audio DACs will be powered down when running on battery due to TLP's autosuspend feature. Some devices such as keyboards and scanners are blacklisted from autosuspend by default.

You may simply want to disable USB autosuspend entirely with the following setting:

    /etc/tlp.conf

    # Do not suspend USB devices
    USB_AUTOSUSPEND=0

Or blacklist specific devices from being auto-suspended. See the TLP documentation on USB devices for details.

### Force battery (BAT) configuration

When no power supply can be detected, the setting for AC will be used on devices like desktops and embedded hardware.

You may want to force the battery (BAT) settings when using TLP on these devices to enable more power saving:

    /etc/tlp.conf

    # Operation mode when no power supply can be detected: AC, BAT.
    TLP_DEFAULT_MODE=BAT

    # Operation mode select: 0=depend on power source, 1=always use TLP_DEFAULT_MODE
    TLP_PERSISTENT_DEFAULT=1

### Bumblebee with NVIDIA driver

If you are running Bumblebee with NVIDIA driver, you need to disable power management for the GPU in TLP in order to make Bumblebee control the power of the GPU.

Depending on the driver(s) that you are using, blacklist one or more of them, preventing TLP from managing their power state:

    /etc/tlp.conf

    RUNTIME_PM_DRIVER_DENYLIST="nouveau nvidia"

### PCI(e) runtime power management on AC

Enabling runtime power management for PCI(e) bus devices while on AC may improve power saving on some laptops. This is enabled by default on battery, but not on AC. To enable on AC, set:

    /etc/tlp.conf

    RUNTIME_PM_ON_AC=auto

### Command line

TLP provides several command line tools. See TLP commands.

## Troubleshooting

For debugging you can display information about the currently used Mode(AC/BAT) and applied configurations:

    # tlp-stat

See also the upstream troubleshooting guide.

### hci0: link tx timeout

If your bluetooth headphones suddenly stop working and you see this error from dmesg, it may be caused by TLP suspending your device. Add device ID to `USB_DENYLIST` in `/etc/tlp.conf`:

    # Disable bluetooth autosuspend
    USB_DENYLIST="8087:0aaa"

Get the device ID for your bluetooth device from `lsusb -v`. Restart TLP and the `bluetooth` service.

## See also

- TLP - Optimize Linux Laptop Battery Life — Project homepage & documentation
- Project FAQ

Category:

- Power management