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