# 执行蓝牙 GAP 功能 Source: [https://docs.qualcomm.com/doc/80-70017-13SC/topic/gap_commands.html](https://docs.qualcomm.com/doc/80-70017-13SC/topic/gap_commands.html) 您可以使用通用 `gap_menu` 选项执行各种蓝牙 GAP 功能。 在开始之前，设置设备并转到 `gap_menu`，如[为蓝牙 GAP 功能设置设备](https://docs.qualcomm.com/doc/80-70017-13SC/topic/gap_operation.html#gap_operation__section_kzq_ggb_1cc_navyanka_07-10-24-2044-49-668)中所述。 ## 启用蓝牙 要启用设备蓝牙，可运行以下命令： enableCopy to clipboard **示例输出** gap_menu ***************** Menu ******************* enable disable inquiry cancel_inquiry get_role_req eg. get_role_req 00:11:22:33:44:55 pair eg. pair 00:11:22:33:44:55 0(auto)/1(BREDR)/2(BLE) unpair eg. unpair 00:11:22:33:44:55 inquiry_list bonded_list get_state get_bt_name get_bt_address set_bt_name eg. set_bt_name MDM_Fluoride set_scan_mode eg. set_scan_mode 0 --0-BT_SCAN_MODE_NONE,1- BT_SCAN_MODE_CONNECTABLE,2-BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE set_afh eg. set_afh 112233445566778899f0 send_hci_cmd eg. send_hci_cmd 01,04,05,33,8b,9e,0a,00 - For Inquiry read_clock eg. read_clock 0(local)/1(acl connection) 00:11:22:33:44:55 main_menu switch_role_req eg. switch_role_req 00:11:22:33:44:55 0 or get_role_req 00:11:22:33:44:55 1 ****************************************** enable current State = 0, new state = 1 BT State is ONCopy to clipboard ## 运行蓝牙查询扫描 要启动对附近设备的查询，运行以下命令： inquiryCopy to clipboard **示例输出** inquiry Inquiry Started Device Found details: Found device Addr: d8:b0:53:e5:6a:32 Found device Name: MyDeviceB Device Type is: 1 Device Found details: Found device Addr: f8:7d:76:9d:9b:6b Found device Name: MyDeviceA Device Type is: 1 Inquiry Stopped automaticallyCopy to clipboard ## 取消蓝牙查询扫描 要取消正在进行的查询，运行以下命令： cancel_inquiryCopy to clipboard **示例输出** cancel_inquiry **************************** Inquiry List ********************************* 1 MyDeviceB d8:b0:53:e5:6a:32 2 MyDeviceA f8:7d:76:9d:9b:6b **************************** End of List ********************************* Inquiry Stopped due to user input Copy to clipboard ## 获取蓝牙/低功耗蓝牙设备列表 要获取已发现设备的列表，运行以下命令： inquiry_listCopy to clipboard **示例输出** inquiry_list **************************** Inquiry List ********************************* 1 MyDeviceB d8:b0:53:e5:6a:32 2 MyDeviceA f8:7d:76:9d:9b:6b **************************** End of List *********************************Copy to clipboard ## 与对端蓝牙设备配对 要启动主动安全简易配对 (SSP)，运行以下命令： pair Copy to clipboard 要接受主动/被动配对，输入 `yes`。要拒绝主动/被动配对，输入 `no`。 注释： 确保为传统配对方式输入正确的 pin 码。 **参数** - `` 是远程设备的蓝牙地址。 - `` 是用于配对的射频。``参数的值可以是： - `0`：自动选择 - `1`：BR/EDR - `2`：蓝牙低功耗 **示例** 要将远程设备与 `` `f8:7d:76:9d:9b:6b` 配对，请运行以下命令命令： pair f8:7d:76:9d:9b:6b 0Copy to clipboard **示例输出** pair f8:7d:76:9d:9b:6b 0 Auto select in the stack ACL state:0 change with reason 00 for device: f8:7d:76:9d:9b:6b BT pairing_variant 0 ************************************************* BT pairing request::Device MyDeviceB::Pairing Code:: 999712 ************************************************* ** Please enter yes / no ** yes *****************DidInfoCb******************* MAC address:f8:7d:76:9d:9b:6b spec_id:0x102 : vendor:0x4c : vendor_id_source:0x1 : product:0x760a : vendor:0x4c : primary_record:0x1 : client_executable_url: : service_description:PnP Information : documentation_url: : DID info result :0 : *****************FINISH******************* ************************************************* Pairing state for MyDeviceB is BONDED *************************************************Copy to clipboard ## 获取绑定/配对设备列表 要获取已验证的配对设备列表，运行以下命令： bonded_listCopy to clipboard **示例输出** bonded_list **************************** Bonded Device List **************************** MyDeviceB f8:7d:76:9d:9b:6b **************************** End of List *********************************Copy to clipboard ## 设置蓝牙设备名称 要更改或设置本地蓝牙设备名称，运行以下命令： set_bt_name Copy to clipboard **参数** `` 是待设置的设备名称。 **示例** 请运行以下命令，以便将设备名称设置为 `K2L`： set_bt_name K2LCopy to clipboard **示例输出** get_bt_name BT Name : Pstack_test set_bt_name K2L BT name is set to K2L get_bt_name BT Name : K2LCopy to clipboard ## 获取蓝牙名称 要获取蓝牙设备名称，可运行以下命令： get_bt_nameCopy to clipboard **示例输出** 在运行此命令后，示例输出设备名称显示为 `K2L`： get_bt_name BT Name : K2LCopy to clipboard ## 获取蓝牙地址 要设置蓝牙 MAC 地址，参见[通用访问配置文件](https://docs.qualcomm.com/doc/80-70017-13SC/topic/gap_operation.html)。 要获取蓝牙设备地址，可运行以下命令： get_bt_addressCopy to clipboard **示例输出** 在运行此命令后，以下是示例输出，设备地址显示为 `11:22:33:44:55:66`： get_bt_address BT Address : 11:22:33:44:55:66Copy to clipboard ## 关闭蓝牙 要关闭蓝牙，可运行以下命令： disableCopy to clipboard **示例输出** gap_menu ***************** Menu ******************* enable disable inquiry cancel_inquiry get_role_req eg. get_role_req 00:11:22:33:44:55 pair eg. pair 00:11:22:33:44:55 0(auto)/1(BREDR)/2(BLE) unpair eg. unpair 00:11:22:33:44:55 inquiry_list bonded_list get_state get_bt_name get_bt_address set_bt_name eg. set_bt_name MDM_Fluoride set_scan_mode eg. set_scan_mode 0 --0-BT_SCAN_MODE_NONE,1- BT_SCAN_MODE_CONNECTABLE,2-BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE set_afh eg. set_afh 112233445566778899f0 send_hci_cmd eg. send_hci_cmd 01,04,05,33,8b,9e,0a,00 - For Inquiry read_clock eg. read_clock 0(local)/1(acl connection) 00:11:22:33:44:55 main_menu switch_role_req eg. switch_role_req 00:11:22:33:44:55 0 or get_role_req 00:11:22:33:44:55 1 ******************************************* disable current State = 1, new state = 0 BT_AUDIO_HAL_INTEGRATION needs to be defined killall: qcbtdaemon: no process killed killall: wcnssfilter: no process killed BT State is OFFCopy to clipboard **上一级主题：** [通用访问配置文件](https://docs.qualcomm.com/doc/80-70017-13SC/topic/gap_operation.html) Last Published: Jan 23, 2025 [Previous Topic 通用访问配置文件](https://docs.qualcomm.com/bundle/publicresource/80-70017-13SC/topics/gap_operation.md) [Next Topic 串行端口配置文件](https://docs.qualcomm.com/bundle/publicresource/80-70017-13SC/topics/set_up_bluetooth_in_spp.md)