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
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

Enum sl_bt_gap_phy_t. 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

Enum sl_bt_gap_phy_t. 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

Enum sl_bt_scanner_data_status_t. 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