diff options
author | Bastien Nocera <hadess@hadess.net> | 2021-12-14 15:21:47 +0100 |
---|---|---|
committer | Bastien Nocera <hadess@hadess.net> | 2022-01-06 11:11:22 +0100 |
commit | c43f459e5a30b18e61124b004f1cff7db18cffe2 (patch) | |
tree | 4061c1ec82fe6ce25a9b76bdb18dec7b3dcb0f99 /README.md | |
parent | a1c66857a471cf6aa8c9def823bbe477485e6b3e (diff) | |
download | gnome-bluetooth-c43f459e5a30b18e61124b004f1cff7db18cffe2.tar.gz |
README: Explain how to disable a Bluetooth adapter
Explain how to disable a builtin Bluetooth adapter as gnome-bluetooth
only supports one in its UI.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 42 |
1 files changed, 42 insertions, 0 deletions
@@ -10,6 +10,48 @@ Requirements - bluez 5.51 or newer - rfkill sub-system enabled in the kernel, and [accessible](https://github.com/systemd/systemd/pull/21605) +Multiple Bluetooth adapters +--------------------------- + +The gnome-bluetooth user interface and API have no support for handling +multiple Bluetooth adapters. Earlier versions of the bluez backend software +had support for setting a "default adapter" but that is not the case +any more. + +As the goal is usually to disable an internal Bluetooth adapter in favour of +a more featureful removable one, there are a couple of possibilities +to do this, depending on the hardware: + +- Disable the internal Bluetooth adapter in the system's BIOS or firmware + +- Disable the internal adapter through a mechanical "RF kill" switch + available on some laptops + +- Unplug the USB cable from the wireless card in the case of combo Bluetooth/Wi-Fi + desktop cards + +- Enable the hardware-specific software kill switch on laptops. First find out + whether your hardware has one: + +```sh +rfkill | grep bluetooth | grep -v hci +5 bluetooth hp-bluetooth unblocked unblocked +``` + + Then block it with `rfkill block <ID>` where `<ID>` is the identifier in the + command above. systemd will remember this across reboots. + +- Disable a specific USB adapter through udev by creating a + `/etc/udev/rules.d/81-bluetooth-hci.rules` device containing: + +``` +SUBSYSTEM=="usb", ATTRS{idVendor}=="0a5c", ATTRS{idProduct}=="21b4", ATTR{authorized}="0" +``` + +- If the adapter still needs to be plugged in so it can be used as a passthrough, +for virtualisation or gaming, we ship [a small script that makes unbinding the Bluetooth +driver easier](contrib/unbind-bluetooth-driver.sh) + Copyright --------- |