Bluetooth

BT-01 // BLUETOOTH

omfreebdy manages Bluetooth via bluetui — a terminal UI — falling back to bluetoothctl if bluetui is not installed.

Opening the Bluetooth Manager

Press ⌘ + Ctrl + B to open bluetui in a terminal window.

Or launch it directly:

bluetui
# or
bluetoothctl

FreeBSD Bluetooth Stack

Ensure the Bluetooth kernel modules are loaded:

# Load Bluetooth support
kldload ng_ubt    # USB Bluetooth adapter
kldload ng_hci
kldload ng_l2cap
kldload ng_btsocket

# Enable in /etc/rc.conf for persistence
sysrc hcsecd_enable=YES
sysrc sdpd_enable=YES

# Start services
service hcsecd start
service sdpd start

Pairing a Device

In bluetui:

1. Power on the adapter with p
2. Start scanning with s
3. Select the device and press Enter to pair
4. Confirm the pairing PIN if prompted

With bluetoothctl:

bluetoothctl
> power on
> scan on
> pair AA:BB:CC:DD:EE:FF
> connect AA:BB:CC:DD:EE:FF
> trust AA:BB:CC:DD:EE:FF

Bluetooth Audio

Bluetooth audio requires virtual_oss to route the Bluetooth sink into the OSS audio stack. See the Audio page for virtual_oss configuration.

Once configured, Bluetooth headphones appear as a standard OSS device and work with all applications without additional setup.

For A2DP (high-quality audio), the bt_coexist sysctl may improve performance on systems with combined WiFi/BT chipsets: sysctl net.bluetooth.hci.bt_coexist=1

Troubleshooting

# Check adapter is detected
usbconfig list
dmesg | grep ubt

# Check HCI state
hccontrol -n ubt0hci read_bd_addr

# Restart Bluetooth services
service hcsecd restart
service sdpd restart