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\n#

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

  • SL_BT_INVALID_BONDING_HANDLE (0xff): No bonding

  • Other: Bonding handle

uint8_t

primary_phy

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

  • gap_1m_phy (0x1): 1M PHY

  • gap_coded_phy (0x4): Coded PHY

uint8_t

secondary_phy

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

  • gap_1m_phy (0x1): 1M PHY

  • gap_2m_phy (0x2): 2M PHY

  • gap_coded_phy (0x4): Coded PHY

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