/********************************************************************************************* * 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 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