Wiznet WizFi210 Manual

WizFi210 Programmers’ Guide
(Version 1.20)
WizFi220 operates same as described in this documents
©2013 WIZnet Co., Ltd. All Rights Reserved.
☞ For more information, visit our website at http://www.wiznet.co.kr

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
Certification Information
CE for Class B ITE
INFORMATION TO THE USER
Hereby, WIZnet. Declares that these WizFi210 and WizFi220 are in compliance with the
essential requirements
and other relevant provisions of directive 1999/5/EC.
WARNING: These are the class B products. In a domestic environment this product may cause
radio interference in which case the user may be required to take adequate measures.
FCC for Class B ITE
INFORMATION TO THE USER
These equipments have been tested and found to comply with the limits for a Class B digital
device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable
protection against harmful interference in a residential installation. This equipment generates,
uses and can radiate radio frequency energy and, if not installed and used in accordance with
the instructions, may cause harmful interference to radio communications. However, there is no
Guarantee that interference will not occur in a particular installation. If this equipment does
cause harmful interference to radio or television reception, which can be determined by turning
the equipment off and on, the user is encouraged to try to correct the interference by one more
of the following measures:
- Reorient or relocate the receiving antenna.
- Increase the separation between the equipment and receiver.
- Connect the equipment into an outlet on a circuit different from that to which the
receiver is connected.
- Consult the dealer or an experienced radio/TV technician for help.
WARNING: These equipments may generate or use radio frequency energy. Changes or
modifications to this equipment may cause harmful interference unless the modifications are
expressly approved in the instruction manual. The user could lose the authority to operate this
equipment if an unauthorized change or modification is made.
TELEC
KCC for Class B ITE
INFORMATION TO THE USER
이 기기는 가정용(B급) 으로 전자파 적합등록을 한 기기로서 주거지역에서는 물론 모든
지역에서 사용할 수 있습니다.
- Trade Name or Applicant : WIZnet Co., Ltd.
- Equipment Name : Wireless LAN Module
- Model Number : WizFi210 / WizFi220
- Manufacturer / Country of Origin : WIZnet, Co., Ltd. / KOREA
- Certification Number : KCC-CRM-WWW-WIZFI210 / KCC-CRM-WWW-WIZFI220
WARNING: 해당 무선설비는 운용 중 전파혼신의 가능성이 있으므로 인명안전과 관련된
서비스는 할 수 없습니다.
Equipment : Wireless Module
Model : WizFi210 UFL antenna type, WizFi210 Chip antenna type
Made in Korea
010-100040

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
Document Revision History
Date
Revision
Changes
2011-03-24
V1.0
Official Release
2011-05-24
V1.01
Changed Power Consumption and RF Output Power
Added Auto Reconnect AT Command(AT+XAR)
Added Certification Information
2011-09-05
V1.10
Changed Evaluation Board
Changed GPIO number(HW Trigger, Button)
Changed AT+XEHT Command
Added Limited AP Feature
Added WizFi220 Specs
2012-01-11
V1.11
Added UART baud rate(460800, 921600bps)
Added EXT_nRESET description
Added FAQ
Added AT+DHCPSRVR Command
Added Product contents
2012-10-24
V1.12
Added AT+WAUTO Option(2 for Limited AP mode)
Added FAQ(Reducing the disassociation event)
Removed unused AT Commands
Removed some features for customizing f/w
2013-03-08
V1.13
Added AT+XRESET Command
Added max/min power value of AT+WP command
2013-03-12
V1.14
Added explanation of AT+XRESET Command
Added FAQ
2013-05-06
V1.2
Divided two documents, Datasheet for Hardware Engineer
and Programmers’ guide for Software Engineer.
More detail information included in datasheet.
Information in this document is belived to be accurate and reliable. However, WIZnet does
not give any representations or warranties, expressed or implied, as to the accuracy or
completeness of such information and shall have no liability for the consequences of use of
such information.
WIZnet reserves the right to make changes to information published in this document,
including without limitation specifictions and product descriptions, at any time and without
notice. This document supersedes and replaces all information supplied prior to the
publication hereof.

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
<Contents>
1. Overview ...................................................................................................................... 1-1
2. AT Command Set ......................................................................................................... 2-1
2.1. AT command category and description .................................................................... 2-3
2.1.1. Basic commands ............................................................................................... 2-3
2.1.2. UART / Adapter interface configuration ............................................................ 2-3
2.1.3. Profile management .......................................................................................... 2-5
2.1.4. WiFi interface .................................................................................................... 2-5
2.1.5. WiFi security .................................................................................................... 2-10
2.1.6. Wireless configuration ..................................................................................... 2-13
2.1.7. Network interface ............................................................................................ 2-15
2.1.8. Connection management ................................................................................ 2-16
2.1.9. Battery check .................................................................................................. 2-22
2.1.10. Power state management ........................................................................... 2-23
2.1.11. Auto connection .............................................................................................. 2-23
2.1.12. Provisioning ................................................................................................. 2-25
2.1.13. Miscellaneous .............................................................................................. 2-25
2.1.14. Network Connection Manager(NCM) .......................................................... 2-30
2.1.15. Summary of commands supported by firmware version ............................. 2-32
3. Communication Interface ........................................................................................... 3-36
3.1. UART ...................................................................................................................... 3-36
3.2. SPI .......................................................................................................................... 3-36
3.2.1. Pin connections for SPI ................................................................................... 3-36
3.2.2. SPI interface details ........................................................................................ 3-37
3.2.3. Host Wake-Up Signal Handling....................................................................... 3-38
3.2.4. SPI data handling ............................................................................................ 3-38
3.2.5. SPI Interface Parameters ................................................................................ 3-39
4. Command mode & Data mode .................................................................................. 4-41
4.1. AT command mode ................................................................................................ 4-41
4.2. Data mode .............................................................................................................. 4-41
4.3. Data communication in AT command mode ........................................................... 4-41
4.3.1. Data Handling ................................................................................................. 4-41
4.3.2. Escape Sequences ......................................................................................... 4-42
5. Using multi sockets .................................................................................................... 5-46
5.1. Associate with AP. .................................................................................................. 5-46
5.1.1. TCP Client multi-connections .......................................................................... 5-46
5.1.2. TCP Server multi-connections ........................................................................ 5-48
6. Operation Mode ......................................................................................................... 6-49
6.1. Station Mode .......................................................................................................... 6-49
6.2. Limited AP Mode .................................................................................................... 6-49
7. Using Factory default provisioning ............................................................................. 7-51
7.1. Factory default #1 : <Limited AP & Web configuration> ........................................ 7-51
7.1.1. Changing mode to <Limited AP & Web mode> .............................................. 7-51
7.1.2. Connect to the WizFi210 (Limited AP) ............................................................ 7-52
7.1.3. Connect to the Web server ............................................................................. 7-53
7.2. Factory default #2 : <Ad-hoc Configuration> ......................................................... 7-55
7.2.1. Changing mode to <ad hoc & Configuration-Tool mode> ............................ 7-55
7.2.2. Connecting to the WizFi210 with ad-hoc mode .............................................. 7-55
8. Transmitting and Receiving HTML Data .................................................................... 8-57
8.1. Operating as HTTP Client using WizFi210 functions ............................................. 8-57
8.1.1. Communicating with Web Server using normal HTTP ................................... 8-57
8.1.2. Communicating with Secure Web Server using HTTPS ................................. 8-58
8.2. Emulating HTTP Server or HTTP Client ................................................................ 8-60
8.2.1. Emulating HTTP Server .................................................................................. 8-61
8.2.2. Emulating HTTP Client.................................................................................... 8-61

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
8.3. Making and Testing the environment for HTTP Server .......................................... 8-63
8.3.1. Configuring the Environment for Web Server Test.......................................... 8-63
8.3.2. HTTP Protocol for Web Server Test ................................................................ 8-64
8.3.3. Example of AT commands for configuring HTTP Server ................................ 8-65
9. Using Enterprise Security .......................................................................................... 9-67
9.1. EAP-TLS ................................................................................................................ 9-67
9.1.1. Connect to RADIUS Server using WizFi210 ................................................... 9-67
10. Examples ................................................................................................................. 10-69
10.1. Station Mode, TCP Client and Auto Connection .................................................. 10-69
10.1.1. Example 1 of commands sequence .......................................................... 10-69
10.1.2. Example 2 of commands sequence .......................................................... 10-71
10.1.3. exchanging data with a peer system ......................................................... 10-71
10.1.4. Closing TCP connection ............................................................................ 10-71
10.2. Station Mode, UDP socket and Auto Connection ................................................. 10-72
10.3. Station Mode and Multi sockets ........................................................................... 10-73
10.3.1. Example of commands sequence ............................................................. 10-73
10.3.2. Exchanging data with a peer system......................................................... 10-74
10.3.3. Closing TCP connection and UDP socket ................................................. 10-74
10.4. Limited AP, TCP Server and Auto Connection ..................................................... 10-75
10.4.1. Example of commands sequence ............................................................. 10-75
10.4.2. Exchanging data with a peer system......................................................... 10-76
10.4.3. Closing TCP connection and UDP socket ................................................. 10-76
10.5. Limited AP and Multi sockets ............................................................................... 10-77
10.5.1. Example of commands sequence ............................................................. 10-77
10.5.2. Exchanging data with a peer system......................................................... 10-78
10.5.3. Closing TCP connection and UDP socket ................................................. 10-78

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
<Table>
TABLE 1 LIST OF RESPONSE FOR AT COMMANDS ................................................................................................. 2-2
TABLE 2 BASIC COMMANDS.................................................................................................................................................. 2-3
TABLE 3 UART/ADAPTER INTERFACE COMMANDS ................................................................................................ 2-4
TABLE 4 LIST OF COMMANDS FOR PROFILE MANAGEMENT........................................................................... 2-5
TABLE 5 LIST OF COMMANDS FOR WIFI INTERFACE ............................................................................................ 2-9
TABLE 6 LIST OF COMMANDS FOR WIFI SECURITY ............................................................................................ 2-13
TABLE 7 LIST OF COMMANDS FOR WIRELESS(RF) CONFIGURATION ..................................................... 2-15
TABLE 8 LIST OF COMMANDS FOR NETWORK INTERFACE ........................................................................... 2-16
TABLE 9 LIST OF COMMANDS FOR CONNECTION MANAGEMENT ............................................................ 2-21
TABLE 10 LIST OF COMMANDS FOR BATTERY CHECK ..................................................................................... 2-22
TABLE 11 LIST OF COMMANDS FOR POWER STATE MANAGEMENT ........................................................ 2-23
TABLE 12 LIST OF COMMANDS FOR AUTO CONNECTION .............................................................................. 2-25
TABLE 13 LIST OF COMMANDS FOR PROVISIONING.......................................................................................... 2-25
TABLE 14 LIST OF COMMANDS FOR MISCELLANEOUS .................................................................................... 2-29
TABLE 15 LIST OF COMMANDS FOR NETWORK CONNECTION MANAGER .......................................... 2-31
TABLE 16 AT COMMAND LIST ............................................................................................................................................. 2-35
TABLE 17 PIN DESCRIPTION OF SPI INTERFACE .................................................................................................. 3-37
TABLE 18 TIMING INFORMATION OF SPI INTERFACE ......................................................................................... 3-38
TABLE 19 BYTE STUFFING FOR SPECIAL DATA OF SPI..................................................................................... 3-39
TABLE 20 ESCAPE SEQUENCE FOR SENDING DATA IN COMMAND MODE .......................................... 4-43
TABLE 21 ESCAPE SEQUENCE FOR RECEIVING DATA IN COMMAND MODE ...................................... 4-45

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
<Figure>
FIGURE 1 PIN CONNECTION FOR SPI BETWEEN HOST AND WIZFI210 .................................................. 3-36
FIGURE 2 TIMING DIAGRAM OF SPI INTERFACE ................................................................................................... 3-37
FIGURE 3 COMMANDS SET FOR ASSOCIATING WITH AP WHEN USING MULTI SOCKETS ......... 5-46
FIGURE 4 COMMAND SEQUENCE AND RESPONSE FOR TCP CLIENT MULTI SOCKETS .............. 5-47
FIGURE 5 COMMANDS SEQUENCE FOR USING TCP SERVER SOCKETS ............................................. 5-48
FIGURE 6 EXAMPLE OF USING COMMANDS FOR STATION MODE ............................................................ 6-49
FIGURE 7 EXAMPLE OF USING COMMANDS FOR LIMITED AP MODE ...................................................... 6-50
FIGURE 8 BUTTON CORRESPONDING TO THAT PIN IN WIZFI210 EVALUATION BOARD .............. 7-51
FIGURE 9 EXAMPLE OF USING AT COMMAND INSTEAD OF HARDWARE PIN ..................................... 7-51
FIGURE 10 EXAMPLE OF APS LIST ................................................................................................................................ 7-52
FIGURE 11 EXAMPLE OF EXECUTING IPCONFIG ON DOS COMMAND LINE ........................................ 7-52
FIGURE 12 EXAMPLE OF CONNECTING TO WEB SERVER ON WIZFI210 ............................................... 7-53
FIGURE 13 WEB PAGE FOR CONFIGURATION ON WIZFI210 .......................................................................... 7-54
FIGURE 14 CERTIFICATE INFORMATION VIEW ON TWITTER.COM ............................................................ 8-59
FIGURE 15 NETWORK ENVIRONMENT FOR TESTING WEB SERVER ON WIZFI210 ......................... 8-63
FIGURE 16 CONNECTION FLOW FOR TEST ............................................................................................................. 8-64
FIGURE 17 EXAMPLE OF COMMANDS FOR WEB SERVER ON WIZFI210 ............................................... 8-65
FIGURE 18 EXAMPLE OF RECEIVED DATA FROM WEB BROWSER ........................................................... 8-66
FIGURE 19 EXAMPLE OF ESCAPE SEQUENCE FOR TRANSMITTING DATA ......................................... 8-66
FIGURE 20 AT COMMAND FOR CLOSE THE TCP CONNECTION .................................................................. 8-66
FIGURE 21 EXAMPLE OF COMMANDS FOR USING EAP-TLS ......................................................................... 9-68
FIGURE 22 EXAMPLE OF COMMANDS FOR STATION MODE AND AUTO CONNECTION .............. 10-70
FIGURE 23 EXAMPLE OF COMMANDS FOR STATION MODE AND AUTO CONNECTION .............. 10-71
FIGURE 24 EXAMPLE OF COMMANDS FOR STATION MODE AND MULTI SOCKETS ...................... 10-73
FIGURE 25 EXAMPLE OF EXCHANGING DATA IN MULTI SOCKETS MODE .......................................... 10-74
FIGURE 26 EXAMPLE OF COMMANDS FOR CLOSING SOCKETS.............................................................. 10-74
FIGURE 27 EXAMPLE OF COMMANDS FOR LIMITED AP MODE AND AUTO CONNECTION ........ 10-75
FIGURE 28 EXAMPLE OF COMMANDS FOR LIMITED AP MODE AND AUTO CONNECTION ........ 10-77

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
2-1
1. Overview
This document provides programmers with all command and explanation about WizFi210
control.
Basically programmers can control WizFi210 with commands set, known as AT command - the
character string format.
In this document, we describe what AT command are used, how each command operates and
how programmers have to handle those commands to get the response as expected.
2. AT Command Set
This section provides a list of WizFi210 AT commands and their effects. Parameters are
generally in ASCII characters, e.g. ATEn with n=1 means series of ASCII characters ‘A’, ‘T’, ‘E’,
and ‘1’. The mandatory parameters are denoted by < > and optional parameters by [ ]. If a
parameter is mandatory, any associated sub-parameters are also mandatory; sub-parameters of
an optional parameter are optional. Parameters must always be provided in the order given in
the command description. When an optional parameter is not supplied, the comma delimiters
must still be included in the command. Every command starts with the characters “AT”; any
other initial characters will cause an error return.
In the most cases, valid commands return the characters OK. Invalid inputs return ERROR:
INVALID INPUT.
Some commands are not supported according to the firmware version on WizFi210.
When user issues an AT command, “Carriage Return(0x0D)” must follows the AT command
to inform its termination.
The possible responses sent by WizFi210 to the serial host are described below.
If you send “AT” string and Line Feed to WizFi210, AT \r (0x61 0x74 0x0d)
You can get the following data.
AT\r (0x61 0x74 0x0d)1 + \r\n[OK]\r\n (0x0d 0x0a 0x5b 0x4f 0x4b 0x5d 0x0d 0x0a)
1 This is echo back of what I sent to WizFi210 from it.

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
2-2
ASCII
CHAR
Response
ASCII STRING
Meaning
0
S2W_SUCCESS
[OK]
Command Request Success.
1
S2W_FAILURE
[ERROR]
Command Request Failed.
2
S2W_EINVAL
[ERROR: INVALID INPUT]
Invalid Command or Option or
Parameter.
3
S2W_SOCK_FAIL
[ERROR: SOCKET
FAILURE]
Socket Operation Failed.
4
S2W_ENOCID
[ERROR: NO CID]
All allowed CID’s in use, so
there was no CID to assign to
the new connection.
5
S2W_EBADCID
[ERROR: INVALID CID]
Invalid Connection Identifier.
6
S2W_ENOTSUP
[ERROR: NOT
SUPPORTED]
Operation or Feature not
supported.
7
S2W_CON_SUCCESS
[CONNECT <CID> <info>]
TCP/IP connection successful.
<CID> = the new CID in
hexadecimal format.
8
S2W_ECIDCLOSE
[DISCONNECT <CID>]
TCP/IP connection with the
given CID is closed. This
response is sent to the host
when a connection is closed
either by the remote device or
by the serial host.
9
S2W_LINK_LOST
[DISASSOCIATED]
Not associated to a wireless
network.
A
S2W_DISASSO_EVT
[Disassociation Event]
Wireless network association
lost.
Table 1 List of response for AT commands

WizFi210 Programmers’ Guide (WIZnet Co., Ltd.)
2-3
2.1. AT command category and description
2.1.1. Basic commands
This category is for basic commands
Command
Category
Description
AT
Format
AT
Meaning
This command is to check whether WizFi210 is in command mode
Response
[OK]
ATE
Format
ATE n
Meaning
n =0 (Input echo disable) ex)ATE 0
n =1 (Input echo enable) ex)ATE 1
Response
[OK]
ATV
Format
ATV n
Meaning
n =0 (ASCII reply disable) ex) ATV 0
n =1 (ASCII reply enable) ex) ATV 1
Response
[OK]
Table 2 Basic commands
2.1.2. UART / Adapter interface configuration
This category is for commands related to UART setting.
Command
Category
Description
ATB
Format
ATB <baudrate>[[,2<bitsperchar>]3[,<parity>][,<stopbits>]]
Description
<baudrate> : 9600, 19200, 38400, 57600, 115200, 230400, 460800,
921600
<bitsperchar> : 5, 6, 7, or 8
<parity> : n = no parity
e = even parity
o = odd parity
<stopbits> : 1, 2 or 1.5(in case of a 5-bit character)
※ UART parameters are immediately reset to values provided.
ex) ATB=9600,8,n,1
Response
[OK]
AT&K
Format
AT&K n
2 No space is allowed between Parameter, comma(,), and next parameter
3 The parameter, which is surrounded by [ ], can be skipped.