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 “rn” back instead of “r”, which means user (host system) always handle 'rn' as a only delimiter.

Input by User	ATr (0x61 0x74 0x0d)
Output from WizFi310	ATrn[OK]rn (0x61 0x74 0x0d 0x0a 0x5b 0x4f 0x4b 0x5d 0x0d 0x0a) (- “ATrn” is Echo back of user input)

Responses

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)

Command List

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

Network Commands
AT+SCON	Socket Open/Connect
AT+SMGMT	Socket Management
AT+SSEND	Data Send
AT+SDATA	Return to Data Mode
AT+SFORM	Define Data Receive Header Form
AT+SOPT	S2W Socket Option
AT+SOPT1	S2W miscellaneous option

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

Available Protocol

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

Basic commands are listed below.

---

AT

• Format: AT

• Meaning: Terminal Check

Check if AT Command Terminal is working.

• Response: [OK]

WiFi Commands

Commands related to WiFi are listed below.

AT+WJOIN

• Format:

  AT+WJOIN

• Meaning: WiFi Association

  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.

  • There are 2 Wi-Fi modes in WizFi310, STA mode and SoftAP mode. When users execute AT+WJOIN command, the current Wi-Fi mode works as the one previously selected by user input. 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.

  • SoftAP mode does not support WEP security method.

• Response:

  [Link-Up Event] IP Addr : xxx.xxx.xxx.xxx Gateway : xxx.xxx.xxx.xxx [OK]

  Already Associated : (Mode) [OK]

---

AT+WLEAVE

• Format: AT+WLEAVE

• Meaning: WiFi Disassociation

In the STA mode, it leaves current Access Point, but in the SoftAP mode, it stops to run as Access Point.

• Response: [Link-Down Event] [OK]

---

AT+WSCAN

• Format:

  AT+WSCAN=<SSID>,<BSSID>,<Channel>

• Meaning: WiFi Scan

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)

• AT+WSCAN=TestAP
• AT+WSCAN=,,6
• AT+WSCAN=,08:00:DC:11:22:33,11

• Response: Index/SSID/BSSID/RSSI(-dBm)/MaxDataRate(Mbps)/Security/RadioBand(GHz)/Channel ... [OK]

---

AT+WSET

• Format:

  AT+WSET=<WiFiMode>,<SSID>,<BSSID>,<Channel>

• Meaning: WiFi Configuration

<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)

• AT+WSET=0,WizFiAP
• AT+WSET=0,WizFiAP,08:00:DC:11:22:33,1

• Response: [OK]

---

• Format: AT+WSET=?

• Meaning: Get Current WiFi configuration Settings

• Response: >

  <WiFiMode>,<SSID>,<BSSID>,<Channel> [OK]

---

AT+WSET2

• Format:

  AT+WSET2=<WiFiMode>,<SSID>

• Meaning: WiFi Configuration for SSID of special Characters like '“' ',' '共'

<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)

• AT+WSET2=0,가나다”,無線共有器

• Response: [OK]

---

• Format: AT+WSET2=?

• Meaning: Get Current WiFi configuration Settings

• Response: >

  <WiFiMode>,<SSID>,<BSSID>,<Length of SSID> [OK]

---

AT+WSEC

• Format: AT+WSEC=<WiFiMode>,<SecType>,<Key>

• Meaning: WiFi Security Configuration

<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)

• AT+WSEC=0,WEP,12345
• AT+WSEC=1,WPA2,12345678
• AT+WSEC=0,,123456789

• Response: [OK]

---

• Format: AT+WSEC=?

• Meaning: Get the Current Security Mode and Settings

• Response: <WiFiMode>,<SecType>,<Key> [OK]

---

AT+WNET

• Format: AT+WNET=<DHCP>,<IP>,<SN>,<GW>

• Meaning: Network Configuration

<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.

• Response: [OK]

---

• Format: AT+WNET=?

• Meaning: Get Current Network Setting

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.

• Response: <DHCP>,<IP>,<SN>,<GW> [OK]

---

AT+WSTAT

• Format: AT+WSTAT

• Meaning: Get Current WiFi Status

• Response: IF/SSID/IP-Addr/Gateway/MAC/TxPower(dBm)/RSSI(-dBm) ... [OK]

---

AT+WWPS

• Format: AT+WWPS=<Mode>,<PinNum>

• Meaning: WiFi WPS Connection 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)

• AT+WWPS=0
• AT+WWPS=1,12345670

• Response: [OK]

---

AT+WADNS

• Format: >

  AT+WADNS=<DNS Server1>,<DNS Server2>

• Meaning: Add DNS Server

<DNS Server 1>: DNS Server 1 <DNS Server 2>: DNS Server 2

Examples)

• AT+WADNS=8.8.8.8

• Response: [OK]

Network Commands

Commands related to Network are listed below.

---

AT+SCON

• Format: >

  AT+SCON=<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>

• Meaning: Socket Open/Connect ( User can use max 8 sockets. ) 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)

AT+SCON=O,TSN,,,5000,0 AT+SCON=S,UCN,192.168.0.10,12345,5000,1 (Profile must be saved)

• Response: [OK]

---

• Format: >

  AT+SCON=?

• Meaning: Get Previous Input Parameters

Use for check if previous input parameters are correct.

• Response: <OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode> [OK]

---

AT+SMGMT

• Format: AT+SMGMT=<SocketID>

• Meaning: Socket Management - Socket Close

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)

• AT+SMGMT=5
• AT+SMGMT=ALL

• Response: [OK]

---

• Format:

  AT+SMGMT=?

• Meaning: Socket Management - Get Opened Socket Status This prints all of the opened sockets statuses.

• Response: Number of Sockets : x (SCID/Socket/Mode/Remote/Local/DataMode) <SocketID>,<SocketAddr>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode> ... [OK]

---

AT+SSEND

• Format: AT+SSEND=<SocketID>,<RemoteIP>,<RemotePort>,<SendSize>,<Timeout>

• Meaning: Data Send

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)

• AT+SSEND=0,,,3
• AT+SSEND=1,192.168.0.100,5000,1000000,50000

• Response: [OK]

---

AT+SDATA

• Format: AT+SDATA

• Meaning: Return to Data Mode

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.

• Response: [OK]

---

AT+SFORM

• Format: AT+SFORM=<Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2>

• Meaning: Define Data Receive Header Form

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)

• AT+SFORM=111111111,7B,2C,7D,0D,0A

• AT+SFORM=101100110,5B,2F,5D,0D,00

  • Response:

    [OK]

---

• Format:

  AT+SFORM=?

• Meaning: Get Current Data Receive Header Form

• Response: <Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2> [OK]

---

AT+SOPT

• Format: AT+SOPT=<Option>,<SocketID>,<Socket Level>,<Option Name>,<Option Value
• Meaning: S2W miscellaneous option <Option>: Option to configure (Required)

Option	Value
1	Set socket option
2	Get 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)

• AT+SOPT=1,0,4095,8,1

• AT+SOPT=1,0,6,3,10

• AT+SOPT=1,0,6,4,15

• AT+SOPT=1,0,6,5,3

• Response:

  [OK]

---

AT+SOPT1

• Format: AT+SOPT1=<Option>,<Value

  • Meaning: S2W miscellaneous option

<Option>: Option to configure (Required) <Value>: Value of the option (Required)

Option	Value
10	Escape sequence(+++) Timer(millisecond, default 1000, 1~10000)

Examples)

• AT+SOPT1=10,500

  • Response:

    [OK]

Management Commands

Commands related to system management are listed below.

---

AT+MPROF

• Format:

  AT+MPROF=<Action

  • Meaning: Profile Management

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)

• AT+MPROF=S

  • Response: [OK]

    +WSET=... +WSEC=... +WNET=... +WREG=... +SCON=... +SFORM=... +MMSG=... +MMAC=... +USET=... +MECHO=... [OK]

---

AT+MFDEF

• Format:

  AT+MFDEF=FR

  • Meaning: Perform Factory Reset

Factory Reset means that all of environmental variables return back to the default state. (You can check that by using AT+MPROF command)

• Response: [OK]

---

AT+MRESET

• Format:

  AT+MRESET

  • Meaning: Perform System Reset

System will reboot after this command.

• Response:

  [OK]

AT+MMSG

• Format:

  AT+MMSG=<Level

  • Meaning: Set Message Print Level

<Level>: Message Print Level (Required)

Parameter	Meaning
1	Not Print Responses
2	Print Responses, Events (Default)
3	Print Responses, Events, Debug Logs

Examples)

• AT+MMSG=2

  • Response:

    [OK]

---

• Format: AT+MMSG=?

• Meaning: Get Current Message Print Level

• Response:

  <Level> [OK]

AT+MMAC

• Format:

  AT+MMAC=<MAC

  • Meaning: Set MAC Address

<MAC>: MAC Address (separated by colon) (Required)

Examples)

• AT+MMAC=00:08:DC:11:22:33

  • Response:

    [OK]

---

• Format:

  AT+MMAC=?

• Meaning: Get Current MAC Address

• Response:

  <MAC> [OK]

AT+MINFO

• Format:

  AT+MINFO

  • Meaning: Get System Information

  • Response:

    FW version / HW version <FWver> / <HWver> [OK]

AT+MECHO

• Format:

  AT+MECHO=<Action

  • Meaning: Set Echo Mode

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)

• AT+MECHO=0

  • Response: [OK]

---

• Format:

  AT+MECHO=?

• Meaning: Get Current Echo Mode

• Response:

  <Mode> [OK]

AT+MHELP

• Format:

  AT+MHELP

  • Meaning: Print Command Description and Usage

This is command usage guide for user convenience.

• Response:

  ... [OK]

AT+MMCUPS

• Currently Not Available

---

AT+MWIFIPS

• Format:

  AT+MWIFIPS=<Action>,<Delay

  • Meaning: Wi-Fi Power Save Enable/Disable

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

  • Response:

    [OK]

---

• Format:

  AT+MWIFIPS=?

• Meaning: Get Current Wi-Fi Power Save Status

<Status > : Current Wi-Fi Power Save Status

Return value	Meaning
0	Wi-Fi Power Save Mode Disable
1	Wi-Fi Power Save Mode Enable

• Response:

  [OK]

---

AT+USET

• Format:

  AT+USET=<Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon

  • Meaning: UART Configuration

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)

• AT+USET=115200,N,8,1,N

• AT+USET=921600,N,8,2,HW

• Response:

  [OK]

---

• Format:

  AT+USET=?

• Meaning: Get Current UART Setting

• Response:

  <Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon> [OK]

---

AT+MCUSTOM

• Format:

  AT+MCUSTOM=<custom code - Meaning: Set to customized settings by request of specific customers.

Examples)

Default custom code is WIZNET

• AT+MCUSTOM=WIZNET

  • Response: [OK]

---

• Format:

  AT+MCUSTOM=?

• Meaning: Get current custom code

• Response:

  WIZNET [OK]

AT+MAIRCMD

• Format:

  AT+MAIRCMD=<OpenType>,<SocketType>,<LocalPort>,<Option

  • Meaning: Configure Air Command mode

<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)

• AT+MAIRCMD=O,T,50001,0

• AT+MAIRCMD=S,U,50001,0

• AT+MAIRCMD=?

  • Response:

    <OpenType>,<SocketType>,<LocalPort>,<Option> [OK]

---

AT+MEVTMSG

• Format:

  AT+MEVTMSG=<Status

  • Meaning: Print [Listen x] as soon as it opens up a socket through TCP server.

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)

• AT+MEVTMSG=0

• AT+MEVTMSG=1

  • Response:

    [OK]

---

AT+MEVTFORM

• Format:

  AT+MEVTFORM=<format

  • Meaning: Define Event Message Form

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)rn	rn[0]rn
b		rn[CONNECT %x]rn	rn[1]rn
c		rn[DISCONNECT %x]rn	rn[2]rn
d		rn[Link-Up Event]rn IP Addr : ...rn Gateway : ...rn	rn[3]rn
e		rn[Link-Down Event]rn	rn[4]rn
f		rn[Reset Event]rn	rn[5]rn
g		rn[TCP Send Error]rn	rn[6]rn
h		rn[P2P Fail Event]rn	rn[7]rn
i		rn[LISTEN %x]rn	rn[8]rn
j		rn[MQTT CONNECT]rn	rn[9]rn
k		rn[MQTT DISCONNECT]rn	rn[a]rn

Examples)

• AT+MEVTFORM=111111111111

• AT+MEVTFORM=122220000000

• AT+MEVTFORM=000000000000

  • Response:

    [OK]

---

• Format:

  AT+MEVTFORM=?

• Meaning: Get Current Event Message Form

• Response:

  <Format> [OK]

AT+MUPGRADE

• Format:

  AT+MUPGRADE

• Meaning: This command is for upgrading firmware of WizFi310 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)

• AT+MUPGRADE

  • Response:

    [OK]

---

Function Commands

Commands related to additional functions are listed below.

---

AT+FPING

• Format:

  AT+FPING=<RepeatCnt>,<TargetIP

  • Meaning: PING Test

<RepeatCnt>: Repeat Count (Required)
Valid Range: 1 ~ 50 (unit:number of times)

<TargetIP>: Target IP Address (Required)

Examples)

• AT+FPING=3,192.168.0.10

  • Response:

    Ping Reply : xxx ms ... [OK]

AT+FDNS

• Format:

  AT+FDNS=<HostName>,<Timeout

  • Meaning: DNS Query

<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)

• AT+FDNS=www.google.com,1000

  • Response:

    xxx.xxx.xxx.xxx [OK]

AT+FGPIO

• Format:

  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

  • Meaning: GPIO Control Function

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)

• AT+FGPIO=3,1,1 << Initialize GPIOB 3 as a Output mode

• AT+FGPIO=3,3,0 << Set GPIO value of GPIOB 3 to Low

• AT+FGPIO=3,3,1 << Set GPIO value of GPIOB 3 to High

• AT+FGPIO=3,2,0 << Get GPIO value of GPIOB 3

  • Response:

If <action> is 2

<gpio_value> [OK] ex) AT+FGPIO=3,2,0 0 [OK]

If <action> is 0, 1, 3

[OK]

---

• Format:

  AT+FGPIO=?

• Meaning: Get available GPIO number

Examples)

• AT+FGPIO=?

  • Response:

    <gpio_num_1>,<gpio_num_2> [OK]

    ex) 3,4 [OK]

---

AT+FGETADC

• Format:

  AT+FGETADC=?

  • Meaning: Read ADC from ADC pin of WizFi310 when using this AT Command

Examples)

• AT+FGETADC=?

  • Response:

    xxxx [OK]

    ex) 1697 [OK]

AT+FSOCK

• Format:

  AT+FSOCK=<Option>,<Value

  • Meaning: SOCKET Extension Option

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)

• AT+FSOCK=1,5000

• AT+FSOCK=6,10

• AT+FSOCK=8,30

  • Response:

    [OK]

---

• Format:

  AT+FSOCK=?

• Meaning: Get Current extended options of socket

• Response:

  <Extened option 1><2><3><4><5><6><7><8> [OK]

  ex) 5000,0,0,0,0,10,0,30

---

AT+FOTA

• Format:

  AT+FOTA=<Server IP>,<Server Port

  • Meaning: Launch OTA Mode

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

• Response:

  [OK]

---

MQTT Commands

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

WizFi310 MQTT Example

---

AT+MQTTSET

• Format:

  AT+MQTTSET=<UserName>,<Password>,<ClientID>,<AliveTime

  • Meaning: This command is used to initialize the necessary parameters of MQTT connection.

<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)

• AT+MQTTSET=wiznet,12345678,wiznet-01,60

  • Response:

    [OK]

---

• Format:

  AT+MQTTSET=?

• Meaning: Get Current Information of MQTT Connection and Authentication

• Response:

  <UserName>,<Password>,<ClientID>,<AliveTime> [OK]

---

AT+MQTTCON

• Format:

  AT+MQTTCON=<Con/Discon>,<BrokerIP>,<BrokerPort>,<SSL_Enable

  • Meaning: Implement MQTT to connect the Broker.

<Con/Discon>: MQTT Connection (Required)

Parameter	Meaning
0	Connect to the broker
1	Disconnect from the broker

<BrokerIP>: IP address of the broker (Optional)

• It can be used when the WizFi310 connect to broker
  <BrokerPort>: Broker Port (optional, default: 1883)
• It can be used when the WizFi310 connect to broker
  <SSL_Enable>: whether to enable secure connection (optional, default:

• It can be used when the WizFi310 connect to broker

Parameter	Meaning
0	Not to enable SSL connection
1	Enable SSL connection

Connection Examples)

• AT+MQTTCON=1,192.168.1.229,1883,0

• AT+MQTTCON=1,192.168.1.229,8883,1

  • Response: [MQTT CONNECT] [OK]

Disconnection Examples)

• AT+MQTTCON=0

  • Response:

    [MQTT DISCONNECT] [OK]

---

• Format:

  AT+MQTTCON=?

• Meaning: Get Current Connection Status

• Response:

  <Connection Status> [OK]

---

AT+MQTTSUB

• Format:

  AT+MQTTSUB=<Sub/Unsub>,<Topic

  • Meaning: Such topics will be pushed to the WizFi310 when received by the Broker,
    for example, wiznet/temp indicates that the WizFi310 has subscribed data (input data) sent by other clients.

<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)

• AT+MQTTSUB=1,wiznet/temp

• AT+MQTTSUB=0,wiznet/temp

  • Response:

    [OK]

---

AT+MQTTPUB

• Format:

  AT+MQTTPUB=<Topic>,<Length

  • Meaning: Publish the message to subscribed Client

<Topic>: Themes subscribed by the WizFi310 (Required, Max: 64 Character)
<Length>: Length of the message (Required)

• After using this command, You must input the message.

Examples)

• AT+MQTTPUB=wiznet/temp,3

  • Response:

    <Length> [OK]

---

GMMP Commands

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

• Format:

  AT+GMMPSET=<Con/Discon>,<ThingPlug IP>,<Thingplug Port>,<Domain Code>,<Auth ID>,<Manufacture ID>,<Device ID

  • Meaning: GMMP_GW_Registration 절차를 수행하기 위한 설정. 사전에 <https://sandbox.sktiot.com에서&#62; 디바이스(TCP) 등록이 되어 있어야 G/W, Device 등로 한다.
    ThingPlug의 IP, Port, Domain Code, WizFi310의 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)

• AT+GMMPSET=1,61.250.21.211,31002,ThingPlug,0008dc1e000000,WIZnet_GWMFID,WizFi310

  • Response: [GMMP CONNECT] [OK]

Disconnection Examples)

• AT+GMMPSET=0

  • Response:

    [GMMP DISCONNECT] [OK]

---

AT+GMMPDATA

• Format:

  AT+GMMPDATA=<Option>,<Data

  • Meaning: OMP로 보내고 싶은 데이터를 해당 AT command를 이용해서 설정할 수 있다.
    옵션에 따라 AT Command 이후 즉시 보내거나, 설정된 주기마다(AT+GMMPOPT로 설정) 데이터(Report type: Collect Data)를 보낼 수 있다.

Element	Example	Description
Option	0 or 1	0: 설정된 주기마다 보낼 데이터를 설정한다. 1: AT명령 즉시 데이터를 보낸다.
Data	DATA	데이터

Examples)

• AT+GMMPDATA=0,test data

• AT+GMMPDATA=1,test data

  • Response:

    [OK]

---

AT+GMMPOPT

• Format:

  AT+GMMPOPT=<Option>,<values

  • Meaning: GMMP 옵션을 설정하는 명령어이다. AT+GMMPOPT의 옵션에는 3가지가 있다.

<Option> = 10

• <Option> = 10은 이벤트 로그, 디버그 프린트를 설정하는 옵션이다.
• Examples) AT+GMMPOPT=10,<set>,<val1>,<val2

Element	Example	Description
set	0 or 1	0: 현재 설정된 값을 읽는다. 1: val1, val2의 값으로 설정한다.
val1	0 or 1	0: 이벤트 로그를 프린트 하지 않는다. 1: 이벤트 로그를 프린트 한다.
val2	0 or 1	0: 디버그 메세지를 프린트하지 않는다. 1: 디버그 메세지를 프린트 한다.

===<Option> = 11===

• <Option> = 11은 Heartbeat 패킷의 전송 주기(Heartbeat Period)이다.

Element	Example	Description
period	10	Heartbeat 패킷 전송 주기(단위: 분)

===<Option> = 12===

• <Option> = 12은 Delivery 패킷의 전송 주기(Report Period)이다.

• Examples) AT+GMMPOPT=12,<period

Element	Example	Description
period	10	Delivery 패킷 전송 주기(단위: 분)

---

Connecting ThingPlug Commands

ThingPlug는 SK Telecom의 IoT 플랫폼으로, oneM2M 표준 기반의 IoT 서비스를 제공합니다.

Connecting ThingPlug Example

---

AT+SKTPCON

• Format:

  AT+SKTPCON=< Con/Discon >,< ThingPlug IP >,< ThingPlug Port >,< Alive Time >, < ThingPlug Portal ID >,< Credential ID >,< Service ID >,< Version >,< Device ID >

  • Meaning: This command is used to connect to ThingPlug.

<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)

• AT+SKTPCON=1,mqtt.thingplug.net,1883,300,ThingPlug User ID,ThingPlug Credential ID,ThingPlug Service ID,v1_0,Registered Device ID

  • Response:

    [MQTT CONNECT] [OK]

---

AT+SKTPDEVICE

• Format:

  AT+SKTPDEVICE=<Register/Delete>,<Device ID>,<Device Authorization Code(AE-ID)

  • Meaning: Device register to ThingPlug.

<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)

• AT+SKTPDEVICE=1,Registered Device ID,Device Authorization Code(AE-ID)

  • Response:

    [OK]

---

AT+SKTPCONTAINER

• Format:

  AT+SKTPCONTAINER=<Register/Delete>,<Container Name

  • Meaning: Register the Container Name.

<Register/Delete>: Container Register/Delete to ThingPlug

Parameter	Meaning
0	Container Delete
1	Container Register

<Container Name>: Container Name

Examples)

• AT+SKTPCONTAINER=1,WIZnet

  • Response:

    [OK]

---

AT+SKTPSEND

• Format:

  AT+SKTPSEND=<Container Name>,<Data

  • Meaning: Sending the data to ThingPlug

<Container Name>: Container Name
<Data>: Data to send

• Data Format is TTV(Between Device Platform and ThingPlug Service Platform communication rule).

Examples)

• AT+SKTPSEND=WIZnet,010600000028

  • Response:

    [OK]

---

AT+SKTPCMD

• Format:

  AT+SKTPCMD=<Register/Delete>,<Management command

  • Meaning: Register the response command to management.

<Register/Delete>: Container Register/Delete to ThingPlug
^ Parameter ^ Meaning ^

0	Management command Delete
1	Management command Register

<Management command>: Response command to management

Examples)

• Response:

  [OK]

---

AT+SKTPRESULT

• Format:

  AT+SKTPRESULT=<Management command>,<Execute Status>,<Execute Result

  • Meaning: Publish the message to subscribed Client

<Management command>: Registered Management command
<Execute Status>: Execute status value
<Execute Result>: Execute result value

Examples)

• AT+SKTPRESULT=WIZnet_CMD,3,0

  • Response:

    [OK]

---

Command mode & Data mode

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.

Entering Data mode

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'.

Data transmission in Command mode

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.