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. The following workflow shows how to get started with verifying the Bluetooth functionality using a sample application. The sequence to complete the workflow is as follows:

1. Set up your infrastructure as described in the Build Qualcomm Linux using Yocto.
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 Bluetooth issues.

​

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. Prerequisites

• Enable SSH to access your host device. For instructions, see Sign in using SSH.
• Switch off Bluetooth on the device.

Procedure

1. Run the SSH in command prompt using the following command:
   ssh root@<device_IP_address>
   
   Example If the IP address of the device is 10.92.160.222, run the following command:
   ssh root@10.92.160.222
   
2. Connect to the SSH by entering the following password:
   oelinux123
   
3. Open the Bluetooth management tool and set the Bluetooth address by running the following command:
   btmgmt public-addr <bt_address>
   
   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
   
   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
   

​

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
obexctl	https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools
ofono	https://git.kernel.org/pub/scm/network/ofono/ofono.git
BlueZ stack	The git repository for BlueZ is at: https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/ You can download the stack at: https://mirrors.edge.kernel.org/pub/linux/bluetooth/bluez-5.65.tar.gz The git repository for the Bluetooth kernel subsystem is at: https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git/tree/ https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/
Bluetooth driver	You can download the Bluetooth driver from the following locations: https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/hci_qca.c (UART) https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/btqca.c (UART) https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/btusb.c (USB)

​

Next steps

• To set up the device and verify GAP functions, see Verify GAP functions.
• To set up the device and verify GATT functions, see Verify GATT functions.
• To set up the device and verify HOGP functions, see Verify HOGP functions.
• To set up the device and verify A2DP functions, see Verify A2DP functions.
• To set up the device and verify HFP functions, see Verify HFP functions.
• To set up the device and verify OPP functions, see Verify OPP functions.
• To set up the device and verify FTP functions, see Verify FTP functions.
• To set up the device and verify PBAP functions, see Verify PBAP functions.
• To set up the device and verify MAP functions, see Verify MAP functions.