Z-World RCM3000, User Manual

Page: 54 / 86

50 802.11b (Wi-Fi) Add-On Kits
WIFI_SCANRES
This command macro returns the scan result into a user-supplied structure. The structure is
defined in the Wi-Fi libraries as follows.
typedef struct {
unsigned int len;
unsigned int rid;
unsigned int rffu;
unsigned int reason;
_wifi_ScanEntry table[4];
}
_wifi_ScanResult;
len
is a value from 0–4 that indicates how many valid BSS (access points and ad-hoc sta-
tions) have been returned by the scan request.
rid
and
rffu
are used internally.
reason
is set to a non-zero value when the scan request has completed.
table
contains a list of all scanned access points and ad-hoc stations found within range.
The format of each entry in
table
is defined as a structure in the Wi-Fi libraries as follows.
typedef struct {
unsigned channel;
unsigned noiseLevel;
unsigned signalLevel;
char bssMAC[6];
unsigned interval;
unsigned capability;
char ssid[34];
unsigned ratesAvail[5];
unsigned rate;
}
_wifi_ScanEntry;
channel
is a value from 1-14 identifying the BSS channel from the scan probe response.
noiseLevel
is a value from 0x1B to 0x9A indicating the average noise level of the probe
response received during the scan.
signalLevel
is a value from 0x1B to 0x9A indicating the signal level at which the probe
response was received.
bssMAC
is the MAC address of the responding BSS access point or ad-hoc station.
interval
is the beacon interval from the probe response (in milliseconds).