PM0237 datasheet(64/88 Pages) STMICROELECTRONICS

64 / 88 page

Design an application using BlueNRG, BlueNRG-MS ACI APIs

PM0237

64/88

DocID027104 Rev 2

ret = aci_hal_write_config_data(CONFIG_DATA_IR_OFFSET,

CONFIG_DATA_IR_LEN,(uint8_t *) IR);

To successfully pair with a device, IO capabilities have to be correctly configured, depending

on the IO capabilily available on the selected device.

aci_gap_set_io_capability(io_capability)

should be used with one of the following

io_capability

value:

0x00: Display Only

0x01: Display yes/no

0x02: Keyboard Only

0x03: No Input, no output

0x04: Keyboard display

PassKey Entry example with 2 BlueNRG devices: Device_1, Device_2

The following pseudocode example illustrates only the specific steps to be followed for

pairing two devices by using the PassKey entry method.

As described in Section Table 11.: Methods used for calculating the Temporary Key (TK),

Device_1, Device_2 have to set the IO capability in order to select PassKey entry as a

security method.

On this particular example, "Display Only" on Device_1 and "KeyBoard Only" on Device_2

are selected, as follows:

/* Device_1: */

tBleStatus ret;

ret = aci_gap_set_io_capability(IO_CAP_DISPLAY_ONLY)

if (ret != BLE_STATUS_SUCCESS) PRINTF("Failure.\n")}

/* Device_2 */

tBleStatus ret;

ret = aci_gap_set_io_capability(IO_CAP_KEYBOARD_ONLY)

if (ret != BLE_STATUS_SUCCESS) PRINTF("Failure.\n")}

Once the IO capability are defined, the aci_gap_set_auth_requirement () should be used

for setting all the security authentication requirements the device needs (MITM mode

(authenticated link or not), OOB data present or not, use fixed pin or not, enabling bonding

or not).

The following pseudocode example illustrates only the specific steps to be followed for

setting the authentication requirements for a device with: “MITM protection , No OOB data,

don’t use fixed pin”: this configuration is used to authenticate the link and to use a not fixed

pin during the pairing process with PassKey Method.

ret = aci_gap_set_auth_requirement(MITM_PROTECTION_REQUIRED,

OOB_AUTH_DATA_ABSENT, /* no OOB data is

present */

NULL, /* no OOB data */

/* Min. encryption key size */

16, /* Max encryption key size */

DONOT_USE_FIXED_PIN_FOR_PAIRING,/* no fixed

pin */

0, /* fixed pin not used */

PM0237 Datasheet(PDF) 64 Page - STMicroelectronics

PM0237 Datasheet(HTML) 64 Page - STMicroelectronics

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88

Datasheet Download

Link URL