bts_br_gap.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
 * Description: BT GAP module.
 */
 
#ifndef BTS_BR_GAP_H
#define BTS_BR_GAP_H
 
#include <stdint.h>
#include <stdbool.h>
#include "errcode.h"
#include "bts_def.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define SERVICE_LIMITED_DISCOVERABILITY 0x002000
 
#define SERVICE_POSITIONING 0x010000
 
#define SERVICE_NETWORKING 0x020000
 
#define SERVICE_RENDER 0x040000
 
#define SERVICE_CAPTURE 0x080000
 
#define SERVICE_OBJECT_TRANSFER 0x100000
 
#define SERVICE_AUDIO 0x200000
 
#define SERVICE_TELEPHONY 0x400000
 
#define SERVICE_INFORMATION 0x800000
 
typedef enum {
    BT_STACK_STATE_TURNING_ON = 0x0, 
    BT_STACK_STATE_TURN_ON,          
    BT_STACK_STATE_TURNING_OFF,      
    BT_STACK_STATE_TURN_OFF          
} bt_stack_state_t;
 
typedef enum {
    BT_CONNECTION_UNKNOWN = 0x00, 
    BT_CONNECTION_ALLOWED,        
    BT_CONNECTION_FORBIDDEN       
} bt_connect_strategy_type_t;
 
typedef enum {
    A2DP_NOT_PLAYING = 0x00, 
    A2DP_IS_PLAYING          
} a2dp_playing_state_t;
 
typedef enum {
    HFP_SCO_STATE_CONNECTING = 0x01,    
    HFP_SCO_STATE_CONNECTED = 0x02,     
    HFP_SCO_STATE_DISCONNECTING = 0x03, 
    HFP_SCO_STATE_DISCONNECTED = 0x04   
} hfp_sco_connect_state_t;
 
typedef enum {
    HFP_VOLUME_MIC = 0x00, 
    HFP_VOLUME_SPEAKER     
} hfp_volume_type_t;
 
typedef enum {
    PROFILE_STATE_CONNECTING = 0x01,    
    PROFILE_STATE_CONNECTED = 0x02,     
    PROFILE_STATE_DISCONNECTING = 0x03, 
    PROFILE_STATE_DISCONNECTED = 0x04   
} profile_connect_state_t;
 
typedef enum {
    BT_TRANSPORT_INVALID = 0x00, 
    BT_TRANSPORT_BR_EDR = 0x01,  
    BT_TRANSPORT_LE = 0x02       
} bt_transport_type_t;
 
 
typedef enum {
    GAP_ACL_STATE_CONNECTED,      
    GAP_ACL_STATE_DISCONNECTED,   
    GAP_ACL_STATE_LE_CONNECTED,   
    GAP_ACL_STATE_LE_DISCONNECTED 
} gap_acl_state_t;
 
typedef enum {
    GAP_DISCOVERY_STARTED = 0x01, 
    GAP_DISCOVERYING = 0x02,      
    GAP_DISCOVERY_STOPED = 0x03,  
} gap_discovery_state_t;
 
typedef enum {
    GAP_BONDABLE_MODE_OFF = 0x00, 
    GAP_BONDABLE_MODE_ON = 0x01   
} gap_bondable_mode_t;
 
typedef enum {
    GAP_ACCESS_PERMISSION_UNKNOWN,   
    GAP_ACCESS_PERMISSION_ALLOWED,   
    GAP_ACCESS_PERMISSION_FORBIDDEN, 
} gap_access_permission_type_t;
 
typedef enum {
    GAP_SCAN_MODE_NONE = 0x00,                      
    GAP_SCAN_MODE_CONNECTABLE,                      
    GAP_SCAN_MODE_GENERAL_DISCOVERABLE,             
    GAP_SCAN_MODE_LIMITED_DISCOVERABLE,             
    GAP_SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE, 
    GAP_SCAN_MODE_CONNECTABLE_LIMITED_DISCOVERABLE  
} gap_scan_mode_t;
 
typedef enum {
    BT_PROFILE_HEADSET = 0x0, 
    BT_PROFILE_A2DP,          
    BT_PROFILE_OPP,           
    BT_PROFILE_HID,           
    BT_PROFILE_PANU,          
    BT_PROFILE_NAP,           
    BT_PROFILE_HFP            
} bt_profile_type_t;
 
typedef enum {
    GAP_PAIR_NONE = 0x01,    
    GAP_PAIR_PAIRING = 0x02, 
    GAP_PAIR_PAIRED = 0x03   
} gap_pair_state_t;
 
#define BD_NAME_LEN 32
 
typedef struct {
    bd_addr_t addr;                         
    unsigned char device_name[BD_NAME_LEN]; 
} gap_paired_device_info_t;
 
typedef enum {
    GAP_PAIR_CONFIRM_TYPE_PIN_CODE = 0x01,        
    GAP_PAIR_CONFIRM_TYPE_PASSKEY_DISPLAY = 0x02, 
    GAP_PAIR_CONFIRM_TYPE_PASSKEY_INPUT = 0x03,   
    GAP_PAIR_CONFIRM_TYPE_NUMERIC = 0x04,         
    GAP_PAIR_CONFIRM_TYPE_CONSENT = 0x05,         
} gap_pair_confirm_type_t;
 
errcode_t enable_bt_stack(void);
 
errcode_t disable_bt_stack(void);
 
errcode_t bluetooth_set_local_addr(unsigned char *mac, unsigned int len);
 
errcode_t bluetooth_get_local_addr(unsigned char *mac, unsigned int len);
 
errcode_t bluetooth_get_local_name(unsigned char *local_name, unsigned char *length);
 
errcode_t bluetooth_set_local_name(const unsigned char *local_name, unsigned char length);
 
bool bluetooth_factory_reset(void);
 
int gap_br_get_scan_mode(void);
 
bool gap_br_set_bt_scan_mode(int mode, int duration);
 
bool gap_get_paired_devices_num(unsigned int *number);
 
bool gap_get_paired_devices_list(gap_paired_device_info_t *dev_info, int *number);
 
int gap_get_pair_state(const bd_addr_t *addr);
 
bool gap_remove_pair(const bd_addr_t *addr);
 
bool gap_remove_all_pairs(void);
 
bool bt_is_acl_connected(const bd_addr_t *addr);
 
errcode_t gap_disconnect_remote_device(const bd_addr_t *addr);
 
errcode_t gap_connect_remote_device(const bd_addr_t *addr);
 
bool gap_br_start_discovery(void);
 
bool gap_br_cancel_discovery(void);
 
bool is_bt_discovering(int transport);
 
bool gap_read_remote_rssi_value(const bd_addr_t *addr);
 
bool gap_get_device_name(const bd_addr_t *addr, unsigned char *remote_name, unsigned char *length);
 
int gap_get_device_class(const bd_addr_t *addr);
 
typedef void (*gap_state_changed_callback)(const int transport, const int status);
 
typedef void (*gap_acl_state_changed_callback)(const bd_addr_t *bd_addr, gap_acl_state_t state, unsigned int reason);
 
typedef void (*gap_discovery_state_changed_callback)(int status);
 
typedef void (*gap_discovery_result_callback)(const bd_addr_t *bd_addr);
 
typedef void (*gap_pair_requested_callback)(const bd_addr_t *bd_addr);
 
typedef void (*gap_pair_confirmed_callback)(const bd_addr_t *bd_addr, int req_type, int number);
 
typedef void (*gap_scan_mode_changed_callback)(int mode);
 
typedef void (*gap_local_device_name_changed_callback)(const unsigned char *device_name, unsigned char length);
 
typedef void (*gap_local_device_addr_changed_callback)(const bd_addr_t *bd_addr);
 
typedef void (*gap_pair_status_changed_callback)(const bd_addr_t *bd_addr, int status);
 
typedef void (*gap_remote_uuid_changed_callback)(const bd_addr_t *bd_addr, bt_uuid_t uuid);
 
typedef void (*gap_remote_name_changed_callback)(
    const bd_addr_t *bd_addr, const unsigned char *device_name, unsigned char length);
 
typedef void (*gap_remote_alias_changed_callback)(const bd_addr_t *bd_addr, const unsigned char *alias,
    unsigned char length);
 
typedef void (*gap_remote_cod_changed_callback)(const bd_addr_t *bd_addr, int cod);
 
typedef void (*gap_remote_battery_level_changed_callback)(const bd_addr_t *bd_addr, int battery_level);
 
typedef void (*gap_read_remote_rssi_event_callback)(const bd_addr_t *bd_addr, int rssi, int status);
 
typedef void (*gap_is_accept_conn_on_safe_mode_callback)(const bd_addr_t *bd_addr, bool *res);
 
typedef struct {
    gap_state_changed_callback state_change_callback;
    gap_acl_state_changed_callback acl_state_changed_callbak;
    gap_scan_mode_changed_callback scan_mode_changed_callback;
    gap_pair_status_changed_callback pair_status_changed_callback;
    gap_local_device_name_changed_callback device_name_changed_callback;
    gap_local_device_addr_changed_callback device_addr_changed_callback;
    gap_pair_requested_callback pair_requested_callback;
    gap_pair_confirmed_callback pair_confiremed_callback;
    gap_discovery_state_changed_callback discovery_state_changed_callback;
    gap_discovery_result_callback discovery_result_callback;
    gap_remote_uuid_changed_callback remote_uuid_changed_callback;
    gap_remote_name_changed_callback remote_name_changed_callback;
    gap_remote_alias_changed_callback remote_alias_changed_callback;
    gap_remote_cod_changed_callback remote_cod_changed_callback;
    gap_remote_battery_level_changed_callback remote_battery_level_changed_callback;
    gap_read_remote_rssi_event_callback read_remote_rssi_event_callback;
    gap_is_accept_conn_on_safe_mode_callback is_accept_conn_on_safe_mode_callback;
} gap_call_backs_t;
 
int gap_register_callbacks(gap_call_backs_t *func);
 
#ifdef __cplusplus
}
#endif
#endif