USB

Scope:

  • Attached and subsequently plugged USB devices

USB_AUTOSUSPEND

USB_AUTOSUSPEND=1

Set autosuspend mode for USB devices on boot and when plugged. Possible values:

  • 1 – enable

  • 0 – disable

Default when unconfigured: 1

USB_DENYLIST

Important

All input devices (driver usbhid), libsane-supported scanners and audio devices get excluded by default. It’s therefore unnecessary to put them on the USB_DENYLIST. To circumvent the default for certain devices enter the IDs into USB_ALLOWLIST.

USB_DENYLIST="1111:2222 3333:4444"

Exclude USB device IDs from autosuspend mode. Useful for devices having difficulties in waking up from autosuspend. Use tlp-stat -u to determine IDs. Multiple IDs are separated with blanks.

USB_EXCLUDE_AUDIO

USB_EXCLUDE_AUDIO=1

Exclude audio devices from autosuspend mode:

  • 0 – do not exclude

  • 1 – exclude

Default when unconfigured: 1

USB_EXCLUDE_BTUSB

USB_EXCLUDE_BTUSB=1

Exclude bluetooth devices from autosuspend mode:

  • 0 – do not exclude

  • 1 – exclude

Default when unconfigured: 0

Note

This feature is intended to solve stability issues with bluetooth connections.

See also

USB_EXCLUDE_BTUSB=1 does not disable autosuspend

USB_EXCLUDE_PHONE

USB_EXCLUDE_PHONE=1

Exclude smartphones from autosuspend mode to enable charging:

  • 0 – do not exclude

  • 1 – exclude

Default when unconfigured: 0

USB_EXCLUDE_PRINTER

USB_EXCLUDE_PRINTER=1

Exclude printers from autosuspend mode:

  • 0 – do not exclude

  • 1 – exclude

Default when unconfigured: 1

USB_EXCLUDE_WWAN

USB_EXCLUDE_WWAN=0

Exclude builtin WWAN devices from autosuspend mode:

  • 0 – do not exclude

  • 1 – exclude

Default when unconfigured: 0

Note

This feature is implemented by an internal denylist currently matching cards from Qualcomm, Ericsson and Sierra. Enter WWAN devices not recognized into USB_DENYLIST.

USB_ALLOWLIST

USB_ALLOWLIST="5555:6666 7777:8888"

Re-enable autosuspend mode for USB device IDs already excluded by any of the settings above (allowlist always wins). Use tlp-stat -u to determine IDs. Multiple IDs are separated with blanks.

USB_AUTOSUSPEND_DISABLE_ON_SHUTDOWN

This parameter was removed in version 1.7

USB_AUTOSUSPEND_DISABLE_ON_SHUTDOWN=1

Disables USB autosuspend mode upon system shutdown. This is intended as a workaround if suspended USB devices disturb the shutdown process.

Default when unconfigured: 0

See also