sd_ble_gap_rssi_start()

uint32_t sd_ble_gap_rssi_start	(	uint16_t	conn_handle,
		uint8_t	threshold_dbm,
		uint8_t	skip_count )

#include <ble_gap.h>

Start reporting the received signal strength to the application.

   A new event is reported whenever the RSSI value changes, until @ref sd_ble_gap_rssi_stop is called.

Events generated

BLE_GAP_EVT_RSSI_CHANGED

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

Relevant Message Sequence Charts

RSSI get sample

RSSI for connections with event filter

Parameters

[in]	conn_handle	Connection handle.
[in]	threshold_dbm	Minimum change in dBm before triggering the BLE_GAP_EVT_RSSI_CHANGED event. Events are disabled if threshold_dbm equals BLE_GAP_RSSI_THRESHOLD_INVALID.
[in]	skip_count	Number of RSSI samples with a change of threshold_dbm or more before sending a new BLE_GAP_EVT_RSSI_CHANGED event.

Return values

NRF_SUCCESS	Successfully activated RSSI reporting.
NRF_ERROR_INVALID_STATE	RSSI reporting is already ongoing.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.