WS63 SDK 文档 7021f4f@fbb_ws63
ws63 和 ws63e 解决方案的 SDK 文档
载入中...
搜索中...
未找到
bts_le_gap.h 文件参考
#include <stdint.h>
#include "errcode.h"
#include "bts_def.h"
bts_le_gap.h 的引用(Include)关系图:

浏览源代码.

结构体

struct  gap_conn_param_update_t
 ble连接参数更新数据结构。 更多...
 
struct  gap_le_set_phy_t
 BLE PHY参数数据结构。 更多...
 
struct  gap_le_set_data_length_t
 BLE发包参数数据结构。 更多...
 
struct  gap_ble_config_adv_data_t
 BLE广播数据。 更多...
 
struct  gap_ble_adv_data_filter_t
 
struct  gap_ble_adv_params_t
 BLE广播参数。 更多...
 
struct  gap_ble_scan_params_t
 BLE扫描参数。 更多...
 
struct  gap_scan_result_data_t
 扫描结果数据。 更多...
 
struct  gap_ble_extern_scan_params_t
 BLE扫描扩展参数。 更多...
 
struct  gap_ble_conn_param_update_t
 ACL链路更新事件参数 更多...
 
struct  gap_ble_sec_params_t
 BLE广播参数。 更多...
 
struct  ble_auth_info_evt_t
 BLE认证结果。 更多...
 
struct  gap_ble_callbacks_t
 GAP BLE回调函数接口定义。 更多...
 

宏定义

#define BLE_PAIRED_LTK_LEN   16
 蓝牙设备配对的LTK长度。
 

类型定义

typedef void(* gap_ble_enable_callback) (errcode_t status)
 ble协议栈启动回调函数。
 
typedef void(* gap_ble_disable_callback) (errcode_t status)
 ble协议栈关闭回调函数。
 
typedef void(* gap_ble_start_adv_callback) (uint8_t adv_id, adv_status_t status)
 启动广播回调函数。
 
typedef void(* gap_ble_stop_adv_callback) (uint8_t adv_id, adv_status_t status)
 停止广播回调函数。
 
typedef void(* gap_ble_set_adv_data_callback) (uint8_t adv_id, errcode_t status)
 设置广播数据后的回调函数。
 
typedef void(* gap_ble_set_adv_param_callback) (uint8_t adv_id, errcode_t status)
 设置广播参数后的回调函数。
 
typedef void(* gap_ble_scan_result_callback) (gap_scan_result_data_t *scan_result_data)
 启动扫描后的回调函数。
 
typedef void(* gap_ble_set_scan_param_callback) (errcode_t status)
 扫描参数设置完成后的回调函数。
 
typedef void(* gap_ble_connect_state_changed_callback) (uint16_t conn_id, bd_addr_t *addr, gap_ble_conn_state_t conn_state, gap_ble_pair_state_t pair_state, gap_ble_disc_reason_t disc_reason)
 连接事件完成的回调函数。
 
typedef void(* gap_ble_paired_complete_callback) (uint16_t conn_id, const bd_addr_t *addr, errcode_t status)
 配对事件完成的回调函数。
 
typedef void(* gap_ble_terminate_adv_callback) (uint8_t adv_id, adv_status_t status)
 配对事件完成的回调函数。
 
typedef void(* gap_ble_read_rssi_callback) (uint16_t conn_id, int8_t rssi, errcode_t status)
 读取rssi的回调函数。
 
typedef void(* gap_ble_auth_complete_callback) (uint16_t conn_id, const bd_addr_t *addr, errcode_t status, const ble_auth_info_evt_t *evt)
 认证完成的回调函数。
 
typedef void(* gap_ble_connect_param_update_callback) (uint16_t conn_id, errcode_t status, const gap_ble_conn_param_update_t *param)
 连接参数更新的回调函数。
 

枚举

enum  gap_ble_appearance_type_t {
  GAP_BLE_APPEARANCE_TYPE_UNKNOWN = 00 , GAP_BLE_APPEARANCE_TYPE_GENERIC_PHONE = 64 , GAP_BLE_APPEARANCE_TYPE_GENERIC_COMPUTER = 128 , GAP_BLE_APPEARANCE_TYPE_GENERIC_WATCH = 192 ,
  GAP_BLE_APPEARANCE_TYPE_GENERIC_DISPLAY = 320 , GAP_BLE_APPEARANCE_TYPE_GENERIC_HID = 960 , GAP_BLE_APPEARANCE_TYPE_KEYBOARD = 961 , GAP_BLE_APPEARANCE_TYPE_MOUSE = 962 ,
  GAP_BLE_APPEARANCE_TYPE_DIGITAL_PEN = 967
}
 BLE显示类型部分举例,具体参考Appearance Values文件 更多...
 
enum  gap_ble_adv_filter_allow_scan_t { GAP_BLE_ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY = 0x00 , GAP_BLE_ADV_FILTER_ALLOW_SCAN_WLST_CON_ANY = 0x01 , GAP_BLE_ADV_FILTER_ALLOW_SCAN_ANY_CON_WLST = 0x02 , GAP_BLE_ADV_FILTER_ALLOW_SCAN_WLST_CON_WLST = 0x03 }
 广播过滤参数。 更多...
 
enum  gap_ble_adv_type_t {
  GAP_BLE_ADV_CONN_SCAN_UNDIR = 0 , GAP_BLE_ADV_CONN_NONSCAN_DIR , GAP_BLE_ADV_NONCONN_SCAN_UNDIR , GAP_BLE_ADV_NONCONN_NONSCAN_UNDIR ,
  GAP_BLE_ADV_CONN_NONSCAN_DIR_LOW_DUTY
}
 广播类型。 更多...
 
enum  gap_ble_scan_type_t { GAP_BLE_SCAN_TYPE_PASSIVE = 0x00 , GAP_BLE_SCAN_TYPE_ACTIVE }
 BLE扫描类型。 更多...
 
enum  gap_ble_scan_filter_policy_t { GAP_BLE_SCAN_FILTER_POLICY_ACCEPT_ALL = 0x00 , GAP_BLE_SCAN_FILTER_POLICY_ONLY_WHITE_LIST , GAP_BLE_SCAN_FILTER_POLICY_ACCEPT_ALL_AND_RPA , GAP_BLE_SCAN_FILTER_POLICY_ONLY_WHITE_LIST_AND_RPA }
 BLE扫描过滤策略。 更多...
 
enum  gap_ble_scan_result_evt_type_t {
  GAP_BLE_EVT_NON_CONNECTABLE_NON_SCANNABLE = 0x00 , GAP_BLE_EVT_NON_CONNECTABLE_NON_SCANNABLE_DIRECTED = 0x04 , GAP_BLE_EVT_CONNECTABLE = 0x01 , GAP_BLE_EVT_CONNECTABLE_DIRECTED = 0x05 ,
  GAP_BLE_EVT_SCANNABLE = 0x02 , GAP_BLE_EVT_SCANNABLE_DIRECTED = 0x06 , GAP_BLE_EVT_LEGACY_NON_CONNECTABLE = 0x10 , GAP_BLE_EVT_LEGACY_SCANNABLE = 0x12 ,
  GAP_BLE_EVT_LEGACY_CONNECTABLE = 0x13 , GAP_BLE_EVT_LEGACY_CONNECTABLE_DIRECTED = 0x15 , GAP_BLE_EVT_LEGACY_SCAN_RSP_TO_ADV_SCAN = 0x1A , GAP_BLE_EVT_LEGACY_SCAN_RSP_TO_ADV = 0x1B
}
 BLE扫描结果广播类型。 更多...
 
enum  gap_ble_scan_result_data_status_t { GAP_BLE_DATA_COMPLETE = 0x00 , GAP_BLE_DATA_INCOMPLETE_MORE_TO_COME = 0x01 , GAP_BLE_DATA_INCOMPLETE_TRUNCATED = 0x02 }
 BLE扫描结果数据完整性。 更多...
 
enum  gap_ble_phy_type_t { GAP_BLE_PHY_NO_PACKET = 0x00 , GAP_BLE_PHY_1M = 0x01 , GAP_BLE_PHY_2M = 0x02 , GAP_BLE_PHY_CODED = 0x03 }
 BLE PHY类型。 更多...
 
enum  adv_status_t { ADV_STATUS_STOPPED = 0x00 , ADV_STATUS_ADVERTISING }
 广播状态 更多...
 
enum  gap_ble_sec_mode_t {
  GAP_BLE_GAP_SECURITY_MODE1_LEVEL1 = 0 , GAP_BLE_GAP_SECURITY_MODE1_LEVEL2 , GAP_BLE_GAP_SECURITY_MODE1_LEVEL3 , GAP_BLE_GAP_SECURITY_MODE1_LEVEL4 ,
  GAP_BLE_GAP_SECURITY_MODE2_LEVEL1 , GAP_BLE_GAP_SECURITY_MODE2_LEVEL2
}
 设备输入输出能力 更多...
 
enum  gap_ble_io_ability_t {
  GAP_BLE_IO_CAPABILITY_DISPLAYONLY = 0 , GAP_BLE_IO_CAPABILITY_DISPLAYYESNO , GAP_BLE_IO_CAPABILITY_KEYBOARDONLY , GAP_BLE_IO_CAPABILITY_NOINPUTNOOUTPUT ,
  GAP_BLE_IO_CAPABILITY_KEYBOARDDISPLAY
}
 设备输入输出能力 更多...
 
enum  gap_ble_filter_duplicates_t { GAP_BLE_FILTER_DUPLICATES_DISABLE = 0 , GAP_BLE_FILTER_DUPLICATES_ENABLE , GAP_BLE_FILTER_DUPLICATES_ENABLE_FOR_PERIOD }
 扫描过滤配置 更多...
 
enum  gap_ble_pair_state_t { GAP_BLE_PAIR_NONE = 0x01 , GAP_BLE_PAIR_PAIRING = 0x02 , GAP_BLE_PAIR_PAIRED = 0x03 }
 蓝牙配对状态。 更多...
 
enum  gap_ble_disc_reason_t { GAP_BLE_DISCONN_UNKNOWN = 0x00 , GAP_BLE_ERR_CONN_TIMEOUT = 0x8 , GAP_BLE_DICSCONNECT_BY_REMOTE_USER = 0x13 , GAP_BLE_CONN_TERMINATE_BY_LOCAL_HOST = 0x16 }
 蓝牙断链原因。 更多...
 
enum  gap_ble_conn_state_t { GAP_BLE_STATE_DISCONNECTED , GAP_BLE_STATE_CONNECTED }
 定义acl链路状态。 更多...
 

函数

errcode_t enable_ble (void)
 使能BLE协议栈。
 
errcode_t disable_ble (void)
 去使能BLE协议栈。
 
errcode_t gap_ble_set_local_addr (const bd_addr_t *addr)
 设置本地设备地址。
 
errcode_t gap_ble_get_local_addr (bd_addr_t *addr)
 获取本地设备地址。
 
errcode_t gap_ble_set_local_appearance (uint16_t appearance)
 设置本地设备地址。
 
errcode_t gap_ble_set_local_name (const uint8_t *name, const uint8_t len)
 设置本地设备名称。
 
errcode_t gap_ble_get_local_name (uint8_t *name, uint8_t *len)
 获取本地设备名称。
 
errcode_t gap_ble_set_adv_data (uint8_t adv_id, const gap_ble_config_adv_data_t *data)
 设置广播数据。
 
errcode_t gap_ble_set_adv_param (uint8_t adv_id, const gap_ble_adv_params_t *param)
 设置广播参数。
 
errcode_t gap_ble_start_adv (uint8_t adv_id)
 开始发送广播。
 
errcode_t gap_ble_stop_adv (uint8_t adv_id)
 停止发送广播。
 
errcode_t gap_ble_set_scan_parameters (const gap_ble_scan_params_t *param)
 设置扫描参数。
 
errcode_t gap_ble_set_scan_extern_parameters (const gap_ble_extern_scan_params_t *param)
 设置扫描扩展参数。
 
errcode_t gap_ble_set_adv_data_filter (uint8_t filter_count, gap_ble_adv_data_filter_t *filter_key)
 设置对扫描结果中的广播数据进行过滤的条件。
 
errcode_t gap_ble_clean_adv_data_filter (void)
 清理对扫描结果中的广播数据进行过滤的条件。
 
errcode_t gap_ble_start_scan (void)
 开始扫描。
 
errcode_t gap_ble_stop_scan (void)
 停止扫描。
 
errcode_t gap_ble_set_phy (gap_le_set_phy_t *param)
 设置BLE PHY参数。
 
errcode_t gap_ble_set_data_length (gap_le_set_data_length_t *param)
 设置BLE发包参数。
 
errcode_t gap_ble_pair_remote_device (const bd_addr_t *addr)
 启动配对。
 
errcode_t gap_ble_get_paired_devices_num (uint16_t *number)
 获取配对设备数量。
 
errcode_t gap_ble_get_paired_devices (bd_addr_t *addr, uint16_t *number)
 获取配对设备数量。
 
errcode_t gap_ble_get_pair_state (const bd_addr_t *addr, gap_ble_pair_state_t *status)
 获取设备的配对状态。
 
errcode_t gap_ble_remove_pair (const bd_addr_t *addr)
 与指定设备取消配对。
 
errcode_t gap_ble_remove_all_pairs (void)
 删除所有BLE配对设备。
 
errcode_t gap_ble_get_bonded_devices (bd_addr_t *addr, uint16_t *number)
 获取本端设备的已绑定设备。
 
errcode_t gap_ble_connect_param_update (gap_conn_param_update_t *params)
 ble连接参数更新
 
errcode_t gap_ble_connect_remote_device (const bd_addr_t *addr)
 与设备建立连接。
 
errcode_t gap_ble_disconnect_remote_device (const bd_addr_t *addr)
 断开设备连接。
 
errcode_t gap_ble_set_sec_param (gap_ble_sec_params_t *params)
 设置安全参数。
 
errcode_t gap_ble_read_remote_device_rssi (uint16_t conn_id)
 读对端rssi值
 
errcode_t gap_ble_register_callbacks (gap_ble_callbacks_t *func)
 注册ble gap回调函数。
 
errcode_t bth_ota_init (void)
 初始化bth ota通道。
 
errcode_t ble_customize_max_pwr (int8_t ble_pwr, int8_t sle_pwr)
 配置定制化信息