GATT Client

本页记录 GATT（Generic Attribute Profile） Client 相关接口声明，包括向远端服务端发起服务发现、特征发现、特征描述符发现，按照句柄或 UUID（Universally Unique Identifier）读取与写入属性值，以及通过回调上报发现结果、读写响应、MTU（Maximum Transmission Unit）协商结果、Notification 与 Indication 等事件。

当前 WS53 方案不支持 BLE Client

当前 WS53 SDK 解决方案未集成 BLE Central（中心设备）/GATT Client（客户端）相关组件，不支持使用本页接口开发 BLE Client。公共头文件中保留的接口声明不代表当前 WS53 方案支持该能力；WS53 仅支持 BLE Peripheral（外设）/GATT Server（服务端）角色。

模块公共头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

接口清单

接口名称	功能简述
gattc_register_client	注册 GATT 客户端，分配客户端 ID
gattc_unregister_client	注销已注册的 GATT 客户端
gattc_discovery_service	向远端发起服务发现请求
gattc_discovery_character	向远端发起特征发现请求
gattc_discovery_descriptor	向远端发起特征描述符发现请求
gattc_read_req_by_handle	按照属性句柄发起读取请求
gattc_read_req_by_uuid	按照 UUID 发起读取请求
gattc_write_req	发起写请求（需要远端响应）
gattc_write_cmd	发起写命令（不需要远端响应）
gattc_exchange_mtu_req	发起 MTU 交换请求
gattc_register_callbacks	注册 GATT 客户端事件回调函数集合

Functions

gattc_register_client

errcode_t gattc_register_client(bt_uuid_t *app_uuid, uint8_t *client_id)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 注册上层应用为 GATT 客户端。
• 根据应用 UUID 分配并返回客户端 ID。
• 客户端 ID 作为后续服务发现、读写等操作的客户端标识。

前置条件

• 调用时序约束：需在 BTS（Bluetooth Stack）协议栈初始化完成、BLE 功能就绪后调用。
• 依赖关系：入参 app_uuid 指向由调用方填充的应用 UUID 结构。

入参

名称	参数类型	说明	约束取值范围
app_uuid	bt_uuid_t *	上层应用 UUID	不为 NULL

出参

名称	数据类型	输出说明
client_id	uint8_t *	成功注册后由 BTS（Bluetooth Stack）填充的客户端 ID

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	客户端注册成功
Other	其他错误码，参考errcode_t	执行失败

gattc_unregister_client

errcode_t gattc_unregister_client(uint8_t client_id)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 注销已注册的 GATT 客户端。
• 释放与该客户端 ID 关联的资源。

前置条件

• 调用时序约束：需先调用 gattc_register_client 成功获取客户端 ID。
• 依赖关系：传入的 client_id 必须为已注册且未注销的有效客户端 ID。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	待注销的客户端 ID	已注册的有效客户端 ID

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	客户端注销成功
Other	其他错误码，参考errcode_t	执行失败

gattc_discovery_service

errcode_t gattc_discovery_service(uint8_t client_id, uint16_t conn_id, bt_uuid_t *uuid)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 向远端 GATT 服务端发起服务发现请求。
• 当 uuid 长度为 0 时发现全部服务，否则按 uuid 过滤目标服务。
• 服务发现结果通过已注册的 gattc_discovery_service_callback 与 gattc_discovery_service_complete_callback 回调异步返回。

前置条件

• 调用时序约束：需先调用 gattc_register_client 获取 client_id，并通过 gattc_register_callbacks 注册回调。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
uuid	bt_uuid_t *	服务过滤 UUID，长度为 0 表示发现全部服务	不为 NULL，uuid_len 取值 0 ~ 16

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	服务发现请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_discovery_character

errcode_t gattc_discovery_character(uint8_t client_id, uint16_t conn_id, gattc_discovery_character_param_t *param)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 在指定服务范围内向远端发起特征发现请求。
• 当 param 中 uuid 长度为 0 时发现服务内的全部特征，否则按 uuid 过滤。
• 特征发现结果通过已注册的 gattc_discovery_character_callback 与 gattc_discovery_character_complete_callback 回调异步返回。

前置条件

• 调用时序约束：需先调用 gattc_discovery_service 获取目标服务句柄范围。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
param	gattc_discovery_character_param_t *	特征发现参数，包含服务起始句柄与过滤 uuid	不为 NULL

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	特征发现请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_discovery_descriptor

errcode_t gattc_discovery_descriptor(uint8_t client_id, uint16_t conn_id, uint16_t character_handle)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 向远端发起指定特征声明句柄下的特征描述符发现请求。
• 特征描述符发现结果通过已注册的 gattc_discovery_descriptor_callback 与 gattc_discovery_descriptor_complete_callback 回调异步返回。

前置条件

• 调用时序约束：需先调用 gattc_discovery_character 获取目标特征的声明句柄。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
character_handle	uint16_t	目标特征的声明句柄	有效特征声明句柄

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	特征描述符发现请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_read_req_by_handle

errcode_t gattc_read_req_by_handle(uint8_t client_id, uint16_t conn_id, uint16_t handle)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 按照属性句柄向远端发起读取请求。
• 读取结果通过已注册的 gattc_read_cfm_callback 回调异步返回。

前置条件

• 调用时序约束：需先通过服务/特征发现获取到目标属性句柄。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
handle	uint16_t	待读取的属性句柄	有效属性句柄

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	读取请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_read_req_by_uuid

errcode_t gattc_read_req_by_uuid(uint8_t client_id, uint16_t conn_id, gattc_read_req_by_uuid_param_t *param)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 在指定句柄范围内按照 UUID 向远端发起读取请求。
• 读取结果通过已注册的 gattc_read_cfm_callback 与 gattc_read_by_uuid_complete_callback 回调异步返回。

前置条件

• 调用时序约束：需先通过服务/特征发现获取到目标句柄范围。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
param	gattc_read_req_by_uuid_param_t *	按 UUID 读取请求参数，包含句柄范围与 uuid	不为 NULL

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	读取请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_write_req

errcode_t gattc_write_req(uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *param)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 向远端属性句柄发起写请求（需要远端响应）。
• 写结果通过已注册的 gattc_write_cfm_callback 回调异步返回。

前置条件

• 调用时序约束：需先通过服务/特征发现获取到目标属性句柄。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
param	gattc_handle_value_t *	写请求参数，包含目标句柄、数据及数据长度	不为 NULL

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	写请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_write_cmd

errcode_t gattc_write_cmd(uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *param)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 向远端属性句柄发起写命令（不需要远端响应）。
• 不产生写响应回调。

前置条件

• 调用时序约束：需先通过服务/特征发现获取到目标属性句柄。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
param	gattc_handle_value_t *	写命令参数，包含目标句柄、数据及数据长度	不为 NULL

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	写命令成功发起
Other	其他错误码，参考errcode_t	执行失败

gattc_exchange_mtu_req

errcode_t gattc_exchange_mtu_req(uint8_t client_id, uint16_t conn_id, uint16_t mtu_size)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 向远端发起 MTU 交换请求，协商本次连接的 ATT（Attribute Protocol）最大传输单元。
• MTU 协商结果通过已注册的 gattc_mtu_changed_callback 回调异步返回。

前置条件

• 调用时序约束：需在 BLE 连接建立后调用。
• 依赖关系：conn_id 对应的 BLE 连接必须已建立，回调集合需已注册。

入参

名称	参数类型	说明	约束取值范围
client_id	uint8_t	客户端 ID	已注册的有效客户端 ID
conn_id	uint16_t	连接 ID	已建立的 BLE 连接 ID
mtu_size	uint16_t	客户端接收 MTU，即客户端支持的接收侧 MTU 大小	23 ~ 517

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	MTU 交换请求成功发起，结果通过回调返回
Other	其他错误码，参考errcode_t	执行失败

gattc_register_callbacks

errcode_t gattc_register_callbacks(gattc_callbacks_t *func)

声明头文件

#include "include/middleware/services/bts/ble/bts_gatt_client.h"

功能说明

• 注册 GATT 客户端事件回调函数集合。
• 注册后，服务发现、特征发现、特征描述符发现、读写响应、MTU 改变、Notification、Indication 等事件通过对应回调上报给上层应用。

前置条件

• 调用时序约束：建议在 gattc_register_client 之前或之后、发起任何发现或读写操作之前调用。
• 依赖关系：func 指向由调用方填充的 gattc_callbacks_t 结构。

入参

名称	参数类型	说明	约束取值范围
func	gattc_callbacks_t *	回调函数集合	不为 NULL

返回值

返回类型：errcode_t

返回值	文字含义	触发场景
ERRCODE_SUCC：0	成功	回调函数集合注册成功
Other	其他错误码，参考errcode_t	执行失败

Type definitions

gattc_discovery_service_callback

typedef void (*gattc_discovery_service_callback)(uint8_t client_id, uint16_t conn_id,
    gattc_discovery_service_result_t *service, errcode_t status);

使用说明

服务发现结果回调函数指针类型，每当 gattc_discovery_service 发现到一个服务时由 BTS 线程调用上报该服务信息。

回调说明：

• 调用时机：运行于 BTS 线程，服务发现过程中每发现一个服务触发一次，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；service 指向本次发现的服务结果（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为本次服务发现结果错误码。
• 返回值处理：回调无返回值。

gattc_discovery_service_complete_callback

typedef void (*gattc_discovery_service_complete_callback)(uint8_t client_id, uint16_t conn_id,
    bt_uuid_t *uuid, errcode_t status);

使用说明

服务发现完成回调函数指针类型，服务发现流程结束时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，服务发现流程完成时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；uuid 为发起发现时传入的入参回传；status 为整体发现流程结果错误码。
• 返回值处理：回调无返回值。

gattc_discovery_character_callback

typedef void (*gattc_discovery_character_callback)(uint8_t client_id, uint16_t conn_id,
    gattc_discovery_character_result_t *character, errcode_t status);

使用说明

特征发现结果回调函数指针类型，每当 gattc_discovery_character 发现到一个特征时由 BTS 线程调用上报该特征信息。

回调说明：

• 调用时机：运行于 BTS 线程，特征发现过程中每发现一个特征触发一次，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；character 指向本次发现的特征结果（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为本次特征发现结果错误码。
• 返回值处理：回调无返回值。

gattc_discovery_character_complete_callback

typedef void (*gattc_discovery_character_complete_callback)(uint8_t client_id, uint16_t conn_id,
    gattc_discovery_character_param_t *param, errcode_t status);

使用说明

特征发现完成回调函数指针类型，特征发现流程结束时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，特征发现流程完成时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；param 为发起发现时传入的入参回传；status 为整体发现流程结果错误码。
• 返回值处理：回调无返回值。

gattc_discovery_descriptor_callback

typedef void (*gattc_discovery_descriptor_callback)(uint8_t client_id, uint16_t conn_id,
    gattc_discovery_descriptor_result_t *descriptor, errcode_t status);

使用说明

特征描述符发现结果回调函数指针类型，每当 gattc_discovery_descriptor 发现到一个特征描述符时由 BTS 线程调用上报该描述符信息。

回调说明：

• 调用时机：运行于 BTS 线程，特征描述符发现过程中每发现一个描述符触发一次，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；descriptor 指向本次发现的特征描述符结果（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为本次描述符发现结果错误码。
• 返回值处理：回调无返回值。

gattc_discovery_descriptor_complete_callback

typedef void (*gattc_discovery_descriptor_complete_callback)(uint8_t client_id, uint16_t conn_id,
    uint16_t character_handle, errcode_t status);

使用说明

特征描述符发现完成回调函数指针类型，特征描述符发现流程结束时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，特征描述符发现流程完成时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起发现的客户端 ID；conn_id 为连接 ID；character_handle 为发起发现时传入的目标特征声明句柄回传；status 为整体发现流程结果错误码。
• 返回值处理：回调无返回值。

gattc_read_cfm_callback

typedef void (*gattc_read_cfm_callback)(uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *read_result,
    gatt_status_t status);

使用说明

读响应回调函数指针类型，远端返回读响应时由 BTS 线程调用上报读取结果。

回调说明：

• 调用时机：运行于 BTS 线程，收到远端读响应时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起读取的客户端 ID；conn_id 为连接 ID；read_result 指向读取到的句柄值结果（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为 GATT 错误码。
• 返回值处理：回调无返回值。

gattc_read_by_uuid_complete_callback

typedef void (*gattc_read_by_uuid_complete_callback)(uint8_t client_id, uint16_t conn_id,
    gattc_read_req_by_uuid_param_t *param, errcode_t status);

使用说明

按 UUID 读取完成回调函数指针类型，按 UUID 读取流程结束时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，按 UUID 读取流程完成时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起读取的客户端 ID；conn_id 为连接 ID；param 为发起读取时传入的入参回传；status 为整体读取流程结果错误码。
• 返回值处理：回调无返回值。

gattc_write_cfm_callback

typedef void (*gattc_write_cfm_callback)(uint8_t client_id, uint16_t conn_id, uint16_t handle, gatt_status_t status);

使用说明

写响应回调函数指针类型，远端返回写响应时由 BTS 线程调用上报写结果。

回调说明：

• 调用时机：运行于 BTS 线程，收到远端写响应时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起写入的客户端 ID；conn_id 为连接 ID；handle 为请求写入的属性句柄；status 为 GATT 错误码。
• 返回值处理：回调无返回值。

gattc_mtu_changed_callback

typedef void (*gattc_mtu_changed_callback)(uint8_t client_id, uint16_t conn_id, uint16_t mtu_size, errcode_t status);

使用说明

MTU 改变回调函数指针类型，MTU 交换完成时由 BTS 线程调用上报最终协商的 MTU 大小。

回调说明：

• 调用时机：运行于 BTS 线程，MTU 交换流程完成时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为发起 MTU 交换的客户端 ID；conn_id 为连接 ID；mtu_size 为协商后的 MTU 大小；status 为 MTU 交换结果错误码。
• 返回值处理：回调无返回值。

gattc_notification_callback

typedef void (*gattc_notification_callback)(uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *data,
    errcode_t status);

使用说明

收到 Notification 回调函数指针类型，远端通过 Notification 上报数据时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，收到远端 Notification 时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为接收通知的客户端 ID；conn_id 为连接 ID；data 指向通知数据（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为执行结果错误码。
• 返回值处理：回调无返回值。

gattc_indication_callback

typedef void (*gattc_indication_callback)(uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *data,
    errcode_t status);

使用说明

收到 Indication 回调函数指针类型，远端通过 Indication 上报数据时由 BTS 线程调用。

回调说明：

• 调用时机：运行于 BTS 线程，收到远端 Indication 时触发，禁止阻塞或长时间等待。
• 参数语义：client_id 为接收指示的客户端 ID；conn_id 为连接 ID；data 指向指示数据（内存由 BTS 申请并在内部释放，回调中不应释放）；status 为执行结果错误码。
• 返回值处理：回调无返回值。

errcode_t

errcode t errcode_t

typedef uint32_t errcode_t;

使用说明

本模块所有对外接口的返回值类型，表示接口执行结果的错误码。本类型定义位于 SDK 公共头文件 errcode.h，被本模块全部对外接口的返回值直接使用。

Structures

gattc_handle_value_t

typedef struct {
    uint16_t handle;   /*!< 属性句柄。 */
    uint16_t data_len; /*!< 数据长度。 */
    uint8_t *data;     /*!< 数据。 */
} gattc_handle_value_t;

成员说明

成员名称	数据类型	描述
handle	uint16_t	属性句柄，作为读写操作的目标句柄或读取结果的来源句柄
data_len	uint16_t	数据长度，单位 Bytes
data	uint8_t *	数据指针，指向句柄对应的数据内容

gattc_discovery_character_param_t

typedef struct {
    uint16_t service_handle; /*!< 服务起始句柄。 */
    bt_uuid_t uuid;          /*!< 特征uuid，如果uuid长度为0，发现服务内的所有特征，否则按照uuid过滤。 */
} gattc_discovery_character_param_t;

成员说明

成员名称	数据类型	描述
service_handle	uint16_t	服务起始句柄，作为特征发现的范围起点
uuid	bt_uuid_t	特征过滤 UUID，uuid_len 为 0 时发现服务内全部特征，否则按该 uuid 过滤

gattc_discovery_service_result_t

typedef struct {
    uint16_t start_hdl; /*!< 服务起始句柄。 */
    uint16_t end_hdl;   /*!< 服务结束句柄。 */
    bt_uuid_t uuid;     /*!< 服务uuid。 */
} gattc_discovery_service_result_t;

成员说明

成员名称	数据类型	描述
start_hdl	uint16_t	服务起始句柄
end_hdl	uint16_t	服务结束句柄
uuid	bt_uuid_t	服务 UUID

gattc_discovery_character_result_t

typedef struct {
    bt_uuid_t uuid;          /*!< 特征uuid。 */
    uint16_t declare_handle; /*!< 特征声明句柄。 */
    uint16_t value_handle;   /*!< 特征值句柄。 */
    uint8_t properties;      /*!< 特征特性 { gatt_characteristic_property_t }。 */
} gattc_discovery_character_result_t;

成员说明

成员名称	数据类型	描述
uuid	bt_uuid_t	特征 UUID
declare_handle	uint16_t	特征声明句柄
value_handle	uint16_t	特征值句柄
properties	uint8_t	特征特性，取值为 gatt_characteristic_property_t 各特性位的按位或

gattc_discovery_descriptor_result_t

typedef struct {
    uint16_t descriptor_hdl; /*!< 特征描述符句柄。 */
    bt_uuid_t uuid;          /*!< 特征描述符uuid。 */
} gattc_discovery_descriptor_result_t;

成员说明

成员名称	数据类型	描述
descriptor_hdl	uint16_t	特征描述符句柄
uuid	bt_uuid_t	特征描述符 UUID

gattc_read_req_by_uuid_param_t

typedef struct {
    uint16_t start_hdl; /*!< 起始句柄。 */
    uint16_t end_hdl;   /*!< 结束句柄。 */
    bt_uuid_t uuid;     /*!< uuid。 */
} gattc_read_req_by_uuid_param_t;

成员说明

成员名称	数据类型	描述
start_hdl	uint16_t	起始句柄，作为按 UUID 读取的句柄范围起点
end_hdl	uint16_t	结束句柄，作为按 UUID 读取的句柄范围终点
uuid	bt_uuid_t	待读取属性的 UUID 过滤条件

gattc_callbacks_t

typedef struct ble_gattc_callbacks {
    gattc_discovery_service_callback discovery_svc_cb;                  /*!< 发现服务回调函数。 */
    gattc_discovery_service_complete_callback discovery_svc_cmp_cb;     /*!< 发现服务完成回调函数。 */
    gattc_discovery_character_callback discovery_chara_cb;              /*!< 发现特征回调函数。 */
    gattc_discovery_character_complete_callback discovery_chara_cmp_cb; /*!< 发现特征完成回调函数。 */
    gattc_discovery_descriptor_callback discovery_desc_cb;              /*!< 发现特征描述符回调函数。 */
    gattc_discovery_descriptor_complete_callback discovery_desc_cmp_cb; /*!< 发现特征描述符完成回调函数。 */
    gattc_read_cfm_callback read_cb;                                    /*!< 收到读响应回调函数。 */
    gattc_read_by_uuid_complete_callback read_cmp_cb;                   /*!< 按照uuid读取完成回调函数。 */
    gattc_write_cfm_callback write_cb;                                  /*!< 收到写响应回调函数。 */
    gattc_mtu_changed_callback mtu_changed_cb;                          /*!< mtu改变回调函数。 */
    gattc_notification_callback notification_cb;                        /*!< 收到通知回调函数。 */
    gattc_indication_callback indication_cb;                            /*!< 收到指示回调函数。 */
} gattc_callbacks_t;

成员说明

成员名称	数据类型	描述
discovery_svc_cb	gattc_discovery_service_callback	发现服务回调函数，每个服务发现结果上报入口
discovery_svc_cmp_cb	gattc_discovery_service_complete_callback	发现服务完成回调函数，服务发现流程结束上报入口
discovery_chara_cb	gattc_discovery_character_callback	发现特征回调函数，每个特征发现结果上报入口
discovery_chara_cmp_cb	gattc_discovery_character_complete_callback	发现特征完成回调函数，特征发现流程结束上报入口
discovery_desc_cb	gattc_discovery_descriptor_callback	发现特征描述符回调函数，每个描述符发现结果上报入口
discovery_desc_cmp_cb	gattc_discovery_descriptor_complete_callback	发现特征描述符完成回调函数，描述符发现流程结束上报入口
read_cb	gattc_read_cfm_callback	收到读响应回调函数
read_cmp_cb	gattc_read_by_uuid_complete_callback	按照 UUID 读取完成回调函数
write_cb	gattc_write_cfm_callback	收到写响应回调函数
mtu_changed_cb	gattc_mtu_changed_callback	MTU 改变回调函数
notification_cb	gattc_notification_callback	收到通知回调函数
indication_cb	gattc_indication_callback	收到指示回调函数