Radio Device Switching

This section contains settings to switch builtin bluetooth, Wi-Fi and WWAN devices on system boot or shutdown and depending on the power source.

For more event based switching refer to Radio Device Wizard.

RESTORE_DEVICE_STATE_ON_STARTUP

RESTORE_DEVICE_STATE_ON_STARTUP=0

Restores radio device state (builtin Bluetooth, Wi-Fi, WWAN) from previous shutdown on boot:

  • 0 – disable
  • 1 – enable

Default when unconfigured: 0

Important

  • The parameters DEVICES_TO_DISABLE_ON_STARTUP/SHUTDOWN below are ignored when this feature is enabled
  • Debian and Ubuntu packages mask systemd-rfkill.service because it implements identical functionality; to mimic the systemd default behavior, set RESTORE_DEVICE_STATE_ON_STARTUP=1

DEVICES_TO_DISABLE_ON_STARTUP

DEVICES_TO_DISABLE_ON_STARTUP="bluetooth wifi wwan"

Disables builtin radio devices on boot:

  • bluetooth
  • wifi – Wireless LAN (Wi-Fi)
  • wwan – Wireless Wide Area Network (3G/UMTS, 4G/LTE, 5G)

Multiple devices are separated with blanks.

DEVICES_TO_ENABLE_ON_STARTUP

DEVICES_TO_ENABLE_ON_STARTUP="bluetooth wifi wwan"

Linux enables all builtin radio devices by default. In case of exception you can use this setting to enable the missing devices on boot. Possible values are as above.

DEVICES_TO_DISABLE_ON_SHUTDOWN

DEVICES_TO_DISABLE_ON_SHUTDOWN="bluetooth wifi wwan"

Disables builtin radio devices upon system shutdown. May be used as a workaround when enabled radio devices block the shutdown process. Possible values are as above.

DEVICES_TO_ENABLE_ON_SHUTDOWN

DEVICES_TO_ENABLE_ON_SHUTDOWN="bluetooth wifi wwan"

Enables builtin radio devices on shutdown. May be used as a workaround to prevent other operating systems from missing disabled devices. Possible values are as above.

Note

The following settings apply only at the moment where the power source actually changes (from AC to battery or vice versa).

DEVICES_TO_ENABLE_ON_AC

DEVICES_TO_ENABLE_ON_AC="bluetooth wifi wwan"

Enables builtin radio devices when AC power is plugged in. Possible values are as above.

DEVICES_TO_DISABLE_ON_BAT

DEVICES_TO_DISABLE_ON_BAT="bluetooth wifi wwan"

Disables builtin radio devices when changing to battery power regardless of their connection state. Possible values are as above.

DEVICES_TO_DISABLE_ON_BAT_NOT_IN_USE

DEVICES_TO_DISABLE_ON_BAT_NOT_IN_USE="bluetooth wifi wwan"

Disables builtin radio devices that are not connected when changing to battery power. Possible values are as above.

Note

Do not use both DEVICES_TO_DISABLE_ON_BAT and DEVICES_TO_DISABLE_ON_BAT_NOT_IN_USE for the same radio device because DEVICES_TO_DISABLE_ON_BAT always has precendence.

See also

  • rfkill – Kernel framework for switching radio devices