Bluetooth Usage
This guide explains how to connect, pair, and use Bluetooth devices on Radxa boards.
- Graphical Interface
- Command Line
Manage Bluetooth devices using the system's built-in Bluetooth management tool.
- Enable Bluetooth
①: Click the System Settings icon
②: Click the Bluetooth option
③: Click the Enable option to turn on Bluetooth
- Connect to a Bluetooth Device
①: Click the Add ... option to automatically scan for nearby Bluetooth devices
②: Find the Bluetooth device you want to connect to in the list of nearby devices
③: Click the Next option to connect to the Bluetooth device
- Pair Bluetooth Device
During the Bluetooth device connection process, you need to pair the devices. Follow the on-screen prompts to complete the pairing operation.
- Connection Successful
After successfully connecting to the Bluetooth device, the system will display a confirmation message.
Manage Bluetooth devices using the command line.
- Start Bluetooth Service
sudo systemctl start bluetooth
- Enable on Boot
sudo systemctl enable bluetooth
- Check Service Status
sudo systemctl status bluetooth
- Connect and Pair Bluetooth Devices
Use the bluetoothctl command-line tool to manage Bluetooth devices.
Enter bluetoothctl in the terminal to enter the interactive command-line interface.
To exit the bluetoothctl command-line interface, type exit.
bluetoothctl
- Turn on Bluetooth Adapter
In the bluetoothctl interactive command-line interface, enter power on to turn on Bluetooth.
power on
- Enable Agent
In the bluetoothctl interactive command-line interface, enter agent on to enable the agent.
agent on
- Scan for Bluetooth Devices
In the bluetoothctl interactive command-line interface, enter scan on to scan for Bluetooth devices.
scan on
Scanned Bluetooth devices will appear in the terminal with their physical address and name, similar to the following output: where EC:30:B3:40:0A:20 is the device's physical address, and Redmi K50 Ultra is the device's name.
[NEW] Device EC:30:B3:40:0A:20 Redmi K50 Ultra
- Stop Scanning
If you don't stop scanning, the bluetoothctl interface will remain in scanning mode. It's recommended to scan a few times, then stop scanning and find the physical address of the Bluetooth device you want to connect to.
scan off
- Pair Device
In the bluetoothctl interactive command-line interface, enter pair <device_address> to pair with a Bluetooth device. The pairing process requires manual confirmation; follow the prompts on your Bluetooth device.
pair <device_address>
# Example
pair EC:30:B3:40:0A:20
- Trust Device
trust <device_address>
# Example
trust EC:30:B3:40:0A:20
- Connect to Device
In the bluetoothctl interactive command-line interface, enter connect <device_address> to connect to the Bluetooth device.
connect <device_address>
# Example
connect EC:30:B3:40:0A:20
- Disconnect Device
In the bluetoothctl interactive command-line interface, enter disconnect <device_address> to disconnect from the Bluetooth device.
disconnect <device_address>
# Example
disconnect EC:30:B3:40:0A:20
- Unpair Device
remove <device_address>
# Example
remove EC:30:B3:40:0A:20
- Turn off Bluetooth Adapter
power off