Skip to content

Commit b287f95

Browse files
authored
bluetooth: Add btusb reload commands (from #1217) (#1246)
1 parent 82b255e commit b287f95

File tree

1 file changed

+22
-10
lines changed

1 file changed

+22
-10
lines changed

content/bluetooth.md

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -106,51 +106,63 @@ Then, run <u>Bluetooth Manager</u>. Check for the device being trusted, and also
106106

107107
### Useful Commands
108108

109+
To show if the Bluetooth module (driver) is loaded, and see what system messages have been logged:
110+
109111
```bash
110112
lsmod | grep bluetooth
111113
dmesg | grep Bluetooth
112114
```
113115

114-
These will show if the Bluetooth module (driver) is loaded, and what the system messages are.
116+
To check if the service that handles Bluetooth is running:
115117

116118
```bash
117119
sudo systemctl status bluetooth
118120
```
119121

120-
This will check to see if the service that handles Bluetooth is running.
122+
To check if Bluetooth or Wireless (Wi-Fi) are software-blocked:
121123

122124
```bash
123125
rfkill list
126+
```
127+
128+
To unblock Bluetooth:
129+
130+
```
124131
sudo rfkill unblock bluetooth
125132
```
126133

127-
If both Bluetooth and Wireless are soft blocked or if the Wireless is soft blocked run this command to unblock:
134+
To unblock all wireless types:
128135

129136
```bash
130137
sudo rfkill unblock all
131138
```
132139

133-
This will check to see Bluetooth is blocked, and if so, unblock it.
134-
135-
*For Pop!\_OS 21.10 or 20.04:*
140+
To manually reload the Bluetooth USB kernel module:
136141

137142
```bash
138-
pactl load-module module-bluetooth-discover
143+
sudo rmmod btusb
144+
sudo modprobe btusb
139145
```
140146

141-
This will load the PulseAudio module responsible for Bluetooth Audio. Typically, it's loaded by default, but sometimes a manual loading can get Bluetooth headsets working again. This module is no longer used on Pop!\_OS 22.04 or higher.
147+
To monitor Bluetooth-related messages (try leaving this command running while pairing or using a device to see any error messages or failures):
142148

143149
```bash
144150
sudo btmon
145151
```
146152

147-
This will show all Bluetooth related messages. Try leaving this command running while pairing or using a device to see any error messages or failures.
153+
To reset the Bluetooth device profiles and require re-pairing all devices (this can help if your Bluetooth audio device is stuck in an HSP/HFP profile and will not switch to A2DP mode after updates <sup>[1](https://github.com/bluez/bluez/issues/157)</sup>):
148154

149155
```bash
150156
sudo rm -r /var/lib/bluetooth/
151157
```
152158

153-
This will reset the Bluetooth device profiles and require re-pairing all devices. This can help if your Bluetooth audio device is stuck in an HSP/HFP profile and will not switch to A2DP mode after updates <sup>[1](https://github.com/bluez/bluez/issues/157)</sup>.
159+
*For Pop!\_OS 21.10 or 20.04:*
160+
161+
Older Pop!\_OS versions used a PulseAudio module for Bluetooth audio. It's typically loaded by default, but sometimes a manual load can get Bluetooth headsets working again:
162+
163+
```bash
164+
pactl load-module module-bluetooth-discover
165+
```
154166

155167
## Additional Info
156168

0 commit comments

Comments
 (0)