# Qualcomm Linux Bluetooth documentation Learn about the Bluetooth^®^ subsystem on Qualcomm^®^ Linux^®^, verify Bluetooth functionality, and debug Bluetooth issues. ## Bluetooth overview Bluetooth overview Learn about Bluetooth wireless technology and explore Qualcomm Linux’s Bluetooth solutions. https://docs.qualcomm.com/doc/80-70030-13/topic/introduction.html#introduction Bluetooth specification Get to know the Bluetooth stack, capabilities, and profile support in Qualcomm Linux. https://docs.qualcomm.com/doc/80-70030-13/topic/introduction.html#bt-ft-overview Bluetooth software architecture Understand the key components of Bluetooth software architecture. https://docs.qualcomm.com/doc/80-70030-13/topic/bt_architecture_overview.html#bt-architecture-overview ## Verify the functionality of BlueZ stack Verify functionality of BlueZ stack Understand the prerequisites to get started with verifying the Bluetooth functionality using a sample application. Set the Bluetooth MAC address Configure the Bluetooth MAC address of your device. https://docs.qualcomm.com/doc/80-70030-13/topic/verify-bluetooth-functionality-of-bluez-stack.html#section-dmc-4mq-mcc-08-24-24-2046-12-275 ## Verify GAP functions Set up the device for Bluetooth GAP functions Complete the setup required to perform Bluetooth GAP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-gap.html#section-az1-nxr-lcc-08-21-24-1139-6-18 Perform Bluetooth GAP functions Enable Bluetooth, scan for nearby devices, pair devices, list paired devices, enable discovery, and disable Bluetooth using `bluetoothctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-gap-functions.html#bluez-perform-bluetooth-gap-functions ## Verify GATT functions Set up the device for Bluetooth GATT functions Complete the setup required to perform Bluetooth GATT functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-gatt.html#section-ajz-mss-lcc-08-21-24-1419-1-422 Perform Bluetooth Low Energy GATT server functions Connect to a remote device, add services and characteristics, register an application, start an advertisement, and disconnect using the `bluetoothctl` menu and `menu gatt` submenu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-low-energy-gatt-server-functions.html#bluez-perform-bluetooth-low-energy-gatt-server-functions Perform Bluetooth Low Energy GATT client functions Connect to a remote device, manage Bluetooth Low Energy GATT scans, retrieve attributes, read and write characteristic and descriptor values, and control attribute notifications using the `bluetoothctl` menu and `menu gatt` submenu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-low-energy-gatt-client-functions.html#bluez-perform-bluetooth-low-energy-gatt-client-functions ## Verify HOGP functions Set up the device for Bluetooth HOGP functions Complete the setup required to perform Bluetooth HOGP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-hogp.html#section-g4p-4rv-mcc-08-25-24-1354-32-878 Perform Bluetooth HOGP functions Connect a device and verify HOGP functionality using `bluetoothctl` menu and evtest tool. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-hogp-functions.html#bluez-perform-bluetooth-hogp-functions ## Verify A2DP functions Set up the device for Bluetooth A2DP functions Complete the setup required to perform Bluetooth A2DP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-a2dp.html#section-fwp-mx5-mcc-08-25-24-1121-38-413 Perform Bluetooth A2DP source functions Connect a remote device, list transport options, check codec capabilities, set the volume, play an audio file, list the sinks and play audio on a specified sink using the `bluetoothctl` menu, `menu transport` submenu, and `paplay` commands. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-a2dp-source-functions.html#bluez-perform-bluetooth-a2dp-source-functions Perform Bluetooth A2DP sink functions Manage your audio experience, connect a remote device, list transport options and check codec capabilities. Set the volume, play an audio file and explore other player functions using the `bluetoothctl` menu, `menu transport` submenu, and `menu player` commands. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-a2dp-sink-functions.html#bluez-perform-bluetooth-a2dp-sink-functions ## Verify HFP functions Set up the device for Bluetooth HFP functions Complete the setup required to perform Bluetooth HFP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-hfp.html#section-rmp-dgv-mcc-08-25-24-1227-32-765 Perform Bluetooth HFP client functions Connect or disconnect a remote device, dial a phone number, answer incoming calls, list active calls, reject or disconnect calls using the `bluetoothctl` menu and `ofono/test` tools. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-hfp-client-functions.html#bluez-perform-bluetooth-hfp-client-functions Perform Bluetooth HFP audio gateway functions Connect a remote device and verify the functionality of an audio gateway using `bluetoothctl` menu and `paplay` commands. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-hfp-ag-functions.html#bluez-perform-bluetooth-hfp-ag-functions ## Verify OPP functions Set up the device for Bluetooth OPP functions Complete the setup required to perform Bluetooth OPP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-opp.html#section-qyc-wdd-rcc-09-09-24-2148-41-416 Perform Bluetooth OPP server functions Receive a file in the server role. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-opp-server-functions.html#bluez-perform-bluetooth-opp-server-functions Perform Bluetooth OPP client functions Send a file in the client role. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-opp-client-functions.html#bluez-perform-bluetooth-opp-client-functions ## Verify FTP functions Set up the device for Bluetooth FTP functions Complete the setup required to perform Bluetooth FTP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-ftp.html#section-bdh-4fl-rcc-09-11-24-025-48-587 Perform Bluetooth FTP client functions Create a folder, go to a specific folder, get folder information, copy files to and from a remote device, copy files within the remote device, move files, and delete files using the `obexctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-ftp-server-and-client-functions.html#bluez-perform-bluetooth-ftp-server-and-client-functions ## Verify PBAP functions Set up the device for Bluetooth PBAP functions Complete the setup required to perform Bluetooth PBAP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-pbap.html#section-h2k-3dh-rcc-09-10-24-1056-45-735 Perform Bluetooth PBAP server functions Create a sample PBAP directory, and pull a contact from the server using the `obexctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-pbap-server-functions.html#bluez-perform-bluetooth-pbap-server-functions Perform Bluetooth PBAP client functions Connect the remote device, select a phone book object, pull the phone book, get its size, and search for a contact using the `obexctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-pbap-client-functions.html#bluez-perform-bluetooth-pbap-client-functions ## Verify MAP functions Set up the device for Bluetooth MAP functions Complete the setup required to perform Bluetooth MAP functions. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-map.html#section-d2k-zj4-rcc-09-11-24-1053-36-11 Perform Bluetooth MAP server functions Create a sample MAP directory, pull a message, and read it using the `obexctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-map-server-functions.html#bluez-perform-bluetooth-map-server-functions Perform Bluetooth MAP client functions Connect the remote device, list messages in a folder, and send a message using the `obexctl` menu. https://docs.qualcomm.com/doc/80-70030-13/topic/bluez-perform-bluetooth-map-client-functions.html#bluez-perform-bluetooth-map-client-functions ## Debug Bluetooth issues Debug BlueZ stack Enable and collect BlueZ, snoop, PipeWire, ofono service, and SSR dump logs to debug BlueZ stack issues. https://docs.qualcomm.com/doc/80-70030-13/topic/bt_debugging.html#debug-bluez-stack Last Published: Jun 15, 2026 [Next Topic Bluetooth overview](https://docs.qualcomm.com/bundle/publicresource/80-70030-13/topics/introduction.md)