|
| 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) |
| | 连接参数更新的回调函数。
|
| |
| typedef void(* | gap_state_changed_callback) (const int transport, const int status) |
| | 蓝牙开关回调函数。
|
| |
| typedef void(* | gap_acl_state_changed_callback) (const bd_addr_t *bd_addr, gap_acl_state_t state, unsigned int reason) |
| | 蓝牙ACL连接状态变化回调函数。
|
| |
| typedef void(* | gap_discovery_state_changed_callback) (int status) |
| | 蓝牙发现状态变化回调函数。
|
| |
| typedef void(* | gap_discovery_result_callback) (const bd_addr_t *bd_addr) |
| | 蓝牙发现结果回调函数。
|
| |
| typedef void(* | gap_pair_requested_callback) (const bd_addr_t *bd_addr) |
| | 蓝牙配对请求回调函数。
|
| |
| typedef void(* | gap_pair_confirmed_callback) (const bd_addr_t *bd_addr, int req_type, int number) |
| | 蓝牙配对确认回调函数。
|
| |
| typedef void(* | gap_scan_mode_changed_callback) (int mode) |
| | 蓝牙广播模式变化回调函数。
|
| |
| typedef void(* | gap_local_device_name_changed_callback) (const unsigned char *device_name, unsigned char length) |
| | 蓝牙本地设备名称变化回调函数。
|
| |
| typedef void(* | gap_local_device_addr_changed_callback) (const bd_addr_t *bd_addr) |
| | 蓝牙本地设备地址变化回调函数。
|
| |
| typedef void(* | gap_pair_status_changed_callback) (const bd_addr_t *bd_addr, int status) |
| | 蓝牙配对状态变化回调函数。
|
| |
| typedef void(* | gap_remote_uuid_changed_callback) (const bd_addr_t *bd_addr, bt_uuid_t uuid) |
| | 远端设备UUID变化回调函数。
|
| |
| typedef void(* | gap_remote_name_changed_callback) (const bd_addr_t *bd_addr, const unsigned char *device_name, unsigned char length) |
| | 远端设备名称变化回调函数。
|
| |
| typedef void(* | gap_remote_alias_changed_callback) (const bd_addr_t *bd_addr, const unsigned char *alias, unsigned char length) |
| | 远端设备昵称变化回调函数。
|
| |
| typedef void(* | gap_remote_cod_changed_callback) (const bd_addr_t *bd_addr, int cod) |
| | 远端设备类型变化回调函数。
|
| |
| typedef void(* | gap_remote_battery_level_changed_callback) (const bd_addr_t *bd_addr, int battery_level) |
| | 远端设备电量变化回调函数。
|
| |
| typedef void(* | gap_read_remote_rssi_event_callback) (const bd_addr_t *bd_addr, int rssi, int status) |
| | 远端设备信号强度变化回调函数。
|
| |
| typedef void(* | gap_is_accept_conn_on_safe_mode_callback) (const bd_addr_t *bd_addr, bool *res) |
| | 询问上层应用是否接受连接回调函数。
|
| |
|
| 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链路状态。 更多...
|
| |
| enum | bt_stack_state_t { BT_STACK_STATE_TURNING_ON = 0x0
, BT_STACK_STATE_TURN_ON
, BT_STACK_STATE_TURNING_OFF
, BT_STACK_STATE_TURN_OFF
} |
| | 蓝牙协议栈状态。 更多...
|
| |
| enum | bt_connect_strategy_type_t { BT_CONNECTION_UNKNOWN = 0x00
, BT_CONNECTION_ALLOWED
, BT_CONNECTION_FORBIDDEN
} |
| | 定义蓝牙的连接类型。 更多...
|
| |
| enum | a2dp_playing_state_t { A2DP_NOT_PLAYING = 0x00
, A2DP_IS_PLAYING
} |
| | 定义蓝牙a2dp的播放状态。 更多...
|
| |
| enum | hfp_sco_connect_state_t { HFP_SCO_STATE_CONNECTING = 0x01
, HFP_SCO_STATE_CONNECTED = 0x02
, HFP_SCO_STATE_DISCONNECTING = 0x03
, HFP_SCO_STATE_DISCONNECTED = 0x04
} |
| | 定义蓝牙hfp的连接状态。 更多...
|
| |
| enum | hfp_volume_type_t { HFP_VOLUME_MIC = 0x00
, HFP_VOLUME_SPEAKER
} |
| | 定义蓝牙hfp的音量调整类型。 更多...
|
| |
| enum | profile_connect_state_t { PROFILE_STATE_CONNECTING = 0x01
, PROFILE_STATE_CONNECTED = 0x02
, PROFILE_STATE_DISCONNECTING = 0x03
, PROFILE_STATE_DISCONNECTED = 0x04
} |
| | 定义蓝牙协议的连接状态。 更多...
|
| |
| enum | bt_transport_type_t { BT_TRANSPORT_INVALID = 0x00
, BT_TRANSPORT_BR_EDR = 0x01
, BT_TRANSPORT_LE = 0x02
} |
| | 定义蓝牙传输的类型。 更多...
|
| |
| enum | gap_acl_state_t { GAP_ACL_STATE_CONNECTED
, GAP_ACL_STATE_DISCONNECTED
, GAP_ACL_STATE_LE_CONNECTED
, GAP_ACL_STATE_LE_DISCONNECTED
} |
| | 蓝牙ACL连接状态。 更多...
|
| |
| enum | gap_discovery_state_t { GAP_DISCOVERY_STARTED = 0x01
, GAP_DISCOVERYING = 0x02
, GAP_DISCOVERY_STOPED = 0x03
} |
| | 蓝牙扫描状态。 更多...
|
| |
| enum | gap_bondable_mode_t { GAP_BONDABLE_MODE_OFF = 0x00
, GAP_BONDABLE_MODE_ON = 0x01
} |
| | 蓝牙绑定状态。 更多...
|
| |
| enum | gap_access_permission_type_t { GAP_ACCESS_PERMISSION_UNKNOWN
, GAP_ACCESS_PERMISSION_ALLOWED
, GAP_ACCESS_PERMISSION_FORBIDDEN
} |
| | 蓝牙访问权限。 更多...
|
| |
| enum | gap_scan_mode_t {
GAP_SCAN_MODE_NONE = 0x00
, GAP_SCAN_MODE_CONNECTABLE
, GAP_SCAN_MODE_GENERAL_DISCOVERABLE
, GAP_SCAN_MODE_LIMITED_DISCOVERABLE
,
GAP_SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE
, GAP_SCAN_MODE_CONNECTABLE_LIMITED_DISCOVERABLE
} |
| | 蓝牙扫描模式。 更多...
|
| |
| enum | bt_profile_type_t {
BT_PROFILE_HEADSET = 0x0
, BT_PROFILE_A2DP
, BT_PROFILE_OPP
, BT_PROFILE_HID
,
BT_PROFILE_PANU
, BT_PROFILE_NAP
, BT_PROFILE_HFP
} |
| | 蓝牙Profile类型。 更多...
|
| |
| enum | gap_pair_state_t { GAP_PAIR_NONE = 0x01
, GAP_PAIR_PAIRING = 0x02
, GAP_PAIR_PAIRED = 0x03
} |
| | 蓝牙配对状态。 更多...
|
| |
| enum | gap_pair_confirm_type_t {
GAP_PAIR_CONFIRM_TYPE_PIN_CODE = 0x01
, GAP_PAIR_CONFIRM_TYPE_PASSKEY_DISPLAY = 0x02
, GAP_PAIR_CONFIRM_TYPE_PASSKEY_INPUT = 0x03
, GAP_PAIR_CONFIRM_TYPE_NUMERIC = 0x04
,
GAP_PAIR_CONFIRM_TYPE_CONSENT = 0x05
} |
| | 蓝牙配对类型。 更多...
|
| |
|
| 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) |
| | 配置定制化信息
|
| |
| errcode_t | enable_bt_stack (void) |
| | 使能BT协议栈。
|
| |
| errcode_t | disable_bt_stack (void) |
| | 去使能BT协议栈。
|
| |
| errcode_t | bluetooth_set_local_addr (unsigned char *mac, unsigned int len) |
| | 设置本地设备地址。
|
| |
| errcode_t | bluetooth_get_local_addr (unsigned char *mac, unsigned int len) |
| | 获取本地设备地址。
|
| |
| errcode_t | bluetooth_get_local_name (unsigned char *local_name, unsigned char *length) |
| | 获取本地设备名称。
|
| |
| errcode_t | bluetooth_set_local_name (const unsigned char *local_name, unsigned char length) |
| | 设置本地设备名称。
|
| |
| bool | bluetooth_factory_reset (void) |
| | 恢复蓝牙出厂设置。
|
| |
| int | gap_br_get_scan_mode (void) |
| | 获取蓝牙广播模式。
|
| |
| bool | gap_br_set_bt_scan_mode (int mode, int duration) |
| | 设置蓝牙广播模式。
|
| |
| bool | gap_get_paired_devices_num (unsigned int *number) |
| | 获取配对设备数量。
|
| |
| bool | gap_get_paired_devices_list (gap_paired_device_info_t *dev_info, int *number) |
| | 获取配对设备列表。
|
| |
| int | gap_get_pair_state (const bd_addr_t *addr) |
| | 获取设备的配对状态。
|
| |
| bool | gap_remove_pair (const bd_addr_t *addr) |
| | 删除配对设备。
|
| |
| bool | gap_remove_all_pairs (void) |
| | 删除所有配对设备。
|
| |
| bool | bt_is_acl_connected (const bd_addr_t *addr) |
| | 检查ACL链路是否连接。
|
| |
| errcode_t | gap_disconnect_remote_device (const bd_addr_t *addr) |
| | 断开设备连接。
|
| |
| errcode_t | gap_connect_remote_device (const bd_addr_t *addr) |
| | 与设备建立连接。
|
| |
| bool | gap_br_start_discovery (void) |
| | 启动扫描。
|
| |
| bool | gap_br_cancel_discovery (void) |
| | 停止扫描。
|
| |
| bool | is_bt_discovering (int transport) |
| | 检查是否正在扫描。
|
| |
| bool | gap_read_remote_rssi_value (const bd_addr_t *addr) |
| | 获取远端设备RSSI信号强度。
|
| |
| bool | gap_get_device_name (const bd_addr_t *addr, unsigned char *remote_name, unsigned char *length) |
| | 获取远端设备名称。
|
| |
| int | gap_get_device_class (const bd_addr_t *addr) |
| | 获取远端设备CoD。
|
| |
| int | gap_register_callbacks (gap_call_backs_t *func) |
| | 注册GAP回调函数。
|
| |
Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
Description: BTS GAP module.
1.9.8