Advertising set info structure. More...

#include <bluetooth.h>

Data Fields
uint8_t	id
	Local identity handle.
int8_t	tx_power
	Currently selected Transmit Power in dBm.
uint8_t	sid
	Advertising Set ID.
const bt_addr_le_t *	addr
	Current local advertising address used.
enum bt_le_ext_adv_state	ext_adv_state
	Extended advertising state.
enum bt_le_per_adv_state	per_adv_state
	Periodic advertising state.

Detailed Description

Advertising set info structure.

Field Documentation

◆ addr

const bt_addr_le_t* bt_le_ext_adv_info::addr

Current local advertising address used.

The address the set advertises with, whether that is an identity address, a static random address, an RPA or an NRPA. For a set advertising with an RPA this is the RPA itself, not the identity address it resolves to. The value is determined when the advertising parameters are set, so it is only meaningful once bt_le_ext_adv_create() or bt_le_ext_adv_update_param() has succeeded, and reads as BT_ADDR_LE_ANY before that.

The pointer is valid for as long as the advertising set object itself, i.e. until bt_le_ext_adv_delete(), and tracks the set across reconfiguration and private address rotation. Copy the address if it is needed beyond that.

Note: If the set was configured to let the controller resolve the address against its resolving list, the controller may substitute a locally generated RPA that the host cannot observe. The configured fallback address is reported in that case.

◆ ext_adv_state

enum bt_le_ext_adv_state bt_le_ext_adv_info::ext_adv_state

Extended advertising state.

◆ id

uint8_t bt_le_ext_adv_info::id

Local identity handle.

◆ per_adv_state

enum bt_le_per_adv_state bt_le_ext_adv_info::per_adv_state

Periodic advertising state.

◆ sid

uint8_t bt_le_ext_adv_info::sid

Advertising Set ID.

◆ tx_power

int8_t bt_le_ext_adv_info::tx_power

Currently selected Transmit Power in dBm.

Range: -127 to +20.

The documentation for this struct was generated from the following file:

include/zephyr/bluetooth/bluetooth.h

Data Fields