S122 SoftDevice v8.1.1
Data Fields
ble_gap_evt_adv_report_t Struct Reference

Event structure for BLE_GAP_EVT_ADV_REPORT. More...

#include <ble_gap.h>

Data Fields

ble_gap_adv_report_type_t type
 
ble_gap_addr_t peer_addr
 
ble_gap_addr_t direct_addr
 
uint8_t primary_phy
 
uint8_t secondary_phy
 
int8_t tx_power
 
int8_t rssi
 
uint8_t ch_index
 
uint8_t set_id
 
uint16_t data_id:12
 
ble_data_t data
 
ble_gap_aux_pointer_t aux_pointer
 

Detailed Description

Event structure for BLE_GAP_EVT_ADV_REPORT.

Field Documentation

ble_gap_aux_pointer_t ble_gap_evt_adv_report_t::aux_pointer
           This field is only used with extended advertisement packets, not supported

by this SoftDevice.

uint8_t ble_gap_evt_adv_report_t::ch_index

Channel Index on which the last advertising packet is received (0-39).

ble_data_t ble_gap_evt_adv_report_t::data
                  Received advertising or scan response data,

the data buffer provided in sd_ble_gap_scan_start is now released.

uint16_t ble_gap_evt_adv_report_t::data_id
         The advertising data ID of the received advertising data. Data ID

is not present if ble_gap_evt_adv_report_t::set_id is set to BLE_GAP_ADV_REPORT_SET_ID_NOT_AVAILABLE.

ble_gap_addr_t ble_gap_evt_adv_report_t::direct_addr
           Contains the target address of the advertising event if

ble_gap_adv_report_type_t::directed is set to 1. If the SoftDevice was able to resolve the address, ble_gap_addr_t::addr_id_peer is set to 1 and the direct_addr contains the local identity address. If the target address of the advertising event is BLE_GAP_ADDR_TYPE_RANDOM_PRIVATE_RESOLVABLE, and the SoftDevice was unable to resolve it, the application may try to resolve this address to find out if the advertising event was directed to us.

ble_gap_addr_t ble_gap_evt_adv_report_t::peer_addr
             Bluetooth address of the peer device. If the peer_addr is resolved:

ble_gap_addr_t::addr_id_peer is set to 1 and the address is the peer's identity address.

uint8_t ble_gap_evt_adv_report_t::primary_phy
           Indicates the PHY on which the primary advertising packet was received.

See GAP PHYs.

int8_t ble_gap_evt_adv_report_t::rssi
                  Received Signal Strength Indication in dBm of the last packet received.
Note
ERRATA-153 and ERRATA-225 require the rssi sample to be compensated based on a temperature measurement.
uint8_t ble_gap_evt_adv_report_t::secondary_phy
         Indicates the PHY on which the secondary advertising packet was received.

See GAP PHYs. This field is set to BLE_GAP_PHY_NOT_SET if no packets were received on a secondary advertising channel.

uint8_t ble_gap_evt_adv_report_t::set_id
                Set ID of the received advertising data. Set ID is not present

if set to BLE_GAP_ADV_REPORT_SET_ID_NOT_AVAILABLE.

int8_t ble_gap_evt_adv_report_t::tx_power
              This field is only used with extended advertising packets, not supported

by this SoftDevice.

ble_gap_adv_report_type_t ble_gap_evt_adv_report_t::type

Advertising report type. See ble_gap_adv_report_type_t.


Documentation feedback | Developer Zone | Subscribe | Updated