S122 SoftDevice v8.1.1
Data Fields
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.

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_CHANGEDNew 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_HANDLEInvalid 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.

Documentation feedback | Developer Zone | Subscribe | Updated