# Perform Bluetooth GAP functions

Note

Bluetooth ^®^ over M.2E connector isn’t enabled in the 2.0 RC3 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-90441-44/topic/iq9-ifp-ug-hw-overview.html#ifp-dip-switch-table).

## 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
    Copy to clipboard

**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-90441-44/topic/iq9-ifp-ug-config-wifi.html#configure-wifi)
- [Set up the LVDS display panel.](https://docs.qualcomm.com/doc/80-90441-44/topic/iq9-ifp-ug-set-up-display.html#set-up-lvds-display-panel)

Last Published: Oct 12, 2026

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