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

Device Management Struct. More...

Data Structures

struct  wiced_bt_tx_power_result_t
 TX Power Result (in response to wiced_bt_dev_read_tx_power) More...
 
struct  wiced_bt_set_adv_tx_power_result_t
 TX Power Result (in response to wiced_bt_ble_set_adv_tx_power) More...
 
struct  wiced_bt_dev_vendor_specific_command_complete_params_t
 Structure returned with Vendor Specific Command complete callback. More...
 
struct  wiced_bt_public_key_t
 Public key. More...
 
struct  wiced_bt_smp_sc_local_oob_t
 Data for BTM_SMP_SC_LOCAL_OOB_DATA_NOTIFICATION_EVT. More...
 
struct  wiced_bt_smp_remote_oob_req_t
 data type for BTM_SMP_REMOTE_OOB_DATA_REQUEST_EVT More...
 
struct  wiced_bt_smp_sc_remote_oob_req_t
 data type for BTM_SMP_SC_REMOTE_OOB_DATA_REQUEST_EVT More...
 
struct  wiced_bt_dev_user_keypress_t
 Pairing keypress notification (BTM_USER_KEYPRESS_NOTIFICATION_EVT event data type) More...
 
struct  wiced_bt_dev_user_key_notif_t
 Data for pairing passkey notification (BTM_USER_PASSKEY_NOTIFICATION_EVT event data type) More...
 
struct  wiced_bt_dev_br_edr_pairing_info_t
 BR/EDR pairing complete infomation. More...
 
struct  wiced_bt_dev_user_cfm_req_t
 Data for pairing confirmation request (BTM_USER_CONFIRMATION_REQUEST_EVT event data type) More...
 
struct  wiced_bt_dev_ble_pairing_info_t
 LE pairing complete infomation. More...
 
union  wiced_bt_dev_pairing_info_t
 Transport dependent pairing complete infomation. More...
 
struct  wiced_bt_dev_pairing_cplt_t
 Pairing complete notification (BTM_PAIRING_COMPLETE_EVT event data type) More...
 
struct  wiced_bt_dev_security_failed_t
 Security/authentication failure status (used by BTM_SECURITY_FAILED_EVT notication) More...
 
struct  wiced_bt_dev_security_request_t
 Security request (BTM_SECURITY_REQUEST_EVT event data type) More...
 
struct  wiced_bt_local_id_keys
 LE keys. More...
 
struct  wiced_bt_local_identity_keys_t
 LE identity key for local device (used by BTM_LE_LOCAL_IDENTITY_KEYS_UPDATE_EVT and BTM_LE_LOCAL_KEYS_REQUEST_EVT notification) More...
 
struct  wiced_bt_ble_connection_param_update_t
 LE connection parameter update event related data. More...
 
struct  wiced_bt_ble_phy_update_t
 LE Physical link update event related data. More...
 
struct  wiced_bt_ble_phy_data_length_update_t
 LE data length update event related data. More...
 
struct  wiced_bt_ble_multi_adv_response_t
 LE Multi adv VSC response data. More...
 
struct  wiced_bt_dev_enabled_t
 Device enabled (used by BTM_ENABLED_EVT) More...
 
struct  wiced_bt_dev_disabled_t
 Device disabled (used by BTM_DISABLED_EVT) More...
 
struct  wiced_bt_dev_name_and_class_t
 Remote device information (used by BTM_PIN_REQUEST_EVT, BTM_SECURITY_ABORTED_EVT) More...
 
struct  wiced_bt_power_mgmt_notification_t
 Change in power management status (used by BTM_POWER_MANAGEMENT_STATUS_EVT notication) More...
 
struct  wiced_bt_dev_encryption_status_t
 Encryption status change (used by BTM_ENCRYPTION_STATUS_EVT) More...
 
struct  wiced_bt_dev_local_oob_t
 Local OOB data BTM_READ_LOCAL_OOB_DATA_COMPLETE_EVT. More...
 
struct  wiced_bt_dev_remote_oob_t
 BTM_REMOTE_OOB_DATA_REQUEST_EVT. More...
 
struct  wiced_bt_dev_bredr_io_caps_req_t
 BR/EDR Pairing IO Capabilities (to be filled by application callback on BTM_PAIRING_IO_CAPABILITIES_BR_EDR_REQUEST_EVT) More...
 
struct  wiced_bt_dev_ble_io_caps_req_t
 LE Pairing IO Capabilities (to be filled by application callback on BTM_PAIRING_IO_CAPABILITIES_BLE_REQUEST_EVT) More...
 
struct  wiced_bt_ble_keys_s
 Paired device LE Keys. More...
 
struct  wiced_bt_device_sec_keys_s
 Paired Device Link key data. More...
 
struct  wiced_bt_device_link_keys_s
 Paired device link key notification (used by BTM_PAIRED_DEVICE_LINK_KEYS_UPDATE_EVT notication) More...
 
struct  wiced_bt_device_br_packet_types_t
 BR packets statistics details. More...
 
struct  edr_packet_types_s
 EDR packets statistics types details. More...
 
union  wiced_bt_br_edr_pkt_type_stats_s
 BR/EDR packet types detail statistics. More...
 
struct  wiced_bt_lq_br_edr_stats_s
 BR/EDR link statistics. More...
 
struct  wiced_bt_lq_le_stats_s
 LE link statistics. More...
 
struct  wiced_bt_lq_stats_result_s
 LQ Quality Result (in response to wiced_bt_dev_lq_stats) More...
 
union  wiced_bt_management_evt_data_t
 Structure definitions for Bluetooth Management (wiced_bt_management_cback_t) event notifications. More...
 

Macros

#define BTM_PIN_TYPE_VARIABLE   HCI_PIN_TYPE_VARIABLE
 Variable Pin Type.
 
#define BTM_PIN_TYPE_FIXED   HCI_PIN_TYPE_FIXED
 Fix Length Pin Type.
 
#define BTM_SECURITY_KEY_DATA_LEN   132
 Security key data length (used by wiced_bt_device_link_keys_t structure)
 
#define BTM_SECURITY_LOCAL_KEY_DATA_LEN   65
 Local security key data length (used by wiced_bt_local_identity_keys_t structure)
 
#define SMP_SEC_NONE   0
 LE Security key level. More...
 
#define SMP_SEC_UNAUTHENTICATE   (1 << 0)
 Security Key Level: key not authenticated.
 
#define SMP_SEC_AUTHENTICATED   (1 << 2)
 Security Key Level: key authenticated.
 
#define BTM_OOB_STATE
 OOB Data status.
 
#define BTM_OOB_REQ_TYPE
 Type of OOB data required.
 
#define BTM_LE_KEY_TYPES
 LE Key type.
 
#define BTM_BLE_SCAN_TYPE
 Scan duty cycle (used for BTM_BLE_SCAN_STATE_CHANGED_EVT and wiced_bt_dev_create_connection)
 
#define BTM_BLE_KEY_TYPE_ID   1
 Identity resolving key.
 
#define BTM_BLE_KEY_TYPE_ER   2
 Encryption root key.
 
#define BTM_PM_STATUS_CODES
 Power Management status codes.
 
#define WICED_POWER_STATE_ACTIVE   BTM_PM_STS_ACTIVE
 Power Management state. More...
 
#define WICED_POWER_STATE_SNIFF   BTM_PM_STS_SNIFF
 Sniff.
 
#define WICED_POWER_STATE_SSR   BTM_PM_STS_SSR
 Sniff subrating notification.
 
#define WICED_POWER_STATE_PENDING   BTM_PM_STS_PENDING
 Pending (waiting for status from controller)
 
#define WICED_POWER_STATE_ERROR   BTM_PM_STS_ERROR
 Error (controller returned error)
 
#define BTM_AFH_CHNL_MAP_SIZE   HCI_AFH_CHANNEL_MAP_LEN
 Channel Map Length.
 
#define BTM_MANAGEMENT_EVT
 Bluetooth Management event.
 
#define BTM_BLE_ADVERT_MODE
 advertisement type (used when calling wiced_bt_start_advertisements)
 
#define BTM_BLE_CONN_MODE
 scan mode used in initiating
 

Typedefs

typedef uint8_t wiced_bt_dev_io_cap_t
 IO capabilities.
 
typedef uint8_t wiced_bt_dev_auth_req_t
 BR/EDR authentication requirement (see wiced_bt_dev_auth_req_e)
 
typedef uint8_t wiced_bt_dev_le_auth_req_t
 LE authentication requirement (see wiced_bt_dev_le_auth_req_e)
 
typedef uint8_t wiced_bt_smp_sec_level_t
 LE Security key level.
 
typedef uint8_t wiced_bt_dev_oob_data_t
 OOB data (see wiced_bt_dev_oob_data_e)
 
typedef uint8_t wiced_bt_dev_oob_data_req_type_t
 OOB data type requested (see wiced_bt_dev_oob_data_req_type_t)
 
typedef uint8_t wiced_bt_dev_le_key_type_t
 LE key type (see wiced_bt_dev_le_key_type_e)
 
typedef uint8_t wiced_bt_ble_scan_type_t
 scan type (see wiced_bt_ble_scan_type_e)
 
typedef uint8_t wiced_bt_smp_status_t
 SMP Pairing status (see wiced_bt_smp_status_e)
 
typedef uint8_t wiced_bt_dev_power_mgmt_status_t
 Power management status (see wiced_bt_dev_power_mgmt_status_e)
 
typedef uint8_t wiced_bt_br_chnl_map_t [BTM_AFH_CHNL_MAP_SIZE]
 Array of Channel Map Length.
 
typedef uint8_t wiced_bt_management_evt_t
 Bluetooth management events (see wiced_bt_management_evt_e)
 
typedef struct wiced_bt_ble_keys_s wiced_bt_ble_keys_t
 Paired device LE Keys.
 
typedef struct
wiced_bt_device_sec_keys_s 
wiced_bt_device_sec_keys_t
 Paired Device Link key data.
 
typedef struct
wiced_bt_device_link_keys_s 
wiced_bt_device_link_keys_t
 Paired device link key notification (used by BTM_PAIRED_DEVICE_LINK_KEYS_UPDATE_EVT notication)
 
typedef struct edr_packet_types_s wiced_bt_device_edr_packet_types_t
 EDR packets statistics types details.
 
typedef union
wiced_bt_br_edr_pkt_type_stats_s 
wiced_bt_br_edr_pkt_type_stats
 BR/EDR packet types detail statistics.
 
typedef struct
wiced_bt_lq_br_edr_stats_s 
wiced_bt_lq_br_edr_stats
 BR/EDR link statistics.
 
typedef struct
wiced_bt_lq_le_stats_s 
wiced_bt_lq_le_stats
 LE link statistics.
 
typedef struct
wiced_bt_lq_stats_result_s 
wiced_bt_lq_stats_result_t
 LQ Quality Result (in response to wiced_bt_dev_lq_stats)
 
typedef uint8_t wiced_bt_link_quality_stats_param_t
 Link Quality Statistic Action (see wiced_bt_dev_link_quality_stats_param_e)
 
typedef uint16_t wiced_bt_link_policy_settings_t [1]
 Link Policy Settings type (see wiced_bt_link_policy_settings_values_e)
 
typedef uint8_t wiced_bt_ble_advert_mode_t
 Advertisement type (see wiced_bt_ble_advert_mode_e)
 
typedef uint8_t wiced_bt_ble_conn_mode_t
 Conn mode (see wiced_bt_ble_conn_mode_e)
 

Enumerations

enum  wiced_bt_sec_flags_e { BTM_SEC_LINK_ENCRYPTED = 0x01, BTM_SEC_LINK_PAIRED_WITHOUT_MITM = 0x02, BTM_SEC_LINK_PAIRED_WITH_MITM = 0x04 }
 security flags for current BR/EDR link More...
 
enum  wiced_bt_dev_io_cap_e {
  BTM_IO_CAPABILITIES_DISPLAY_ONLY = 0, BTM_IO_CAPABILITIES_DISPLAY_AND_YES_NO_INPUT = 1, BTM_IO_CAPABILITIES_KEYBOARD_ONLY = 2, BTM_IO_CAPABILITIES_NONE = 3,
  BTM_IO_CAPABILITIES_BLE_DISPLAY_AND_KEYBOARD_INPUT = 4, BTM_IO_CAPABILITIES_MAX = 5
}
 Pairing IO Capabilities. More...
 
enum  wiced_bt_dev_auth_req_e {
  BTM_AUTH_SINGLE_PROFILE_NO = 0, BTM_AUTH_SINGLE_PROFILE_YES = 1, BTM_AUTH_ALL_PROFILES_NO = 2, BTM_AUTH_ALL_PROFILES_YES = 3,
  BTM_AUTH_SINGLE_PROFILE_GENERAL_BONDING_NO = 4, BTM_AUTH_SINGLE_PROFILE_GENERAL_BONDING_YES = 5
}
 BR/EDR Authentication requirement. More...
 
enum  wiced_bt_dev_le_auth_req_e {
  BTM_LE_AUTH_REQ_NO_BOND = 0x00, BTM_LE_AUTH_REQ_BOND = 0x01, BTM_LE_AUTH_REQ_MITM = 0x04, BTM_LE_AUTH_REQ_SC = 0x08,
  BTM_LE_AUTH_REQ_KP = 0x10, BTM_LE_AUTH_REQ_H7 = 0x20, BTM_LE_AUTH_REQ_SC_BOND = (BTM_LE_AUTH_REQ_SC|BTM_LE_AUTH_REQ_BOND), BTM_LE_AUTH_REQ_SC_MITM = (BTM_LE_AUTH_REQ_SC|BTM_LE_AUTH_REQ_MITM),
  BTM_LE_AUTH_REQ_SC_MITM_BOND = (BTM_LE_AUTH_REQ_SC|BTM_LE_AUTH_REQ_MITM|BTM_LE_AUTH_REQ_BOND), BTM_LE_AUTH_REQ_MASK = 0x3D
}
 LE Authentication requirement. More...
 
enum  wiced_bt_dev_oob_data_e {
  BTM_OOB_NONE, BTM_OOB_PRESENT_192, BTM_OOB_PRESENT_256, BTM_OOB_PRESENT_192_256,
  BTM_OOB_UNKNOWN
}
 OOB Data status. More...
 
enum  wiced_bt_dev_oob_data_req_type_e { BTM_OOB_INVALID_TYPE, BTM_OOB_PEER, BTM_OOB_LOCAL, BTM_OOB_BOTH }
 Type of OOB data required. More...
 
enum  wiced_bt_dev_le_key_type_e {
  BTM_LE_KEY_PENC = (1 << 0), BTM_LE_KEY_PID = (1 << 1), BTM_LE_KEY_PCSRK = (1 << 2), BTM_LE_KEY_PLK = (1 << 3),
  BTM_LE_KEY_LENC = (1 << 4), BTM_LE_KEY_LID = (1 << 5), BTM_LE_KEY_LCSRK = (1 << 6), BTM_LE_KEY_LLK = (1 << 7)
}
 LE Key type. More...
 
enum  wiced_bt_ble_scan_type_e {
  BTM_BLE_SCAN_TYPE_NONE, BTM_BLE_SCAN_TYPE_HIGH_DUTY, BTM_BLE_SCAN_TYPE_LOW_DUTY, BTM_BLE_SCAN_TYPE_LIMITED_HIGH_DUTY,
  BTM_BLE_SCAN_TYPE_LIMITED_LOW_DUTY
}
 Scan duty cycle (used for BTM_BLE_SCAN_STATE_CHANGED_EVT and wiced_bt_dev_create_connection) More...
 
enum  wiced_bt_smp_status_e {
  SMP_SUCCESS = 0, SMP_PASSKEY_ENTRY_FAIL = 0x01, SMP_OOB_FAIL = 0x02, SMP_PAIR_AUTH_FAIL = 0x03,
  SMP_CONFIRM_VALUE_ERR = 0x04, SMP_PAIR_NOT_SUPPORT = 0x05, SMP_ENC_KEY_SIZE = 0x06, SMP_INVALID_CMD = 0x07,
  SMP_PAIR_FAIL_UNKNOWN = 0x08, SMP_REPEATED_ATTEMPTS = 0x09, SMP_INVALID_PARAMETERS = 0x0A, SMP_DHKEY_CHK_FAIL = 0x0B,
  SMP_NUMERIC_COMPAR_FAIL = 0x0C, SMP_BR_PAIRING_IN_PROGR = 0x0D, SMP_XTRANS_DERIVE_NOT_ALLOW = 0x0E, SMP_MAX_FAIL_RSN_PER_SPEC = SMP_XTRANS_DERIVE_NOT_ALLOW,
  SMP_PAIR_INTERNAL_ERR = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x01), SMP_UNKNOWN_IO_CAP = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x02), SMP_INIT_FAIL = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x03), SMP_CONFIRM_FAIL = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x04),
  SMP_BUSY = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x05), SMP_ENC_FAIL = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x06), SMP_STARTED = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x07), SMP_RSP_TIMEOUT = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x08),
  SMP_FAIL = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x09), SMP_CONN_TOUT = (SMP_MAX_FAIL_RSN_PER_SPEC + 0x0A)
}
 SMP Pairing status codes. More...
 
enum  wiced_bt_multi_adv_opcodes_t {
  SET_ADVT_PARAM_MULTI = 1, SET_ADVT_DATA_MULTI = 2, SET_SCAN_RESP_DATA_MULTI = 3, SET_RANDOM_ADDR_MULTI = 4,
  SET_ADVT_ENABLE_MULTI = 5
}
 LE Multi adv opcodes returned. More...
 
enum  wiced_bt_dev_power_mgmt_status_e {
  BTM_PM_STS_ACTIVE = HCI_MODE_ACTIVE, BTM_PM_STS_HOLD = HCI_MODE_HOLD, BTM_PM_STS_SNIFF = HCI_MODE_SNIFF, BTM_PM_STS_PARK = HCI_MODE_PARK,
  BTM_PM_STS_SSR, BTM_PM_STS_PENDING, BTM_PM_STS_ERROR
}
 Power Management status. More...
 
enum  wiced_bt_management_evt_e {
  BTM_ENABLED_EVT, BTM_DISABLED_EVT, BTM_POWER_MANAGEMENT_STATUS_EVT, BTM_RE_START_EVT,
  BTM_PIN_REQUEST_EVT, BTM_USER_CONFIRMATION_REQUEST_EVT, BTM_PASSKEY_NOTIFICATION_EVT, BTM_PASSKEY_REQUEST_EVT,
  BTM_KEYPRESS_NOTIFICATION_EVT, BTM_PAIRING_IO_CAPABILITIES_BR_EDR_REQUEST_EVT, BTM_PAIRING_IO_CAPABILITIES_BR_EDR_RESPONSE_EVT, BTM_PAIRING_IO_CAPABILITIES_BLE_REQUEST_EVT,
  BTM_PAIRING_COMPLETE_EVT, BTM_ENCRYPTION_STATUS_EVT, BTM_SECURITY_REQUEST_EVT, BTM_SECURITY_FAILED_EVT,
  BTM_SECURITY_ABORTED_EVT, BTM_READ_LOCAL_OOB_DATA_COMPLETE_EVT, BTM_REMOTE_OOB_DATA_REQUEST_EVT, BTM_PAIRED_DEVICE_LINK_KEYS_UPDATE_EVT,
  BTM_PAIRED_DEVICE_LINK_KEYS_REQUEST_EVT, BTM_LOCAL_IDENTITY_KEYS_UPDATE_EVT, BTM_LOCAL_IDENTITY_KEYS_REQUEST_EVT, BTM_BLE_SCAN_STATE_CHANGED_EVT,
  BTM_BLE_ADVERT_STATE_CHANGED_EVT, BTM_SMP_REMOTE_OOB_DATA_REQUEST_EVT, BTM_SMP_SC_REMOTE_OOB_DATA_REQUEST_EVT, BTM_SMP_SC_LOCAL_OOB_DATA_NOTIFICATION_EVT,
  BTM_SCO_CONNECTED_EVT, BTM_SCO_DISCONNECTED_EVT, BTM_SCO_CONNECTION_REQUEST_EVT, BTM_SCO_CONNECTION_CHANGE_EVT,
  BTM_BLE_CONNECTION_PARAM_UPDATE, BTM_BLE_PHY_UPDATE_EVT, BTM_LPM_STATE_LOW_POWER, BTM_MULTI_ADVERT_RESP_EVENT,
  BTM_BLE_DATA_LENGTH_UPDATE_EVENT
}
 Bluetooth Management events used in wiced_bt_management_cback_t. More...
 
enum  wiced_bt_dev_link_quality_stats_param_e { WICED_CLEAR_LINK_QUALITY_STATS = 0, WICED_READ_LINK_QUALITY_STATS = 1, WICED_READ_THEN_CLEAR_LINK_QUALITY_STATS = 2 }
 Link Quality statistics action type. More...
 
enum  wiced_bt_link_policy_settings_values_e { WICED_ENABLE_ROLE_SWITCH = 0x01, WICED_ENABLE_HOLD_MODE = 0x02, WICED_ENABLE_SNIFF_MODE = 0x04 }
 .Enumeration of known link policy settings value assignments of the wiced_bt_link_policy_settings_t More...
 
enum  wiced_bt_ble_advert_mode_e {
  BTM_BLE_ADVERT_OFF, BTM_BLE_ADVERT_DIRECTED_HIGH, BTM_BLE_ADVERT_DIRECTED_LOW, BTM_BLE_ADVERT_UNDIRECTED_HIGH,
  BTM_BLE_ADVERT_UNDIRECTED_LOW, BTM_BLE_ADVERT_NONCONN_HIGH, BTM_BLE_ADVERT_NONCONN_LOW, BTM_BLE_ADVERT_DISCOVERABLE_HIGH,
  BTM_BLE_ADVERT_DISCOVERABLE_LOW
}
 advertisement type (used when calling wiced_bt_start_advertisements) More...
 
enum  wiced_bt_ble_conn_mode_e { BLE_CONN_MODE_OFF, BLE_CONN_MODE_LOW_DUTY, BLE_CONN_MODE_HIGH_DUTY }
 scan mode used in initiating More...
 
enum  wiced_bt_hci_trace_type_t {
  HCI_TRACE_EVENT, HCI_TRACE_COMMAND, HCI_TRACE_INCOMING_ACL_DATA, HCI_TRACE_OUTGOING_ACL_DATA,
  HCI_TRACE_INCOMING_ISO_DATA, HCI_TRACE_OUTGOING_ISO_DATA, HCI_TRACE_INCOMING_SCO_DATA, HCI_TRACE_OUTGOING_SCO_DATA
}
 HCI trace types. More...
 

Detailed Description

Device Management Struct.

Macro Definition Documentation

#define SMP_SEC_NONE   0

LE Security key level.

Security Key Level: None

#define WICED_POWER_STATE_ACTIVE   BTM_PM_STS_ACTIVE

Power Management state.

Active

Enumeration Type Documentation

advertisement type (used when calling wiced_bt_start_advertisements)

Enumerator
BTM_BLE_ADVERT_OFF 

Stop advertising.

BTM_BLE_ADVERT_DIRECTED_HIGH 

Directed advertisement (high duty cycle)

BTM_BLE_ADVERT_DIRECTED_LOW 

Directed advertisement (low duty cycle)

BTM_BLE_ADVERT_UNDIRECTED_HIGH 

Undirected advertisement (high duty cycle)

BTM_BLE_ADVERT_UNDIRECTED_LOW 

Undirected advertisement (low duty cycle)

BTM_BLE_ADVERT_NONCONN_HIGH 

Non-connectable advertisement (high duty cycle)

BTM_BLE_ADVERT_NONCONN_LOW 

Non-connectable advertisement (low duty cycle)

BTM_BLE_ADVERT_DISCOVERABLE_HIGH 

discoverable advertisement (high duty cycle)

BTM_BLE_ADVERT_DISCOVERABLE_LOW 

discoverable advertisement (low duty cycle)

scan mode used in initiating

Enumerator
BLE_CONN_MODE_OFF 

Stop initiating.

BLE_CONN_MODE_LOW_DUTY 

slow connection scan parameter

BLE_CONN_MODE_HIGH_DUTY 

fast connection scan parameter

Scan duty cycle (used for BTM_BLE_SCAN_STATE_CHANGED_EVT and wiced_bt_dev_create_connection)

Enumerator
BTM_BLE_SCAN_TYPE_NONE 

Stop scanning.

BTM_BLE_SCAN_TYPE_HIGH_DUTY 

General inquiry high duty cycle scan.

BTM_BLE_SCAN_TYPE_LOW_DUTY 

General inquiry low duty cycle scan.

BTM_BLE_SCAN_TYPE_LIMITED_HIGH_DUTY 

Limited inquiry high duty cycle scan.

BTM_BLE_SCAN_TYPE_LIMITED_LOW_DUTY 

Limited inquiry low duty cycle scan.

BR/EDR Authentication requirement.

Enumerator
BTM_AUTH_SINGLE_PROFILE_NO 

MITM Protection Not Required - Single Profile/non-bonding.

Numeric comparison with automatic accept allowed

BTM_AUTH_SINGLE_PROFILE_YES 

MITM Protection Required - Single Profile/non-bonding.

Use IO Capabilities to determine authentication procedure

BTM_AUTH_ALL_PROFILES_NO 

MITM Protection Not Required - All Profiles/dedicated bonding.

Numeric comparison with automatic accept allowed

BTM_AUTH_ALL_PROFILES_YES 

MITM Protection Required - All Profiles/dedicated bonding.

Use IO Capabilities to determine authentication procedure

BTM_AUTH_SINGLE_PROFILE_GENERAL_BONDING_NO 

MITM Protection Not Required - Single Profiles/general bonding.

Numeric comparison with automatic accept allowed

BTM_AUTH_SINGLE_PROFILE_GENERAL_BONDING_YES 

MITM Protection Required - Single Profiles/general bonding.

Use IO Capabilities to determine authentication procedure

Pairing IO Capabilities.

Enumerator
BTM_IO_CAPABILITIES_DISPLAY_ONLY 

Display Only.

BTM_IO_CAPABILITIES_DISPLAY_AND_YES_NO_INPUT 

Display Yes/No.

BTM_IO_CAPABILITIES_KEYBOARD_ONLY 

Keyboard Only.

BTM_IO_CAPABILITIES_NONE 

No Input, No Output.

BTM_IO_CAPABILITIES_BLE_DISPLAY_AND_KEYBOARD_INPUT 

Keyboard display (For LE SMP)

BTM_IO_CAPABILITIES_MAX 

Max value for IO capability.

LE Authentication requirement.

Enumerator
BTM_LE_AUTH_REQ_NO_BOND 

Not required - No Bond.

BTM_LE_AUTH_REQ_BOND 

Required - General Bond.

BTM_LE_AUTH_REQ_MITM 

MITM required - Auth Y/N.

BTM_LE_AUTH_REQ_SC 

LE Secure Connection or legacy, no MITM, no Bonding.

BTM_LE_AUTH_REQ_KP 

Keypress supported Y/N.

BTM_LE_AUTH_REQ_H7 

Key derivation function H7 supported Y/N.

BTM_LE_AUTH_REQ_SC_BOND 

LE Secure Connection or legacy, no MITM, Bonding.

BTM_LE_AUTH_REQ_SC_MITM 

LE Secure Connection or legacy, MITM, no Bonding.

BTM_LE_AUTH_REQ_SC_MITM_BOND 

LE Secure Connection or legacy , MITM, Bonding.

BTM_LE_AUTH_REQ_MASK 

Auth Request Mask.

LE Key type.

Enumerator
BTM_LE_KEY_PENC 

encryption information of peer device

BTM_LE_KEY_PID 

identity key of the peer device

BTM_LE_KEY_PCSRK 

peer SRK

BTM_LE_KEY_PLK 

peer link key

BTM_LE_KEY_LENC 

Central role security information:div.

BTM_LE_KEY_LID 

Central device ID key.

BTM_LE_KEY_LCSRK 

local CSRK has been deliver to peer

BTM_LE_KEY_LLK 

Local link key.

Link Quality statistics action type.

Enumerator
WICED_CLEAR_LINK_QUALITY_STATS 

clear link quality stats

WICED_READ_LINK_QUALITY_STATS 

read link quality stats

WICED_READ_THEN_CLEAR_LINK_QUALITY_STATS 

read then clear link quality stats

OOB Data status.

Enumerator
BTM_OOB_NONE 

No OOB data.

BTM_OOB_PRESENT_192 

OOB data present (from the P-192 public key)

BTM_OOB_PRESENT_256 

OOB data present (from the P-256 public key)

BTM_OOB_PRESENT_192_256 

OOB data present (from the P-192 and P-256 public keys)

BTM_OOB_UNKNOWN 

OOB data unknown.

Type of OOB data required.

Enumerator
BTM_OOB_INVALID_TYPE 

Invalid OOB Type.

BTM_OOB_PEER 

Peer OOB data requested.

BTM_OOB_LOCAL 

Local OOB data requested.

BTM_OOB_BOTH 

Both local and peer OOB data requested.

Power Management status.

Enumerator
BTM_PM_STS_ACTIVE 

Active.

BTM_PM_STS_HOLD 

Hold.

BTM_PM_STS_SNIFF 

Sniff.

BTM_PM_STS_PARK 

Park.

BTM_PM_STS_SSR 

Sniff subrating notification.

BTM_PM_STS_PENDING 

Pending (waiting for status from controller)

BTM_PM_STS_ERROR 

Error (controller returned error)

HCI trace types.

Enumerator
HCI_TRACE_EVENT 

HCI event data from controller to the host.

HCI_TRACE_COMMAND 

HCI command data from host to controller.

HCI_TRACE_INCOMING_ACL_DATA 

HCI incoming acl data.

HCI_TRACE_OUTGOING_ACL_DATA 

HCI outgoing acl data.

HCI_TRACE_INCOMING_ISO_DATA 

HCI incoming ISO data.

HCI_TRACE_OUTGOING_ISO_DATA 

HCI outgoing ISO data.

HCI_TRACE_INCOMING_SCO_DATA 

HCI incoming sco data.

HCI_TRACE_OUTGOING_SCO_DATA 

HCI outgoing sco data.

.Enumeration of known link policy settings value assignments of the wiced_bt_link_policy_settings_t

Enumerator
WICED_ENABLE_ROLE_SWITCH 

Enable Role Switch.

WICED_ENABLE_HOLD_MODE 

Enable Hold mode.

WICED_ENABLE_SNIFF_MODE 

Enable Sniff mode.

Bluetooth Management events used in wiced_bt_management_cback_t.

Note
Some of the events are BR/EDR events which are available only in dual mode (BR/EDR+LE) operation
Return values of the management events Return values of notification and status events are typically not checked, unless explicitly mentioned. Return values of events requesting information from app should be WICED_BT_ERROR for cases where the app does not handle the events. For the request events which are handled by the app, indicate WICED_BT_SUCCESS as per the specific requirements of the event as documented below.
Enumerator
BTM_ENABLED_EVT 

Event notifies Bluetooth controller and host stack is enabled.

Event data: wiced_bt_management_evt_data_t::enabled Indicates the stack is up. Application can now start calling bluetooth wiced bt APIs

BTM_DISABLED_EVT 

Event notifies Bluetooth controller and host stack disabled.

Event data: NULL

BTM_POWER_MANAGEMENT_STATUS_EVT 

Event notifies Power management status change.

Event data: wiced_bt_management_evt_data_t::power_mgmt_notification

BTM_RE_START_EVT 

Event notifies Bluetooth controller and host stack re-enabled.

Event data: wiced_bt_management_evt_data_t::enabled

Note
: Not used
BTM_PIN_REQUEST_EVT 

Event requests app for the PIN to be used for pairing (legacy pairing only).

Event data: wiced_bt_management_evt_data_t::pin_request

BTM_USER_CONFIRMATION_REQUEST_EVT 

Event requests user confirmation for the numeric value to continue the App is expected to respond with using wiced_bt_dev_confirm_req_reply typically by confirming via a display to the user Event data: wiced_bt_management_evt_data_t::user_confirmation_request.

BTM_PASSKEY_NOTIFICATION_EVT 

Event notifies user passkey app App is expected to display the passkey to the user Event data: wiced_bt_management_evt_data_t::user_passkey_notification.

BTM_PASSKEY_REQUEST_EVT 

Event requests user passkey from app.

Application is expected to respond with the passkey for pairing with #wiced_bt_dev_pass_key_req_reply Event data: wiced_bt_management_evt_data_t::user_passkey_request

BTM_KEYPRESS_NOTIFICATION_EVT 

Event notifies keypress notification event to app Event data: wiced_bt_management_evt_data_t::user_keypress_notification.

BTM_PAIRING_IO_CAPABILITIES_BR_EDR_REQUEST_EVT 

Event requests BR/EDR IO capabilities for BR/EDR pairing from app Event data: wiced_bt_management_evt_data_t::pairing_io_capabilities_br_edr_request App is expected to fill in it's BR/EDR IO capabilities into the incoming wiced_bt_management_evt_data_t::pairing_io_capabilities_br_edr_request structure member.

Note
BR/EDR Only
BTM_PAIRING_IO_CAPABILITIES_BR_EDR_RESPONSE_EVT 

Event notifies received IO capabilities response for BR/EDR pairing.

Event data: wiced_bt_management_evt_data_t::pairing_io_capabilities_br_edr_response

Note
BR/EDR Only
BTM_PAIRING_IO_CAPABILITIES_BLE_REQUEST_EVT 

Event requests LE IO capabilities for LE pairing from app.

Peripheral can check peer io capabilities in event data before updating with local io capabilities. Event data: wiced_bt_management_evt_data_t::pairing_io_capabilities_ble_request

BTM_PAIRING_COMPLETE_EVT 

Event notifies simple pairing complete to app Event data: wiced_bt_management_evt_data_t::pairing_complete.

BTM_ENCRYPTION_STATUS_EVT 

Event notifies encryption status change to app Event data: wiced_bt_management_evt_data_t::encryption_status.

BTM_SECURITY_REQUEST_EVT 

Event requests app to allow stack to continue Security procedures/pairing to continue with the peer.

App needs to respond with wiced_bt_ble_security_grant App is expected to either allow or deny the incoming pairing request based on it's state Event data: wiced_bt_management_evt_data_t::security_request

BTM_SECURITY_FAILED_EVT 

Event notifies Security procedure/authentication failed to app Event data: wiced_bt_management_evt_data_t::security_failed.

BTM_SECURITY_ABORTED_EVT 

Event notifies security procedure aborted locally, or unexpected link drop.

Event data: wiced_bt_management_evt_data_t::security_aborted

BTM_READ_LOCAL_OOB_DATA_COMPLETE_EVT 

Event notifies result of reading local OOB data from the controller Event data: wiced_bt_management_evt_data_t::read_local_oob_data_complete.

Note
BR/EDR Only
BTM_REMOTE_OOB_DATA_REQUEST_EVT 

Event requests OOB data of the remote device from app Event data: wiced_bt_management_evt_data_t::remote_oob_data_request.

Note
BR/EDR Only
BTM_PAIRED_DEVICE_LINK_KEYS_UPDATE_EVT 

Event notifies app with the updated remote device link keys in this event.

App is expected to store device_link_keys to NV memory. This is the place to verify that the correct link key has been generated. Event data: wiced_bt_management_evt_data_t::paired_device_link_keys_update

BTM_PAIRED_DEVICE_LINK_KEYS_REQUEST_EVT 

Event requests for stored remote device link keys from app (restore device_link_keys from NV memory).

If available then fill the stored keys into wiced_bt_management_evt_data_t.paired_device_link_keys_request and return WICED_BT_SUCCESS else WICED_BT_ERROR Event data: wiced_bt_management_evt_data_t::paired_device_link_keys_request

BTM_LOCAL_IDENTITY_KEYS_UPDATE_EVT 

Event notifies updated local identity key to the app (stored local_identity_keys NV memory).

App is expected to store the identity key to NV memory. Event data: wiced_bt_management_evt_data_t::local_identity_keys_update

BTM_LOCAL_IDENTITY_KEYS_REQUEST_EVT 

Event requests local identity key from app (get local_identity_keys from NV memory).

If available then fill the local key into wiced_bt_management_evt_data_t.local_identity_keys_request and return WICED_BT_SUCCESS else WICED_BT_ERROR. Event data: wiced_bt_management_evt_data_t::local_identity_keys_request

BTM_BLE_SCAN_STATE_CHANGED_EVT 

Event notifies LE scan state change to app Event data: wiced_bt_management_evt_data_t::ble_scan_state_changed.

BTM_BLE_ADVERT_STATE_CHANGED_EVT 

Event notifies LE advertisement state change to app Event data: wiced_bt_management_evt_data_t::ble_advert_state_changed.

BTM_SMP_REMOTE_OOB_DATA_REQUEST_EVT 

Event requests SMP remote oob data.

Reply using wiced_bt_smp_oob_data_reply. Event data: wiced_bt_management_evt_data_t::smp_remote_oob_data_request

BTM_SMP_SC_REMOTE_OOB_DATA_REQUEST_EVT 

Event requests LE secure connection remote oob data request.

Reply using wiced_bt_smp_sc_oob_reply. Event data: wiced_bt_management_evt_data_t::smp_sc_remote_oob_data_request

BTM_SMP_SC_LOCAL_OOB_DATA_NOTIFICATION_EVT 

Event notifies LE secure connection local OOB data (wiced_bt_smp_create_local_sc_oob_data) returned by the stack The app is expected to copy the data into it's memory and share out of band with the peer To build the data to be shared, app can use #wiced_bt_dev_build_oob_data Event data: wiced_bt_management_evt_data_t::p_smp_sc_local_oob_data.

BTM_SCO_CONNECTED_EVT 

Event notfies SCO connected to app Event data: wiced_bt_management_evt_data_t::sco_connected.

Note
BR/EDR Only
BTM_SCO_DISCONNECTED_EVT 

Event notifies SCO disconnected event to app Event data: wiced_bt_management_evt_data_t::sco_disconnected.

Note
BR/EDR Only
BTM_SCO_CONNECTION_REQUEST_EVT 

Event notifies SCO connection request to app App is expected to reply with.

Event data: wiced_bt_management_evt_data_t::sco_connection_request

Note
BR/EDR Only
BTM_SCO_CONNECTION_CHANGE_EVT 

Event notifies SCO connection change to app Event data: wiced_bt_management_evt_data_t::sco_connection_change.

Note
BR/EDR Only
BTM_BLE_CONNECTION_PARAM_UPDATE 

Event notifies LE connection parameter update to app Event data: wiced_bt_management_evt_data_t::ble_connection_param_update.

BTM_BLE_PHY_UPDATE_EVT 

Event notifies LE Physical link update to app Event data: wiced_bt_management_evt_data_t::ble_phy_update_event.

BTM_LPM_STATE_LOW_POWER 

Event notifies BT device wake has been deasserted.

Used for Host Stack Use Case.

BTM_MULTI_ADVERT_RESP_EVENT 

Event notifies Multi adv command status event used for the status of the command sent Event data: wiced_bt_management_evt_data_t::ble_multi_adv_response_event.

BTM_BLE_DATA_LENGTH_UPDATE_EVENT 

Event to notify change in the data length and timeout configured for Rx and Tx on the LE link Event data: wiced_bt_management_evt_data_t::ble_data_length_update_event.

LE Multi adv opcodes returned.

Enumerator
SET_ADVT_PARAM_MULTI 

Opcode as a result of calling wiced_set_multi_advertisement_params.

SET_ADVT_DATA_MULTI 

Opcode as a result of calling wiced_set_multi_advertisement_data.

SET_SCAN_RESP_DATA_MULTI 

Opcode as a result of calling wiced_set_multi_advertisement_scan_response_data.

SET_RANDOM_ADDR_MULTI 

Opcode as a result of calling wiced_set_multi_advertisements_random_address.

SET_ADVT_ENABLE_MULTI 

Opcode as a result of calling wiced_start_multi_advertisements.

security flags for current BR/EDR link

Enumerator
BTM_SEC_LINK_ENCRYPTED 

Link encrypted.

BTM_SEC_LINK_PAIRED_WITHOUT_MITM 

Paired without man-in-the-middle protection.

BTM_SEC_LINK_PAIRED_WITH_MITM 

Link with man-in-the-middle protection.

SMP Pairing status codes.

Enumerator
SMP_SUCCESS 

Success.

SMP_PASSKEY_ENTRY_FAIL 

Passkey entry failed.

SMP_OOB_FAIL 

OOB failed.

SMP_PAIR_AUTH_FAIL 

Authentication failed.

SMP_CONFIRM_VALUE_ERR 

Value confirmation failed.

SMP_PAIR_NOT_SUPPORT 

Not supported.

SMP_ENC_KEY_SIZE 

Encryption key size failure.

SMP_INVALID_CMD 

Invalid command.

SMP_PAIR_FAIL_UNKNOWN 

Unknown failure.

SMP_REPEATED_ATTEMPTS 

Repeated attempts.

SMP_INVALID_PARAMETERS 

Invalid parameters.

SMP_DHKEY_CHK_FAIL 

DH Key check failed.

SMP_NUMERIC_COMPAR_FAIL 

Numeric comparison failed.

SMP_BR_PAIRING_IN_PROGR 

BR paIring in progress.

SMP_XTRANS_DERIVE_NOT_ALLOW 

Cross transport key derivation not allowed.

SMP_MAX_FAIL_RSN_PER_SPEC 

SMP Max Fail Reason as per spec.

SMP_PAIR_INTERNAL_ERR 

Internal error.

SMP_UNKNOWN_IO_CAP 

unknown IO capability, unable to decide associatino model

SMP_INIT_FAIL 

Initialization failed.

SMP_CONFIRM_FAIL 

Confirmation failed.

SMP_BUSY 

Busy.

SMP_ENC_FAIL 

Encryption failed.

SMP_STARTED 

Started.

SMP_RSP_TIMEOUT 

Response timeout.

SMP_FAIL 

Generic failure.

SMP_CONN_TOUT 

Connection timeout.