sd_ble_gap_rssi_get()

uint32_t sd_ble_gap_rssi_get	(	uint16_t	conn_handle,
		int8_t *	p_rssi,
		uint8_t *	p_ch_index )

#include <ble_gap.h>

Get the received signal strength for the last connection event.

   @ref sd_ble_gap_rssi_start must be called to start reporting RSSI before using this function. @ref NRF_ERROR_NOT_FOUND
   will be returned until RSSI was sampled for the first time after calling @ref sd_ble_gap_rssi_start.

Relevant Message Sequence Charts

RSSI get sample

Parameters

[in]	conn_handle	Connection handle.
[out]	p_rssi	Pointer to the location where the RSSI measurement shall be stored.
[out]	p_ch_index	Pointer to the location where Channel Index for the RSSI measurement shall be stored.

Return values

NRF_SUCCESS	Successfully read the RSSI.
NRF_ERROR_NOT_FOUND	No sample is available.
NRF_ERROR_INVALID_ADDR	Invalid pointer supplied.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied.
NRF_ERROR_INVALID_STATE	RSSI reporting is not ongoing.