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
Страница 1: ...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...
Страница 2: ...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 b...
Страница 3: ...tures 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...
Страница 4: ...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...
Страница 5: ...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...
Страница 6: ...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...
Страница 7: ...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 FLO...
Страница 8: ...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 com...
Страница 9: ...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...
Страница 10: ...ex ATV1 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 bits...
Страница 11: ...work connection Timeout 10ms 1 65535 1000 1 Auto Associate Timeout 10ms 0 65535 500 2 TCP connection Timeout 10ms 0 65535 500 3 Association Retry Count NA NA NA 4 Nagle Algorithm Wait Time 10ms 0 6553...
Страница 12: ...x AT Y0 n 1 Set default configuration to profile 1 ex AT Y1 Response OK AT F Format AT F Meaning Restore profile to factory default values Response OK AT V Format AT V Meaning Current and saved profil...
Страница 13: ...e RAM Response 00 08 dc 17 aa 1d OK AT WREGDO MAIN Format AT WREGDOMAIN Regulatory Domain Meaning Set Regulatory Domain with specified value in parameter ex AT WREGDOMAIN 0 Parameter Domain Channel Ra...
Страница 14: ...SONAL 10 6f 3f 25 c3 8c BUFF_SJCHUN 04 INFRA 78 WPA2 PERSONAL No Of AP Found 7 OK AT WM Format AT WM n Meaning n 0 infrastructure Station n 1 ad hoc n 2 limited AP Response OK AT WA Format AT WA SSID...
Страница 15: ...ed AP mode Response AT NSTAT Format AT NSTAT Meaning Get Current wireless and network status Response MAC 00 08 dc 17 aa 1d WSTATE CONNECTED MODE AP BSSID 00 23 69 c8 f4 f5 SSID WizFiDemoAP CHANNEL 11...
Страница 16: ...lways greater than or equal to Min scan time Both parameters are in milliseconds The allowed range of Min and Max scan time is 5 to 16000 Response OK AT WST Format AT WST Meaning To view the scan time...
Страница 17: ...sociate with is using WEP Security this command transfer WEP key to WizFi210 But when WizFi210 operates as Limited AP it uses KEY which transferred as its own key n 1 to 4 Key index key Key value in A...
Страница 18: ...ich WizFi210 will associate with is using WPA2 Pre Shared Key Security this command transfer Pre Shared Key to WizFi210 But When WizFi210 operates as Limited AP this command is not meaningless as WizF...
Страница 19: ...a 7 ex AT WEAP 0 0 100 0 ESC W data AT WEAP 1 0 200 0 ESC W data AT WEAP 2 0 150 0 ESC W data Response OK AT TCERTAD D Format AT TCERTADD Name Format Size Location OK 8 Response from WizFi210 ESC W Ce...
Страница 20: ...er Save mode disable n 1 Power Save mode enable ex AT WRXPS 1 Response OK AT MCSTSET Format AT MCSTSET n Meaning n 0 Multicast reception disable n 1 Multicast reception enable ex AT MCSTSET 0 Response...
Страница 21: ...ON but turned OFF during time consuming key calculation during the joining procedure 2 Receiver is kept PS POLL mode throughout the joining procedure Receiver is kept PS POLL mode throughout the joini...
Страница 22: ...erver enable Prior to start the DHCP server the adapter should be configured with a valid static ip address using AT NSET Response OK AT NSET Format AT NSET Src Address Net mask Gateway Meaning Src Ad...
Страница 23: ...The adapter support caching of the ARP entries max 8 in its nonvolatile memory and available across standby wakeup cycle Enable 1 to start the caching and 0 to stop the caching Response OK AT NARPCH...
Страница 24: ...isten for peer system to connect If a connection is established with this server socket you will get another CID for communication with the peer system Port Local Listen port number ex AT NSTCP 5000 R...
Страница 25: ...et option having a specified CID Response OK AT SSLOPEN Format AT SSLOPEN cid certificate name Meaning Open a SSL Connection cid Connection ID certificate name Certificate Name Response OK AT SSLCLOS...
Страница 26: ...R_WWW_AUTHENTICATE 23 HTTP_HEADER_REQUEST_URL Value a string value for a corresponding parameter above ex AT HTTPCONF 20 User Agent Mozilla 5 0 r Response OK AT HTTPCO NFDEL Format AT HTTPCONFDEL Para...
Страница 27: ...ning Open an HTTP Client connection This command opens an HTTP Client socket on WizFi210 and tries to connect to the server specified by the host name or IP address in host field host Domain name or I...
Страница 28: ...mat from HTTP S Server AT HTTPCLO SE Format AT HTTPCLOSE cid Meaning Close the HTTP client connection cid CID for the HTTP Client socket ex AT HTTPCLOSE 0 Response OK AT NRAW Format AT NRAW n Meaning...
Страница 29: ...sponse OK AT BATTLVL SET Format AT BATTLVLSET Warning Level Warning Freq Standby Level Meaning Set the battery warning standby level to enable WizFi210 220 s internal battery measuring logic Response...
Страница 30: ...uto connection This category is for commands related to Auto Connection mode Command Category Description AT WAUTO Format AT WAUTO mode SSID BSSID channel Meaning Sets WiFi parameters to be used for A...
Страница 31: ...association Response OK ATO Format ATO Meaning Return to a previous Auto Connect session returns an error if no such session exists We use this command normally when using data mode for exchanging da...
Страница 32: ...LOGOADD size Meaning Adding the Logo that will appear on the web pages used for provisioning size maximum size is 1788 bytes Response OK Table 13 List of commands for Provisioning 2 1 13 Miscellaneous...
Страница 33: ...n the serial interface as follows Response OK AT DGPIO Format AT DGPIO GPIO NO SET RESET 0 1 Meaning Set or reset high low a GPIO pin GPIO NO GPIO number SET RESET 0 1 GPIO value to set ex AT DGPIO 31...
Страница 34: ...n milliseconds Minimum 2ms Maximum 17ms Average 5ms AT TRACER OUTE Format AT TRACEROUTE IP Interval MaxHops MinHops TOS Meaning Trace the route to the IP address provided IP Target s IP address Interv...
Страница 35: ...XDUM n Meaning This command is to set whether Notification from WizFi210 regarding of some event become enable n 1 Notification Message is disable n 0 Notification Message is enable Response OK AT XE...
Страница 36: ...Meaning The command forcefully reset the WizFi210 Response APP Reset APP SW Reset AT ERRCOU NT Format AT ERRCOUNT Meaning Get the error count statistics This command returns error count information t...
Страница 37: ...nd L4 disconnection triggers the NCM and it starts do the L2 L3 and L4 re connection Response OK AT NCMAUT OCONF Format AT NCMAUTOCONF ConfID Value Meaning The NCM use some configurable parameters for...
Страница 38: ...ecified in section 2 1 5 and 2 1 11 However these commands are used for both station and Limited AP mode To distinguish the parameters for Limited AP mode WizFi210 provides a command AT APCONF Enable...
Страница 39: ...SPI The Enterprise version can be supported on specific hardware version Use can check the version of firmware and hardware using ATI2 command Now we summarize those information here AT command Stand...
Страница 40: ...X X AT WSEC AT WS AT WAUTH AT WAUTO AT WRATE AT WRSSI AT NSET AT WWPA AT WWEP AT WEAPCONF X X AT WEAP X X AT WM AT WRXPS AT WP AT WD AT WAPSM X X AT HTTPSEND X X AT HTTPOPEN X X AT HTTPCLOSE X X AT H...
Страница 41: ...T STORENWCONN AT RESTORENWCONN AT WPAPSK AT WPSK AT VER AT DNSLOOKUP AT DNSSET AT MCSTSET AT BCHKSTRT AT BATTVALGET AT BCHK AT BCHKSTOP AT BATTLVLSET AT TRACEROUTE X X AT ERRCOUNT AT SETTIME AT GETTIM...
Страница 42: ...mers Guide WIZnet Co Ltd 2 35 AT WIEEEPSPOLL X X AT APCLIENTINFO X X AT RESET X X AT APCONF X X AT NCMAUTO X X AT NCMAUTOCONF X X AT XDUM X X AT XEHT X X AT XAR X X AT XRESET X X AT XGPIO X X Table 16...
Страница 43: ...on interface SPI When using SPI WizFi210 requests some additional operation like byte stuffing So programmers using SPI interface have to do handle it in their code This 3 2 SPI section explains how f...
Страница 44: ...is selected CPOL 0 and CPH 0 Motorola SPI Format with CPL 0 CPH 0 is like Figure 2 below Figure 2 Timing diagram of SPI interface Note In case of continuous back to back transmissions the Chip Select...
Страница 45: ...must give the SPI clock and SPI read operation as long as host wake up signal is HIGH Whenever WizFi210 wants to transfer the data it asserts HIGH host wake up signal Once all the data transferred fr...
Страница 46: ...IO signal known as host wake up is available for data ready indication from Slave WizFi210 to Master Host processor Master host processor must provide clock as long as host wake up signal is active Ho...
Страница 47: ...parameters take effect after node reset restart However they are stored in RAM and will be lost when power is lost unless they are saved to a profile using AT W The profile used in that command must...
Страница 48: ...d Auto Connection session It just only to transit its mode to AT command mode in order to execute some AT command 4 2 Data mode In Data mode except the case that Notification Message is enabled using...
Страница 49: ...quence to send data to a TCP server TCP client or UDP socket in WizFi210 220 Example To send user data e g Hello on CID 1 the format will be Esc S1Hello Esc E Esc Z CID data length data To improve dat...
Страница 50: ...o Ltd 4 43 Example When WizFi210 sends data e g Hello on CID 0 with destination IP 192 168 1 1 and destination port number 52 the format will be Esc U0192 168 1 1 52 Hello Esc E Table 20 Escape Sequen...
Страница 51: ...itted because user will receive data up to specified byte count in data length Example When you receive data thru CID 1 TCP socket from peer system user will receive from WizFi210 220 as below Esc Z10...
Страница 52: ...en WizFi210 receive data e g Hello thru CID 0 WizFi210 220 transfer it to host as below Esc y0192 168 1 1 52 t0005Hello Esc O OK This sequence is sent to the serial host by the WizFi210 220 upon succe...
Страница 53: ...Auto Connection mode is not allowed then it is impossible to enter Data mode So user has to handle data in AT command mode Now we will see the list of AT commands set to use multi sockets and some exa...
Страница 54: ...ence and response for TCP Client multi sockets As we can see after connections established we can get some data from peer system following the format of escape sequence AT NCTCP 192 168 3 102 4000 Sen...
Страница 55: ...e AT NSTCP command Then the operation is processed as below CID 6 socket receives the SSSSS CID 7 socket receives the TTTTT Figure 5 Commands sequence for using TCP Server sockets AT NSTCP 5001 Sent A...
Страница 56: ...fore user doesn t need to use this AT WM 0 because the default is the Station mode Then user uses AT WA SSID to join AP which its SSID is SSID 6 2 Limited AP Mode WizFi210 can operate in Limited AP Mo...
Страница 57: ...as Limited AP mode we should use AT WM 2 AT WA SSID has WizFi210 220 configure itself with parameter values not join AP having SSID And if we need to allocate IP address to devices joined WizFi210 dy...
Страница 58: ...own below IP 192 168 1 1 Subnet 255 255 255 0 Gateway 192 168 1 1 S the URL address of Wizfi210 is http 192 168 1 1 Instead of clicking the Reserved Button you can use the AT Command as below Figure 9...
Страница 59: ...AC address of WizFi210 is attached to the position of XXXXXX Now do connect your PC to the WizFi210 Figure 10 Example of APs list In Limited AP mode WizFi210 has the DHCP server so you don t need use...
Страница 60: ...HTTP request at your host processor WizFi210 provides a web page for setting WizFi210 Users can connect to the web server the default ID and Password are admin and admin respectively Figure 12 Exampl...
Страница 61: ...WizFi210 Programmers Guide WIZnet Co Ltd 7 54 Figure 13 Web page for configuration on WizFi210...
Страница 62: ...192 168 1 1 Instead of clicking the Reserved Button you can use the AT Command as below 7 2 2 Connecting to the WizFi210 with ad hoc mode If you scan the AP you can see WizFi2xxXXXXXX in the ad hoc li...
Страница 63: ...grammers Guide WIZnet Co Ltd 7 56 In ad hoc mode you need to use Static IP address as below because WizFi210 can t allocate it any IP address dynamically And in most cases you need to disable the ethe...
Страница 64: ...rver When using these capabilities users don t need to make any HTTP request data to communicate with peer s Web server all users have to do is give some AT commands like AT HTTPCOPEN AT HTTPCCLOSE an...
Страница 65: ...how to connect to twitter com and register user s own tweet on it step by step Getting Twitter Certificate You have to get twitter certificate using a Web browser in your PC as WizFi210 doesn t operat...
Страница 66: ...n click Certificate information link to save Certificate into a file After a dialog box was shown Click Next Select DER encoded binary X 509 CER combo box and click the Next button Then give the locat...
Страница 67: ...er or customize their system s interaction to peer s web server they can emulate HTTP server or HTTP client on their host 16 The CID number of a socket connected to mobile twitter com AT TCERTADD twit...
Страница 68: ...to that client system How to make a HTML parser and HTML pages and how to operate under corresponding rule is up to you and your systems requirement You can see an example regarding to a HTML Parser...
Страница 69: ...zFi210 Programmers Guide WIZnet Co Ltd 8 62 application can process it according to its intention like extracting some information After all data is finished Web server will close its current connecti...
Страница 70: ...HTTP Server 8 3 1 Configuring the Environment for Web Server Test In the case of Web Server using WizFi210 You must constitute environment as bellows 1 Associate WizFi210 with AP 2 Associate PC with A...
Страница 71: ...of Web Server You can test web server protocol as below 1 WizFi210 is waiting for TCP connection of PC 2 PC will send TCP connection packet and request web page data 3 WizFi210 will apply web page da...
Страница 72: ...sage in WizFi210 as below AT WD Sent AT command followed 0x0d OK Response which means executed successfully AT WM 0 Sent AT command followed 0x0d OK Response which means executed successfully AT WWPA...
Страница 73: ...la 5 0 Windows NT 6 1 AppleWebKit 536 5 KHTML like Gecko Chrome 19 0 1084 56 Safari 536 6 r n Accept text html application xhtml xml application xml q 0 9 q 0 8 r n Accept Encoding gzip deflate sdch r...
Страница 74: ...ADIUS Server using WizFi210 Click Start click Run type cmd and then click OK Convert certificate file into the binary file u type openssl exe pkcs12 in Client_Cert pfx out Client_Cert pem nodes and th...
Страница 75: ...WizFi210 Programmers Guide WIZnet Co Ltd 9 68 Figure 21 Example of commands for using EAP TLS...
Страница 76: ...terface then he has to add byte stuffing function to UART AT commands and responses For it refer to 3 2 SPI section 10 1 Station Mode TCP Client and Auto Connection This is the popular example that us...
Страница 77: ...isassociation from previous AP association OK Response AT NDHCP 1 AT command making DHCP mode be enable OK Response AT WWPA 12345678 AT command setting WiFi security OK Response AT WAUTO 0 WizFiDemoAP...
Страница 78: ...d AT Sent AT command followed 0x0d AT AT command echoed back by WizFi210 OK Response which means executed successfully ATE0 Sent AT command followed 0x0d this make echo back be disable ATE0 AT command...
Страница 79: ...mmers Guide WIZnet Co Ltd 10 72 10 2 Station Mode UDP socket and Auto Connection This is the same exactly with 10 1 except using an UDP socket To make an UDP socket you have to use AT NAUTO type 0 Des...
Страница 80: ...se use AT BDATA 0 OK AT WD AT command making disassociation from previous AP association OK Response AT NDHCP 1 AT command making DHCP mode be enable OK Response AT WWPA 12345678 AT command setting Wi...
Страница 81: ...1 62 63 64 1B 45 in HEX no space Sednig data to a Socket with CID 0 under using BULK mode ESC Z00004abcd 1B 5A 3021 30 30 30 3422 61 62 63 6423 Receiving data from a UDP Socket under not using BULK mo...
Страница 82: ...AP association OK Response AT WM 2 AT command making WizFi210 Operating Mode as LimitedAP mode OK Response AT WAUTH 1 AT command making WizFi210 Operating Mode as LimitedAP mode OK AT WWEP1 1234567890...
Страница 83: ...d 10 76 10 4 2 Exchanging data with a peer system Exchanging data with its peer system is the same to 10 1 3 Refer to it 10 4 3 Closing TCP connection and UDP socket Closing TCP connections and UDP so...
Страница 84: ...de as LimitedAP mode OK Response AT WAUTH 1 AT command making WizFi210 Operating Mode as LimitedAP mode OK AT WWEP1 1234567890 AT command setting WiFi security LimitedAP mode supports only WEP OK Resp...
Страница 85: ...10 78 10 5 2 Exchanging data with a peer system Exchanging data with its peer system is the same to 10 3 2 Refer to it 10 5 3 Closing TCP connection and UDP socket Closing TCP connections and UDP soc...
