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