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 |