Functions
void	wiced_bt_dev_confirm_req_reply (wiced_result_t res, wiced_bt_device_address_t bd_addr)

void	wiced_bt_dev_pass_key_req_reply (wiced_result_t res, wiced_bt_device_address_t bd_addr, uint32_t passkey)

void	wiced_bt_dev_pin_code_reply (wiced_bt_device_address_t bd_addr, wiced_result_t res, uint8_t pin_len, uint8_t *p_pin)

wiced_result_t	wiced_bt_dev_read_local_oob_data (void)

void	wiced_bt_dev_remote_oob_data_reply (wiced_result_t res, wiced_bt_device_address_t bd_addr, wiced_bool_t is_extended_oob_data, BT_OCTET16 c_192, BT_OCTET16 r_192, BT_OCTET16 c_256, BT_OCTET16 r_256)

wiced_result_t	wiced_bt_dev_sec_bond (wiced_bt_device_address_t bd_addr, wiced_bt_ble_address_type_t bd_addr_type, wiced_bt_transport_t transport, uint8_t pin_len, uint8_t *p_pin)

wiced_result_t	wiced_bt_dev_sec_bond_cancel (wiced_bt_device_address_t bd_addr)

void	wiced_bt_dev_send_key_press_notif (wiced_bt_device_address_t bd_addr, wiced_bt_dev_passkey_entry_type_t type)

wiced_result_t	wiced_bt_dev_set_encryption (wiced_bt_device_address_t bd_addr, wiced_bt_transport_t transport, void *p_ref_data)

wiced_bool_t	wiced_bt_smp_create_local_sc_oob_data (wiced_bt_device_address_t bd_addr, wiced_bt_ble_address_type_t bd_addr_type)

void	wiced_bt_smp_sc_oob_reply (uint8_t *p_oob_data)

Detailed Description

This module defines the generic procedures related to discovery of Bluetooth devices and link management aspects of connecting to Bluetooth devices. It also defines procedures related to use of different security levels.

Function Documentation

void wiced_bt_dev_confirm_req_reply	(	wiced_result_t	res,
		wiced_bt_device_address_t	bd_addr
	)

Function wiced_bt_dev_confirm_req_reply

             Confirm the numeric value for pairing (in response to <b>BTM_USER_CONFIRMATION_REQUEST_EVT </b> of #wiced_bt_management_cback_t)

Parameters

[in]	res	: result of the operation WICED_BT_SUCCESS if success
[in]	bd_addr	: Address of the peer device

Returns: void

void wiced_bt_dev_pass_key_req_reply	(	wiced_result_t	res,
		wiced_bt_device_address_t	bd_addr,
		uint32_t	passkey
	)

Function wiced_bt_dev_pass_key_req_reply

             Provide the pairing passkey (in response to <b>BTM_PASSKEY_REQUEST_EVT </b> of #wiced_bt_management_cback_t)

Parameters

[in]	res	: result of the operation WICED_BT_SUCCESS if success
[in]	bd_addr	: Address of the peer device
[in]	passkey	: numeric value in the range of 0 - 999999(0xF423F).

Returns: void

void wiced_bt_dev_pin_code_reply	(	wiced_bt_device_address_t	bd_addr,
		wiced_result_t	res,
		uint8_t	pin_len,
		uint8_t *	p_pin
	)

Function wiced_bt_dev_pin_code_reply

             PIN code reply (use in response to <b>BTM_PIN_REQUEST_EVT </b> in #wiced_bt_management_cback_t)

Parameters

[in]	bd_addr	: Address of the device for which PIN was requested
[in]	res	: result of the operation WICED_BT_SUCCESS if success
[in]	pin_len	: length in bytes of the PIN Code
[in]	p_pin	: pointer to array with the PIN Code

Returns: void

wiced_result_t wiced_bt_dev_read_local_oob_data ( void )

Function wiced_bt_dev_read_local_oob_data

             Read the local OOB data from controller (for sending
             to peer device over oob message). When
             operation is completed, local OOB data will be
             provided via BTM_READ_LOCAL_OOB_DATA_COMPLETE_EVT.

void wiced_bt_dev_remote_oob_data_reply	(	wiced_result_t	res,
		wiced_bt_device_address_t	bd_addr,
		wiced_bool_t	is_extended_oob_data,
		BT_OCTET16	c_192,
		BT_OCTET16	r_192,
		BT_OCTET16	c_256,
		BT_OCTET16	r_256
	)

Function wiced_bt_dev_remote_oob_data_reply

             Provide the remote OOB extended data for Simple Pairing
             in response to BTM_REMOTE_OOB_DATA_REQUEST_EVT

Parameters

[in]	bd_addr	: Address of the peer device
[in]	is_extended_oob_data	: TRUE if extended OOB data (set according to BTM_REMOTE_OOB_DATA_REQUEST_EVT request)
[in]	c_192	: simple pairing Hash C derived from the P-192 public key.
[in]	r_192	: simple pairing Randomizer R associated with the P-192 public key.
[in]	c_256	: simple pairing Hash C derived from the P-256 public key (if is_extended_oob_data=TRUE)
[in]	r_256	: simple pairing Randomizer R associated with the P-256 public key (if is_extended_oob_data=TRUE)

wiced_result_t wiced_bt_dev_sec_bond	(	wiced_bt_device_address_t	bd_addr,
		wiced_bt_ble_address_type_t	bd_addr_type,
		wiced_bt_transport_t	transport,
		uint8_t	pin_len,
		uint8_t *	p_pin
	)

Function wiced_bt_dev_sec_bond

             Bond with peer device. If the connection is already up, but not secure, pairing is attempted.

Note: PIN parameters are only needed when bonding with legacy devices (pre-2.1 Core Spec)

Parameters

[in]	bd_addr	: Peer device bd address to pair with.
[in]	bd_addr_type	: BLE_ADDR_PUBLIC or BLE_ADDR_RANDOM (applies to LE devices only)
[in]	transport	: BT_TRANSPORT_BR_EDR or BT_TRANSPORT_LE
[in]	pin_len	: Length of input parameter p_pin (0 if not used).
[in]	p_pin	: Pointer to Pin Code to use (NULL if not used).

Returns

            WICED_BT_PENDING if successfully initiated,
            WICED_BT_SUCCESS if already paired to the device, else
            error code

wiced_result_t wiced_bt_dev_sec_bond_cancel ( wiced_bt_device_address_t bd_addr )

Function wiced_bt_dev_sec_bond_cancel

Cancel an ongoing bonding process with peer device.

Parameters

[in] bd_addr : Peer device bd address to pair with.

Returns

            WICED_BT_PENDING if cancel initiated,
            WICED_BT_SUCCESS if cancel has completed already, else error code.

void wiced_bt_dev_send_key_press_notif	(	wiced_bt_device_address_t	bd_addr,
		wiced_bt_dev_passkey_entry_type_t	type
	)

Function wiced_bt_dev_send_key_press_notif

             Inform remote device of keypress during pairing.

             Used during the passkey entry by a device with KeyboardOnly IO capabilities
             (typically a HID keyboard device).

Parameters

[in]	bd_addr	: Address of the peer device
[in]	type	: notification type

wiced_result_t wiced_bt_dev_set_encryption	(	wiced_bt_device_address_t	bd_addr,
		wiced_bt_transport_t	transport,
		void *	p_ref_data
	)

Function wiced_bt_dev_set_encryption

             Encrypt the specified connection.
             Status is notified using <b>BTM_ENCRYPTION_STATUS_EVT </b> of #wiced_bt_management_cback_t.

Parameters

[in]	bd_addr	: Address of peer device
[in]	transport	: BT_TRANSPORT_BR_EDR or BT_TRANSPORT_LE
[in]	p_ref_data	: pointer to reference data to be passed upon completion (NULL if no data)

Returns

             WICED_BT_SUCCESS            : already encrypted
             WICED_BT_PENDING            : command will be returned in the callback
             WICED_BT_WRONG_MODE         : connection not up.
             WICED_BT_BUSY               : security procedures are currently active

wiced_bool_t wiced_bt_smp_create_local_sc_oob_data	(	wiced_bt_device_address_t	bd_addr,
		wiced_bt_ble_address_type_t	bd_addr_type
	)

Function wiced_bt_smp_create_local_sc_oob_data

             Create local BLE SC (secure connection) OOB data. When
             operation is completed, local OOB data will be
             provided via BTM_SMP_SC_LOCAL_OOB_DATA_NOTIFICATION_EVT.

Parameters

[in]	bd_addr	: intended remote address for the OOB data
[in]	bd_addr_type	: BLE_ADDR_PUBLIC or BLE_ADDR_PUBLIC

Returns: TRUE: creation of local SC OOB data set started.

void wiced_bt_smp_sc_oob_reply ( uint8_t * p_oob_data )

Function wiced_bt_smp_sc_oob_reply

Description Provide the SC OOB data for SMP in response to BTM_SMP_SC_REMOTE_OOB_DATA_REQUEST_EVT

Parameters

[in] p_oob_data : oob data

Functions

Detailed Description

Function Documentation