bt_le_ext_adv_cb Struct Reference

Callback struct to notify about advertiser activity. More...

#include <bluetooth.h>

Data Fields
void(*	sent )(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_sent_info *info)
	The advertising set was disabled after reaching limit.
void(*	connected )(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_connected_info *info)
	The advertising set has accepted a new connection.
void(*	scanned )(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_scanned_info *info)
	The advertising set has sent scan response data.

Detailed Description

Callback struct to notify about advertiser activity.

The bt_le_ext_adv_cb struct contains callback functions that are invoked in response to various events related to the advertising set. These events include:

• Completion of advertising data transmission
• Acceptance of a new connection
• Transmission of scan response data
• If privacy is enabled:
  • Expiration of the advertising set's validity
• If PAwR (Periodic Advertising with Response) is enabled:
  • Readiness to send one or more PAwR subevents, namely the LE Periodic Advertising Subevent Data Request event
  • Response of synced devices to a periodic advertising subevent indication has been received, namely the LE Periodic Advertising Response Report event

Note

Must point to valid memory during the lifetime of the advertising set.

Used in bt_le_ext_adv_create.

Field Documentation

connected

void(* bt_le_ext_adv_cb::connected) (struct bt_le_ext_adv *adv, struct bt_le_ext_adv_connected_info *info)

The advertising set has accepted a new connection.

This callback notifies the application that the advertising set has accepted a new connection.

Parameters

adv	The advertising set object.
info	Information about the connected event.

scanned

void(* bt_le_ext_adv_cb::scanned) (struct bt_le_ext_adv *adv, struct bt_le_ext_adv_scanned_info *info)

The advertising set has sent scan response data.

This callback notifies the application that the advertising set has has received a Scan Request packet, and has sent a Scan Response packet.

Parameters

adv	The advertising set object.
info	Information about the scanned event, namely the address.

sent

void(* bt_le_ext_adv_cb::sent) (struct bt_le_ext_adv *adv, struct bt_le_ext_adv_sent_info *info)

The advertising set was disabled after reaching limit.

This callback is invoked when the limit set in bt_le_ext_adv_start_param::timeout or bt_le_ext_adv_start_param::num_events is reached.

Parameters

adv	The advertising set object.
info	Information about the sent event.

---

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

• zephyr/bluetooth/bluetooth.h