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

This parameter was renamed with version 1.4. Until 1.3 it was called USB_BLACKLIST. 1.4 and newer also recognize the old name.

Important

All input devices (driver usbhid), libsane-supported scanners and (as of version 1.4) 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

Version 1.4 and newer

USB_EXCLUDE_AUDIO=1

Exclude audio devices from autosuspend mode:

0 – do not exclude
1 – exclude

Default when unconfigured: 1

USB_EXCLUDE_BTUSB

This parameter was renamed with version 1.4. Until 1.3 it was called USB_BLACKLIST_BTUSB. 1.4 and newer also recognize the old name.

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.

USB_EXCLUDE_PHONE

This parameter was renamed with version 1.4. Until 1.3 it was called USB_BLACKLIST_PHONE. 1.4 and newer also recognize the old name.

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

This parameter was renamed with version 1.4. Until 1.3 it was called USB_BLACKLIST_PRINTER. 1.4 and newer also recognize the old name.

USB_EXCLUDE_PRINTER=1

Exclude printers from autosuspend mode:

0 – do not exclude
1 – exclude

Default when unconfigured: 1

USB_EXCLUDE_WWAN

This parameter was renamed with version 1.4. Until 1.3 it was called USB_BLACKLIST_WWAN. 1.4 and newer also recognize the old name.

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

This parameter was renamed with version 1.4. Until 1.3 it was called USB_WHITELIST. 1.4 and newer also recognize the old name.

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

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