- 
                                
                                Technical Information Motorola W24 Developer’s Guide AT+i Commands Reference Manual MAY 31, 2008 6802985C10-A 
- 
                                
                                SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE Notice While reasonable efforts have been made to assure the accuracy of this document, Motorola, Inc. assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be entirely reliable. However, no responsibility is assumed for inaccuracies or omissions. Motorola, Inc. 
- 
                                
                                Trademarks MOTOROLA and the Stylized M Logo are registered in the US Patent & Trademark Office. All other product or service names are the property of their respective owners. ©Copyright 2008 Motorola, Inc. 
- 
                                
                                
                            
- 
                                
                                Table of Contents Manual Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Target Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Manual Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Applicable Documents . . . . . . . . . . . . . 
- 
                                
                                Table of Contents +iTUP - Triggered Internet Session Initiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 +iDOWN - Terminate Internet Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 +iPING - Send a PING Request to a Remote Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9 E-mail Send Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents +iMCM - Issue Intermediate Command to Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wireless LAN Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iWLTR - Wireless LAN Transmission Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iWLPW - Set WLAN Tx Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents Software Flow Control Diagram in Binary E-Mail Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Flow Control During a Socket Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Flow Control Diagram in Socket Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Host -> W24 Hardware Flow Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents Telnet Client Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-94 Secure Socket Protocol Theory of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-95 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-95 Generating Certificates for Use with Servers . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents ISP Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iISPn - Set ISP Phone Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iATH - Set PPP Authentication Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iUSRN - Define Connection User Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents Wireless LAN Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iWLCH - Wireless LAN Communication Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iWLSI - Wireless LAN Service Set Identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . +iWLWM - Wireless LAN WEP Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                Table of Contents iRouter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-193 +iARS - Automatic Router Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-193 Appendix A: MIME Content Types and Subtypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 Appendix B: Sample Parameter Update File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
- 
                                
                                List of Figures 2-1 2-2 2-3 2-4 2-5 2-6 2-7 2-8 2-9 E-Mail Receive (RMM) Flow Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 Configuring W24 when in iRouter Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52 AT+i Interface to W24 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53 Software Flow Control in Binary E-Mail Send . . . . . . . . . . . . . . . . . . . 
- 
                                
                                List of Figures x AT+i Commands Reference Manual May 31, 2008 
- 
                                
                                List of Tables 1-1 1-2 2-1 2-2 2-3 2-4 2-5 2-6 AT+i Commands by Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 AT+i Result Code Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 Report Status Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Server Names Acquired from DHCP Server . . . . . . . . . . . . . . . . . . . 
- 
                                
                                List of Tables xii AT+i Commands Reference Manual May 31, 2008 
- 
                                
                                Preface Manual Scope This manual introduces the W24 AT+i commands, and describes how software developers can use these commands to communicate with the W24 device, and to create software applications that communicate with the W24 using these commands. Note: The integrator should read the corresponding SW release notes for the W24 version he is using to get information about differences from this manual. 
- 
                                
                                Contact Us Contact Us We at Motorola want to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements. For general contact, technical support, report documentation errors and to order manuals, use this email address: M2M.CustomerCare@motorola.com Motorola appreciates feedback from the users of our information. Text Conventions The following special paragraphs are used in this guide to point out information that must be read. 
- 
                                
                                Preface Field Service For Field Service requests, use this email address: M2M.Customer@motorola.com General Safety Remember!. . . safety depends on you! The following general safety precautions must be observed during all phases of operation, service, and repair of the equipment described in this manual. Failure to comply with these precautions or with specific warnings elsewhere in this manual violates safety standards of design, manufacture, and intended use of the equipment. Motorola, Inc. 
- 
                                
                                Caring for the Environment • not remove equipment covers. Only Factory Authorized Service Personnel or other qualified maintenance personnel may remove equipment covers for internal subassembly, or component replacement, or any internal adjustment • not replace components with power cable connected. 
- 
                                
                                Preface http://mynetworksupport.motorola.com Select Customer Network Resolution Center contact information. Alternatively if you do not have access to CNRC or the internet, contact the Local Motorola Office. Disposal of Motorola equipment in non-EU countries In non-EU countries, dispose of Motorola Networks equipment in accordance with national and regional regulations. RoHS Compliance The W24 product meets the European Union directive for RoHS compliance. 
- 
                                
                                How to Get Warranty Service? the applicable Motorola specifications current at the time of manufacture for a term of [1] year from date of purchase of the Product(s) (Warranty Term). 
- 
                                
                                Preface You must ensure that all and any repairs or servicing is handled at all times by a Motorola Authorized Service Center in accordance with the Motorola Service requirements. In some cases, you may be requested to provide additional information concerning the maintenance of the Products by Motorola Authorized Service Centers only, therefore it is important to keep a record of any previous repairs, and make them available if questions arise concerning maintenance. 
- 
                                
                                Installed Data 5. Products disassembled or repaired other than by Motorola in such a manner as to adversely affect performance or prevent adequate inspection and testing to verify any warranty claim. 6. Defects or damage due to range, coverage, availability, grade of service, or operation of the Wi-Fi Provider. 7. Defects or damage due to moist, liquid or spills of food. 8. Control unit coil cords in the Product that are stretched or have the modular tab broken. 9. 
- 
                                
                                Preface Revision History Manual Number 6802985C10-A Manual Title W24 Developer’s Guide: AT+i Commands Reference Manual Version Information The following table lists the manual version, date of version, and remarks about the version. 
- 
                                
                                Revision History xxii AT+i Commands Reference Manual May 31, 2008 
- 
                                
                                Chapter 1: Introduction to AT+i Commands AT+i Commands Overview AT+i commands are an extension to the basic AT commands set. They are parsed and acted upon by W24. 
- 
                                
                                AT+i Commands Overview Characters within the AT+i command line are parsed as commands with associated parameter values. The W24 supports editing of command lines by recognizing a backspace character. When ECHO is enabled, the W24 responds to receipt of a backspace by echoing a backspace character, a space character, and another backspace. When ECHO is disabled, backspace characters are treated as data characters without any further processing. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Flexible Host and Modem Interfaces The flexible host and modem interfaces feature enables users to select the interface through which W24 accepts AT+i commands from the host processor, as well as the interface through which AT+i commands are sent to a dialup or cellular modem. 
- 
                                
                                AT+i Commands Overview In auto baud mode, W24 expects an A or a character. This is usually the first character sent, since in command mode a meaningful command is always prefixed by AT+i. The host may send an a or A to the W24 to allow it to determine the host's baud rate. It may also send a complete AT+i command. In any case, W24 detects the A or a character, determines the correct baud rate, and configures its serial channel during the stop bit. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Internet Session Hang-up Procedure (Modem Only) Upon completion of a dial-up Internet session, the W24 automatically executes a modem hang-up procedure: • The DTR line is dropped. • After a 1second delay, W24 raises the DTR. • If the modem responds to the DTR drop with a No Carrier then Done. Otherwise, W24 issues a (+++) to the modem followed by ATH. 
- 
                                
                                AT+i Commands Overview W24 Readiness Indication This W24 Readiness Indication feature provides an indication of W24's readiness to accept AT+i commands following a hardware reset. Using this feature, W24 can also notify the host when it is ready for IP communication. This functionality is based on two parameters - RRA and RRHW. The RRA parameter can be set to send a software message to the host, assert a dedicated hardware pin, or do both. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands General AT+i Command Format The AT+i command has the following general format: AT+i[[ | #UFn]…] The following table gives a short explanation of the fields: Parameter Description  (or ) 2-4 letter command code () or parameter name ()  Delimiter: '=', '~', '?', ':', ‘,‘  Optional parameter or data.
 
- 
                                
                                General AT+i Command Format Table 1-1: AT+i Commands by Category (Cont.) Command Function Parameters/Description Connection BDRA Auto baud rate mode Forces W24 into auto baud rate detection mode. UP Connect to Internet Forces W24 to go online, establish an Internet session, and optionally register its IP address. TUP Triggered Internet session mode Enters a mode in which W24 goes online in response to triggers from external signals. It also supports a special Always Online mode. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Table 1-1: AT+i Commands by Category (Cont.) Command Function Parameters/Description Telnet Client TOPN Telnet open session Opens a Telnet session to a remote Telnet server. If W24 is not online, it is connected. TRCV Telnet receive Receives data from a remote Telnet server. TSND Telnet send line Sends an ASCII data line to a remote Telnet server. TBSN[%] Telnet send binary stream Sends a binary data stream to a remote Telnet server. 
- 
                                
                                General AT+i Command Format Table 1-1: AT+i Commands by Category (Cont.) Command Function Parameters/Description Socket Interface STCP:, [, ] Socket TCP Opens and connects a TCP socket. If W24 is not online, it is connected. The responding system is assumed to be a server listening on the specified socket. Returns a handle to the socket. SUDP: , [,] Socket UDP Opens, connects, and optionally binds a UDP socket. If W24 is not online, it is connected. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Table 1-1: AT+i Commands by Category (Cont.) Command Function Parameters/Description Wireless LAN WLTR WLAN transmission rate Sets the maximum allowable WLAN transmission rate. WLPW WLAN Tx power Sets the transmission power of the Marvell WLAN chipset. WRFU WLAN radio up Turns on radio transmission of the Marvell WLAN chipset. WRFD WLAN radio down Turns off radio transmission of the Marvell WLAN chipset. 
- 
                                
                                General AT+i Command Format AT+i Result Code Summary Table 1-2 gives the AT+i result code summary. Table 1-2: AT+i Result Code Summary Response String I/OK Command was successfully executed. I/BUSY W24 busy. Command discarded. I/DONE W24 completed Internet activity; returned to command mode, or entered SerialNET mode. I/ONLINE W24 completed Internet activity and returned to command mode, or entered SerialNET mode. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Table 1-2: AT+i Result Code Summary (Cont.) Response String May 31, 2008 Denotation 63 ~CTSH needs to be LOW to change to hardware flow control. 
- 
                                
                                General AT+i Command Format Table 1-2: AT+i Result Code Summary (Cont.) Response String 1-14 Denotation 111 Serial data overflow 112 Illegal command when modem online 113 E-mail firmware update attempted but not completed. 
- 
                                
                                Chapter 1: Introduction to AT+i Commands Table 1-2: AT+i Result Code Summary (Cont. 
- 
                                
                                General AT+i Command Format Table 1-2: AT+i Result Code Summary (Cont.) Response String Denotation 561 Remote peer closed the SerialNET socket 570 571 PING destination not found No reply to PING request Note: All W24 response strings are terminated with . 
- 
                                
                                Chapter 2: AT+i Commands Reference Report Status +i[!]RPi - Report Status Syntax: AT+i[!]RPi Returns a status report. Parameters: i=0..20 Command Options: i=0 Returns the W24 part number. i=1 Returns the current firmware revision and date. i=2 Returns the connection status. i=3 Returns boot-block revision and date. i=4 Returns W24 socket status. i=5 Returns a unique serial number. i=6 Returns current ARP table. i=7 Returns socket buffers utilization bitmap. 
- 
                                
                                Report Status AT+i!RP11 Returns a list of all ad-hoc networks available in the surrounding area. i=14 Returns a DHCP server table of MAC and IP addresses of all the stations connected to W24. i=19 Returns Analog-to-Digital Converter (ADC) pin status report. i=20 Returns a list of all APs and ad-hoc networks available in the surrounding area. Default: None Result Code: i=0..20 I/ERROR Status message followed by I/OK. 
- 
                                
                                Chapter 2: AT+i Commands Reference Table 2-1: Report Status Message Format (Cont.) Report Option 6 7 Format Current ARP table listing: INTERNET ADDRESS nnn.nnn.nnn.nnn For debugging purposes. PHYSICAL ADDRESS STATE TTL xxxxxxxxxxxx VALID nnn sec. I/xxxx xxxx – 16 bit Hex Value Bitmap A bit set to ‘1’ indicates that the corresponding socket contains buffered data, which needs to be read by the host. 
- 
                                
                                Report Status Table 2-1: Report Status Message Format (Cont.) Report Option Format 11 W24 scans all available Access Points (APs) in the surrounding area and returns a list of APs. Each line contains the following comma-separated fields: SSID, security scheme, and signal strength. The AP having the strongest signal appears first. ,, ,, . . 
- 
                                
                                Chapter 2: AT+i Commands Reference Table 2-1: Report Status Message Format (Cont.) May 31, 2008 Report Option Format 19 Returns Analog-to-Digital Converter (ADC) pin status report. If the ADCP parameter is set, the reports returns GPIO pin state. Otherwise, it returns the ADC value only. ADC value=, GPIO state= I/OK where • level is an integer in the range 0-255 representing the input voltage measured on the ADC pin, calculated as follows: (A/3. 
- 
                                
                                Connection Connection +iBDRA - Force W24 into Auto Baud Rate Mode Syntax: AT+iBDRA Forces the W24 into auto baud rate mode. The following A, AT or AT+i command (in any combination of upper or lowercase) from the host will synchronize on the host's baud rate. W24 supports auto baud rate detection for the following baud rates: 2400, 4800, 9600, 19200, 38400, 57600, and 115200. Result Code: I/OK This result code is sent using the previous baud rate. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iTUP - Triggered Internet Session Initiation Syntax: AT+iTUP: Enter triggered Internet session initiation mode. This command is relevant in a modem environment only. Parameters: n=0..2 Command Options: n=0 Disable triggered Internet session initiation mode. n=1 Enter triggered Internet session initiation mode. 
- 
                                
                                Connection open TCP active sockets, but leaves UDP sockets and TCP passive (listening) sockets intact and updates their local IP if a new IP is assigned after establishing a new PPP connection. W24 does not close any open Internet sessions (FTP/Telnet sessions and so on), nor releases the handle of the active TCP sockets, thus giving the host a chance to read the session errors and get buffered incoming data from active TCP sockets. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iPING - Send a PING Request to a Remote Server Syntax: AT+iPING: Sends a two-byte ICMP PING request packet to the remote host defined by host. Parameters: =Logical name of the target host or a host IP address. Command Options:  The host name may be any legal Internet server name, which can be resolved by the W24's DNS (Domain Name Server) settings. The host name may also be specified as an absolute IP address given in DOT form. 
- 
                                
                                E-mail Send Commands E-mail Send Commands +iEMA - Accept ASCII-Coded Lines for E-Mail Send Syntax: AT+i[!]EMA: Defines a plain text e-mail body. Parameters:  Plain text e-mail body. The e-mail body contains  terminated ASCII character strings.  must be terminated by a dot character (.) in the 1st column of an otherwise empty line. Command Options: ::={ …}. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iEMB - Accept Binary Data for Immediate E-Mail Send Syntax: AT+i[!]EMB[#]:, Defines and sends a MIME-encoded binary e-mail. Parameters:   Size of  in bytes.  bytes of binary data. Command Options:   0..4GB 8 bit binary data. Must be exactly  bytes long. The binary data is encapsulated in a MIME-encoded e-mail message. The receiving end views the binary data as a standard e-mail attachment. 
- 
                                
                                E-mail Send Commands (active low). If a transmission error occurs while in hardware flow control, W24 continues receiving all remaining  bytes before returning the I/ERROR response. • Some SMTP servers limit e-mail message size to a value that is lower than W24's limitations. +iE* - Terminate Binary E-Mail Syntax: AT+i[!]E* Terminates the current binary e-mail attachment. Parameters:  Plain text e-mail body. The e-mail body contains  terminated ASCII character strings. 
- 
                                
                                Chapter 2: AT+i Commands Reference E-Mail Retrieve +iRML - Retrieve Mail List Syntax: AT+i[!]RML Retrieves pending e-mail list from current mailbox. Command Options: ! Stay online after completing the command. Result Code: I/OK I/ERROR To acknowledge successful receipt of the command. Otherwise. Returns: I/MBE Otherwise: If the mailbox is empty. A list of qualifying e-mail message descriptors, separated by . 
- 
                                
                                E-Mail Retrieve i Optional e-mail message index of a qualifying message. If no parameter is used, all e-mail headers are retrieved. Command Options: i Optional index of a qualifying message, as reported by AT+iRML. ! Stay online after completing the command. Default: Retrieves headers of all pending qualified mail messages. Result Code: I/OK I/ERROR When command is received and about to be processed. Otherwise. Returns: I/MBE Otherwise: If the mailbox is empty. 
- 
                                
                                Chapter 2: AT+i Commands Reference I/ERROR Otherwise. Returns: I/MBE Otherwise: If the mailbox is empty. 
- 
                                
                                E-Mail Retrieve Figure 2-1 shows E-Mail Receive (RMM) flow diagram. 
- 
                                
                                Chapter 2: AT+i Commands Reference HTTP Client Interface +iRLNK - Retrieve Link Syntax: AT+i[!]RLNK[:URL] Retrieves a file from a URL. Parameters: URL = Optional URL address, which specifies the host, path, and source file to be retrieved. URL address syntax: "://[[:]/[]/]" Command Options:  http or https.  Host name or IP address.  0..65535 If not specified, defaults to 80 for http and 443 for https. 
- 
                                
                                HTTP Client Interface +iSLNK - Submit a POST Request to a Web Server Syntax: AT+i[!]SLNK: Submits a plain text POST request to a web server defined in the URL parameter. The "Content-type:" field of the POST request is defined by the CTT parameter. Parameters:  = Plain text POST request body containing  terminated ASCII character strings.  must be terminated by a dot character (.) in the first column of an otherwise empty line. 
- 
                                
                                Chapter 2: AT+i Commands Reference SerialNET Mode Initiation +iSNMD - Activate SerialNET Mode Syntax: AT+i[! | @]SNMD Activates SerialNET mode. Instead of using the optional (!) and (@) flags, you can use the following syntax: AT+iSNMD=1 is equivalent to AT+iSNMD AT+iSNMD=2 is equivalent to AT+i!SNMD AT+iSNMD=3 is equivalent to AT+i@SNMD AT+iSNMD=4 causes W24 to enter SerialNET over TELNET mode Command Options: AT+i!SNMD -orAT+iSNMD=2 Optional Auto-Link mode. 
- 
                                
                                SerialNET Mode Initiation I/ONLINE After successfully activating SerialNET mode. Allow a 2.5 seconds delay for W24 re-initialization. -orI/OFFLINE After successfully activating SerialNET Auto-Link mode (!) or Deferred Connection mode. Note: To terminate SerialNET mode, issue the ESC sequence (+++), power-cycle the W24 with the MSEL signal pulled low for less than 5 seconds, or pull the MSEL signal low for more than 5 seconds during runtime. 
- 
                                
                                Chapter 2: AT+i Commands Reference Web Server Interface +iWWW - Activate Embedded Web Server Syntax: AT+iWWW[:n] Activates W24's internal web server. Parameters: Command Options: =Web browser backlog. n represents the number of browsers that can connect to W24's internal web server simultaneously at any given time. Note: Each additional browser (over the n number), will close a previous one and open its own. =1.. 
- 
                                
                                File Transfer Protocol (FTP) File Transfer Protocol (FTP) +i[@]FOPN - FTP Open Session Syntax: AT+i[@]FOPN:[,]:,[,] Opens an FTP link to an FTP server. Parameters:  Logical name of the FTP or the server's IP address.  Optional FTP port in the range 0..65535.  FTP user's name.  FTP user's password.  Optional FTP account. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iFDL - FTP Directory Listing Syntax: AT+iFDL:[,] Returns a full FTP directory listing. Parameters:  An open FTP session handle.  Directory or filename wild card. Command Options:  Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session.  Optional directory name or filename wild card. If  is a directory, that directory's files are listed. 
- 
                                
                                File Transfer Protocol (FTP) I/OK I/ERROR Returns: To acknowledge successful receipt of the command. If  is not an open FTP session or otherwise some error has occurred. A bare list of filenames. Each file name is listed on a separate line, terminated by . No attributes are returned in addition to the filename. Followed by: I/ONLINE After successfully retrieving the directory list. 
- 
                                
                                Chapter 2: AT+i Commands Reference  Absolute or relative path name of the new directory. The special directory ".." signifies "one directory up". Result Code: I/OK I/ERROR After successfully changing the working directory. Otherwise. +iFSZ - FTP File Size Syntax: AT+iFSZ:, Reports an FTP file size. Parameters:  An open FTP session handle.  File pathname. 
- 
                                
                                File Transfer Protocol (FTP) I/OK I/ERROR When command has been received and about to be processed. If  is not an open FTP session or otherwise some error has occurred. Followed by: I/ERROR -orFollowed by: If the FTP RECV command could not be processed. I/  where,  is the exact size (in bytes) of the  to follow. If  cannot be determined, W24 returns I/0 followed by the data stream. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iFAPN - FTP Open File for Appending Syntax: AT+iFAPN:,[,] Opens an existing remote FTP server file for Append. Parameters:  An open FTP session handle.  File pathname.  Size in bytes to reserve for the file on the server. Command Options:  Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session.  Absolute or relative path name of the remote destination file. 
- 
                                
                                File Transfer Protocol (FTP)  An 8-bit byte stream of exactly size . If  is larger than 256 bytes, W24 assumes host flow control. Depending on the setting of the FLW parameter, the flow control mode is either software or hardware. Under software flow control mode, the host processor must respond to W24's flow control characters. The flow control protocol is detailed in the "Host -> W24 Software Flow Control" section later in this document. 
- 
                                
                                Chapter 2: AT+i Commands Reference  File pathname Command Options:  Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session.  Absolute or relative pathname of the remote destination file to delete. Result Code: I/OK I/ERROR After successfully closing the file. Otherwise. +iFCLS - FTP Close Session Syntax: AT+i[!]FCLS: Closes the FTP link. Parameters:  An open FTP session handle. 
- 
                                
                                Telnet Client Telnet Client +iTOPN - Telnet Open Session Syntax: AT+iTOPN: Opens a Telnet link (socket) to a Telnet server on port 23. Parameters:  Logical name of the Telnet server or the server's IP address. Command Options:  The server name can be any legal Internet Server name that can be resolved by W24's DNS (Domain Name Server) settings. The server name may also be specified as an absolute IP address given in DOT form. 
- 
                                
                                Chapter 2: AT+i Commands Reference Parameters:  A line of data bytes to be sent to the Telnet server. W24 terminates the  with a  and sends it to the Telnet server. Command Options:  If the line to be sent incorporates W24 delimiter characters (, ; : ; = ; ~),  must be enclosed in single (') or double (") quotes. AT+i command's terminating  is considered a terminating quote, as well. 
- 
                                
                                Telnet Client +iTFSH[%] - Flush Telnet Socket's Outbound Data Syntax: AT+iTFSH[%] Flushes (immediately sends) all the data accumulated in a Telnet socket's outbound buffer. Command Options: % When the flush-and-acknowledge ('%') flag is specified, W24 flushes and waits for the Telnet server receipt acknowledgment of all outstanding outbound data. Result Code: I/OK I/ERROR If all outbound data has been received and acknowledged by the Telnet server. Otherwise. 
- 
                                
                                Chapter 2: AT+i Commands Reference Direct Socket Interface +iSTCP - Open and Connect a TCP Socket Syntax: AT+iSTCP:,[,] Opens a Transmission Control Protocol (TCP) client socket and attempts to connect it to the specified  on a server defined by . Parameters:  Logical name of the target server or a host IP address.  0..65535, target port.  Optional local port on W24. 
- 
                                
                                Direct Socket Interface  Remote port number to send to, or 0 to open a non-connected socket.  Optional local UDP port to use. Command Options:  The remote system's name may be any legal Internet server name that can be resolved by W24's DNS (Domain Name Server) settings. The server name may also be specified as an absolute IP address given in DOT form. When the  is defined, the resulting UDP socket is created and connected. If =0.0.0. 
- 
                                
                                Chapter 2: AT+i Commands Reference I/ I/ERROR Upon successfully opening a TCP listening socket, a socket handle is returned. The socket handle  is in the range 10..11 and used to reference the socket in all following socket commands. Otherwise. +iLSST - Get a Listening Socket's Active Connection Status Syntax: AT+iLSST: Retrieves handles of active socket connections established through the listening socket identified by . 
- 
                                
                                Direct Socket Interface I/() I/ERROR where, sockstat >=0 - Number of bytes pending in socket 's input buffer. sockstat <0 - Socket error code. If some error occurred. +iSCS - Get a Socket Connection Status Report Syntax: AT+iSCS: Retrieves a socket's connection status report without reporting the number of buffered characters. Parameters:  A TCP/UDP socket handle. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iSSND[%] - Send a Byte Stream to a Socket Syntax: AT+iSSND[%]:,:[] Sends a byte stream of size sz to the socket specified by the socket handle hn. Parameters:  A TCP/UDP socket handle of an open socket.  The exact size of the byte stream that follows.   A byte stream of size sz to be sent to the specified socket. 
- 
                                
                                Direct Socket Interface +iSRCV - Receive a Byte Stream from a Socket's Input Buffer Syntax: AT+iSRCV:[,] Receives a byte stream from the TCP/UDP socket specified by the socket handle hn. Received data is valid only if it already resides in W24's socket input buffer at the time this command is issued. Parameters:   A TCP/UDP socket handle of an open socket. Optionally specifies the maximum number of bytes to transfer. 
- 
                                
                                Chapter 2: AT+i Commands Reference  A TCP/UDP socket handle of an open socket. Command Options:  Must have been obtained by a previous execution of an AT+iSTCP or AT+iSUDP command during the current Internet mode session. Or a socket accepted by a listening socket. Result Code: I/(:) I/ERROR where,  is the remote peer's IP address, and  is the remote peer's port for this connection. If  is not an open socket handle, or otherwise some error occurred. 
- 
                                
                                Direct Socket Interface % When the flush-and-acknowledge (%) flag is specified and  is a TCP socket handle, W24 flushes and waits for the peer receipt acknowledgment of all outstanding outbound data. Common errors associated with this flag are 215 (carrier lost) and 203 (socket closed by peer in an orderly manner or did not receive ACK after repeated attempts to retransmit unacknowledged data). 
- 
                                
                                Chapter 2: AT+i Commands Reference Special Modem Commands +iMCM - Issue Intermediate Command to Modem Syntax: AT+iMCM[:] Sends a single AT command to the modem during an internet session or enters Modem Command mode. Parameters:  Optional single AT command to be sent to modem. Command Options:  Returns: W24 puts the modem in command mode by issuing the (+++) escape sequence and then sends  to the modem, followed by a . 
- 
                                
                                Wireless LAN Mode Wireless LAN Mode The W24 includes a Wireless LAN driver for the Marvell 88W8686 802.11b/g WiFi chipset. In addition, the W24 firmware contains WEP and WPA encryption of WPA-PSK with TKIP and WPA2-PSK with AES for this chipset. WPA security requires a parameter that contains the Personal Shared Key (PSK), sometimes referred to as the passphrase. The Wireless LAN Passphrase (WLPP) parameter is used to set the passphrase. 
- 
                                
                                Chapter 2: AT+i Commands Reference tr=12 Limited to 48 Mbps tr=13 Limited to 54 Mbps Default: 0 (Maximum transmission rate) Result Code: I/OK If tr=0..13. I/ERROR Otherwise. +iWLPW - Set WLAN Tx Power Syntax: AT+iWLPW= Sets the transmission power of the Marvell WLAN chipset. Parameters: n=0 n=0-20 Use Marvell's automatic power level adaptation scheme. n=1-20 Set a fixed transmission power level. Default: n=0 Result Code: I/OK I/ERROR (042) If power set succeeded. 
- 
                                
                                Wireless LAN Mode +iWRST - Reset WLAN Chipset Syntax: AT+iWRST Performs a hardware reset of the Marvell WLAN chipset. Parameters: None Result Code: I/OK I/ERROR (404) If operation succeeded. Otherwise. +iWLBM - WLAN B Mode Syntax: AT+iWLBM Sets the Marvell WLAN chipset to 802.11/b mode. Allowable Tx transmission rates for this mode are: 1, 2, 5.5 and 11 Mbps. Parameters: None Result Code: I/OK Always. +iWLGM - WLAN G Mode Syntax: AT+iWLGM Sets the Marvell WLAN chipset to 802.11/g mode. 
- 
                                
                                Chapter 2: AT+i Commands Reference • WROM - Enables Roaming mode. • WPSI - Sets the time interval between consecutive scans that W24 performs for APs in its vicinity. • WSRL - Sets a low SNR threshold for W24 in Roaming mode. • WSRH - Sets a high SNR threshold for W24 in Roaming mode. In addition, two reports provide useful information pertaining to the Roaming feature: • AT+i!RP10 - Returns a report of the current WLAN connection. 
- 
                                
                                Wireless LAN Mode If the connection is active, W24 waits for an IP activity command from the host. When such a command is sent, W24 performs a software reset and starts scanning for APs. W24 responds with ERROR (074) to indicate that the current connection has been lost. Multiple SSIDs The Multiple SSIDs feature allows you to define an ordered list of SSIDs of Access Points (APs) or ad-hoc networks with which W24 attempts to connect upon power-up. 
- 
                                
                                Chapter 2: AT+i Commands Reference IP Registration When W24 goes online in a dial-up environment, it is normally assigned a dynamic IP address during PPP establishment. Since a different IP address is usually assigned every session, it is not practical to use W24 as a server, since the clients do not know what IP address to use. Furthermore, under these restrictions, there is no practical way to know whether a specific system is online or offline. 
- 
                                
                                IP Registration to the server defined in RRSV during the registration procedure. When a socket is established, W24 transmits its ID information and current IP address (or the RRRL) in the following format: "iChip- S/N: version:  HN: IP: Port:" The registration socket is then closed. Web Server Registration W24 registers itself by surfing to a web server with its ID information and current IP address as parameters. 
- 
                                
                                Chapter 2: AT+i Commands Reference DHCP Client A DHCP client component in W24 in WLAN mode supports IP and server name acquisition from a standard DHCP Server. The W24 device attempts to contact and acquire server names from a DHCP server if and when its DIP (Default IP) parameter contains the special value 0.0.0.0. When the DHCP acquisition procedure is successful, the W24's IPA (IP Address) parameter contains the assigned IP address retrieved from the DHCP server. 
- 
                                
                                DHCP Server DHCP Server W24's DHCP server allows it to manage a network segment when no DHCP server is available. When W24 is configured to operate in iRouter mode, it provides access to the public internet via its modem connection. The DHCP server can handle up to 255 IP addresses concurrently. Two parameters govern DHCP server functionality: • DPSZ: The DHCP pool size parameter determines the range of IP addresses that W24 allocates for its clients. 
- 
                                
                                Chapter 2: AT+i Commands Reference iRouter Mode Introduction W24's iRouter mode is used to provide a gateway to a multitude of WiFi devices through a single dialup or cellular link. In this configuration, W24's DHCP server may be used to assign IP addresses to the local hosts on the WiFi side. W24 also uses a Network Address Translator (NAT) to translate between local and public IP addresses. While routing IP packets, W24 also accepts AT+i commands, as during normal operation. 
- 
                                
                                iRouter Mode Configuring W24 when in iRouter Mode iRouter mode is terminated by any of the following occurrences: • By issuing the AT+iSTPR (Stop Routing) command. When W24 receives this command, routing services are stopped and W24 goes offline on the dialup/cellular side. If ARS=1 (Auto Routing), W24 automatically goes online and restores routing services when the next packet arrives. • Automatically after an idle time period (with no routing activity) has passed. 
- 
                                
                                Chapter 2: AT+i Commands Reference dialup/cellular side; when CPF=1, they are directed towards the WiFi side. While processing AT+i commands, W24 continues to route packets seamlessly between the two platforms. W24's responses to AT+i commands depend on the CPF value, as well. For example, the IP returned by AT+iIPA? command while CPF=1 is the WLAN-side IP. Figure 2-3: AT+i Interface to W24 Baud Rate Settings and Auto Baud Rate iRouter mode supports all host and modem baud rates supported by W24. 
- 
                                
                                iRouter Mode Followed by: I/ONLINE I/ERROR After successfully going online on the dialup/cellular side. Otherwise. +iSTPR - Stop Router Syntax: AT+iSTPR Causes W24 to exit iRouter mode, go offline on the dialup/cellular side, and stop routing packets. If ARS=1 (Auto Routing), W24 automatically goes online and restores routing services when the next packet arrives. Result Code: I/OK When command is received and about to be processed. 
- 
                                
                                Chapter 2: AT+i Commands Reference Ad-Hoc Networks An ad-hoc network is a Wireless Local Area Network (WLAN) in which some of the stations are part of the network only for the duration of a communications session or, in the case of mobile or portable devices, while in some close proximity to the rest of the network. Ad-hoc networks do not require an Access Point (AP) to enable communication among stations. Each station can create a new ad-hoc network or join an existing one. 
- 
                                
                                Ad-Hoc Networks Merging Ad-Hoc Networks When W24 is configured to operate in ad-hoc mode, the Marvell WiFi chipset it is connected to performs a periodic scan for other ad-hoc networks in the vicinity having the same SSID but a different BSSID. If a scan indicates the existence of such an ad-hoc network, the Marvell chipset initiates a procedure of merging networks. Networks merge into the one that was created earlier, provided they operate on the same channel. 
- 
                                
                                Chapter 2: AT+i Commands Reference Secure Socket Protocol W24 supports the SSL3/TLS1 secure socket protocol, based on RFC2246. W24 supports the following Cipher suites: • SSL_RSA_WITH_RC4_128_MD5 • • • • SSL_RSA_WITH_RC4_128_SHA SSL_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_AES_128_CBC_SHA TLS_RSA_WITH_AES_256_CBC_SHA Establishing An SSL3/TLS1 Socket Connection W24 supports a single SSL3/TLS1 TCP/IP active socket connection. Opening a secure socket on W24 involves two steps: 1. 
- 
                                
                                Secure Socket Protocol AT+iSSL:0 W24 is instructed to negotiate an SSL3/TLS1 connection on socket handle 0. I/OK SSL3/TLS1 handshake was successful. SSL3/TLS1 connection established on socket handle 0. AT+iSSND%:0,323:<…323 bytes of plain text data> Host sends 323 bytes of plain text data via SSL3/TLS1 socket. W24 encrypts data and sends cipher text over the Internet. The '%' attribute indicates immediate flush. I/OK W24 encrypted and sent data. AT+iRP4 Request socket status. 
- 
                                
                                Chapter 2: AT+i Commands Reference +iSSL - Secure Socket Connection Handshake Syntax: AT+iSSL: Negotiates a secure SSL3/TLS1 connection over an open TCP/IP socket. Parameters:  = A previously open TCP/IP socket handle. Command Options:  Must be obtained using the AT+iSTCP command during the current Internet mode session. Or a socket accepted by a listening socket. 
- 
                                
                                Secure Socket Protocol  Password for user authentication. If special characters are used, the password must be specified within quotes. It is customary that servers that allow anonymous login request an e-mail address as a password.  Some FTP servers require an account in order to allow a certain subset of the commands. In this case, the account name must be specified when opening the FTP link. @ The optional @ is used to flag the Force PASV mode. 
- 
                                
                                Chapter 2: AT+i Commands Reference Network Time Client W24 incorporates a Simple Network Time Protocol (SNTP) client. With this protocol support, W24 can be configured to check SNTP servers for current time and date each time it goes online. W24 is configured to retrieve time data from a Network Time Server each time it goes online with the NTOD parameter. After updating its internal Time-Of-Day (TOD) registers at least once, W24 continues to keep track of time independently, even after it goes offline. 
- 
                                
                                MIME Encapsulated E-Mail Messages MIME Encapsulated E-Mail Messages W24-Generated Binary Message Formats Binary e-mail messages are sent via W24 using one or more AT+iEMB commands. The message format is limited to an optional body of text and a single attachment. The following fields are added by W24 to the main message header: X-Mailer: iChip  Message-ID: @iChip Mime-Version: 1. 
- 
                                
                                Chapter 2: AT+i Commands Reference When several consecutive AT+iEMB commands are used, the host must issue the commands with an inter-command delay, which does not violate the SMTP server's timeout constraints. Otherwise, the SMTP server will timeout and abort the session. Average SMTP servers allow for delays in the range of 30 to 120 seconds. 
- 
                                
                                MIME Encapsulated E-Mail Messages The maximum temporary body size allowed is 1K characters (including embedded ). The text body is included in the next session binary message and then purged. MIME-Encapsulated E-Mail Message Format Note: Bold lines are added by W24. Received: from JFK by FTGate SmartPop; Tue, 23 Nov 1999 09:26:21 +0200 Received: from mail.inter.net.il (hrz-153-147.access.net.il [212.68.153.147]) by mail.inter.net.il (8.9.3/8.8. 
- 
                                
                                Chapter 2: AT+i Commands Reference . . .  . . . 
- 
                                
                                Flow Control Flow Control Host -> W24 Software Flow Control When issuing an AT+iEMB command to generate a binary e-mail, an AT+iSSND command to transfer data to a socket, an AT+iTBSN to send a binary stream to a Telnet server, or an AT+iFSND command to transfer a file, the host transfers a binary data stream to W24. At times, this stream may be very large. Once W24 establishes a connection, it acts as a pipeline, transferring data received from the host to the Internet. 
- 
                                
                                Chapter 2: AT+i Commands Reference Software Flow Control Diagram in Binary E-Mail Send See Figure 2-4. 
- 
                                
                                Flow Control Software Flow Control During a Socket Send When a WAIT control is sent to the host during a socket send (AT+iSSND) command, it is automatically followed by an RP4 socket status report in the following syntax: I/(, , … ,) See the AT+iRP command for a full description. While the host is waiting for the CONTINUE control, it may analyze the sockets' input buffer status. 
- 
                                
                                Chapter 2: AT+i Commands Reference Software Flow Control Diagram in Socket Send See Figure 2-5. 
- 
                                
                                Flow Control Host -> W24 Hardware Flow Control As an alternative to the software flow control method, which requires some software attention on behalf of the host, W24 offers a hardware flow control mode. This mode is selected by setting W24's FLW parameter Bit 0, using the AT+iFLW command. Note that to set FLW Bit 0, the ~CTSH signal needs to be LOW (enabled), otherwise W24 returns I/ERROR (063). 
- 
                                
                                Chapter 2: AT+i Commands Reference Remote Firmware Update Introduction W24 accepts remote firmware updates from an HTTP or FTP server. The firmware update is stored as an .imz file on the host server and downloaded by W24 acting as a client. W24 replaces its existing firmware with the new one through a special application that is part of the .imz file. This method is especially convenient when managing firmware updates in a globally distributed install base of internet-enabled devices. 
- 
                                
                                Remote Firmware Update 5. W24 replaces the old image with the new image. 6. If the replacement process fails, for example due to power failure, W24 re-boots from boot loader in the flash memory and re-tries the replacement process until successful. 7. If the replacement process is successful, W24 re-boots and executes the new firmware. +iRFU - Remote Firmware Update Syntax: AT+iRFU Downloads and updates W24 firmware from a remote HTTP or FTP server. 
- 
                                
                                Chapter 2: AT+i Commands Reference W24 Parameter Update Introduction The W24 remote parameter update file allows users to remotely modify various non-volatile parameters in W24 products. The file is an ASCII-formatted text file, edited by the user or created by a dedicated application. The file's size must not exceed 10k. The remote parameter file (RPF) naming convention is .rpf. 
- 
                                
                                W24 Parameter Update • RP_GROUP - If the RPF Group Name parameter contains a value, the RPF file must include an RP_GROUP definition and its value must be identical to the RPF value. Otherwise, the parameter update file will be rejected. Nevertheless, if the RPF parameter is set to the special value (*) (match any), the RPF file will be accepted with any value of RP_GROUP, as well as without any value at all. The RPF Group Name parameter can be viewed and changed by sending an AT+iRPG? command to W24. 
- 
                                
                                Chapter 2: AT+i Commands Reference W24 Embedded Web Server Introduction W24 includes a web server that handles HTTP 1.0/1.1 web interactions independently of its host processor. It allows system designers to build web-based products, which can be remotely monitored, configured, and managed via the Internet using a standard web browser interface. W24 devices host two on-chip websites stored in non-volatile memory. 
- 
                                
                                W24 Embedded Web Server In Host interaction mode, W24 is used to host, serve, and manage web interactions with a remote web browser on behalf of the embedded device's host processor. The host gains access to the web-based parameters via AT+i commands sent to W24 through the serial connection.. Figure 2-7: W24 Web Server Modes The Application Website The application website is stored in non-volatile memory. 
- 
                                
                                Chapter 2: AT+i Commands Reference The configuration site includes web forms to monitor and update most W24 parameters and an upload page consisting of file upload forms. Note that, the following W24 parameters cannot be configured remotely and are therefore not displayed on W24's configuration website: • WiFi security parameters • Fast USART parameter (BDRD) • Analog-to-digital converter (ADC) parameters Each upload form allows file uploading using the POST method for a single file. 
- 
                                
                                W24 Embedded Web Server and queried using: > AT+itemperature? When the host issues a Set Parameter Tag Value command, W24 links the updated value to the Parameter Tag and stores it in its internal RAM. In response to a browser's GET request, the real value is substituted everywhere in the page where the Parameter Tag exists while the page is being served, on-the-fly. Parameter Tag values are printable ASCII text. 
- 
                                
                                Chapter 2: AT+i Commands Reference Manipulating Variables in the Application Website The application website is composed of HTML or WAP files, which may contain links to internal or external websites, Java Scripts, VB scripts, graphic files, and more (See list of supported file types). Using Parameter Tags, the page can also be used to dynamically display and update values of W24's configuration parameters and device-specific Parameter Tags in the manner described above. 
- 
                                
                                W24 Embedded Web Server