ble_gap_qos_rssi_t Struct Reference

Quality of Service (QoS) reporting changes in RSSI. More...

#include <ble_gap.h>

Data Fields
uint16_t	conn_handle
uint8_t	threshold_dbm
uint8_t	skip_count

Detailed Description

Quality of Service (QoS) reporting changes in RSSI.

This can be used with sd_ble_gap_qos_start and sd_ble_gap_qos_stop to start and stop reporting of changes in RSSI.

Note

An RSSI change detected before the call but not yet received by the application may be reported after sd_ble_gap_qos_stop has been called.

Events generated

BLE_GAP_EVT_RSSI_CHANGED

New RSSI data available. How often the event is generated is dependent on the settings of ble_gap_qos_rssi_t::threshold_dbm and ble_gap_qos_rssi_t::skip_count input parameters.

Relevant Message Sequence Charts

RSSI get sample

RSSI for connections with event filter

Return values

BLE_ERROR_INVALID_CONN_HANDLE

Invalid connection handle supplied.

Field Documentation

uint16_t ble_gap_qos_rssi_t::conn_handle

Connection handle.

uint8_t ble_gap_qos_rssi_t::skip_count

                Number of RSSI samples with a change of threshold_dbm or more before sending

a new BLE_GAP_EVT_RSSI_CHANGED event. Ignored when used with sd_ble_gap_qos_stop.

uint8_t ble_gap_qos_rssi_t::threshold_dbm

             Minimum change in dBm before triggering the @ref BLE_GAP_EVT_RSSI_CHANGED event.

Events are disabled if threshold_dbm equals BLE_GAP_RSSI_THRESHOLD_INVALID. Ignored when used with sd_ble_gap_qos_stop.