465 lines
19 KiB
C
465 lines
19 KiB
C
#ifndef _API_BTSTACK_H
|
||
#define _API_BTSTACK_H
|
||
|
||
//工作模式
|
||
#define MODE_NORMAL 0
|
||
#define MODE_CBT_TEST 1
|
||
#define MODE_FCC_TEST 2
|
||
#define MODE_BQB_RF 3
|
||
#define MODE_BQB_PROFILE 4
|
||
|
||
//蓝牙功能
|
||
#define PROF_A2DP 0x0007 //蓝牙音乐功能
|
||
#define PROF_HID 0x0018 //蓝牙键盘功能
|
||
#define PROF_HFP 0x0060 //蓝牙通话功能
|
||
#define PROF_SPP 0x0080 //蓝牙串口功能
|
||
#define PROF_PBAP 0x0100 //蓝牙电话本功能
|
||
#define PROF_HSP 0x0200
|
||
#define PROF_MAP 0x0400 //蓝牙短息功能
|
||
|
||
//蓝牙特性
|
||
#define HFP_BAT_REPORT 0x01 //是否支持手机电量显示
|
||
#define HFP_3WAY_CALL 0x02 //是否支持三通电话
|
||
#define HFP_INBAND_RING_RONE 0x04 //是否支持手机来电铃声
|
||
#define HFP_CALL_PRIVATE 0x08 //是否打开强制私密接听
|
||
#define HFP_SIRI_CMD 0x10 //是否打开siri控制命令
|
||
#define HFP_EC_AND_NR 0x20 //是否打开手机端回音和降噪
|
||
#define HFP_RING_NUMBER_EN 0x40 //是否支持来电报号
|
||
#define A2DP_VOL_CTRL 0x01 //是否支持手机音量控制同步
|
||
#define A2DP_IOS_PLAY_STATUS 0x02 //是否支持IOS手机播放状态同步，注意打开后微信小视频会无声，蓝牙后台建议打开
|
||
#define A2DP_ANDROID_PLAY_STATUS 0x04 //是否支持ANDROID手机播放状态同步
|
||
#define A2DP_RESTORE_PLAYING 0x08 //是否支持掉线回连后恢复播放
|
||
#define A2DP_AVDTP_DELAY_REPORT 0x10 //是否支持AVDTP delay report功能
|
||
|
||
//蓝牙编解码
|
||
#define CODEC_SBC 0x01
|
||
#define CODEC_AAC 0x02
|
||
#define CODEC_MSBC 0x04
|
||
#define CODEC_PLC 0x08
|
||
|
||
|
||
//蓝牙状态
|
||
enum {
|
||
BT_STA_OFF, //蓝牙模块已关闭
|
||
BT_STA_INITING, //初始化中
|
||
BT_STA_IDLE, //蓝牙模块打开，未连接
|
||
|
||
BT_STA_SCANNING, //扫描中
|
||
BT_STA_DISCONNECTING, //断开中
|
||
BT_STA_CONNECTING, //连接中
|
||
|
||
BT_STA_CONNECTED, //已连接
|
||
BT_STA_PLAYING, //播放
|
||
BT_STA_INCOMING, //来电响铃
|
||
BT_STA_OUTGOING, //正在呼出
|
||
BT_STA_INCALL, //通话中
|
||
BT_STA_OTA, //OTA升级中
|
||
};
|
||
|
||
//蓝牙通知
|
||
enum {
|
||
BT_NOTICE_INIT_FINISH, //蓝牙初始化完成
|
||
};
|
||
|
||
//BLE通知
|
||
enum {
|
||
BLE_NOTICE_INIT_FINISH, //蓝牙初始化完成
|
||
BLE_NOTICE_CONNECTED, //BLE连接成功
|
||
BLE_NOTICE_DISCONNECT, //BLE连接丢失，param[0]=reason
|
||
BLE_NOTICE_DATA_LEN_CHANGE,
|
||
};
|
||
|
||
//控制消息
|
||
enum {
|
||
BT_CTL_OFF = 0, //关闭蓝牙
|
||
BT_CTL_ON, //打开蓝牙
|
||
BT_CTL_MAX,
|
||
};
|
||
|
||
//BLE消息
|
||
enum {
|
||
BLE_ADV_ENABLE = 0, //打开广播
|
||
BLE_ADV_DISABLE, //关闭广播
|
||
BLE_SET_ADV_INTV, //设置广播间隔
|
||
BLE_SET_ADV_DATA, //设置广播数据
|
||
BLE_SET_SCAN_RSP_DATA,
|
||
BLE_UPDATE_CONN_PARAM, //更新连接参数
|
||
BLE_SEND_DATA, //发送数据
|
||
BLE_SM_REQ, //发起加密请求
|
||
BLE_EXCHANGE_MTU_REQ,
|
||
BLE_DISCONNECT, //断开连接
|
||
};
|
||
|
||
//蓝牙消息
|
||
enum bt_msg_t {
|
||
BT_MSG_CTRL = 0, //蓝牙控制消息
|
||
BT_MSG_BLE,
|
||
BT_MSG_MAX,
|
||
};
|
||
|
||
//LE Addr Type, public or random(static or non resolvable or resolvable)
|
||
enum {
|
||
GAP_RANDOM_ADDRESS_TYPE_OFF = 0, //Public
|
||
GAP_RANDOM_ADDRESS_TYPE_STATIC,
|
||
GAP_RANDOM_ADDRESS_NON_RESOLVABLE,
|
||
GAP_RANDOM_ADDRESS_RESOLVABLE,
|
||
};
|
||
|
||
//LE状态
|
||
enum {
|
||
LE_STA_STANDBY,
|
||
LE_STA_ADVERTISING, //正在广播
|
||
LE_STA_CONNECTION, //已连接
|
||
};
|
||
|
||
//LE GATT 服务相关
|
||
/**
|
||
BLE GATTS ERR return
|
||
*/
|
||
#define BLE_GATTS_SUCCESS 0x00
|
||
#define BLE_GATTS_SRVC_TYPE_ERR 0x01
|
||
#define BLE_GATTS_SRVC_RULES_ERR 0x02
|
||
#define BLE_GATTS_SRVC_PROPS_ERR 0x03
|
||
#define BLE_GATTS_SRVC_ATT_FULL_ERR 0x04
|
||
#define BLE_GATTS_SRVC_PROFILE_FULL_ERR 0x05
|
||
|
||
/**
|
||
att property flag
|
||
*/
|
||
#define ATT_BROADCAST 0x01
|
||
#define ATT_READ 0x02
|
||
#define ATT_WRITE_WITHOUT_RESPONSE 0x04
|
||
#define ATT_WRITE 0x08
|
||
#define ATT_NOTIFY 0x10
|
||
#define ATT_INDICATE 0x20
|
||
#define ATT_AUTHENTICATED_SIGNED_WRITE 0x40
|
||
#define ATT_EXTENDED_PROPERTIES 0x80
|
||
#define ATT_DYNAMIC 0x100
|
||
#define ATT_UUID128 0x200
|
||
#define ATT_AUTHENTICATION_REQUIRED 0x400
|
||
#define ATT_AUTHORIZATION_REQUIRED 0x800
|
||
|
||
/**
|
||
define group GATT Server Service Types
|
||
*/
|
||
typedef enum {
|
||
BLE_GATTS_SRVC_TYPE_PRIMARY = 0x00, //Primary Service
|
||
BLE_GATTS_SRVC_TYPE_SEVONDARY= 0x01, //Secondary Service
|
||
BLE_GATTS_SRVC_TYPE_INCLUDE = 0x02, //include Type
|
||
} ble_gatts_service_type;
|
||
|
||
/**
|
||
define group GATT Server UUID Types
|
||
*/
|
||
typedef enum {
|
||
BLE_GATTS_UUID_TYPE_16BIT = 0x00, //UUID 16BIT
|
||
BLE_GATTS_UUID_TYPE_128BIT = 0x01, //UUID 128BIT
|
||
} ble_gatts_uuid_type;
|
||
|
||
/**
|
||
define GATT handler callback
|
||
con_handle: connect handle
|
||
handle : attribute handle
|
||
flag : call back flag
|
||
*/
|
||
#define ATT_CB_FALG_OFFSET (0xffff)
|
||
#define ATT_CB_FALG_DIR_WRITE (0x10000)
|
||
typedef int (*ble_gatt_callback_func)(uint16_t con_handle, uint16_t handle, uint32_t flag, uint8_t *ptr, uint16_t len);
|
||
|
||
/**
|
||
define GATT service base
|
||
*/
|
||
typedef struct gatts_service_base{
|
||
uint16_t handle;
|
||
} gatts_service_base_st;
|
||
|
||
/**
|
||
define GATT service uuid
|
||
*/
|
||
typedef struct gatts_uuid_base{
|
||
uint16_t props;
|
||
uint8_t type;
|
||
const uint8_t *uuid;
|
||
} gatts_uuid_base_st;
|
||
/**
|
||
define GATT service call back info
|
||
*/
|
||
typedef struct {
|
||
uint16_t client_config; // att config, 1:notify enable; 2:indicate enable;
|
||
uint16_t value_len;
|
||
ble_gatt_callback_func att_write_callback_func; // 特征值的写操作回调
|
||
ble_gatt_callback_func att_read_callback_func; // 特征值的读操作回调, 注意要设置value_len
|
||
uint8_t *value; // read return data, when att_read_callback_func is NULL
|
||
} ble_gatt_characteristic_cb_info_t;
|
||
|
||
#define GATT_CLIENT_CONFIG_NOTIFY 1
|
||
#define GATT_CLIENT_CONFIG_INDICATE 2
|
||
|
||
/**
|
||
define group GATT Server profile struct
|
||
*/
|
||
typedef struct gatts_profile_list{
|
||
void *item;
|
||
uint16_t profile_start_handle;
|
||
uint16_t profile_end_handle;
|
||
const uint8_t *profile_date;
|
||
uint16_t profile_date_size;
|
||
} ble_gatts_profile_list_st;
|
||
|
||
#define BD_ADDR_LENGTH 6
|
||
typedef uint8_t bd_addr_t[BD_ADDR_LENGTH];
|
||
|
||
extern uint8_t cfg_bt_work_mode;
|
||
extern uint8_t cfg_bt_max_acl_link;
|
||
extern bool cfg_bt_dual_mode;
|
||
extern bool cfg_bt_scan_ctrl_mode;
|
||
extern bool cfg_bt_simple_pair_mode;
|
||
extern bool cfg_bt_voip_reject_en;
|
||
extern uint16_t cfg_bt_support_profile;
|
||
extern uint16_t cfg_bt_support_codec;
|
||
extern uint8_t cfg_bt_hid_type;
|
||
extern uint16_t cfg_bt_def_connect_times;
|
||
extern uint16_t cfg_bt_sup_to_connect_times;
|
||
|
||
extern uint8_t cfg_bt_rf_def_txpwr;
|
||
extern uint8_t cfg_bt_page_inq_txpwr;
|
||
|
||
extern uint8_t cfg_bt_a2dp_feature;
|
||
extern uint8_t cfg_bt_hfp_feature;
|
||
extern uint8_t cfg_bt_sniff_clk_sel;
|
||
|
||
#define bt_a2dp_is_vol_ctrl() (cfg_bt_a2dp_feature & A2DP_VOL_CTRL)
|
||
#define bt_a2dp_is_ios_play_status() (cfg_bt_a2dp_feature & A2DP_IOS_PLAY_STATUS)
|
||
|
||
//control
|
||
void bt_fcc_init(void);
|
||
void bt_init(void); //初始化蓝牙变量
|
||
int bt_setup(void); //打开蓝牙模块
|
||
void bt_off(void); //关闭蓝牙模块
|
||
void bt_wakeup(void); //唤醒蓝牙模块
|
||
void bt_send_msg_do(uint msg); //蓝牙控制消息，参数详见bt_msg_t
|
||
void bt_audio_bypass(void); //蓝牙SBC/SCO通路关闭
|
||
void bt_audio_enable(void); //蓝牙SBC/SCO通路使能
|
||
void bt_set_sco_far_delay(void *buf, uint size, uint delay);
|
||
|
||
void bt_set_scan(u8 iscan, u8 pscan); //打开/关闭可被发现和可被连接
|
||
void bt_set_scan_param(uint param); //pscan int = 0x100*((param >> 8)&0xff) + 1), iscan int = 0x100*((param&0xff) + 1)
|
||
uint8_t bt_get_scan(void); //获取设置的可被发现可被连接状态
|
||
void bt_connect(uint times); //蓝牙设备回连, times: 重试次数（每次6s）
|
||
void bt_disconnect(uint reason); //蓝牙设备断开, reason: 0=单独断开（入仓），1=断开并同步关机（按键/自动关机）
|
||
void bt_hid_connect(void); //蓝牙HID服务回连
|
||
void bt_hid_disconnect(void); //蓝牙HID服务断开
|
||
uint32_t bt_sleep_proc(void);
|
||
void bt_enter_sleep(void);
|
||
void bt_exit_sleep(void);
|
||
void updata_bt_name(char *bt_name);
|
||
|
||
//status
|
||
uint bt_get_disp_status(void); //获取蓝牙的当前显示状态
|
||
uint bt_get_status(void); //获取蓝牙的当前状态
|
||
uint bt_get_call_indicate(void); //获取通话的当前状态
|
||
uint bt_get_siri_status(void); //获取SIRI当前状态, 0=SIRI已退出, 1=SIRI已唤出
|
||
bool bt_is_calling(void); //判断是否正在通话
|
||
bool bt_is_playing(void); //判断是否正在播放
|
||
bool bt_is_ring(void); //判断是否正在响铃
|
||
bool bt_is_testmode(void); //判断当前蓝牙是否处于测试模式
|
||
bool bt_is_sleep(void); //判断蓝牙是否进入休眠状态
|
||
bool bt_is_connected(void); //判断蓝牙是否已连接
|
||
bool bt_is_ios_device(void); //判断当前播放的是否ios设备
|
||
bool sco_is_connected(void); //判断当前SCO链路是否连接
|
||
bool bt_sco_is_msbc(void); //判断当前通话是否是宽带通话
|
||
bool bt_a2dp_is_connected(void); //判断蓝牙A2DP是否已连接
|
||
bool bt_hfp_is_connected(void); //判断蓝牙HFP是否已连接
|
||
int bt_hid_is_connected(void);
|
||
bool bt_hid_is_ready_to_discon(void);
|
||
bool sbc_is_bypass(void);
|
||
bool bt_sync_tick(void); //根据蓝牙时钟同步到50ms，误差为5ms
|
||
void bt_reset_addr(void); //重置bt地址, 值通过bt_get_local_bd_addr设置;
|
||
|
||
//info
|
||
bool bt_get_link_btname(uint8_t index, char *name, uint8_t max_size); //index: 0=link0, 1=link1, 0xff=auto(default link0)
|
||
bool bt_nor_get_link_info(uint8_t *bd_addr); //获取手机配对信息，bd_addr=NULL时仅查询是否存在回连信息
|
||
bool bt_nor_get_link_info_addr(uint8_t *bd_addr, uint8_t order); //获取第n个手机配对信息，bd_addr=NULL时仅查询是否存在回连信息
|
||
void bt_nor_delete_link_info(void); //删除手机配对信息
|
||
|
||
#define bt_send_msg(ogf, ocf) bt_send_msg_do((ogf<<24) | (ocf))
|
||
#define bt_ctrl_msg(msg) bt_send_msg(BT_MSG_CTRL, msg)
|
||
#define bt_ble_msg(msg) bt_send_msg(BT_MSG_BLE, msg)
|
||
|
||
//pkt
|
||
typedef void (*kick_func_t)(void);
|
||
|
||
struct txbuf_tag {
|
||
uint8_t *ptr;
|
||
uint16_t len;
|
||
uint16_t handle;
|
||
} __attribute__ ((packed)) ;
|
||
|
||
struct txpkt_tag
|
||
{
|
||
struct txbuf_tag *buf;
|
||
uint16_t buf_size;
|
||
uint8_t total;
|
||
volatile uint8_t cnt;
|
||
uint8_t rptr;
|
||
volatile uint8_t wptr;
|
||
kick_func_t send_kick;
|
||
};
|
||
extern struct txpkt_tag notify_tx;
|
||
|
||
uint32_t txpkt_init(struct txpkt_tag *txpkt, void *mem_pool, uint8_t total, uint16_t buf_size);
|
||
|
||
/*****************************************************************************
|
||
* BLE API
|
||
*****************************************************************************/
|
||
#define ble_adv_dis() bt_ble_msg(BLE_ADV_DISABLE)
|
||
#define ble_adv_en() bt_ble_msg(BLE_ADV_ENABLE)
|
||
|
||
void ble_set_gap_name(char *gap_name, u8 len);
|
||
u16 ble_get_conn_interval(void); //N*1.25ms
|
||
u16 ble_get_conn_latency(void);
|
||
u16 ble_get_conn_timeout(void); //N*10ms
|
||
u16 ble_get_adv_interval(void); //N*625us
|
||
|
||
/*****************************************************************************
|
||
* BLE连接相关（通道1，与BLE无连接广播相互独立）
|
||
*****************************************************************************/
|
||
void ble_send_kick(void);
|
||
|
||
/**
|
||
* @brief 主动请求mtu
|
||
* @return void
|
||
*
|
||
**/
|
||
void ble_exchange_mtu_request(void);
|
||
|
||
/**
|
||
* @brief 获取BLE的状态
|
||
* @return 3种状态的一种
|
||
LE_STA_STANDBY, //standby
|
||
LE_STA_ADVERTISING, //正在广播
|
||
LE_STA_CONNECTION, //已连接
|
||
*
|
||
**/
|
||
u8 ble_get_status(void);
|
||
|
||
/**
|
||
* @brief 判断BLE是否已经链接
|
||
* @return true表示已连接，false断开
|
||
*
|
||
**/
|
||
bool ble_is_connect(void);
|
||
|
||
/**
|
||
* @brief 获取当前MTU值
|
||
* @return 返回MTU
|
||
*
|
||
**/
|
||
u16 ble_get_gatt_mtu(void);
|
||
|
||
/**
|
||
* @brief 设置广播间隔时间
|
||
* 注意单位是625us
|
||
* @param[in] interval 参数数据，范围是32 到 16384
|
||
*
|
||
**/
|
||
void ble_set_adv_interval(u16 interval);
|
||
|
||
/**
|
||
* @brief 断开BLE连接
|
||
*
|
||
*
|
||
**/
|
||
void ble_disconnect(void);
|
||
|
||
/**
|
||
* @brief 往手机(client)端发送数据
|
||
注: 发送的数据长度不能超过MTU设置，可以通过ble_get_gatt_mtu函数获取。
|
||
* @param[in] index GATT初始化的时候返回的一个ID，在ble_gatts_characteristic_add_do函数里有返回
|
||
* @param[in] buf 发送数据的buff
|
||
* @param[len] buf 发送数据的长度
|
||
* @return[int] 0: 成功
|
||
0x0C: APP没打开client_config，或发送的数据大于MTU，或BLE没连接
|
||
0x57: 内部缓存已满
|
||
0x56：发送数据为空指针；或发送数据大小超过init设置的(txpkt_init函数的buf_size参数)
|
||
*
|
||
**/
|
||
int ble_tx_notify(u16 att_handle, u8* buf, u8 len);
|
||
|
||
/**
|
||
* @brief 更新连接间隔
|
||
注:
|
||
* @param[in] interval 连接间隔，1.25ms为单位；最大和最小连接间隔设置为一样了
|
||
* @param[in] latency 潜伏时间 可跳过多少事件
|
||
* @param[len] timeout 超时时间 10ms为单位
|
||
*
|
||
**/
|
||
void ble_update_conn_param(u16 interval, u16 latency, u16 timeout);
|
||
|
||
/**
|
||
* @brief 主动设置广播数据
|
||
注: 意思可以在广播过程中，更改广播数据
|
||
* @param[in] adv_buf 广播数据buff
|
||
* @param[in] size 数据大小最大31字节
|
||
* return : ture 成功
|
||
**/
|
||
bool ble_set_adv_data(const u8 *adv_buf, u32 size);
|
||
|
||
/**
|
||
* @brief 主动设置扫描响应数据
|
||
注: 意思可以在广播过程中，更改扫描相应
|
||
* @param[in] scan_rsp_buf 数据buff
|
||
* @param[in] size 数据大小最大31字节
|
||
* return : ture 成功
|
||
**/
|
||
bool ble_set_scan_rsp_data(const u8 *scan_rsp_buf, u32 size);
|
||
|
||
/**
|
||
* @brief 添加服务初始化函数
|
||
客户一般不需要直接调用，SDK默认引用好了
|
||
* @param[in] profile_table : 存储profile的buuff
|
||
* @param[in] profile_table_size : profile_table大小
|
||
* @param[in] cb_info_table_p：回调结构体
|
||
* @param[in] gatt_max_att：GATT数量的最多需求
|
||
**/
|
||
void ble_gatts_init(uint8_t *profile_table, uint16_t profile_table_size,
|
||
ble_gatt_characteristic_cb_info_t **cb_info_table_p,
|
||
uint16_t gatt_max_att);
|
||
|
||
/**
|
||
* @brief 添加服务函数
|
||
* @param[in] service_type BLE_GATTS_SRVC_TYPE_PRIMARY BLE_GATTS_SRVC_TYPE_SEVONDARY BLE_GATTS_SRVC_TYPE_INCLUDE一种
|
||
* @param[in] service_uuid UUID数据
|
||
* @param[in] uuid_type UUID类型，指16bit还是128bit类型
|
||
* @param[in] service_handle 用这个位置去获取当前分配的handle
|
||
**/
|
||
int ble_gatts_service_add(ble_gatts_service_type service_type, const uint8_t *service_uuid, ble_gatts_uuid_type uuid_type, uint8_t *service_handle);
|
||
|
||
/**
|
||
* @brief 添加特征值函数
|
||
* @param[in] att_uuid GATT的UUID
|
||
* @param[in] uuid_type UUID类型，指16bit还是128bit类型
|
||
* @param[in] props 读写权限
|
||
* @param[in] att_handle 用这个位置去获取当前分配的handle， 可以填NULL
|
||
* @param[in] cb_info： 回调信息，存放读写回调函数等
|
||
**/
|
||
int ble_gatts_characteristic_add( const uint8_t *att_uuid, ble_gatts_uuid_type uuid_type, uint16_t props,
|
||
uint16_t *att_handle, ble_gatt_characteristic_cb_info_t *cb_info);
|
||
bool ble_gatt_init_att_info(uint16_t att_handle, ble_gatt_characteristic_cb_info_t *att_cb_info);
|
||
int ble_gatts_inlcude_service_add(ble_gatts_uuid_type uuid_type, const uint8_t *service_uuid, uint16_t start_handle, uint16_t end_handle, uint16_t *att_handle);
|
||
int ble_gatts_add_profile_date(ble_gatts_profile_list_st *gatts_profile);
|
||
int ble_gatts_attribute_add(const uint8_t *att_data, uint16_t *att_handle);
|
||
bool ble_gatts_profile_mg_alloc_att_num_check(uint8_t att_num);
|
||
|
||
/*****************************************************************************
|
||
* BLE无连接广播相关（通道0，与BLE连接相互独立）
|
||
*****************************************************************************/
|
||
#define BLE_ADV0_EN_BIT 0x01
|
||
#define BLE_ADV0_MS_VAR_BIT 0x02
|
||
#define BLE_ADV0_ADDR_PUBIC_BIT 0x04
|
||
|
||
uint8_t ble_adv0_get_adv_en(void);
|
||
void ble_adv0_set_ctrl(uint opcode); //0=关闭广播, 1=打开广播, 2=更新广播数据（打开时直接广播，关闭时仅更新buffer）
|
||
|
||
#endif
|