Address Management APIs

This group includes GAP address APIs.

Functions
at_ble_status_t	at_ble_addr_get (at_ble_addr_t *address)
	Get device BT Address. More...
at_ble_status_t	at_ble_addr_set (at_ble_addr_t *address)
	Set device BT Address. More...
at_ble_status_t	at_ble_random_address_resolve (uint8_t nb_key, at_ble_addr_t *rand_addr, uint8_t *irk_key)
	Handles request of resolving a resolvable random address ,AT_BLE_RESOLV_RAND_ADDR_STATUS event is used to inform which key has been used to perform resolution for the returned address. More...

at_ble_status_t at_ble_addr_get

(

at_ble_addr_t *

address

)

Get device BT Address.

Parameters

[out]

address

pointer to save returned BT Address

Returns

Upon successful completion the function shall return AT_BLE_SUCCESS, Otherwise the function shall return at_ble_status_t

Referenced by app_init(), ble_device_config(), ble_set_address(), and ble_set_dev_config().

at_ble_status_t at_ble_addr_set

(

at_ble_addr_t *

address

)

Set device BT Address.

Parameters

[in]

address

the new BT address

Precondition

In case of using resolvable random address, at_ble_set_dev_config is used to set device IRK key otherwise default randomness IRK key values will be used.

Note

• If address type is AT_BLE_ADDRESS_RANDOM_PRIVATE_RESOLVABLE or AT_BLE_ADDRESS_RANDOM_PRIVATE_NON_RESOLVABLE, the given address is ignored and address will be auto generated.
• If address type is random , then AT_BLE_RAND_ADDR_CHANGED event is triggered after first air operation either advertising, connecting, or scanning to inform application about the used random address.
• The default duration before regenerating device address is AT_RENEW_DUR_VAL_MIN, to change renew address duration use at_ble_set_dev_config.

Returns

Upon successful completion the function shall return AT_BLE_SUCCESS, Otherwise the function shall return at_ble_status_t

Referenced by app_init(), ble_device_config(), ble_set_address(), and ble_set_dev_config().

at_ble_status_t at_ble_random_address_resolve	(	uint8_t	nb_key,
		at_ble_addr_t *	rand_addr,
		uint8_t *	irk_key
	)

Handles request of resolving a resolvable random address ,AT_BLE_RESOLV_RAND_ADDR_STATUS event is used to inform which key has been used to perform resolution for the returned address.

Parameters

[in]	nb_key	number of provided IRK
[in]	rand_addr	pointer to the random address
[in]	irk_key	array of IRK used for address resolution

Note

• irk_key argument, should be known after exchanging keys at security level (bonding).

Returns

Upon successful completion the function shall return AT_BLE_SUCCESS, Otherwise the function shall return at_ble_status_t

Referenced by ble_connected_state_handler().