cnet's Application Programming Interface
- NAME
- CNET_wlan_arrival - determine the characteristics of a recently arrived WLAN signal
- SYNOPSIS
#include <cnet.h>
int CNET_wlan_arrival(int link, double *rx_signal_dBm, double *rx_angle);
- DESCRIPTION
-
CNET_wlan_arrival provides the characteristics of the
signal that has recently arrived on the indicated LT_WLAN link.
The received signal strength, rx_signal_dBm,
is measured in decibel-metres (dBm),
and the angle of arrival, rx_angle,
is in radians (0 = 3 o'clock, pi/2 = 12 o'clock, -pi/2 = 6 o'clock).
If NULL is presented for either signal attribute,
then that attribute is not reported.
- RETURN VALUE
-
The value 0 is returned on success.
On failure, the value -1 is returned,
and the global variable cnet_errno is set to one of the
following values to describe the error:
- ER_BADLINK
- The value of link is not a valid link number.
- ER_NOTSUPPORTED
- The indicated link is not of type LT_WLAN.
- SEE ALSO
-
CNET_get_wlaninfo and
CNET_set_wlaninfo.
|
cnet v3.3.4, written by Chris.McDonald@uwa.edu.au
Last modified: Tue Mar 1 7:43AM 2016