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.

Note

If ble_gap_adv_report_type_t::status is set to BLE_GAP_ADV_DATA_STATUS_INCOMPLETE_MORE_DATA, not all fields in the advertising report may be available.

When ble_gap_adv_report_type_t::status is not set to BLE_GAP_ADV_DATA_STATUS_INCOMPLETE_MORE_DATA, scanning will be paused. To continue scanning, call sd_ble_gap_scan_start.

Field Documentation

ble_gap_aux_pointer_t ble_gap_evt_adv_report_t::aux_pointer

           The offset and PHY of the next advertising packet in this extended advertising

event.

Note

This field is only set if ble_gap_adv_report_type_t::status is set to BLE_GAP_ADV_DATA_STATUS_INCOMPLETE_MORE_DATA.

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

ble_gap_adv_report_type_t::status is not set to BLE_GAP_ADV_DATA_STATUS_INCOMPLETE_MORE_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 requires 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

              TX Power reported by the advertiser in the last packet header received.

This field is set to BLE_GAP_POWER_LEVEL_INVALID if the last received packet did not contain the Tx Power field.

Note

TX Power is only included in extended advertising packets.

ble_gap_adv_report_type_t ble_gap_evt_adv_report_t::type

Advertising report type. See ble_gap_adv_report_type_t.