# Qualcomm Linux 蓝牙文档了解 Qualcomm^®^ Linux^®^ 上的蓝牙^®^ 子系统，验证蓝牙功能并调试蓝牙问题。 ## 蓝牙概述蓝牙概述了解蓝牙无线技术并探索 Qualcomm Linux 的蓝牙解决方案。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/introduction.html#introduction 蓝牙规范了解 Qualcomm Linux 中的蓝牙协议栈、功能和配置文件支持。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/introduction.html#bt-ft-overview 蓝牙软件架构了解蓝牙软件架构的关键组件。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bt_architecture_overview.html#bt-architecture-overview ## 验证 BlueZ 协议栈的功能验证 BlueZ 协议栈的功能了解使用示例应用程序开始验证蓝牙功能的先决条件。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/get-started.html#get-started 设置蓝牙 MAC 地址配置设备的蓝牙 MAC 地址。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/verify-bluetooth-functionality-of-bluez-stack.html#section-dmc-4mq-mcc-navyanka-08-24-24-2046-12-275 ## 验证 GAP 功能设置设备的蓝牙 GAP 功能完成执行蓝牙 GAP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-gap.html#section-az1-nxr-lcc-navyanka-08-21-24-1139-6-18 执行蓝牙 GAP 功能使用 `bluetoothctl` 菜单启用蓝牙、扫描附近的设备、配对设备、列出配对的设备、启用发现以及禁用蓝牙。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-gap-functions.html#bluez-perform-bluetooth-gap-functions ## 验证 GATT 功能设置设备的蓝牙 GATT 功能完成执行蓝牙 GATT 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-gatt.html#section-ajz-mss-lcc-navyanka-08-21-24-1419-1-422 执行低功耗蓝牙 GATT 服务器功能使用 `bluetoothctl` 菜单和 `menu gatt` 子菜单连接到远程设备、添加服务和特性、注册应用程序、启动广播以及断开连接。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-low-energy-gatt-server-functions.html#bluez-perform-bluetooth-low-energy-gatt-server-functions 执行低功耗蓝牙 GATT 客户端功能使用 `bluetoothctl` 菜单和 `menu gatt` 子菜单连接到远程设备、管理蓝牙低功耗 GATT 扫描、获取属性、读写特性和描述符值以及控制属性通知。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-low-energy-gatt-client-functions.html#bluez-perform-bluetooth-low-energy-gatt-client-functions ## 验证 HOGP 功能设置设备的蓝牙 HOGP 功能完成执行蓝牙 HOGP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-hogp.html#section-g4p-4rv-mcc-navyanka-08-25-24-1354-32-878 执行蓝牙 HOGP 功能使用 `bluetoothctl` 菜单和 evtest 工具连接设备并验证 HOGP 功能。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-hogp-functions.html#bluez-perform-bluetooth-hogp-functions ## 验证 A2DP 功能设置设备的蓝牙 A2DP 功能完成执行蓝牙 A2DP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-a2dp.html#section-fwp-mx5-mcc-navyanka-08-25-24-1121-38-413 执行蓝牙 A2DP 发送端功能使用 `bluetoothctl` 菜单、`menu transport` 子菜单和 `paplay` 命令连接远程设备、列出传输选项、检查 codec 功能、设置音量、播放音频文件、列出接收端并在指定接收端上播放音频。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-a2dp-source-functions.html#bluez-perform-bluetooth-a2dp-source-functions 执行蓝牙 A2DP 接收端功能管理您的音频体验、连接远程设备、列出传输选项并检查 codec 功能。使用 `bluetoothctl` 菜单、`menu transport` 子菜单和 `menu player` 命令设置音量、播放音频文件并探索其他播放器功能。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-a2dp-sink-functions.html#bluez-perform-bluetooth-a2dp-sink-functions ## 验证 HFP 功能设置设备的蓝牙 HFP 功能完成执行蓝牙 HFP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-hfp.html#section-rmp-dgv-mcc-navyanka-08-25-24-1227-32-765 执行蓝牙 HFP 客户端功能使用 `bluetoothctl` 菜单和 `ofono/test` 工具连接或断开远程设备、拨打电话号码、接听来电、列出当前通话、拒绝或断开通话。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-hfp-client-functions.html#bluez-perform-bluetooth-hfp-client-functions 执行蓝牙 HFP 音频网关功能使用 `bluetoothctl` 菜单和 `paplay` 命令连接远程设备并验证音频网关的功能。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-hfp-ag-functions.html#bluez-perform-bluetooth-hfp-ag-functions ## 验证 OPP 功能设置设备的蓝牙 OPP 功能完成执行蓝牙 OPP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-opp.html#section-qyc-wdd-rcc-navyanka-09-09-24-2148-41-416 执行蓝牙 OPP 服务器功能以服务器角色接收文件。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-opp-server-functions.html#bluez-perform-bluetooth-opp-server-functions 执行蓝牙 OPP 客户端功能以客户端角色发送文件。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-opp-client-functions.html#bluez-perform-bluetooth-opp-client-functions ## 验证 FTP 功能设置设备的蓝牙 FTP 功能完成执行蓝牙 FTP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-ftp.html#section-bdh-4fl-rcc-navyanka-09-11-24-025-48-587 执行蓝牙 FTP 客户端功能使用 `obexctl` 菜单创建文件夹、转到特定文件夹、获取文件夹信息、将文件拷贝到远程设备或从远程设备拷贝文件、在远程设备内拷贝文件、移动文件以及删除文件。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-ftp-server-and-client-functions.html#bluez-perform-bluetooth-ftp-server-and-client-functions ## 验证 PBAP 功能设置设备的蓝牙 PBAP 功能完成执行蓝牙 PBAP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-pbap.html#section-h2k-3dh-rcc-navyanka-09-10-24-1056-45-735 执行蓝牙 PBAP 服务器功能使用 `obexctl` 菜单创建示例 PBAP 目录，并从服务器中拉取联系人。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-pbap-server-functions.html#bluez-perform-bluetooth-pbap-server-functions 执行蓝牙 PBAP 客户端功能使用 `obexctl` 菜单连接远程设备、选择电话簿对象、拉取电话簿、获取其大小以及搜索联系人。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-pbap-client-functions.html#bluez-perform-bluetooth-pbap-client-functions ## 验证 MAP 功能设置设备的蓝牙 MAP 功能完成执行蓝牙 MAP 功能所需的设置。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-map.html#section-d2k-zj4-rcc-navyanka-09-11-24-1053-36-11 执行蓝牙 MAP 服务器功能使用 `obexctl` 菜单创建示例 MAP 目录、拉取消息并读取。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-map-server-functions.html#bluez-perform-bluetooth-map-server-functions 执行蓝牙 MAP 客户端功能使用 `obexctl` 菜单连接远程设备、列出文件夹中的消息以及发送消息。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-perform-bluetooth-map-client-functions.html#bluez-perform-bluetooth-map-client-functions ## 调试蓝牙问题调试 BlueZ 协议栈启用并收集 BlueZ、snoop、PulseAudio、ofono 服务和 SSR dump 日志以调试 BlueZ 协议栈问题。 https://docs.qualcomm.com/doc/80-70022-13SC/topic/bt_debugging.html#debug-bluez-stack Last Published: Nov 03, 2025 [Next Topic 蓝牙概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-13SC/topics/introduction.md)