Technical information

Chapter 2: AT+i Commands Reference
May 31, 2008 AT+i Commands Reference Manual 2-165
+iWSIn - Wireless LAN Service Set Identifier Array
Syntax: AT+iWSI<n>=<ssid>
Sets the destination Wireless LAN Service Set Identifier (SSID)
string into position n in the array. This array defines the order in
which W24 attempts to connect to an AP or ad-hoc network.
Parameters:
n=0-9 n=0 is equivalent to the WLSI parameter and defines the default
SSID. The default SSID (WSI0 or WLSI) determines the type of
scanning that W24 performs. If the default SSID refers to an AP,
all SSIDs on the list must be configured for APs as well. If the
default SSID refers to an ad-hoc network (starts with the (!)
character), all SSIDs on the list must be configured for ad-hoc
networks as well (start with the (!) character).
The location of an SSID within the list defines its priority, where
the first SSID has the top priority. The SSIDs must be configured
consecutively. For example, if WSI0 and WSI2 are set but WSI1
is not, W24 ignores WSI2.
If, for example, W24 is connected to an AP having an SSID value
defined by WSI3, and that SSID is set to a different value using
the AT+iWSI3=new SSID command, the change will take effect
immediately and W24 will attempt to associate with an AP
having the new SSID. If, on the other hand, W24 is not currently
connected to an AP with SSID defined by WSI3 and the value of
WSI3 is changed, the change will take effect only upon the next
connection attempt.
<ssid>=<ID> ID will be used as the destination SSID. ID must be configured in
the AP for W24 to successfully communicate with that AP
Command Options: The options below apply to WSI0 only.
ssid=" Empty. No SSID defined. W24 will communicate with the
strongest AP in its vicinity.
ssid=* Prevents W24 from automatically attempting to connect to an AP
or ad-hoc network immediately after power-up. If the ssid
parameter value is changed to (*) while W24 is already connected
to an AP, the current connection will not be affected.
ssid=! Optional flag indicating ad-hoc mode. Upon power-up, W24 will
continuously search for existing ad-hoc networks in its vicinity
and join the one having the strongest signal.
Default: Empty. No SSID defined.
Result Code:
I/OK If n is a legal value.
I/ERROR Otherwise.
AT+i WS In~ssid Temporarily sets the nth position in the array to ssid.
AT +i W SI n? Reports the current SSID value in position n.
AT+i WS In=? Returns the message 'String'. The reply is followed by I/OK.