# Perform Bluetooth GAP functions

Note

Bluetooth over M.2E connector isn’t enabled in the 2.0 build.

Perform various Bluetooth General Access Profile (GAP) functions using the commands provided in the main menu of `bluetoothctl`.

To enable Bluetooth on the mezzanine board, see the DIP switch settings in [DIP switch positions and their functions](https://docs.qualcomm.com/doc/80-80022-44/topic/iq8-ifp-ug-hw-overview.html#ifp-dip-switch-table).

## Prerequisites

Set up the device as described in the [Qualcomm Linux Bluetooth Guide](https://docs.qualcomm.com/doc/80-80021-13/topic/bluez-gap.html).

## Enable Bluetooth

To enable Bluetooth on the device, run the following command:

power on
    Copy to clipboard

**Sample output**

[bluetooth]# power on
[CHG] Controller 22:22:F1:C1:99:C0 Class: 0x007c0000
Changing power on succeeded
[CHG] Controller 22:22:F1:C1:99:C0 Powered: yes

## Run Bluetooth inquiry scan

To start an inquiry for nearby devices, run the following command:

scan on

**Sample output**

[bluetooth]# scan on
Discovery started
[CHG] Controller 22:22:9B:2C:79:1E Discovering: yes
[NEW] Device A4:30:7A:EE:AF:EF [TV] MyDeviceA 8 Series (43)
[NEW] Device 7E:08:AE:BC:66:58 7E-08-AE-BC-66-58
[CHG] Device A4:30:7A:EE:AF:EF RSSI: -91
[NEW] Device F8:7D:76:9D:9B:6B MyDeviceB

## Stop Bluetooth inquiry scan

To stop an inquiry that’s in progress, run the following command:

scan off
    Copy to clipboard

**Sample output**

[bluetooth]# scan off
Discovery stopped
[CHG] Controller 8C:FD:F0:21:84:23 Discovering: no

## Pair with a remote Bluetooth device

Before pairing a remote device, run a Bluetooth inquiry scan to ensure that the remote device is available.

To pair with a remote Bluetooth device, run the following command:

pair <bt_address>
    Copy to clipboard

To accept the outgoing/incoming pairing, enter `yes`. To reject the outgoing/incoming pairing, enter `no`.

**Parameters**

`<bt_address>` is the Bluetooth address of the remote device.

**Example**

To pair with a remote device with `<bt_address>` `F8:7D:76:9D:9B:6B`, run the following command:

pair F8:7D:76:9D:9B:6B
    Copy to clipboard

**Sample output**

[bluetooth]# pair F8:7D:76:9D:9B:6B
Attempting to pair with F8:7D:76:9D:9B:6B
[CHG] Device F8:7D:76:9D:9B:6B Connected: yes
[CHG] Device F8:7D:76:9D:9B:6B Name: MyDeviceB
[CHG] Device F8:7D:76:9D:9B:6B Alias: MyDeviceB
[agent] Confirm passkey 068560 (yes/no): yes
[CHG] Device F8:7D:76:9D:9B:6B Bonded: yes
[CHG] Device F8:7D:76:9D:9B:6B Paired: yes
Pairing successful

## Get the bonded/paired device list

To get a verified list of paired devices, run the following command:

devices
    Copy to clipboard

**Sample output**

[bluetooth]# devices
Device F8:7D:76:9D:9B:6B MyDeviceB

## Unpair a device

To unpair a device, run the following command:

remove <bt_address>
    Copy to clipboard

**Example**

To unpair a device with the address `F8:7D:76:9D:9B:6B`, the following command:

remove F8:7D:76:9D:9B:6B
    Copy to clipboard

**Sample output**

[bluetooth]# remove F8:7D:76:9D:9B:6B
[DEL] Device F8:7D:76:9D:9B:6B MyDeviceB
Device has been removed

## Enable device discovery

To enable discovery mode in the DUT, run the following command:

discoverable on
    Copy to clipboard

**Sample output**

[bluetooth]# discoverable on
Changing discoverable on succeeded
[CHG] Controller 8C:FD:F0:21:84:23 Discoverable: yes

## Disable Bluetooth

To disable Bluetooth on the device, run the following command:

power off
    Copy to clipboard

**Sample output**

[bluetooth]# power off
[CHG] Controller 8C:FD:F0:21:84:23 Discoverable: no
Changing power off succeeded
[CHG] Controller 8C:FD:F0:21:84:23 Powered: no
[CHG] Controller 8C:FD:F0:21:84:23 Discovering: no

## Next steps

- [Configure Wi-Fi.](https://docs.qualcomm.com/doc/80-80022-44/topic/iq8-ifp-ug-config-wifi.html#configure-wifi)
- [Set up the LVDS display panel.](https://docs.qualcomm.com/doc/80-80022-44/topic/iq8-ifp-ug-set-up-display.html#set-up-lvds-display-panel)

Last Published: Jul 20, 2026

[Previous Topic
Perform Ethernet operations](https://docs.qualcomm.com/bundle/publicresource/80-80022-44/topics/iq8-ifp-ug-ethernet.md) [Next Topic
Configure Wi-Fi](https://docs.qualcomm.com/bundle/publicresource/80-80022-44/topics/iq8-ifp-ug-config-wifi.md)