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.