BLE_GAP_SetDeviceAddr

C

uint16_t BLE_GAP_SetDeviceAddr(BLE_GAP_Addr_T *p_addr);

Description

Sets the Bluetooth device address (identity address).

Note

The address type must be either Address types_PUBLIC or Address types_RANDOM_STATIC. The address identifies the device to other Bluetooth devices. The default IRK (Identity Resolving Key) is automatically changed if the Bluetooth device address is updated.

Parameters

ParameterDescription
[in] p_addrPointer to the device address buffer. See BLE_GAP_Addr_T.

Return values

Return valueDescription
MBA_RES_SUCCESSSuccessfully sets the device address.
MBA_RES_FAILFailed to set device address due to invalid address type or other conditions.
MBA_RES_OOMInternal memory allocation failure occurred.