bt_rdev_get_rssi()

Retrieve the received signal strength indicator (RSSI) of the remote Bluetooth-enabled device.

Synopsis:

#include <btapi/btdevice.h>

int bt_rdev_get_rssi(const bt_remote_device_t *remote_device, int *rssi)

Since:

BlackBerry 10.0.0

Arguments:

remote_device: A pointer to a remote device structure.

rssi: A pointer to a buffer where the RSSI value is to be written.

Library:

libbtapi (For the qcc command, use the -l btapi option to link against this library)

Description:

The RSSI value is only valid when the device was found by using the bt_disc_retrieve_devices() function with BT_DISCOVERY_CACHED as an argument.

The RSSI value for paired devices is always 0.

Returns:

0 is returned upon success, -1 with the errno set otherwise. Possible errno values include:

EINVAL: An invalid parameter was passed in.