S112 SoftDevice v6.0.0
Data Fields
ble_gap_privacy_params_t Struct Reference

Privacy. More...

#include <ble_gap.h>

Data Fields

uint8_t privacy_mode
uint8_t private_addr_type
uint16_t private_addr_cycle_s

Detailed Description


   The privacy feature provides a way for the device to avoid being tracked over a period of time.
   The privacy feature, when enabled, hides the local device identity and replaces it with a private address
   that is automatically refreshed at a specified interval.

   If a device still wants to be recognized by other peers, it needs to share it's Identity Resolving Key (IRK).
   With this key, a device can generate a random private address that can only be recognized by peers in possession of that key,
   and devices can establish connections without revealing their real identities.

   Both network privacy (@ref BLE_GAP_PRIVACY_MODE_NETWORK_PRIVACY) and device privacy (@ref BLE_GAP_PRIVACY_MODE_DEVICE_PRIVACY)
   are supported.
If the device IRK is updated, the new IRK becomes the one to be distributed in all bonding procedures performed after sd_ble_gap_privacy_set returns. The IRK distributed during bonding procedure is the device IRK that is active when sd_ble_gap_sec_params_reply is called.

Field Documentation

ble_gap_irk_t* ble_gap_privacy_params_t::p_device_irk
        When used as input, pointer to IRK structure that will be used as the default IRK. If NULL, the device default IRK will be used.

When used as output, pointer to IRK structure where the current default IRK will be written to. If NULL, this argument is ignored. By default, the default IRK is used to generate random private resolvable addresses for the local device unless instructed otherwise.

uint8_t ble_gap_privacy_params_t::privacy_mode

Privacy mode, see Privacy modes. Default is BLE_GAP_PRIVACY_MODE_OFF.

uint16_t ble_gap_privacy_params_t::private_addr_cycle_s

Private address cycle interval in seconds. Providing an address cycle value of 0 will use the default value defined by BLE_GAP_DEFAULT_PRIVATE_ADDR_CYCLE_INTERVAL_S.

uint8_t ble_gap_privacy_params_t::private_addr_type

Documentation feedback | Developer Zone | Subscribe | Updated