sd_ble_gap_lesc_oob_data_set()

uint32_t sd_ble_gap_lesc_oob_data_set	(	uint16_t	conn_handle,
		ble_gap_lesc_oob_data_t const *	p_oobd_own,
		ble_gap_lesc_oob_data_t const *	p_oobd_peer )

#include <ble_gap.h>

Provide the OOB data sent/received out of band.

Note

An authentication procedure with OOB selected as an algorithm must be in progress when calling this function.

A BLE_GAP_EVT_LESC_DHKEY_REQUEST event with the oobd_req set to 1 must have been received prior to calling this function.

Events generated

This function is used during authentication procedures, see the list of events in the documentation of sd_ble_gap_authenticate.

Relevant Message Sequence Charts

Peripheral LESC Bonding: Out of Band

Central LESC Bonding: Out of Band

Parameters

[in]	conn_handle	Connection handle.
[in]	p_oobd_own	The OOB data sent out of band to a peer or NULL if the peer has not received OOB data. Must correspond to ble_gap_sec_params_t::oob flag in BLE_GAP_EVT_SEC_PARAMS_REQUEST.
[in]	p_oobd_peer	The OOB data received out of band from a peer or NULL if none received. Must correspond to ble_gap_sec_params_t::oob flag in sd_ble_gap_authenticate in the central role or in sd_ble_gap_sec_params_reply in the peripheral role.

Return values

NRF_SUCCESS	OOB data accepted.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
NRF_ERROR_INVALID_STATE	Invalid state to perform operation. Either: Authentication key not requested Not expecting LESC OOB data Have not actually exchanged passkeys.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.