LE Pairing Responder

The LE Pairing Responder model is a vendor model. This model can be used to hand over a passkey that will authenticate a Bluetooth LE connection over a mesh network when it is not possible to use other pairing methods.

Before the pairing is initiated, an initiator should send an LE Pairing message with Passkey Reset sub-opcode to set a new passkey for the next pairing request. The passkey returned in the LE Pairing message with the Passkey Status sub-opcode should be used for the next pairing.

The passkey is generated using the bt_rand() function and set to the host using the bt_passkey_set() function. The latter requires the CONFIG_BT_FIXED_PASSKEY option to be enabled.

Note

The warning generated by the CONFIG_BT_FIXED_PASSKEY option should be disregarded as long as the application always invalidates the previously used passkey by calling the bt_mesh_le_pair_resp_passkey_invalidate() function regardless of the pairing result (see below).

This model requires an application to only enable the display capability for the LE pairing by setting the bt_conn_auth_cb.pairing_display callback. After every pairing request, the application must invalidate the previously used passkey by calling the bt_mesh_le_pair_resp_passkey_invalidate() function. This function can be called from callbacks bt_conn_auth_info_cb.pairing_complete and bt_conn_auth_info_cb.pairing_failed. See the samples/bluetooth/mesh/common/smp_bt_auth.c file for the reference.

The model supports only LE Secure Connection pairing and requires the CONFIG_BT_SMP_SC_ONLY to be enabled.

Messages

The LE Pairing Request model defines a single message with opcode 0x11, which defines at least 1-byte long sub-opcode field. The supported sub-opcodes are:

Passkey Reset

Sent to instruct a node to generate a new passkey for the next pairing request. The sub-opcode field value is 0x00.

Passkey Status

Sent as a response to the Passkey Reset message. The sub-opcode field value is 0x01. The message contains the 1-byte long request status, and optionally a 3-byte long, 6-digit passkey. If the passkey was generated successfully (the status field is 0x00), the message contains a 3-byte long, 6-digit passkey.

States

None

Extended models

None

Persistent storage

None

API documentation

Header file: include/bluetooth/mesh/vnd/le_pair_resp.h

Source file: subsys/bluetooth/mesh/vnd/le_pair_resp.c

group bt_mesh_le_pair_resp

API for the LE Pairing Responder model.

Defines

BT_MESH_VENDOR_COMPANY_ID_LE_PAIR_RESP

BT_MESH_MODEL_ID_LE_PAIR_RESP

BT_MESH_MODEL_LE_PAIR_RESP

LE Pairing Responder model entry.

Functions

void bt_mesh_le_pair_resp_passkey_invalidate(void)

void bt_mesh_le_pair_resp_passkey_set(uint32_t passkey)