BTS GATT CLIENT API

结构体
struct	gattc_handle_value_t
	句柄值信息。 更多...
struct	gattc_discovery_character_param_t
	发现特征参数。 更多...
struct	gattc_discovery_service_result_t
	发现服务结果。 更多...
struct	gattc_discovery_character_result_t
	发现特征结果。 更多...
struct	gattc_discovery_descriptor_result_t
	发现特征描述符结果。 更多...
struct	gattc_read_req_by_uuid_param_t
	向对端发送按照uuid读取请求的参数。 更多...
struct	ble_gattc_callbacks
	GATT client回调函数接口定义。 更多...

类型定义
typedef void(*	gattc_discovery_service_callback) (uint8_t client_id, uint16_t conn_id, gattc_discovery_service_result_t *service, errcode_t status)
	服务发现的回调函数。
typedef void(*	gattc_discovery_service_complete_callback) (uint8_t client_id, uint16_t conn_id, bt_uuid_t *uuid, errcode_t status)
	服务发现完成的回调函数。
typedef void(*	gattc_discovery_character_callback) (uint8_t client_id, uint16_t conn_id, gattc_discovery_character_result_t *character, errcode_t status)
	特征发现的回调函数。
typedef void(*	gattc_discovery_character_complete_callback) (uint8_t client_id, uint16_t conn_id, gattc_discovery_character_param_t *param, errcode_t status)
	特征发现完成的回调函数。
typedef void(*	gattc_discovery_descriptor_callback) (uint8_t client_id, uint16_t conn_id, gattc_discovery_descriptor_result_t *descriptor, errcode_t status)
	特征描述符发现的回调函数。
typedef void(*	gattc_discovery_descriptor_complete_callback) (uint8_t client_id, uint16_t conn_id, uint16_t character_handle, errcode_t status)
	特征描述符发现完成的回调函数。
typedef void(*	gattc_read_cfm_callback) (uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *read_result, gatt_status_t status)
	收到读响应的回调函数。
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读取完成的回调函数。
typedef void(*	gattc_write_cfm_callback) (uint8_t client_id, uint16_t conn_id, uint16_t handle, gatt_status_t status)
	收到写响应的回调函数。
typedef void(*	gattc_mtu_changed_callback) (uint8_t client_id, uint16_t conn_id, uint16_t mtu_size, errcode_t status)
	mtu改变的回调函数。
typedef void(*	gattc_notification_callback) (uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *data, errcode_t status)
	收到通知的回调函数。
typedef void(*	gattc_indication_callback) (uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *data, errcode_t status)
	收到指示的回调函数。
typedef struct ble_gattc_callbacks	gattc_callbacks_t
	GATT client回调函数接口定义。

函数
errcode_t	gattc_register_client (bt_uuid_t *app_uuid, uint8_t *client_id)
	注册gatt客户端。
errcode_t	gattc_unregister_client (uint8_t client_id)
	注销gatt客户端。
errcode_t	gattc_discovery_service (uint8_t client_id, uint16_t conn_id, bt_uuid_t *uuid)
	发现服务。
errcode_t	gattc_discovery_character (uint8_t client_id, uint16_t conn_id, gattc_discovery_character_param_t *param)
	发现特征。
errcode_t	gattc_discovery_descriptor (uint8_t client_id, uint16_t conn_id, uint16_t character_handle)
	发现特征描述符。
errcode_t	gattc_read_req_by_handle (uint8_t client_id, uint16_t conn_id, uint16_t handle)
	发起按照句柄读取请求。
errcode_t	gattc_read_req_by_uuid (uint8_t client_id, uint16_t conn_id, gattc_read_req_by_uuid_param_t *param)
	发起按照uuid读取请求。
errcode_t	gattc_write_req (uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *param)
	发起写请求。
errcode_t	gattc_write_cmd (uint8_t client_id, uint16_t conn_id, gattc_handle_value_t *param)
	发起写命令。
errcode_t	gattc_exchange_mtu_req (uint8_t client_id, uint16_t conn_id, uint16_t mtu_size)
	发送交换mtu请求。
errcode_t	gattc_register_callbacks (gattc_callbacks_t *func)
	注册gatt客户端回调函数。

详细描述

类型定义说明

gattc_callbacks_t

typedef struct ble_gattc_callbacks gattc_callbacks_t

GATT client回调函数接口定义。

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_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)

特征发现完成的回调函数。

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_complete_callback

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

特征描述符发现完成的回调函数。

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_complete_callback

typedef void(* gattc_discovery_service_complete_callback) (uint8_t client_id, uint16_t conn_id, bt_uuid_t *uuid, errcode_t 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)

收到指示的回调函数。

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改变的回调函数。

gattc_notification_callback

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

收到通知的回调函数。

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读取完成的回调函数。

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)

收到读响应的回调函数。

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)

收到写响应的回调函数。

函数说明

gattc_discovery_character()

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

发现特征。

gattc_discovery_descriptor()

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

发现特征描述符。

gattc_discovery_service()

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

发现服务。

gattc_exchange_mtu_req()

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

发送交换mtu请求。

gattc_read_req_by_handle()

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

发起按照句柄读取请求。

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
	)

发起按照uuid读取请求。

gattc_register_callbacks()

errcode_t gattc_register_callbacks

(

gattc_callbacks_t *

func

)

注册gatt客户端回调函数。

gattc_register_client()

errcode_t gattc_register_client	(	bt_uuid_t *	app_uuid,
		uint8_t *	client_id
	)

注册gatt客户端。

gattc_unregister_client()

errcode_t gattc_unregister_client

(

uint8_t

client_id

)

注销gatt客户端。

gattc_write_cmd()

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

发起写命令。

gattc_write_req()

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

发起写请求。