This document provides programmers with all commands and explanations about WizFi310 control. Basically programmers can control WizFi310 with commands set, known as AT command – the character string format. In this document, we describe what AT commands are used, how each command operates and how programmers have to handle those commands to get the expected response.
For WizFi250 fans, the WizFi310 comes with compatible AT Commands
This section provides a list of WizFi310 AT commands and their effects. Users can input commands and parameters through UART line. Every command starts with the characters “AT”. Any other initial character will cause an error in return. Commands and parameters are all ASCII characters, e.g. When you input 'AT+MMSG=1', you can input ASCII characters 'A', 'T', '+', 'M', 'M', 'S', 'G', '=', '1' and 'Enter Key' which should be CR(0x0d), but neither CRLF(0x0d, 0x0a) nor LF(0x0a).
Some parameters are mandatory and the others are optional. (refer to Command Tables) Parameters must be entered in an order of format column given by the command tables. Even though an optional parameter is not used, the comma delimiters must still be included in the command. In most cases, valid commands return the characters [OK]. Invalid inputs return [ERROR]. The possible responses sent by WizFi310 to the user side are described at Responses. Below is a possible example which users can input. As you can see, WizFi310 return “\r\n” back instead of “\r”, which means user (host system) always handle '\r\n' as a only delimiter.
Input by User | AT\r (0x61 0x74 0x0d) |
---|---|
Output from WizFi310 | AT\r\n[OK]\r\n (0x61 0x74 0x0d 0x0a 0x5b 0x4f 0x4b 0x5d 0x0d 0x0a) (* “AT\r\n” is Echo back of user input) |
Responses are listed below.
Response | Meaning |
---|---|
[OK] | Command Request Success |
[ERROR] | Command Request Fail |
[ERROR: INVALID INPUT] | Wrong command or parameter |
[ERROR: INVALID SCID] | Wrong Socket ID |
[ERROR: WiFi Status] | Wrong WiFi Status (Some commands work only with Wi-Fi Joined status) |
[ERROR: Mode Status] | Wrong Mode Status (Some commands do not work in Data mode) |
[CONNECT x] | TCP Connection established & Socket Open |
[DISCONNECT x] | TCP Connection closed & Socket Close |
[Link-Up Event] | WiFi Connection was established |
[Link-Down Event] | WiFi Connection was closed |
[Reset Event] | System reset occurred (not by user) |
Basic Commands | |
---|---|
AT | Terminal Check |
WiFi Commands | |
AT+WJOIN | WiFi Association |
AT+WLEAVE | WiFi Disassociation |
AT+WSCAN | WiFi Scan |
AT+WSET | WiFi SSID Configuration |
AT+WSET2 | WiFi SSID Configuration for special Chars |
AT+WSEC | WiFi Security Configuration |
AT+WNET | Network Configuration |
AT+WSTAT | Get Current WiFi Status |
AT+WWPS | WiFi WPS Connection |
AT+WADNS | Add DNS Server |
Management Commands | |
---|---|
AT+MPROF | Profile Management |
AT+MFDEF | Perform Factory Reset |
AT+MRESET | Perform System Reset |
AT+MMSG | Set Message Print Level |
AT+MMAC | Set MAC Address |
AT+MINFO | Get System Information |
AT+MECHO | Set Echo Mode |
AT+MHELP | Print Command Description and Usage |
AT+MMCUPS | MCU Power Save Enable/Disable |
AT+MWIFIPS | Wi-Fi Power Save Enable/Disable |
AT+USET | UART Configuration |
AT+MCUSTOM | Custom code |
AT+MAIRCMD | Air Command Configuration |
AT+MEVTMSG | Print [Listen x] as soon as it opens up a socket through TCP server. |
AT+MEVTFORM | Event Message Form |
AT+MUPGRADE | Firmware upgrade using serial |
Function Commands | |
---|---|
AT+FPING | PING Test |
AT+FDNS | DNS Query |
AT+FGPIO | GPIO Control |
AT+FGETADC | Read ADC value |
AT+FSOCK | SOCKET Extension Option |
AT+FOTA | Launch OTA Mode |
MQTT Commands | |
---|---|
AT+MQTTSET | MQTT Configuration |
AT+MQTTCON | MQTT Connect/Disconnect |
AT+MQTTSUB | MQTT Subscribe |
AT+MQTTPUB | MQTT Publish |
GMMP Commands | |
---|---|
AT+GMMPSET | GMMP Configuration, Connect/Disconnect |
AT+GMMPDATA | GMMP Data Send |
AT+GMMPOPT | GMMP Option Management |
Connecting ThingPlug Commands | |
---|---|
AT+SKTPCON | Connecting authorization, Connect/Disconnect |
AT+SKTPDEVICE | Device registration |
AT+SKTPCONTAINER | Container Create |
AT+SKTPSEND | Data sending to ThingPlug |
AT+SKTPCMD | Command registration to ThingPlug |
AT+SKTPRESULT | Response to ThingPlug Command |
Basic commands are listed below.
AT
Check if AT Command Terminal is working.
[OK]
Commands related to WiFi are listed below.
AT+WJOIN
In the STA mode, it joins with the BSS selected by AT+WSET(or AT+WSET2), AT+WSEC.
And in the AP mode, it starts to run as an Access Point.
[Link-Up Event] IP Addr : xxx.xxx.xxx.xxx Gateway : xxx.xxx.xxx.xxx [OK]
Already Associated : (Mode) [OK]
AT+WLEAVE
In the STA mode, it leaves current Access Point, but in the SoftAP mode, it stops to run as Access Point.
[Link-Down Event] [OK]
AT+WSCAN=<SSID>,<BSSID>,<Channel>
Return the scan results filtered by parameters.
<SSID>: SSID Filter (Optional)
Scan only the AP which has this SSID.
<BSSID>: BSSID Filter (Optional)
Scan only the AP which has this BSSID.
<Channel>: Channel Filter (Optional)
Scan only the AP in this Channel.
* When combining these filters, it works at the same time. For example, if you enter AT+WSCAN=TestAP,00:08:DC:11:22:33', it only scans the AP which has TestAP as SSID and 00:08:DC:11:22:33 as BSSID in all the channel.
Examples)
Index/SSID/BSSID/RSSI(-dBm)/MaxDataRate(Mbps)/Security/RadioBand(GHz)/Channel ... [OK]
AT+WSET=<WiFiMode>,<SSID>,<BSSID>,<Channel>
<WiFiMode>: WiFi Mode to set (Required)
This changes current WiFi mode.
Parameter | Meaning |
---|---|
0 | Set Wi-Fi mode as STA mode |
1 | Set Wi-Fi mode as AP mode |
<SSID>: Target/Own SSID (Required, Max: 32 Character)
Mode | Meaning |
---|---|
STA | The SSID of target AP |
AP | Its own SSID |
<BSSID>: Target BSSID (Optional, Form: xx:xx:xx:xx:xx:xx)
Mode | Meaning |
---|---|
STA | The BSSID of target AP |
AP | Not used. if any, it will be ignored |
<Channel>: Target/Own Channel (Optional)
Mode | Meaning |
---|---|
STA | In STA mode, the Channel of target AP |
AP | In AP mode, its own Channel to run (Default: 6) |
* There are 2 Wi-Fi modes in WizFi310, STA mode and SoftAP mode. When users execute AT+WJOIN command, it works as Wi-Fi mode previously selected by the user. It can be selected or checked by AT+WSET(or AT+WSET2) and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.
* AT+WSET(or AT+WSET2), AT+WSEC commands save its parameters into the profile automatically, so the user does not need to save the current profile.
Examples)
[OK]
AT+WSET=?
<WiFiMode>,<SSID>,<BSSID>,<Channel> [OK]
AT+WSET2=<WiFiMode>,<SSID>
<WiFiMode>: WiFi Mode to set (Required)
This changes current WiFi mode.
Parameter | Meaning |
---|---|
0 | Set Wi-Fi mode as STA mode |
1 | Set Wi-Fi mode as AP mode |
<SSID>: Target/Own SSID (Required, Max: 32 Character)
Mode | Meaning |
---|---|
STA | The SSID of target AP |
AP | Its own SSID to run |
* There are 2 Wi-Fi modes in WizFi310, STA mode and SoftAP mode. When users execute AT+WJOIN command, it works as Wi-Fi mode previously selected by the user. It can be selected or checked by AT+WSET and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.
* AT+WSET, AT+WSEC commands save its parameters into the profile automatically, so the user does not need to save the current profile.
Examples)
[OK]
AT+WSET2=?
<WiFiMode>,<SSID>,<BSSID>,<Length of SSID> [OK]
AT+WSEC=<WiFiMode>,<SecType>,<Key>
<WiFiMode>: Target WiFi mode to set (Required)
Parameter | Meaning |
---|---|
0 | Set Wi-Fi mode as STA mode |
1 | Set Wi-Fi mode as AP mode |
<SecType>: Security type (Optional)
Parameter | Meaning |
---|---|
OPEN | None |
WiFi Auto Security | |
WEP | WEP (* Not support at SoftAP mode) |
WPA | WPA1 - TKIP |
WPAAES | WPA1 - AES |
WPA2AES | WPA2 - AES |
WPA2TKIP | WPA2 - TKIP |
WPA2 | WPA2 - Mixed |
<Key>: Security key value
Method | Length |
---|---|
WEP | 5 or 13 (ASCII), 10 or 26 (HEX) |
WPA | 8 ~ 63 (ASCII), 128 (HEX) |
* There are 2 Wi-Fi modes in WizFi310, STA mode and SoftAP mode. When users execute AT+WJOIN command, it works as Wi-Fi mode previously selected by the user. It can be selected or checked by AT+WSET and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.
* AT+WSET, AT+WSEC commands save its parameters into the profile automatically, it works as Wi-Fi mode previously selected by the user.
* Minimum key length is 8 bytes in WiFi Auto Security.
In case of WEP mode and 5 bytes key, you should input the key with HEX type.
AT+WSEC=0,,12345(X)
AT+WSEC=0,,3132333435(O)
In case of OPEN mode, you should input the 8 bytes dummy string. Then WizFi310 will ignore the dummy key in OPEN mode.
AT+WSEC=0,,(X)
AT+WSEC=0,,12345678(O)
Examples)
[OK]
AT+WSEC=?
<WiFiMode>,<SecType>,<Key> [OK]
AT+WNET=<DHCP>,<IP>,<SN>,<GW>
<DHCP>: DHCP On/Off (Optional)
Parameter | Meaning |
---|---|
0 | DHCP Off, Static |
1 | DHCP On, DHCP Client |
Mode | Meaning |
STA | DHCP Client On/Off |
AP | Not used. if any, it will be ignored |
<IP>: IP Address (Optional)
<SN>: Subnet Mask (Optional)
<GW>: Gateway Address (Optional)
Mode | Meaning |
---|---|
STA | AP(Router) gateway address |
AP | Not used. if any, it will be ignored |
* When you turn DHCP On in STA Mode, <IP>,<SN>,<GW> are not needed. If you input them at this time, they will be stored in the memory. They can be used later when set as Static(DHCO Off) without inputting these parameters.
* In AP mode, DHCP Server will always run despite DHCP option,
and Gateway option will not be used, So both options will be ignored.
[OK]
AT+WNET=?
Note that <IP>,<SN>,<GW> address of response are not actual addresses, but addresses stored in the memory. So when DHCP is on, it usually different from actual addresses.
<DHCP>,<IP>,<SN>,<GW> [OK]
AT+WSTAT
IF/SSID/IP-Addr/Gateway/MAC/TxPower(dBm)/RSSI(-dBm) ... [OK]
AT+WWPS=<Mode>,<PinNum>
Join with an AP through WPS method
<Mode>: WPS Mode (Required)
Parameter | Meaning |
---|---|
0 | WPS_PBC_MODE |
1 | WPS_PIN_MODE |
<PinNum>: Pin Number (Pin Mode: Required, PBC Mode: N/A)
* The maximum pin number letter is 8.
Examples)
[OK]
AT+WADNS=<DNS Server1>,<DNS Server2>
<DNS Server 1>: DNS Server 1
<DNS Server 2>: DNS Server 2
Examples)
[OK]
Commands related to Network are listed below.
AT+SCON=<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>
Opens a socket and if it is a TCP Client, establishes TCP connection with remote peer device.
<OpenType>: Socket open type (Required)
Parameter | Meaning |
---|---|
O | open at Once |
S | register as a Service |
SO | open at Once & register as a Service |
* AT ONCE: Assigns a socket immediately and if the socket is a TCP Client, tries to connect peer socket.
* AS SERVICE: Registers its information to the profile. When WiFi Joined, socket open/connect will be performed automatically. If you want to use this after reset, It should be saved by using AT+MPROF=S
<SocketType>: Socket protocol to use (Required)
Parameter | Meaning |
---|---|
TSN | TCP Server Normal |
TCN | TCP Client Normal |
TCS | TCP Client Secured |
USN | UDP Server Normal |
UCN | UDP Client Normal |
* 'Secured' means TCP connection through SSL Encryption. It can be used in only TCP Client mode.
* Actually, there is no Server/Client concept in UDP protocol. This concept is used to decide peer address purposes. If a UDP Server receives any packet, its default peer address will be changed to the address of the packet, so if you send data after that, it goes to the changed address. But If you use UDP Client, its …default address stored by AT+SCON will never be changed.
<RemoteIP>: Remote IP address
Protocol | Parameter Application |
---|---|
TCP Server | N/A |
TCP Client | Required |
UDP Server | Optional |
UDP Client | Required |
<RemotePort>: Remote port number
Same condition with upper, RemoteIP
<LocalPort>: Local port number (Required)
Local port number should not be duplicated with others which have opened before. When the value is 0, in case the socket was a TCP/UDP Client, a random port number will be selected. If it was a TCP/UDP Server, it will return an error message.
<DataMode>: Mode to run (Optional, default: 0)
Parameter | Meaning |
---|---|
0 | Open as Command mode |
1 | Open as Data mode |
* About Command/Data mode, refer to Command mode & Data mode
Examples)
[OK]
AT+SCON=?
Use for check if previous input parameters are correct.
<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode> [OK]
AT+SMGMT=<SocketID>
Closes the selected socket and releases all its resources.
<SocketID>: Socket ID (Required)
Parameter | Meaning |
---|---|
0 ~ 7 | The socket ID to close |
ALL | All the opened sockets |
* Opened socket information can be found by using '?' option.
Examples)
[OK]
AT+SMGMT=?
This prints all of the opened sockets statuses.
Number of Sockets : x (SCID/Socket/Mode/Remote/Local/DataMode) <SocketID>,<SocketAddr>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode> ... [OK]
AT+SSEND=<SocketID>,<RemoteIP>,<RemotePort>,<SendSize>,<Timeout>
This is used only in command mode, not in data mode. It is not required in data mode as you can input directly, but if you exit from data mode to command mode by inputting '+++', you can send data through this command.
<SocketID>: Socket ID (Required)
<RemoteIP>: Remote IP Address
Protocol | Parameter Application |
---|---|
TCP Server | N/A |
TCP Client | N/A |
UDP Server | Optional |
UDP Client | Optional |
* In case of TCP Server waiting for a client on listen state or in case of undecided remote address of the UDP Server (meaning its remote address is 0.0.0.0:0), this command will fail.
<RemotePort>: Remote Port Number
Same condition with upper, RemoteIP
<SendSize>: Data size to send (Required)
Valid Range: 1 ~ 100,000,000 Byte
<Timeout >: Set timeout value (milliseconds unit) (Optional)
If the transmission takes time more time than timeout value, it will fail and return error response. Default value is 10s + (100s / 1 MB)
Examples)
[OK]
AT+SDATA
In data mode, it can be changed to command mode temporally by using serial '+++' input. After that, to return to the data mode, you can use this command. If it is not data mode, [ERROR] response will be returned.
[OK]
AT+SFORM=<Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2>
Define the header of received data which is used at command mode. For example, default receiving format look like below.
“{0,192.168.0.216,59834,5}hello(0xd)(0xa)”
This means ASCII code “hello” was received from 192.168.0.216:59834 by socket ID 0, and its length was 5. You can change this format to suit your system through this command.
Factory default option is “111111111,7B,2C,7D,0D,0A”
<Format>: Decide each of header items to use. (Required)
If you want to set it to active, input '1'.
If not, input '0'.
Order | Meaning |
---|---|
0 | Header Start |
1 | Socket ID |
2 | Delimiter |
3 | Remote IP Address |
4 | Remote Port Number |
5 | Data Length |
6 | Header End |
7 | Data End 1/2 |
8 | Data End 2/2 |
* At default format, '{' '}' is header start and end, ',' is delimiter, 0xd,0xa is data end 1,2.
< Start>: Header Start Character (Required)
< Delim>: Delimiter Character (Required)
< End>: Header End Character (Required)
< Cls1>: Data End Character 1/2 (Required)
< Cls2>: Data End Character 2/2 (Required)
Examples)
[OK]
AT+SFORM=?
<Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2> [OK]
AT+SOPT=<Option>,<SocketID>,<Socket Level>,<Option Name>,<Option Value>
<Option>: Option to configure (Required)
Option | Value |
---|---|
1 | Set socket option |
| |
<SocketID>: Socket ID (Required)
<Socket Level>: Socket Level (Required)
Socket Level | Value |
---|---|
4095 | SOL_SOCKET |
0 | IPPROTO_IP |
6 | IPPROTO_TCP |
17 | IPPROTO_UDP |
136 | IPPROTO_UDPLITE |
<Option Name> : Option name for socket level options for level SOL_SOCKET
Option Name | Value |
---|---|
4 | SO_REUSEADDR |
8 | SO_KEEPALIVE |
options for level IPPROTO_IP
Option Name | Value |
---|---|
1 | IP_TOS |
2 | IP_TTL |
options for level IPPROTO_TCP
Option Name | Value |
---|---|
1 | TCP_NODELAY |
2 | TCP_KEEPALIVE |
3 | TCP_KEEPIDLE |
4 | TCP_KEEPINTVL |
5 | TCP_KEEPCNT |
Examples)
[OK]
AT+SOPT1=<Option>,<Value>
<Option>: Option to configure (Required) <Value>: Value of the option (Required)
Option | Value |
---|---|
10 | Escape sequence(+++) Timer(millisecond, default 1000, 1~10000) |
Examples)
[OK]
Commands related to system management are listed below.
AT+MPROF=<Action>
You can save/load the environmental information in the RAM to/from flash ROM, or check the setting values in both of them through this command.
(* AT+WSET, AT+WSEC are immediately stored in the Flash ROM)
<Action>: The action to perform (Required)
Parameter | Meaning |
---|---|
VD | Get saved profile |
VG | Get current profile |
L | Load profile |
S | Save profile |
* There is no '?' option at this command.
Examples)
[OK]
+WSET=... +WSEC=... +WNET=... +WREG=... +SCON=... +SFORM=... +MMSG=... +MMAC=... +USET=... +MECHO=... [OK]
AT+MFDEF=FR
Factory Reset means that all of environmental variables return back to the default state. (You can check that by using AT+MPROF command)
[OK]
AT+MRESET
System will reboot after this command.
[OK]
AT+MMSG=<Level>
<Level>: Message Print Level (Required)
Parameter | Meaning |
---|---|
1 | Not Print Responses |
2 | Print Responses, Events (Default) |
3 | Print Responses, Events, Debug Logs |
Examples)
[OK]
AT+MMSG=?
<Level> [OK]
AT+MMAC=<MAC>
<MAC>: MAC Address (separated by colon) (Required)
Examples)
[OK]
AT+MMAC=?
<MAC> [OK]
AT+MINFO
FW version / HW version <FWver> / <HWver> [OK]
AT+MECHO=<Action>
If you turn the echo mode off, you cannot see the characters that you inputted returning. It is easy to use to turn off when Host MCU handles AT Command control.
<Action>: Echo Mode (Required)
Parameter | Meaning |
---|---|
0 | Echo Off |
1 | Echo On (Default) |
Examples)
[OK]
AT+MECHO=?
<Mode> [OK]
AT+MHELP
This is command usage guide for user convenience.
... [OK]
AT+MWIFIPS=<Action>,<Delay>
Wi-Fi power save mode can be selected through this command.
<Action> : Wi-Fi Power Save Mode (Required)
Parameter | Meaning |
---|---|
0 | Wi-Fi Power Save Mode Disable |
1 | Wi-Fi Power Save Mode Enable |
2 | Enables power save mode while attempting to maximize throughput |
* To using Wi-Fi Power Save Mode, WizFi310 has to connect to Access Point. And WizFi310 can only use this mode in station mode.
<Delay > : Return to Sleep Delay
If it is set with a bigger value, the performance will improve but the power consumption will rise.
Action | Application |
---|---|
0 | N/A |
1 | N/A |
2 | Required |
* This parameter is used only to set 2 of <Action> parameter.
* It must be set to a multiple of 10. When set to 0, the timeout period default to 2 beacon intervals (approximately 204ms).
* It can be set to 0 ~ 90
[OK]
AT+MWIFIPS=?
<Status > : Current Wi-Fi Power Save Status
Return value | Meaning |
---|---|
0 | Wi-Fi Power Save Mode Disable |
1 | Wi-Fi Power Save Mode Enable |
[OK]
AT+USET=<Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon>
UART parameter can be set through this command. Factory default parameter is “115200,N,8,1,N ”.
<Baudrate>: Set the Baud-Rate. (Required)
Parameter | Meaning |
---|---|
300 | 300 bps |
600 | 600 bps |
1200 | 1200 bps |
2400 | 2400 bps |
4800 | 4800 bps |
9600 | 9600 bps |
14400 | 14400 bps |
19200 | 19200 bps |
38400 | 38400 bps |
57600 | 57600 bps |
115200 | 115200 bps |
230400 | 230400 bps |
460800 | 460800 bps |
921600 | 921600 bps |
1843200 | 1843200 bps |
<Parity>: Set the Parity-Bit type. (Required)
Parameter | Meaning |
---|---|
N | None |
O | Odd |
E | Even |
<WordLen>: Set the Word-Length. (Required)
Parameter | Meaning |
---|---|
7 | 7 bits |
8 | 8 bits |
<StopBit>: Set the Stop-Bit. (Required)
Parameter | Meaning |
---|---|
1 | 1 bits |
2 | 2 bits |
<FlowCon>: Set the Flow-Control method. (Required)
Parameter | Meaning |
---|---|
N | None |
HW | Hardware Flow Control |
Examples)
[OK]
AT+USET=?
<Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon> [OK]
AT+MCUSTOM=<custom code>
Examples)
Default custom code is WIZNET
[OK]
AT+MCUSTOM=?
WIZNET [OK]
AT+MAIRCMD=<OpenType>,<SocketType>,<LocalPort>,<Option>
<OpenType>: Air Command mode type (Required)
Parameter | Meaning |
---|---|
O | open at Once |
S | register as a Service |
* AT ONCE: Assigns a Air-Command-socket immediately.
* AS SERVICE: Registers its information to the profile. When WiFi Joined, Air-Command-socket open will be performed automatically. If you want to use this after reset, It should be saved by using AT+MPROF=S
<SocketType>: Air-Command-Socket protocol to use (Required)
Parameter | Meaning |
---|---|
T | TCP Server Normal |
U | UDP Server Normal |
<LocalPort>: Local port number (Required)
Local port number should not be duplicated with others which have opened before. When the value is 0, in case the socket was a TCP/UDP Client, a random port number will be selected. If it was a TCP/UDP Server, it will return an error message.
<Option>: Reserved (Required)
Examples)
<OpenType>,<SocketType>,<LocalPort>,<Option> [OK]
AT+MEVTMSG=<Status>
It is able to print TCP Server Status with [Listen x].(x:socket number).
A user can decide whether WizFi310 will print out Listen message or not in initialization mode on TCP server.
This command is made for mbed library.
Uses 1 Parameter and set status of socket as 0,1 for each relevant below table.
<Status>: Printing status (Required)
Parameter | Meaning |
---|---|
0 | No display [Listen x] message |
1 | Display [Listen x] message |
Examples)
[OK]
AT+MEVTFORM=<format>
It is able to control format and printing status of WizFi310 event messages.
Uses 10 Parameters and set event message as 0,1,2 for each relevant one
<Format>: Event Message Format (Required)
0: No display
1: Full Message
2: Short Message
AT+MEVTFORM=abcdefghijkl
0(No display) | 1(Full Message,Default) | 2(Short Message) | |
---|---|---|---|
a | WizFi310 Version 1.0.0.6 (WIZnet Co.Ltd)\r\n | \r\n[0]\r\n | |
b | \r\n[CONNECT %x]\r\n | \r\n[1]\r\n | |
c | \r\n[DISCONNECT %x]\r\n | \r\n[2]\r\n | |
d | \r\n[Link-Up Event]\r\n IP Addr : …\r\n Gateway : …\r\n | \r\n[3]\r\n | |
e | \r\n[Link-Down Event]\r\n | \r\n[4]\r\n | |
f | \r\n[Reset Event]\r\n | \r\n[5]\r\n | |
g | \r\n[TCP Send Error]\r\n | \r\n[6]\r\n | |
h | \r\n[P2P Fail Event]\r\n | \r\n[7]\r\n | |
i | \r\n[LISTEN %x]\r\n | \r\n[8]\r\n | |
j | \r\n[MQTT CONNECT]\r\n | \r\n[9]\r\n | |
k | \r\n[MQTT DISCONNECT]\r\n | \r\n[a]\r\n |
Examples)
[OK]
AT+MEVTFORM=?
<Format> [OK]
AT+MUPGRADE
After using this command, WizFi310 will wait UART signal for XMODEM protocol. After this command, You have to send binary file which you want to upload using XMODEM protocol.
If it is done successfully, WizFi310 will display “[OK]” message and then restart.
Examples)
[OK]
Commands related to additional functions are listed below.
AT+FPING=<RepeatCnt>,<TargetIP>
<RepeatCnt>: Repeat Count (Required)
Valid Range: 1 ~ 50 (unit:number of times)
<TargetIP>: Target IP Address (Required)
Examples)
Ping Reply : xxx ms ... [OK]
AT+FDNS=<HostName>,<Timeout>
<HostName>: The domain name to search (Required)
<Timeout>: Maximum Delay (milliseconds unit) (Required)
Valid Range: 1,000 ~ 1,000,000 (unit:ms)(Recommend: 1000)
Examples)
xxx.xxx.xxx.xxx [OK]
AT+FGPIO=<gpio_number>,<action:0>,<config_value> AT+FGPIO=<gpio_number>,<action:1>,<config_value> AT+FGPIO=<gpio_number>,<action:2>,<gpio_value> AT+FGPIO=<gpio_number>,<action:3>,<gpio_value>
GPIO can be set through this command.
<gpio_number>: Available GPIO number (Required)
Return value | Meaning |
---|---|
3 | GPIOB 3 |
4 | GPIOC 4 |
<action>: The action to perform (Required)
Return value | Meaning |
---|---|
0 | GPIO Initialize as a Input mode |
1 | GPIO Initialize as a Output mode |
2 | Get GPIO value of <gpio_number> |
3 | Set GPIO value of <gpio_number> |
<config_value>: Current GPIO Configuration Value (It can be used when action is 0, 1)
Return value | Meaning |
---|---|
0 | PULL_NONE (Not use pull-up & pull-down resistor) |
1 | PULL_UP (Input with an internal pull-up resistor) |
2 | PULL_DOWN (Input with an internal pull-down resistor) |
3 | OPEN_DRAIN (Output open drain) |
<gpio_value>: Current GPIO Value (It can be used when action is 2, 3)
Return value | Meaning |
---|---|
0 | Low |
1 | High |
Examples)
If <action> is 2
<gpio_value> [OK] ex) AT+FGPIO=3,2,0 0 [OK]
If <action> is 0, 1, 3
[OK]
AT+FGPIO=?
Examples)
<gpio_num_1>,<gpio_num_2> [OK] ex) 3,4 [OK]
AT+FGETADC=?
Examples)
xxxx [OK] ex) 1697 [OK]
AT+FSOCK=<Option>,<Value>
When there is no socket connected, it tries to reconnect the server using this option.
6,8 options must be set as service mode(AT+SCON=S) for Auto Reconnection.
Profile(AT+MPROF=S) has to be saved after AT+FSOCK
This is for extended options of Socket. It will be added continuously.
<Option>: Extended options of Socket (Required)
Parameter | Meaning |
---|---|
1 | TCP Send error timeout (value : 2000~20000ms) |
6 | Recreates Socket then attempts Auto-Reconnection after <Value> seconds (value: 10~1000) |
8 | Automatically resets WizFi310 module. when there is no socket connected (value: 5~1000) |
<Value> : Value of extended option (Required)
Examples)
[OK]
AT+FSOCK=?
<Extened option 1><2><3><4><5><6><7><8> [OK] ex) 5000,0,0,0,0,10,0,30
AT+FOTA=<Server IP>,<Server Port>
User can update firmware in OTA mode which can be entered by this command. Refer to Wi-Fi OTA
OTA Server should run some protocol. that included in OTA tool.
<Server IP>: Firmware Server IP
<Server Port> : Firmware Server Port
[OK]
MQTT (Message Queuing Telemetry Transport) is a light weight messaging protocol for use on top of the TCP/IP protocol. It is designed for connections with remote locations where a “small code footprint” is required or the network bandwidth is limited.
It is a communication protocol which almost can link all networked objects with the external, and it is used as a sensor.
Wikipedia
AT+MQTTSET=<UserName>,<Password>,<ClientID>,<AliveTime>
<UserName>: The User Name used in the broker authentication (Required, Max: 50 Character)
<Password>: The Password used in the broker authentication (Required, Max: 50 Character)
<ClientID>: The Client ID connected to the broker (Required, Max: 50 Character)
<AliveTime>: The keep-alive time setting with the broker (Required, 30S ~ 300S)
* this command needs to be invoked before the command of “AT+MQTTCON” connecting the broker.
Examples)
[OK]
AT+MQTTSET=?
<UserName>,<Password>,<ClientID>,<AliveTime> [OK]
AT+MQTTCON=<Con/Discon>,<BrokerIP>,<BrokerPort>,<SSL_Enable>
<Con/Discon>: MQTT Connection (Required)
Parameter | Meaning |
---|---|
0 | Connect to the broker |
1 | Disconnect from the broker |
<BrokerIP>: IP address of the broker (Optional)
<BrokerPort>: Broker Port (optional, default: 1883)
<SSL_Enable>: whether to enable secure connection (optional, default: 0)
Parameter | Meaning |
---|---|
0 | Not to enable SSL connection |
1 | Enable SSL connection |
Connection Examples)
[MQTT CONNECT] [OK]
Disconnection Examples)
[MQTT DISCONNECT] [OK]
AT+MQTTCON=?
<Connection Status> [OK]
AT+MQTTSUB=<Sub/Unsub>,<Topic>
<Sub/Unsub>: Subscribe/Unsubscribe the Topic (Required)
Parameter | Meaning |
---|---|
0 | Unsubscribe the topic |
1 | Subscribe the topic |
<Topic>: Themes subscribed by the WizFi310 (Required, Max: 64 Character)
Examples)
[OK]
AT+MQTTPUB=<Topic>,<Length>
<Topic>: Themes subscribed by the WizFi310 (Required, Max: 64 Character)
<Length>: Length of the message (Required)
Examples)
<Length> [OK]
GMMP Commands are for SK Telecom in Korea. So these command can't use in other country. (It can be used only in Korea). So descriptions for these commands will be written in Korea.
GMMP는 M2M 단말과 개방형 M2M 플랫폼(OMP)사이의 TCP 기반 연동 규격으로서, 단말 등록/해지, 주기보고, 단말 제어 등의 기능을 수행하는 SKTelecom 내부 규격이다.
AT+GMMPSET=<Con/Discon>,<ThingPlug IP>,<Thingplug Port>,<Domain Code>,<Auth ID>,<Manufacture ID>,<Device ID>
Element | Example | Description |
---|---|---|
Con/Discon | 1 or 0 | 1: GMMP_GW_Registration과 GMMP_Delivery를 수행한다. GMMP_Delivery는 AT+GMMPDATA가 설정되어있어야 한다. 0: GMMP_Delivery를 중지한다. |
ThingPlug IP | 61.250.21.211 | ThingPlug의 IP를 입력한다. |
ThingPlug Port | 31002 | ThingPlug의 TCP Listen Port를 입력한다. ThingPlug→마이페이지→서비스 정보수정에서 확인 가능 |
Domain Code | ThingPlug | ThingPlug의 서비스명을 입력한다. ThingPlug→마이페이지→서비스 정보수정에서 확인 가능 |
Auth ID | 0008dc1e000000 | GW ID, 디바이스 등록시 입력한 MAC Address를 입력한다. ThingPlug→디바이스 정보→디바이스 조회에서 확인 가능 |
Manufacture ID | WIZnet_GWMFID | 제조사 ID를 입력한다. ThingPlug→디바이스 정보→디바이스 조회에서 확인 가능 |
Device ID | deviceID | 디바이스 ID를 입력한다. 디바이스 고유의 ID를 사용한다. |
Connection Examples)
[GMMP CONNECT] [OK]
Disconnection Examples)
[GMMP DISCONNECT] [OK]
AT+GMMPDATA=<Option>,<Data>
Element | Example | Description |
---|---|---|
Option | 0 or 1 | 0: 설정된 주기마다 보낼 데이터를 설정한다. 1: AT명령 즉시 데이터를 보낸다. |
Data | DATA | 데이터 |
Examples)
[OK]
AT+GMMPOPT=<Option>,<values>
<WRAP indent><WRAP indent>
Element | Example | Description |
---|---|---|
set | 0 or 1 | 0: 현재 설정된 값을 읽는다. 1: val1, val2의 값으로 설정한다. |
val1 | 0 or 1 | 0: 이벤트 로그를 프린트 하지 않는다. 1: 이벤트 로그를 프린트 한다. |
val2 | 0 or 1 | 0: 디버그 메세지를 프린트하지 않는다. 1: 디버그 메세지를 프린트 한다. |
Element | Example | Description |
---|---|---|
period | 10 | Heartbeat 패킷 전송 주기(단위: 분) |
Element | Example | Description |
---|---|---|
period | 10 | Delivery 패킷 전송 주기(단위: 분) |
ThingPlug는 SK Telecom의 IoT 플랫폼으로, oneM2M 표준 기반의 IoT 서비스를 제공합니다.
AT+SKTPCON=<Con/Discon>,<ThingPlug IP>,<ThingPlug Port>,<Alive Time>, <ThingPlug Portal ID>,<Credential ID>,<Service ID>,<Version>,<Device ID>
<Con/Discon>: ThingPlug Connect/Disconnect
Parameter | Meaning |
---|---|
0 | Disconnect to the ThingPlug |
1 | Connect from the ThingPlug |
<ThingPlug IP>: ThingPlug IP 주소
<ThingPlug Port>: ThingPlug Port 번호
<Alive Time>: ThingPlug에 접속 유지하는 시간 설정
<ThingPlug Portal ID>: ThingPlug에 가입한 사용자 ID
<Credential ID>: 초기 디바이스 인증 코드
<Service ID>: 등록한 서비스 ID
<Version>: 버젼 정보
<Device ID>: 디바이스 ID
Examples)
[MQTT CONNECT] [OK]
AT+SKTPDEVICE=<Register/Delete>,<Device ID>,<Device Authorization Code(AE-ID)>
<Register/Delete>: Device Register/Delete to ThingPlug
Parameter | Meaning |
---|---|
0 | Device Delete |
1 | Device Register |
<Device ID>: Device ID
<Device Authorization Code(AE-ID)>: AE-ID
Connection Examples)
[OK]
AT+SKTPCONTAINER=<Register/Delete>,<Container Name>
<Register/Delete>: Container Register/Delete to ThingPlug
Parameter | Meaning |
---|---|
0 | Container Delete |
1 | Container Register |
<Container Name>: Container Name
Examples)
[OK]
AT+SKTPSEND=<Container Name>,<Data>
<Container Name>: Container Name
<Data>: Data to send
Examples)
[OK]
AT+SKTPCMD=<Register/Delete>,<Management command>
<Register/Delete>: Container Register/Delete to ThingPlug
Parameter | Meaning |
---|---|
0 | Management command Delete |
1 | Management command Register |
<Management command>: Response command to management
Examples)
[OK]
AT+SKTPRESULT=<Management command>,<Execute Status>,<Execute Result>
<Management command>: Registered Management command
<Execute Status>: Execute status value
<Execute Result>: Execute result value
Examples)
[OK]
There are two user interface modes between WizFi310 and User-System.
Command mode is the default communication mode and all AT Commands can be used only at this mode. Through AT Commands, users can do 'WiFi Configuration', 'Sending/Receiving Data', 'Managing System', and so on. WizFi310 treats all received data from users as AT command. If all received data follows the correct command format, WizFi310 processes it and returns a proper response to user.
Data mode, on the other hand, is the mode which passes data of application layers to peer devices directly, without AT commands or any other interventions. It can be considered as a black box which passes all USART input to USART output directly. Its concept is simple but to enter this mode, Users need to set the environment properly through AT Commands.
Users can enter Data mode by writing '1' at '<DataMode>' parameter of AT+SCON command. Make sure that there are no open sockets before performing this, because Data mode works with one socket only. (So if you try to open another socket in data mode it will fail). If the socket of Data mode is closed, the mode will be changed to Command mode automatically so users can input AT Commands. If users set AT+SCON command as service with data mode option and save the profile, Data mode will be started when WiFi is joined, so the user does not need to set environments anymore. If the system boots or reboots at that time, WiFi Join will also be started automatically. Users can exit from data mode temporally by entering '+++' in a row (Wait for a second until [OK] response show up). Any AT Command can be entered during Data mode except AT+SCON command. If you want to return to data mode again, you just need to enter AT+SDATA. If you want to exit Data mode completely, close the socket by using 'AT+SMGMT=0' or 'AT+SMGMT=ALL'.
In Command mode, you can make more than one socket, and you can send/receive data through opened sockets at the same time by using AT Command. You can send data to specific socket opened through AT+SSEND command and receive data with information header which informs you on the socket number, the peer address and the received data length.
WizFi310 can be upgraded using serial interface. These are methods how to upload firmware using serial interface.
WIZnet supports <WizFi310_Update_Tool> for uploading firmware. This tool used XMODEM protocol with WizFi310 and it can be downloaded at WizFi310 Firmware(Using Serial).
Execute “WizFi310_Update_Tool.exe” and select serial port and baud rate. For your information, WizFi310 is set to 115200 for default baudrate.
If you select <Upload> button, This tool will try to upload firmware to WizFi310 as below.
If it is done successfully, you can see message as below.
If this tool is displayed error message as below, you have to check your binary whether it is right.
TeraTerm is terminal emulator. This software is open source software under BSD License. For more detailed information, Refer to it. ( https://ttssh2.osdn.jp/ ) You can download TeraTerm at this URL. ( https://en.osdn.jp/projects/ttssh2/releases/ )
In order to set for upgrading firmware, You can use AT+MUPGRADE command.
After enter AT+MUPGRADE in TeraTerm after WizFi310 restart. It will display 'C' message as below.
After select binary, Teraterm will send binary via XMODEM and If it is done successfully, WizFi310 will restart and display firmware version as below.
WIZnet supports <WizFi310_OTA_Tool> for uploading firmware. This tool used TCP protocol with WizFi310 and it can be downloaded at WizFi310 Firmware(Using OTA).
Execute “WizFi310_Ota_Tool.exe” and select serial port and baud rate of WizFi310. For your information, WizFi310 is set to 115200 for default baudrate.
If it is done successfully after push <Open> button in Step 1, You can choice SSID which WizFi310 will connect. Choice SSID and input key value of AP and then push <connect> button, <WizFi310 OTA Tool> will enter commands to WizFi310 in order to connect to AP.
Select IP Address of PC which <WizFi310 OTA Tool> is run and then click <Start OTA> button.
If it is done successfully, you can see message as below.
If this tool is displayed error message as below, you have to check WizFi310 or your binary whether it is right.
This section explains how to connect to AP using WizFi310 with static IP address.
In this example, target AP information is as below.
( SSID : WizFiDemoAP, Security : WPA2, Key : 12345678 )
AT (Sent AT command with 0x0d (Hex of Enter button)) [OK] (Response meaning successful execution) AT+WSET=0,WizFiDemoAP (AT command for setting WiFi association) [OK] AT+WSEC=0,WPA2,12345678 (AT command for setting WiFi security) [OK] AT+WNET=0,192.168.12.101,255.255.255.0,192.168.12.1 (AT command for setting Static IP address) [OK] AT+WJOIN (AT command executing AP association) Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.101 Gateway : 192.168.12.1 [OK] AT+WLEAVE (AT command making disassociation from AP association) [Link-Down Event] [OK]
This section explains how to connect WizFi310 to target AP with DCHP Client Mode
AT (Sent AT command with 0x0d (Hex of Enter button)) [OK] (Response meaning successful execution) AT+WSET=0,WizFiDemoAP (AT command for setting WiFi association) [OK] AT+WSEC=0,WPA2,12345678 (AT command for setting WiFi security) [OK] AT+WNET=1 (AT command for setting DHCP) [OK] AT+WJOIN (AT command executing AP association) Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.13 Gateway : 192.168.12.1 [OK] AT+WLEAVE (AT command making disassociation from AP association) [Link-Down Event] [OK]
This section explains how to set AP mode using WizFi310. In AP mode, WizFi310
have to set static IP address. (AT+WNET=0,xxx,xxx,xxx) After setting AP mode,
WizFi310 will operate DHCP Server. Thus, when smart phone or other devices
connect to WizFi310, WizFi310 will give IP address to connected device.
AT (Sent AT command with 0x0d (Hex of Enter button)) [OK] (Response meaning successful execution) AT+WSET=1,WizFi310_AP (AT command for setting WiFi association information) [OK] AT+WSEC=1,WPA2,12345678 (AT command for setting WiFi security) [OK] AT+WNET=0,192.168.12.105,255.255.255.0,192.168.12.1 (AT command for setting Static IP address) [OK] AT+WJOIN (AT command executing run AP mode) Joining : WizFi310_AP [Link-Up Event] IP Addr : 192.168.12.105 Gateway : 192.168.12.1 [OK] AT+WLEAVE (AT Command disassociating from AP association) [Link-Down Event] [OK]
This section explains how to open <TCP Client Socket> and communicate with peer system.
Below is an example showing how to set TCP Client and change the mode to data mode.
It also explains parameters of <AT+SCON> command.
(AT+SCON=<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>)
If you enter <O> or <SO> value to <Open Type> parameter, WizFi310 will try to connect
to TCP Server immediately. But when using <S> value, WizFi310 will try to connect to TCP
Server after reboot and you have to set <SocketType>,<RemoteIP>,<RemotePort> and
<LocalPort> as below
In order to set WizFi310 to data mode, you have to enter 1 value to <Data Mode> parameter
of <AT+SCON> command. For detailed information to this command,
refer to AT+SCON.
AP Association ( Refers to Association & Disassociation Example ) AT+SCON=O,TCN,192.168.12.102,5000,5001,1 ( AT command connecting with a TCP Client Socket ) [OK] [CONNECT 0] <= At this point, a TCP connection is done
If WizFi310 successfully connects to a peer system, WizFi310 will print [CONNECT(CID)] message
and enter data mode. In data mode, WizFi310 can send serial data to peer system and receive
network data from peer system without other translation.
In order to close TCP connection, WizFi310 has to switch to AT Command Mode.
( When +++ message entered, WizFi310 can be changed to AT Command Mode. )
After being changed to AT Command Mode, TCP Connection can be closed by using <AT+SMGMT=CID> or <AT+SMGMT=ALL> command.
After being changed to AT Command Mode, TCP Connection can be closed by using <AT+SMGMT=CID> or <AT+SMGMT=ALL> command.
AT+SMGMT=? Number of Sockets : 1 (SCID/Socket/Mode/Remote/Local/DataMode) 0/TCN/192.168.12.23:5000/5001/1 [OK]
This section explains how to open <TCP Server Socket> and communicate with peer system.
Below is the example for setting TCP Server and then changing to data mode.
For detailed information about <AT+SCON> command,
refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,TSN, , ,5000,1 ( AT command listening with a TCP Server Socket ) [OK] [CONNECT 0] <= When TCP connection is done, you can see this message
Exchanging data with its peer system is the same as previous Exchanging data with a peer system.
Closing socket connection is the same as previous Socket Close.
Checking socket status is the same as previous Checking Socket Status.
This section explains how to open <UDP Client Socket> and communicate to peer system.
Below is an example for setting up UDP Client and changing into data mode.
For detailed information about <AT+SCON> command,
refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,UCN,192.168.12.23,5001,5000,1 [OK] [CONNECT 0] <= At this point, a UDP connection is done
Exchanging data with its peer system is the same as previous Exchanging data with a peer system.
Closing socket connection is the same as previous Socket Close.
Checking socket status is the same as previous Checking Socket Status.
This section explains how to open <UDP Server Socket> and communicate to peer system.
Below is an example for setting up UDP Server and changing into data mode.
For detailed information about <AT+SCON> command,
refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,USN, , ,5000,1 [OK] [CONNECT 0] <= At this point, a UDP connection is done
<UDP Server Mode> can connect UDP connection without peer system information like IP address
and port number. But before peer system is connected to WizFi310, WizFi310 does not send data
to peer system because WizFi310 does not know its information. Thus peer system must send data
to WizFi310 in order to know peer system’s information like below.
The other information for exchanging data is same as Exchanging data with a peer system.
Closing socket connection is the same as previous Socket Close.
Checking socket status is the same as previous Checking Socket Status.
This section explains how to set <TCP Client> in <Command Mode> and communicate to peer system.
Below is the example for setting TCP Client on the Command Mode .
In order to enter in the Command Mode, you have to enter 0 value to <Data Mode> parameter of
<AT+SCON> command. For detailed information to this command,
refer to AT+SCON
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,TCN,192.168.12.23,5000,5001,0 [OK] [CONNECT 0] <= At this point, a TCP connection is done
If WizFi310 connects to peer system successfully, WizFi310 will print [CONNECT(CID)] message. At this time, WizFi310 is in command mode. In order to send data to peer system, you have to use <AT+SSEND=CID, Destination IP, Destination Port, Data Length> command. If you input serial command like <Data Length> , WizFi310 will send serial data to peer system.
AT+SSEND=0,,,5 ( Sending data to a Socket with CID 0 ) Hello <= When serial data is 5byte, WizFi310 send this data to peer system [OK] {0,192.168.12.23,5000,11}Hi WizFi310 ( Receiving data from pear system )
In <AT Command Mode>, TCP connection can be closed through <AT+SMGMT=CID> or <AT+SMGMT=ALL> command.
In <AT Command Mode>, Information of connected sockets are shown by using <AT+SMGMT=?> command.
AT+SMGMT=? Number of Sockets : 1 (SCID/Socket/Mode/Remote/Local/DataMode) 0/TCN/192.168.12.23:5000/5001/0 [OK]
This section explains how to set <TCP Server> in <Command Mode> and communicate to peer system.
Below is the example for setting TCP Server on the Command Mode. For detailed information about
<AT+SCON> command, refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,TSN, , ,5000,0 ( AT command listening with a TCP Server Socket ) [OK] [CONNECT 0]
Exchanging data with its peer system is the same with previous Exchanging data with a peer system.
Closing socket connection is the same with previous Socket Close.
This section explains how to set <UDP Client> in <Command Mode> and communicate to peer system.
Below is an example for setting UDP Client on Command Mode. For detailed information about
<AT+SCON> command, refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,UCN,192.168.12.23,5001,5000,0 [OK] [CONNECT 0] <= At this point, a UDP connection is done
Exchanging data with its peer system is the same as previous Exchanging data with a peer system.
Closing socket connection is the same as previous Socket Close.
This section explains how to open <UDP Server Socket> in Command Mode and communicate to peer system.
Below is an example for setting UDP Server on Command Mode. For detailed information about
<AT+SCON> command, refer to AT+SCON
and Socket Open.
AP Association ( Refer to Association & Disassociation Example ) AT+SCON=O,USN, , ,5000,0 [OK] [CONNECT 0]
<UDP Server Mode> of WizFi310 can connect UDP connection without peer system information like IP address and port number. Before peer system is connected to WizFi310, WizFi310 does not send data to peer system. So you should be careful when using <UDP Server Mode>.
{0,192.168.12.23,5001,11}Hi WizFi310 ( Receiving data from peer system ) AT+SSEND=0,,,5 ( Sending data to a Socket with CID 0 ) Hello <= When serial data is 5byte, WizFi310 send this data to peer system [OK ]
AT+SCON=<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>
This section explains the usage of <Open Type> parameter of <AT+SCON> command.
This table describes values of <Open Type> parameter.
Parameter | Meaning |
---|---|
S | Register as a Service |
O | Open at Once |
SO | Open at Once & Register as a Service |
When using this parameter, WizFi310 will try to connect to peer system using TCP or UDP when power is on.
AT+WLEAVE [OK] AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,WPA2,12345678 [OK] AT+WNET=1 [OK] AT+SCON=S,TSN,,,5000,0 [OK] AT+MPROF=S [OK] AT+MRESET [OK] WizFi310 Version 0.9.0.0 (WIZnet Co.Ltd) Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.10 Gateway : 192.168.12.1 AT+SMGMT=? Number of Sockets : 1 (SCID/Mode/Remote/Local/DataMode) 0/TSN/0.0.0.0:0/5000/0 [OK]
When using this parameter, WizFi310 will try to connect to peer system using TCP or UDP when
enter the <AT+SCON> command. For using this parameter, WizFi310 should be already associated with
AP or running AP mode. In this section, we have only explained steps in Station Mode. In AP Mode,
you can use this command like in Station Mode
AT+WLEAVE [OK] AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,WPA2,12345678 [OK] AT+WNET=1 [OK] AT+WJOIN Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.10 Gateway : 192.168.12.1 [OK] AT+SCON=O,TCN,192.168.12.23,5000,,0 [OK] [CONNECT 0]
When using this parameter, you can use functions of <S> and <O> at the same time. When using this parameter, WizFi310 will try to connect to peer system momentarily. And if you restart WizFi310, WizFi310 will try to connect to AP and peer system.
AT+WLEAVE [OK] AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,WPA2,12345678 [OK] AT+WNET=1 [OK] AT+WJOIN Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.10 Gateway : 192.168.12.1 [OK] AT+SCON=SO,TCN,192.168.12.23,5000,,0 [OK] [CONNECT 0] AT+MPROF=S [OK] AT+MRESET [OK] WizFi310 Version 0.9.0.0 (WIZnet Co.Ltd) Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.12.10 Gateway : 192.168.12.1 [CONNECT 0]
This section explains how to connect to and communicate with SSL server. To connect to SSL server, use <TCS(TCP Client SSL)> parameter of <AT+SCON> command.
( When using UDP and TCP Server, WizFi310 cannot use SSL Connection. )
In order to use SSL connection, you can use AT command as below.
AP Association ( Refers to Association & Disassociation Example ) AT+FDNS=facebook.com,3000 173.252.120.68 [OK] AT+SCON=O,TCS,173.252.120.68,443,,0 ( Connect to Facebook.com using SSL Connection ) [OK] [CONNECT 0] AT+SSEND=0,,,18 [0,,,18] ... GET / HTTP/1.1{0x0d}{0x0a} ( Send data to Facebook ) {0x0d}{0x0a} ... [OK] {0,173.252.120.68,443,1500}HTTP/1.1 400 Bad Request ( Receive data from Facebook ) Content-Type: text/html; charset=utf-8 Date: Tue, 24 May 2016 06:03:48 GMT Connection: close Content-Length: 2959 <!DOCTYPE html> <html lang="en" id="facebook"> <head> <title>Facebook | Error</title> <meta charset="utf-8"> <meta http-equiv="cache-control" content="no-cache"> <meta http-equiv="cache-control" content="no-store"> <meta http-equiv="cache-control" content="max-age=0"> <meta http-equiv="expires" content="-1"> <meta http-equiv="pragma" content="no-cache"> <meta name="robots" content="noindex,nofollow"> .... [DISCONNECT 0]
When you want to connect the Web Server. you have to use the AT+SCON Command. but the parameters of AT+SCON are IP and Port instead of Domain name.
When It case, It is useful to use AT+SDNAME for getting the IP from Domain name.
AT+SDNAME=<Domain Name>
Destination IP would be set using DNS Query when this Command set.
WizFi310 Version 1.0.0.0 (WIZnet Co.Ltd) AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,,12345678 [OK] AT+WNET=1 [OK] AT+WJOIN [Link-Up Event] IP Addr : 192.168.3.55 Gateway : 192.168.3.1 [OK] AT+SDNAME=facebook.com [OK] AT+SCON=O,TCS,0.0.0.0,443,,0 [OK] [CONNECT 0] AT+SMGMT=? Number of Sockets : 1 (SCID/Mode/Remote/Local/DataMode) 0/TCS/69.171.230.68/443/32337/0 [OK]
Some times you need to set WizFi310 which can be set for TCP re-connection automatically.
If you use AT+FSOCK command as below, you can use WizFi310 in order to retry connection automatically.
AT+FSOCK=6,n
This command means that WizFi310 will check every <n> seconds whether socket is connected or not. If socket is not connected during <n> second, WizFi310 will retry connection. ( For using AT+FSCOK command, AT+SCON command is set to <S> or <SO> option. )
AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,,12345678 [OK] AT+WNET=1 [OK] AT+SCON=S,TCN,222.98.173.250,6002,,0 [OK] AT+FSOCK=6,30 [OK] AT+MPROF=S [OK] WizFi310 Version 1.0.0.0 (WIZnet Co.Ltd) Joining : WizFiDemoAP Successfully joined : WizFiDemoAP [Link-Up Event] IP Addr : 192.168.3.52 Gateway : 192.168.3.1 [CONNECT 0] [DISCONNECT 0] (Socket is disconnected due to unknown reason ) [DISCONNECT 0] (1st fail and try to connect socket after 30 seconds ) [DISCONNECT 0] (2nd fail and try to connect socket after 30 seconds again ) [CONNECT 0] (Connection is success after 30 seconds )
This example describe how to use <auto restart> function when connection is fail or disconnected
If you use these commands, you can set WizFi310 for using auto re-connection and automatically restart when repeats connection a specific number of times.
WizFi310 Version 1.0.0.0 (WIZnet Co.Ltd) AT+WSET=0,WizFiDemoAP [OK] AT+WSEC=0,,12345678 [OK] AT+WNET=1 [OK] AT+SCON=S,TCN,192.168.3.100,5000,,0 [OK] AT+FSOCK=8,20 [OK] AT+MPROF=S [OK] AT+MRESET [OK] WizFi310 Version 1.0.0.0 (WIZnet Co.Ltd) [Link-Up Event] IP Addr : 192.168.3.52 Gateway : 192.168.3.1 [DISCONNECT 0] (1st fail) [Link-Down Event] WizFi310 Version 1.0.0.0 (WIZnet Co.Ltd) (It will be restarted because tcp connection is fail during 20 seconds) [Link-Up Event] IP Addr : 192.168.3.52 Gateway : 192.168.3.1 [CONNECT 0] (WizFi310 will retry connection. then this message will be printed)
This section explains how to operate Air-command-mode of WizFi310.
With this Air-command-mode included in the WizFi310, you can issue AT commands to the module via WiFi, while the WizFi310 is in the TCP server or UDP server operation mode.
Please have a look at the following hints:
The AT command consists of following parts: Command header (WizFi310AirCmd:
), AT command (for example: AT
) and Carriage Return (\r
).
The command should be sent with these conditions:
Example usage of the WizFi310AirCmd:
AT+WSET=1,WizFi310_AIRCMD [OK] AT+WSEC=1,WPA2,123456789 [OK] AT+WNET=0,192.168.11.1,255.255.255.0,192.168.11.1 [OK] AT+WJOIN [Link-Up Event] IP Addr : 192.168.11.1 Gateway : 192.168.11.1 [OK] AT+MAIRCMD=O,T,50001,0 [OK] Now, TCP Client can connect to the WizFi310 and issue the AT commands via WiFi as below. (TCP Client TX) WizFi310AirCmd:AT+MINFO\r (24 Byte) (RX) FW version/HW version 1.0.0.0/WizFi310 Rev 1.0 [OK] (TCP Client TX) WizFi310AirCmd:AT+WSEC=?\r (25 Byte) (RX) 1,WPA2,123456789 [OK] (TCP Client TX) WizFi310AirCmd:AT+WSEC=1,WPA2,aaaabbbb\r (39 Byte) (RX) [OK] (TCP Client TX) WizFi310AirCmd:AT+MMAC=?\r (25 Byte) (RX) 00:08:DC:00:55:76 [OK]
If you use <Air Command>, You can configure WizFi310 using device which can use TCP like <Android App>.
In order to config the WizFi310 using Android APP, WizFi310 should operate as SoftAP mode.
After operating SoftAP, <AT+MAIRCMD> command should be set like “Example - Air Command”.
Another way for setting WizFi310 in order to use <Android app>, You have to press once function key of WizFi310. If you press function key once, WizFi310 will be changed to <Soft AP Mode> and open TCP port 50001 for using <Air Command Mode>.
You can download the App for configuration of WizFi310 at link below.
App install file - Google Play Store
Source Code - GitHub Repository
This picture shows the configuration page of WizFi310 Config Tool. If you want to use <WizFi310 Config Tool>, WizFi310 will be set to <Soft AP mode>
If you push <SCAN> button, <WizFi310 Config Tool> will search SSID of WizFi310. If SSID of WizFi310 doesn't match <WizFi310 SSID> value in general setting, <WizFi310 Config Tool> will display error message.
If you push <Join> button after scan SSID of WizFi310, <WizFi310 Config Tool> will connect to WizFi310.
If you push <AIR COMMAND> button after previous step is done successfully, <WizFi310 Config Tool> will set WizFi310 in order to join to AP and connect to destination server.
You can find the examples of mqtt using the WizFi310 at following link.
Refer to MQTT Example
You can find the examples of gmmp using the WizFi310 at following link.
Refer to GMMP Example(written korean)
You can find the examples of connecting to ThingPlug using the WizFi310 at following link.
Refer to ThingPlug Example(written in Korean)