User Tools

Site Tools


products:wiz550s2e:wiz550s2epg_en:atcomm

WIZ550S2E AT Command Set

This section provides a list of WIZ550S2E AT commands and their functions. Users can input commands and parameters through USART line.

Enter/Exit Command Mode

The command mode is entered by sending the “Trigger Code” (default 2B 2B 2B in Hex) to the serial port of the WIZ550S2E module.
This three byte Trigger Code need to be send without any character before and after the three byte = also without CR or LF for 500ms time.
The command mode is closed by sending “AT+MDATA/r/n”
The Trigger Code can be en/disabled and also changed with the config tool.

The three byte Trigger Code need to be isolated = without CR(0x0D), LF(0x0A)


Every command starts with “AT”. Any other initial character will cause an error in return. Commands and parameters are all ASCII characters, i.e. when you input 'AT+NSTAT', you should input ASCII characters 'A', 'T', '+', 'N', 'S', 'T', 'A', 'T' and 'Enter Key' which is CR, LF (0x0d, 0x0A).

All commands should be terminated with CR(0x0D), LF(0x0A)

Some parameters are mandatory and others are optional. Parameters must be entered in the order of format column given by the command tables. Although the optional parameter is not used, the comma delimiters ',' must still be included in the command. In most cases, valid commands return the character [S] and invalid inputs return [F]. The possible responses sent from WIZ550S2E to the user are described as Responses. Below are examples of user input. As you can see, WIZ550S2E return “\r\n” back instead of “\r”, which means user (host system) always handle '\r\n' as the only delimiter.

Input by UserAT\r\n (0x61 0x74 0x0d 0x0a)
Output from WIZ550S2E[S]\r\n (0x5b 0x53 0x5d 0x0d 0x0a)

Responses

Response Format

[(Type),(Id),(Param1),(Param2),(Param3),(Param4),(Param5),(Param6)]↓(Data)↓
  • (Type): Type of response. It can be one of S, D, F, W, R and V.
  • (Id): Socket Identifier. This is the mandatory in Async mode.
  • (Param1) ~ (Param6): ): These are included in case of commands retrieving module's setting value.
  • ↓: This means 'Enter' key as delimiter and CR, LF(0x0d, 0x0a) are its real value.
  • (Data): When huge data are needed, 'Data' will be followed in case of Type of response, D and R.


Responses are listed below.

Response Description
Success Response [S,(Id),(Param1),(Param2),(Param3),(Param4),(Param5),(Param6)]↓
Command Request Success, outputs with param when it's needed.
Success Dump Response [D,(Id),(Size)]↓(Data)↓
Command Request Success, Outputs large data include 'Enter key' value.
Fail Response [F,(Id),(ErrorCode),(ErrorParam)]↓
Command Request Fail, outputs with param when it's needed.
Wait Response [W,(Id)]↓
Command is started with ID in Async mode.
Data Receive Response [R,(SockId),(ReceivedSize),(SrcIP),(SrcPort)]↓(Data)↓
Outputs the received data.
Event Response [V,(Id),(EventCode)]↓
Event occurred.
  • (Id): 0 - System ID or 0~n - Socket Number
  • (Size): Byte size of the output data
  • (ErrorCode): Error Code
  • (ErrorParam): Value of description for Error Code
  • (SockId): Socket Identifier of the socket which received data
  • (ReceivedSize): Byte size of received data
  • (SrcIP): Sender's IP address. This is mandatory in case of UDP & TCP Client. In case of TCP Server this is omitted.
  • (SrcPort): Sender socket's port number. This is mandatory in case of UDP & TCP Client.In case of TCP Server this is omitted.
  • (EventCode): Indication of which event happened.


Error Code

General Error Code

Code Error Name Description
0 ERR_Undefined Undefined Error
1 ERR_WrongOperator Wrong Operator
2 ERR_WrongCommandSign Wrong Command Sign
3 ERR_WrongArguments Wrong Arguments
4 ERR_OurofRange Parameter is out of Range
5 ERR_FuncDisabled This function is disabled
6 ERR_NotAllowed Not Allowed
7 ERR_CommandBusy Command Busy
8 ERR_CommandTimeout Command Timeout

Socket Error Code

Code Error Name Description
10 ERR_SockNotAvail Socket Not Available
11 ERR_SockClosed Socket Closed
12 ERR_SockPortNumNotAvail Port Not Available
13 ERR_SockNotConnected Not Connected
14 ERR_SockWrongAddr Wrong Address
15 ERR_SockDataNotAvailable Data Not Available

Other Error Code

Code Error Name Description
20 ERR_NoFreeMem No Free Memory


Event Code

Socket Event Code

Code Socket Event Name Description
0 EVENT_SockConnected Connected. Socket transition from Listen state to established state
1 EVENT_SockDisconnected Disconnected. Socket transition from established state to disconnected state
2 EVENT_SockClosed Closed. Socket transition to closed state
3 EVENT_SockDataRcvd Data Received. The corresponding socket received data from its peer

Network Commands

Command Prop. Input Parameter Response
AT+NSET None or ? [S,,S,(IP),(SN),(GW),(DNS)]
[S,,D]
= S,(IP),(SN),(GW),(DNS) [S]
D [S]
- num,Param [S]
AT+NSTAT None or ? [S,,S/D,(IP),(SN),(GW),(DNS)]
AT+NMAC None or ? [S,,(MAC)]
= (MAC) [S]
AT+NOPEN = S/C/U,(SrcPort),(DstIP),(DstPort) [W,(SockId)]
[S,(SockId)]
A
AT+NCLOSE = (SockId) [W,(SockId)]
[S,(SockId)]
AT+NSEND = (SockId),(size),(DstIP),(DstPort) [W,(SockId)]
[S,(SockId)]
AT+NSOCK None or ? [D,,(Size)]↓(Data)
= (SockId) [S,,S/C/U,(SrcPort),(DstIP),(DstPort)]
AT+NMODE = S/C/U/M,(SrcPort),(DstIP),(DstPort) [S]

AT+NSET





  • Format:
AT+NSET=<DHCP>,<IP>,<SN>,<GW>,<DNS>
  • Meaning: Network Configuration

<DHCP>: Static/DHCP

Parameter Meaning
S DHCP Off, Static
D DHCP On, DHCP Client

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

  • Response:
[S]
  • Example 1:
AT+NSET\r\n
AT+NSET?\r\n
  • Meaning: Get Current Network Setting

Note that <IP>,<SN>,<GW>,<DNS> address of response are not actual addresses, but addresses stored in the memory. So when DHCP is on, they are usually different from actual addresses.

  • Response:
[S,,S,192.168.11.100,255.255.255.0,192.168.11.1,8.8.8.8]
[S,,D]
  • Example 2:

AT+NSET-2,192.168.11.110\r\n

  • Meaning: Update Second Parameter

  • Response:

[S]


AT+NSTAT





  • Format:
AT+NSTAT
AT+NSTAT?
  • Meaning: Display Current Network Status
  • Response:
[S,,<DHCP>,<IP>,<SN>,<GW>,<DNS>]
  • Example 1:

AT+NSTAT\r\n
AT+NSTAT?\r\n

  • Meaning: Display Current Network Status
  • Response:

[S,,S,192.168.11.100,255.255.255.0,192.168.11.1,8.8.8.8]
[S,,D]


AT+NMAC





  • Format:
AT+NMAC
AT+NMAC?
  • Meaning: Get MAC Address
  • Response:
[S,,<MAC>]
  • Example 1:

AT+NMAC=00:08:dc:1d:bb:8b\r\n

  • Meaning: Set MAC Address
  • Response:

[S]

  • Example 2:

AT+NMAC\r\n
AT+NMAC?\r\n

  • Meaning: Get MAC Address
  • Response:

[S,,00:08:dc:1d:bb:8a]


AT+NOPEN





  • Format:
AT+NOPEN=<SockType>,<SrcPort>,<DstIP>,<DstPort>
  • Meaning: Initialize Socket

<SockType>: Socket Type

Parameter Meaning
S TCP Server Socket
C TCP Client Socket
U UDP Socket

<SrcPort>: Local Port Number
<DstIP>: Destination IP Address
<DstPort>: Destination Port Number

  • Response:
[W,(SockId)]
[S,(SockId)]
  • Example 1:

AT+NOPEN=C,3000,192.168.11.100,3000\r\n

  • Meaning: Create TCP Client Socket
  • Response:

[W,0]
[S,0]
[W,0]
[F,,1]

  • Example 2:

AT+NOPEN=S,5000,,\r\n

  • Meaning: Create TCP Server Socket
  • Response:

[S,,0]


AT+NCLOSE





  • Format:
AT+NCLOSE=(SockId)
  • Meaning: Close Socket

<SockId>: Socket ID

  • Response:
[W,(SockId)]
[S,(SockId)]
  • Example 1:

AT+NCLOSE\r\n

  • Meaning: Close Socket
  • Response:

[W,0]
[S,0]
[F,,11]


AT+NSEND





  • Format:
AT+NSEND=<SockId>,<size>,<DstIP>,<DstPort>
  • Meaning: Send Data

<SockId>: Socket ID

Parameter Meaning
S TCP Server Socket
C TCP Client Socket
U UDP Socket

<SrcPort>: Local Port Number
<DstIP>: Destination IP Address
<DstPort>: Destination Port Number

  • Response:
[W,(SockId)]
[S,(SockId)]
  • Example 1:

AT+NSEND=0,4\r\n
aaaa

  • Meaning: In TCP Server mode, Destination IP and port are not need.
  • Response:

[W,0]
[S,0]


AT+NMODE




  • Notice:

This feature has been added to v1.0.3 and v1.1.5 has been renamed AT + MMODE.

  • Format:
AT+NSOCK=S/C/U/M,<SrcPort>,<DstIP><DstPort>,
  • Meaning: Change the network information of the module (automatically saved in EEPROM)

S/C/U/M: Network Mode
S = Server, C = Client, U = UDP, M = Mixed TCP(Server/Client)

  • Response:
[S]

  • Example 1: To change the network information of the module to Client, Local Port 5000, Server IP 192.168.0.3, Remote Port 5000

AT+NMODE=C,5000,192.168.0.3,5000\r\n

  • Meaning: Change & save network information of module to client, local port 5000, server IP 192.168.0.3, remote port 5000
  • Response:

[S]


Management Commands

Command Prop. Input Parameter Response
AT None [S]
? [D,,(Size)]↓(Data)
AT+MSTAT None or ? [S,,(Version)]
AT+MUSART None or ? [S,,(BR),(W),(P),(S),(F)]
= (BR),(W),(P),(S),(F) [S]
- num,Param [S]
AT+MSAVE None [S]
AT+MRST None [S]
= F [S]
AT+MDATA None [S]

AT





  • Format:
AT
  • Meaning: Terminal Check
  • Response:
[S]

AT+MSTAT





  • Format:
AT+MSTAT
AT+MSTAT?
  • Meaning: Get Current Version
  • Response:
[S,,<Version>]

AT+MUSART





  • Format:
AT+MUSART=<BR>,<W>,<P>,<S>,<F>
  • Meaning: Serial Interface Configuration

<BR>: Baud rate

Parameter Meaning
300 300bps
600 600bps
1200 1200bps
2400 2400bps
4800 4800bps
9600 9600bps
19200 19200bps
38400 38400bps
57600 57600bps
115200 115200bps
230400 230400bps

<W>: Word length

Parameter Meaning
7 7 bits
8 8 bits

<P>: Parity bit

Parameter Meaning
N NONE
O ODD
E EVEN

<S>: Stop bit

Parameter Meaning
1 1 bits
2 2 bits

<F>: Flow Control

Parameter Meaning
0 NONE
1 RTS/CTS
2 RS422
3 RS485
  • Response:
[S,,<BR>,( <W>, <P>, <S> ) <F>]

  • Example1:
AT+MUSART
AT+MUSART?
  • Meaning: Get Serial Interface Information
  • Response:
[S,,<BR>,( <W>, <P>, <S> ) <F>]
  • Example2:
AT+MUSART=,,E,,0
  • Meaning: Set Serial Interface Information
  • Response:
[S]

AT+MRST





  • Format:
AT+MRST
  • Meaning: Reset the module.
  • Response:
[S]



AT+MDATA





  • Format:
AT+MDATA
  • Meaning: Terminal Check - exit AT Command mode
  • Response:
[S]



AT+MSAVE





  • Format:
AT+MSAVE
  • Meaning: Save the setting value.

The values set via AT+MUSART, AT+NSET (except AT+NMAC) are basically only until the module is reset. (In Data Mode, the corresponding setting value is shared. Check through Search in Configuration Tool) In other words, when module is reset, it returns to the value before setting. However, the user can save the set value through the corresponding command (AT+MSAVE) so that the module does not change even if it is reset. That is, it is the same as Setting function in Configuration Tool.

  • Response:
[S]



Function Commands

Command Prop. Input Parameter Input Resp. Query Response
AT+FDNS None [D,,(Size)]↓(Data)

AT+FDNS





  • Format:
AT+FDNS
  • Meaning: Do DNS Query and then return its result. Using Domain and DNS Server IP what has set via Configuration Tool.
  • Response:
[D,,13]
DNS Timeout
[D,,17]
173.194.126.180
products/wiz550s2e/wiz550s2epg_en/atcomm.txt · Last modified: 2018/04/19 14:35 by ricky