background image

 

WizFi210 

Programmers’ Guide 

(WIZnet Co., Ltd.)

 

5-47

  <CID 0> socket receives the <AAAA>. 

  <CID 1> socket receives the <BBBB>. 

  <CID 2> socket receives the <CCCC>. 

  <CID 3> socket receives the <DDDD>. 

 

Figure 4 Command sequence 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    

(Sent AT command followed 0x0d)

 

 
[OK] 
 
AT+NCTCP=192.168.3.102,4001 
 
[OK] 
 
AT+NCTCP=192.168.3.102,4002 
 
[OK] 
 
AT+NCTCP=192.168.3.102,4003 
 
[OK] 
 
<ESC>S0AAAA<ESC>E<ESC>S1BBBB<ESC>E<ESC>S2CCCC<ESC>E<ESC>S3DDDD<ESC>E  
 

Summary of Contents for WizFi210

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Page 61: ...WizFi210 Programmers Guide WIZnet Co Ltd 7 54 Figure 13 Web page for configuration on WizFi210...

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

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

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

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

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

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

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

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

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

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

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

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

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

Page 75: ...WizFi210 Programmers Guide WIZnet Co Ltd 9 68 Figure 21 Example of commands for using EAP TLS...

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

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

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

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

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

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

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

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

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

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

Reviews: