GETSCAN

Description

The GETSCAN command can be used to pull one record off the result set generated by a previous WLAN SCAN. GETSCAN needs one argument that must be a string variable which should receive the record.

GETSCAN must be called repeatedly to read out all records. After the last record has been read, GETSCAN automatically frees the result set.

After a successful GETSCAN call, the string variable contains space-separated information in the following order:

Position 0...11
These characters are the BSSID

Position 13...14
This is a two-digits decimal number that is the RSSI

Position 16
Can be either B or I. B stands for BSS, which is a net that normally needs an access point. I stands for IBSS, which means an ad-hoc network.

Position 18
Can be either 0,1,2 or 3. 0 means no encryption, 1 stands for WEP encryption, 2 is WPA and 3 is WPA2 encryption.

Position 20...53
These characters contain the SSID which is a variable-length string from up to 32 characters. If the station doesn't broadcasts its SSID, the string [no name] is inserted.

Example

let a$ =""
getscan a$
print a$

This prints a string, e.g:

000c419d2f64 43 B 1 Toshiba_AP

which contains a full scan record.

Remarks

This command is new since Version 3.49.

There's no chance to read a record twice because GETSCAN advances its internal read pointer after each call and throws the result set away when the last record was fetched. LASTERR becomes ERR_NO_DATA (8) if GETSCAN is called and there's no result set available.

See also

SCAN : Search for WLAN networks

SCANNED : Returns number of found WLAN networks

GETSCAN : Read results from scan command

STATUS(-4]) : Returns status of WLAN connection