WIFINETCONFIG
Set the connection parameters of Wi-Fi to which the Wi-Fi client can connect
Platform: |
PwrPak7, SMART7-I, SMART7-SI, SMART7-W |
PwrPak7M and PwrPak7Q variants do not support this command.
Use this command to specify Access Points (AP) to which the Client/Station will automatically connect when the receiver's Wi-Fi Client/Station functionality is enabled (refer to the WIFIMODE command for details regarding the Wi-Fi configuration modes).
If the Wi-Fi Client/Station is already connected to an access point (defined using this command), the connection remains in effect even when a more preferred access point comes into range (preferred as indicated by network_id).
If Wi-Fi ALIGN automation is enabled, the Client only connects to the Access Point specified in the WIFIALIGNAUTOMATION command.
The term passkey and password are the same.
Message ID: 2213
Abbreviated ASCII Syntax:
WIFINETCONFIG network_id switch [ssid [passkey [address_mode [IP_address ]netmask [gateway [dns]]]]]]]
Factory Default:
WIFINETCONFIG 1 DISABLE
WIFINETCONFIG 2 DISABLE
WIFINETCONFIG 3 DISABLE
WIFINETCONFIG 4 DISABLE
Example:
WIFINETCONFIG 1 ENABLE SomeSSID 12345678
WIFINETCONFIG 2 ENABLE AnotherSSID 1A2b3C4d STATIC 192.168.19.1
Field |
Field Type |
ASCII Value |
Binary Value |
Description |
Format |
Binary Bytes |
Binary Offset |
---|---|---|---|---|---|---|---|
1 |
Command header |
- |
- |
WIFINETCONFIG header This field contains the command name for abbreviated ASCII or the message header for ASCII (see page 1) or Binary (see page 1). |
- |
H |
0 |
2 |
network_id |
1, 2, 3, 4 |
The Network identifier value is used to prioritize network connections when more than one network is in range of the client. The access point with the lowest network_id is chosen. |
Ulong |
4 |
H |
|
3 |
switch |
DISABLE |
0 |
When set to Disable, the client will not connect to an access point with this SSID. |
Enum |
4 |
H+4 |
ENABLE |
1 |
When set to Enable, the client connects to an access point with this SSID if there are no other APs with a lower network_id in range. |
|||||
4 |
ssid |
Null-terminated ASCII string |
Access Points with non-ASCII SSIDs are not supported. Required if switch is set to ENABLE. |
String [33] |
Variable |
|
|
5 |
passkey |
Null-terminated ASCII string, 8 to 64 characters |
Passkey required to connect to access point identified by “ssid” parameter.(default = “”) |
String [65] |
Variable |
|
|
6 |
address_mode |
DHCP |
1 |
Use dynamic IP address (default = DHCP) |
Enum |
4 |
|
STATIC |
2 |
Use static IP address |
|||||
7 |
ip_address |
ddd.ddd.ddd.ddd |
IP Address - decimal dot notation The IP address is mandatory when the address mode is STATIC. |
String [16] |
Variable |
|
|
8 |
netmask |
ddd.ddd.ddd.ddd |
Netmask – decimal dot notation (default = 255.255.255.0) |
String [16] |
Variable |
|
|
9 |
gateway |
ddd.ddd.ddd.ddd |
Gateway – decimal dot notation (default = 0.0.0.0) |
String [16] |
Variable |
|
|
10 |
dns |
ddd.ddd.ddd.ddd |
DNS server – decimal dot notation (default = 0.0.0.0) |
String [16] |
Variable |
|