Skip to main content

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 UserATr (0x61 0x74 0x0d)
Output from WizFi310ATrn[OK]rn (0x61 0x74 0x0d 0x0a 0x5b 0x4f 0x4b 0x5d 0x0d 0x0a) (- โ€œATrnโ€ is Echo back of user input)

Responses#

Responses are listed below.

ResponseMeaning
[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
ATTerminal Check
WiFi Commands
AT+WJOINWiFi Association
AT+WLEAVEWiFi Disassociation
AT+WSCANWiFi Scan
AT+WSETWiFi SSID Configuration
AT+WSET2WiFi SSID Configuration for special Chars
AT+WSECWiFi Security Configuration
AT+WNETNetwork Configuration
AT+WSTATGet Current WiFi Status
AT+WWPSWiFi WPS Connection
AT+WADNSAdd DNS Server
Network Commands
AT+SCONSocket Open/Connect
AT+SMGMTSocket Management
AT+SSENDData Send
AT+SDATAReturn to Data Mode
AT+SFORMDefine Data Receive Header Form
AT+SOPTS2W Socket Option
AT+SOPT1S2W miscellaneous option
Management Commands
AT+MPROFProfile Management
AT+MFDEFPerform Factory Reset
AT+MRESETPerform System Reset
AT+MMSGSet Message Print Level
AT+MMACSet MAC Address
AT+MINFOGet System Information
AT+MECHOSet Echo Mode
AT+MHELPPrint Command Description and Usage
AT+MMCUPSMCU Power Save Enable/Disable
AT+MWIFIPSWi-Fi Power Save Enable/Disable
AT+USETUART Configuration
AT+MCUSTOMCustom code
AT+MAIRCMDAir Command Configuration
AT+MEVTMSGPrint [Listen x] as soon as it opens up a socket through TCP server.
AT+MEVTFORMEvent Message Form
AT+MUPGRADEFirmware upgrade using serial
Function Commands
AT+FPINGPING Test
AT+FDNSDNS Query
AT+FGPIOGPIO Control
AT+FGETADCRead ADC value
AT+FSOCKSOCKET Extension Option
AT+FOTALaunch OTA Mode

Available Protocol

MQTT Commands
AT+MQTTSETMQTT Configuration
AT+MQTTCONMQTT Connect/Disconnect
AT+MQTTSUBMQTT Subscribe
AT+MQTTPUBMQTT Publish
GMMP Commands
AT+GMMPSETGMMP Configuration, Connect/Disconnect
AT+GMMPDATAGMMP Data Send
AT+GMMPOPTGMMP Option Management
Connecting ThingPlug Commands
AT+SKTPCONConnecting authorization, Connect/Disconnect
AT+SKTPDEVICEDevice registration
AT+SKTPCONTAINERContainer Create
AT+SKTPSENDData sending to ThingPlug
AT+SKTPCMDCommand registration to ThingPlug
AT+SKTPRESULTResponse 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.

ParameterMeaning
0Set Wi-Fi mode as STA mode
1Set Wi-Fi mode as AP mode

<SSID>: Target/Own SSID (Required, Max: 32 Character)

ModeMeaning
STAThe SSID of target AP
APIts own SSID

<BSSID>: Target BSSID (Optional, Form: xx:xx:xx:xx:xx:xx)

ModeMeaning
STAThe BSSID of target AP
APNot used. if any, it will be ignored

<Channel>: Target/Own Channel (Optional)

ModeMeaning
STAIn STA mode, the Channel of target AP
APIn 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.

ParameterMeaning
0Set Wi-Fi mode as STA mode
1Set Wi-Fi mode as AP mode

<SSID>: Target/Own SSID (Required, Max: 32 Character)

ModeMeaning
STAThe SSID of target AP
APIts 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)

ParameterMeaning
0Set Wi-Fi mode as STA mode
1Set Wi-Fi mode as AP mode

<SecType>: Security type (Optional)

ParameterMeaning
OPENNone
WiFi Auto Security
WEPWEP (* Not support at SoftAP mode)
WPAWPA1 - TKIP
WPAAESWPA1 - AES
WPA2AES WPA2 - AES
WPA2TKIPWPA2 - TKIP
WPA2WPA2 - Mixed

<Key>: Security key value

MethodLength
WEP5 or 13 (ASCII), 10 or 26 (HEX)
WPA8 ~ 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)

ParameterMeaning
0DHCP Off, Static
1DHCP On, DHCP Client
ModeMeaning
STADHCP Client On/Off
APNot used. if any, it will be ignored

<IP>: IP Address (Optional) <SN>: Subnet Mask (Optional) <GW>: Gateway Address (Optional)

ModeMeaning
STAAP(Router) gateway address
APNot 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)

ParameterMeaning
0WPS_PBC_MODE
1WPS_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)

ParameterMeaning
Oopen at Once
Sregister as a Service
SOopen 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)

ParameterMeaning
TSNTCP Server Normal
TCNTCP Client Normal
TCSTCP Client Secured
USNUDP Server Normal
UCNUDP 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

ProtocolParameter Application
TCP ServerN/A
TCP ClientRequired
UDP ServerOptional
UDP ClientRequired

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

ParameterMeaning
0Open as Command mode
1Open 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)

ParameterMeaning
0 ~ 7The socket ID to close
ALLAll 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

ProtocolParameter Application
TCP ServerN/A
TCP ClientN/A
UDP ServerOptional
UDP ClientOptional
  • 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'.

OrderMeaning
0Header Start
1Socket ID
2Delimiter
3Remote IP Address
4Remote Port Number
5Data Length
6Header End
7Data End 1/2
8Data 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)
OptionValue
1Set socket option
2Get socket option

<SocketID>: Socket ID (Required)

<Socket Level>: Socket Level (Required)

Socket LevelValue
4095SOL_SOCKET
0IPPROTO_IP
6IPPROTO_TCP
17IPPROTO_UDP
136IPPROTO_UDPLITE

<Option Name> : Option name for socket level options for level SOL_SOCKET

Option NameValue
4SO_REUSEADDR
8SO_KEEPALIVE

options for level IPPROTO_IP

Option NameValue
1IP_TOS
2IP_TTL

options for level IPPROTO_TCP

Option NameValue
1TCP_NODELAY
2TCP_KEEPALIVE
3TCP_KEEPIDLE
4TCP_KEEPINTVL
5TCP_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)

OptionValue
10Escape 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=&#60;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)

ParameterMeaning
VDGet saved profile
VGGet current profile
LLoad profile
SSave 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)

ParameterMeaning
1Not Print Responses
2Print Responses, Events (Default)
3Print 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=&#60;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=&#60;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 ^

0Echo Off
1Echo 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)

ParameterMeaning
0Wi-Fi Power Save Mode Disable
1Wi-Fi Power Save Mode Enable
2Enables 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.

ActionApplication
0N/A
1N/A
2Required
  • 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 valueMeaning
0Wi-Fi Power Save Mode Disable
1Wi-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)

ParameterMeaning
300300 bps
600600 bps
12001200 bps
24002400 bps
48004800 bps
96009600 bps
1440014400 bps
1920019200 bps
3840038400 bps
5760057600 bps
115200115200 bps
230400230400 bps
460800460800 bps
921600921600 bps
18432001843200 bps

<Parity>: Set the Parity-Bit type. (Required)

ParameterMeaning
NNone
OOdd
EEven

<WordLen>: Set the Word-Length. (Required)

ParameterMeaning
77 bits
88 bits

<StopBit>: Set the Stop-Bit. (Required)

ParameterMeaning
11 bits
22 bits

<FlowCon>: Set the Flow-Control method. (Required)

ParameterMeaning
NNone
HWHardware 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)

ParameterMeaning
Oopen at Once
Sregister 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)

ParameterMeaning
TTCP Server Normal
UUDP 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 ^

0No display [Listen x] message
1Display [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)
aWizFi310 Version 1.0.0.6 (WIZnet Co.Ltd)rnrn[0]rn
brn[CONNECT %x]rnrn[1]rn
crn[DISCONNECT %x]rnrn[2]rn
drn[Link-Up Event]rn
IP Addr : ...rn
Gateway : ...rn
rn[3]rn
ern[Link-Down Event]rnrn[4]rn
frn[Reset Event]rnrn[5]rn
grn[TCP Send Error]rnrn[6]rn
hrn[P2P Fail Event]rnrn[7]rn
irn[LISTEN %x]rnrn[8]rn
jrn[MQTT CONNECT]rnrn[9]rn
krn[MQTT DISCONNECT]rnrn[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=&#60;HostName&#62;,&#60;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+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 valueMeaning
3GPIOB 3
4GPIOC 4

<action>: The action to perform (Required)

Return valueMeaning
0GPIO Initialize as a Input mode
1GPIO Initialize as a Output mode
2Get GPIO value of <gpio_number>
3Set GPIO value of <gpio_number>

<config_value>: Current GPIO Configuration Value (It can be used when action is 0, 1)

Return valueMeaning
0PULL_NONE (Not use pull-up & pull-down resistor)
1PULL_UP (Input with an internal pull-up resistor)
2PULL_DOWN (Input with an internal pull-down resistor)
3OPEN_DRAIN (Output open drain)

<gpio_value>: Current GPIO Value (It can be used when action is 2, 3)

Return valueMeaning
0Low
1High

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=&#60;Option&#62;,&#60;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)

ParameterMeaning
1TCP Send error timeout (value : 2000~20000ms)
6Recreates Socket then attempts Auto-Reconnection after <Value> seconds (value: 10~1000)
8Automatically 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=&#60;Server IP&#62;,&#60;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)

ParameterMeaning
0Connect to the broker
1Disconnect 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: 0)
  • It can be used when the WizFi310 connect to broker
ParameterMeaning
0Not to enable SSL connection
1Enable 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)

ParameterMeaning
0Unsubscribe the topic
1Subscribe 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์—์„œ>; ๋””๋ฐ”์ด์Šค(TCP) ๋“ฑ๋ก์ด ๋˜์–ด ์žˆ์–ด์•ผ G/W, Device ๋“ฑ๋กœ ํ•œ๋‹ค.
      ThingPlug์˜ IP, Port, Domain Code, WizFi310์˜ Auth ID, Manufacture ID, Device ID๋ฅผ ์„ค์ •ํ•œ๋‹ค.
ElementExampleDescription
Con/Discon1 or 01: GMMP_GW_Registration๊ณผ GMMP_Delivery๋ฅผ ์ˆ˜ํ–‰ํ•œ๋‹ค. GMMP_Delivery๋Š” AT+GMMPDATA๊ฐ€ ์„ค์ •๋˜์–ด์žˆ์–ด์•ผ ํ•œ๋‹ค.
0: GMMP_Delivery๋ฅผ ์ค‘์ง€ํ•œ๋‹ค.
ThingPlug IP61.250.21.211ThingPlug์˜ IP๋ฅผ ์ž…๋ ฅํ•œ๋‹ค.
ThingPlug Port31002ThingPlug์˜ TCP Listen Port๋ฅผ ์ž…๋ ฅํ•œ๋‹ค.
ThingPlug->๋งˆ์ดํŽ˜์ด์ง€->์„œ๋น„์Šค ์ •๋ณด์ˆ˜์ •์—์„œ ํ™•์ธ ๊ฐ€๋Šฅ
Domain CodeThingPlugThingPlug์˜ ์„œ๋น„์Šค๋ช…์„ ์ž…๋ ฅํ•œ๋‹ค.
ThingPlug->๋งˆ์ดํŽ˜์ด์ง€->์„œ๋น„์Šค ์ •๋ณด์ˆ˜์ •์—์„œ ํ™•์ธ ๊ฐ€๋Šฅ
Auth ID0008dc1e000000GW ID, ๋””๋ฐ”์ด์Šค ๋“ฑ๋ก์‹œ ์ž…๋ ฅํ•œ MAC Address๋ฅผ ์ž…๋ ฅํ•œ๋‹ค.
ThingPlug->๋””๋ฐ”์ด์Šค ์ •๋ณด->๋””๋ฐ”์ด์Šค ์กฐํšŒ์—์„œ ํ™•์ธ ๊ฐ€๋Šฅ
Manufacture IDWIZnet_GWMFID์ œ์กฐ์‚ฌ ID๋ฅผ ์ž…๋ ฅํ•œ๋‹ค.
ThingPlug->๋””๋ฐ”์ด์Šค ์ •๋ณด->๋””๋ฐ”์ด์Šค ์กฐํšŒ์—์„œ ํ™•์ธ ๊ฐ€๋Šฅ
Device IDdeviceID๋””๋ฐ”์ด์Šค 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)๋ฅผ ๋ณด๋‚ผ ์ˆ˜ ์žˆ๋‹ค.
ElementExampleDescription
Option0 or 10: ์„ค์ •๋œ ์ฃผ๊ธฐ๋งˆ๋‹ค ๋ณด๋‚ผ ๋ฐ์ดํ„ฐ๋ฅผ ์„ค์ •ํ•œ๋‹ค.
1: AT๋ช…๋ น ์ฆ‰์‹œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ณด๋‚ธ๋‹ค.
DataDATA๋ฐ์ดํ„ฐ
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

    ElementExampleDescription
    set0 or 10: ํ˜„์žฌ ์„ค์ •๋œ ๊ฐ’์„ ์ฝ๋Š”๋‹ค.
    1: val1, val2์˜ ๊ฐ’์œผ๋กœ ์„ค์ •ํ•œ๋‹ค.
    val10 or 10: ์ด๋ฒคํŠธ ๋กœ๊ทธ๋ฅผ ํ”„๋ฆฐํŠธ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
    1: ์ด๋ฒคํŠธ ๋กœ๊ทธ๋ฅผ ํ”„๋ฆฐํŠธ ํ•œ๋‹ค.
    val20 or 10: ๋””๋ฒ„๊ทธ ๋ฉ”์„ธ์ง€๋ฅผ ํ”„๋ฆฐํŠธํ•˜์ง€ ์•Š๋Š”๋‹ค.
    1: ๋””๋ฒ„๊ทธ ๋ฉ”์„ธ์ง€๋ฅผ ํ”„๋ฆฐํŠธ ํ•œ๋‹ค.
    ===<Option> = 11===
  • <Option> = 11์€ Heartbeat ํŒจํ‚ท์˜ ์ „์†ก ์ฃผ๊ธฐ(Heartbeat Period)์ด๋‹ค.

ElementExampleDescription
period10Heartbeat ํŒจํ‚ท ์ „์†ก ์ฃผ๊ธฐ(๋‹จ์œ„: ๋ถ„)

===<Option> = 12===

  • <Option> = 12์€ Delivery ํŒจํ‚ท์˜ ์ „์†ก ์ฃผ๊ธฐ(Report Period)์ด๋‹ค.

  • Examples) AT+GMMPOPT=12,<period

ElementExampleDescription
period10Delivery ํŒจํ‚ท ์ „์†ก ์ฃผ๊ธฐ(๋‹จ์œ„: ๋ถ„)

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

ParameterMeaning
0Disconnect to the ThingPlug
1Connect 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

ParameterMeaning
0Device Delete
1Device 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=&#60;Register/Delete&#62;,&#60;Container Name
    • Meaning: Register the Container Name.

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

ParameterMeaning
0Container Delete
1Container 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 ^

0Management command Delete
1Management 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.