sd_ble_gap_addr_set()

uint32_t sd_ble_gap_addr_set

(

ble_gap_addr_t const *

p_addr

)

#include <ble_gap.h>

Set the local Bluetooth identity address.

   The local Bluetooth identity address is the address that identifies this device to other peers.
   The address type must be either @ref BLE_GAP_ADDR_TYPE_PUBLIC or @ref BLE_GAP_ADDR_TYPE_RANDOM_STATIC.

Note

The identity address cannot be changed while advertising.

This address will be distributed to the peer during bonding. If the address changes, the address stored in the peer device will not be valid and the ability to reconnect using the old address will be lost.

By default the SoftDevice will set an address of type BLE_GAP_ADDR_TYPE_RANDOM_STATIC upon being enabled. The address is a random number populated during the IC manufacturing process and remains unchanged for the lifetime of each IC.

Relevant Message Sequence Charts

Advertising

Parameters

[in]

p_addr

Pointer to address structure.

Return values

NRF_SUCCESS	Address successfully set.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
BLE_ERROR_GAP_INVALID_BLE_ADDR	Invalid address.
NRF_ERROR_BUSY	The stack is busy, process pending events and retry.
NRF_ERROR_INVALID_STATE	The identity address cannot be changed while advertising.