User's Manual

Manuals Brands Connect One Manuals Electronics Nano Socket iWiFi with Internal Antenna

Table Of Contents

AT+i Command Set
- Scope
- AT+i Command Guidelines
- AT+i Command Format
- Escape Code Sequence
- Socket Command Abort
- Flexible Host and Modem Interfaces
- Auto Baud Rate Detection
- High Speed USART
- Reset via Serial Link
- Entering Rescue Mode during Runtime
- Internet Session Hang-Up Procedure (Modem Only)
- Modem Startup
- Analog-to-Digital Converter
- iChip Readiness Indication
- Programming iChip’s Serial Number into Flash Memory
  - +iSNUM — iChip Serial Number
- Programming a Unique ID String into Flash Memory
  - +iUID — Unique ID
General Format
- AT+i Commands by Category
AT+i Result Code Summary
Report Status
- +i[!]RPi — Report Status
- Status Message Format
Connection
- +iBDRA — Forces iChip into Auto Baud Rate Mode
- +iUP — Initiate Internet Session
- +iTUP — Triggered Internet Session Initiation
- +iDOWN — Terminate Internet Session
- +iPING — Send a PING Request to a Remote Server
E-mail Send Commands
- +iEMA — Accept ASCII-Coded Lines for E-Mail Send
- +iEMB — Accept Binary Data for Immediate E-Mail Send
- +iE* — Terminate Binary E-Mail
E-Mail Retrieve
- +iRML — Retrieve Mail List
- +iRMH — Retrieve Mail Header
- +iRMM — Retrieve Mail Message
HTTP Client Interface
- +iRLNK — Retrieve Link
- +iSLNK — Submit A POST Request to A Web Server
SerialNET Mode Initiation
- +iSNMD — Activate SerialNET Mode
Web Server Interface
- +iWWW — Activate Embedded Web Server
- +iWNXT — Retrieve Next Changed Web Parameter
File Transfer Protocol (FTP)
- +i[@]FOPN — FTP Open Session
- +iFDL — FTP Directory Listing
- +iFDNL — FTP Directory Names Listing
- +iFMKD — FTP Make Directory
- +iFCWD — FTP Change Working Directory
- +iFSZ — FTP File Size
- +iFRCV — FTP Receive File
- +iFSTO — FTP Open File for Storage
- +iFAPN — FTP Open File for Appending
- +iFSND — FTP Send File Data
- +iFCLF — FTP Close File
- +iFDEL — FTP Delete File
- +iFCLS — FTP Close Session
Telnet Client
- +iTOPN — Telnet Open Session
- +iTRCV — Telnet Receive Data
- +iTSND — Telnet Send Data Line
- +iTBSN[%] — Telnet Send A Byte Stream
- +iTFSH[%] — Flush Telnet Socket’s Outbound Data
- +iTCLS — Telnet Close Session
Direct Socket Interface
- +iSTCP — Open and Connect A TCP Socket
- +iSUDP — Open A Connectionless UDP Socket
- +iLTCP — Open A TCP Listening Socket
- +iLSST — Get A Listening Socket’s Active Connection Status
- +iSST — Get A Single Socket Status Report
- +iSCS — Get A Socket Connection Status Report
- +iSSND[%] — Send A Byte Stream to A Socket
- +iSRCV — Receive A Byte Stream from A Socket’s Input Buffer
- +iGPNM — Get Peer Name for A Specified Socket
- +iSDMP — Dump Socket Buffer
- +iSFSH[%] — Flush Socket’s Outbound Data
- +iSCLS — Close Socket
Special Modem Commands
- +iMCM — Issue Intermediate Command to Modem
Wireless LAN Mode
- +iWLTR — Wireless LAN Transmission Rate
- +iWLPW — Set WLAN Tx Power
- +iWRFU — WLAN Radio Up
- +iWRFD — WLAN Radio Down
- +iWRST — Reset WLAN Chipset
- +iWLBM — WLAN B Mode
- +iWLGM — WLAN G Mode
- Roaming Mode
- Multiple SSIDs
- iChip Power Save Mode
IP Registration
- E-Mail Registration
- Socket Registration
- Web Server Registration
DHCP Client
DHCP Server
iRouter Mode
- Introduction
- Establishing iRouter mode
- Basic Routing
- Terminating iRouter Mode
- Configuring iChip when in iRouter Mode
- AT+i Interface to iChip
- Baud Rate Settings and Auto Baud Rate
- iRouter and Power Save Mode
- +iSTRR — Start Router
- +iSTPR — Stop Router
Ad-Hoc Networks
- Configuration
- iChip Behavior in Ad-Hoc Mode
Secure Socket Protocol
- Establishing An SSL3/TLS1 Socket Connection
- Sending and Receiving Data over An SSL3/TLS1 Socket
- SSL3/TLS1 Handshake and Session Example
- Secure FTP Session on iChip
- +iSSL — Secure Socket Connection Handshake
- +i[@]FOPS — Secure FTP Open Session
Network Time Client
MIME Encapsulated E-Mail Messages
- iChip-Generated Binary Message Formats
- MIME-Related AT+i Commands and Parameters
  - Binary Attachment Parameters
  - Defining A Textual Body for Binary Messages
- MIME-Encapsulated E-Mail Message Format
Flow Control
- Host ( iChip Software Flow Control
- Software Flow Control Diagram in Binary E-Mail Send
- Software Flow Control During A Socket Send
- Software Flow Control Diagram in Socket Send
- Host ( iChip Hardware Flow Control
Remote Firmware Update
- Introduction
- Updating Firmware from a Remote Server
- +iRFU — Remote Firmware Update
iChip Parameter Update
- Introduction
- Remote Parameter File (RPF) Structure
- Header Parameter Names and Values
- Uploading A Parameters Update File to iChip
iChip Embedded Web Server
- Introduction
- Features
- Web Server Modes
- The Application Website
- Parameter Tags
- iChip Configuration Mode
- Host Interaction Mode
- Website Creation, Packing, and Uploading
- Manipulating Variables in the Application Website
- Security and Restrictions
- Parameter Update Error Handling
- File Types Supported by iChip’s Web Server
iChip RAS Server
- Introduction
- RAS Parameters
- RAS Theory of Operation
SerialNET Theory of Operation
- Introduction
- SerialNET Mode
- Server Devices
- Client Devices
- Automatic SerialNET Server Wake-Up Procedure
- Transmit Packets
- Completing a SerialNET Session
- SerialNET Failed Connection
- Local Serial Port Configuration
- Activation Command
- SerialNET over TELNET
  - Mode of Operation
  - RFC2217 Implementation
File Transfer Protocol (FTP) Theory of Operation
- Introduction
- iChip Family FTP Client Command Set
- iChip FTP Client Operation Mode
- FTP Command Socket
- FTP Receive Flow
Telnet Client Operation
Secure Socket Protocol Theory of Operation
- Introduction
- Generating Certificates for Use with Servers
- Using the OpenSSL Package to Create Certificates
- Creating a Certificate Authority
- Signing a Certificate with a CA Certificate
  - Creating a Certificate Request
  - Using the Test CA to Issue the Certificate
Remote AT+i Service
- Introduction
- Remote AT+i Commands
- Closing A Remote AT+i Session
- Caveats and Restrictions
Nonvolatile Parameter Database
- Parameter Descriptions
- +iFD — Restore All Parameters to Factory Defaults
- Operational Parameters
- ISP Connection Parameters
- Server Profile Parameters
- +iUFn — User Fields and Macro Substitution
- Email Format Parameters
- HTTP Parameters
- RAS Server Parameters
- LAN Parameters
- Wireless LAN Parameters
- IP Registration Parameters
- SerialNET Mode Parameters
- Remote Firmware Update Parameters
- Remote Parameter Update
Note: This default value is shipped from the factory. The AT+iFD command does not restore RPG to this value.
- Secure Socket Protocol Parameters
- DHCP Server Parameters
  - +iDPSZ — DHCP Server Pool Size
  - +iDSLT — DHCP Server Lease Time
- iRouter Parameters
  - +iARS — Automatic Router Start
Appendix A
- MIME content types and subtypes
Appendix B
- Sample Parameter Update File
Appendix C
- NIST Time Servers
Index

International:

Connect One Ltd.

20 Atir Yeda Street

Kfar Saba 44643, Israel

Tel: +972-9-766-0456

Fax: +972-9-766-0461

http://www.connectone.com

USA:

Connect One Semiconductors, Inc.

560 S. Winchester Blvd.

Suite 500

San Jose, CA 95128

Tel: (408) 572-5675

Fax: (408) 572-5601

Pub. No. 20-5000-08_32, November 2008

Programmer’ s Manual

Version 8.32

for iChip™ CO2  

with Firmware Version 722P01

November 2008

AT+i

Summary of content (307 pages)

PAGE 1

AT+i TM Programmer’ s Manual Version 8.32 for iChip™ CO2 with Firmware Version 722P01 November 2008 International: Connect One Ltd. 20 Atir Yeda Street Kfar Saba 44643, Israel Tel: +972-9-766-0456 Fax: +972-9-766-0461 http://www.connectone.com Pub. No. 20-5000-08_32, November 2008 USA: Connect One Semiconductors, Inc. 560 S. Winchester Blvd.
PAGE 2

Discalaimer, Copyrights and Trademarks The information in this document is subject to change without notice and shall not be construed as a commitment on the part of Connect One. Connect One assumes no liability for any errors that may appear in this document. The software described in this document is furnished under a license agreement and may be used or copied only in accordance with the terms of such a license agreement.
PAGE 3

Revision History 20-5000-08_32 Revision History 20-5000-08_32 Version 1.0 3.0 4.0 Date Nov. 1999 Nov. 2000 January 2001 5.0 6.0 February 2001 March 2001 Description Original Release. Updated with iChip LAN support. Updated with AT+i commands for listening sockets and email firmware update. Requires iChip/iChip LAN with Firmware IC602B01 and boot block BBIC0620 or higher.
PAGE 4

Contents Contents 1 AT+i Command Set ............................................................................................... 1-1 1.1 SCOPE .............................................................................................................. 1-1 1.2 AT+I COMMAND GUIDELINES ......................................................................... 1-1 1.3 AT+I COMMAND FORMAT ............................................................................... 1-1 1.4 ESCAPE CODE SEQUENCE .........
PAGE 5

Contents 8 HTTP Client Interface .......................................................................................... 8-1 8.1 8.2 9 +IRLNK — RETRIEVE LINK............................................................................ 8-1 +ISLNK — SUBMIT A POST REQUEST TO A WEB SERVER ............................ 8-3 SerialNET Mode Initiation ................................................................................... 9-1 9.1 +ISNMD — ACTIVATE SERIALNET MODE ...................................
PAGE 6

Contents 14 Special Modem Commands ................................................................................ 14-1 14.1 +IMCM — ISSUE INTERMEDIATE COMMAND TO MODEM ............................. 14-1 15 Wireless LAN Mode ............................................................................................ 15-1 15.1 +IWLTR — WIRELESS LAN TRANSMISSION RATE ...................................... 15-2 15.2 +IWLPW — SET WLAN TX POWER ............................................................
PAGE 7

Contents 21 Secure Socket Protocol ........................................................................................ 21-1 21.1 21.2 21.3 21.4 21.5 21.6 ESTABLISHING AN SSL3/TLS1 SOCKET CONNECTION ................................. 21-1 SENDING AND RECEIVING DATA OVER AN SSL3/TLS1 SOCKET................... 21-1 SSL3/TLS1 HANDSHAKE AND SESSION EXAMPLE ........................................ 21-1 SECURE FTP SESSION ON ICHIP .....................................................................
PAGE 8

Contents 27.12 FILE TYPES SUPPORTED BY ICHIP‘S WEB SERVER ......................................... 27-8 28 iChip RAS Server ................................................................................................ 28-1 28.1 INTRODUCTION .............................................................................................. 28-1 28.2 RAS PARAMETERS ........................................................................................ 28-1 28.3 RAS THEORY OF OPERATION ........................
PAGE 9

Contents 33.1 33.2 33.3 33.4 INTRODUCTION .............................................................................................. 33-1 REMOTE AT+I COMMANDS ........................................................................... 33-1 CLOSING A REMOTE AT+I SESSION .............................................................. 33-1 CAVEATS AND RESTRICTIONS........................................................................ 33-1 34 Nonvolatile Parameter Database.................................
PAGE 10

Contents 34.5 SERVER PROFILE PARAMETERS ................................................................... 34-44 34.5.1 +iLVS — ‘Leave on Server’ Flag ....................................................... 34-44 34.5.2 +iDNSn — Define Domain Name Server IP Address ......................... 34-45 34.5.3 +iSMTP — Define SMTP Server Name .............................................. 34-46 34.5.4 +iSMA — SMTP Authentication Method ............................................ 34-47 34.5.
PAGE 11

Contents 34.11.1 +iWLCH — Wireless LAN Communication Channel ......................... 34-86 34.11.2 +iWLSI — Wireless LAN Service Set Identifier .................................. 34-87 34.11.3 +iWLWM — Wireless LAN WEP Mode.............................................. 34-88 34.11.4 +iWLKI — Wireless LAN Transmission WEP Key Index ................... 34-89 34.11.5 +iWLKn — Wireless LAN WEP Key Array ........................................ 34-90 34.11.6 +iWLPS — Wireless LAN Power Save ...................
PAGE 12

Contents Note: This default value is shipped from the factory. The AT+iFD command does not restore RPG to this value. ...................................................................................... 34-128 34.16 SECURE SOCKET PROTOCOL PARAMETERS ................................................ 34-129 34.16.1 +iCS — Define the SSL3/TLS Cipher Suite ...................................... 34-129 34.16.2 +iCA — Define SSL3/TLS Certificate Authority .............................. 34-130 34.16.
PAGE 13

Figures Figures Figure 7-1 E-Mail Receive (RMM) Flow Diagram ........................................................ 7-5 Figure 23-1 Software Flow Control in Binary E-Mail Send......................................... 24-3 Figure 23-2 Software Flow Control in Socket Send ..................................................... 24-5 Figure 23-3 Minimum Hardware Flow Control Connections....................................... 24-6 Figure 26-1: iChip Web Server Modes .............................................
PAGE 14

Tables Tables Table 2-1 AT+i Commands by Category........................................................................ 2-5 Table 3-1 AT+i Result Code Summary .......................................................................... 3-3 Table 1-1 Report Status Message Format ....................................................................... 4-6 Table 17-1: Server Names Acquired from DHCP Server ............................................. 17-1 Table 22-1 Binary Attachment Parameters ..............
PAGE 15

AT+i Command Set 1 1.1 AT+i Command Set Scope This manual describes Connect One‘s AT+i™ interface standard, protocol, and syntax for the iChip CO2128. 1.2 AT+i Command Guidelines AT+i commands are an extension to the basic AT command set. They are parsed and acted upon by iChip.
PAGE 16

AT+i Command Set If a syntax error is found anywhere in a command line, the remainder of the line is ignored and the I/ERROR result code returned. An AT+i command is accepted by iChip once the previous command has been fully executed, which is normally indicated by the return of an appropriate result code. Due to the fact that iChip is intended for Machine-to-Machine applications, only limited parsing is performed on AT+i commands it receives from the host.
PAGE 17

AT+i Command Set  USART0  USART1  USART2  USB Device (identifies itself as a CDC device)  USB Host (supports only USB Modem class) Available modem interfaces are:  USART0  USART1  USART2  USB Device  USB Host (only Motorola G24 USB GSM modem is supported) As a USB host/device, iChip supports the Full-Speed USB standard (12Mbps). Host-to-iChip interface is selected by setting the value of the Host Interface (HIF) parameter.
PAGE 18

AT+i Command Set In auto baud mode, iChip 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 iChip to allow it to determine the host‘s baud rate. It may also send a complete AT+i command. In any case, iChip detects the A or a character, determines the correct baud rate, and configures its serial channel during the stop bit.
PAGE 19

AT+i Command Set 1.10 Entering Rescue Mode during Runtime The MSEL (Mode Select) input signal of the iChip (see the iChip CO2128 Datasheet), can be used for entering iChip into Rescue mode. If MSEL is pulled low (logical 0) for more than 5 seconds during runtime, iChip waits until MSEL is pulled high (logical 1), performs a software reset and restarts in Rescue mode. In Rescue mode, iChip performs the following operations:  If in SerialNET mode — iChip exits SerialNET mode (changes SNMD value to 0).
PAGE 20

AT+i Command Set  The ADCT parameter defines an interval, in milliseconds, between consecutive queries of the value of the A/D converter‘s register. iChip‘s response time to value changes is up to 40ms. In order to enable the A/D converter polling mechanism, you must, at the very least, set the ADCL, ADCT, and ADCP parameters to a non-zero value. The following table summarizes the behavior of the A/D converter.
PAGE 21

AT+i Command Set I/OK If serial_number is a legal hexadecimal string and is being set for the first time. I/ERROR(068) Serial number already exists. AT+iSNUM=? Returns the message ―String‖ followed by I/OK. 1.16 Programming a Unique ID String into Flash Memory You can use the AT+iUID command to enable programming of a unique 8-character ID string for each iChip in iChip‘s flash memory. 1.16.
PAGE 22

General Format 2 General Format AT+i[[ | #UFn]…] (or ) 2–4 letter command code () or parameter name () Delimiter: '=', '~', '?', ':', ‗,‘ Optional parameter or data. If includes a , as defined above, it must be enclosed in single (‗) or double (―) quotes. The terminating is considered as a terminating quote as well. #UFn User-field macro substitution Carriage Return line terminator (ASCII 13) 2.
PAGE 23

General Format Command [!]EMA: [!]EMB:, [!]E* [!]RML [!]RMH[:] [!]RMM[:] [!]RLNK[:] [!]SLNK: WWW WNXT [!|@]SNMD TOPN TRCV TSND TBSN[%] TFSH[%] TCLS Function Parameters/Description Send E-mail Send textual e-mail Defines the textual contents of the e-mail body. Following this command, several text lines can be sent in sequence. Send binary e-mail Prefixes a binary data stream. The data is encapsulated as a base 64 encoded MIME attachment.

PAGE 24

General Format Command FOPN FOPS FDL FDNL FMKD FCWD FSZ FRCV FSTO FAPN FSND FCLF FDEL FCLS Function Parameters/Description File Transfer Protocol (FTP) Open FTP link Opens an FTP command socket to a remote FTP server. If iChip is not online, it is connected. Once an FTP link is established, it can be used to carry out operations on the server‘s file system. Open secure FTP Opens an FTP link and negotiates an SSL3/TLS1 link connection on the control channel.

PAGE 25

General Format Command Function Parameters/Description Socket Interface STCP:, Socket TCP Opens and connects a TCP socket. If iChip 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 iChip is not online, it is connected. Returns a handle to the socket.

PAGE 26

General Format Command MCM WLTR WLPW WRFU WRFD WRST WLBM WLGM RFU Function Parameters/Description Special Modem Command Interlaced modem Sends an interlaced AT command to the modem command while it is online. Wireless LAN WLAN Sets the maximum allowable WLAN transmission transmisssion rate rate. WLAN Tx power Sets the transmission power of the Marvell WLAN chipset. WLAN radio up Turns on radio transmission of the Marvell WLAN chipset.

PAGE 27

AT+i Result Code Summary 3 AT+i Result Code Summary Response String I/OK I/BUSY I/DONE Denotation I/ONLINE I/OFFLINE I/RCV I/PART I/EOP I/EOM I/MBE I/UPDATE I/ERROR(nnn) nnn 41 43 45 47 49 51 53 55 Command was successfully executed. iChip busy. Command discarded. iChip completed Internet activity; returned to command mode, or entered SerialNET mode. iChip completed Internet activity and returned to command mode, or entered SerialNET mode.

PAGE 28

AT+i Result Code Summary 83 85 SMTP failed RESERVED 84 86 87 Web server IP registration failed E-mail IP registration failed RESERVED RESERVED 88 89 91 93 90 92 94 98 100 102 IP registration failed for all methods specified RESERVED In Always Online mode, connection was lost and re-established A remote host, which had taken over iChip through the LATI port, was disconnected RESERVED Error restoring default parameters No USRN defined 104 106 108 No DNS defined MBX (mailbox) not defined TOA (addres

PAGE 29

AT+i Result Code Summary 225 227 No additional SSL sockets available AT+iSSND command failed because size of stream sent exceeded 2048 bytes 301 303 305 307 HTTP server timeout No URL specified Illegal HTTP port number URL address too long 401 403 No IP address Wireless LAN radio control failed Wireless LAN hardware setup failed Illegal WiFi channel 405 407 501 503 505 507 509 511 513 551 553 555 557 559 Communications platform already active RESERVED Cannot open additional FTP session – all FTP h

PAGE 30

AT+i Result Code Summary AT+i Programmer‘s Manual Version 8.

PAGE 31

Report Status 4 4.1 Report Status +i[!]RPi — Report Status Syntax: AT+i[!]RPi Returns a status report. Parameters: i=0..20 Command Options: i=0 Returns the iChip 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 iChip socket status. i=5 Returns a unique serial number. i=6 Returns current ARP table. i=7 Returns socket buffers utilization bitmap.

PAGE 32

Report Status Default: None Result Code: i=0..20 Status message followed by I/OK. I/ERROR Otherwise AT+i Programmer‘s Manual Version 8.

PAGE 33

Report Status 4.

PAGE 34

Report Status Report Option 10 Format I/(, , , ) port stat -Port Status: 0: Wireless LAN adapter not present 1: Wireless LAN adapter disabled 2: Searching for initial connection 4: Connected 5: Out of range Transfer rate in the range 1..54 Signal level [%], in the range 0..100 Link quality [%], in the range 0..100 AT+i!RP10 xfer rate -sig level -lnk qual -I/OK Returns a report of the current WLAN connection.

PAGE 35

Report Status Report Option Format SSID Up to 32 alphanumeric characters signal_strength 0 - low, 1 - good, 2 - excellent For example: Free Public WiFi,NONE,1 I/OK Note: If no Ad-Hoc networks are detected, only I/OK is returned. 14 Returns a DHCP server table of MAC and IP addresses of all the stations connected to iChip. MAC Address .

PAGE 36

Report Status Report Option Format Free Public WiFi,ADHOC,D2:B3:5B:06:CA:04,NONE,11,69 BlueI,AP,00:0E:2E:55:39:A6,WEP,11,57 private,AP,00:0E:2E:FD:F0:69,WPA,11,74 I/OK Table 4-1 Report Status Message Format AT+i Programmer‘s Manual Version 8.

PAGE 37

Connection 5 5.1 Connection +iBDRA — Forces iChip into Auto Baud Rate Mode Syntax: AT+iBDRA Forces the iChip 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. iChip 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. AT+i Programmer‘s Manual Version 8.

PAGE 38

Connection 5.2 +iUP — Initiate Internet Session Syntax: AT+iUP[:n] Initiates an Internet session by going online. In a dialup/cellular environment, a PPP Internet connection is established. Once online, optionally goes through an IP registration process, as determined by n. Parameters: n=0..1 Default: n=0 Command Options: n=0 Go online. n=1 Go online and carry out the IP registration process according to the relevant registration option parameters.

PAGE 39

Connection 5.3 +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.

PAGE 40

Connection Notes: 1. When going online in one of these modes, iChip activates its web server if the AWS parameter is set (AWS>0). 2. In this mode, iChip does not go offline after a completion of any successful or unsuccessful Internet session started by the host, even if the stay online flag is not used. 3.

PAGE 41

Connection 5.4 +iDOWN — Terminate Internet Session Syntax: AT+iDOWN Performs a software reset. Terminates an ongoing Internet session, goes offline and returns to Command mode. This command is useful in a dialup environment following a command where the stay online flag (!) was specified. All open sockets are closed and the web server deactivated.

PAGE 42

Connection 5.5 +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 iChip‘s DNS (Domain Name Server) settings. The host name may also be specified as an absolute IP address given in DOT form.

PAGE 43

E-mail Send Commands 6 6.1 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: ::={ …}.

PAGE 44

E-mail Send Commands 6.2 +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.

PAGE 45

E-mail Send Commands I/OK If is within limits and after bytes have been received successfully. I/ERROR If is out of bounds, or if a communication error occurred during the Internet session. Notes:  If is larger than 256 bytes, iChip 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, the host processor must respond to iChip‘s flow control characters.

PAGE 46

E-mail Send Commands 6.3 +iE* — Terminate Binary E-Mail Syntax: AT+i[!]E* Terminates the current binary e-mail attachment. Command Options: ! Stay online after completing the command Result Code: I/OK If a binary e-mail attachment is in the process of being defined. The e-mail message is terminated and the SMTP session is then completed and closed. I/ERROR Otherwise Followed by: I/DONE After successfully sending the e-mail. Allow a 2.

PAGE 47

E-Mail Retrieve 7 7.1 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 To acknowledge successful receipt of the command. I/ERROR Otherwise Returns: I/MBE If the mailbox is empty. Otherwise: A list of qualifying e-mail message descriptors, separated by .

PAGE 48

E-Mail Retrieve 7.2 +iRMH — Retrieve Mail Header Syntax: AT+i[!]RMH[:i] Retrieves header of e-mail message from current mailbox. Parameters: 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.

PAGE 49

E-Mail Retrieve 7.3 +iRMM — Retrieve Mail Message Syntax: AT+i[!]RMM[:i] Retrieves contents of e-mail message i from current mailbox. Parameters: i Optional e-mail message index of a qualifying message. If no parameter is used, all e-mails are retrieved. Command Options: i Optional index of a qualifying message, as reported by AT+iRML. ! Stay online after completing the command. Default: Retrieves all pending qualified mail messages. Result Code: I/OK When command is received and about to be processed.

PAGE 50

E-Mail Retrieve email‘s body (contents) are retrieved. If the email message contains a MIME-encapsulated attachment encoded in BASE64, iChip performs the decoding and transfers pure binary data to the host. Binary attachments encoded in a scheme other than BASE64 are returned as-is. E-mails that qualify the Delete E-Mail Filter (DELF) are deleted from the mailbox without being downloaded. Followed by: I/EOP End of Part Message, if message is prefixed with an I/PART line.

PAGE 51

E-Mail Retrieve E-Mail Receive (RMM) Flow Diagram Issue AT+iRMM wait f or I/OK Fetch next Line I/MBE I/ERROR I/RCV I/DONE or I/ONLINE Mailbox is empty END Fetch next Line END Yes I/EOM Mail Message Complete I/Done Other END Line belongs to Mail I/PART I/EOM Parse Part Fields Mail Message complete Binary Attachment Part? No Fetch next line Receive Mail "AS-IS" Yes Attachment Bas e64 Enc oding? No I/EOP Other Fetch Next By te Receiv e "nnn)" Receive decoded binary data belongs L

PAGE 52

HTTP Client Interface 8 8.1 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.

PAGE 53

HTTP Client Interface specified. -orI/ERROR Otherwise. (Always preceded by a 5 seconds silence period.) AT+i Programmer‘s Manual Version 8.

PAGE 54

HTTP Client Interface 8.2 +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.

PAGE 55

SerialNET Mode Initiation 9 9.1 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 iChip to enter SerialNET-overTELNET mode Command Options: AT+i!SNMD Optional Auto-Link mode.

PAGE 56

SerialNET Mode Initiation Note: Before entering SerialNET mode, you must set iChip‘s Host Interface to USART0 (HIF=1) or USART1 (HIF=2). Result Code: I/OK If all minimum required parameters for SerialNET mode operation are defined (HSRV or LPRT and, in a modem environment, also ISP1, USRN, PWD) I/ERROR Otherwise Followed by: I/DONE After successfully activating SerialNET mode when using. Allow a 2.5 seconds delay for iChip re-initialization. -orI/ONLINE After successfully activating SerialNET mode.

PAGE 57

Web Server Interface 10 10.1 Web Server Interface +iWWW — Activate Embedded Web Server Syntax: AT+iWWW[:n] Activates iChip‘s internal web server. Parameters: =Web browser backlog. n represents the number of browsers that can connect to iChip‘s internal web server simultaneously at any given time. Command Options: =1..3 Default: =1 Returns: I/() where, is the iChip local IP address.

PAGE 58

Web Server Interface 10.2 +iWNXT — Retrieve Next Changed Web Parameter Syntax: AT+iWNXT Retrieves the Parameter Tag name and new value of the next changed application web parameter, which has not been retrieved since it has been changed by the remote browser. Returns: = When there are no more remaining changed parameters, a blank terminated line is returned. Followed by: I/O AT+i Programmer‘s Manual Version 8.

PAGE 59

File Transfer Protocol (FTP) 11 File Transfer Protocol (FTP) 11.1 +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.

PAGE 60

File Transfer Protocol (FTP) 11.2 +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.

PAGE 61

File Transfer Protocol (FTP) 11.3 +iFDNL — FTP Directory Names Listing Syntax: AT+iFDNL:[,] Returns the FTP directory name list. Parameters: An open FTP session handle Optional 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.

PAGE 62

File Transfer Protocol (FTP) 11.4 +iFMKD — FTP Make Directory Syntax: AT+iFMKD:, Creates a new directory on the FTP server‘s file system. Parameters: An open FTP session handle Directory pathname Command Options: Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session. Directory name. A new directory will be created under the current directory, as indicated by path.

PAGE 63

File Transfer Protocol (FTP) 11.5 +iFCWD — FTP Change Working Directory Syntax: AT+iFCWD:, Changes the current FTP working directory. Parameters: An open FTP session handle New directory path name 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 new directory. The special directory ―..‖ signifies ―one directory up‖.

PAGE 64

File Transfer Protocol (FTP) 11.6 +iFSZ — FTP File Size Syntax: AT+iFSZ:, Reports an FTP file size. Parameters: An open FTP session handle 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 path name of the remote file.

PAGE 65

File Transfer Protocol (FTP) 11.7 +iFRCV — FTP Receive File Syntax: AT+iFRCV:, Downloads a file from an FTP server. Parameters: An open FTP session handle 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 path name of the remote file. Result Code: I/OK When command has been received and about to be processed.

PAGE 66

File Transfer Protocol (FTP) 11.8 +iFSTO — FTP Open File for Storage Syntax: AT+iFSTO:,[,] Opens a remote FTP server file for upload. Parameters: An open FTP session handle Destination file pathname Optional size in bytes to reserve for the file on the remote FTP server Command Options: Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session.

PAGE 67

File Transfer Protocol (FTP) 11.9 +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.

PAGE 68

File Transfer Protocol (FTP) 11.10 +iFSND — FTP Send File Data Syntax: AT+iFSND:,: Uploads data to a remote FTP server file. Valid only after a successful AT+iFSTO or AT+iFAPN command. Parameters: An open FTP session handle The exact size of the data stream that follows A byte stream of size composing the remote file contents Command Options: Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session.

PAGE 69

File Transfer Protocol (FTP) 11.11 +iFCLF — FTP Close File Syntax: AT+iFCLF: Closes a file downloaded to a remote FTP server. Only valid after a successful AT+iFSTO or AT+iFAPN command and optional AT+iFSND commands. Parameters: An open FTP session handle Command Options: Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session. Result Code: I/OK After successfully closing the file.

PAGE 70

File Transfer Protocol (FTP) 11.12 +iFDEL — FTP Delete File Syntax: AT+iFDEL:, Deletes a remote FTP file. Parameters: An open FTP session handle 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 After successfully deleting the remote file.

PAGE 71

File Transfer Protocol (FTP) 11.13 +iFCLS — FTP Close Session Syntax: AT+i[!]FCLS: Closes the FTP link. Parameters: An open FTP session handle Command Options: Must have been obtained by a previous execution of an AT+iFOPN command during the current Internet mode session. ! Stay online after completing the command Result Code: I/OK When command has been received and about to be processed.

PAGE 72

Telnet Client 12 12.1 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 iChip‘s DNS (Domain Name Server) settings. The server name may also be specified as an absolute IP address given in DOT form.

PAGE 73

Telnet Client 12.2 +iTRCV — Telnet Receive Data Syntax: AT+iTRCV[:] Receives data from the Telnet server. Parameters: Optionally specifies the maximum number of bytes to transfer. Result Code: I/ERROR If no Telnet session is open or otherwise some error has occurred. Returns: I/[:] where, is the exact size of the binary data stream to follow. If the socket input buffer is empty, iChip returns I/O. In this case the (:) and are omitted.

PAGE 74

Telnet Client 12.3 +iTSND — Telnet Send Data Line Syntax: AT+iTSND: Sends data to the remote Telnet server. Parameters: A line of data bytes to be sent to the Telnet server. iChip terminates the with a and sends it to the Telnet server. Command Options: If the line to be sent incorporates iChip delimiter characters (, ; : ; = ; ~), must be enclosed in single (‗) or double (―) quotes.

PAGE 75

Telnet Client 12.4 +iTBSN[%] — Telnet Send A Byte Stream Syntax: AT+iTBSN[%]:: Sends a byte stream of size to the Telnet server. Parameters: The exact size of the byte stream that follows. A byte stream of size to be sent to the Telnet server. Command Options: 0..4GB An 8-bit byte stream of exactly size . If is larger than 256 bytes, iChip assumes host flow control.

PAGE 76

Telnet Client 12.5 +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, iChip flushes and waits for the Telnet server receipt acknowledgment of all outstanding outbound data. Result Code: I/OK If all outbound data has been received and acknowledged by the Telnet server. I/ERROR Otherwise AT+i Programmer‘s Manual Version 8.

PAGE 77

Telnet Client 12.6 +iTCLS — Telnet Close Session Syntax: AT+i[!]TCLS Closes the Telnet link. Command Options: ! Stay online after completing the command Result Code: I/OK If an active Telnet socket exists. Followed by: I/DONE When the Telnet link was the last open socket and after successfully closing the Telnet link. Allow a 2.5 seconds delay for iChip re-initialization following an Internet mode session.

PAGE 78

Direct Socket Interface 13 Direct Socket Interface 13.1 +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..

PAGE 79

Direct Socket Interface 13.2 +iSUDP — Open A Connectionless UDP Socket Syntax: AT+iSUDP:,[,] Opens a UDP (User Datagram Protocol) socket and sets the remote system‘s : address. Parameters: Logical name of the target server or a host IP address, or 0.0.0.0 to open a non-connected socket. Remote port number to send to, or 0 to open a non-connected socket. Optional local UDP port to use.

PAGE 80

Direct Socket Interface 13.3 +iLTCP — Open A TCP Listening Socket Syntax: AT+iLTCP:, Opens a TCP listening socket on the local IP address and the specified port . The parameter specifies the maximum number of remote concurrent connections allowed through the listening socket. Parameters: 0..65535 1..10 Command Options: Listening port to be used by a remote system when connecting to iChip.

PAGE 81

Direct Socket Interface 13.4 +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 . Parameters: A TCP listening socket handle of an open listening socket. Command Options: Must have been obtained by a previous AT+iLTCP command during the current Internet session. Result Code: I/(,…,) A list of active socket handles.

PAGE 82

Direct Socket Interface 13.5 +iSST — Get A Single Socket Status Report Syntax: AT+iSST: Retrieves a socket status report for a single socket. This is a subset of the general AT+iRP4 report command. Parameters: A TCP/UDP socket handle 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.

PAGE 83

Direct Socket Interface 13.6 +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 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.

PAGE 84

Direct Socket Interface 13.7 +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.

PAGE 85

Direct Socket Interface command is issued. When using a UDP socket, every SSND command generates and flushes a packet. Result Code: I/OK After sz bytes have been transferred successfully to the socket‘s output buffer. I/ERROR Otherwise Note: When iChip is in checksum mode, it calculates the checksum of the data received from host and compares it with checksum sent by host. If the two match, the result code is I/OK. Otherwise, I/ERROR (228) is returned and the data discarded.

PAGE 86

Direct Socket Interface 13.8 +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 iChip‘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.

PAGE 87

Direct Socket Interface I/ERROR If is not an open socket, or otherwise some error occurred. AT+i Programmer‘s Manual Version 8.

PAGE 88

Direct Socket Interface 13.9 +iGPNM — Get Peer Name for A Specified Socket Syntax: AT+iGPNM: Retrieves peer name (:) of a remote connection to a TCP/UDP socket specified by the socket handle . Parameters: 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.

PAGE 89

Direct Socket Interface 13.10 +iSDMP — Dump Socket Buffer Syntax: AT+iSDMP: Dumps all buffered data currently accumulated in a TCP socket‘s inbound buffer. The socket remains open. Parameters: A TCP socket handle of an open socket Command Options: Must have been obtained by a previous execution of an AT+iSTCP command during the current Internet mode session. Or a socket accepted by a listening socket. Result Code: I/OK If is a handle to an open socket.

PAGE 90

Direct Socket Interface 13.11 +iSFSH[%] — Flush Socket’s Outbound Data Syntax: AT+iSFSH[%]: Flushes (immediately sends) accumulated data in a TCP socket‘s outbound buffer. Parameters: A TCP socket handle of an open socket Command Options: Must have been obtained by a previous execution of an AT+iSTCP command during the current Internet mode session. Or a socket accepted by a listening socket.

PAGE 91

Direct Socket Interface 13.12 +iSCLS — Close Socket Syntax: AT+i[!]SCLS: Closes a TCP/UDP socket. If the socket is the only open socket and the stay online flag (!) is not specified, iChip terminates the Internet session and goes offline. Parameters: A TCP/UDP socket handle of an open socket Command Options: Must have been obtained by a previous execution of an AT+iLTCP, AT+iSTCP or AT+iSUDP command during the current Internet mode session. Or a socket accepted by a listening socket.

PAGE 92

Special Modem Commands 14 Special Modem Commands 14.1 +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: iChip puts the modem in command mode by issuing the (+++) escape sequence and then sends to the modem, followed by a . must include the AT prefix.

PAGE 93

Wireless LAN Mode 15 Wireless LAN Mode The iChip includes a Wireless LAN driver for the Marvell 88W8686 802.11b/g WiFi chipset. In addition, the iChip 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.

PAGE 94

Wireless LAN Mode 15.1 +iWLTR — Wireless LAN Transmission Rate Syntax: AT+iWLTR= Sets the maximum allowable wireless LAN transmission rate. After a SW reset, WLTR returns to its default value (54 Mbps). Parameters: tr=0..13 Command Options: tr=0 Maximum supported transmission rate (54 MBps) tr=1 Limited to 1 Mbps tr=2 Limited to 2 Mbps tr=3 Limited to 5.

PAGE 95

Wireless LAN Mode 15.2 +iWLPW — Set WLAN Tx Power Syntax: AT+iWLPW= Sets the transmission power of the Marvell WLAN chipset. Parameters: n=0-20 n=0 Use Marvell‘s automatic power level adaptation scheme. n=1-20 Set a fixed transmission power level. Default: n=0 Result Code: I/OK If power set succeeded I/ERROR (042) If n is an illegal value -orI/ERROR (402) If power set failed AT+i Programmer‘s Manual Version 8.

PAGE 96

Wireless LAN Mode 15.3 +iWRFU — WLAN Radio Up Syntax: AT+iWRFU Turns on radio transmission of the Marvell WLAN chipset. Parameters: None Result Code: I/OK If operation succeeded I/ERROR (403) Otherwise AT+i Programmer‘s Manual Version 8.

PAGE 97

Wireless LAN Mode 15.4 +iWRFD — WLAN Radio Down Syntax: AT+iWRFD Turns off radio transmission of the Marvell WLAN chipset. Parameters: None Result Code: I/OK If operation succeeded I/ERROR (403) Otherwise AT+i Programmer‘s Manual Version 8.

PAGE 98

Wireless LAN Mode 15.5 +iWRST — Reset WLAN Chipset Syntax: AT+iWRST Performs a hardware reset of the Marvell WLAN chipset. Parameters: None Result Code: I/OK If operation succeeded I/ERROR (404) Otherwise AT+i Programmer‘s Manual Version 8.

PAGE 99

Wireless LAN Mode 15.6 +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 AT+i Programmer‘s Manual Version 8.

PAGE 100

Wireless LAN Mode 15.7 +iWLGM — WLAN G Mode Syntax: AT+iWLGM Sets the Marvell WLAN chipset to 802.11/g mode. Allowable Tx transmission rates for this mode are: 6, 9, 12, 18, 24, 36, 48 and 54 Mbps. Parameters: None Result Code: I/OK Always AT+i Programmer‘s Manual Version 8.

PAGE 101

Wireless LAN Mode 15.8 Roaming Mode When set to operate in Roaming mode, iChip can roam seamlessly among Access Points (APs) sharing the same SSID and the same security configuration without interrupting its IP connectivity. iChip also has a monitoring mechanism that is sensitive to drops in AP signal strength. When iChip detects such a drop, it automatically starts searching for APs in its vicinity that have a stronger signal, while remaining connected to the current AP.

PAGE 102

Wireless LAN Mode When in Roaming mode, iChip does not restart its DHCP client process for new connections. When iChip is not in Roaming mode, iChip remains connected to an AP as long as it has an open active socket, or until triggered by a Link Lost event. When not in Roaming mode, iChip ignores any decrease in AP signal strength while having open active sockets.

PAGE 103

Wireless LAN Mode 15.10 iChip Power Save Mode iChip has a Power Save mode for achieving energy savings. You enable Power Save mode by setting the PSE parameter to any value n between 1 and 255 seconds. When n seconds have elapsed without any activity on the host or modem serial ports, iChip shuts down most of its circuits. Renewed activity on the serial ports, or incoming data from the LAN, restores iChip to full operational mode.

PAGE 104

IP Registration 16 IP Registration When iChip 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 iChip 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.

PAGE 105

IP Registration 16.2 Socket Registration iChip registers itself by opening a socket to a registration server and sending its ID information and current IP address. When iChip‘s RRSV parameter contains a value, iChip establishes a socket to the server defined in RRSV during the registration procedure.

PAGE 106

DHCP Client 17 DHCP Client A DHCP client component in iChip in LAN mode supports IP and server name acquisition from a standard DHCP Server. The iChip 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 iChip‘s IPA (IP Address) parameter contains the assigned IP address retrieved from the DHCP server.

PAGE 107

iRouter Mode 18 DHCP Server iChip‘s DHCP server allows it to assign IP addresses and manage a network segment when no DHCP server is available. iChip‘s DHCP server can handle a pool of up to 255 IP addresses concurrently. This may be usefull, for example, when iChip is configured to operate in iRouter mode and provides access to the public internet via its modem connection.

PAGE 108

iRouter Mode 19 iRouter Mode 19.1 Introduction iChip‘s iRouter mode is used to provide a gateway to a multitude of LAN or WiFi devices through a single dialup or cellular link. In this configuration, iChip‘s DHCP server may be used to assign IP addresses to the local hosts on the LAN/WiFi side. iChip also uses a Network Address Translator (NAT) to translate between local and public IP addresses. While routing IP packets, iChip also accepts AT+i commands, as during normal operation.

PAGE 109

iRouter Mode Note: When using an FTP client to connect to an external FTP server through the iRouter, you must use the FTP client in passive mode. For example, if the FTP client is an iChip, you must open the FTP session using AT+i@FTP. 19.4 Terminating iRouter Mode iRouter mode is terminated by any of the following occurrences:  By issuing the AT+iSTPR (Stop Routing) command. When iChip receives this command, routing services are stopped and iChip goes offline on the dialup/cellular side.

PAGE 110

iRouter Mode 19.6 AT+i Interface to iChip In addition to configuring the iChip, AT+i commands can also be used to perform operations on either the LAN/WiFi or dialup/cellular communication platform. Using the CPF (Communication Platform) parameter, you can select either one of the communication platforms. When CPF=0, AT+i commands are directed towards the dialup/cellular side; when CPF=1, they are directed towards the LAN/WiFi side.

PAGE 111

iRouter Mode 19.9 +iSTRR — Start Router Syntax: AT+iSTRR Causes iChip to immediately enter iRouter mode. Upon entering iRouter mode, iChip immediately goes online on the dialup/cellular side. Packets are not buffered during dialup/cellular connection establishment. After establishing the connection, iChip starts the routing service. Result Code: I/OK When command is received and about to be processed. Followed by: I/ONLINE After successfully going online on the dialup/cellular side.

PAGE 112

iRouter Mode 19.10 +iSTPR — Stop Router Syntax: AT+iSTPR Causes iChip to exit iRouter mode, go offline on the dialup/cellular side, and stop routing packets. If ARS=1 (Auto Routing), iChip 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. Followed by: I/ONLINE After terminating the connection on the dialup/cellular side when CPF=1.

PAGE 113

Ad-Hoc Networks 20 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.

PAGE 114

iRouter Mode 20.2.4 Merging Ad-Hoc Networks When iChip is configured to operate in Ad-Hoc mode it 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, it initiates a procedure for merging the networks. Networks will merge into one, provided they operate on the same channel. AT+i Programmer‘s Manual Version 8.

PAGE 115

Secure Socket Protocol 21 Secure Socket Protocol iChip supports the SSL3/TLS1 secure socket protocol, based on RFC2246. iChip 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 21.1 Establishing An SSL3/TLS1 Socket Connection iChip supports a single SSL3/TLS1 TCP/IP active socket connection. Opening a secure socket on iChip involves two steps: 1.

PAGE 116

Secure Socket Protocol AT+iSTCP:secure.sslserver.com,1503 Open a TCP/IP socket to a secure application. I/000 iChip opens socket and returns handle 0. AT+iSSL:0 iChip 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. iChip encrypts data and sends cipher text over the Internet.

PAGE 117

Secure Socket Protocol When the AT+iFOPS command is used to initiate a secure FTP session, iChip performs the following operations: 1. Opens an FTP control socket. 2. Sends AUTH TLS. 3. Performs the SSL3/TLS1 handshake. 4. Sends USER command. 5. Sends PASS command. 6. Sends PBSZ 0, followed by PROT P. Once the data channel TCP socket is established, all subsequent data connections (send or retrieve files as well as directory listings) start with an SSL3/TLS1 handshake.

PAGE 118

Secure Socket Protocol 21.5 +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.

PAGE 119

Secure Socket Protocol 21.6 +i[@]FOPS — Secure FTP Open Session Syntax: AT+i[@]FOPS:[,]:,[,] Opens a secure FTP link to a secure FTP server. Parameters: Logical name of the FTP server or the server‘s IP address.

PAGE 120

Network Time Client 22 Network Time Client iChip incorporates a Simple Network Time Protocol (SNTP) client. With this protocol support, iChip can be configured to check SNTP servers for current time and date each time it goes online. iChip 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-OfDay (TOD) registers at least once, iChip continues to keep track of time independently, even after it goes offline.

PAGE 121

MIME Encapsulated E-Mail Messages 23 MIME Encapsulated E-Mail Messages 23.1 iChip-Generated Binary Message Formats Binary e-mail messages are sent via iChip 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 iChip to the main message header: X-Mailer: iChip Message-ID: @iChip Mime-Version: 1.

PAGE 122

MIME Encapsulated E-Mail Messages AT+i commands may be interlaced within a sequence of AT+iEMB commands, except for the following AT+i commands: AT+iEMA, AT+iRML, AT+iRMH, AT+iRMM, AT+iRFU, AT+iRLNK, AT+iBDRA, and AT+iSNMD. iChip does not limit the size of the binary attachment. However, ISPs do have limitations. An Internet connection is initiated immediately after the first AT+iEMB command, while the rest of the command is received.

PAGE 123

MIME Encapsulated E-Mail Messages 23.3 MIME-Encapsulated E-Mail Message Format Note: Bold lines are added by iChip. 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.6/PA) with SMTP id OAA11594; Mon, 22 Nov 1999 14:18:03 +0200 (IST) Date: Mon, 22 Nov 1999 14:18:03 +0200 (IST) From: lims@connectone.com To: lims@connectone.com To: connect1@inter.net.il To: gadyl@netvision.net.

PAGE 124

Flow Control 24 Flow Control 24.1 Host  iChip 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 iChip. At times, this stream may be very large. Once iChip establishes a connection, it acts as a pipeline, transferring data received from the host to the Internet.

PAGE 125

Flow Control The control characters are defined as: Control ASCII Dec ASCII Hex Mnemonic WAIT 22 0x16 SYN CONTINUE 24 0x18 CAN ERROR 5 0x5 ENQ Table 24-1 Software Flow Control Characters AT+i Programmer‘s Manual Version 8.

PAGE 126

Flow Control 24.2 Software Flow Control Diagram in Binary E-Mail Send ISSUE AT+iEBA, No SZ>256 Yes Send Bytes Wait for I/ OK Send Next Byte Byte Received from iChip? END No Wait for I/ Error(nnn) Yes No Yes No Error code? Wait code? Yes Yes Yes Byte Received from iChip? No Error code? No Yes Continue code? No Yes Figure 24-1 Software Flow Control in Binary E-Mail Send AT+i Programmer‘s Manual Version 8.

PAGE 127

Flow Control 24.3 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.

PAGE 128

Flow Control 24.4 Software Flow Control Diagram in Socket Send ISSUE AT+iSSND:,: No SZ>256 Yes Send Bytes Wait for I/OK Send Next Byte Byte Received from iChip ? END Yes No Wait for I/Error(nnn) Yes Error code? No No Wait code? Yes Wait for RP4 reply Yes Yes No Byte from iChip? Received Error code? No Yes Yes Yes Continue code? Pause? No No Issue "- - - " End Figure 24-2 Software Flow Control in Socket Send AT+i Programmer‘s Manual Version 8.

PAGE 129

Flow Control 24.5 Host  iChip Hardware Flow Control As an alternative to the software flow control method, which requires some software attention on behalf of the host, iChip offers a hardware flow control mode. This mode is selected by setting iChip‘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 iChip returns I/ERROR (063).

PAGE 130

Remote Firmware Update 25 Remote Firmware Update 25.1 Introduction iChip 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 iChip acting as a client. iChip 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. 25.

PAGE 131

Remote Firmware Update 2. If the download fails, iChip returns an error message and continues to work as before. 3. If during the download iChip is going over a reset cycle (SW or HW), iChip re-boots and executes the old firmware. 4. If the download is successful, iChip authenticates the firmware image file. 5. iChip replaces the old image with the new image. 6.

PAGE 132

Remote Firmware Update 25.3 +iRFU — Remote Firmware Update Syntax: AT+iRFU Downloads and updates iChip firmware from a remote HTTP or FTP server. The value of the USRV parameter is used to determine the remote server from which to download the firmware. The value of the UEN flag is used to determine whether to update any firmware version or only a version that is newer than the one already installed.

PAGE 133

iChip Parameter Update 26 iChip Parameter Update 26.1 Introduction The iChip remote parameter update file allows users to remotely modify various nonvolatile parameters in iChip 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.

PAGE 134

iChip Parameter Update 26.3 Header Parameter Names and Values Name Value Default RP_DEST NONE RP_GROUP Single string, no space characters RP_START_FROM_FACTORY_DEFAULTS YES/NO NO NONE Table 26-1 Header Parameter Names and Values  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.

PAGE 135

iChip Parameter Update 26.4 Uploading A Parameters Update File to iChip By default, receiving and processing a parameters update file is disabled in the iChip. To enable this option, the RPG parameter must be set to some value. If a value other than (*) is set, the value must match the parameters update file RP_GROUP value. This feature facilitates group updates, and can be used as a password to secure parameter updates.

PAGE 136

iChip Embedded Web Server 27 iChip Embedded Web Server 27.1 Introduction iChip 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. iChip devices host two on-chip websites stored in non-volatile memory.

PAGE 137

iChip Embedded Web Server 27.3 Web Server Modes Two web server modes are defined as (see figure below):  iChip configuration mode  Host interaction mode Each of these modes is supported by a dedicated website and a parameter access password. The iChip configuration mode allows remote iChip configuration. It encompasses web interactions between iChip and a remote browser to carry out iChip parameter maintenance and iChip firmware and application website uploads.

PAGE 138

iChip Embedded Web Server 27.5 Parameter Tags iChip and host real-time parameters can be referred to in the embedded websites through the use of Parameter Tags. When Parameter Tags are placed in an HTML web page, actual values are sent by iChip‘s web server component when the page is served out. Parameter Tags are also used to change corresponding parameter values from a remote web browser. Syntactically, Parameter Tags are parameter names enclosed between two (~) characters.

PAGE 139

iChip Embedded Web Server resolve this problem, iChip includes a recovery website. This website allows a user at the remote browser end to upload the .imz file again in order to restore iChip‘s internal website. iChip‘s configuration site is located at: HTTP:///ichip/ 27.7 Host Interaction Mode Host Interaction mode allows OEMs to design and implement a product-related embedded website that is managed by iChip on behalf of the host.

PAGE 140

iChip Embedded Web Server Parameter Tag values can be changed and submitted from the browser end using HTML forms. iChip stores the updated values and responds appropriately to host AT+i parameter query commands. Thus, the host can poll specific parameters for value changes. Status Report 7 (AT+iRP7) can be used to facilitate polling on all application web parameters. RP7 returns a bitmap result, where bit 10 is set to ‗1‘ if one or more application web parameters have been remotely changed.

PAGE 141

iChip Embedded Web Server For example, to display the current value of the headline web parameter, enter ~headline~ anywhere on the page, as in the following example: SAMPLE PAGE
~headline~
When serving this home page, iChip‘s web server replaces the ~headline~ string in the served page with the current value of that parameter.

PAGE 142

iChip Embedded Web Server In addition to specifying iChip configuration parameters and Parameter Tags, it is also possible to display iChip reports and iChip‘s LAN MAC address. For example:

MAC Address: ~MACA~

Bootblock Version: BBIC~RP3~ Firmware Version: ~RP1~

Serial Number: ~RP5~ Hardware Version: ~RP0~

27.

PAGE 143

iChip Embedded Web Server The Parameter Tags defined in the application website are secured from remote updates in the same manner as the iChip configuration parameters. In this case, the authentication password is stored in iChip‘s local parameter WPWD (Web Password). If the WPWD parameter contains a value, a remote user needs to issue this value as an authentication password in order to gain update access to the application level Parameter Tags.

PAGE 144

iChip RAS Server 28 iChip RAS Server 28.1 Introduction iChip features an internal Remote Access Server (RAS) that allows a remote dialer to dial into iChip using an active modem platform. When configured as RAS, iChip answers the incoming call and negotiates a PPP connection. iChip‘s RAS supports acknowledging an IP address request from the remote dialer side, as well as assigning a default IP address. Once the connection is established, the client can browse iChip‘s website.

PAGE 145

iChip RAS Server 28.3 RAS Theory of Operation When a remote client dials into iChip, the modem RING strings are transferred by iChip (which defaults to transparent mode) to the host. When the RAS feature is enabled (RAU contains a value), iChip picks up the line and negotiates a PPP connection by issuing the ATA (modem) command after RAR RING strings have been received.

PAGE 146

iChip RAS Server iChip defers to PPP negotiation. The (~) is the last character transmitted to the host end to signal that iChip has taken over the negotiations. Upon this event, iChip continues to negotiate a PPP connection internally in a manner similar to the procedure that occurs when iChip picks up the line after receiving RING strings.

PAGE 147

SerialNET Theory of Operation 29 SerialNET Theory of Operation 29.1 Introduction iChip‘s SerialNET mode extends a local asynchronous serial link to a TCP or UDP socket across a LAN or Internet. Its main purpose is to allow simple devices, which normally interact over a serial line, to interact in a similar fashion across a network without requiring any changes in the device itself.

PAGE 148

SerialNET Theory of Operation 29.3 Server Devices Server devices linger until approached by a remote client. The remote client must know iChip‘s IP and listening port address in order to establish communications. LAN-based devices and dial-up devices linger differently. A LAN device is normally online and may thus have an associated listening (passive) socket ready to accept remote socket connections. While in SerialNET mode, iChip establishes a listening socket on the port defined in its LPRT parameter.

PAGE 149

SerialNET Theory of Operation Once the socket connection is established, iChip transmits the buffered data collected during the connection period. The MBTB parameter dictates the maximum number of bytes to buffer. If additional bytes are received on the serial port before the connection is established, they are discarded. iChip will dial-up the ISP to establish an Internet connection before attempting to open the server socket.

PAGE 150

SerialNET Theory of Operation atomic, maintaining their original size. When a TCP connection is used, packets can be combined before being actually transmitted. This follows from the stream nature of the TCP protocol. Data originating in the remote system is routed to the local device as it is made available. Flow control can be governed locally using hardware flow control only. The PTD parameter can be used to define the number of packets to be cyclically discarded in a SerialNET mode session.

PAGE 151

SerialNET Theory of Operation If the iChip is online at the time this command is issued, it closes the Internet session in an orderly manner. This includes closing all open sockets and disconnecting from the ISP in a modem environment. When iChip boots up in SerialNET mode, it sets the host serial channel to the fixed baud rate and serial interface parameters defined in the SNSI parameter.

PAGE 152

SerialNET Theory of Operation 29.11.1 Mode of Operation SerialNET over TELNET mode expands the Auto-Link mode (!SNMD). In this mode, iChip immediately goes online upon activating SerialNET, regardless of whether serial data has arrived or not. If the LPRT (Listening Port) parameter is defined, iChip opens a listening port and awaits a connection, and so it acts as a TELNET server.

PAGE 153

SerialNET Theory of Operation  Add the ability for the host device to inform the remote side about signal changes in CTS and DSR.  Add the ability for the remote side to change the value of the RTS and DTR signals of the host device.  Add the ability to exchange BREAK signal indications between the host device and the remote side. The table below lists the RFC2217 options and sub-options supported by iChip. Note that iChip does not send any replies to commands or command values not supported.

PAGE 154

File Transfer Protocol (FTP) Theory of Operation 30 File Transfer Protocol (FTP) Theory of Operation 30.1 Introduction The FTP client component in iChip extends iChip‘s general-purpose sockets to incorporate an additional, dedicated socket for FTP activities. From the host‘s perspective, the FTP capabilities are a logical extension of the capabilities of e-mail and direct socket manipulation. As in all other iChip protocol implementations, host involvement in the specifics of FTP is minimal.

PAGE 155

File Transfer Protocol (FTP) Theory of Operation 30.5 FTP Receive Flow Issue: AT+iFRCV Command I/OK ? I/ERROR Return I/ERROR YES I/ ? I/ERROR Return I/ERROR YES equals 0 ? YES Accumulate Quiet Time NO NO Accumulate Quiet Time NO 5 secs. Quiet ? NO FTP Data Available? FTP Data Available? YES Next chars. I/ERROR? YES NO YES YES NO Retrieve FTP Data Retrieve FTP Data Decrement Reset Quiet Time Reset Quiet Time NO Return I/ERROR 5 secs. Quiet ? NO Next chars.

PAGE 156

Telnet Client Operation 31 Telnet Client Operation There are four operation modes for most Telnet applications, namely, half-duplex, character at a time, line at a time, and line mode. iChip incorporates two methods to send data to the remote Telnet server: One line at a time, namely, an AT+i command (+iTSND) is used to send a single (CR/LF terminated line to the Telnet server); and Binary Transmission, where an AT+i command (+iTBSN) is used to send an arbitrary amount of binary data.

PAGE 157

Secure Socket Protocol Theory of Operation 32 Secure Socket Protocol Theory of Operation 32.1 Introduction iChip implements an SSL3/TLS1 client socket connection. When connecting to an SSL3/TLS1 server, iChip negotiates an SSL3/TLS1 secure connection. During the negotiation process, the server identifies itself to the client (iChip) by sending a certificate. The certificate‘s main purpose is to allow iChip to determine that the server is indeed the server it claims to be.

PAGE 158

Secure Socket Protocol Theory of Operation to create an in-house Certificate Authority, sign your own certificates, and generate the proper requests in order to receive a signed certificate from a commercial CA. The signed certificates can then be installed on servers to which iChip will connect in a secure (SSL3/TLS1) manner. 32.4 Creating a Certificate Authority The certificate generated using the following steps can be used in deployed systems, in which you are the trusted authority.

PAGE 159

Secure Socket Protocol Theory of Operation [ CA_default_policy ] commonName = supplied stateOrProvinceName = supplied countryName = supplied emailAddress = supplied organizationName = supplied organizationalUnitName = optional [ certificate_extensions ] basicConstraints = CA:false [ req ] dir = /testCA default_bits = 1024 default_keyfile = $dir/private/caprivkey.

PAGE 160

Secure Socket Protocol Theory of Operation 2. Enter the command for generating the self-signed root certificate (all text is a single command typed on one line): openssl req –x509 –newkey rsa:1024 –out cacert.pem –outform PEM 3. You are prompted to enter a PEM pass phrase. This is your password to the CA private key. It is essential for the security of the system that both this password and the CA private key are kept secret. An encrypted caprivkey.

PAGE 161

Secure Socket Protocol Theory of Operation openssl req –newkey rsa:1024 –keyout myprivkey.pem –keyform PEM –out myreq.pem –outform PEM If you do not want an encrypted private key, add –nodes to the above command. At the conclusion of this step two new files are created. The myprivkey.pem file contains the encrypted private key. This file must never be shared, not even with the CA. The other file is the certificate request file, myreq.pem, which will be used by the CA to create the final signed certificate.

PAGE 162

Remote AT+i Service 33 Remote AT+i Service 33.1 Introduction The LATI parameter allows configuring iChip to maintain a communication channel that supports interacting with iChip from a remote location using the AT+i command set as if the commands are administered through the local serial port. When LATI is set to a nonzero value, iChip opens a TCP listening socket on port . In a dial-up environment, this occurs only after the PPP connection is established.

PAGE 163

Remote AT+i Service iChip LAN will then return to auto baud rate detect mode when and if the local host or the remote client close the LATI session, in effect re-starting iChip LAN.  During a remote AT+i session, the remote client taking over the parser cannot make use of iChip‘s mechanisms of Hardware or Software flow control, which exist for the local host port. The only mechanism iChip will use is this mode is TCP level flow control (using the TCP window).

PAGE 164

Nonvolatile Parameter Database 34 Nonvolatile Parameter Database 34.1 Parameter Descriptions Parameter Type Range Default Operational Description XRC DMD Byte Byte 0..4 0..2 4 0 MIS String 126 chars MTYP WTC Byte Byte 0..11 0..255 ―AT&FE0V 1X4Q0&D2 M1L3\r‖ 0 45 TTO INT 0..3600 0 PGT Unsigned INT 0-65535 0 [mSec] MPS TTR Byte INT 0 (1500) 3000 [mSec] BDRF Byte 0..3 1000.. 65535 3..9|‗a‘| ‗h‘ BDRM Byte 3..

PAGE 165

Nonvolatile Parameter Database Parameter Type Range ADCP INT 0-96 RRA RRHW Byte INT 0-6 0-96 ISPn ATH Phone # Byte 96 chars 0..2 USRN PWD RDL RTO String String Byte Byte 64 chars 64 chars 0..20 0..3600 LVS DNSn[p] 0..1 SMTP[p] SMA Byte IP address String Byte SMU SMP POP3[p] MBX MPWD NTSn NTOD String String String String String String Byte 64 chars 64 chars 64 chars 64 chars 64 chars 64 chars 0..1 GMTO DSTD Byte String -12..

PAGE 166

Nonvolatile Parameter Database Parameter Type Range XFH Byte 0..1 HDL FLS Byte String 0..255 64 chars DELF SBJ TOA[n] TO String String String String 64 chars 96 chars 64 chars 96 chars REA FRM String String 64 chars 96 chars CCn String 64 chars BDY 96 chars MT Text lines Byte MST String 64 chars FN String 64 chars RRMA String 64 chars RRSV String 64 chars RRWS String RRRL String 128 chars 64 chars HSTN String 64 chars 0..

PAGE 167

Nonvolatile Parameter Database Parameter Type Range URL String CTT String 128 chars 64 chars WPWD String 64 chars RAR Byte 2..20 RAU RAP String String 64 chars 64 chars MACA String 12 chars DIP Default IP address IP address IP address IP address IPA IPG SNET WLCH Byte WLSI WLWM String Byte WLKI Byte WLKn WLPS Hex Key String Byte WLPP String WSEC WROM WPSI WSRL WSRH Default HTTP None Description URL string used for subsequent +iRLNK and +iSLNK commands.

PAGE 168

Nonvolatile Parameter Database Parameter Type Range Default Description 802.11b/g Wireless LAN 32 chars ― (Empty) WLAN SSID for multiple SSIDs 8-63 ― (Empty) Pre-shared key passphrase for multiple chars SSIDs 26 chars ― (Empty) WLAN WEP key for multiple SSIDs 0..4 0 WLAN security type for multiple SSIDs SerialNET Mode 64 chars NULL Set the remote host server name/IP and port. 3 chars NULL Switches among three possible HSRV parameters. 8 chars NULL Set the disconnection string template.

PAGE 169

Nonvolatile Parameter Database Parameter Type UEN Byte RPG String CS Byte CA String CERT PKEY String String DPSZ Byte DSLT INT ARS Byte Range Default Description Remote Firmware Update 0..1 0 Remote Firmware Update flag Remote Parameter Update 64 chars NULL Remote Parameter Update Group/Password Secure Socket Protocol (SSL3/TLS1) 0, 4, 5, 0 Set the cipher suite to be used during 10, 47, (propose SSL3/TLS negotiations.

PAGE 170

Nonvolatile Parameter Database 34.2 +iFD — Restore All Parameters to Factory Defaults Syntax: AT+iFD Restore iChip‘s non-volatile parameter database values to factory defaults. Each of iChip‘s nonvolatile parameters, described in the following section, has an associated default value. This command restores all parameters to their factory default values. This command disables iChip‘s DHCP client. In order to reactivate the DHCP client process, you need to perform a HW or SW reset.

PAGE 171

Nonvolatile Parameter Database 34.3 34.3.1 Operational Parameters +iXRC — Extended Result Code Syntax: AT+iXRC=n Extended Result Code. Same as ATXn. This command selects which subset of the result messages will be used by the modem to inform the Host of the results of commands. Parameters: n=0..4 Command For a detailed description of the command options see the Options: ATXn command in the AT command set manual for the modem in use.

PAGE 172

Nonvolatile Parameter Database 34.3.2 +iDMD — Modem Dial Mode Syntax: AT+iDMD=n Permanently sets the modem dial mode to Tone, Pulse or none. This parameter defines the dial character m used when issuing the ATDm dial command to the modem. Parameters: n=0..

PAGE 173

Nonvolatile Parameter Database 34.3.3 +iMIS — Modem Initialization String Syntax: AT+iMIS=str[;str…] Sets the Modem Initialization String. Parameters: str=Modem initialization string Command Options: str=” Empty: No modem initialization string defined. str= string will be used as the modem initialization string. If string contains special characters, such as quotation marks (‗ or ―), these may be included in string by prefixing each special character with a backslash (‗\‘).

PAGE 174

Nonvolatile Parameter Database 34.3.4 +iMTYP — Set Type of Modem Connected to iChip Syntax: AT+iMTYP=n Sets the modem type. Parameters: n=0..9 Command Options: n=0 Standard, Hayes compatible, dialup modem n=1 Silicon Laboratories Si2400 modem. See note below.

PAGE 175

Nonvolatile Parameter Database 2. AT+iMIS=‖ 3. AT+iBDRF=3 4. AT+iBDRM=3 Note 2 Configuring the iChip to work with GPRS modems: 1. AT+iMTYP=2 – GSM/GPRS modem type 2. AT+iXRC=0 – blind dialing 3. AT+iISP1= (usually *99**1#) 4. AT+iMIS=‖AT+CGDCONT=1,IP,‖ Note 3 Changing from modem type 4 (Falcom GSM): When iChip is configured with MTYP=4, the MTYP parameter must first be changed to the special value 99 before it can be changed to some other value.

PAGE 176

Nonvolatile Parameter Database 34.3.5 +iWTC — Wait Time Constant Syntax: AT+iWTC=n This parameter is used to set the modem register S7 to the required value (using the ―ATS7=n‖ command). Parameters: n=0..255 Command The WTC parameter defines a timeout constant for a Options: variety of modem activities. For a detailed description of this parameter, see the ATS7=n command in the AT command set manual for the modem in use.

PAGE 177

Nonvolatile Parameter Database 34.3.6 +iTTO — TCP Timeout Syntax: AT+iTTO=n Sets the number of seconds iChip allots an Internet transaction to complete before returning the timeout error. Parameters: n=0..3600 seconds Command The TTO parameter defines the timeout constant for Options: Internet transactions. iChip will return with a timeout error for any TCP/UDP/IP transaction that didn‘t complete properly within n±10%.

PAGE 178

Nonvolatile Parameter Database 34.3.7 +iPGT — PING Timeout Syntax: AT+iPGT=n Sets the timeout in milliseconds, after which iChip will reissue a PING request that has not been replied to. Parameters: n=0..65535 milliseconds Command After issuing a PING request, in response to the AT+iPING Options: command, iChip will wait up to n milliseconds for a reply. If a reply is not received, iChip will reissue the PING request. n=0 is a special case where a timeout of 2 seconds is used.

PAGE 179

Nonvolatile Parameter Database 34.3.8 +iMPS — Max PPP Packet Size Syntax: AT+iMPS=n Limits the size of an outgoing PPP packet in dial-up environments. In effect, the MPS parameter limits the iChip‘s MTU (Maximum Transfer Unit). Parameters: n=0..3 Command Options: n=0 1500 bytes n=1 256 bytes n=2 536 bytes n=3 1024 bytes Default: n=0 Result Code: I/OK If n is within limits I/ERROR Otherwise AT+iMPS? Returns current value followed by I/OK. AT+iMPS=? Returns the message ―0-3‖ followed by I/OK.

PAGE 180

Nonvolatile Parameter Database 34.3.9 +iTTR — TCP Retransmit Timeout Syntax: AT+iTTR=n Sets the timeout, in milliseconds, after which an unacknowledged TCP packet will be retransmitted over a PPP connection by iChip. Parameters: n=1000..65535 Default: 3000 milliseconds Result Code: I/OK if n is within limits I/ERROR Otherwise AT+iTTR? Reports the current value followed by I/OK. AT+iTTR=? Returns the message ―1000-65535‖ followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 181

Nonvolatile Parameter Database 34.3.10 +iBDRF — Define A Fixed Baud Rate on Host Connection Syntax: AT+iBDRF= Sets the baud rate on host serial connection. This parameter is saved to nonvolatile memory and activated only after power-up. Parameters: n=3..

PAGE 182

Nonvolatile Parameter Database +iBDRM — Define A Fixed Baud Rate on iChip Modem Connection Syntax: AT+iBDRM= Sets the baud rate on modem connection. This parameter is saved to nonvolatile memory and activated after every powerup. Parameters: 3..

PAGE 183

Nonvolatile Parameter Database 34.3.12 +iBDRD — Baud Rate Divider Syntax: AT+iBDRD= When set to ‗0‘, iChip sets its host USART baud rate according to the value of the BDRF parameter. When set to any value in the range 1-255, it divides the maximum supported baud rate – 3Mbps – by that value. The quotient of this division is set as the host baud rate, and the value of BDRF is ignored. Parameters: n=0 Host baud rate is determined by the BDRF parameter.

PAGE 184

Nonvolatile Parameter Database 34.3.13 +iAWS — Activate WEB Server Automatically Syntax: AT+iAWS=v Sets Activate Web Server flag to v. Parameters: v=0 | 1 | 2 | 3 Command Options: v=0 Automatic web server activation disabled v>0 Web server will be activated automatically when iChip goes online in SerialNET mode or as a result of a triggered Internet session initiation. Maximum number of concurrent browser connections is v.

PAGE 185

Nonvolatile Parameter Database 34.3.14 +iLATI — TCP/IP Listening Socket to Service Remote AT+i Commands Syntax: AT+iLATI= Sets the Remote AT+i service listening port number. When connected to the Internet, opens a TCP/IP listen socket on the local IP address and the specified port. Parameters: port=0..

PAGE 186

Nonvolatile Parameter Database 34.3.15 +iFLW — Set Flow Control Mode Syntax: AT+iFLW=n Sets the flow control mode. Parameters: n=0 .. 7 Command Options: n= Bitmapped flags: Bit 0 0 = Host S/W flow control, using Wait/Continue control characters. 1 = Host hardware flow control based on ~CTS/~RTS hardware signals. Bit 1 0 = No Modem flow control. 1 = Modem hardware flow control based on ~CTS/~RTS hardware signals.

PAGE 187

Nonvolatile Parameter Database 34.3.16 +iCPF — Active Communications Platform Syntax: AT+iCPF=n Sets the active communications platform to either modem or LAN. Parameters: n=0..1 Command Options: n=0 Sets active communications platform to dial-up or cellular modem. When the modem is online, any character, including , sent from the host that is not part of an AT+i command is transferred directly to the modem. n=1 Sets active communications platform to LAN.

PAGE 188

Nonvolatile Parameter Database 34.3.17 +iPSE — Set Power Save Mode Syntax: AT+iPSE=n Enables or disables iChip‘s Power Save Mode. Parameters: n=0..255 Command Options: n=0 Disable Power Save mode. n=1..255 Enable Power Save mode. When Power Save mode is enabled, iChip automatically shuts down most of its circuits after a period of n seconds without any activity on the host or modem serial ports. Renewed activity on the serial ports restores iChip to full operational mode.

PAGE 189

Nonvolatile Parameter Database 34.3.18 +iSDM — Service Disabling Mode Syntax: AT+iSDM=n Sets the service disabling mode bits. Parameters: n=0 .. 7 Command Options: n= Bitmapped flags: Bit 0: Disable iChip‘s response to ICMP ECHO (PING) requests. When this bit is set, iChip will not respond to any PING requests, thereby eliminating the possibility of a PING attack on iChip. Bit 1: Disable iChip‘s remote debug daemon.

PAGE 190

Nonvolatile Parameter Database 34.3.19 +iDF — IP Protocol ‘Don’t Fragment’ Bit Value Syntax: AT+iDF=n Sets the value of the Don‘t Fragment bit used in all subsequent IP packets. Parameters: n=0..1 Command Options: n=0 IP packets transmitted may be fragmented by routers. n=1 IP packets transmitted may not be fragmented by routers. Default: 0 Result Code: I/OK If n is within limits I/ERROR Otherwise AT+iDF~n Temporarily sets the IP protocol Don‘t Fragment bit to n for one session.

PAGE 191

Nonvolatile Parameter Database +iCKSM — Checksum Mode Syntax: AT+iCKSM= Sets iChip‘s checksum mode. With this mode enabled, iChip calculates the checksum of data it returns to host upon receiving the AT+iSRCV command. At the same time, iChip expects the host to append checksum to the data it sends with the AT+iSSND command. iChip compares the checksum it calculates with the one calculated by the host to verify that data was not corrupted during transmission between host and iChip.

PAGE 192

Nonvolatile Parameter Database 34.3.21 +iHIF — Host Interface Syntax: AT+iHIF=n Specifies the interface to be used for communication between the host processor and iChip in subsequent sessions. This parameter takes effect only after power-up. Parameters: n=0 Automatic host interface detection. In this mode, the first character sent from the host over one of the supported interfaces sets the host interface to be used throughout that session until the next iChip power cycle.

PAGE 193

Nonvolatile Parameter Database 34.3.22 +iMIF — Modem Interface Syntax: AT+iMIF=n Specifies the interface to be used for communication between iChip and a dialup or cellular modem in subsequent sessions. This parameter takes effect only after power-up. Parameters: n=1 USART0 n=2 USART1 n=3 USART2 n=4 USB Device n=5 USB Host (only Motorola G24 USB GSM modem is supported) Default: 2 (USART1) Result Code: I/OK If n is within limits I/ERROR Otherwise AT+iMIF? Reports the current value followed by I/OK.

PAGE 194

Nonvolatile Parameter Database 34.3.23 +iADCL — ADC Level Syntax: AT+iADCL= Specifies an ADC base level, or threshold, in the range 0-255 that corresponds to an analog voltage measured on the input pin of iChip‘s A/D converter. Together with ADCD, these two parameters determine when the A/D converter asserts the GPIO pin specified by the ADCP parameter. ADCL must be greater than ADCD.

PAGE 195

Nonvolatile Parameter Database 34.3.24 +iADCD — ADC Delta Syntax: AT+iADCD= Specifies an ADC delta. Together with ADCL, these two parameters determine when the A/D converter asserts the GPIO pin specified by the ADCP parameter. ADCD must be less than ADCL. Parameters: delta=0-255 ADC delta Default: 0 (zero delta) Result Code: I/OK If delta is within limits I/ERROR Otherwise AT+iADCD? Reports the current value followed by I/OK. AT+iADCD=? Returns the message “0-255” followed by I/OK.

PAGE 196

Nonvolatile Parameter Database 34.3.25 +iADCT — ADC Polling Time Syntax: AT+iADCT= Specifies the time interval between consecutive queries of the value of the A/D converter‘s register. iChip‘s response time to value changes is up to 40ms. Parameters: interval=0 A/D converter polling is disabled. interval=1-65535 Time interval, in milliseconds, between queries.

PAGE 197

Nonvolatile Parameter Database 34.3.26 +iADCP — ADC GPIO Pin Syntax: AT+iADCP= Defines which of iChip‘s general-purpose I/O pins (GPIO) is asserted by the A/D converter‘s polling mechanism. Parameters: pin=0 A/D converter polling is disabled.

PAGE 198

Nonvolatile Parameter Database 34.3.27 +iRRA — iChip Readiness Report Activation Syntax: AT+iRRA= Sets the type of iChip readiness indication sent to the host following a hardware reset. Command Options: n=0 No indication is sent. n=1 An I/ATI message is sent, indicating iChip is ready to accept AT+i commands. n=2 An I/ message is sent, indicating iChip has an IP address and is ready for IP communication.

PAGE 199

Nonvolatile Parameter Database Result code: I/OK If n is a legal value. I/ERROR Otherwise AT+iRRA? Returns the current RRA value followed by I/OK. AT+iRRA=? Returns the message “0-6” followed by I/OK. Notes: 4. The I/ATI and I/ messages are sent only if:  iChip is set to communicate with the host over a fixed interface (HIF≠0).  Either the host interface is not a USART, or hostiChip baud rate is set to a fixed value (BDRF≠a).  iChip is not configured to operate in SerialNET mode. 5.

PAGE 200

Nonvolatile Parameter Database 34.3.28 +iRRHW — iChip Readiness Hardware Pin Syntax: AT+iRRHW= Defines which of iChip‘s general-purpose I/O pins (GPIO) will be asserted Low to indicate iChip readiness to the host. iChip readiness indication is specified by the RRA parameter. Parameters: pin=0 No hardware indication is given.

PAGE 201

Nonvolatile Parameter Database 34.4 ISP Connection Parameters 34.4.1 +iISPn — Set ISP Phone Number Syntax: AT+iISPn=dial-s Sets the ISP‘s access phone numbers. Use n=1 to set the ISP‘s primary access phone number. Use n=2 to set the ISP‘s alternate number. The alternate number is dialed after exhausting all redial attempts of the primary number. Parameters: n=1..2 dial-s= Telephone number string, composed of digits, ‗,‘, ‗-‘, ‗W‘, ‗w‘, ‗*‘, ‗#‘, ‗!‘ or ‗ ‘. See description of the standard ATD command.

PAGE 202

Nonvolatile Parameter Database 34.4.2 +iATH — Set PPP Authentication Method Syntax: AT+iATH=v Sets authentication method to v. Parameters: v=0 .. 2 Command Options: v=1 Use PAP authentication v=2 Use CHAP authentication Default: 1 (PAP) Result Code: I/OK If v is within limits I/ERROR Otherwise AT+iATH~v Temporarily sets the authentication method to v for the duration of the next session. The permanent value will be restored after completing the session, whether the session was successful or not.

PAGE 203

Nonvolatile Parameter Database 34.4.3 +iUSRN — Define Connection User Name Syntax: AT+iUSRN=user Sets connection user name. Parameters: user=nser name to be used when logging onto the ISP. Command Options: user=― ‖ Empty: No user name defined. user= user-name is used to login to the ISP. Default: user=― ‖ Empty. No user name defined. The login user name can be defined Ad-Hoc. Result Code: I/OK If user is an empty or legal ISP login name.

PAGE 204

Nonvolatile Parameter Database 34.4.4 +iPWD — Define Connection Password Syntax: AT+iPWD=pass Sets connection password. Parameters: pass=Password to be used when logging onto the ISP. Command Options: pass='' Empty — no password defined. pass= password is used to login to the ISP. Default: Empty — no password defined. The login password can be defined Ad-Hoc. Result Code: I/OK If password is an empty or a legal ISP login password.

PAGE 205

Nonvolatile Parameter Database 34.4.5 +iRDL — Number of Times to Redial ISP Syntax: AT+iRDL=n Sets the number of times to redial ISP. Parameters: n= Number of redial attempts to the ISP. If the ISP number is busy or the ISP does not pick up the line, the system will attempt to redial the ISP after a delay period as defined in the RTO parameter. If all redial attempts are exhausted, an attempt to dial the alternate ISP number will be made, if an alternate number exists.

PAGE 206

Nonvolatile Parameter Database 34.4.6 +iRTO — Delay Period between Redials to ISP Syntax: AT+iRTO=n Sets delay period, in seconds, between redials to ISP. Parameters: n= Number of seconds to delay before redialing the ISP, after a busy signal or in the event that the ISP did not answer the call. iChip will enforce a minimal 5 second delay for values of n less than 5 seconds. Command Options: n=0 ..

PAGE 207

Nonvolatile Parameter Database 34.5 Server Profile Parameters 34.5.1 +iLVS — ‘Leave on Server’ Flag Syntax: AT+iLVS=v Sets the ‗Leave on Server‘ flag to v. Parameters: v = 0 | 1 Command Options: v=0 After successful retrieval, messages will be deleted from server. v=1 All messages will remain on server. Default: 1 Result Code: I/OK If v = 0 or 1 I/ERROR Otherwise AT+iLVS~v Temporarily sets the Leave on Server flag to v for the duration of the next session.

PAGE 208

Nonvolatile Parameter Database 34.5.2 +iDNSn — Define Domain Name Server IP Address Syntax: AT+iDNSn[p]=IP Sets the Domain Name Server IP Address. Use n=1 to define the Primary IP address of the Domain Name Server associated with the ISP. Use n=2 to define the alternate IP address. IP::=... where, : [000..255] Parameters: n=1..2 p= Optional communication platform modifier for iChip Plus. Where, p=‘S‘ to force the (serial) dial-up platform and p=‘L‘ to force the LAN platform.

PAGE 209

Nonvolatile Parameter Database 34.5.3 Syntax: IP. +iSMTP — Define SMTP Server Name AT+iSMTP[p]=server Parameters: Permanently sets the SMTP Server Name or server = An SMTP server name or IP address. Server names must be resolvable by the primary or alternate DNS. p = optional communication platform modifier for iChip Plus. Where, p=‘S‘ to force the (serial) dial-up platform and p=‘L‘ to force the LAN platform. p may be used to select any platform. If p is omitted, the active platform will be used.

PAGE 210

Nonvolatile Parameter Database 34.5.4 Syntax: +iSMA — SMTP Authentication Method AT+iSMA=v Permanently sets SMTP authentication method. Parameters: v = 0 or 1 Command Options: v=0 v=1 SMTP authentication will be disabled. iChip will support the ―AUTH LOGIN‖ SMTP authentication method, if forced by SMTP server. Default: 0 (SMTP authentication disabled) Result code: I/OK I/ERROR if v = 0 or 1. Otherwise. AT+iSMA? Report the current value authentication method. The reply is followed by I/OK.

PAGE 211

Nonvolatile Parameter Database 34.5.5 Syntax: +iSMU — Define SMTP Login User Name AT+iSMU=user Permanently sets Authenticated SMTP login User Name. Parameters: user = User Name to be used when logging on to an SMTP server that requires authentication (if SMA is set to a non zero value). Command Options: user='' Empty: No SMTP authentication User Name defined. user= user-name will be used to login to an authenticated SMTP server. Default: Empty. No User Name defined.

PAGE 212

Nonvolatile Parameter Database 34.5.6 Syntax: password. +iSMP — Define SMTP Login Password AT+iSMP=pass Parameters: Permanently sets authenticated SMTP login pass = Password to be used when logging on to an SMTP server that requires authentication. Command Options: pass='' Empty: No SMTP authentication password defined. pass= password will be used to login to an authenticated SMTP server. Default: Result code: I/OK I/ERROR Empty. No password defined.

PAGE 213

Nonvolatile Parameter Database 34.5.7 Syntax: +iPOP3 — Define POP3 Server Name AT+iPOP3[p]=server Permanently sets the POP3 Server Name or IP. Parameters: server = a POP3 Server Name or IP address. The Server Name must be resolvable by the primary or alternate DNS. p = optional communication platform modifier for iChip Plus. Where, p=‘S‘ to force the (serial) dial-up platform and p=‘L‘ to force the LAN platform. p may be used to select any platform. If p is omitted, the active platform will be used.

PAGE 214

Nonvolatile Parameter Database 34.5.8 Syntax: +iMBX — Define POP3 Mailbox Name AT+iMBX=mailbox Permanently sets mailbox name. Parameters: mailbox = Mailbox name to be used for Email retrieve. Command Options: mailbox ='' Empty: No mailbox name defined. mailbox = mbox-name will be used to retrieve Email messages. Default: Result code: I/OK I/ERROR Empty. No mailbox defined. To retrieve Email messages, a mailbox name must be defined AdHoc. If mailbox is an empty or legal mailbox name.

PAGE 215

Nonvolatile Parameter Database 34.5.9 Syntax: +iMPWD — Define POP3 Mailbox Password AT+iMPWD=MBxPass Permanently sets POP3 mailbox password. Parameters: MBxPass = Mailbox password to be used for authentication, when retrieving Email messages from the mailbox. Command Options: MBxPass ='' Empty: No mailbox password defined. MBxPass = mbox-pass will be used to authenticate receiver, when retrieving Email messages from the mailbox. Default: Result code: I/OK I/ERROR Empty.

PAGE 216

Nonvolatile Parameter Database 34.5.10 Syntax: +iNTSn — Define Network Time Server AT+iNTSn= Sets the network time server name or IP. Use n=1 to define the primary time server. Use n=2 to define an alternate time server. Parameters: n = 1..2 server = A network timeserver name or IP address. See Appendix C for a list of NIST Time servers. Command Options: Server=‘‘ Empty. No Network Time Server defined.

PAGE 217

Nonvolatile Parameter Database 34.5.11 Syntax: +NTOD — Define Network Time-of-Day Activation Flag AT+iNTOD=n Sets the network time-of-day activation flag to n. If this flag is enabled, iChip will retrieve an updated time reading the next time it goes online. Note: In a LAN environment, since iChip is always online, time retrieval will take place following a hardware or software (AT+iDOWN) reset only.

PAGE 218

Nonvolatile Parameter Database 34.5.12 Syntax: +iGMTO — Define Greenwich Mean Time Offset AT+iGMTO=n Permanently sets iChip location‘s Greenwich mean time offset, in hours. Parameters: n = -12..12 Default: 0 Result code: I/OK AT+iGMTO~n Temporarily set the Greenwich Mean Time Offset to value n. The permanent values will be restored after completing the next session, whether the session was successful or not. AT+iGMTO? Report the current value of GMTO. The reply is followed by I/OK.

PAGE 219

Nonvolatile Parameter Database 34.5.13 Syntax: +iDSTD — Define Daylight Savings Transition Rule AT+iDSTD=DST_rule Permanently sets the daylight savings time transition rule. Parameters: DST_rule ::= ―;‖ Where, indicates the date when Daylight Saving Time starts and indicates the date when Daylight Saving Time ends. HHn ::= Full Hour (two digits). DDn ::= Either specific day, or . ::= F = First, L = Last Day of the month.

PAGE 220

Nonvolatile Parameter Database 34.5.14 Syntax: or IP. +iPDSn — Define PING Destination Server AT+iPDSn=Server Permanently sets the PING destination server name Use n=1 to define the primary destination server. Use n=2 to define the secondary destination server. Parameters: n = 1..2 Server = A network server name or IP address. Command Options: Server=‘‘ Empty. No PING destination Server defined.

PAGE 221

Nonvolatile Parameter Database 34.5.15 +iPFR — PING Destination Server Polling Frequency Syntax: AT+iPFR=n Parameters: Permanently sets the time interval, in seconds, upon which iChip will issue a PING request to one of the PING destination servers. n = 0..65535 [seconds] Command Options: Default: 0 (Disabled PING polling) Result code: I/OK I/ERROR If n is within limits Otherwise AT+iPFR~n Temporarily set the PING polling interval value for one session.

PAGE 222

Nonvolatile Parameter Database 34.6 +iUFn — User Fields and Macro Substitution Syntax: AT+iUFn= Parameters: Permanently sets user field n. n = 01..12 String = Parameter string-value. Command Options: String=‘‘ String= Empty User Field. Str is stored in the specified User Field. Maximum Str length is 128 characters. A User Field may be used for general-purpose storage.

PAGE 223

Nonvolatile Parameter Database 34.7 Email Format Parameters AT+i Programmer‘s Manual Version 8.

PAGE 224

Nonvolatile Parameter Database 34.7.1 Syntax: +iXFH — Transfer Headers Flag AT+iXFH=v Permanently sets ‗Transfer Headers‘ flag to v. Parameters: v = 0 or 1 Command Options: v=0 v=1 Retrieve only Email body - No headers. BASE64 MIME attachments will be decoded by iChip, on-the-fly. Retrieve Email headers with Email body. Attachments shall not be decoded. Default: 1 Result code: I/OK I/ERROR If v = 0 or 1 Otherwise.

PAGE 225

Nonvolatile Parameter Database 34.7.2 Syntax: +iHDL — Limit Number of Header Lines AT+iHDL=n Sets maximum number of header lines to retrieve. Parameters: n = 0 – 255 Default: 0 (no limit) Result code: I/OK I/ERROR If n is within limits Otherwise AT+iHDL~n Temporarily set the maximum limit of header lines for the duration of the next session. The permanent value will be restored after completing the next session, whether the session was successful or not.

PAGE 226

Nonvolatile Parameter Database 34.7.3 +iFLS — Define Filter String Syntax: AT+iFLS=str Parameters: Permanently sets a filter string. str = ASCII string which qualifies an Email message to be listed or retrieved by the iChip. This string must exist in the Email header for the message to qualify. If the string does not exist, the message will be ignored. Command Options: str='' Empty string: Filter disabled. All messages shall be qualified for retrieval.

PAGE 227

Nonvolatile Parameter Database 34.7.4 +iDELF — Email Delete Filter String Syntax: AT+iDELF=[#]str Parameters: Permanently sets the Email delete filter string. str = ASCII string which qualifies an Email message to be deleted from the mailbox. This string must exist in the Email header for the message to qualify. If the string exists in at least one header field, the message will be deleted from the mailbox during the next Email retrieve session (AT+iRMM).

PAGE 228

Nonvolatile Parameter Database 34.7.5 +iSBJ — Email Subject Field Syntax: AT+iSBJ:subject Permanently sets Email header‘s Subject field. Parameters: subject = Contents of subject field. Command Options: subject='' Empty string. ‗Subject:‘ Field in Email header will be left empty. subject= The ‗Subject:‘ field in the Email header will contain subject string Default: Empty. Result code: I/OK I/ERROR If subject is an empty or legal string. Otherwise.

PAGE 229

Nonvolatile Parameter Database 34.7.6 +iTOA — Define Primary Addressee Syntax: AT+iTOA[n]=Email@ Parameters: Permanently sets Email addressee. Email@ = Email addressee. This is the default Email addressee, which will be used to direct Email messages sent by iChip. n = optional index of addressee. When n is not specified, TOA00 (primary addressee) is used. Command Options: Email@='' Empty address: No addressee defined.

PAGE 230

Nonvolatile Parameter Database 34.7.7 +iTO — Email ‘To’ Description/Name Syntax: AT+iTO:to Permanently sets Email header‘s ‗To:‘ description. Parameters: to = Contents of 'To:' description/name field. Command Options: to='' Empty string. to= The 'To:' description field in the Email header will contain to_str. Default: Empty Result code: I/OK I/ERROR If to is an empty or legal string. Otherwise.

PAGE 231

Nonvolatile Parameter Database 34.7.8 +iREA — Return Email Address Syntax: AT+iREA=Email@ Parameters: Permanently sets the Return Email Address. This is the Email address that will be used when replying to this Email. Email@ = Email addressee. Command Options: Email@='' Empty address: No return address defined. Email@= addr will be used as the return Email address. Default: Empty. No return Email address defined. The return Email address will be defined Ad-Hoc.

PAGE 232

Nonvolatile Parameter Database 34.7.9 Syntax: +iFRM — Email ‘From’ Description/Name AT+iFRM:from Permanently sets Email header ‗From:‘ description. Parameters: from = Contents of 'From:' description field. Command Options: from='' from= Empty string. The 'From:' description field in the Email header will contain from string. Default: Empty Result code: I/OK I/ERROR If from is an empty or legal string. Otherwise.

PAGE 233

Nonvolatile Parameter Database 34.7.10 +iCCn — Define Alternate Addressee Syntax: AT+iCCn=Email@ Parameters: Permanently sets alternative addressee. n = 1..4 Email@ = Email addressee. This is the Email address, which will be used to copy Email messages sent by the iChip to the primary addressee list. Command Options: Email@='' Empty address: Alternate addressee n not defined. Email@= addr will be used as alternate Email addressee n. Default: Empty. No alternate addressees defined.

PAGE 234

Nonvolatile Parameter Database 34.7.11 +iMT — Media Type Value Syntax: AT+iMT=type Parameters: Permanently sets the media type used for generating Email messages with a MIME encapsulated attachment. type = Media type. Command Options: type=0..4 type will be used as the media type: 0 – text 1 – image 2 – audio 3 – video 4 -- application Default: 4 (application) Result code: I/OK I/ERROR If type is in the range: 0..4 Otherwise AT+iMT~type Temporarily set the media type.

PAGE 235

Nonvolatile Parameter Database 34.7.12 +iMST — Media Subtype String Syntax: AT+iMST=str Parameters: Permanently sets the media subtype string used for generating Email messages with a MIME encapsulated attachment. str = Media subtype string. Command Options: str='' Empty: No media subtype string defined, the default will be used. str= string will be used as the media subtype string. A list of subtype strings is detailed in appendix A.

PAGE 236

Nonvolatile Parameter Database 34.7.13 +iFN — Attachment File Name Syntax: AT+iFN=fname Parameters: Permanently sets the attachment file name string used for generating Email messages with a MIME encapsulated attachment. fname = Attachment file name. Command Options: fname ='' Empty: No file name string defined, the default will be used. fname= str will be used as the file name string when constructing a MIME attachment. The file name should be complete with an explicit extension.

PAGE 237

Nonvolatile Parameter Database 34.8 HTTP Parameters AT+i Programmer‘s Manual Version 8.

PAGE 238

Nonvolatile Parameter Database 34.8.1 Syntax: +iURL — Default URL Address AT+iURL=URLadd Sets the URL address string used for downloading web pages and files and uploading files to web servers. Parameters: URLadd = URL address string. Command Options: URLadd ='' URLadd = Empty: No URL address string defined. str will be used as the URL address string when downloading a Web page or file.

PAGE 239

Nonvolatile Parameter Database 34.8.2 +iCTT — Define Content Type Field in POST Request Syntax: AT+iCTT= Defines the contents of the ―Content-type:‖ field that is sent in the POST request by the AT+iSLNK command. This field specifies the type of file being sent. Parameters: string=max length 64 bytes Command Options: string=‖ Empty. A default value of ―application/x-www-form-urlencoded‖ will be used, and the server will expect the data to be the data sent in a ―Submit‖ of a form.

PAGE 240

Nonvolatile Parameter Database 34.8.3 +iWPWD — Password for Application Website Authentication Syntax: AT+iWPWD=Pass Parameters: Permanently sets the application website‘s remote parameter update Password. Pass = Password to be used for authentication, when accepting application Web site parameter updates from a remote Web browser.

PAGE 241

Nonvolatile Parameter Database 34.9 34.9.1 Syntax: RAS Server Parameters +iRAR — RAS RINGs AT+iRAR=n Sets the number of RINGs that will activate iChip‘s internal RAS if RAU is not empty. Parameters: n = number of RINGs iChip will detect before answering an incoming call and activating its internal RAS. If n is set to a value greater than 100 and an incoming call is picked up by the host or the modem after less than n-100 RINGs, iChip will activate its internal RAS.

PAGE 242

Nonvolatile Parameter Database 34.9.2 +iRAU — Define RAS Login User Name Syntax: AT+iRAU=user Parameters: Permanently sets RAS login user name. user = User Name to be used for authentication when accepting a call from a PPP client connecting to iChip‘s internal RAS. Command Options: user='' Empty: iChip‘s internal RAS is effectively disabled. user = user-name will be used to establish login rights of a remote PPP client connection to iChip‘s internal RAS.

PAGE 243

Nonvolatile Parameter Database 34.9.3 +iRAP — Password for RAS Authentication Syntax: AT+iRAP=Pass Parameters: Sets the RAS Password. Pass = Password to be used for login authentication when accepting a call from a PPP client connecting to iChip‘s internal RAS. Command Options: Pass ='' or Pass=”*” Pass = A password will not be required to authenticate a remote PPP client connection to iChip‘s internal RAS.

PAGE 244

Nonvolatile Parameter Database 34.10 LAN Parameters 34.10.1 Syntax: +iMACA — MAC Address of iChip AT+iMACA=mac Permanently sets iChip‘s MAC address. Parameters: mac = MAC address. The MAC address may only be assigned once in the lifetime of the device, i.e., while the current MAC address is still FFFFFFFFFFFF. After a MAC address is assigned it cannot be changed or overwritten. Command Options: mac= mac@ must consist of 12 hexadecimal characters.

PAGE 245

Nonvolatile Parameter Database 34.10.2 +iDIP — iChip Default IP Address Syntax: AT+iDIP=IP address Permanently sets iChip‘s default IP address to IP address. Parameters: IP address = IP address Command Options: IP address = 0.0.0.0 IP address = 255.255.255.255 IP address = Default: Result code: I/OK I/ERROR Empty: At power-up, iChip LAN / iChip Plus will attempt to resolve an IP address via a DHCP server. The assigned address will be stored in the IPA (active IP address) parameter.

PAGE 246

Nonvolatile Parameter Database 34.10.3 Syntax: +iIPA — Active IP Address AT+iIPA= IP address Changes the active IP to IP address. Parameters: IP address = IP address. Command Options: IP address = IP ADDR. will be assigned as the active iChip LAN / iChip Plus IP address. Also changes the permanent Default IP address in nonvolatile memory. See description of the DIP parameter. Valid only for iChip LAN / iChip Plus. Default: Contents of the DIP parameter at power up.

PAGE 247

Nonvolatile Parameter Database 34.10.4 +iIPG — IP Address of the Gateway Syntax: AT+iIPG=IP addres Parameters: Permanently sets the IP address of the gateway to be used by iChip. IP address = Gateway IP address. Command Options: IP address = 0.0.0.0 IP address = Empty: iChip LAN / iChip Plus will try to resolve the gateway IP address via DHCP, but ONLY if the DIP parameter value has been set to empty (0.0.0.0). IP ADDR will be used as the gateway IP address. Default: Empty.

PAGE 248

Nonvolatile Parameter Database 34.10.5 +iSNET — Subnet Address Syntax: AT+iSNET=IP mask Parameters: Sets the Sub Net to IP mask. IP mask = Subnet mask address. Command Options: IP mask =0.0.0.0 IP mask = Empty: iChip LAN / iChip Plus will try to resolve the subnet address via DHCP, but ONLY if the DIP parameter value has been set to empty. MASK will be used by iChip LAN / iChip Plus as the subnet mask. Default: Empty. No subnet mask address defined.

PAGE 249

Nonvolatile Parameter Database 34.11 Wireless LAN Parameters 34.11.1 +iWLCH — Wireless LAN Communication Channel Syntax: AT+iWLCH= Sets the default WiFi communication channel. When iChip is configured to operate in Ad-Hoc mode, this parameter must be given a value between 1 and 13 that defines the channel to be used for beacon transmission. When iChip joins an already existing Ad-Hoc network, it adopts that network‘s channel.

PAGE 250

Nonvolatile Parameter Database 34.11.2 +iWLSI — Wireless LAN Service Set Identifier Syntax: AT+iWLSI= Sets the destination Wireless LAN Service Set IDentifier (SSID) string. Parameters: ssid = SSID required for communications with a specific Access Point (AP). The AP must be configured with the same SSID. Command Options: ssid='' Empty. No SSID defined. iChip will communicate with any AP. ssid= ID will be used as the destination SSID.

PAGE 251

Nonvolatile Parameter Database 34.11.3 +iWLWM — Wireless LAN WEP Mode Syntax: AT+iWLWM=md Parameters: Sets the Wireless LAN WEP operation mode. md = 0..2 Command Options: md=0 md=1 md=2 WEP Disabled. WEP Enabled, using 64-bit keys. WEP Enabled, using 128-bit keys. Default: 0 - WEP disabled Result code: I/OK I/ERROR if md is within limits. Otherwise AT+iWLWM~md Temporarily set the WEP operation mode to md.

PAGE 252

Nonvolatile Parameter Database 34.11.4 +iWLKI — Wireless LAN Transmission WEP Key Index Syntax: AT+iWLKI=ki Parameters: Sets the Wireless LAN transmission WEP-Key index. ki = 1 .. 4 Command Options: ki= When transmitting WiFi packets, the WEP key at position key_indx in the 4 key array will be used for packet encryption. Default: 1 Result code: I/OK I/ERROR if ki = 1 .. 4 otherwise AT+iWLKI~ki Temporarily set the transmission WEP key index to ki.

PAGE 253

Nonvolatile Parameter Database 34.11.5 +iWLKn — Wireless LAN WEP Key Array Syntax: AT+iWLKn=keyString Parameters: Permanently sets the Wireless LAN WEP keys in the 4-slot WEP key array. n = 1..4. keyString = WEP key string represented by a Hexadecimal ASCII string. Command Options: keyString='' keyString= Empty: No WEP key defined in position n. key will be used as the key string value in position n. The identical value must be configured in the same position in the AP router.

PAGE 254

Nonvolatile Parameter Database 34.11.6 +iWLPS — Wireless LAN Power Save Syntax: AT+iWLPS=n Sets a time interval during which the Marvell WiFi chipset connected to iChip remains in Power Save mode. Value changes take effect only after a SW or HW reset. Parameters: n=0 WiFi chipset Power Save mode is disabled. n=1-5 The number of beacon periods during which the WiFi chipset remains in Power Save mode. The beacon period is set by the Access Point (AP) and is typically 100ms.

PAGE 255

Nonvolatile Parameter Database 34.11.7 +iWLPP — Personal Shared Key Pass-Phrase Syntax: AT+iWLPP= Sets the wireless LAN WPA-PSK pass-phrase. Parameters: = Pass-phrase to be used in generating the WPA-PSK encryption key. Command Options: passphrase =‖ Empty — WPA security is disabled. passphrase = If WLSI (SSID) is not empty, WPA-PSK security is enabled for WiFi connections and pass is used in generating the WPA-PSK encryption key.

PAGE 256

Nonvolatile Parameter Database 34.11.8 +iWROM — Enable Roaming in WiFi Syntax: AT+iWROM= Sets iChip to Roaming mode. Parameters: n=0 | 1 n=0 Disable Roaming mode. n=1 Enable Roaming mode. Default: n=0 Result Code: I/OK If n is a legal value. I/ERROR Otherwise AT+iWROM? Returns the current WROM value followed by I/OK. AT+iWROM=? Returns the message ―0-1” followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 257

Nonvolatile Parameter Database 34.11.9 +iWPSI — Periodic WiFi Scan Interval Syntax: AT+iWPSI=n Sets the time interval – n – between consecutive scans that iChip performs for APs in its vicinity. Parameters: n=1-3600 seconds Default: n=5 seconds Result Code: I/OK If n is a legal value. I/ERROR Otherwise AT+iWPSI? Returns the current WPSI value followed by I/OK. AT+iWPSI=? Returns the message “1-3600” followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 258

Nonvolatile Parameter Database 34.11.10 +iWSRL — SNR Low Threshold Syntax: AT+iWSRL= Sets a low SNR threshold for iChip in Roaming mode. If the SNR value of the signal from the AP that iChip is currently associated with drops below n, iChip is triggered by the SNR low event. Parameters: n=0-255 dB Default: n=10 dB Result Code: I/OK If n is a legal value. I/ERROR Otherwise AT+iWSRL? Returns the current WSRL value followed by I/OK. AT+iWSRL=? Returns the message “0-255” followed by I/OK.

PAGE 259

Nonvolatile Parameter Database 34.11.11 +iWSRH — SNR High Threshold Syntax: AT+iWSRH= Sets a high SNR threshold for iChip in Roaming mode. iChip will re-associate only with APs having SNR that is better than n. Parameters: n=0-255 dB Default: 30 dB Result Code: I/OK If n is a legal value. I/ERROR Otherwise AT+iWSRH? Returns the current WSRH value followed by I/OK. AT+iWSRH=? Returns the message “0-255” followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 260

Nonvolatile Parameter Database 34.11.12 +iWSIn — Wireless LAN Service Set Identifier Array Syntax: AT+iWSI= Sets the destination Wireless LAN Service Set Identifier (SSID) string into position n in the array. This array defines the order in which iChip attempts to connect to an AP or Ad-Hoc network. Parameters: n=0-9 n=0 is equivalent to the WLSI parameter and defines the default SSID. The default SSID (WSI0 or WLSI) determines the type of scanning that iChip performs.

PAGE 261

Nonvolatile Parameter Database strongest signal. Default: Empty. No SSID defined. Result Code: I/OK If n is a legal value. I/ERROR Otherwise AT+iWSIn~ssid Temporarily sets the nth position in the array to ssid. AT+iWSIn? Reports the current SSID value in position n. AT+iWSIn=? Returns the message “String” followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 262

Nonvolatile Parameter Database 34.11.13 +iWPPn — Pre-Shared Key Passphrase Array Syntax: AT+iWPPn= Sets the Wireless LAN PSK passphrase for WPA and WPA2 encryption for each individual SSID in the array. Parameters: n=0-9 10 WPA passphrases, one for each SSID, respectively. Setting WPP0= is equivalent to setting the WLPP parameter, and vice versa. = pass is the passphrase to be used in generating the PSK encryption key for WPA and WPA2.

PAGE 263

Nonvolatile Parameter Database 34.11.14 +iWKYn — Wireless LAN WEP Key Array Syntax: AT+iWKYn= Sets the Wireless LAN WEP key for each individual SSID in the array. Parameters: n=0-9 10 WEP keys, one for each SSID, respectively. Setting KeyString with n=0 is equivalent to setting WLKI and WLK1-WLK4 parameters. WEP key string represented by a hexadecimal ASCII string. Command Options: KeyString=‖ Empty KeyString= key will be used as the KeyString value in position n.

PAGE 264

Nonvolatile Parameter Database 34.11.15 +iWSTn — Wireless LAN Security Type Array Syntax: AT+iWSTn= Sets the Wireless LAN security type for each individual SSID in the array. Setting WST0= is equivalent to setting the WLWM and WSEC parameters accordingly, and vice versa. For example, setting WST0=3 (WPA-TKIP) causes iChip to automatically set WSEC=0. Setting WST0=1 (WEP-64) automatically sets WLWM=1.

PAGE 265

Nonvolatile Parameter Database 34.11.16 +iWSEC — Wireless LAN WPA Security Syntax: AT+iWSEC=n Sets the WPA protocol type to be used for wireless LAN security. This parameter takes effect following either a hardware or software reset (AT+iDOWN) only. A change to this parameter during iChip operation does not affect the current connection.

PAGE 266

Nonvolatile Parameter Database 34.12 IP Registration Parameters 34.12.1 Syntax: +iRRMA — IP Registration Mail Address AT+iRRMA= Email@ Permanently sets the IP registration addressee. Parameters: Email@ = Email addressee. This addressee will receive a registration Email message after iChip establishes an Internet session connection as a result of an explicit AT+i command or as a result of automated Internet session establishment procedures.

PAGE 267

Nonvolatile Parameter Database 34.12.2 Syntax: +iRRSV — IP Registration Host Server Name AT+iRRSV=server_name:port Permanently sets the IP registration server name or IP and port number to be used in an IP registration procedure . Parameters: server_name = A server name or IP address. Server names must be resolvable by the primary or alternate DNS. port = 0..65535 Command Options: server_name='' Empty: No IP registration server name defined.

PAGE 268

Nonvolatile Parameter Database 34.12.3 Syntax: +iRRWS — IP Registration Web Server AT+iRRWS=url Permanently sets the IP registration web server URL. Parameters: url = The web server URL to use for registration after going online. Command Options: url = ‗‘ Empty: No IP registration URL defined. url = Reg_URL will be used to dynamically register iChip‘s IP and Port after going online as a result of an explicit AT+i command or as a result of automated Internet session establishment procedures.

PAGE 269

Nonvolatile Parameter Database 34.12.4 Syntax: +iRRRL — IP Registration Return Link AT+iRRRL=IP[:Port] Permanently sets the IP registration Return Link IP and Web Port. Parameters: IP = IP address to use for registration after going online. Port = Port number to assign to iChip‘s Web server. See description of RRRL when registering IP. Command Options: IP = 0.0.0.0 IP = Empty: No Return Link defined.

PAGE 270

Nonvolatile Parameter Database 34.12.5 Syntax: +iHSTN — iChip LAN Host Name AT+iHSTN=host Permanently sets iChip‘s Network Host Name. Parameters: host = Symbolic Host Name string. Command Options: host = ‘‘ Empty: Do not attempt to register a symbolic host name. If the iChip LAN is already registered in the DNS, the symbolic name will typically be cleared only after the last DHCP lease assigned to this iChip has expired.

PAGE 271

Nonvolatile Parameter Database 34.13 SerialNET Mode Parameters 34.13.1 Syntax: +iHSRV | +iHSRn — Host Server Name/IP AT+i{HSRV | HSRn} = server_name:port Sets the host server-name or IP and port number to be used in SerialNET mode. Use n=0 or HSRV to define the primary server. Use n=1 or 2 to define secondary servers. Parameters: n = 0 .. 2 server_name = A server name or IP address. Server names must be resolvable by the primary or alternate DNS. port = 0..

PAGE 272

Nonvolatile Parameter Database +iHSS — Assign Special Characters to Hosts Syntax: AT+iHSS= When iChip is connected to HSRn (where n=0..2) in SerialNet mode, and character (where HSS=) arrives from the host, iChip will close the socket to remote server HSRn, flush all characters received from host prior to , and open a socket to remote server HSRm. In the special case when n=m, iChip doesn‘t do anything.

PAGE 273

Nonvolatile Parameter Database +iDSTR — Define Disconnection String for SerialNET Mode Syntax: AT+i[!]DSTR: Permanently sets SerialNET device disconnection string. In a modem environment, iChip also goes offline following this event. Parameters: disconnect_string = The string expected on a serial link to signal socket disconnection. Command Options: disconnect_string= '' Empty string – the connection will never be terminated due to a string arriving on serial link.

PAGE 274

Nonvolatile Parameter Database 34.13.4 Syntax: +iLPRT — SerialNET Device Listening Port AT+iLPRT=n Permanently sets the port number on which iChip will listen for client connections in SerialNET mode. Parameters: n = 0-65535 Default: 0 (no port). Result code: I/OK I/ERROR If n is within limits. otherwise AT+iLPRT? Report the current value of the SerialNET device listen port. The reply is followed by I/OK. AT+iLPRT=? Returns the message "0-65535". The reply is followed by I/OK.

PAGE 275

Nonvolatile Parameter Database 34.13.5 Syntax: +iMBTB — Max Bytes To Buffer AT+iMBTB=n Permanently sets max bytes to buffer while the iChip is establishing an Internet connection. Parameters: n = number of bytes to buffer while establishing the connection in SerialNET mode. Command Options: n = 0 .. 2048 Default: 0 – No Buffering. Result code: I/OK I/ERROR If n is within limits. Otherwise AT+iMBTB? Report the current setting of max bytes to buffer. The reply is followed by I/OK.

PAGE 276

Nonvolatile Parameter Database 34.13.6 Syntax: +iMTTF — Max Timeout to Socket Flush AT+iMTTF=n Sets max inactivity timeout before flushing the SerialNET socket. Parameters: n = number of milliseconds of inactivity on serial link to signal socket flush in SerialNET mode. Command Options: n = 0 .. 65535 Default: 0 – No timeout. Result code: I/OK I/ERROR If n is within limits. Otherwise. AT+iMTTF? Report the current timeout before SerialNET socket flush in milliseconds. The reply is followed by I/OK.

PAGE 277

Nonvolatile Parameter Database 34.13.7 Syntax: +iFCHR — Flush Character AT+iFCHR=flush_chr Permanently sets flush character in SerialNET mode. Parameters: flush_chr = character received on serial link to signal socket flush in SerialNET mode. Command Options: flush_chr = ‗‘ Empty: No Flush character defined. The SerialNET socket will not be flushed as a result of receiving a special flush character. ‗a‘ – ‗z‘ | ‗A‘ – ‗Z‘ | ‗0‘ – ‗9‘ | flush_chr = where, = \x = 00-FF Defa

PAGE 278

Nonvolatile Parameter Database 34.13.8 Syntax: +iMCBF — Maximum Characters before Socket Flush AT+iMCBF=n Permanently sets max number of characters before flushing the SerialNET socket. Parameters: n = maximum number of characters received on the serial link before flushing the SerialNET socket. Command Options: n = 0 .. 1460 Default: 0 – No specific limit. Flushing governed by Network. Result code: I/OK I/ERROR If n is within limits. Otherwise.

PAGE 279

Nonvolatile Parameter Database 34.13.9 Syntax: +iIATO — Inactivity Timeout AT+iIATO=n Permanently sets maximum inactivity timeout in seconds to signal socket disconnection in SerialNET mode. When signaled, iChip will close the connected SerialNET communication socket. In a modem environment, the iChip will also go offline following this event. When iChip is in iRouter mode and TUP< >2, if no activity is detected for the specified period, iChip will disconnect its modem side and go offline.

PAGE 280

Nonvolatile Parameter Database 34.13.10 +iSNSI — SerialNET Device Serial Interface Syntax: AT+iSNSI=settings_str Sets serial interface settings for SerialNET mode. Parameters: settings_str = Serial link settings in SerialNET mode. Command Options: settings_str=‖,,,,‖ where, = 0..

PAGE 281

Nonvolatile Parameter Database 34.13.11 +iSTYP — SerialNET Device Socket Type Syntax: AT+iSTYP=v Sets SerialNET socket type to v. Parameters: v = 0 or 1 Command Options: v=0 v=1 TCP UDP Default: 0 (TCP) Result Code: I/OK I/ERROR if v = 0 or 1 Otherwise AT+iSTYP? Reports the current value of the SerialNET socket type followed by I/OK. AT+iSTYP=? Returns the message “0-1” followed by I/OK. AT+i Programmer‘s Manual Version 8.

PAGE 282

Nonvolatile Parameter Database 34.13.12 +iSNRD — SerialNET Device Re-Initialization Delay Syntax: AT+iSNRD=n Sets SerialNET mode re-initialization delay in seconds. Parameters: n = number of seconds iChip will pause before reinitializing SerialNET mode after a failed attempt to establish a socket connection to the peer or a connection related fatal error. A new SerialNET connection will only be attempted after SerialNET re-initializes.

PAGE 283

Nonvolatile Parameter Database 34.13.13 +iSPN — SerialNET Server Phone Number Syntax: AT+iSPN=number Permanently sets the SerialNET phone number to use to wake up a remote SerialNET server. Parameters: number = Telephone number to use to dial up a remote SerialNET server in order to wake it up and activate its preprogrammed Ring-Response procedures. The SerialNET client will attempt RDL redials. During each dial-up attempt it will wait for SDT seconds before hanging up.

PAGE 284

Nonvolatile Parameter Database 34.13.14 +iSDT — SerialNET Dialup Timeout Syntax: AT+iSDT=n Permanently sets the SerialNET Dial timeout when waking up a remote SerialNET server. Parameters: n = Number of seconds to allow after dialing up the remote SerialNET server, before hanging up. Command Options: n = 0..255 [seconds]. Default: 20 [seconds] Result code: I/OK I/ERROR If n is within limits. Otherwise AT+iSDT? Report the current SerialNET dial timeout. The reply is followed by I/OK.

PAGE 285

Nonvolatile Parameter Database 34.13.15 +iSWT — SerialNET Wake-Up Timeout Syntax: AT+iSWT=n Sets the SerialNET wake-up timeout when waking up a remote SerialNET server. Parameters: n = Number of seconds to allow the entire SerialNET server wakeup procedure before hanging up and retrying. Command Options: n = 0..65535 [seconds] Default: 600 [seconds]. Result code: I/OK I/ERROR AT+iSWT? If n is within limits. Otherwise Report the current SerialNET Wake-up timeout. The reply is followed by I/OK.

PAGE 286

Nonvolatile Parameter Database 34.13.16 +iPTD — SerialNET Packets to Discard Syntax: AT+iPTD=n Sets the number of packets to be cyclically discarded in a SerialNET mode session. A packet is defined as the group of characters received on the serial link, meeting one (or more) of the socket flush conditions defined (+iFCHR, +iMTTF, +iMCBF). Parameters: n = 0 – 65535 Default: 0 – No packet filtering. All data is transferred. Result code: I/OK I/ERROR If n is within limits. Otherwise.

PAGE 287

Nonvolatile Parameter Database 34.14 Remote Firmware Update Parameters +iUEN — Remote Firmware Update Flag Syntax: AT+iUEN= Sets the remote firmware update flag. Parameters: v = 0 or 1 Command Options: v=0 Update only to a firmware version that is newer than the currently installed one. v=1 Update to any firmware version available. Default: 0 Result Code: I/OK If v = 0 or 1 I/ERROR Otherwise AT+iUEN~v Temporarily set the remote firmware update flag to v for the duration of the current session.

PAGE 288

Nonvolatile Parameter Database +iUSRV — Remote Firmware Update Server Name Syntax: AT+iUSRV=―://[:]/[/]‖ Sets name of server to be used for updating iChip firmware remotely. This server must contain one or more firmware .imz files. The actual update process is initiated using the AT+iRFU command. Parameters: = http or ftp = Host name or IP address = 1..65535 Default port for http is 80. Default port for ftp is 21.

PAGE 289

Nonvolatile Parameter Database +iUUSR — Remote Firmware Update FTP User Name Syntax: AT+iUUSR= Sets name of user to logon to the FTP server defined in the AT+iUSRV parameter. Parameters: = Name of user to logon to the FTP server. This must be a registered user on the FTP server. Some servers allow anonymous login, in which case username=anonymous. Command Options: AT+iUUSR=― Empty. No user name defined. Default: Empty. No user name defined.

PAGE 290

Nonvolatile Parameter Database +iUPWD — Remote Firmware Update FTP User Password Syntax: AT+iUPWD= Sets user password to logon to the FTP server defined in the AT+iUSRV parameter. Parameters: = User password to logon to the FTP server. If special characters are used, the password should be specified within quotes. Servers that allow anonymous login usually request an Email address as a password. Command Options: AT+iUPWD=― Empty. No user password defined. Default: Empty.

PAGE 291

Nonvolatile Parameter Database 34.15 Remote Parameter Update Syntax: AT+iRPG=GroupPass Parameters: Sets the remote parameter update group/password. Also used to authenticate a remote technician connecting for remote debug purposes. GroupPass = Group/Password to be used for authentication when accepting iChip parameter updates from a remote web browser. Command Options: GroupPass ='' Empty: Remote Email Parameter Update and remote Web parameter updates are effectively disabled.

PAGE 292

Nonvolatile Parameter Database 34.16 Secure Socket Protocol Parameters +iCS — Define the SSL3/TLS Cipher Suite Syntax: AT+iCS=n Sets the cipher suite to be used in SSL3/TLS negotiations with a secure server. The default value ‗0‘ is the all-cipher selection. With this value, iChip sends its full list of supported ciphers to the server. The server selects the most appropriate cipher to use during the handshake procedure.

PAGE 293

Nonvolatile Parameter Database +iCA — Define SSL3/TLS Certificate Authority Syntax: AT+iCA[n]=tca Sets the certificates of the trusted certificate authorities. This authority is the one eligible to sign a server‘s certificate. iChip accepts a server‘s identity only if its certificate is signed by one of these authorities. Parameters: tca = PEM format DER-encoded X509 certificate Command Options: tca = Empty: No trusted certificate authority.

PAGE 294

Nonvolatile Parameter Database 34.16.3 +iCERT — Define SSL3/TLS1 Certificate Syntax: AT+iCERT=ct Set iChip‘s SSL3/TLS1 certificate. Some SSL3/TLS1 servers require the client side to authenticate its identity by requesting the client to provide a certificate during the SSL socket negotiation phase. This is called ―client side authentication‖. If the CERT parameter contains a certificate, iChip provides it to the server upon request.

PAGE 295

Nonvolatile Parameter Database 34.16.4 +iPKEY — Define iChip’s Private Key Syntax: AT+iPKEY=pky Set iChip‘s private key. The private key is required to perform an RSA encryption of its certificate (see CERT parameter) when performing client side authentication. Special care should be taken to protect private key contents from unauthorized parties. For this reason, once the private key is stored on iChip, it cannot be read – only erased or overwritten.

PAGE 296

Nonvolatile Parameter Database 34.17 DHCP Server Parameters +iDPSZ — DHCP Server Pool Size Syntax: AT+iDPSZ= Sets number of addresses to be allocated in the IP pool of iChip‘s DHCP server. Parameters: range = number of IP addresses in pool Command Options: range=0-255 When range=0 the pool is empty and the DHCP server is inactive. When range is set to any number between 1 and 255, and the DIP parameter is defined – the DHCP server becomes active.

PAGE 297

Nonvolatile Parameter Database +iDSLT — DHCP Server Lease Time Syntax: AT+iDSLT= Defines lease time, in minutes, to be granted by iChip‘s DHCP server when assigning IP addresses to clients. Parameters: time = lease time in minutes Scope: Command Options: time=0-65535 When time=0 lease time is indefinite. Any other value sets a limit on the lease time. Default: 0 — Indefinite lease time Result Code: I/OK If time is an integer between 0 and 65535.

PAGE 298

Nonvolatile Parameter Database 34.18 iRouter Parameters 34.18.1 +iARS — Automatic Router Start Syntax: AT+iARS=n Causes iChip to automatically enter iRouter mode upon power-up or soft reset. Upon entering iRouter mode, iChip immediately goes online on the dialup/cellular side. Packets are not buffered during dialup/cellular connection establishment. After establishing the connection, iChip starts the routing service. Parameters: n=0 Do not start iRouter mode upon power-up or soft reset.

PAGE 299

Appendix A 35 Appendix A 35.1 MIME content types and subtypes Type text multipart message Subtype plain richtext enriched tab-seperated-values html sgml vnd.latex-z vnd.fmi.flexstor mixed alternative digest parallel appledouble header-set Form-data related report voice-message signed encrypted rfc822 partial external-body news http AT+i Programmer‘s Manual Version 8.

PAGE 300

Appendix A Type application Subtype octet-stream postscript oda atomicmail andrew-inset slate wita dec-dx dca-rft activemessage rtf applefile mac-binhex40 news-message-id news-transmission wordperfect5.1 pdf zip macwriteii msword remote-printing mathematica cybercash commonground iges riscos eshop x400-bp sgml cals-1840 pgp-encrypted pgp-signature pgp-keys vnd.framemaker vnd.mif vnd.ms-excel vnd.ms-powerpoint vnd.ms-project vnd.ms-works AT+i Programmer‘s Manual Version 8.32 Subtype vnd.music-niff vnd.

PAGE 301

Appendix A Type image audio video Subtype jpeg gif ief g3fax tiff cgm naplps vnd.dwg vnd.svf vnd.dxf png vnd.fpx vnd.net-fpx basic 32kadpcm vnd.qcelp mpeg quicktime vnd.vivo vnd.motorola.video vnd.motorola.videop Table 35-1 MIME Content Types and Subtypes AT+i Programmer‘s Manual Version 8.

PAGE 302

Appendix B 36 36.1 Appendix B Sample Parameter Update File RP_GROUP="111" RP_DEST=‖00010001‖ RP_START_FROM_FACTORY_DEFAULTS=YES # MODEM PARAMETERS: MIS="ATX4E1&C1&D2M2L2" XRC=1 BDRM=8 # CONNECTION PARAMETERS: ISP1="7777555" ISP2="036666555" USRN="name" PWD="pass" DNS1=192.115.106.10 DNS2=192.115.106.11 ATH=1 SMTP="smtp.com" EMA="name@domain" # POP3 PARAMETERS: MBX="pop_name" MPWD="pop_pass" POP3="pop3.com" LVS=0 FLS=‖mymail‖ # EMAIL STRUCTURE_PARAMETERS: TOA=‖email@address.com‖ CC1= "cc1@address.

PAGE 303

Appendix B MT=0 MST=‖text-plain‖ # CONNECTION TIMEOUT/RETRIES PARAMETERS: RDL=2 RTO=180 WTC=100 # OTHER PARAMETERS: HDL=5 URL=‖http://www.connectone.com/‖ AT+i Programmer‘s Manual Version 8.

PAGE 304

Appendix C 37 37.1 Appendix C NIST Time Servers Server IP Address Location nist1.aol-ca.truetime.com 207.200.81.113 TrueTime, AOL facility, Sunnyvale, California nist1.aol-va.truetime.com 205.188.185.33 TrueTime, AOL facility, Virginia 66.243.43.21 Datum, San Jose, California 209.0.72.7 Datum, San Jose, California 216.200.93.8 Abovnet, Virginia 208.184.49.9 Abovnet, New York City 208.185.146.41 Abovnet, San Jose, California 216.200.93.8 Abovenet, Virginia 208.184.49.9 Abovenet, New York City 207.

PAGE 305

Index 38 Index +i[@]FOPN – FTP Open Session................. 11-1 +i[@]FOPS – Secure FTP Open Session ..... 21-5 +iADCD - ADC Delta ................................ 34-32 +iADCL - ADC Level ................................ 34-31 +iADCP - ADC GPIO Pin .......................... 34-34 +iADCT - ADC Polling Time .................... 34-33 +iARS – Automatic Router Start .............. 34-135 +iATH - Set PPP Authentication Method .. 34-39 +iAWS - Activate WEB Server Automatically ................................

PAGE 306

Index +iPGT - PING Timeout .............................. 34-15 +iPING - Send a PING Request to a Remote Server ........................................................ 5-6 +iPKEY - Define iChip‘s Private Key...... 34-132 +iPOP3 - Define POP3 Server Name ......... 34-50 +iPSE – Set Power Save Mode................... 34-25 +iPTD - SerialNET Packets to Discard .... 34-123 +iPWD - Define Connection Password ...... 34-41 +iRAP - Password for RAS Authentication ......... .........................................

PAGE 307

Index +iWPWD – Password for Application Website Authentication ....................................... 34-77 +iWRFD - WLAN Radio Down ................... 15-5 +iWRFU - WLAN Radio Up........................ 15-4 +iWROM - Enable Roaming in WiFi ......... 34-93 +iWRST - Reset WLAN Chipset ................. 15-6 +iWSEC - Wireless LAN WPA Security . 34-102 +iWSIn - Wireless LAN Service Set Identifier Array ..................................................... 34-97 +iWSRH - SNR High Threshold ................