1511 lines
61 KiB
C
1511 lines
61 KiB
C
/*********************************************************************************************
|
||
* Filename : ble_api.h
|
||
|
||
* Description :
|
||
|
||
* Author : mx
|
||
|
||
* Email : lmx@zh-jieli.com
|
||
|
||
* Last modifiled : 2020-07-01 16:36
|
||
|
||
* Copyright:(c)JIELI 2011-2020 @ , All Rights Reserved.
|
||
*********************************************************************************************/
|
||
#ifndef __BLE_API_H__
|
||
#define __BLE_API_H__
|
||
|
||
|
||
#include "typedef.h"
|
||
#include "btstack/btstack_typedef.h"
|
||
|
||
|
||
/*****注意：该文件的枚举与库编译密切相关，主要是给用户提供调用所用。用户不能自己在中间添加值.***/
|
||
/*!
|
||
* ----user (command) codes----
|
||
*
|
||
* @brief hci connection handle type
|
||
*/
|
||
/*************************************************************************************************/
|
||
|
||
typedef enum {
|
||
/*
|
||
*/
|
||
BLE_CMD_ADV_ENABLE = 1,
|
||
BLE_CMD_ADV_PARAM,
|
||
BLE_CMD_ADV_DATA,
|
||
BLE_CMD_RSP_DATA,
|
||
BLE_CMD_DISCONNECT,
|
||
BLE_CMD_REGIEST_THREAD,
|
||
BLE_CMD_ATT_SEND_INIT,
|
||
BLE_CMD_ATT_MTU_SIZE,
|
||
BLE_CMD_ATT_VAILD_LEN,
|
||
BLE_CMD_ATT_SEND_DATA,
|
||
BLE_CMD_REQ_CONN_PARAM_UPDATE,
|
||
//12
|
||
BLE_CMD_SCAN_ENABLE,
|
||
BLE_CMD_SCAN_PARAM,
|
||
BLE_CMD_STACK_EXIT,
|
||
BLE_CMD_CREATE_CONN,
|
||
BLE_CMD_CREATE_CONN_CANCEL,
|
||
|
||
//17
|
||
BLE_CMD_ADV_PARAM_EXT,
|
||
BLE_CMD_SEND_TEST_KEY_NUM,
|
||
BLE_CMD_LATENCY_HOLD_CNT,
|
||
BLE_CMD_SET_DATA_LENGTH,
|
||
BLE_CMD_SET_HCI_CFG,
|
||
BLE_CMD_SCAN_ENABLE2,
|
||
BLE_CMD_ATT_SERVER_REQ_RESUME,
|
||
|
||
//MULTI API,多机接口,兼容单机默认的发送接口
|
||
BLE_CMD_MULTI_ATT_SEND_INIT,
|
||
BLE_CMD_MULTI_ATT_SET_CONN_HANDLE,
|
||
BLE_CMD_MULTI_ATT_SEND_DATA,
|
||
BLE_CMD_MULTI_ATT_MTU_SIZE,
|
||
BLE_CMD_MULTI_ATT_VAILD_LEN,
|
||
|
||
//sm
|
||
BLE_CMD_SM_REQ_RESUME,
|
||
|
||
//add here
|
||
BLE_CMD_CREATE_CONN_EXT,
|
||
BLE_CMD_DISCONNECT_EXT,
|
||
BLE_CMD_ATT_CLEAR_SEND_DATA,
|
||
|
||
//优先级高的发送缓存初始化和使用
|
||
//基于原来的ATT发送机制,再添加1套发送缓存初始化;两套缓存要同时使用
|
||
BLE_CMD_HIGH_ATT_SEND_INIT,
|
||
BLE_CMD_HIGH_ATT_SEND_DATA,
|
||
BLE_CMD_HIGH_ATT_VAILD_LEN,
|
||
|
||
//< ble5
|
||
BLE_CMD_EXT_ADV_PARAM = 0x40,
|
||
BLE_CMD_EXT_ADV_DATA,
|
||
BLE_CMD_EXT_RSP_DATA,
|
||
BLE_CMD_EXT_ADV_ENABLE,
|
||
BLE_CMD_SET_PHY,
|
||
BLE_CMD_EXT_SCAN_PARAM,
|
||
BLE_CMD_EXT_SCAN_ENABLE,
|
||
BLE_CMD_EXT_CREATE_CONN,
|
||
BLE_CMD_PERIODIC_ADV_PARAM,
|
||
BLE_CMD_PERIODIC_ADV_DATA,
|
||
BLE_CMD_PERIODIC_ADV_ENABLE,
|
||
BLE_CMD_PERIODIC_ADV_CREAT_SYNC,
|
||
BLE_CMD_PERIODIC_ADV_TERMINATE_SYNC,
|
||
BLE_CMD_PERIODIC_ADV_CREATE_SYNC_CANCEL,
|
||
|
||
//client
|
||
BLE_CMD_SEARCH_PROFILE = 0x80,
|
||
BLE_CMD_WRITE_CCC,
|
||
BLE_CMD_ONNN_PARAM_UPDATA,
|
||
} ble_cmd_type_e;
|
||
|
||
typedef enum {
|
||
BLE_CMD_RET_SUCESS = 0, //执行成功
|
||
BLE_CMD_RET_BUSY = -100, //命令处理忙
|
||
BLE_CMD_PARAM_OVERFLOW, //传数溢出
|
||
BLE_CMD_OPT_FAIL, //操作失败
|
||
BLE_BUFFER_FULL, //缓存满了
|
||
BLE_BUFFER_ERROR, //缓存出错
|
||
BLE_CMD_PARAM_ERROR, //传参出错
|
||
BLE_CMD_STACK_NOT_RUN, //协议栈没有运行
|
||
BLE_CMD_CCC_FAIL, //没有使能通知，导致NOTIFY或INDICATE发送失败，
|
||
} ble_cmd_ret_e;
|
||
|
||
//--------------------------------------------
|
||
ble_cmd_ret_e ble_user_cmd_prepare(ble_cmd_type_e cmd, int argc, ...);
|
||
|
||
struct conn_update_param_t {
|
||
u16 interval_min; //连接周期范围最小值(unit:1.25ms)
|
||
u16 interval_max; //连接周期范围最大值(unit:1.25ms)
|
||
u16 latency; //忽略通信次数(unit: interval)
|
||
u16 timeout; //(unit:10ms)
|
||
};
|
||
|
||
typedef enum {
|
||
PFL_SERVER_UUID16 = 1, //指定16bit UUID搜索方式
|
||
PFL_SERVER_UUID128, //指定128bit UUID搜索方式
|
||
PFL_SERVER_ALL, //搜索所有的UUID
|
||
} search_profile_type_e;
|
||
|
||
|
||
//--------------------------------------------
|
||
struct create_conn_param_t {
|
||
u16 conn_interval; //连接周期(unit:1.25ms)
|
||
u16 conn_latency; //忽略通信次数(unit: interval)
|
||
u16 supervision_timeout; //(通信超时 unit:10ms)
|
||
u8 peer_address_type; //对方地址类型：0--public address,1--random address
|
||
u8 peer_address[6]; //对方地址address
|
||
} _GNU_PACKED_;
|
||
|
||
struct create_conn_param_ext_t {
|
||
u16 le_scan_interval; /*scan 周期(unit: 0.625ms)*/
|
||
u16 le_scan_window; /*scan 窗口(unit: 0.625ms)*/
|
||
u8 initiator_filter_policy;/*过滤,set 0*/
|
||
u8 peer_address_type; /*对方地址类型:0--public address,1--random address*/
|
||
u8 peer_address[6]; /*对方地址*/
|
||
u8 own_address_type; /*本地地址类型:0--public address,1--random address*/
|
||
u16 conn_interval_min;/*连接周期最小值(unit:1.25ms)*/
|
||
u16 conn_interval_max;/*连接周期最大值(unit:1.25ms)*/
|
||
u16 conn_latency; /*忽略通信次数(unit: interval)*/
|
||
u16 supervision_timeout;/*通信超时 unit:10ms*/
|
||
u16 minimum_ce_length; /*set 1*/
|
||
u16 maximum_ce_length; /*set 1*/
|
||
} _GNU_PACKED_;
|
||
|
||
|
||
typedef struct {
|
||
u8 event_type; //对方广播包类型: 0--ADV_IND,1--ADV_DIRECT_IND,2--ADV_SCAN_IND,3--ADV_NONCONN_IND,4--SCAN_RSP
|
||
u8 address_type; //对方地址类型：0--public address,1--random address
|
||
u8 address[6]; //peer_address
|
||
s8 rssi; //range:-127 ~128 dbm
|
||
u8 length; //广播包长度
|
||
u8 data[0]; //广播包内容
|
||
} adv_report_t;
|
||
|
||
typedef struct {
|
||
//base info
|
||
u8 type; //< See <btstack/hci_cmds.h> SM_...
|
||
u8 size;
|
||
u16 con_handle; //connection 's handle, >0
|
||
u8 addr_type; //对方地址类型:0--public address,1--random address
|
||
u8 address[6]; //对方地址
|
||
//extend info
|
||
u8 data[4];
|
||
} sm_just_event_t;
|
||
|
||
//BLE_CMD_SET_HCI_CFG
|
||
typedef enum {
|
||
HCI_CFG_OWN_ADDRESS_TYPE = 0, //
|
||
HCI_CFG_ADV_FILTER_POLICY, //
|
||
HCI_CFG_SCAN_FILTER_POLICY, //
|
||
HCI_CFG_INITIATOR_FILTER_POLICY, //
|
||
//add here
|
||
} hci_cfg_par_e;
|
||
|
||
typedef enum {
|
||
REMOTE_TYPE_UNKNOWN = 0,//未查询or查询对方未响应
|
||
REMOTE_TYPE_ANDROID, //安卓系统
|
||
REMOTE_TYPE_IOS,//ios系统
|
||
} remote_type_e;
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief Gatt client角色初始化.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void gatt_client_init(void);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 注册gatt client角色,事件回调函数.
|
||
*
|
||
* \param [in] handler 事件处理函数.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void gatt_client_register_packet_handler(btstack_packet_handler_t handler);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 初始化配对表.
|
||
*
|
||
* \note 上电初始化一次.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void le_device_db_init(void);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 注册passkey输入回调.
|
||
*
|
||
* \param [in] reset_pk 复位按键输入.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void reset_PK_cb_register(void (*reset_pk)(u32 *));
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 设置ble蓝牙的public地址.
|
||
*
|
||
* \param [in] addr public地址.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*
|
||
* \note 可以结合接口 ble_op_set_ownaddress_type 配置选择地址类型.
|
||
* \note 修改地址必须在ble非工作状态下才能生效( 没有scan,没有adv,没有connected).
|
||
*/
|
||
/*************************************************************************************************/
|
||
int le_controller_set_mac(void *addr);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取ble蓝牙的public地址.
|
||
*
|
||
* \param [out] addr pulic地址.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*/
|
||
/*************************************************************************************************/
|
||
int le_controller_get_mac(void *addr);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 初始化ble蓝牙random地址.
|
||
*
|
||
* \param [in] addr random地址.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*
|
||
* \note 结合接口ble_op_set_own_address_type 配置选择地址类型.
|
||
* \note 修改地址必须在ble非工作状态下才能生效(内有scan,没有adv,没connected).
|
||
*/
|
||
/*************************************************************************************************/
|
||
int le_controller_set_random_mac(void *addr);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 提供自动生成 ble对应的random类型的地址
|
||
*
|
||
* \param [in] random_type
|
||
1--STATIC_DEVICE_ADDR
|
||
2--NON_RESOLVABLE_PRIVATE_ADDR
|
||
3--RESOLVABLE_PRIVATE_ADDR
|
||
*
|
||
* \return true or false
|
||
*
|
||
* \note 设置后可用le_controller_set_random_mac改变指定地址
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_set_make_random_address(uint8_t random_type);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取ble蓝牙的random地址.
|
||
*
|
||
* \param [out] addr random地址.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*/
|
||
/*************************************************************************************************/
|
||
int le_controller_get_random_mac(void *addr);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置协议栈 GATT 角色处理,default server.
|
||
*
|
||
* \param [in] role GATT role: 0--server ,1--client ,2--server + client.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void ble_stack_gatt_role(u8 role);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief client 连接后初始化.
|
||
*
|
||
* \param [in] handle range :>0.
|
||
* \param [in] buffer 配置缓存地址.
|
||
* \param [in] buffer_size 缓存大小.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void user_client_init(u16 handle, u8 *buffer, u16 buffer_size);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取链路对方的信号强度.
|
||
*
|
||
* \param [in] con_handle range :>0.
|
||
*
|
||
* \return rssi 强度 ,range :-127 ~128 dbm.
|
||
*/
|
||
/*************************************************************************************************/
|
||
s8 ble_vendor_get_peer_rssi(u16 conn_handle);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 使能周期interval事件上报.
|
||
*
|
||
* \param [in] con_handle range :>0.
|
||
* \param [in] enable 1 or 0.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_vendor_interval_event_enable(u16 conn_handle, int enable);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置bt协议栈的 ATT协议交换MTU的大小
|
||
*
|
||
* \param [in] mtu_size 配置MTU大小 ,range :23 ~517.
|
||
*
|
||
* \return 配置后mtu_size的值.
|
||
*/
|
||
/*************************************************************************************************/
|
||
u16 ble_vendor_set_default_att_mtu(u16 mtu_size);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 设置 client 搜索结束.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void user_client_set_search_complete(void);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 提供生成ble对应的类型地址.
|
||
*
|
||
* \param [out] address 类型对应地址.
|
||
* \param [in] type ble_type
|
||
* (eg:1.STATIC_DEVICE_ADDR.
|
||
* 2.NON_RESOLVABLE_PRIVATE_ADDR.
|
||
* 3.RESOLVABLE_PRIVATE_ADDR).
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note 生成RESOLVABLE_PRIVATE_ADDR,需要等协议栈初始化IRK后才能生成.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_vendor_random_address_generate(u8 *address, u8 type);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 根据提供的edr地址生成唯一对应的ble地址.
|
||
*
|
||
* \param [out] ble_adress BLE_address.
|
||
* \param [in] edr_adress EDR_address.
|
||
*
|
||
* \note 用户可以自定义edr和ble地址关联规则,重写这个接口
|
||
*/
|
||
/*************************************************************************************************/
|
||
void lib_make_ble_address(u8 *ble_address, u8 *edr_address);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置设备的地址类型，默认为 0(public address).
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_own_address_type(u8 address_type).
|
||
*
|
||
* \param [in] address_type Range: 0x00 to 0x03.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意:设置的时候必须在、设置广播参数、或者扫描参数、或者创建连接参数前配置好.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_own_address_type(u8 address_type) */
|
||
#define ble_op_set_own_address_type(address_type) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_HCI_CFG, 2,HCI_CFG_OWN_ADDRESS_TYPE,(int)address_type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 开关BLE广播.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_adv_enable(int enable).
|
||
*
|
||
* \param [in] enable 广播使能 :0(dis) or 1(en).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：开广播前必现先配置好广播的参数.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_adv_enable(int enable) */
|
||
#define ble_op_adv_enable(enable) \
|
||
ble_user_cmd_prepare(BLE_CMD_ADV_ENABLE, 1, (int)enable)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置广播过滤策略(决定链路层如何处理扫描、连接请求);默认为 0.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_adv_filter_policy(u8 type).
|
||
*
|
||
* \param [in] type 类型 :Range: 0x00 to 0x03.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必须在“设置广播参数ble_op_set_adv_param前配置好.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_adv_filter_policy(u8 type) */
|
||
#define ble_op_set_adv_filter_policy(type) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_HCI_CFG, 2,HCI_CFG_ADV_FILTER_POLICY,type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置广播参数.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_adv_param(u16 adv_interval,u8 adv_type).
|
||
*
|
||
* \param [in] adv_interval 广播周期,Range: 0x0020 to 0x4000 (unit: 0.625ms).
|
||
* \param [in] adv_type 广播类型,Range: 0x00 to 0x04.
|
||
* \param [in] adv_channel 广播类型通道,range:Range: 0x01 to 0x07.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必现在广播关闭的状态下.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_adv_param(u16 adv_interval,u8 adv_type) */
|
||
#define ble_op_set_adv_param(adv_interval,adv_type,adv_channel) \
|
||
ble_user_cmd_prepare(BLE_CMD_ADV_PARAM, 3, (int)adv_interval, (int)adv_type, (int)adv_channel)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置广播参数+配对信息(相比配对广播参数,这个函数主要是针对定向广播使用).
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_adv_param_ext(u16 adv_interval,u8 adv_type,u8 adv_channel,const u8 *peer_info).
|
||
*
|
||
* \param [in] adv_interval 广播周期,Range: 0x0020 to 0x4000 (unit: 0.625ms).
|
||
* \param [in] adv_type 广播类型,Range: 0x00 to 0x04.
|
||
* \param [in] adv_channel 广播类型通道,range:Range: 0x01 to 0x07.
|
||
* \param [in] peer_info (全局变量地址),定向广播时，填入对方的地址信息.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必现在广播关闭的状态下.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_adv_param_ext(u16 adv_interval,u8 adv_type,u8 adv_channel,const u8 *peer_info) */
|
||
#define ble_op_set_adv_param_ext(adv_interval,adv_type,adv_channel,peer_info) \
|
||
ble_user_cmd_prepare(BLE_CMD_ADV_PARAM_EXT, 4, (int)adv_interval, (int)adv_type, (int)adv_channel, (void*)peer_info)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置广播 Advertising Data内容.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_adv_data(u8 adv_len,const *u8 adv_data).
|
||
*
|
||
* \param [in] adv_len adv 数据包长度，Range: 0x00 to 0x1f.
|
||
* \param [in] adv_data (全局变量地址)，adv数据包地址.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必现在广播关闭的状态下.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_adv_data(u8 adv_len,const *u8 adv_data) */
|
||
#define ble_op_set_adv_data(adv_len,adv_data) \
|
||
ble_user_cmd_prepare(BLE_CMD_ADV_DATA, 2, (int)adv_len, (void*)adv_data)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置广播 Scan Response Data内容.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_rsp_data(u8 rsp_len,const *u8 rsp_data).
|
||
*
|
||
* \param [in] rsp_len rsp 包长度，Range: 0x00 to 0x1f.
|
||
* \param [in] adv_data (全局变量地址)，rsp数据包地址.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必现在广播关闭的状态下.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_rsp_data(u8 rsp_len,const *u8 rsp_data) */
|
||
#define ble_op_set_rsp_data(rsp_len,rsp_data) \
|
||
ble_user_cmd_prepare(BLE_CMD_RSP_DATA, 2, (int)rsp_len, (void*)rsp_data)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 请求断开 ble 连接.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_disconnect(u16 con_handle).
|
||
*
|
||
* \param [in] con_handle range: >0.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_disconnect(u16 con_handle) */
|
||
#define ble_op_disconnect(con_handle) \
|
||
ble_user_cmd_prepare(BLE_CMD_DISCONNECT, 1, (int)con_handle)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 请求断开 ble 连接,by reason
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_disconnect(u16 con_handle).
|
||
*
|
||
* \param [in] con_handle range: >0.
|
||
* \param [in] reason range: see spec.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_disconnect_ext(u16 con_handle,reason) */
|
||
#define ble_op_disconnect_ext(con_handle,reason) \
|
||
ble_user_cmd_prepare(BLE_CMD_DISCONNECT_EXT, 2, (int)con_handle, reason)
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置ATT发送模块RAM大小.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_att_send_init(u16 con_handle,u8 *att_ram_addr,int att_ram_size,int att_payload_size).
|
||
*
|
||
* \param [in] con_handle range: >0.
|
||
* \param [in] att_ram_addr 传入ATT发送模块ram地址，地址按4字节对齐.
|
||
* \param [in] att_ram_size 传入ATT发送模块ram大小.
|
||
* \param [in] att_payload_size 发送ATT包payload的最大长度 <= MTU的payload,range：20 to MTU的payload size.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_att_send_init(u16 con_handle,u8 *att_ram_addr,int att_ram_size,int att_payload_size) */
|
||
#define ble_op_att_send_init(con_handle,att_ram_addr,att_ram_size,att_payload_size) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_SEND_INIT, 4, con_handle,att_ram_addr,att_ram_size,att_payload_size)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief MULTI API: 配置ATT发送模块初始化.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_multi_att_send_init(u8 *att_ram_addr,int att_ram_size,int att_payload_size).
|
||
*
|
||
* \param [in] att_ram_addr 传入ATT发送模块ram地址，地址按4字节对齐.
|
||
* \param [in] att_ram_size 传入ATT发送模块ram大小.
|
||
* \param [in] att_payload_size 发送ATT包payload的最大长度 <= MTU的payload，range：20 to MTU的payload size.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 多机处理,只需要初始化一次就可以.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_multi_att_send_init(u8 *att_ram_addr,int att_ram_size,int att_payload_size) */
|
||
#define ble_op_multi_att_send_init(att_ram_addr,att_ram_size,att_payload_size) \
|
||
ble_user_cmd_prepare(BLE_CMD_MULTI_ATT_SEND_INIT, 3, att_ram_addr,att_ram_size,att_payload_size)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief MULTI API: 配置ATT模块 使用的连接con_handle.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_multi_att_send_conn_handle(u16 con_handle,int handle_index,int0 rolev).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [in] handle_index range: 0~7 //多连接的hanlde id.
|
||
* \param [in] role range: 0-gatt_sever,1-gatt_client.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 多机处理.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_multi_att_send_conn_handle(u16 con_handle,int handle_index,int0 rolev) */
|
||
#define ble_op_multi_att_send_conn_handle(con_handle,handle_index,role) \
|
||
ble_user_cmd_prepare(BLE_CMD_MULTI_ATT_SET_CONN_HANDLE, 3, con_handle,handle_index,role)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 根据对方的接收MTU大小，配置本地可发送MTU的payload大小.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_att_set_send_mtu(u16 mtu_payload_size).
|
||
*
|
||
* \param [in] mtu_payload_size mtu的payload的大小; mtu_size-3
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_att_set_send_mtu(u16 mtu_payload_size)) */
|
||
#define ble_op_att_set_send_mtu(mtu_payload_size) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_MTU_SIZE, 1, mtu_payload_size);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief MULTI API: 根据对方的接收MTU大小，配置本地可发送的MTU的大小.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_multi_att_set_send_mtu(u16 con_handle,u16 mtu_payload_size).
|
||
*
|
||
* \param [in] con_handle 连接 con_handle,range：>0.
|
||
* \param [in] mtu_payload_size mtu的payload的大小; mtu_size-3
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_multi_att_set_send_mtu(u16 con_handle,u16 mtu_payload_size) */
|
||
#define ble_op_multi_att_set_send_mtu(con_handle,mtu_payload_size) \
|
||
ble_user_cmd_prepare(BLE_CMD_MULTI_ATT_MTU_SIZE, 2, con_handle,mtu_payload_size);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取ATT发送模块，cbuffer可写入数据的长度.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_att_get_remain(int *remain_size_ptr).
|
||
*
|
||
* \param [out] remain_size_ptr 输出可写入长度值.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_att_get_remain(int *remain_size_ptr) */
|
||
#define ble_op_att_get_remain(remain_size_ptr) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_VAILD_LEN, 1, remain_size_ptr)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief MULTI API: 获取ATT发送模块，cbuffer 可写入数据的长度.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_multi_att_get_remain(u16 con_handle,int *remain_size_ptr).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [out] remain_size_ptr 输出可写入长度值.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_multi_att_get_remain(u16 con_handle,int *remain_size_ptr) */
|
||
#define ble_op_multi_att_get_remain(con_handle,remain_size_ptr) \
|
||
ble_user_cmd_prepare(BLE_CMD_MULTI_ATT_VAILD_LEN, 2,con_handle, remain_size_ptr)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ATT操作handle发送数据.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_att_send_data(u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type).
|
||
*
|
||
* \param [in] att_handle att操作的handle.
|
||
* \param [in] data 数据地址.
|
||
* \param [in] len 数据长度 <= cbuffer 可写入的长度.
|
||
* \param [in] att_op_type see att_op_type_e (att.h).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_att_send_data(u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type) */
|
||
#define ble_op_att_send_data(att_handle,data,len,att_op_type) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_SEND_DATA, 4, att_handle, data, len, att_op_type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief MULTI API: ATT操作handle发送数据.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_multi_att_send_data(u16 con_handle,u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type).
|
||
*
|
||
* \param [in] con_handle 连接 con_handle,range：>0.
|
||
* \param [in] att_handle att操作handle.
|
||
* \param [in] data 数据地址.
|
||
* \param [in] len 数据长度 <= cbuffer 可写入的长度.
|
||
* \param [in] att_op_type see att_op_type_e (att.h).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 多机处理.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_multi_att_send_data(u16 con_handle,u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type) */
|
||
#define ble_op_multi_att_send_data(con_handle,att_handle,data,len,att_op_type) \
|
||
ble_user_cmd_prepare(BLE_CMD_MULTI_ATT_SEND_DATA, 5, con_handle,att_handle, data, len, att_op_type)
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ATT操作,清默认缓存发送的数据缓存
|
||
*
|
||
* \function ble_op_att_clear_data(void).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_att_clear_send_data(void) */
|
||
#define ble_op_att_clear_send_data(void) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_CLEAR_SEND_DATA, 1, 1)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 从机请求更新连接参数,走l2cap命令.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_conn_param_request(u16 con_handle,const struct conn_update_param_t *con_param).
|
||
*
|
||
* \param [in] con_handle 连接 con_handle,range：>0.
|
||
* \param [in] con_param (全局变量地址),连接参数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_conn_param_request(u16 con_handle,const struct conn_update_param_t *con_param) */
|
||
#define ble_op_conn_param_request(con_handle,con_param) \
|
||
ble_user_cmd_prepare(BLE_CMD_REQ_CONN_PARAM_UPDATE, 2, con_handle, (void*)con_param)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 发起data length 交换.(btctrl的feature打开支持DLE)
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_data_length(u16 con_handle,u16 tx_octets,u16 tx_time).
|
||
*
|
||
* \param [in] tx_octets DLE发送长度.
|
||
* \param [in] tx_time DLE发送事件.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_data_length(u16 con_handle,u16 tx_octets,u16 tx_time) */
|
||
#define ble_op_set_data_length(con_handle,tx_octets,tx_time) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_DATA_LENGTH, 3, con_handle, tx_octets, tx_time)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置广播参数.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_adv_param(u8 *param,u16 param_len).
|
||
*
|
||
* \param [in] param 广播参数.
|
||
* \param [in] tx_time 参数长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_adv_param(u8 *param,u16 param_len) */
|
||
#define ble_op_set_ext_adv_param(param,param_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_ADV_PARAM, 2, param, param_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置 adv 数据包.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_adv_data(u8 *data,u16 data_len).
|
||
*
|
||
* \param [in] data 数据包内容.
|
||
* \param [in] data_len 数据包长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_adv_data(u8 *data,u16 data_len) */
|
||
#define ble_op_set_ext_adv_data(data,data_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_ADV_DATA, 2, data, data_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置 respond 数据包.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_rsp_data(u8 *data,u16 data_len).
|
||
*
|
||
* \param [in] data 数据包内容.
|
||
* \param [in] data_len 数据包长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_rsp_data(u8 *data,u16 data_len) */
|
||
#define ble_op_set_ext_rsp_data(data,data_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_RSP_DATA, 2, data, data_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 开关广播.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_adv_enable(u8 *cmd,u16 cmd_le).
|
||
*
|
||
* \param [in] cmd 命令信息.
|
||
* \param [in] cmd_len 命令长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_adv_enable(u8 *cmd,u16 cmd_le) */
|
||
#define ble_op_set_ext_adv_enable(cmd,cmd_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_ADV_ENABLE, 2, cmd, cmd_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置phy.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_phy(u16 con_handle,u16 all_phys,u16 tx_phy,u16 rx_phy,u16 phy_options).
|
||
*
|
||
* \param [in] con_handle 连接 con_handle,range：>0.
|
||
* \param [in] all_phys 0.
|
||
* \param [in] tx_phy CONN_SET_CODED_PHY.
|
||
* \param [in] rx_phy CONN_SET_CODED_PHY.
|
||
* \param [in] phy_options CONN_SET_PHY_OPTIONS.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_phy(u16 con_handle,u16 all_phys,u16 tx_phy,u16 rx_phy,u16 phy_options) */
|
||
#define ble_op_set_ext_phy(con_handle,all_phys,tx_phy,rx_phy,phy_options) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_PHY, 5, con_handle, all_phys, tx_phy, rx_phy, phy_options)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置 主机scan 参数.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_ext_scan_param(u8 *param,u16 param_le).
|
||
*
|
||
* \param [in] param 参数内容.
|
||
* \param [in] param_len 参数长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_ext_scan_param(u8 *param,u16 param_le) */
|
||
#define ble_op_set_ext_scan_param(param,param_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_SCAN_PARAM, 2, param, param_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置 主机scan 开关.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_ext_scan_enable(u8 *cmd,u16 cmd_le).
|
||
*
|
||
* \param [in] cmd 命令信息.
|
||
* \param [in] cmd_len 命令长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_ext_scan_enable(u8 *cmd,u16 cmd_le) */
|
||
#define ble_op_ext_scan_enable(cmd,cmd_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_SCAN_ENABLE, 2, cmd, cmd_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble5.0 配置 主机创建连接监听.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_ext_create_conn(u8 *conn_param,u16 param_len_len).
|
||
*
|
||
* \param [in] conn_param 连接参数信息.
|
||
* \param [in] param_len 参数长度.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_ext_create_conn(u8 *conn_param,u16 param_len_len) */
|
||
#define ble_op_ext_create_conn(conn_param,param_len) \
|
||
ble_user_cmd_prepare(BLE_CMD_EXT_CREATE_CONN, 2, conn_param, param_len)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 忽略进入latency 作用的次数
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_latency_skip(u16 con_handle,u16 skip_interval).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [in] skip_interval 忽略的interval的次数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：让设备不进入latency模式，加快响应速度，但会耗电.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_latency_skip(u16 con_handle,u16 skip_interval) */
|
||
#define ble_op_latency_skip(con_handle,skip_interval) \
|
||
ble_user_cmd_prepare(BLE_CMD_LATENCY_HOLD_CNT, 2, con_handle, skip_interval)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 测试盒识别按键测试.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_test_key_num(u16 con_handle,u8 key_num).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [in] key_num 按键.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_test_key_num(u16 con_handle,u8 key_num) */
|
||
#define ble_op_test_key_num(con_handle,key_num) \
|
||
ble_user_cmd_prepare(BLE_CMD_SEND_TEST_KEY_NUM, 2, con_handle, key_num)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 退出ble协议栈.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_stack_exit(u8 control).
|
||
*
|
||
* \param [in] control : 0--退出stack(默认),1--退出stack + controller.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 若已调用btstack_exit退出,则无需调用此接口
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_stack_exit(u8 control) */
|
||
#define ble_op_stack_exit(control) \
|
||
ble_user_cmd_prepare(BLE_CMD_STACK_EXIT, 1, control)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 挂载协议栈线程调用.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_regist_thread_call(void (*thread_callback)(void)).
|
||
*
|
||
* \param [in] thread_callback 回调函数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 用于同步线程处理，慎用
|
||
*
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_regist_thread_call(void (*thread_callback)(void)) */
|
||
#define ble_op_regist_thread_call(thread_callback) \
|
||
ble_user_cmd_prepare(BLE_CMD_REGIEST_THREAD, 1, thread_callback)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 开关BLE搜索扫描.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_scan_enable(u8 enable).
|
||
*
|
||
* \param [in] enable 0 or 1.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note filter_duplicate 默认为 1.
|
||
* \note !!!注意：开搜索前必现先配置好搜索的参数ble_op_set_scan_param.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_scan_enable(u8 enable) */
|
||
#define ble_op_scan_enable(enable) \
|
||
ble_user_cmd_prepare(BLE_CMD_SCAN_ENABLE, 1, enable)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 开关BLE搜索扫描2.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_scan_enable2(u8 enable,u8 filter_duplicate).
|
||
*
|
||
* \param [in] enable 0 or 1.
|
||
* \param [in] filter_duplicate 0 or 1.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note filter_duplicate 默认为 1.
|
||
* \note !!!注意：开搜索前必现先配置好搜索的参数ble_op_set_scan_param.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_scan_enable2(u8 enable,u8 filter_duplicate) */
|
||
#define ble_op_scan_enable2(enable,filter_duplicate) \
|
||
ble_user_cmd_prepare(BLE_CMD_SCAN_ENABLE2, 2, enable,filter_duplicate)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置scan filter policy,默认type为0.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_scan_filter_policy(u8 type).
|
||
*
|
||
* \param [in] type Range: 0x00 to 0x03.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必须在 设置扫描参数 ble_op_set_scan_param 前配置好.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_scan_filter_policy(u8 type) */
|
||
#define ble_op_set_scan_filter_policy(type) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_HCI_CFG, 2,HCI_CFG_SCAN_FILTER_POLICY,type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置搜索参数.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_scan_param(u8 scan_type,u16 scan_interval,u16 scan_window).
|
||
*
|
||
* \param [in] scan_type 搜索类型 Range: 0x00 to 0x01 (unit: 0.625ms).
|
||
* \param [in] scan_interval 搜索周期 Range: 0x0004 to 0x4000 (unit: 0.625ms) >= scan_window.
|
||
* \param [in] scan_window 搜索窗口 Range: 0x0004 to 0x4000 (unit: 0.625ms), <= scan_interval.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_scan_param(u8 scan_type,u16 scan_interval,u16 scan_window) */
|
||
#define ble_op_set_scan_param(scan_type,scan_interval,scan_window) \
|
||
ble_user_cmd_prepare(BLE_CMD_SCAN_PARAM, 3, scan_type, scan_interval, scan_window)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置creat filter policy,默认type: 0.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_set_create_filter_policy(u8 type).
|
||
*
|
||
* \param [in] type Range: 0x00 to 0x03.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note !!!注意：设置的时候必须在 设置创建连接参数 ble_op_create_connection 前配置好.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_set_create_filter_policy(u8 type) */
|
||
#define ble_op_set_create_filter_policy(type) \
|
||
ble_user_cmd_prepare(BLE_CMD_SET_HCI_CFG, 2,HCI_CFG_INITIATOR_FILTER_POLICY,type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief BLE创建连接监听.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_create_connection(struct create_conn_param_t * create_conn_param).
|
||
*
|
||
* \param [in] create_conn_param 连接参数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_create_connection(struct create_conn_param_t * create_conn_param) */
|
||
#define ble_op_create_connection(create_conn_param) \
|
||
ble_user_cmd_prepare(BLE_CMD_CREATE_CONN, 1, create_conn_param)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief BLE创建连接监听,扩展传入参数
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_create_connection_ext(cosnt struct create_conn_param_ext_t * create_conn_param_ext).
|
||
*
|
||
* \param [in] create_conn_param_ext 连接参数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_create_connection_ext(const struct create_conn_param_ext_t * create_conn_param_ext) */
|
||
#define ble_op_create_connection_ext(create_conn_param_ext) \
|
||
ble_user_cmd_prepare(BLE_CMD_CREATE_CONN_EXT, 1, create_conn_param_ext)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 取消BLE连接监听.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_create_connection_cancel(void).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_create_connection_cancel(void) */
|
||
#define ble_op_create_connection_cancel() \
|
||
ble_user_cmd_prepare(BLE_CMD_CREATE_CONN_CANCEL,0)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 主机搜索所有服务.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_search_profile_all(void).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_search_profile_all(void) */
|
||
#define ble_op_search_profile_all() \
|
||
ble_user_cmd_prepare(BLE_CMD_SEARCH_PROFILE, 2, PFL_SERVER_ALL, 0)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 主机搜索指定UUID16服务.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_search_profile_uuid16(u16 uuid16).
|
||
*
|
||
* \param [in] uuid16 uuid.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_search_profile_uuid16(u16 uuid16) */
|
||
#define ble_op_search_profile_uuid16(uuid16) \
|
||
ble_user_cmd_prepare(BLE_CMD_SEARCH_PROFILE, 2, PFL_SERVER_UUID16, uuid16)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 主机搜索指定UUID128服务.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_search_profile_uuid128(const u8 *uuid128_pt).
|
||
*
|
||
* \param [in] uuid128_pt uuid.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_search_profile_uuid128(const u8 *uuid128_pt) */
|
||
#define ble_op_search_profile_uuid128(uuid128_pt) \
|
||
ble_user_cmd_prepare(BLE_CMD_SEARCH_PROFILE, 2, PFL_SERVER_UUID128, uuid128_pt)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 主机更新连接参数.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_conn_param_update(u16 con_handle,struct conn_update_param_t *con_param).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [in] con_param (全局变量地址)，连接参数.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_conn_param_update(u16 con_handle,struct conn_update_param_t *con_param) */
|
||
#define ble_op_conn_param_update(con_handle,con_param) \
|
||
ble_user_cmd_prepare(BLE_CMD_ONNN_PARAM_UPDATA, 2, con_handle, con_param)
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief API: 配置ATT,第二套缓存发送模块初始化(优先级比默认缓存高).
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_high_att_send_init(u8 *att_ram_addr,int att_ram_size).
|
||
*
|
||
* \param [in] att_ram_addr 传入ATT发送模块ram地址，地址按4字节对齐.
|
||
* \param [in] att_ram_size 传入ATT发送模块ram大小.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note 必须在原有的缓存初始化使用后，才能再初始化新的缓存使用.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_high_att_send_init(u8 *att_ram_addr,int att_ram_size) */
|
||
#define ble_op_high_att_send_init(att_ram_addr,att_ram_size) \
|
||
ble_user_cmd_prepare(BLE_CMD_HIGH_ATT_SEND_INIT, 2, att_ram_addr,att_ram_size)
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief API: ATT操作high 缓存 handle发送数据.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_high_att_send_data(u16 con_handle,u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type).
|
||
*
|
||
* \param [in] con_handle 连接 con_handle,range：>0.
|
||
* \param [in] att_handle att操作handle.
|
||
* \param [in] data 数据地址.
|
||
* \param [in] len 数据长度 <= cbuffer 可写入的长度.
|
||
* \param [in] att_op_type see att_op_type_e (att.h).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*
|
||
* \note
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_high_att_send_data(u16 con_handle,u16 att_handle,u8 *data,u16 len, att_op_type_e att_op_type) */
|
||
#define ble_op_high_att_send_data(con_handle,att_handle,data,len,att_op_type) \
|
||
ble_user_cmd_prepare(BLE_CMD_HIGH_ATT_SEND_DATA, 5, con_handle,att_handle, data, len, att_op_type)
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ATT操作,清high缓存发送的数据缓存
|
||
*
|
||
* \function ble_op_high_att_clear_send_data(void).
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_high_att_clear_send_data(void) */
|
||
#define ble_op_high_att_clear_send_data(void) \
|
||
ble_user_cmd_prepare(BLE_CMD_ATT_CLEAR_SEND_DATA, 1, 2)
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief API: 获取ATT发送模块,high 缓存cbuffer 可写入数据的长度.
|
||
*
|
||
* \function ble_cmd_ret_e ble_op_high_att_get_remain(u16 con_handle,int *remain_size_ptr).
|
||
*
|
||
* \param [in] con_handle range：>0.
|
||
* \param [out] remain_size_ptr 输出可写入长度值.
|
||
*
|
||
* \return see ble_cmd_ret_e.
|
||
*/
|
||
/*************************************************************************************************/
|
||
/* ble_cmd_ret_e ble_op_high_att_get_remain(u16 con_handle,int *remain_size_ptr) */
|
||
#define ble_op_high_att_get_remain(con_handle,remain_size_ptr) \
|
||
ble_user_cmd_prepare(BLE_CMD_HIGH_ATT_VAILD_LEN, 2,con_handle, remain_size_ptr)
|
||
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble master&slave 配置配对表(可以不设置,使用sdk默认值).
|
||
*
|
||
* \param [in] pair_devices_count 记录配对设备,range: 0~10,默认10.若配置为0:则不使用配对表记录管理，不限制配对个数.
|
||
* \param [in] is_allow_cover 是否允许循环覆盖记录 1 or 0,默认1.
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note 上电调用配置,若配置的个数跟之前不一样，默认清所有的配对表数据.
|
||
* \note VM 掉电记录保护.
|
||
* \note 主从机共用一个配对表.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void ble_list_config_reset(u8 pair_devices_count, u8 is_allow_cover);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 配置是否接受新设备请求配对,记录在VM,(可以不设置,使用sdk默认值).
|
||
*
|
||
* \param [in] enable 允许新设备配对开关,1 or 0,默认1.
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note VM 掉电记录保护.
|
||
* \note 是否覆盖是由接口 ble_list_config_reset 的参数 is_allow_cover 决定.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_pair_accept(u8 enable);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 当前配置是否接受新设备请求配对
|
||
*
|
||
* \param [in] NULL
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note VM 掉电记录保护.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_is_pair_accept(void);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取配对表已有配对个数.
|
||
*
|
||
* \return 0~10.
|
||
*/
|
||
/*************************************************************************************************/
|
||
u16 ble_list_get_count(void);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 绑定已配对的指定设备,清除其他配对设备.
|
||
*
|
||
* \param [in] conn_addr 对方地址6bytes.
|
||
* \param [in] conn_addr_type 对方地址类型range: 0~1.
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note VM 掉电记录保护.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_bonding_remote(u8 *conn_addr, u8 conn_addr_type);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 清空配对表(包括主从机).
|
||
*
|
||
* \return true or false.
|
||
* \note 执行效率快.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_clear_all(void);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 清除对应角色的配对列表
|
||
*
|
||
* \param [in] role, 本地设备的角色: 1--slave, 0--master
|
||
* \return true or false.
|
||
* \note 查找方式逐个删除,不区分主从删除建议使用接口 ble_list_clear_all
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_role_clear_all(u8 role);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 检测连接地址是否在已配对表中.
|
||
*
|
||
* \param [in] conn_addr 对方地址6bytes.
|
||
* \param [in] conn_addr_type 对方地址类型range: 0~1.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_check_addr_is_exist(u8 *conn_addr, u8 conn_addr_type);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 把记录对方设备的信息从配对表中删除.
|
||
*
|
||
* \param [in] conn_addr 对方地址6bytes.
|
||
* \param [in] conn_addr_type 对方地址类型range: 0~1.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_delete_device(u8 *conn_addr, u8 conn_addr_type);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 根据记录本地地址的信息,从配对表中删除.(适用于不同通道本地地址不一样,清空通道记录信息)
|
||
*
|
||
* \param [in] local_addr 本地地址6bytes.
|
||
* \param [in] local_addr_type 本地地址类型range: 0~1.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_delete_device_by_local_address(u8 *local_addr, u8 local_addr_type);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 获取配对表中最后连接设备的 id_address (public address).
|
||
*
|
||
* \param [out] id_addr 输出最后连接设备的id地址.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_get_last_id_addr(u8 *id_addr);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 获取已配对设备连接地址对应的 id_address (public address or static address).
|
||
*
|
||
* \param [in] conn_addr 对方连接地址6bytes.
|
||
* \param [in] conn_addr_type 对方连接地址类型range: 0~1.
|
||
* \param [out] id_addr 输出已配对设备的id地址.
|
||
*
|
||
* \return true or false.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_get_id_addr(u8 *conn_addr, u8 conn_addr_type, u8 *id_addr);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble 获取已配对设备的系统类型.
|
||
*
|
||
* \param [in] conn_addr 对方连接地址6bytes.
|
||
* \param [in] conn_addr_type 对方连接地址类型range: 0~1.
|
||
* \param [out] output_type 见 remote_type_e 定义.
|
||
*
|
||
* \return true or false.
|
||
*
|
||
* \note 只支持作为从机获取手机类型.
|
||
*/
|
||
/*************************************************************************************************/
|
||
bool ble_list_get_remote_type(u8 *conn_addr, u8 conn_addr_type, u8 *output_type);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble slave: att server 连接后主动发起请求MTU交换流程.
|
||
*
|
||
* \param [in] handle range：>0.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void att_server_set_exchange_mtu(u16 con_handle);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble slave: att server 使能流控功能.
|
||
*
|
||
* \param [in] handle range：>0.
|
||
* \param [in] enable 1 or 0.
|
||
*
|
||
* \note 蓝牙初始化后可调用.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void att_server_flow_enable(u8 enable);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble slave: att server 控制收数流控.
|
||
*
|
||
* \param [in] handle range：>0.
|
||
* \param [in] hold_flag 1--停止收发数据，0--开始正常收发数.
|
||
*
|
||
* \note 蓝牙初始化后可调用,对方client要使用write的方式发送数据才能有流控生效
|
||
*/
|
||
/*************************************************************************************************/
|
||
void att_server_flow_hold(hci_con_handle_t con_handle, u8 hold_flag);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble master: client 控制收数流控.
|
||
*
|
||
* \param [in] handle range：>0.
|
||
* \param [in] hold_flag 1--停止收发数据，0--开始正常收发数.
|
||
*
|
||
* \note 对方serverd要使用indication的方式发送数据才能有流控生效
|
||
* \return 0->success ,非0->fail.
|
||
*/
|
||
/*************************************************************************************************/
|
||
int ble_att_client_set_flow(hci_con_handle_t con_handle, u8 hold_flag);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief ble slave: server 配对连接时，检查对方操作系统.
|
||
*
|
||
* \param [in] handle range：>0.
|
||
* \param [in] callback 检查完回调.
|
||
*
|
||
* \note 在第一次配对连接时调用，HCI_EVENT_ENCRYPTION_CHANGE 事件后.
|
||
*/
|
||
/*************************************************************************************************/
|
||
void att_server_set_check_remote(u16 con_handle, void (*callback)(u16 con_handle, remote_type_e remote_type));
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 检测协议栈att模块是否支持多机.
|
||
*
|
||
* \param [in] server_max 传入判断的从机个数.
|
||
* \param [in] client_max 传入判断的主机个数·.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*/
|
||
/*************************************************************************************************/
|
||
int att_send_check_multi_dev(u8 server_max, u8 client_max);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 可修改GATT服务的profile.
|
||
*
|
||
* \param [in] profile_data gatt profile.
|
||
*
|
||
* \return 0->success ,非0->fail.
|
||
*
|
||
* \note 蓝牙未连接状态下,可调用修改.
|
||
*/
|
||
/*************************************************************************************************/
|
||
int att_server_change_profile(u8 const *profile_data);
|
||
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取server的mtu大小.
|
||
*
|
||
* \param [in] con_handle range :>0.
|
||
*
|
||
* \return mtu size
|
||
*
|
||
* \note 蓝牙未连接状态下,可调用修改.
|
||
*/
|
||
/*************************************************************************************************/
|
||
u16 ble_att_server_get_link_mtu(u16 con_handle);
|
||
|
||
/*************************************************************************************************/
|
||
/*!
|
||
* \brief 获取client的mtu大小.
|
||
*
|
||
* \param [in] con_handle range :>0.
|
||
*
|
||
* \return mtu size
|
||
*
|
||
* \note 蓝牙未连接状态下,可调用修改.
|
||
*/
|
||
/*************************************************************************************************/
|
||
u16 ble_att_client_get_link_mtu(u16 con_handle);
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
#endif
|
||
|