Rabbit RabbitCore RCM4400W Product Manual - page 85
User’s Manual
77
WIFI_SCAN
Initiates a Wi-Fi scan. When the scan has been completed, the configured scan callback
function (see above) will be called. The callback function must have already been config-
ured before using this command. A Wi-Fi scan will interrupt the network connectivity
briefly since the scan must iterate through the channels on the wireless network.
WIFI_STATUSGET
When using this command, you must ensure there is enough space for the entire data
structure. Be sure the data pointer points to a buffer that is large enough to hold
sizeof(wifi_status)
.
This command returns status information into the user-supplied buffer (or data structure)
area. The
wifi_status
structure has the following definition.
typedef struct {
wln_state state;
uint8 ssid[WLN_SSID_SIZE];
int ssid_len;
int channel;
mac_addr bss_addr;
uint16 bss_caps;
uint8 wpa_info[WLN_WPAIE_SIZE];
uint32 authen;
uint32 encrypt;
int tx_rate;
int rx_rate;
int rx_signal;
int tx_power;
uint8 country_info[WLN_COUNTRY_STRLEN];
} wifi_status;
The structure elements have the following definitions.
state
= association state: one of
WLN_ST_xxx
(see below)
ssid
= current service set ID (SSID)
ssid_len
= service set ID length
channel
= current channel (1–13)
bss_addr
= BSS ID (access point MAC address)
bss_caps
reserved
wpa_info
reserved
authen
reserved
encrypt
reserved
tx_rate
= current transmit rate (in 100 kbps)
rx_rate
= last received rate (in 100 kbps)
rx_signal
= last received signal strength (0–107)
tx_power
reserved
country_info
reserved