Infineon Logo AIROC BTSDK v4.4 - Documentation
 
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
wiced_bt_ble.h File Reference

AIROC Bluetooth Low Energy (LE) Functions. More...

Data Structures

struct  wiced_bt_ble_advert_elem_t
 
struct  wiced_bt_ble_scan_results_t
 LE inquiry result type. More...
 
struct  wiced_bt_ble_phy_preferences_t
 Host PHY preferences. More...
 
struct  wiced_bt_ble_conn_params_t
 LE connection parameteres. More...
 
struct  wiced_bt_ble_multi_adv_params_t
 

Macros

#define BTM_BLE_CHNL_MAP_SIZE   HCI_BLE_CHNL_MAP_SIZE
 
#define BTM_BLE_SCAN_MODES
 Scan modes.
 
#define BTM_BLE_DEFAULT_ADVERT_CHNL_MAP   (BTM_BLE_ADVERT_CHNL_37| BTM_BLE_ADVERT_CHNL_38| BTM_BLE_ADVERT_CHNL_39)
 
#define BTM_BLE_ADVERT_FILTER_DEFAULT   BTM_BLE_ADV_POLICY_ACCEPT_CONN_AND_SCAN
 
#define BTM_BLE_ADVERT_INTERVAL_MIN   0x0020
 
#define BTM_BLE_ADVERT_INTERVAL_MAX   0x4000
 
#define BTM_BLE_SCAN_INTERVAL_MIN   0x0004
 
#define BTM_BLE_SCAN_INTERVAL_MAX   0x4000
 
#define BTM_BLE_SCAN_WINDOW_MIN   0x0004
 
#define BTM_BLE_SCAN_WINDOW_MAX   0x4000
 
#define BTM_BLE_CONN_INTERVAL_MIN   0x0006
 
#define BTM_BLE_CONN_INTERVAL_MAX   0x0C80
 
#define BTM_BLE_CONN_LATENCY_MAX   500
 
#define BTM_BLE_CONN_SUP_TOUT_MIN   0x000A
 
#define BTM_BLE_CONN_SUP_TOUT_MAX   0x0C80
 
#define BTM_BLE_CONN_PARAM_UNDEF   0xffff /* use this value when a specific value not to be overwritten */
 
#define BTM_BLE_CONN_SUP_TOUT_DEF   700
 
#define BTM_BLE_SCAN_FAST_INTERVAL   96 /* 30 ~ 60 ms (use 60) = 96 *0.625 */
 
#define BTM_BLE_SCAN_FAST_WINDOW   48 /* 30 ms = 48 *0.625 */
 
#define BTM_BLE_SCAN_SLOW_INTERVAL_1   2048 /* 1.28 s = 2048 *0.625 */
 
#define BTM_BLE_SCAN_SLOW_WINDOW_1   18 /* 11.25 ms = 18 *0.625 */
 
#define BTM_BLE_SCAN_SLOW_INTERVAL_2   4096 /* 2.56 s = 4096 *0.625 */
 
#define BTM_BLE_SCAN_SLOW_WINDOW_2   36 /* 22.5 ms = 36 *0.625 */
 
#define BTM_BLE_CONN_INTERVAL_MIN_DEF   24 /* recommended min: 30ms = 24 * 1.25 */
 
#define BTM_BLE_CONN_INTERVAL_MAX_DEF   40 /* recommended max: 50 ms = 56 * 1.25 */
 
#define BTM_BLE_CONN_PERIPHERAL_LATENCY_DEF   0 /* 0 */
 
#define BTM_BLE_CONN_TIMEOUT_DEF   2000
 
#define BTM_BLE_DIR_CONN_FALLBACK_UNDIR   1
 
#define BTM_BLE_DIR_CONN_FALLBACK_NO_ADV   2
 
#define BTM_BLE_DIR_CONN_FALLBACK   BTM_BLE_DIR_CONN_FALLBACK_UNDIR
 
#define BTM_BLE_AUTH_SIGNATURE_SIZE   12
 LE Signature. More...
 
#define BTM_BLE_POLICY_REJECT_ALL   0x00 /* relevant to both */
 
#define BTM_BLE_POLICY_ALLOW_SCAN   0x01 /* relevant to advertiser */
 
#define BTM_BLE_POLICY_ALLOW_CONN   0x02 /* relevant to advertiser */
 
#define BTM_BLE_POLICY_ALLOW_ALL   0x03 /* relevant to both */
 
#define BTM_BLE_LIMITED_DISCOVERABLE_FLAG   (0x01 << 0)
 
#define BTM_BLE_GENERAL_DISCOVERABLE_FLAG   (0x01 << 1)
 
#define BTM_BLE_BREDR_NOT_SUPPORTED   (0x01 << 2)
 
#define BTM_BLE_SIMULTANEOUS_DUAL_MODE_TO_SAME_DEVICE_CONTROLLER_SUPPORTED   (0x01 << 3)
 Simultaneous LE and BR/EDR to Same Device Capable (Controller). More...
 
#define BTM_BLE_SIMULTANEOUS_DUAL_MODE_TO_SAME_DEVICE_HOST_SUPPORTED   (0x01 << 4)
 Simultaneous LE and BR/EDR to Same Device Capable (Host). More...
 
#define BTM_BLE_NON_LIMITED_DISCOVERABLE_FLAG   (0x00 ) /* lowest bit unset */
 
#define BTM_BLE_ADVERT_FLAG_MASK   (BTM_BLE_LIMITED_DISCOVERABLE_FLAG | BTM_BLE_BREDR_NOT_SUPPORTED | BTM_BLE_GENERAL_DISCOVERABLE_FLAG)
 
#define BTM_BLE_LIMITED_DISCOVERABLE_MASK   (BTM_BLE_LIMITED_DISCOVERABLE_FLAG )
 
#define BTM_SEC_LE_LINK_SEC_FLAGS
 security settings used with L2CAP LE COC
 
#define BTM_BLE_CONN_TYPES
 Background connection type.
 
#define BTM_BLE_SEC_ACTION_TYPES
 LE encryption method.
 
#define BTM_BLE_PREFER_1M_PHY   0x01
 
#define BTM_BLE_PREFER_2M_PHY   0x02
 
#define BTM_BLE_PREFER_LELR_PHY   0x04
 
#define BTM_BLE_PREFER_NO_LELR   0x0000
 
#define BTM_BLE_PREFER_LELR_125K   0x0001
 
#define BTM_BLE_PREFER_LELR_512K   0x0002
 
#define MULTI_ADV_MAX_NUM_INSTANCES   16
 
#define MULTI_ADV_TX_POWER_MIN   0
 
#define MULTI_ADV_TX_POWER_MAX   4
 

Typedefs

typedef uint8_t wiced_bt_ble_chnl_map_t [BTM_BLE_CHNL_MAP_SIZE]
 
typedef uint8_t wiced_bt_ble_scan_mode_t
 scan mode (see wiced_bt_ble_scan_mode_e)
 
typedef uint8_t wiced_bt_ble_scanner_filter_policy_t
 Scanner filter policy (see wiced_bt_ble_scanner_filter_policy_e)
 
typedef uint8_t wiced_bt_ble_advert_chnl_map_t
 LE advertisement channel map (see wiced_bt_ble_advert_chnl_map_e)
 
typedef uint8_t wiced_bt_ble_advert_filter_policy_t
 Advertising filter policy (see wiced_bt_ble_advert_filter_policy_e)
 
typedef uint8_t wiced_dev_ble_signature_t [BTM_BLE_AUTH_SIGNATURE_SIZE]
 Device address (see BTM_BLE_AUTH_SIGNATURE_SIZE)
 
typedef uint8_t wiced_bt_ble_advert_type_t
 LE advertisement data type (see wiced_bt_ble_advert_type_e)
 
typedef uint8_t wiced_bt_dev_ble_evt_type_t
 Scan result event value (see wiced_bt_dev_ble_evt_type_e)
 
typedef uint8_t wiced_bt_ble_conn_type_t
 Connection type (see wiced_bt_ble_conn_type_e)
 
typedef uint8_t wiced_bt_ble_sec_action_type_t
 
typedef UINT8 wiced_bt_ble_host_phy_preferences_t
 
typedef UINT16 wiced_bt_ble_lelr_phy_preferences_t
 
typedef int8_t wiced_bt_ble_adv_tx_power_t
 
typedef uint8_t wiced_bt_ble_multi_advert_type_t
 LE advertisement type (see wiced_bt_ble_multi_advert_type_e)
 
typedef uint8_t wiced_bt_ble_multi_advert_filtering_policy_t
 wiced_bt_ble_multi_advert_filtering_policy_e
 
typedef uint8_t wiced_bt_ble_privacy_mode_t
 
typedef wiced_bool_t( wiced_bt_ble_selective_conn_cback_t )(wiced_bt_device_address_t remote_bda, uint8_t *p_remote_name)
 Callback wiced_bt_ble_selective_conn_cback_t. More...
 
typedef void( wiced_bt_ble_scan_result_cback_t )(wiced_bt_ble_scan_results_t *p_scan_result, uint8_t *p_adv_data)
 Callback wiced_bt_ble_scan_result_cback_t. More...
 
typedef void( wiced_bt_ble_read_phy_complete_callback_t )(wiced_bt_ble_phy_update_t *p_phy_result)
 Callback wiced_bt_ble_read_phy_complete_callback_t. More...
 

Enumerations

enum  wiced_bt_ble_scan_mode_e { BTM_BLE_SCAN_MODE_PASSIVE = 0x00, BTM_BLE_SCAN_MODE_ACTIVE = 0x01, BTM_BLE_SCAN_MODE_NONE = 0xff }
 
enum  wiced_bt_ble_scanner_filter_policy_e {
  BTM_BLE_SCAN_POLICY_ACCEPT_ADV_RSP, BTM_BLE_SCAN_POLICY_FILTER_ADV_RSP, BTM_BLE_SCAN_POLICY_ACCEPT_RPA_DIR_ADV_RSP, BTM_BLE_SCAN_POLICY_FILTER_RPA_DIR_ADV_RSP,
  BTM_BLE_SCAN_POLICY_MAX
}
 Scanner filter policy.
 
enum  { WICED_BT_ADV_NOTIFICATION_READY, WICED_BT_ADV_NOTIFICATION_DONE }
 
enum  wiced_bt_ble_advert_chnl_map_e { BTM_BLE_ADVERT_CHNL_37 = (0x01 << 0), BTM_BLE_ADVERT_CHNL_38 = (0x01 << 1), BTM_BLE_ADVERT_CHNL_39 = (0x01 << 2) }
 advertising channel map More...
 
enum  wiced_bt_ble_advert_filter_policy_e {
  BTM_BLE_ADV_POLICY_ACCEPT_CONN_AND_SCAN = 0x00, BTM_BLE_ADV_POLICY_ACCEPT_CONN_FILTER_SCAN = 0x01, BTM_BLE_ADV_POLICY_FILTER_CONN_ACCEPT_SCAN = 0x02, BTM_BLE_ADV_POLICY_FILTER_CONN_FILTER_SCAN = 0x03,
  BTM_BLE_ADV_POLICY_MAX
}
 Advertising filter policy. More...
 
enum  wiced_bt_ble_advert_type_e {
  BTM_BLE_ADVERT_TYPE_FLAG = 0x01, BTM_BLE_ADVERT_TYPE_16SRV_PARTIAL = 0x02, BTM_BLE_ADVERT_TYPE_16SRV_COMPLETE = 0x03, BTM_BLE_ADVERT_TYPE_32SRV_PARTIAL = 0x04,
  BTM_BLE_ADVERT_TYPE_32SRV_COMPLETE = 0x05, BTM_BLE_ADVERT_TYPE_128SRV_PARTIAL = 0x06, BTM_BLE_ADVERT_TYPE_128SRV_COMPLETE = 0x07, BTM_BLE_ADVERT_TYPE_NAME_SHORT = 0x08,
  BTM_BLE_ADVERT_TYPE_NAME_COMPLETE = 0x09, BTM_BLE_ADVERT_TYPE_TX_POWER = 0x0A, BTM_BLE_ADVERT_TYPE_DEV_CLASS = 0x0D, BTM_BLE_ADVERT_TYPE_SIMPLE_PAIRING_HASH_C = 0x0E,
  BTM_BLE_ADVERT_TYPE_SIMPLE_PAIRING_RAND_C = 0x0F, BTM_BLE_ADVERT_TYPE_SM_TK = 0x10, BTM_BLE_ADVERT_TYPE_SM_OOB_FLAG = 0x11, BTM_BLE_ADVERT_TYPE_INTERVAL_RANGE = 0x12,
  BTM_BLE_ADVERT_TYPE_SOLICITATION_SRV_UUID = 0x14, BTM_BLE_ADVERT_TYPE_128SOLICITATION_SRV_UUID = 0x15, BTM_BLE_ADVERT_TYPE_SERVICE_DATA = 0x16, BTM_BLE_ADVERT_TYPE_PUBLIC_TARGET = 0x17,
  BTM_BLE_ADVERT_TYPE_RANDOM_TARGET = 0x18, BTM_BLE_ADVERT_TYPE_APPEARANCE = 0x19, BTM_BLE_ADVERT_TYPE_ADVERT_INTERVAL = 0x1a, BTM_BLE_ADVERT_TYPE_LE_BD_ADDR = 0x1b,
  BTM_BLE_ADVERT_TYPE_LE_ROLE = 0x1c, BTM_BLE_ADVERT_TYPE_256SIMPLE_PAIRING_HASH = 0x1d, BTM_BLE_ADVERT_TYPE_256SIMPLE_PAIRING_RAND = 0x1e, BTM_BLE_ADVERT_TYPE_32SOLICITATION_SRV_UUID = 0x1f,
  BTM_BLE_ADVERT_TYPE_32SERVICE_DATA = 0x20, BTM_BLE_ADVERT_TYPE_128SERVICE_DATA = 0x21, BTM_BLE_ADVERT_TYPE_CONN_CONFIRM_VAL = 0x22, BTM_BLE_ADVERT_TYPE_CONN_RAND_VAL = 0x23,
  BTM_BLE_ADVERT_TYPE_URI = 0x24, BTM_BLE_ADVERT_TYPE_INDOOR_POS = 0x25, BTM_BLE_ADVERT_TYPE_TRANS_DISCOVER_DATA = 0x26, BTM_BLE_ADVERT_TYPE_SUPPORTED_FEATURES = 0x27,
  BTM_BLE_ADVERT_TYPE_UPDATE_CH_MAP_IND = 0x28, BTM_BLE_ADVERT_TYPE_PB_ADV = 0x29, BTM_BLE_ADVERT_TYPE_MESH_MSG = 0x2A, BTM_BLE_ADVERT_TYPE_MESH_BEACON = 0x2B,
  BTM_BLE_ADVERT_TYPE_3D_INFO_DATA = 0x3D, BTM_BLE_ADVERT_TYPE_MANUFACTURER = 0xFF
}
 Advertisement data types. More...
 
enum  wiced_bt_ble_sec_flags_e { BTM_SEC_LE_LINK_ENCRYPTED = 0x01, BTM_SEC_LE_LINK_PAIRED_WITHOUT_MITM = 0x02, BTM_SEC_LE_LINK_PAIRED_WITH_MITM = 0x04 }
 
enum  wiced_bt_dev_ble_evt_type_e {
  BTM_BLE_EVT_CONNECTABLE_ADVERTISEMENT = 0x00, BTM_BLE_EVT_CONNECTABLE_DIRECTED_ADVERTISEMENT = 0x01, BTM_BLE_EVT_SCANNABLE_ADVERTISEMENT = 0x02, BTM_BLE_EVT_NON_CONNECTABLE_ADVERTISEMENT = 0x03,
  BTM_BLE_EVT_SCAN_RSP = 0x04
}
 Scan result event type. More...
 
enum  wiced_bt_ble_conn_type_e { BTM_BLE_CONN_NONE = 0x00, BTM_BLE_CONN_AUTO = 0x01, BTM_BLE_CONN_SELECTIVE = 0x02 }
 
enum  { BTM_BLE_SEC_NONE = 0x00, BTM_BLE_SEC_ENCRYPT = 0x01, BTM_BLE_SEC_ENCRYPT_NO_MITM = 0x02, BTM_BLE_SEC_ENCRYPT_MITM = 0x03 }
 
enum  wiced_bt_ble_multi_advert_start_e { MULTI_ADVERT_STOP = 0x00, MULTI_ADVERT_START = 0x01 }
 Multi-advertisement start/stop. More...
 
enum  wiced_bt_ble_multi_advert_type_e {
  MULTI_ADVERT_CONNECTABLE_UNDIRECT_EVENT = 0x00, MULTI_ADVERT_CONNECTABLE_DIRECT_EVENT = 0x01, MULTI_ADVERT_DISCOVERABLE_EVENT = 0x02, MULTI_ADVERT_NONCONNECTABLE_EVENT = 0x03,
  MULTI_ADVERT_LOW_DUTY_CYCLE_DIRECT_EVENT = 0x04
}
 Multi-advertisement type.
 
enum  wiced_bt_ble_multi_advert_filtering_policy_e { MULTI_ADVERT_FILTER_POLICY_FILTER_ACCEPT_LIST_NOT_USED = 0x00, MULTI_ADVERT_FILTER_ACCEPT_LIST_POLICY_ADV_ALLOW_UNKNOWN_CONNECTION = 0x01, MULTI_ADVERT_FILTER_ACCEPT_LIST_POLICY_ADV_ALLOW_UNKNOWN_SCANNING = 0x02, MULTI_ADVERT_FILTER_POLICY_FILTER_ACCEPT_LIST_USED_FOR_ALL = 0x03 }
 Multi-advertisement Filtering policy. More...
 
enum  { BTM_BLE_PRIVACY_MODE_NETWORK, BTM_BLE_PRIVACY_MODE_DEVICE }
 

Functions

wiced_result_t wiced_bt_start_advertisements (wiced_bt_ble_advert_mode_t advert_mode, wiced_bt_ble_address_type_t directed_advertisement_bdaddr_type, wiced_bt_device_address_ptr_t directed_advertisement_bdaddr_ptr)
 Function wiced_bt_start_advertisements. More...
 
wiced_bt_ble_advert_mode_t wiced_bt_ble_get_current_advert_mode (void)
 Function wiced_bt_ble_get_current_advert_mode. More...
 
wiced_result_t wiced_bt_ble_set_raw_advertisement_data (UINT8 num_elem, wiced_bt_ble_advert_elem_t *p_data)
 Function wiced_bt_ble_set_raw_advertisement_data. More...
 
wiced_bt_dev_status_t wiced_bt_ble_set_raw_scan_response_data (uint8_t num_elem, wiced_bt_ble_advert_elem_t *p_data)
 Function wiced_bt_ble_set_raw_scan_response_data. More...
 
wiced_bt_dev_status_t wiced_bt_ble_observe (wiced_bool_t start, uint8_t duration, wiced_bt_ble_scan_result_cback_t *p_scan_result_cback)
 Function wiced_bt_ble_observe. More...
 
wiced_result_t wiced_bt_ble_scan (wiced_bt_ble_scan_type_t scan_type, wiced_bool_t duplicate_filter_enable, wiced_bt_ble_scan_result_cback_t *p_scan_result_cback)
 Function wiced_bt_ble_scan. More...
 
wiced_bt_ble_scan_type_t wiced_bt_ble_get_current_scan_state (void)
 Function wiced_bt_ble_get_current_scan_state. More...
 
void wiced_bt_ble_security_grant (wiced_bt_device_address_t bd_addr, uint8_t res)
 Function wiced_bt_ble_security_grant. More...
 
wiced_bool_t wiced_bt_ble_data_signature (wiced_bt_device_address_t bd_addr, uint8_t *p_text, uint16_t len, wiced_dev_ble_signature_t signature)
 Function wiced_bt_ble_data_signature. More...
 
wiced_bool_t wiced_bt_ble_verify_signature (wiced_bt_device_address_t bd_addr, uint8_t *p_orig, uint16_t len, uint32_t counter, uint8_t *p_comp)
 Function wiced_bt_ble_verify_signature. More...
 
wiced_bool_t wiced_bt_ble_set_background_connection_type (wiced_bt_ble_conn_type_t conn_type, wiced_bt_ble_selective_conn_cback_t *p_select_cback)
 Function wiced_bt_ble_set_background_connection_type. More...
 
wiced_bool_t wiced_bt_ble_update_background_connection_device (wiced_bool_t add_remove, wiced_bt_device_address_t remote_bda)
 Function wiced_bt_ble_update_background_connection_device. More...
 
uint8_t * wiced_bt_ble_check_advertising_data (uint8_t *p_adv, wiced_bt_ble_advert_type_t type, uint8_t *p_length)
 Function wiced_bt_ble_check_advertising_data. More...
 
wiced_bool_t wiced_bt_ble_get_security_state (wiced_bt_device_address_t bd_addr, uint8_t *p_le_sec_flags, uint8_t *p_le_key_size)
 Function wiced_bt_ble_get_security_state. More...
 
wiced_bool_t wiced_bt_ble_update_advertising_filter_accept_list (wiced_bool_t add, wiced_bt_device_address_t remote_bda)
 Function wiced_bt_ble_update_advertising_filter_accept_list. More...
 
wiced_bool_t wiced_btm_ble_update_advertisement_filter_policy (wiced_bt_ble_advert_filter_policy_t advertising_policy)
 Function wiced_btm_ble_update_advertisement_filter_policy. More...
 
wiced_bool_t wiced_bt_ble_update_scanner_filter_list (wiced_bool_t add, wiced_bt_device_address_t remote_bda, wiced_bt_ble_address_type_t addr_type)
 Function wiced_bt_ble_update_scanner_filter_list. More...
 
void wiced_bt_ble_update_scanner_filter_policy (wiced_bt_ble_scanner_filter_policy_t scanner_policy)
 Function wiced_bt_ble_update_scanner_filter_policy. More...
 
wiced_bool_t wiced_bt_ble_clear_filter_accept_list (void)
 Function wiced_bt_ble_clear_filter_accept_list. More...
 
uint8_t wiced_bt_ble_get_filter_accept_list_size (void)
 Function wiced_bt_ble_get_filter_accept_list_size. More...
 
wiced_result_t wiced_bt_ble_set_adv_tx_power (INT8 power, wiced_bt_dev_vendor_specific_command_complete_cback_t *p_cb)
 Function wiced_bt_ble_set_adv_tx_power. More...
 
wiced_result_t wiced_bt_ble_read_adv_tx_power (wiced_bt_dev_cmpl_cback_t *p_cback)
 Function wiced_bt_ble_read_adv_tx_power. More...
 
wiced_result_t wiced_bt_ble_set_channel_classification (const wiced_bt_ble_chnl_map_t ble_channel_map)
 Function wiced_bt_ble_set_channel_classification. More...
 
wiced_bt_dev_status_t wiced_bt_ble_read_phy (wiced_bt_device_address_t remote_bd_addr, wiced_bt_ble_read_phy_complete_callback_t *p_read_phy_complete_callback)
 Function wiced_bt_ble_read_phy. More...
 
wiced_bt_dev_status_t wiced_bt_ble_set_default_phy (wiced_bt_ble_phy_preferences_t *phy_preferences)
 Function wiced_bt_ble_set_default_phy. More...
 
wiced_bt_dev_status_t wiced_bt_ble_set_phy (wiced_bt_ble_phy_preferences_t *phy_preferences)
 Function wiced_bt_ble_set_phy. More...
 
wiced_result_t wiced_bt_ble_get_connection_parameters (wiced_bt_device_address_t bda, wiced_bt_ble_conn_params_t *p_conn_parameters)
 Function wiced_bt_gatt_ble_get_connection_parameters. More...
 
wiced_bt_dev_status_t wiced_start_multi_advertisements (uint8_t advertising_enable, uint8_t adv_instance)
 
wiced_bt_dev_status_t wiced_set_multi_advertisement_params (uint8_t adv_instance, wiced_bt_ble_multi_adv_params_t *p_param)
 Function wiced_set_multi_advertisement_params. More...
 
wiced_bt_dev_status_t wiced_set_multi_advertisement_data (uint8_t *p_data, uint8_t data_len, uint8_t adv_instance)
 Function wiced_set_multi_advertisement_data. More...
 
wiced_bt_dev_status_t wiced_set_multi_advertisements_random_address (wiced_bt_device_address_t randomAddr, uint8_t adv_instance)
 Function wiced_set_multi_advertisements_random_address. More...
 
wiced_bt_dev_status_t wiced_set_multi_advertisement_scan_response_data (uint8_t *p_data, uint8_t data_len, uint8_t adv_instance)
 Function wiced_set_multi_advertisement_scan_response_data. More...
 
wiced_bool_t wiced_bt_notify_multi_advertisement_packet_transmissions (uint8_t adv_instance, void(*clientCallback)(uint32_t), uint32_t advanceNoticeInMicroSeconds)
 Function wiced_bt_notify_multi_advertisement_packet_transmissions. More...
 
wiced_bt_dev_status_t wiced_bt_ble_set_privacy_mode (wiced_bt_device_address_t remote_bda, wiced_bt_ble_privacy_mode_t privacy_mode)
 
uint8_t * wiced_btm_get_private_bda (void)
 Function wiced_btm_get_private_bda. More...
 
void wiced_bt_ble_set_resolvable_private_address (wiced_bt_device_address_t rpa)
 Function wiced_bt_ble_set_resolvable_private_address. More...
 
void wiced_bt_ble_set_local_identity_key_data (uint8_t *p_data)
 Function wiced_bt_ble_set_local_identity_key_data. More...
 
wiced_result_t wiced_ble_private_device_address_resolution (wiced_bt_device_address_t rpa, BT_OCTET16 irk)
 Function wiced_ble_private_device_address_resolution. More...
 
wiced_result_t wiced_bt_dev_add_device_to_address_resolution_db (wiced_bt_device_link_keys_t *p_link_keys)
 Function wiced_bt_dev_add_device_to_address_resolution_db. More...
 
wiced_result_t wiced_bt_dev_remove_device_from_address_resolution_db (wiced_bt_device_link_keys_t *p_link_keys)
 Function wiced_bt_dev_remove_device_from_address_resolution_db. More...
 
wiced_result_t wiced_bt_dev_get_ble_keys (wiced_bt_device_address_t bd_addr, wiced_bt_dev_le_key_type_t *p_key_mask)
 Function wiced_bt_dev_get_ble_keys. More...
 

Detailed Description

AIROC Bluetooth Low Energy (LE) Functions.

Macro Definition Documentation

#define BTM_BLE_AUTH_SIGNATURE_SIZE   12

LE Signature.

LE data signature length 8 Bytes + 4 bytes counter

#define BTM_BLE_SIMULTANEOUS_DUAL_MODE_TO_SAME_DEVICE_CONTROLLER_SUPPORTED   (0x01 << 3)

Simultaneous LE and BR/EDR to Same Device Capable (Controller).

#define BTM_BLE_SIMULTANEOUS_DUAL_MODE_TO_SAME_DEVICE_HOST_SUPPORTED   (0x01 << 4)

Simultaneous LE and BR/EDR to Same Device Capable (Host).

Typedef Documentation

typedef void( wiced_bt_ble_read_phy_complete_callback_t)(wiced_bt_ble_phy_update_t *p_phy_result)

Callback wiced_bt_ble_read_phy_complete_callback_t.

read phy complete callback (from calling wiced_bt_ble_read_phy)

Parameters
p_phy_result: read phys result
Returns
Nothing
typedef void( wiced_bt_ble_scan_result_cback_t)(wiced_bt_ble_scan_results_t *p_scan_result, uint8_t *p_adv_data)

Callback wiced_bt_ble_scan_result_cback_t.

Scan result callback (from calling wiced_bt_ble_scan)

Parameters
p_scan_result: scan result data (NULL indicates end of scanning)
p_adv_data: Advertisement data (parse using wiced_bt_ble_check_advertising_data)
Returns
Nothing
typedef wiced_bool_t( wiced_bt_ble_selective_conn_cback_t)(wiced_bt_device_address_t remote_bda, uint8_t *p_remote_name)

Callback wiced_bt_ble_selective_conn_cback_t.

Selective connection callback (registered with wiced_bt_ble_set_background_connection_type)

Parameters
remote_bda: remote device
p_remote_name: remote device name
Returns

Enumeration Type Documentation

anonymous enum
Enumerator
WICED_BT_ADV_NOTIFICATION_READY 

Ready to send out an adv in the next few mS.

App can change ADV data if required. Typically invoked about 2.5mS before te ADV. If there are other higher priority tasks or other events in the app thread event queue, this will be delayed. Notification is best effort.

WICED_BT_ADV_NOTIFICATION_DONE 

Just completed transmitting an ADV packet.

anonymous enum
Enumerator
BTM_BLE_SEC_NONE 

No encryption.

BTM_BLE_SEC_ENCRYPT 

encrypt the link using current key

BTM_BLE_SEC_ENCRYPT_NO_MITM 

encryption without MITM

BTM_BLE_SEC_ENCRYPT_MITM 

encryption with MITM

anonymous enum
Enumerator
BTM_BLE_PRIVACY_MODE_NETWORK 

network privacy mode

BTM_BLE_PRIVACY_MODE_DEVICE 

device privacy mode

advertising channel map

Enumerator
BTM_BLE_ADVERT_CHNL_37 

ADV channel.

BTM_BLE_ADVERT_CHNL_38 

ADV channel.

BTM_BLE_ADVERT_CHNL_39 

ADV channel.

Advertising filter policy.

Enumerator
BTM_BLE_ADV_POLICY_ACCEPT_CONN_AND_SCAN 

Process scan and connection requests from all devices (i.e., the Filter Accept List is not in use) (default)

BTM_BLE_ADV_POLICY_ACCEPT_CONN_FILTER_SCAN 

Process connection requests from all devices and only scan requests from devices that are in the Filter Accept List.

BTM_BLE_ADV_POLICY_FILTER_CONN_ACCEPT_SCAN 

Process scan requests from all devices and only connection requests from devices that are in the Filter Accept List.

BTM_BLE_ADV_POLICY_FILTER_CONN_FILTER_SCAN 

Process scan and connection requests only from devices in the Filter Accept List.

Advertisement data types.

Enumerator
BTM_BLE_ADVERT_TYPE_FLAG 

Advertisement flags.

BTM_BLE_ADVERT_TYPE_16SRV_PARTIAL 

List of supported services - 16 bit UUIDs (partial)

BTM_BLE_ADVERT_TYPE_16SRV_COMPLETE 

List of supported services - 16 bit UUIDs (complete)

BTM_BLE_ADVERT_TYPE_32SRV_PARTIAL 

List of supported services - 32 bit UUIDs (partial)

BTM_BLE_ADVERT_TYPE_32SRV_COMPLETE 

List of supported services - 32 bit UUIDs (complete)

BTM_BLE_ADVERT_TYPE_128SRV_PARTIAL 

List of supported services - 128 bit UUIDs (partial)

BTM_BLE_ADVERT_TYPE_128SRV_COMPLETE 

List of supported services - 128 bit UUIDs (complete)

BTM_BLE_ADVERT_TYPE_NAME_SHORT 

Short name.

BTM_BLE_ADVERT_TYPE_NAME_COMPLETE 

Complete name.

BTM_BLE_ADVERT_TYPE_TX_POWER 

TX Power level.

BTM_BLE_ADVERT_TYPE_DEV_CLASS 

Device Class.

BTM_BLE_ADVERT_TYPE_SIMPLE_PAIRING_HASH_C 

Simple Pairing Hash C.

BTM_BLE_ADVERT_TYPE_SIMPLE_PAIRING_RAND_C 

Simple Pairing Randomizer R.

BTM_BLE_ADVERT_TYPE_SM_TK 

Security manager TK value.

BTM_BLE_ADVERT_TYPE_SM_OOB_FLAG 

Security manager Out-of-Band data.

BTM_BLE_ADVERT_TYPE_INTERVAL_RANGE 

Peripheral connection interval range.

BTM_BLE_ADVERT_TYPE_SOLICITATION_SRV_UUID 

List of solicitated services - 16 bit UUIDs.

BTM_BLE_ADVERT_TYPE_128SOLICITATION_SRV_UUID 

List of solicitated services - 128 bit UUIDs.

BTM_BLE_ADVERT_TYPE_SERVICE_DATA 

Service data - 16 bit UUID.

BTM_BLE_ADVERT_TYPE_PUBLIC_TARGET 

Public target address.

BTM_BLE_ADVERT_TYPE_RANDOM_TARGET 

Random target address.

BTM_BLE_ADVERT_TYPE_APPEARANCE 

Appearance.

BTM_BLE_ADVERT_TYPE_ADVERT_INTERVAL 

Advertising interval.

BTM_BLE_ADVERT_TYPE_LE_BD_ADDR 

LE device bluetooth address.

BTM_BLE_ADVERT_TYPE_LE_ROLE 

LE role.

BTM_BLE_ADVERT_TYPE_256SIMPLE_PAIRING_HASH 

Simple Pairing Hash C-256.

BTM_BLE_ADVERT_TYPE_256SIMPLE_PAIRING_RAND 

Simple Pairing Randomizer R-256.

BTM_BLE_ADVERT_TYPE_32SOLICITATION_SRV_UUID 

List of solicitated services - 32 bit UUIDs.

BTM_BLE_ADVERT_TYPE_32SERVICE_DATA 

Service data - 32 bit UUID.

BTM_BLE_ADVERT_TYPE_128SERVICE_DATA 

Service data - 128 bit UUID.

BTM_BLE_ADVERT_TYPE_CONN_CONFIRM_VAL 

LE Secure Connections Confirmation Value.

BTM_BLE_ADVERT_TYPE_CONN_RAND_VAL 

LE Secure Connections Random Value.

BTM_BLE_ADVERT_TYPE_URI 

URI.

BTM_BLE_ADVERT_TYPE_INDOOR_POS 

Indoor Positioning.

BTM_BLE_ADVERT_TYPE_TRANS_DISCOVER_DATA 

Transport Discovery Data.

BTM_BLE_ADVERT_TYPE_SUPPORTED_FEATURES 

LE Supported Features.

BTM_BLE_ADVERT_TYPE_UPDATE_CH_MAP_IND 

Channel Map Update Indication.

BTM_BLE_ADVERT_TYPE_PB_ADV 

PB-ADV.

BTM_BLE_ADVERT_TYPE_MESH_MSG 

Mesh Message.

BTM_BLE_ADVERT_TYPE_MESH_BEACON 

Mesh Beacon.

BTM_BLE_ADVERT_TYPE_3D_INFO_DATA 

3D Information Data

BTM_BLE_ADVERT_TYPE_MANUFACTURER 

Manufacturer data.

Enumerator
BTM_BLE_CONN_NONE 

No background connection.

BTM_BLE_CONN_AUTO 

Auto connection.

BTM_BLE_CONN_SELECTIVE 

Selective connection.

Multi-advertisement Filtering policy.

Enumerator
MULTI_ADVERT_FILTER_POLICY_FILTER_ACCEPT_LIST_NOT_USED 

Filter Accept List not used.

MULTI_ADVERT_FILTER_ACCEPT_LIST_POLICY_ADV_ALLOW_UNKNOWN_CONNECTION 

Filter Accept List for scan request.

MULTI_ADVERT_FILTER_ACCEPT_LIST_POLICY_ADV_ALLOW_UNKNOWN_SCANNING 

Filter Accept List for connection request.

Multi-advertisement start/stop.

Enumerator
MULTI_ADVERT_STOP 

Stop Multi-adverstisment.

MULTI_ADVERT_START 

Start Multi-adverstisment.

Enumerator
BTM_BLE_SCAN_MODE_PASSIVE 

Passive does not send scan request.

BTM_BLE_SCAN_MODE_ACTIVE 

Active sends scan request to advertiser.

BTM_BLE_SCAN_MODE_NONE 

Disable scans.

Enumerator
BTM_SEC_LE_LINK_ENCRYPTED 

Link encrypted.

BTM_SEC_LE_LINK_PAIRED_WITHOUT_MITM 

Paired without man-in-the-middle protection.

BTM_SEC_LE_LINK_PAIRED_WITH_MITM 

Link with man-in-the-middle protection.

Scan result event type.

Enumerator
BTM_BLE_EVT_CONNECTABLE_ADVERTISEMENT 

Connectable advertisement.

BTM_BLE_EVT_CONNECTABLE_DIRECTED_ADVERTISEMENT 

Connectable Directed advertisement.

BTM_BLE_EVT_SCANNABLE_ADVERTISEMENT 

Scannable advertisement.

BTM_BLE_EVT_NON_CONNECTABLE_ADVERTISEMENT 

Non connectable advertisement.

BTM_BLE_EVT_SCAN_RSP 

Scan response.