nrf-softdevice-s132

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gap_device_identities_set(
pp_id_keys: *const *const ble_gap_id_key_t,
pp_local_irks: *const *const ble_gap_irk_t,
len: u8
) -> u32
Expand description

@brief Set device identity list.

@note Only one device identity list can be used at a time and the list is shared between the BLE roles. The device identity list cannot be set if a BLE role is using the list.

@param[in] pp_id_keys Pointer to an array of peer identity addresses and peer IRKs, if NULL the device identity list will be cleared. @param[in] pp_local_irks Pointer to an array of local IRKs. Each entry in the array maps to the entry in pp_id_keys at the same index. To fill in the list with the currently set device IRK for all peers, set to NULL. @param[in] len Length of the device identity list, maximum @ref BLE_GAP_DEVICE_IDENTITIES_MAX_COUNT.

@mscs @mmsc{@ref BLE_GAP_PRIVACY_ADV_MSC} @mmsc{@ref BLE_GAP_PRIVACY_SCAN_MSC} @mmsc{@ref BLE_GAP_PRIVACY_SCAN_PRIVATE_SCAN_MSC} @mmsc{@ref BLE_GAP_PRIVACY_ADV_DIR_PRIV_MSC} @mmsc{@ref BLE_GAP_PERIPH_CONN_PRIV_MSC} @mmsc{@ref BLE_GAP_CENTRAL_CONN_PRIV_MSC} @endmscs

@retval ::NRF_SUCCESS The device identity list successfully set/cleared. @retval ::NRF_ERROR_INVALID_ADDR The device identity list (or one of its entries) provided is invalid. This code may be returned if the local IRK list also has an invalid entry. @retval ::BLE_ERROR_GAP_DEVICE_IDENTITIES_IN_USE The device identity list is in use and cannot be set or cleared. @retval ::BLE_ERROR_GAP_DEVICE_IDENTITIES_DUPLICATE The device identity list contains multiple entries with the same identity address. @retval ::BLE_ERROR_GAP_INVALID_BLE_ADDR Invalid address type is supplied. @retval ::NRF_ERROR_DATA_SIZE The given device identity list size invalid (zero or too large); this can only return when pp_id_keys is not NULL.