# 执行低功耗蓝牙 GATT 客户端功能

您可以使用 `gattctest_menu` 选项执行蓝牙低功耗 GATT 客户端功能。

在开始之前，请设置设备并转到 GATT 客户端菜单，如[设置设备以使用低功耗蓝牙 GATT 功能](https://docs.qualcomm.com/doc/80-70018-13SC/topic/set_up_ble_gatt.html#context-o3z-5dt-s1c)中所述。

## 初始化低功耗蓝牙 GATT 客户端

要初始化 GATT 客户端测试，运行以下命令：

gattctest_init
    Copy to clipboard

**示例输出**

gattctest_menu
    
    ***************** Menu *******************
             gattctest_init (only for Init time)
             gattctest_scanset<space><scan_type><space><value>         eg: scanType: 0-NO_SET,1-SCAN_MODE,2-CB_Type,3-RESULT_TYPE,4-PHY,5-LEGACY,6-REPORT_DELAY,7-NUM_RESPONSE
             gattctest_scanFilter<space><filter_type><space><filter_Value>         eg: filterType: 0-NO_FILT,1-FILT_BD_ADDR,2-FILT_DEV_NAME,3-FILT_SRVC_UUID
             gattctest_scanFilter_manData<space><manuId><space><ManuData><space><ManuMask>
             gattctest_start_scan
             gattctest_stop_scan
             gattctest_batch_scan  0-FULL MODE 1- TRUNCATED MODE
             main_menu
             gattctest_conn_params<space><isAuto><space><phy><space><isOppur>         eg: isAuto(0/1);phy (0-255 (0 bit:1M(1); 1bit:2M(2); 2bit:Coded(4); or any combination); isOppur(0/1))
             gattctest_connect<space><bt_address><space><transport>         eg. gattctest_connect 00:11:22:33:44:55 0(Auto)/1(BREDR)/2(LE)
             gattctest_disconnect<space><bt_address>           eg.gattctest_connect 00:11:22:33:44:55
             gattctest_discsrvc<space><bdaddr>  discovering services
             gattctest_rdchar_uuid<space><bdaddr><space><uuid>         eg: reading char by uuid
             gattctest_readPhy<space><bt_address>
             gattctest_readrssi<space><bt_address>
             gattctest_reqMtu<space><bt_address><space><value>
             gattctest_refresh<space><bt_address>
             gattctest_setphy<space>          <TxValue(0-255,(0 bit:1M(1); 1bit:2M(2); 2bit:Coded(4); or any combination))><space><RxValue(0-255)><space><PhyOpt(0:no pref,1:s2,2:s8)><space><bt_address>
             gattctest_getservices<space><bt_address>
             gattctest_reqconn_pri<space><bt_address><space><priority 0/1/2>
             gattctest_getcharid<space><bt_address><space><instanceid>
             gattctest_reliablewrite<space><bt_address><space><instanceid>
             gattctest_getdescid<space><bt_address><space><instanceid>
             gattctest_getsrvc<space><bt_address><space><UUID><space><INSTANCEID>
             gattctest_RdWrDesc<space><bt_address><space><R-2/W-1><space><value><space><INSTANCEID><space><value length>
             gattctest_RdWrchar<space><bt_address><space><R-2/W-1><space><value><space><INSTANCEID><space><value length>
             gattctest_conn_dev
             gattctest_register_notifications<space><bt_address><space><CHARINSTANCEID><space><DESCINSTANCEID><space><E-1/D-0>
    ******************************************
    gattctest_init
    BtCmdHandler GATTC_TEST_MENUENABLE GATTCTEST
    gattctest not initialized
    EnableGATTCTEST done
    Copy to clipboard

## 配置低功耗蓝牙 GATT 客户端扫描设置

要在扫描之前配置低功耗蓝牙 GATT 扫描设置，例如扫描模式、PHY 和传统选项，运行以下命令：

gattctest_scanset <scan_type> <value>
    Copy to clipboard

**参数**

- `<scan_type>` 是扫描类型。
- `<value>` 是扫描模式。

Note

有关扫描类型及其值的详细信息，参见 [Scan settings](https://docs.qualcomm.com/doc/80-70018-13SC/topic/gatt_config_params.html#section-mk4-b21-kbc-navyanka-05-14-24-1212-32-304)。

如果未配置扫描设置，则使用默认设置启动扫描。

**示例**

要将 `<scan_type>` 和 `<value>` 分别设置为 `<1>` 和 `<1>`，可运行以下命令：

gattctest_scanset 1 1
    Copy to clipboard

**示例输出**

gattctest_scanset 1 1
    BtCmdHandler GATTC_TEST_MENUScan settings
    Do scan settings
    scanSettings Type : 1
    SCAN_MODE value : 1
    Copy to clipboard

## 配置低功耗蓝牙 GATT 客户端扫描过滤器

要在扫描之前配置特定的低功耗蓝牙 GATT 扫描过滤器，运行以下命令：

gattctest_scanFilter <filter_type> <filter_Value>
    Copy to clipboard

**参数**

- `<filter_type>` 是过滤器类型。
- `<filter_Value>` 是设备名称。

如果未配置扫描设置，则使用默认设置启动扫描。

**示例**

要将名为 `QIPL_BT` 的蓝牙设备的 `<filer_type>` 设置为 `<2>`，可运行以下命令：

gattctest_scanFilter 2 QIPL_BT
    Copy to clipboard

**示例输出**

gattctest_scanFilter 2 QIPL_BT
    BtCmdHandler GATTC_TEST_MENUScan filter
    Do scan filtering
    FilterType 2
    FILTER_DEVICE_NAME
    Dev_Name is QIPL_BT
    Copy to clipboard

## 启动低功耗蓝牙 GATT 客户端扫描

要启动低功耗蓝牙 GATT 扫描，运行以下命令：

gattctest_start_scan
    Copy to clipboard

如果已配置扫描设置，则根据指定的设置和过滤器启动扫描。如果未配置扫描设置，则使用默认设置启动扫描。

Note

要获取扫描结果，远程设备必须使用任意蓝牙低功耗应用程序进行广播。

**示例输出**

gattctest_start_scan
    BtCmdHandler GATTC_TEST_MENUtrying to start scan
    starting scan
    [INFO:gatt_api.cc(949)] GATT_Register37d79a07-e02f-f98a-21e9-af96b7f9e01f
    INFO:gatt_api.cc(969)] allocated gatt_if=5
    VERBOSE1:gatt_api.cc(1077)]_GATT_StartIf gatt_if=+
    VERBOSE1:gatt_utils.cc(264)] gatt_find_the_connected_bda start_idx=0
    [VERBOSE1:gatt_utils.cc(276)] found=0 found_idx=7
    VERBOSE1:btm_ble_gap. cc(1952)] btm_ble_process_adv_addr: bda=1e:44:9c:50:13:5a
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 1e:44:9c:50:13:5a
    The scanned device is 1e:44:9c:50:13:5a
    The scanned device is
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=3d: f0:ba:09:2b:35
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 3d: f0:ba:09:2b:35
    The scanned device is 3d: f0:ba: 09:2b:35
    The scanned device is
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=22:fe:78:cc:32:f9
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 22:fe:78:cc:32:f9
    The scanned device is 22:fe:78:cc:32:f9
    The scanned device is
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=8c: fd: f0:Of:29:de
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 8c:fd: f0:Of:29:de
    The scanned device is 8c:fd:f0:Of:29:de
    The scanned device is
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=3c: 12:87: 58:0c:97
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 3c:12:87:58:0c:97
    The scanned device is 3c:12:87:58:0c:97
    The scanned device is
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=23:32:b0:bd: a6:28
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 23:32:b0:bd: a6:28
    [VERBOSE1:btm_ble_gap.cc(1952)] btm_ble_process_adv_addr: bda=3b: a0:94:d1:16:2a
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 3b: a0:94:d1:16:2a
    The scanned device is 23:32:b0:bd:a6:28
    The scanned device is
    The scanned device is 3b:a0:94:d1:16:2a
    Copy to clipboard

## 停止低功耗蓝牙 GATT 客户端扫描

要停止低功耗蓝牙 GATT 扫描，运行以下命令：

gattctest_stop_scan
    Copy to clipboard

**示例输出**

gattctest_stop_scan
    BtCmdHandler GATTC_TEST_MENUstopping scan
    stopping scan results
    [VERBOSE1:gatt_api.cc(992)] GATT_Deregister gatt_if=5
    Copy to clipboard

## 连接低功耗蓝牙 GATT 客户端

要启动与远程设备的 GATT 连接，运行以下命令：

gattctest_connect <bt_address> <transport>
    Copy to clipboard

**参数**

- `<bt_address>` 是远程设备的地址。
- `<transport>` 是用于配对的射频。`<transport>` 参数的值可以是：

    - `0`：自动选择
    - `1`：BR/EDR
    - `2`：蓝牙低功耗

**示例**

远程设备的地址为 `44:c8:f4:b6:af:00`，`<transport>` 类型为 `2`。要连接到远程设备，可运行以下命令：

gattctest_connect 44:c8:f4:b6:af:00 2
    Copy to clipboard

**示例输出**

gattctest_connect 44:c8:f4:b6:af:00 2
    BtCmdHandler GATTC_TEST_MENUconnecting
    [INFO:gatt_api.cc(949)] GATT_Register82462309-bb44-a4a7-db81-b204201f49dd
    [INFO:gatt_api.cc(969)] allocated gatt_if=5
    VERBOSE1:gatt_api.cc(1077)] GATT_StartIf gatt_if=+
    VERBOSE1:gatt_utils.cc(264)] gatt_find_the_connected_bda start_idx=0
    VERBOSE1:gatt_utils.cc(276)] found=0 found_idx=7
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 44:c8:f4:b6:af:00
    INFO:gatt_api.cc(1122)] GATT_Connectgatt_if=5 44:c8:f4:b6:af:00
    [VERBOSE1:gatt_main.cc(1217)] gatt_get_ch_state: ch_state=0
    [VERBOSE1:gatt_main.cc(1200)] gatt_set_ch_state: old=0 new=o
    [VERBOSE1: 12c_api.cc(1673)] L2CA_ConnectFixedChnl BDA: 44:c8:f4:b6:af:00CID: 0x0004
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 44:c8:f4:b6:af:00
    [VERBOSE1:gatt_main.cc(334)] gatt_update_app_use_link_flag: is_add=1 chk_link=1
    [VERBOSE1:gatt_main.cc(300)] gatt_update_app_hold_link_status
    [VERBOSE1:gatt_main.cc(304)] added gatt_if=5
    Copy to clipboard

## 读取低功耗蓝牙 GATT 客户端当前发射器 PHY

要读取 GATT 连接的 Tx 和 Rx PHY 参数，运行以下命令：

gattctest_readPhy <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是连接的远程设备的地址。

**示例**

远程设备的地址是 `66:6b:26:88:df:83`。要读取此连接的 PHY 参数，运行以下命令：

gattctest_readPhy 66:6b:26:88:df:83
    Copy to clipboard

**示例输出**

gattctest_readphy 66:6b:26:88:df:83
    BtCmdHandler GATTC_TEST_MENUReading PHY
    Readphy Setting initiated
    [VERBOSE1:btm_ble.cc(889)] read_phy_cb Received read_phy_cb
    Txphy is 1 and RxPhy is 1
    Copy to clipboard

## 设置低功耗蓝牙 GATT 客户端当前发射器 PHY

要设置 GATT 连接的 Tx 和 Rx PHY 参数，运行以下命令：

gattctest_setphy <tx value> <rx value> <Phy option> <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是连接的远程设备的地址。

Note

有关 PHY 参数的更多信息，请参阅 GATT 配置参数。

**示例**

远程设备的地址是 `4e:0f:49:d9:85:0c`。请运行以下命令，以便将连接的 Tx PHY、Rx PHY 和 PHY 选项分别设置为 `1`、`1` 和 `0`：

gattctest_setphy 1 1 0 4e:0f:49:d9:85:0c
    Copy to clipboard

**示例输出**

gattctest_setphy 1 1 0 4e:0f:49:d9:85:0c
    BtCmdHandler GATTC_TEST_MENUSetting PHY
    Txphy is 1 and RxPhy is 1
    Copy to clipboard

Note

Tx 和 Rx PHY 值根据对端协商的值进行更新。这些值可能与运行 `gattctest_setphy` 命令时提供的 PHY 值不同。

## 读取远程设备 RSSI

要读取远程设备的 RSSI，运行以下命令：

gattctest_readrssi <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是连接的远程设备的地址。

**示例**

远程设备的地址是 `66:6b:26:88:df:83`。要读取设备的 RSSI，运行以下命令：

gattctest_readrssi 66:6b:26:88:df:83
    Copy to clipboard

**示例输出**

gattctest_readrssi 66:6b:26:88:df:83
    BtCmdHandler GATTC_TEST_MENUReading RSSI
    gattReadRemoteRssi Initiated Success
    [VERBOSE1:btm_inq.cc(1019)] BTM_InqDbRead: bd addr 66:6b:26:88:df:83
    onReadRemoteRssi RSSI: -51
    Copy to clipboard

## 发现远程设备服务

要发现远程设备的服务，运行以下命令：

gattctest_discsrvc <bdaddr>
    Copy to clipboard

**参数**

`<bdaddr>` 是连接的远程设备的地址。

**示例**

远程设备的地址是 `66:6b:26:88:df:83`。要发现设备的服务，运行以下命令：

gattctest_discsrvc 66:6b:26:88:df:83
    Copy to clipboard

**示例输出**

gattctest_discsrvc 66:6b:26:88:df:83
    BtCmdHandler GATTC_TEST_MENUDiscovering services
    ===============================
    === The service type is 0 InstaceId 1
    == SERVICE uuid is 00001801-0000-1000-8000-00805f9b34fb
    The no of Characteristics for thisservice: 1
    == == CHAR uuid is 00002a05-0000-1000-8000-00805f9b34fb InstanceID 3
    == == Properties 32 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    ===============================
    === The service type is 0 InstaceId 20
    == SERVICE uuid is 00001800-0000-1000-8000-00805f9b34fb
    The no of Characteristics for thisservice: 3
    == == CHAR uuid is 00002a00-0000-1000-8000-00805f9b34fb InstanceID 22
    == == Properties 2 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    == == CHAR uuid is 00002a01-0000-1000-8000-00805f9b34fb InstanceID 24
    == == Properties 2 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    == == CHAR uuid is 00002aa6-0000-1000-8000-00805f9b34fb InstanceID 26
    == == Properties 2 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    ===============================
    === The service type is 0 InstaceId 40
    == SERVICE uuid is 0000180d-0000-1000-8000-00805f9b34fb
    The no of Characteristics for thisservice: 3
    == == CHAR uuid is 00002a37-0000-1000-8000-00805f9b34fb InstanceID 42
    == == Properties 16 ; permissions 0; writeType 2
    The no of descriptors for thischar 1
    == == CHAR uuid is 00002a38-0000-1000-8000-00805f9b34fb InstanceID 45
    == == Properties 2 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    == == CHAR uuid is 00002a39-0000-1000-8000-00805f9b34fb InstanceID 47
    == == Properties 8 ; permissions 0; writeType 2
    The no of descriptors for thischar 0
    Copy to clipboard

## 获取远程设备服务

要获取远程设备的服务列表，运行以下命令：

gattctest_getservices <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是连接的远程设备的地址。

**示例**

远程设备的地址是 `66:6b:26:88:df:83`。要获取设备的服务列表，运行以下命令：

gattctest_getservices 66:6b:26:88:df:83
    Copy to clipboard

**示例输出**

gattctest_getservices 66:6b:26:88:df:83
    BtCmdHandler GATTC_TEST_MENUgetting services
    ==============================================
    === The service type is 0 Instance ID is1
    == SERVICE uuid is 00001801-0000-1000-8000-00805f9b34fb
    The no of Characteristics for this service:1
    == == == CHAR uuid is 00002a05-0000-1000-8000-00805f9b34fb InstanceId : 3
    == == == Properties 32 ; permissions 0;writeType 2
    ==============================================
    === The service type is 0 Instance ID is20
    == SERVICE uuid is 00001800-0000-1000-8000-00805f9b34fb
    The no of Characteristics for this service:3
    == == == CHAR uuid is 00002a00-0000-1000-8000-00805f9b34fb InstanceId : 22
    == == == Properties 2 ; permissions 0;writeType 2
    == == == CHAR uuid is 00002a01-0000-1000-8000-00805f9b34fb InstanceId : 24
    == == == Properties 2 ; permissions 0;writeType 2
    == == == CHAR uuid is 00002aa6-0000-1000-8000-00805f9b34fb InstanceId : 26
    == == == Properties 2 ; permissions 0;writeType 2
    ==============================================
    === The service type is 0 Instance ID is40
    == SERVICE uuid is 0000180d-0000-1000-8000-00805f9b34fb
    The no of Characteristics for this service:3
    == == == CHAR uuid is 00002a37-0000-1000-8000-00805f9b34fb InstanceId : 42
    == == == Properties 16 ; permissions 0;writeType 2
    == == == CHAR uuid is 00002a38-0000-1000-8000-00805f9b34fb InstanceId : 45
    == == == Properties 2 ; permissions 0;writeType 2
    == == == CHAR uuid is 00002a39-0000-1000-8000-00805f9b34fb InstanceId : 47
    == == == Properties 8 ; permissions 0;writeType 2
    ==============================================
    === The service type is 0 Instance ID is48
    Copy to clipboard

## 读取特征值

要读取特征值，运行以下命令：

gattctest_RdWrChar <bt_address> <Read> <Value> <InstanceID> <Value length>
    Copy to clipboard

**参数**

- `<bt_address>` 是连接的远程设备的地址。
- `<Read>` 命令值为 `2`。
- `<Value>` 是 `0`.由于特征值是从远程设备读取的，因此该值为 `0`。
- `<InstanceID>` 是特定特征的实例值。

    在服务发现期间，所有服务和特征都会使用命令行中的实例 ID 进行更新。
- `<Value Length>` 是要写入的特征值的长度。为了读取特征值，值长度可以是 `0`。

**示例**

远程设备的地址为 `48:33:48:d9:2c:b0`，`<InstanceID>` 为 `9`。要读取特征值，运行以下命令：

gattctest_RdWrchar 48:33:48:d9:2c:b0 2 0 9 0
    Copy to clipboard

**示例输出**

gattctest RdWrchar 48:33:48:d9:2c:b0 2 0 9 0
    BtCmdHandler GATTC_TEST_MENUReading writing char
    instanceid 9
    readcharacteristic Initiated
    onCharacteristicRead UUID 00002b2a-0000-1000-8000-00805f9b34fb, value is 16~0
    Copy to clipboard

## 写入特征值

要写入特征值，运行以下命令：

gattctest_RdWrChar <bt_address> <Write> <Value> <InstanceID> <Value length>
    Copy to clipboard

**参数**

- `<bt_address>` 是连接的远程设备的地址。
- `<Write>` 命令值为 `1`。
- `<Value>` 是要写入的特征值。
- `<InstanceID>` 是特定特征的实例值。

    在服务发现期间，所有服务和特征都会使用命令行中的实例 ID 进行更新。
- `<Value Length>` 是要写入的特征值的长度。

**示例**

远程设备的地址为 `48:33:48:d9:2c:b0`，`<InstanceID>` 为 `56`。请运行以下命令，以便写入值长度为 `2` 的特征值 `78`：

gattctest_RdWrchar 48:33:48:d9:2c:b0 1 78 56 2
    Copy to clipboard

**示例输出**

gattctest_RdWrchar 48:33:48:d9:2c:b0 1 78 56 2
    BtCmdHandler GATTC_TEST_MENUReading writing char
    instanceid 56
    writeCharacteristic value 78
    writeCharacteristic success
    write characteristic uid 0000aaa2-0000-1000-8000-aabbccddeeff, value:78 == success
    write characteristic: 0 success
    Copy to clipboard

## 读取描述符值

要读取描述符值，运行以下命令：

gattctest_RdWrDesc <bt_address> <Read> <Value> <InstanceID> <Value length>
    Copy to clipboard

**参数**

- `<bt_address>` 是连接的远程设备的地址。
- `<Read>` 命令值为 `2`。
- `<Value>` 是 `0`.由于描述符值是从远程设备读取的，因此该值为 `0`。
- `<InstanceID>` 是特定描述符的实例值。

    有关特征描述符的实例 ID，请参阅[获取特征 ID](https://docs.qualcomm.com/doc/80-70018-13SC/topic/perform_ble_gatt_client_functions.html#section-ogz-ygt-s1c)。

    在服务发现期间，所有服务和描述符都会使用命令行中的实例 ID 进行更新。
- `<Value Length>` 是要写入的描述符值的长度。要读取描述符值，值长度可以为 `0`。

**示例**

远程设备的地址为 `48:33:48:d9:2c:b0`，`<InstanceID>` 为 `52`。要读取描述符值，运行以下命令：

gattctest_RdWrDesc 48:33:48:d9:2c:b0 2 0 52 0
    Copy to clipboard

**示例输出**

gattctest_RdWrDesc 48:33:48:d9:2c:b0 2 0 52 0
    BtCmdHandler GATTC_TEST_MENUReading writing DESC
    instanceid 52
    readDescriptor Initiated
    DESCRIPTOR VALUE is #4Vx
    Copy to clipboard

## 写入描述符值

要写入描述符值，运行以下命令：

gattctest_RdWrDesc <bt_address> <Write> <Value> <InstanceID> <Value length>
    Copy to clipboard

**参数**

- `<bt_address>` 是连接的远程设备的地址。
- `<Write>` 命令值为 `1`。
- `<Value>` 是要写入的描述符值。
- `<InstanceID>` 是特定描述符的实例值。

    有关特征描述符的实例 ID，请参阅[获取特征 ID](https://docs.qualcomm.com/doc/80-70018-13SC/topic/perform_ble_gatt_client_functions.html#section-ogz-ygt-s1c)。

    在服务发现期间，所有服务和描述符都会使用命令行中的实例 ID 进行更新。
- `<Value Length>` 是要写入的描述符值的长度。

**示例**

远程设备的地址为 `48:33:48:d9:2c:b0`，`<InstanceID>` 为 `52`。请运行以下命令，以便读取值长度为 `1` 的描述符值 `7`：

gattctest_RdWrDesc 48:33:48:d9:2c:b0 1 7 52 1
    Copy to clipboard

**示例输出**

gattctest_RdWrDesc 48:33:48:d9:2c:b0 1 7 52 1
    BtCmdHandler GATTC_TEST_MENUReading writing DESC
    instanceid 52
    onDescriptorWrite Completed 0
    onDescriptorWrite Success
    Copy to clipboard

## 设置连接优先级

要设置特定远程设备的连接优先级，运行以下命令：

gattctest_reqconn_pri <bt_address> <priority>
    Copy to clipboard

**参数**

- `<bt address>` 是连接的远程设备的地址。
- `<priority>` 可以是 `0`、`1` 或 `2`。

**示例**

请运行以下命令，以便将地址为 `66:6b:26:88:df:83` 的远程设备的连接优先级设置为 `1`：

gattctest_reqconn_pri 66:6b:26:88:df:83 1
    Copy to clipboard

**示例输出**

gattctest_reqconn_pri 66:6b:26:88:df:83 1
    BtCmdHandler GATTC_TEST_MENURequesting Connection Priority
    Requested Connection priority
    onConnectionUpdated interval (12), latency (0), timeout (2000), status (0)
    Copy to clipboard

## 获取特征 ID

要获取特征的详细信息，可运行以下命令：

gattctest_getcharid <bt_address> <instanceID>
    Copy to clipboard

此命令显示特征的详细信息，例如特征 UUID、属性、权限、描述符数以及描述符的 UUID 和实例 ID。

**参数**

- `<bt address>` 是连接的远程设备的地址。
- `<instanceID>` 是特征的实例 ID。

**示例**

远程设备的地址是 `54:8b:83:4a:1f:4e`。请运行以下命令，以便获取实例 ID `74` 的特征：

gattctest_getcharid 54:8b:83:4a:1f:4e 74
    Copy to clipboard

**示例输出**

gattctest_getcharid 54:8b:83:4a:1f:4e 74
    BtCmdHandler GATTC_TEST_MENUgetting Characteristic
    == == == CHAR uuid is ffffeeee-0000-1000-8000-00805f9b34fb InstanceId : 74
    == == == Properties 10 ; permissions 0 ; writeType 2
    The no of descriptors for this char: 1
    @@@@@@ desc uuid is bbbb1111-0000-1000-8000-00705f9b34fb InstanceId : 75
    ****** permissions 0 ; value (null)
    Copy to clipboard

## 获取描述符 ID

要获取描述符的详细信息，可运行以下命令：

gattctest_getdescid <bt address> <instanceID>
    Copy to clipboard

**参数**

- `<bt address>` 是连接的远程设备的地址。
- `<instanceID>` 是描述符的实例 ID。

**示例**

远程设备的地址是 `54:8b:83:4a:1f:4e`。请运行以下命令，以便获取实例 ID 为 `75` 的描述符：

gattctest_getdescid 54:8b:83:4a:1f:4e 75
    Copy to clipboard

**示例输出**

gattctest_getdescid 54:8b:83:4a:1f:4e 75
    BtCmdHandler GATTC_TEST_MENUgetting Descriptor
    @@@@@@ desc uuid is bbbb1111-0000-1000-8000-00705f9b34fb InstanceId : 75
    Copy to clipboard

## 断开低功耗蓝牙 GATT 客户端的连接

要断开远程设备的连接，可运行以下命令：

gattctest_disconnect <bt_address>
    Copy to clipboard

**参数**

`<bt address>` 是您要断开连接的远程设备的地址。

**示例**

远程设备的地址是 `69:d0:d6:99:80:75`。要断开设备的连接，可运行以下命令：

gattctest_disconnect 69:d0:d6:99:80:75
    Copy to clipboard

**示例输出**

gattctest_disconnect 69:d0:d6:99:80:75
    BtCmdHandler GATTC_TEST_MENUdisconnecting
    [INFO:gatt_api.cc(1225)] GATT_Disconnect conn_id=5
    [VERBOSE1:gatt_main.cc(334)] gatt_update_app_use_link_flag: is_add=0 chk_link=1
    [VERBOSE1:gatt_main.cc(300)] gatt_update_app_hold_link_status
    [VERBOSE1:gatt_main.cc(317)] removed_gatt_if=5
    Copy to clipboard

Last Published: Apr 30, 2025

[Previous Topic
执行低功耗蓝牙 GATT 服务器功能](https://docs.qualcomm.com/bundle/publicresource/80-70018-13SC/topics/perform_ble_gatt_server_functions.md) [Next Topic
GATT 配置参数](https://docs.qualcomm.com/bundle/publicresource/80-70018-13SC/topics/gatt_config_params.md)