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