# Get started with Bluetooth functionality 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 Bluetooth functions. Qualcomm Linux supports the following sample applications for the BlueZ stack: - bluetoothctl - obexctl - ofono - evtool 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-70018-254) and [*Qualcomm Linux Yocto Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-27). The [*Qualcomm Linux Build Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254) also provides information about the common build workflows. 2. Run the sample application and verify the Bluetooth functionality as described in [Verify functionality of BlueZ stack](https://docs.qualcomm.com/doc/80-70018-13/topic/verify-bluetooth-functionality-of-bluez-stack.html#verify-bluetooth-functionality-of-bluez-stack). 3. If any issues occur, log and debug them as described in [Debug](https://docs.qualcomm.com/doc/80-70018-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-70018-254/how_to.html#use-ssh). - [Switch off Bluetooth on the device.](https://docs.qualcomm.com/doc/80-70018-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:



>
>
> | Last Published: Apr 02, 2025 [Previous Topic Bluetooth overview](https://docs.qualcomm.com/bundle/publicresource/80-70018-13/topics/introduction.md) [Next Topic Bluetooth features](https://docs.qualcomm.com/bundle/publicresource/80-70018-13/topics/bt_ft_overview.md)