sl_bt_evt_scanner_scan_reportScanner

Reports an advertising or scan response packet that is received by the device's radio while in scanning mode.

Data Structures

struct  sl_bt_evt_scanner_scan_report_s
 Data structure of the scan_report event.
 

Macros

#define sl_bt_evt_scanner_scan_report_id   0x010500a0
 Identifier of the scan_report event.
 

Detailed Description

Reports an advertising or scan response packet that is received by the device's radio while in scanning mode.


Data Structure Documentation

◆ sl_bt_evt_scanner_scan_report_s

struct sl_bt_evt_scanner_scan_report_s

Data structure of the scan_report event.

Data Fields
uint8_t packet_type

Bits 0..2 : advertising packet type

  • 000 : Connectable scannable undirected advertising
  • 001 : Connectable undirected advertising
  • 010 : Scannable undirected advertising
  • 011 : Non-connectable non-scannable undirected advertising
  • 100 : Scan Response. Note that this is received only if the device is in active scan mode.

Bits 3..4 : Reserved for future

Bits 5..6 : data completeness

  • 00: Complete
  • 01: Incomplete, more data to come in new events
  • 10: Incomplete, data truncated, no more to come

Bit 7 : legacy or extended advertising

  • 0: Legacy advertising PDUs used
  • 1: Extended advertising PDUs used
bd_addr address

Bluetooth address of the remote device

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

Enum sl_bt_gap_phy_type_t. The PHY on which advertising packets are transmitted on the primary advertising channel. Ignore this field if the report is for a legacy advertising PDU. Values:

  • sl_bt_gap_1m_phy (0x1): 1M PHY
  • sl_bt_gap_coded_phy (0x4): Coded PHY, 125k (S=8) or 500k (S=2)
uint8_t secondary_phy

Enum sl_bt_gap_phy_type_t. The PHY on which advertising packets are transmitted on the secondary advertising channel. Ignore this field if the report is for a legacy advertising PDU. Values:

  • sl_bt_gap_1m_phy (0x1): 1M PHY
  • sl_bt_gap_2m_phy (0x2): 2M PHY
  • sl_bt_gap_coded_phy (0x4): Coded PHY, 125k (S=8) or 500k (S=2)
uint8_t adv_sid

Advertising set identifier

int8_t tx_power

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

  • Valid value range: -127 to 126
  • Value 127: information unavailable
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

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

Advertising or scan response data