bts_gatt_client.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
 *
 * Description: BTS GATT CLIENT module.
 */
 
 
#ifndef BTS_GATT_CLIENT_H
#define BTS_GATT_CLIENT_H
 
#include <stdint.h>
#include "errcode.h"
#include "bts_def.h"
#include "bts_gatt_stru.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
    uint16_t handle;   
    uint16_t data_len; 
    uint8_t *data;     
} gattc_handle_value_t;
 
typedef struct {
    uint16_t service_handle; 
    bt_uuid_t uuid;          
} gattc_discovery_character_param_t;
 
typedef struct {
    uint16_t start_hdl; 
    uint16_t end_hdl;   
    bt_uuid_t uuid;     
} gattc_discovery_service_result_t;
 
typedef struct {
    bt_uuid_t uuid;          
    uint16_t declare_handle; 
    uint16_t value_handle;   
    uint8_t properties;      
} gattc_discovery_character_result_t;
 
typedef struct {
    uint16_t descriptor_hdl; 
    bt_uuid_t uuid;          
} gattc_discovery_descriptor_result_t;
 
typedef struct {
    uint16_t start_hdl; 
    uint16_t end_hdl;   
    bt_uuid_t uuid;     
} gattc_read_req_by_uuid_param_t;
 
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);
 
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);
 
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_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;                   
    gattc_write_cfm_callback write_cb;                                  
    gattc_mtu_changed_callback mtu_changed_cb;                          
    gattc_notification_callback notification_cb;                        
    gattc_indication_callback indication_cb;                            
} gattc_callbacks_t;
 
errcode_t gattc_register_client(bt_uuid_t *app_uuid, uint8_t *client_id);
 
errcode_t gattc_unregister_client(uint8_t client_id);
 
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);
 
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);
 
errcode_t gattc_register_callbacks(gattc_callbacks_t *func);
 
#ifdef __cplusplus
}
#endif
#endif