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_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_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. Ignore this field if the report is for a legacy advertising PDU. 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)

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