Generation of NFC NDEF messages used for BLE pairing. More...

Modules
	ac (Alternative carrier) records
	Generation of NFC NDEF Alternative Carrier records for NDEF messages.

	Advertising and Scan Response Data Encoder for NFC OOB pairing
	Function for encoding data in the Advertising and Scan Response Data format, which can be used to create payload of NFC message intended for initiating the Out-of-Band pairing.

	EP OOB records
	Generation of NFC NDEF EP OOB records for NDEF messages.

	Hs (Handover Select) records
	Generation of NFC NDEF Handover Select records for NDEF messages.

	LE OOB records
	Generation of NFC NDEF LE OOB records for NDEF messages.

Enumerations
enum	nfc_ble_pair_type_t { NFC_BLE_PAIR_MSG_BLUETOOTH_LE_SHORT, NFC_BLE_PAIR_MSG_BLUETOOTH_EP_SHORT, NFC_BLE_PAIR_MSG_FULL }
	Types of BLE pairing message. More...

Functions
ret_code_t	nfc_ble_simplified_le_oob_msg_encode (ble_advdata_t const const p_le_advdata, uint8_t p_buf, uint32_t *p_len)
	Function for encoding simplified LE OOB messages. More...

ret_code_t	nfc_ble_simplified_ep_oob_msg_encode (ble_advdata_t const const p_ep_advdata, uint8_t p_buf, uint32_t *p_len)
	Function for encoding simplified EP OOB messages. More...

ret_code_t	nfc_ble_full_handover_select_msg_encode (ble_advdata_t const const p_le_advdata, ble_advdata_t const const p_ep_advdata, uint8_t p_buf, uint32_t p_len)
	Function for encoding BLE Handover Select Messages. More...

ret_code_t	nfc_ble_pair_default_msg_encode (nfc_ble_pair_type_t nfc_ble_pair_type, ble_advdata_tk_value_t const p_tk_value, uint8_t p_buf, uint32_t *p_len)
	Function for encoding any type of BLE pairing messages with default BLE advertising data structures. More...

Detailed Description

Generation of NFC NDEF messages used for BLE pairing.

Enumeration Type Documentation

enum nfc_ble_pair_type_t

Types of BLE pairing message.

Use one of these values to choose the type of NDEF BLE pairing message.

Enumerator
NFC_BLE_PAIR_MSG_BLUETOOTH_LE_SHORT	Simplified LE OOB message.
NFC_BLE_PAIR_MSG_BLUETOOTH_EP_SHORT	Simplified EP OOB message.
NFC_BLE_PAIR_MSG_FULL	BLE Handover Select Message.

Function Documentation

ret_code_t nfc_ble_full_handover_select_msg_encode	(	ble_advdata_t const *const	p_le_advdata,
		ble_advdata_t const *const	p_ep_advdata,
		uint8_t *	p_buf,
		uint32_t *	p_len
	)

Function for encoding BLE Handover Select Messages.

This function encodes a BLE Handover Select Message into a buffer. The payload of the LE OOB record and the EP OOB record inside the message can be configured via the advertising data structures.

This function was implemented partially according to "Bluetooth Secure Simple Pairing Using NFC" (denotation "NFCForum-AD-BTSSP_1_1" published on 2014-01-09) chapters 3.1, 3.2, 4.1.1 and 4.1.2 (combined), and according to "Supplement to the Bluetooth Core Specification" (Version 5, adoption date: Dec 02 2014).

Note: To be able to encode the message, a SoftDevice must be enabled and configured.

Parameters

[in]	p_le_advdata	Pointer to the BLE advertising data structure for the LE OOB record.
[in]	p_ep_advdata	Pointer to the BLE advertising data structure for the EP OOB record.
[out]	p_buf	Pointer to the buffer for the message.
[in,out]	p_len	Size of the available memory for the message as input. Size of the generated message as output.

Return values

NRF_SUCCESS	If the function completed successfully.
NRF_ERROR_xxx	If an error occurred.

ret_code_t nfc_ble_pair_default_msg_encode	(	nfc_ble_pair_type_t	nfc_ble_pair_type,
		ble_advdata_tk_value_t *const	p_tk_value,
		uint8_t *	p_buf,
		uint32_t *	p_len
	)

Function for encoding any type of BLE pairing messages with default BLE advertising data structures.

This function encodes a BLE pairing message into a buffer. The message can be encoded as one of the three message types (using nfc_ble_simplified_le_oob_msg_encode, nfc_ble_simplified_ep_oob_msg_encode, or nfc_ble_full_handover_select_msg_encode), according to the nfc_ble_pair_type parameter. LE and EP OOB records use the default advertising data structure configuration. Only one field ('Security Manager TK') in the BLE advertising data can be configured for both records by specifying the p_tk_value parameter.

For LE OOB records, the default BLE advertising data structure configuration fills the required fields 'LE Bluetooth Device Address' and 'LE Role' and the optional fields 'Appearance', 'Local Name', and 'Flags'.

For EP OOB records, the default BLE advertising data structure configuration fills the required field 'Security Manager Out Of Band Flags' and the optional fields 'Appearance', 'Local Name', and 'Flags'.

Note: To be able to encode the message, a SoftDevice must be enabled and configured.

Parameters

[in]	nfc_ble_pair_type	Type of BLE pairing message.
[in]	p_tk_value	Pointer to the authentication Temporary Key (TK). If NULL, Just Works pairing over NFC mode is used. Otherwise, Out-of-Band pairing over NFC mode is used.
[out]	p_buf	Pointer to the buffer for the message.
[in,out]	p_len	Size of the available memory for the message as input. Size of the generated message as output.

Return values

NRF_SUCCESS	If the function completed successfully.
NRF_ERROR_xxx	If an error occurred.

ret_code_t nfc_ble_simplified_ep_oob_msg_encode	(	ble_advdata_t const *const	p_ep_advdata,
		uint8_t *	p_buf,
		uint32_t *	p_len
	)

Function for encoding simplified EP OOB messages.

This function encodes a simplified EP OOB message into a buffer. The payload of the EP OOB record inside the message can be configured via the advertising data structure.

This function was implemented partially according to "Bluetooth Secure Simple Pairing Using NFC" (denotation "NFCForum-AD-BTSSP_1_1" published on 2014-01-09) chapters 3.1, 3.2, 4.3.1, and according to "Supplement to the Bluetooth Core Specification" (Version 5, adoption date: Dec 02 2014).

Note: To be able to encode the message, a SoftDevice must be enabled and configured.

Parameters

[in]	p_ep_advdata	Pointer to the BLE advertising data structure for the EP OOB record.
[out]	p_buf	Pointer to the buffer for the message.
[in,out]	p_len	Size of the available memory for the message as input. Size of the generated message as output.

Return values

NRF_SUCCESS	If the function completed successfully.
NRF_ERROR_xxx	If an error occurred.

ret_code_t nfc_ble_simplified_le_oob_msg_encode	(	ble_advdata_t const *const	p_le_advdata,
		uint8_t *	p_buf,
		uint32_t *	p_len
	)

Function for encoding simplified LE OOB messages.

This function encodes a simplified LE OOB message into a buffer. The payload of the LE OOB record inside the message can be configured via the advertising data structure.

This function was implemented partially according to "Bluetooth Secure Simple Pairing Using NFC" (denotation "NFCForum-AD-BTSSP_1_1" published on 2014-01-09) chapters 3.1, 3.2, 4.3.2, and according to "Supplement to the Bluetooth Core Specification" (Version 5, adoption date: Dec 02 2014).

Note: To be able to encode the message, a SoftDevice must be enabled and configured.

Parameters

[in]	p_le_advdata	Pointer to the BLE advertising data structure for the LE OOB record.
[out]	p_buf	Pointer to the buffer for the message.
[in,out]	p_len	Size of the available memory for the message as input. Size of the generated message as output.

Return values

NRF_SUCCESS	If the function completed successfully.
NRF_ERROR_xxx	If an error occurred.

Modules

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

Function Documentation