bts_gatt_server.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
 * Description: BTS GATT SERVER module.
 */
 
#ifndef BTS_GATT_SERVER_H
#define BTS_GATT_SERVER_H
 
#include <stdbool.h>
#include <stdint.h>
#include "errcode.h"
#include "bts_def.h"
#include "bts_gatt_stru.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
    bt_uuid_t chara_uuid;   
    uint8_t permissions;    
    uint8_t properties;    
    uint16_t value_len;     
    uint8_t *value;         
} gatts_add_chara_info_t;
 
typedef struct {
    bt_uuid_t desc_uuid;   
    uint8_t permissions;   
    uint16_t value_len;    
    uint8_t *value;        
} gatts_add_desc_info_t;
 
typedef struct {
    uint16_t request_id;  
    uint16_t handle;      
    uint16_t offset;      
    bool need_rsp;        
    bool need_authorize;  
    bool is_long;         
} gatts_req_read_cb_t;
 
typedef struct {
    uint16_t request_id;  
    uint16_t handle;      
    uint16_t offset;      
    bool need_rsp;        
    bool need_authorize;  
    bool is_prep;         
    uint16_t length;      
    uint8_t *value;       
} gatts_req_write_cb_t;
 
typedef struct {
    uint16_t request_id; 
    uint8_t status;      
    uint16_t offset;     
    uint16_t value_len;  
    uint8_t *value;      
} gatts_send_rsp_t;
 
typedef struct {
    uint16_t attr_handle; 
    uint16_t value_len;   
    uint8_t *value;       
} gatts_ntf_ind_t;
 
typedef struct {
    bt_uuid_t chara_uuid;  
    uint16_t start_handle; 
    uint16_t end_handle;   
    uint16_t value_len;    
    uint8_t *value;        
} gatts_ntf_ind_by_uuid_t;
 
typedef struct {
    uint16_t handle;         
    uint16_t value_handle;   
} gatts_add_character_result_t;
 
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);
 
typedef struct {
    gatts_add_service_callback add_service_cb;               
    gatts_add_characteristic_callback add_characteristic_cb; 
    gatts_add_descriptor_callback add_descriptor_cb;         
    gatts_start_service_callback start_service_cb;           
    gatts_stop_service_callback stop_service_cb;             
    gatts_delete_service_callback delete_service_cb;         
    gatts_read_request_callback read_request_cb;             
    gatts_write_request_callback write_request_cb;           
    gatts_mtu_changed_callback mtu_changed_cb;               
} gatts_callbacks_t;
 
errcode_t gatts_register_server(bt_uuid_t *app_uuid, uint8_t *server_id);
 
errcode_t gatts_unregister_server(uint8_t server_id);
 
errcode_t gatts_add_service(uint8_t server_id, bt_uuid_t *service_uuid, bool is_primary);
 
errcode_t gatts_add_characteristic(uint8_t server_id, uint16_t service_handle, gatts_add_chara_info_t *character);
 
errcode_t gatts_add_descriptor(uint8_t server_id, uint16_t service_handle, gatts_add_desc_info_t *descriptor);
 
errcode_t gatts_add_service_sync(uint8_t server_id, bt_uuid_t *service_uuid, bool is_primary, uint16_t *handle);
 
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);
 
errcode_t gatts_add_descriptor_sync(uint8_t server_id, uint16_t service_handle, gatts_add_desc_info_t *descriptor,
    uint16_t *handle);
 
errcode_t gatts_start_service(uint8_t server_id, uint16_t service_handle);
 
errcode_t gatts_stop_service(uint8_t server_id, uint16_t service_handle);
 
errcode_t gatts_delete_service(uint8_t server_id, uint16_t service_handle);
 
errcode_t gatts_delete_all_services(uint8_t server_id);
 
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);
 
errcode_t gatts_register_callbacks(gatts_callbacks_t *func);
 
 
#ifdef __cplusplus
}
#endif
#endif