sl_bt_evt_scanner_extended_advertisement_reportScanner#

Reports an advertising or scan response packet from an advertising device that uses extended advertising PDUs.

Data Structures

struct  

sl_bt_evt_scanner_extended_advertisement_report_s

Data structure of the extended_advertisement_report event.

Macros

#define  

sl_bt_evt_scanner_extended_advertisement_report_id   0x020500a0

Identifier of the extended_advertisement_report event.

Detailed Description#

Reports an advertising or scan response packet from an advertising device that uses extended advertising PDUs.

Multiple events may be reported for single advertisement train.

This event is used to report advertisements only if the application includes the bluetooth_feature_extended_scanner component. Otherwise, the sl_bt_evt_scanner_scan_report event is used for maintaining the backwards compatibility.


Data Structure Documentation#

sl_bt_evt_scanner_extended_advertisement_report_s#

struct sl_bt_evt_scanner_extended_advertisement_report_s

Data structure of the extended_advertisement_report event.

Data Fields

name

description

uint8_t

event_flags

The event type flag(s) in the advertisement packet. Value: One or more flags defined in Event Type Flags of Advertisement Reports

bd_addr

address

Advertiser address

uint8_t

address_type

Advertiser address type. Values:

  • 0: Public address

  • 1: Random address

  • 255: No address provided (anonymous advertising)

uint8_t

bonding

Bonding handle if the remote advertising device has previously bonded with the local device. Values:

  • SL_BT_INVALID_BONDING_HANDLE (0xff): No bonding

  • Other: Bonding handle

int8_t

rssi

Signal strength indicator (RSSI) in the last received packet. Units: dBm

  • Range: -127 to +20

uint8_t

channel

The channel number on which the last packet was received

bd_addr

target_address

The target address if this is directed advertising, otherwise ignored

uint8_t

target_address_type

The target address type if this is directed advertising, otherwise ignored. Values:

  • 0: Public address

  • 1: Random address

uint8_t

adv_sid

Advertising set identifier

uint8_t

primary_phy

The PHY on which advertising packets are transmitted on the primary advertising channel Values:

  • sl_bt_gap_phy_1m (0x1): 1M PHY

  • sl_bt_gap_phy_coded (0x4): Coded PHY, 125k (S=8) or 500k (S=2)

uint8_t

secondary_phy

The PHY on which advertising packets are transmitted on the secondary advertising channel Values:

  • sl_bt_gap_phy_1m (0x1): 1M PHY

  • sl_bt_gap_phy_2m (0x2): 2M PHY

  • sl_bt_gap_phy_coded (0x4): Coded PHY, 125k (S=8) or 500k (S=2)

int8_t

tx_power

TX power value in the received packet header. Units: dBm

  • Valid value range: -127 to 126

  • Value 127: information unavailable

uint16_t

periodic_interval

The periodic advertising interval. Value 0 indicates no periodic advertising. Otherwise,

  • Range: 0x06 to 0xFFFF

  • Unit: 1.25 ms

  • Time range: 7.5 ms to 81.92 s

uint8_t

data_completeness

The data completeness status. Values:

  • sl_bt_scanner_data_status_complete (0x0): All data of the advertisement has been reported.

  • sl_bt_scanner_data_status_incomplete_more (0x1): Data of the advertisement is incomplete in this event, and more data will come in new events.

  • sl_bt_scanner_data_status_incomplete_nomore (0x2): Data of the advertisement is incomplete in this event, but no more data will come, i.e., the data of the advertisement is truncated.

uint8_t

counter

The monotonically increasing counter as the sequence number of the event. This counter is specific to sl_bt_evt_scanner_extended_advertisement_report_id. It can be used to detect if one more sl_bt_evt_scanner_extended_advertisement_report events were dropped due to temporarily out of resources or other reasons. Ignore this field if event loss is not a concern.

uint8array

data

Advertising or scan response data