# Verify the functionality of BlueZ stack The Qualcomm Linux Bluetooth solution includes the BlueZ stack and sample test applications. These applications interact with the Bluetooth daemon of the BlueZ stack to run different Bluetooth functions. Use them to verify the functionality of the BlueZ stack. Qualcomm Linux supports the following sample applications that demonstrate Bluetooth profile use cases and test procedures. Each application has profile-specific functions through menu-driven options. | Sample application | Profile | | --- | --- | | bluetoothctl | GAP, GATT, A2DP | | evtool | HOGP | | obexctl | OPP, FTP, PBAP, MAP | | ofono | HFP | The following workflow shows how to get started with verifying the Bluetooth functionality using a sample application. ![../../_images/get-started-workflow.png](data:image/png;base64,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) The sequence to complete the workflow is as follows: 1. Set up your infrastructure as described in the [*Qualcomm Linux Build Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254) and [*Qualcomm Linux Yocto Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-27). The [*Qualcomm Linux Build Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254) also provides information about the common build workflows. 2. Set up the device and run the sample application of a profile. 3. Verify the functionality of a Bluetooth profile. 4. If any issues occur, log and debug them as described in [Debug](https://docs.qualcomm.com/doc/80-70022-13/topic/bt_debugging.html#bt-debugging). ## Set the Bluetooth MAC address By default, the factory sets the Bluetooth MAC address in the one-time programmable memory. If you want to set the Bluetooth MAC address manually, complete the following procedure. Note A manually set Bluetooth MAC address doesn’t persist across device reboots. **Prerequisites** - Enable SSH to access your host device. For instructions, see [Sign in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-254/how_to.html#use-ssh). - [Switch off Bluetooth on the device.](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-perform-bluetooth-gap-functions.html#section-s3x-z1s-lcc-navyanka-08-21-24-1205-42-982) **Procedure** 1. Run the SSH in command prompt using the following command: ssh root@ Copy to clipboard **Example** If the IP address of the device is `10.92.160.222`, run the following command: ssh root@10.92.160.222 Copy to clipboard 2. Connect to the SSH by entering the following password: oelinux123 Copy to clipboard 3. Open the Bluetooth management tool and set the Bluetooth address by running the following command: btmgmt public-addr Copy to clipboard For example, to set the Bluetooth address of the device as `22:22:9B:2C:79:1E`, run the following command: btmgmt public-addr 22:22:9B:2C:79:1E Copy to clipboard **Sample output** sh-5.1# btmgmt public-addr 22:22:9B:2C:79:1E hci0 Set Public Address complete, options: sh-5.1# hciconfig hci0: Type: Primary Bus: UART BD Address: 22:22:9B:2C:79:1E ACL MTU: 1024:7 SCO MTU: 240:8 DOWN RX bytes: 7763 acl:0 sco:0 events:364 errors:0 TX bytes: 938685 acl:0 sco:0 commands:4004 errors:0 Copy to clipboard ## Source code location The following table lists the source code location of Bluetooth components such as the stack, sample test applications, and drivers. | Component | Source code location | | --- | --- | | bluetoothctl | [https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools](https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools) | | obexctl | [https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools](https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools) | | ofono | [https://git.kernel.org/pub/scm/network/ofono/ofono.git](https://git.kernel.org/pub/scm/network/ofono/ofono.git) | | BlueZ stack | | | Bluetooth driver | You can download the Bluetooth driver from the following locations:



>
>
> | ## Next steps - To set up the device and verify GAP functions, see [Verify GAP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-gap.html#bluez-gap). - To set up the device and verify GATT functions, see [Verify GATT functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-gatt.html#bluez-gatt). - To set up the device and verify HOGP functions, see [Verify HOGP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-hogp.html#bluez-hogp). - To set up the device and verify A2DP functions, see [Verify A2DP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-a2dp.html#bluez-a2dp). - To set up the device and verify HFP functions, see [Verify HFP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-hfp.html#bluez-hfp). - To set up the device and verify OPP functions, see [Verify OPP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-opp.html#bluez-opp). - To set up the device and verify FTP functions, see [Verify FTP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-ftp.html#bluez-ftp). - To set up the device and verify PBAP functions, see [Verify PBAP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-pbap.html#bluez-pbap). - To set up the device and verify MAP functions, see [Verify MAP functions](https://docs.qualcomm.com/doc/80-70022-13/topic/bluez-map.html#bluez-map). Last Published: Sep 15, 2025 [Previous Topic Bluetooth architecture](https://docs.qualcomm.com/bundle/publicresource/80-70022-13/topics/bt_architecture_overview.md) [Next Topic Verify GAP functions](https://docs.qualcomm.com/bundle/publicresource/80-70022-13/topics/bluez-gap.md)