WS63 SDK 文档 7021f4f@fbb_ws63
ws63 和 ws63e 解决方案的 SDK 文档
载入中...
搜索中...
未找到
BTS GATT SERVER API

结构体

struct  gatts_add_chara_info_t
 添加特征信息。 更多...
 
struct  gatts_add_desc_info_t
 添加特征描述符信息。 更多...
 
struct  gatts_req_read_cb_t
 读请求信息。 更多...
 
struct  gatts_req_write_cb_t
 写请求信息。 更多...
 
struct  gatts_send_rsp_t
 发送响应信息。 更多...
 
struct  gatts_ntf_ind_t
 发送通知/指示信息。 更多...
 
struct  gatts_ntf_ind_by_uuid_t
 通过uuid发送通知/指示信息。 更多...
 
struct  gatts_add_character_result_t
 添加特征回调信息。 更多...
 
struct  gatts_callbacks_t
 GATT server回调函数接口定义。 更多...
 

类型定义

typedef void(* gatts_add_service_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t handle, errcode_t status)
 服务注册的回调函数。
 
typedef void(* gatts_add_characteristic_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t service_handle, gatts_add_character_result_t *result, errcode_t status)
 特征注册的回调函数。
 
typedef void(* gatts_add_descriptor_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t service_handle, uint16_t handle, errcode_t status)
 特征描述符注册的回调函数。
 
typedef void(* gatts_start_service_callback) (uint8_t server_id, uint16_t handle, errcode_t status)
 开始服务的回调函数。
 
typedef void(* gatts_stop_service_callback) (uint8_t server_id, uint16_t handle, errcode_t status)
 停止服务的回调函数。
 
typedef void(* gatts_delete_service_callback) (uint8_t server_id, errcode_t status)
 删除服务的回调函数。
 
typedef void(* gatts_read_request_callback) (uint8_t server_id, uint16_t conn_id, gatts_req_read_cb_t *read_cb_para, errcode_t status)
 收到读请求的回调函数。
 
typedef void(* gatts_write_request_callback) (uint8_t server_id, uint16_t conn_id, gatts_req_write_cb_t *write_cb_para, errcode_t status)
 收到写请求的回调函数。
 
typedef void(* gatts_mtu_changed_callback) (uint8_t server_id, uint16_t conn_id, uint16_t mtu_size, errcode_t status)
 mtu大小改变的回调函数。
 

函数

errcode_t gatts_register_server (bt_uuid_t *app_uuid, uint8_t *server_id)
 注册gatt服务端。
 
errcode_t gatts_unregister_server (uint8_t server_id)
 注销gatt服务端。
 
errcode_t gatts_add_service (uint8_t server_id, bt_uuid_t *service_uuid, bool is_primary)
 添加一个gatt服务。
 
errcode_t gatts_add_characteristic (uint8_t server_id, uint16_t service_handle, gatts_add_chara_info_t *character)
 添加一个gatt特征。
 
errcode_t gatts_add_descriptor (uint8_t server_id, uint16_t service_handle, gatts_add_desc_info_t *descriptor)
 添加一个gatt特征描述符。
 
errcode_t gatts_add_service_sync (uint8_t server_id, bt_uuid_t *service_uuid, bool is_primary, uint16_t *handle)
 添加一个gatt服务。
 
errcode_t gatts_add_characteristic_sync (uint8_t server_id, uint16_t service_handle, gatts_add_chara_info_t *character, gatts_add_character_result_t *result)
 添加一个gatt特征。
 
errcode_t gatts_add_descriptor_sync (uint8_t server_id, uint16_t service_handle, gatts_add_desc_info_t *descriptor, uint16_t *handle)
 添加一个gatt特征描述符。
 
errcode_t gatts_start_service (uint8_t server_id, uint16_t service_handle)
 开始一个GATT服务。
 
errcode_t gatts_stop_service (uint8_t server_id, uint16_t service_handle)
 停止一个GATT服务。
 
errcode_t gatts_delete_service (uint8_t server_id, uint16_t service_handle)
 删除一个GATT服务。
 
errcode_t gatts_delete_all_services (uint8_t server_id)
 删除所有GATT服务。
 
errcode_t gatts_send_response (uint8_t server_id, uint16_t conn_id, gatts_send_rsp_t *param)
 当收到需要用户回复响应的请求时发送响应。
 
errcode_t gatts_notify_indicate (uint8_t server_id, uint16_t conn_id, gatts_ntf_ind_t *param)
 向对端发送通知或指示。
 
errcode_t gatts_notify_indicate_by_uuid (uint8_t server_id, uint16_t conn_id, gatts_ntf_ind_by_uuid_t *param)
 向对端发送通知或指示。
 
errcode_t gatts_set_mtu_size (uint8_t server_id, uint16_t mtu_size)
 在连接之前设置服务端接收mtu。
 
errcode_t gatts_register_callbacks (gatts_callbacks_t *func)
 注册回调函数。
 

详细描述

类型定义说明

◆ gatts_add_characteristic_callback

typedef void(* gatts_add_characteristic_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t service_handle, gatts_add_character_result_t *result, errcode_t status)

特征注册的回调函数。

◆ gatts_add_descriptor_callback

typedef void(* gatts_add_descriptor_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t service_handle, uint16_t handle, errcode_t status)

特征描述符注册的回调函数。

◆ gatts_add_service_callback

typedef void(* gatts_add_service_callback) (uint8_t server_id, bt_uuid_t *uuid, uint16_t handle, errcode_t status)

服务注册的回调函数。

◆ gatts_delete_service_callback

typedef void(* gatts_delete_service_callback) (uint8_t server_id, errcode_t status)

删除服务的回调函数。

◆ gatts_mtu_changed_callback

typedef void(* gatts_mtu_changed_callback) (uint8_t server_id, uint16_t conn_id, uint16_t mtu_size, errcode_t status)

mtu大小改变的回调函数。

◆ gatts_read_request_callback

typedef void(* gatts_read_request_callback) (uint8_t server_id, uint16_t conn_id, gatts_req_read_cb_t *read_cb_para, errcode_t status)

收到读请求的回调函数。

◆ gatts_start_service_callback

typedef void(* gatts_start_service_callback) (uint8_t server_id, uint16_t handle, errcode_t status)

开始服务的回调函数。

◆ gatts_stop_service_callback

typedef void(* gatts_stop_service_callback) (uint8_t server_id, uint16_t handle, errcode_t status)

停止服务的回调函数。

◆ gatts_write_request_callback

typedef void(* gatts_write_request_callback) (uint8_t server_id, uint16_t conn_id, gatts_req_write_cb_t *write_cb_para, errcode_t status)

收到写请求的回调函数。

函数说明

◆ gatts_add_characteristic()

errcode_t gatts_add_characteristic ( uint8_t  server_id,
uint16_t  service_handle,
gatts_add_chara_info_t character 
)

添加一个gatt特征。

◆ gatts_add_characteristic_sync()

errcode_t gatts_add_characteristic_sync ( uint8_t  server_id,
uint16_t  service_handle,
gatts_add_chara_info_t character,
gatts_add_character_result_t result 
)

添加一个gatt特征。

◆ gatts_add_descriptor()

errcode_t gatts_add_descriptor ( uint8_t  server_id,
uint16_t  service_handle,
gatts_add_desc_info_t descriptor 
)

添加一个gatt特征描述符。

◆ gatts_add_descriptor_sync()

errcode_t gatts_add_descriptor_sync ( uint8_t  server_id,
uint16_t  service_handle,
gatts_add_desc_info_t descriptor,
uint16_t *  handle 
)

添加一个gatt特征描述符。

◆ gatts_add_service()

errcode_t gatts_add_service ( uint8_t  server_id,
bt_uuid_t service_uuid,
bool  is_primary 
)

添加一个gatt服务。

◆ gatts_add_service_sync()

errcode_t gatts_add_service_sync ( uint8_t  server_id,
bt_uuid_t service_uuid,
bool  is_primary,
uint16_t *  handle 
)

添加一个gatt服务。

◆ gatts_delete_all_services()

errcode_t gatts_delete_all_services ( uint8_t  server_id)

删除所有GATT服务。

◆ gatts_delete_service()

errcode_t gatts_delete_service ( uint8_t  server_id,
uint16_t  service_handle 
)

删除一个GATT服务。

◆ gatts_notify_indicate()

errcode_t gatts_notify_indicate ( uint8_t  server_id,
uint16_t  conn_id,
gatts_ntf_ind_t param 
)

向对端发送通知或指示。

◆ gatts_notify_indicate_by_uuid()

errcode_t gatts_notify_indicate_by_uuid ( uint8_t  server_id,
uint16_t  conn_id,
gatts_ntf_ind_by_uuid_t param 
)

向对端发送通知或指示。

◆ gatts_register_callbacks()

errcode_t gatts_register_callbacks ( gatts_callbacks_t func)

注册回调函数。

◆ gatts_register_server()

errcode_t gatts_register_server ( bt_uuid_t app_uuid,
uint8_t *  server_id 
)

注册gatt服务端。

◆ gatts_send_response()

errcode_t gatts_send_response ( uint8_t  server_id,
uint16_t  conn_id,
gatts_send_rsp_t param 
)

当收到需要用户回复响应的请求时发送响应。

◆ gatts_set_mtu_size()

errcode_t gatts_set_mtu_size ( uint8_t  server_id,
uint16_t  mtu_size 
)

在连接之前设置服务端接收mtu。

◆ gatts_start_service()

errcode_t gatts_start_service ( uint8_t  server_id,
uint16_t  service_handle 
)

开始一个GATT服务。

◆ gatts_stop_service()

errcode_t gatts_stop_service ( uint8_t  server_id,
uint16_t  service_handle 
)

停止一个GATT服务。

◆ gatts_unregister_server()

errcode_t gatts_unregister_server ( uint8_t  server_id)

注销gatt服务端。