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

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