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

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

See GAP PHYs . This field is to 0 if no packets where 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 .

Data Fields

Detailed Description

Field Documentation