Bluez

Tutorials

arch wiki

https://wiki.archlinux.org/index.php/bluetooth

Locations

/etc/bluetooth/main.conf

config

Install

sudo pacman -S bluez bluez-utils
sudo modprobe btusb

sudo systemctl start bluetooth
sudo systemctl enable bluetooth

Usage

General

bluetoothctl
> power on
> scan on             # listen for devices
> devices             # list all discovered devices
> paired-devices      # list all paired devices
> remove ${MAC_ADDR}  # remove a paired device

Pair with Device

bluetoothctl
> power on
> scan on
> agent on
> list

Now adjust your device to pair

pair    ${MAC_ADDRESS}
trust   ${MAC_ADDRESS}
connect ${MAC_ADDRESS}

Configuration

# /etc/bluetooth/main.conf

[Policy]
# power-on on boot
AutoEnable=true

Troubleshooting

Disable ERTM

Required for Xbox One Controller. The following is temporary, make permanent using sysfs.

temporary

sudu -i
echo 1 > /sys/module/bluetooth/parameters/disable_ertm

permanent

# /etc/modprobe.d/xbox_bt.conf

options bluetooth disable_ertm=1