Home

AT+i Programmer`s Manual - Copeland Communications, Inc.

1. lt accni gt flag Result code Open an FTP link to an FTP Server lt server gt Logical name of the FTP or the server s IP address lt port gt Optional FTP port in the range 0 65535 lt user gt FTP User s name lt pass gt FTP User s password lt accnt gt Optional FTP Account iChip CO110PC ESFT The server name may be any legal Internet server name which 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 Specifies the FTP server s listening port If not specified port 21 decimal is assumed User s name string This must be a registered user on the FTP server Some servers allow anonymous login in which case user anonymous Password to authenticate user If special characters are used the password should be specified within quotes It is customary that servers which allow anonymous login will request an Email address as a password Some FTP servers require an account in order to allow a certain subset of the commands In this case the account name must be specified when opening the FTP link The optional is used to flag the Force PASV mode When is specified iChip will only use the PASV method when opening a data socket to server for FTP data transfer I lt FTP handle gt Upon successfully connecting to the FTP Server VERROR and authenticating the user a socket
2. 19 5 16 iSDM Service Disabling Mode Syntax AT iSDM n Set 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 Default 0 All services enabled Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHSDM Returns current Service Disabling mode The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 26 Nonvolatile Parameter Database 19 5 17 iDF IP Protocol Don t Fragment Bit Value Syntax AT iDF n Parameters Command Options Default Scope Result code VOK VERROR ATHDE Set the value of the Don t Fragment bit used in all subsequent IP packets n 0 1 n O _ IP packets transmitted may be fragmented by routers n 1 IP packets transmitted may not be fragmented by routers 0 iChip CO110PC If n is within limits Otherwise Report the current IP protocol Don t Fragment bit setting The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 27 Nonvolatile Parameter Database 19 5 18 iISPn Set ISP Phone Number Syntax AT ilSPn dial s Permanently set the ISP s access phone numbers Use n 1 to set the ISP s primary access phone number
3. Scope iChip CO110PC ESFT Command Options lt F_hn gt Must have been obtained by a previous execution of an AT iFOPN command during the current Internet mode session lt stream gt An 8 bit byte stream of exactly size lt sz gt If lt sz gt 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 mode the Host processor must respond to iChip s flow control characters The flow control protocol is detailed in the Host gt iChip Software Flow Control section later in this document When software flow control is active it is recommended to set iChip to Echo Off mode Under hardware flow control the CTS RTS RS232 control signals must be connected and the host must respond to iChip s CTS signal The host may send data only when the CTS signal is asserted active low Several consecutive HFSND commands may be issued in sequence to create a larger aggregate of data to be sent The File transfer is complete by issuing a iFCLF FTP Close File command Result code VOK After lt sz gt bytes have been transferred successfully to the FTP server VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 10 File Transfer Protocol FTP 9 11 iFCLF FTP Close File Syntax AT RCLF lt F_hn gt Parameters Scope Command Options lt F_hn gt
4. iChip CO110PC If IP is an empty or legal IP address Otherwise Report the current main alternate DNS address If no DNS address exists 0 0 0 0 will be returned The reply is followed by I OK Note This parameter may be omitted when Email HTTP FTP or other servers are defined as IP addresses rather than symbolic names CO110PC AT i Programmer s Manual Version 7 6 19 34 Nonvolatile Parameter Database 19 5 25 iSMTP Define SMTP Server Name Syntax AT iSMTP server Parameters Command Options server Permanently set the SMTP Server Name or IP server An SMTP server name or IP address Server names must be resolvable by the primary or alternate DNS Empty No server name defined server lt SMTP_SRVR gt SMTP_SRVR will be used to locate and Default Scope Result code VOK VERROR ATHSMTP establish an SMTP connection when sending Email messages If SMTP SRVR is asymbolic name a DNS server will be used to resolve the IP address Define iSMA iSMU and iSMP if the SMTP server requires authentication Empty No SMTP server defined To send Email messages the SMTP server name must be defined ad hoc iChip CO110PC ESFT If server is an empty or legal IP address or SMTP server name Otherwise Report the current SMTP server name If a server name does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Versio
5. Issuing a BREAK signal on the Host serial link will effectively RESET the iChip A BREAK signal is issued by transmitting a LOW zero value for a period that is longer than 23 bits at the current baud rate Considerably lowering the host baud rate 300 baud or less and transmitting a binary zero will in effect generate a BREAK signal After a BREAK signal is issued iChip requires 4 seconds to complete the reset cycle before commands may be issued When iChip is configured for auto baud rate AT iBDRF a the BREAK method is especially useful to force iChip back into auto baud rate mode when iChip and the host loose sync 1 6 Reset via Forced Watchdog Activation iChip includes an internal watchdog mechanism When enabled the internal watchdog circuitry will physically RESET the iChip device if the 1Chip firmware does not execute CO110PC AT i Programmer s Manual Version 7 6 1 2 AT i Command Set in an orderly manner as expected The AT iWDR command forces the watchdog circuitry to instigate a RESET condition as a means to reset the iChip device with an AT i command from the host 1 7 Internet Session Hang up Procedure When completing a dialup Internet session iChip will automatically execute a modem hang up procedure 1 The DTR line is dropped 2 After a 1 Sec Delay iChip raises the DTR 3 If the modem responded to the DTR drop with a No Carrier gt Done 4 Otherwise iChip issu
6. 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 TW w or See description of the standard ATD command Note If a character that is defined as a Delimiter is used within the dial string the string must be entered between apostrophes Command Options dial s Empty access number dial s lt number gt number will be set as ISP access number Default Empty No permanent ISP access number defined Scope iChip CO110PC Result code VOK If dial s is a legal phone number string VERROR Otherwise ATHiISPn Report the current value of the ISP s primary alternate access numbers If the number does not exist only lt CRLF gt is returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 28 Nonvolatile Parameter Database 19 5 19 iATH Set PPP Authentication Method Syntax AT iATH v Parameters Command Options v 0 val v 2 Default Scope Result code VOK VERROR ATHATH Permanently set Authentication method to v v 0 2 Use script driven authentication Obsolete Use PAP authentication Use CHAP authentication 1 PAP iChip CO110PC If v is within limits Otherwise Report the current setting of the authentication method The reply is followed by I OK CO110PC AT i Programmer s
7. iChip will allow up to lt PG7 gt milliseconds for a PING reply If a reply will not be received within lt PGT gt milliseconds iChip will send two more PING requests allowing lt PGT gt milliseconds for a reply on each of the requests before reporting an error VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 5 6 Connection 5 6 iWDR Force Watchdog RESET Syntax AT iWDR Forces iChip to perform a hard RESET by means of its internal watchdog circuit After performing a hard RESET iChip will 1 Restore the host serial port to the baud rate in effect when the WDR command was issued regardless of the BDRF parameter value 2 A modem hang up process will be performed to resolve the possible case where the modem was online when the RESET occurred 3 A BREAK condition is forced on the TXDH signal to notify the host that a watchdog reset has occurred Parameters None Scope iChip CO110PC Result code VOK CO110PC AT i Programmer s Manual Version 7 6 5 7 HTTP Client Interface 6 Email Send 6 1 EOA Accept ASCI Coded Lines for Immediate Email Send Syntax AT i JEOA lt textlines gt Define a plain text Email body Parameters lt text lines gt Plain text Email body The Email body contains lt CR LF gt terminated ASCII character strings lt text lines gt must be terminated by a Dot character in the 1 column of an otherwise empty line Scope iChip CO110
8. s Manual Version 7 6 10 9 Direct Socket Interface 10 10 iSDMP Dump Socket Buffer Syntax AT iSDMP lt hn gt Parameters Scope Command Options lt hn gt Result code VOK VERROR Dump all buffered data currently accumulated in a socket s inbound buffer The socket remains open lt hn gt A TCP UDP socket handle of an open socket iChip CO110PC Must have been obtained by a previous execution of an AT iSTCP or ATHSUDP command during the current Internet mode session Or a socket accepted by a listen socket If lt hn gt is a handle to an open socket Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 10 Direct Socket Interface 10 11 iSFSH Syntax AT HiSFSH lt hn gt Parameters Scope Command Options lt hn gt oo flag Result code VOK VERROR Flush Socket s Outbound Data Flush immediately send accumulated data in a socket s outbound buffer lt hn gt A TCP UDP socket handle of an open socket iChip CO110PC 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 listen socket When the flush and acknowledge 9 flag is specified and lt hn gt is a TCP socket handle iChip will both flush and wait for the peer receipt acknowledgment of all outstanding outbound data Common errors associated with this flag are
9. 12 1 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 will establish a socket to the server defined in RRSV during the registration procedure When a socket is established 1Chip will transmit its ID information and current IP address or the RRRL in the following format iChip lt D L S gt S N lt RP5 gt version lt RP1 gt HN lt HSTN gt IP lt IPA or RRRL gt Port lt LPRT or 80 or 0 gt The registration socket is then closed 12 2 Web Server Registration iChip registers itself by surfing to a Web server with its ID information and current IP address as parameters If the RRWS parameter contains a URL of a registration Web server iChip will register its ID information and IP using the URL by issuing a GET command along with a fixed format parameter line lt RRWS path gt SN lt RP5 gt amp IP lt IPA or RRRL gt amp WPt lt 0 or the port defined in RRRL gt amp HN lt HSTN gt The Web server must contain a CGI asp page exe etc which will make use of these parameters to register the iChip CO110PC AT i Programmer s Manual Version 7 6 12 1 IP Registration If several registration parameters are configured iChip will go through multiple registration processes If more than one registration process fails iChip will return an I ERROR result describing
10. 3600 180 iChip 110 Timeout before redialing seconds DNSn IP 0 0 0 0 iChip 110 Domain Name Server IP address address lt n gt 1 2 SMTP String 64chars NULL iChip 110 SMTP server name ESFT SMA Byte 0 1 O None iChip 110 Define SMTP Authenticated Method ESFT O None 1 Login authentication SMU String 64chars NULL iChip 110 SMTP Authentication User Name ESFT SMP String 64chars NULL iChip 110 SMTP Authentication Password ESFT PDSn String 64chars NULL iChip 110 Set iChip s PING Destination servers used for online status verification PFR INT 0 65535 O Disabled iChip 110 Set PING destination server polling Frequency SBJ String 96chars NULL iChip 110 Contents of the Email subject field ESFT TOA String 64chars NULL iChip 110 Email Addressee ESFT TO String 96chars NULL iChip 110 Addressee Description Name in Email ESFT header REA String 64chars NULL iChip 110 Return Email Address ESFT FRM String 96chars NULL iChip 110 Sender Description Name in Email ESFT header Cen String 64chars NULL iChip 110 Alternate Addressee CC field lt n gt 1 4 ESFT CO110PC AT i Programmer s Manual Version 7 6 19 3 Nonvolatile Parameter Database URL String 128 chars None iChip 110 URL string used for subsequent iRLNK commands to upload Web pages and files Byte 2 20 iChip 110 Number of RINGs after which iChip will activate its internal RAS Server Rau String 64chars
11. Command Options iChip supports auto baud rate detection for baud rates 2400 4800 9600 19200 38400 57600 and 115200 bits per second Result code VOK This result code will be sent using the previous baud rate CO110PC AT i Programmer s Manual Version 7 6 5 1 Connection 5 2 UP Initiate Internet Session Syntax ATH UP n Parameters Default Scope Command Options n 0 n 1 Result code VONLINE Or VERROR Initiate an Internet session by going online and establishing a PPP Internet connection Once online optionally go through an IP registration process according to n n 0 1 n 0 iChip CO110PC Go online and establish a PPP Internet connection Go online establish a PPP Internet connection and carry out the IP registration process according to the relevant registration option parameters After successfully establishing an Internet Session and completing the IP registration if requested If iChip could not go online and establish an Internet session or could not complete the requested IP registration CO110PC AT i Programmer s Manual Version 7 6 5 2 Connection 5 3 iTUP Triggered Internet Session Initiation Syntax AT iTUP lt n gt Parameters Scope Command Options n 0 n 1 n 2 Enter triggered Internet session initiation mode n 0 2 iChip CO110PC Disable triggered Internet session initiation mode Enter triggered Internet session initia
12. Parameters URLadd URL address string Command Options URLadd Empty No URL address string defined URLadd lt str gt str will be used as the URL address string when downloading a Web page or file The URL address format is lt Protocol gt lt host gt lt port gt lt absolute_link gt Where lt protocol gt HTTP lt host gt Web Server Name IP address or server name resolved by DNS lt port gt Port number on server Default 80 lt absolute link gt Absolute path name of Web page or file on server Default None Scope iChip CO110PC Result code VOK If URLadd is an empty or a legal URL address string VERROR Otherwise AT HURL Report the current URL address string If the URL address is empty only lt CRLF gt will be returned The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 47 Nonvolatile Parameter Database 19 5 38 iRAR RAS RINGS Syntax AT iRAR n Parameters Command Options n 100 Default Scope Result code VOK VERROR ATHRAR Permanently set the number of RINGS that will activate iChip s internal RAS if RAU is not empty 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 The RAS server will
13. Report an FTP file size lt F_hn gt An open FTP Session handle lt path gt File path name iChip CO110PC ESFT 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 iChip reports path s file size in bytes if the file exists and the FTP server supports the file size FTP command Followed by VOK Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 6 File Transfer Protocol FTP 9 7 HFRCV FTP Receive File Syntax AT FRCV lt F_hn gt lt path gt Download a file from an FTP server Parameters Scope Command Options lt F_hn gt lt path gt Result code lt F_hn gt An open FTP Session handle lt path gt File path name iChip CO110PC ESFT 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 VOK When command has been received and about to be processed VERROR If lt F_hn gt is not an open FTP Session or otherwise some error has occurred Followed by VERROR If the FTP RECV command could not be processed or I lt sz gt lt CR gt lt LF gt Followed by lt data stream gt Where lt sz gt is the exact size in bytes of the lt data stream gt to follow If lt sz gt cannot be determined iChip returns I 0 followed by the data str
14. hardware flow control the CTS RTS RS232 control signals must be connected and the host must respond to iChip s CTS signal The host may send data only when the CTS signal is asserted active low When the auto flush flag is specified the socket is automatically flushed immediately after receiving the lt stream gt Otherwise data will be transmitted to the Internet only in integral quantities of the specified MTU Maximum Transfer Unit or when the AT iSFSH command is issued After lt sz gt bytes have been transferred successfully to the socket s output buffer Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 7 Direct Socket Interface 10 8 Syntax iSRCV Receive a Byte Stream from a Socket s Input Buffer AT HSRCV lt hn gt lt max gt Parameters Scope Command Options lt hn gt lt max gt Result code VERROR Returns Receive a byte stream from the TCP UDP socket specified by the socket handle lt hn gt Receive data is valid only if it already resides in iChip s socket input buffer at the time this command is issued lt hn gt A TCP UDP socket handle of an open socket lt max gt Optionally specifies the maximum number of bytes to transfer Additional bytes may remain in the socket input buffer following this command iChip CO110PC Must have been obtained by a previous execution of an AT iSTCP or ATHSUDP command during the current
15. s Manual Version 7 6 Connection 5 4 DOWN Terminate Internet Session Syntax AT iDOWN Parameters Scope Result code VOK Followed by VERROR Or VDONE Terminate an ongoing Internet session go offline and return to Command mode This command is useful following a command where the stay online flag was specified All open sockets shall be closed iChip effectively executes a software reset None iChip CO110PC After terminating the current Internet session when the command caused iChip to abort an on going Internet activity or close an active socket After terminating the current Internet session Allow a 2 5 sec delay for iChip re initialization following an Internet mode session CO110PC AT i Programmer s Manual Version 7 6 5 5 Connection 5 5 iPING Send a PING Request to a Remote Server Syntax AT iPING lt host gt Sends a two byte ICMP PING request packet to the remote host defined by host Parameters lt host gt Logical name of the target host or a host IP address Scope iChip CO110PC Command Options lt host gt The host name may be any legal Internet server name which can be resolved by iChip s DNS Domain Name Server settings The host name may also be specified as an absolute IP address given in DOT form Result code I lt RRT gt Upon successfully receiving an ICMP PING reply from the host the round trip time in milliseconds is returned RRT
16. 0 iChip 110 TCP Timeout Number of seconds to wait before returning a timeout error on a TCP transaction PGT Unsigned 0 65535 0 mSec iChip 110 Timeout to resend a PING request INT MPS Byte 0 3 0 1500 iChip 110 Max PPP Packet Size TTR INT 0 65535 3000 mSec iChip 110 Timeout to resend an unacknowledged TCP packet over PPP in milliseconds BDRF Byte 1 8 a Auto iChip 110 Sets the iChip lt Host to a fixed baud rate BDRM Byte 1 8 a Auto iChip 110 Sets the iChip 2 modem baud rate to a fixed baud LATI INT 0 65535 O Disabled iChip 110 Remote AT i Service port number FLW Byte 0 7 0 S W iChip 110 Flow Control Mode PSE Byte 0 1 O Disabled iChip 110 Set Power Save Mode Disabled 0 Enabled 1 WDM Byte 0 4 O Disabled iChip 110 Watch Dog Activation Mode SDM Byte 0 7 O AN Enabled iChip 110 Service Disable Bit map DE Byte 0 1 0 iChip 110 IP Protocol Don t Fragment Bit CO110PC AT i Programmer s Manual Version 7 6 19 2 Nonvolatile Parameter Database ISPn Phone 96chars NULL iChip 110 ISP s access phone number lt n gt 1 2 ATH Byte 0 2 1 PAP iChip 110 Use CHAP 2 PAP 1 or Script 0 authentication USRN String 64chars NULL iChip 110 ISP Connection User name PWD String 64chars NULL iChip 110 ISP Connection Password RDL Byte 0 20 5 iChip 110 Number of Redial tries RTO Byte 0
17. 215 carrier lost and 203 socket closed by peer in an orderly manner or did not receive ACK after 10 tries to retransmit unacknowledged data If lt hn gt is a handle to an open socket and when lt hn gt is a TCP socket handle all outbound data has been received and when flag specified also acknowledged by peer Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 11 Direct Socket Interface 10 12 iSCLS Close Socket Syntax AT Hi SCLS lt hn gt Parameters Scope Command Options lt hn gt Result code VOK VERROR Followed by VDONE or VONLINE or VERROR Close a TCP UDP socket If the socket was the only open socket and the stay online flag was not specified iChip will terminate the Internet session and go offline lt hn gt A TCP UDP socket handle of an open socket iChip CO110PC 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 listen socket A socket will always be flushed before being closed TCP sockets are disconnected from the remote host server in an orderly manner Stay On Line after completing the command If lt hn gt is a handle to an open socket Otherwise After successfully closing the last open socket Allow a 2 5 sec delay for iChip re initialization following an Internet mode session After successfully closing
18. 7 6 19 37 Nonvolatile Parameter Database 19 5 28 iSMP Define SMTP Login Password Syntax AT iSMP pass Parameters Command Options pass Permanently set authenticated SMTP login password pass Password to be used when logging on to an SMTP server that requires authentication Empty No SMTP authentication password defined pass lt password gt password will be used to login to an Default Scope Result code VOK VERROR AT iSMP authenticated SMTP server Empty No password defined iChip CO110PC ESFT If password is an empty or a legal SMTP login password Otherwise Report the current SMTP login password The reported value will consist of characters The number of characters shall reflect the number of characters in the actual password If a password does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 38 Nonvolatile Parameter Database 19 5 29 iPDSn Define PING Destination Server Syntax AT iPDSn Server Parameters Command Options Server Server lt nps gt Default Scope Result code AT iPDSn Permanently set the PING destination server name or IP Use n 1 to define the primary destination server Use n 2 to define the secondary destination server n 1 2 Server A network server name or IP address Empty No PING destination Server defined The serve
19. CO110PC If n is within limits Otherwise Report the current Internet transaction timeout used The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 16 Nonvolatile Parameter Database 19 5 7 iPGT PING Timeout Syntax AT iPGT n Permanently set the timeout in milliseconds after which iChip will reissue a PING request that has not been replied to Parameters n 0 65535 milliseconds Command Options After issuing a PING request in response to the AT iPING command iChip will wait up to n milliseconds for a reply If a reply is not received iChip will reissue the PING request n Q is a special case where a timeout of 2 seconds is used Default 0 use iChip s factory default 2 seconds timeout Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHPGT Report the current PING transaction timeout used The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 17 Nonvolatile Parameter Database 19 5 8 iMPS Max PPP Packet Size Syntax AT iMPS n Limit the size of an outgoing PPP packet in dial up environments In effect the MPS parameter limits 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 Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHMPS Returns
20. Internet mode session Or a socket accepted by a listen socket If lt max gt is not specified all available bytes residing in the socket input buffer shall be returned If lt hn gt is not an open socket or otherwise some error occurred I lt sz gt lt binary data stream gt Where lt sz gt 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 lt binary data stream gt are omitted lt sz gt is guaranteed to be equal or less than lt max gt when specified CO110PC AT i Programmer s Manual Version 7 6 10 8 Direct Socket Interface 10 9 iGPNM Get Peer Name for a Specified Socket Syntax AT HGPNM lt hn gt Parameters Scope Command Options lt hn gt Result code Retrieve Peer Name lt IP gt lt Port gt of a remote connection to a TCP UDP socket specified by the socket handle lt hn gt lt hn gt A TCP UDP socket handle of an open socket iChip CO110PC Must have been obtained by a previous execution of an AT iSTCP or ATHSUDP command during the current Internet mode session Or a socket accepted by a listen socket I lt IP gt lt Port gt Where VERROR lt P gt is the remote peer s IP address and lt Port gt is the remote peer s port for this connection If lt hn gt is not an open socket handle or otherwise some error occurred CO110PC AT i Programmer
21. Result code VOK VERROR Close File Downloaded to a remote FTP server file Only valid after a successful AT iFSTO or AT iFAPN command and optional AT iFSND commands lt F_hn gt An open FTP session handle iChip CO110PC ESFT Must have been obtained by a previous execution of an AT iFOPN command during the current Internet mode session After successfully closing the file Otherwise CO110PC AT i Programmer s Manual Version 7 6 File Transfer Protocol FTP 9 12 iFDEL FTP Delete File Syntax AT iIFDEL lt F_hn gt lt path gt Delete a remote FTP file Parameters lt F_hn gt An open FTP session handle lt path gt File path name Scope iChip CO110PC ESFT Command Options lt F_hn gt Must have been obtained by a previous execution of an AT iFOPN command during the current Internet mode session lt path gt Absolute or relative path name of the remote destination file to delete Result code VOK After successfully deleting the remote file VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 12 File Transfer Protocol FTP 9 13 iFCLS FTP Close Session Syntax AT i FCLS lt F_hn gt Parameters Scope Command Options lt F_hn gt Result code VOK Followed by VDONE or VONLINE or VERROR Close the FTP link lt F_hn gt An open FTP session handle iChip CO110PC ESFT Must have been obtained by a previous execution of an AT iFOPN comman
22. Socket send error 102 No USRN defined 209 Socket receive error 103 No PWD entered 210 PPP down for socket 104 No DNS defined 211 Obsolete Use 203 212 Socket flush error 213 Obsolete 214 Obsolete 108 TOA addressee not defined 215 No carrier error on socket operation 109 REA return Email address not 216 General exception defined 110 SMTP server not defined 217 Out of Memory 218 An STCP Open Socket command specified a local port number that is already in use CO110PC AT i Programmer s Manual Version 7 6 3 2 AT i Result Code Summary VERROR nnn Continued nnn 300 HTTP server unknown 500 Communications Platform Not Available 301 HTTP server timeout 501 Communications Platform already Active 302 HTTP failure 502 RESERVED 303 No URL given 503 RESERVED 304 Bad HTTP host name 504 RESERVED 305 Bad HTTP port number 505 Cannot open additional FTP session all FTP handles in use 306 Bad URL address 506 Not an FTP session handle 307 URL address too long 507 FTP server not found 508 Timeout when connecting to FTP server 509 Failed to login to FTP server bad username or password or account 510 FTP command could not be completed 511 FTP data socket could not be opened 512 Failed to send data on FTP data socket 513 FTP shutdown by remote server 401 No IP address 561 Rem
23. Syntax AT IFDNL lt F_hn gt lt path gt Return the FTP directory name list Parameters lt F_hn gt An open FTP Session handle lt path gt Optional directory or filename wild card Scope iChip CO110PC ESFT Command Options lt F_hn gt Must have been obtained by a previous execution of an ATHFOPN command during the current Internet mode session lt path gt Optional directory name or filename wild card If lt path gt is a directory that directory s files shall be listed If it is a filename wild card only matching filenames in the current directory shall be listed If lt path gt is not specified the current directory shall be listed in full Result code VOK To acknowledge successful receipt of the command VERROR If lt F_hn gt is not an open FTP Session or otherwise some error has occurred Returns A bare list of filenames Each file name is listed on a separate line terminated by lt CR LF gt No attributes are returned in addition to the filename Followed by VONLINE After successfully retrieving the directory list CO110PC AT i Programmer s Manual Version 7 6 9 3 File Transfer Protocol FTP 9 4 iFMKD FTP Make Directory Syntax AT iIFMKD lt F_hn gt lt path gt Parameters Scope Command Options lt F_hn gt lt path gt Result code VOK VERROR Create a new directory on FTP server s file system lt F_hn gt An open FTP Session handle spath direct
24. a special flush character flush_chr a 2 SA E 0 9 lt hex_char gt where lt hex_char gt x lt hh gt lt hh gt 00 FF Default Empty No flush character defined Scope iChip CO110PC SNET Result code VOK If flush_chr is empty or a legal character representation VERROR Otherwise AT iFCHR Report the current flush character The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 61 Nonvolatile Parameter Database 19 5 52 iMCBF Maximum Characters Before Socket Flush Syntax AT iMCBF n Permanently set 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 timeout Scope iChip CO110PC SNET Result code VOK If n is within limits VERROR Otherwise AT iIMCBF Report the current maximum number of characters before flushing the SerialNET socket The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 62 Nonvolatile Parameter Database 19 5 53 ilATO Inactivity Timeout Syntax AT IATO n Permanently set maximum inactivity timeout in seconds to signal socket disconnection in SerialNET mode When signaled iChip will close the connected SerialNET communication socket iChip will go offline following this event Parameters n number
25. all binary 1s nor all binary Os CO110PC AT i Programmer s Manual Version 7 6 15 2 RAS Server 15 3 1 Auto PPP RAS Mode 1Chip allows combining RAS and direct modem to modem communication sessions A special mode named Auto PPP RAS supports dialing into iChip with a PPP dialer or a regular modem Auto PPP RAS mode is enabled by enabling RAS mode and adding a 100 offset to the RAR parameter where lt RAR gt 100 determines the number of RINGS after which iChip will automatically pick up the line and negotiate a PPP connection The host processor may instruct the modem to pick up the line beforehand by issuing the ATA modem command or by setting the modem to auto answer after less than lt RAR gt 100 RING strings This is normally done in order to manage a direct modem to modem non PPP communication session When iChip is in the Auto PPP RAS mode it will monitor the data stream following the modem CONNECT line If the first character transmitted by the remote end is Ox7E iChip will defer to PPP negotiation The will be the last character transmitted to the host end to signal that iChip has taken over the negotiations Upon this event iChip will continue to negotiate a PPP connection internally in a manner similar to the procedure that occurs when iChip picks up the line after receiving lt RAR gt RING strings If however the first character received from the calling end after the CONNEC
26. as a RAS The remote dialer must specify the correct user name and matching password in order to successfully complete the PPP connection This parameter must have a non empty value for the RAS feature to be enabled Otherwise when RAU is empty iChip s RAS is effectively disabled When RAU contains the special character the RAS is enabled but no authentication is required ii RAP RAS Login Password The remote dialer must provide the correct password in order to successfully complete the PPP connection When the RAP parameter is empty or contains any password string will be accepted in effect nullifying the authentication process iii RAR Number of RINGs before picking up the line When iChip s RAS feature is enabled the RAR parameter defines the number of RINGs that must arrive before iChip picks up the line and transfers control to its RAS CO110PC AT i Programmer s Manual Version 7 6 15 1 RAS Server 15 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 will pick up the line and negotiate a PPP connection by issuing the ATA modem command after RAR RING strings have been received If the host chooses to manage a direct modem to modem data connection it may pick up the line before RAR RING strings have arrived by issuin
27. by the iChip s DNS Domain Name Server settings The server name may also be specified as an absolute IP address given in DOT form When the lt host gt is defined the resulting UDP socket will be created and connected If lt host gt 0 0 0 0 the socket is created but remains unconnected The first UDP packet to arrive will automatically latch the senders IP port in effect connecting the socket Specifies the remote system s port Specifies the local port to use If unspecified iChip will allocate a port from its internal pool Upon successfully opening and connecting the UDP socket to the lt host gt lt port gt a socket handle is returned The socket handle lt sock handle gt is in the range 0 9 and is used to reference the socket in all following socket commands Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 2 Direct Socket Interface 10 3 iLTCP Open a TCP Listen Socket Syntax AT iLTCP lt port gt lt backlog gt Opens a TCP listen socket on the local IP address and the specified port lt port gt lt backlog gt specifies the maximum number of remote concurrent connections allowed through the listen socket Parameters lt port gt 0 65535 lt backlog gt 1 10 Scope iChip CO110PC Command Options lt port gt Listening port to be used by a remote system when connecting to iChip lt backlog gt Specifies the maximum number of active connections that may be con
28. 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 will be discarded The remote server s IP address and port number are part of the SerialNET mode configuration parameters Once a data connection is established data can flow freely between the local client device and the remote server If a connection cannot be obtained CO110PC AT i Programmer s Manual Version 7 6 16 2 SerialNET Operation eventually the client device s data will be discarded similar to the case of a device transmitting serial data without a serial cable connected Data continues to flow until a predefined activity termination event is triggered upon which the remote connection is dropped 16 5 Automatic SerialNET Server Wake up Procedure A SerialNET client may be configured to wake up a remote SerialNET server provided it has its phone number The SPN parameter is used to store this wake up number When SPN contains a phone number and no Host Server Name and or IP address are defined the SerialNET client will try to retrieve them from the registration Email of a remote SerialNET server When characters are received from the host port the SerialNET client will dial the SerialNET server and then hang up causing the server to connect to its ISP se
29. current value The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 18 Nonvolatile Parameter Database 19 5 9 iTTR TCP Retransmit Timeout Syntax AT TTR n Parameters Default Scope Result code VOK VERROR ATHTTR Set the timeout in milliseconds after which an unacknowledged TCP packet will be retransmitted over a PPP connection by iChip n 0 65535 3000 milliseconds iChip CO110PC if n is within limits Otherwise Report the current value The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 19 Nonvolatile Parameter Database 19 5 10 iBDRF Define a Fixed Baud Rate on Host Connection Syntax AT iBDRF n Set the baud rate on host serial connection This parameter is saved to nonvolatile memory and activated only after power up Parameters n 3 9 or a or h Command Options set baud rate to Autobaud set baud rate to 2400 set baud rate to 4800 set baud rate to 9600 set baud rate to 19200 set baud rate to 38400 set baud rate to 57600 set baud rate to 115200 set baud rate to 230400 Ss Ss Ss 353 SS SS Il 5 VOoHOU PULP When BDRF is set to a iChip will boot in auto baud rate mode In this mode iChip will synchronize on the first a or A character sent normally as part of an AT or AT 1 command and detect its baud rate The detected baud rate will prevail until the iChip is p
30. defined in this section The AT i commands are an extension to the basic industry standard AT Command Set AT i commands shall be parsed and acted upon by the iChip controller The ASCII ISO 646 character set CCITT T 50 International Alphabet 5 American Standard Code for Information Interchange is used for the issuance of commands and responses Only the low order 7 bits of each character are used for commands or parameters the high order bit is ignored Upper case characters are equivalent to lower case characters 1 2 AT i Command Format An AT i command line is a string of characters sent from a Host to the iChip controller while it is in the command state The command line has a prefix a body and a terminator Each command must begin with the character sequence AT i and must be terminated by a carriage return lt CR gt Commands entered in upper case or lower case are accepted The AT i command body is restricted to printable ASCII characters 032 126 The command terminator is the ASCII lt CR gt character The command line interpretation begins upon receipt of the carriage return character an exception to this rule are the AT iSSND and AT iFSND commands When ECHO is enabled the lt CR gt Carriage Return character is echoed as a 2 character sequence lt CR gt lt LF gt Carriage Return Line Feed Characters within the AT i command line are parsed as commands with associated parameter values iChip does not
31. ee ee ee in 16 4 17 FILE TRANSFER PROTOCOL FTP THEORY OF OPERATION 17 1 IE INTRODUCTION SS EE ae cata ats a a N EE Nae ciate 17 1 17 2 ICHIP FTP CLIENT COMMAND SET ees ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 17 1 17 3 ICHIP FTP CLIENT OPERATION MODE eie ee ee ee ee see ee se ee ee ee ee ee ee ee ee ee ee ee 17 1 17 4 FTP COMMAND SOCKET ccsscsccscececeesessnscecescceessssnseaeeesesecseeesssaaeceseeseneees 17 1 Ii FTP RECEIVE PLOW SS SUS DE ORN ee ee Aa Ve 17 2 18 REMOTE AT I SERVICE steeks sede See bee ee ss ee dee sek Ges og Geb ees idee Ge ek ges de 18 1 8 1 INITRODUETIONS SLEG GE SR EG SEE N RE nie Bos 18 1 18 2 REMOTE AT COMMANDS ees sees ee see se se ee se ee ee ee ee ee Re Re ee ee ee Re Re ee ee ee ee 18 1 18 3 OELOSINGAREMOTEATAISESSION iese sei ee ee Ge ee ees nee el ER ees ees bie 18 1 18 4 CAVEATS AND RESTRICTIONS iese esse se se ee ee ee ee ee ee ee Re Re ee ee ee RR Re Re ee ee ee ee 18 1 19 NONVOLATILE PARAMETER DATABASE uuu es ssssse sees esse sees esse se ee es se ge ee ee 19 2 19 1 PARAMETER DESCRIPTIONS iese sesse es se se ee se ee ee ee ee ee ee ee ee ee ee ee ee RR Re Re ee ee ee ee 19 2 19 2 IFD RESTORE ALL PARAMETERS TO FACTORY DEFAULT sees ee ee ees ee ee ee 19 6 19 3 IPARS STORE ALL PARAMETER UPDATES TO NONVOLATILE DATABASE 19 7 19 4 IPARD DROP ALL PARAMETER UPDATES CURRENTLY IN MEMORY 19 8 19 5 PARAMETER ACCESS COMM
32. either be in 115K baud rate or in auto baud rate to respond to this activation If the iChipConfig Utility does not succeed to communicate with iChip s monitor mode it will display a dialog box requesting the local operator to power up iChip with the FUSEL pin 44 signal held LOW For more information see the iChipConfig Utility User s Manual CO110PC AT i Programmer s Manual Version 7 6 14 1 RAS Server 15 iChip RAS Server 15 1 Introduction iChip features an internal RAS server which makes it possible to dial into iChip using an active modem platform With this feature a remote dialer may dial into iChip and when configured as a RAS Remote Access Server iChip will answer the call and negotiate 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 All other iChip IP protocol functionality will be enabled allowing the host to issue Internet protocol AT i commands based on the PPP connection Note however that since iChip is not connected to an actual ISP in this mode iChip will not have access to the public Internet and thus only direct connections between iChip and the connected PPP client will be possible 15 2 RAS Parameters Three parameters govern the use of iChip s RAS server i RAU RAS Login User Name The RAU parameter defines the allowable user name for login purposes when iChip answers an incoming call
33. handle is returned The handle lt FTP handle gt is used to reference the FTP Session in all following FTP commands Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 1 File Transfer Protocol FTP 9 2 iFDL FTP Directory Listing Syntax AT iFDL lt F_hn gt lt path gt Return a full FTP directory listing Parameters lt F_hn gt An open FTP Session handle lt path gt Directory or filename wild card Scope iChip CO110PC ESFT Command Options lt F_hn gt Must have been obtained by a previous execution of an AT iFOPN command during the current Internet mode session lt path gt Optional directory name or filename wild card If lt path gt is a directory that directory s files shall be listed If it is a filename wild card only matching filenames in the current directory shall be listed If lt path gt is not specified the current directory shall be listed in full Result code VOK To acknowledge successful receipt of the command VERROR If lt F_hn gt is not an open FTP Session or otherwise some error has occurred Returns A list of filenames with file attributes Each file is listed on a separate line terminated by lt CR LF gt The file data line syntax is FTP server dependant Followed by VONLINE After successfully retrieving the directory list CO110PC AT i Programmer s Manual Version 7 6 9 2 File Transfer Protocol FTP 9 3 iFDNL FTP Directory Names Listing
34. initialization delay in seconds The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 66 Nonvolatile Parameter Database 19 5 57 iPTD SerialNET Packets To Discard Syntax AT iPTD n Parameters Default Scope Result code VOK VERROR AT HPTD Set 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 1FCHR iMTTF iMCBF n 0 65535 0 No packet filtering All data is transferred iChip CO110PC SNET if n is within limits Otherwise Report the current value The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 67
35. lt host gt lt port gt lt abs_link gt Default Result code Retrieve a file from a URL URL Optional URL address which specifies the host path and source file that will be retrieved URL address syntax lt Protocol gt lt host gt lt port gt lt abs_link gt iChip CO110PC http Host name or IP address 0 65535 If not specified defaults to 80 Path filename and file extension of the file to retrieve on the designated host Stay On Line after completing the command Uses the URL address stored in the URL parameter VOK When command has been received and about to be processed VERROR Otherwise Returns I lt sz gt lt CR gt lt LF gt Followed by lt binary data stream gt Where lt sz gt is the exact size of the lt binary data stream gt to follow If lt sz gt is unknown iChip returns 1 0 followed by the data stream When this is the case the host must monitor for a timeout condition of at least 5 seconds without any data being transmitted before seeing one of the terminator lines described under Followed by Followed by VDONE or VONLINE or VERROR After successfully retrieving the file Allow a 2 5 sec delay for iChip re initialization following an Internet mode session After successfully retrieving the file if the stay online flag was specified Otherwise Always proceeded by 5 sec silence CO110PC AT i Programmer s Manu
36. nnn Error code Wait code lt Yes Yes Continue code Figure 13 1 Software Flow Control in FTP Send CO110PC AT i Programmer s Manual Version 7 6 13 2 Flow Control 13 3 Software Flow Control During a Socket Send When a WATT control is sent to the host during a socket send AT iSSND command it is automatically followed by a RP4 socket status in the following syntax I lt sockOsz gt lt sockI sz gt lt sock9sz gt lt CR LF gt 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 If the host detects a need to execute a socket receive command to empty one or more socket input buffers it may escape the current SSND command by issuing a Pause sequence immediately after receiving the CONTINUE control The Pause sequence is defined as 2 second of silence followed by three consecutive minus sign characters iChip will respond by prematurely terminating the SSND command including flushing the current socket if the flag was specified Following this the TOR will be issued and the host may issue the required SRCV command in addition to any other operations it needs to execute The host may return to the preempted socket at any time and issue a new SSND command to send out the balance of data CO110PC AT i Programmer s Manual Version 7 6 13
37. of seconds of inactivity on a connected SerialNET socket to signal socket disconnection Command Options n 0 32768 When iChip is in Server SerialNET mode LPRT defined and it goes online in response to a triggering event RING signal MMSEL signal pulled low or AT I SNMD timeout calculation commences only after the iChip opens the Listen port Default 0 No timeout limit Scope iChip CO110PC SNET Result code VOK If n is within limits VERROR Otherwise ATHIATO Report the current inactivity timeout in seconds to signal socket disconnection in SerialNET mode The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 63 Nonvolatile Parameter Database 19 5 54 iSNSI SerialNET Device Serial Interface Syntax AT iSNSI settings_str Permanently set serial interface settings for SerialNET mode Parameters settings str Serial link settings in SerialINET mode Command Options settings_str lt baud gt lt data_bits gt lt parity gt lt stop_bits gt lt flow gt where lt baud gt 0 9 lt data_bits gt 718 lt parity gt NIEIO lt stop_bits gt 112 lt flow gt 011 The following table summarizes supported baud rates Baud Baud Code Baud Rate Code Baud Rate 0 300 5 9600 1 600 6 19200 2 1200 7 38400 3 2400 8 57600 4 4800 9 115200 Default 5 8 N 1 0 baud rate 9600bps 8 bits No parity 1 stop bit no flo
38. the host on the next command that requires the use of the connection and only then will a software reset be performed CO110PC AT i Programmer s Manual Version 7 6 15 5 RAS Server 15 3 4 Restrictions Modem RING strings will not be detected while the baud rate between iChip and the host is not yet established This means that in order to use the RAS feature one of following must apply 1 BDRF was set to a fixed value 3 9 or h 2 iChip is in SerialNET mode with its baud rate defined by the SNSI parameter 3 An a or A was previously received from the host serial port and iChip has determined the host s baud rate CO110PC AT i Programmer s Manual Version 7 6 15 6 SerialNET Operation 16 SerialNET Theory of Operation 16 1 Introduction iChip SerialNET mode extends a local asynchronous serial link to a TCP or UDP socket across the 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 In order to achieve this SerialNET mode defines a set of associated operational parameters which define the nature of the desired network connection When iChip is put in SerialNET mode it acts as a router between the device s serial port and the network Devices that communicate with a terminal over a serial link fall into three major categories Output only i
39. the socket while additional sockets are still open or if the stay online flag was specified Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 12 Special Modem Commands 11 Special Modem Commands 11 1 iIMCM Issue Intermediate Command to Modem Syntax AT IMCM Parameters Scope Enter Modem Command mode None iChip CO110PC Command Options If the modem is online iChip will put the modem in Returns command mode by issuing the escape sequence Then iChip will enter Modem Command mode In this mode all following commands shall be transferred as is to the modem Modem replies shall be relayed back to the host processor iChip will not implement any translations or functional handling of the commands Modem Command mode will be exited after the host issues the ATO command iChip will transfer the ATO command to the modem and relay the modem s response back to the host Modem command shall also be exited if the host issues an AT i followed by a lt CR gt In this case iChip will just reply with I OK Modem s response s including command echo if it is enabled Followed by VOK Or VERROR When the modem successfully returns online If modem was unable to go back online CO110PC AT i Programmer s Manual Version 7 6 11 1 IP Registration 12 IP Registration When iChip goes online in a dial up or cellular environment it is normally assigned a dynam
40. was not specified the iChip will terminate the Internet session and go offline CO110PC AT i Programmer s Manual Version 7 6 2 3 AT i Command Set Command Function Parameters Description MCM Modem Sends an AT command s to the modem Command Firmware Update Enters local monitor mode for firmware upload Table 2 1 AT i Commands by Category CO110PC AT i Programmer s Manual Version 7 6 4 AT i Result Code Summary 3 AT i Result Code Summary Sune TOK Command was successfully seed TUBUSY iChip device Busy Command discarded SSS VDONE EN Chip completed Internet activity Returned to command mode VONLINE iChip device completed an Internet activity and returned to command mode iChip will issue this response when it has remained on line as a result of the stay online flag 1 VYERROR mnn nm Command Error Encountered Command Discarded 41 Illegal delimiter 63 CTSH needs to be LOW to change to H W flow control 42 Illegal value 64 66 RESERVED 43 CR expected 44 Number expected 45 CRor expected 67 Command ignored as irrelevant 46 DNS expected 68 RESERVED 47 or expected 69 Timeout on host communication 48 String expected 70 Modem failed to respond 49 or expected 71 No dial tone response 50 Text expected 72 No carrier modem response 51 Syntax error 73 Dial failed 52 lt expe
41. 28 CO110PC AT i Programmer s Manual Version 7 6 vi Contents 19 5 19 19 5 20 19 5 21 19 5 22 19 5 23 19 5 24 19 5 25 19 5 26 19 5 27 19 5 28 19 5 29 19 5 30 19 5 31 19 5 32 19 5 33 19 5 34 19 5 35 19 5 36 19 5 37 19 5 38 19 5 39 19 5 40 19 5 41 19 5 42 19 5 43 19 5 44 19 5 45 19 5 46 19 5 47 19 5 48 19 5 49 19 5 50 19 5 51 19 5 52 19 5 53 19 5 54 19 5 55 19 5 56 19 5 57 iATH Set PPP Authentication Method ees see ees ss se ees ee se ee ee se 19 29 iUSRN Define Connection User Name iese se ee ER ee se 19 30 iPWD Define Connection Password ese ss es se ee ee ee ee ee 19 31 iRDL Number of Times to Redial ISP ee se ee Re ee 19 32 iRTO Delay Period Between Redials to ISP ese se ee se 19 33 iDNSn Define Domain Name Server IP Addres ies ee se 19 34 iSMTP Define SMTP Server NAME iese ee ees se ees se ee ee ee ee ee 19 35 iSMA SMTP Authentication Method ees se es se ee ee se ee ee ee 19 36 iSMU Define SMTP Login User Name ees see ees ss se ee ee se ee ee se 19 37 iSMP Define SMTP Login Password sesse esse ees ss se ees ee se ee ee ee 19 38 iPDSn Define PING Destination Server iese ees se ee se ee ee ee 19 39 iPFR PING Destination Server Polling FreguenCY eise sesse esse 19 40 iSBJ Email Subject Field soen EE Re EG EE Ee 19 4 iTOA Define Primary Addressee ees see ss se ee ER ee ER ee se 19 42 iTO Em
42. 3 Flow Control 13 4 Software Flow Control Diagram during Socket Send ISSUE AT iSSND lt hn gt lt sz gt N Yes Vv Send lt sz gt Vv Wait for VOK j gt gt Send Next a l No END Byte Received fro iChip No Wait for No Yes VError nnn Error code Wait code Wait for RP4 reply Yes byte from iChip A No Continue code Yes Pause Figure 13 2 Software Flow Control in Socket Send CO110PC AT i Programmer s Manual Version 7 6 13 4 Flow Control 13 5 Host 2 iChip Hardware Flow Control As an alternative to the software flow control method which reguires 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 will return VERROR 063 This convention safeguards iChip from lockup which may arise if FLW Bit 0 is set while the CTSH signal is constantly HIGH For hardware flow control to operate properly the CTS and RTS signals between the host and iChip UARTS must be interconnected iChip CTSH and RTSH may be shorted to circumvent H W flow control Under this mode iChip will assume that the host transmission may be paused by de asserting the CTS signal Th
43. 9 63 iSNSI SerialNET Device Serial Interface iese ee se ee ee 19 64 iSTYP SerialNET Device Socket Type iese es se ee Re ee 19 65 iSNRD SerialNET Device Re initialization DelaY iese se 19 66 iPTD SerialNET Packets To Discard ees ss ees ss se ee ee se ee ee se 19 67 CO110PC AT i Programmer s Manual Version 7 6 vii Figures FIGURES Figure 13 1 Software Flow Control in FTP Send esse esse esse esse es se Gee ee ee ed ee 13 2 Figure 13 2 Software Flow Control in Socket Send esse se ee ee Se ee ee Gee 13 4 Figure 13 3 Minimum Hardware Flow Control ConnecHONnS esse ss se esse es see see ee 13 5 Fig re 17 1 EP Receive PlOwe batt isdie Se be es gee eds ristini 17 2 CO110PC AT i Programmer s Manual Version 7 6 vii Tables Tables Table 2 1 ATH Commands by Categories esse ee osse es ed Se Se GE ee Ee Re RR de 2 4 Table 3 1 ATH Result Code Summary oe Gee SESSE Bek NR eg Gee ee n Se ee Se ee eg 3 3 Table 4 1 Report Status Message BOrmiat EE N Ge ed Ge be Ee Ge 4 2 Table 13 1 Software Flow Control Control Characters sesse sesse ee se ee ee ee ee ee 13 1 Table 19 1 Nonvolatile Parameter Database iis sesse ee se ee ee ee ee ee GR ee Ge ee ee 19 5 CO110PC AT i Programmer s Manual Version 7 6 iii AT i Command Set 1 AT i Command Set 1 1 AT i Command Guidelines The AT i commands for Internet mode operations used to control the iChip Internet Controller are
44. ANDS ccessessscscesececeesessaeeececececeesssseaeeeeeeeeeenes 19 9 19 5 1 iXRC Extended Result Code ees ee ee ee ee ee ee ese ee ee ee ee ee ee ee ee ee 19 10 19 5 2 tiDMD Modem Dial Mode ee ee ee ee ee ee ee ee Re Re ke Re ke ke ke ee ee 19 11 19 5 3 tiMIS Modem Initialization String eise se ee Re RR GR RR 19 12 19 5 4 iMTYP Set Type of Modem Connected to Chip esse esse ee 19 13 19 5 5 iWTC Wait Time Constant ee es ss ee ee ee ee ee ee ee ee ee ee ee 19 15 19 5 6 tilTO TCP TimeOuH ees ee ee ee ee ee ee Re Re Re ke ke Re Re ee ke ke RE ke ke ee ee 19 16 1987 iPGT PING TAR COUE oe eron annii De ER ee 19 17 19 5 8 iMPS Max PPP Packet Siz ese ee ee ee ee ee eke ee ee ee ee ee ee ee ee 19 18 19 5 9 iTTR TCP Retransmit Timeout 19 19 19 5 10 iBDRF Define a Fixed Baud Rate on Host Connection 0000 19 20 19 5 11 iBDRM Define a Fixed Baud Rate on iChip Modem Connection19 21 19 5 12 iLATI TCP IP Listen Socket to Service Remote AT I commands 19 22 19 5 13 iFLW Set Flow Control Mode sd ese Ed ee N ie ee 19 23 19 5 14 iPSE Set Power Save Mode dee Ee Ns ee ee ee ke be di 19 24 19 5 15 iWDM Set Watchdog Activation Mode see ees ee se se ee se ee 19 25 19 5 16 iSDM Service Disabling Mode se ER RR RA SE RR 19 26 19 5 17 iDF IP Protocol Don t Fragment Bit Value iese see ss se ee 19 27 ID 5 18 i lSPn Set ISP Phone Number ocean ee ee Ee 19
45. AT i CO110PC Programmer s Manual Version 7 6 September 2004 International USA Connect One Ltd Connect One Semiconductors Inc 2 Hanagar Street 15818 North 9th Ave Kfar Saba 44425 Israel Phoenix AZ 85023 Tel 972 9 766 0456 Tel 408 986 9602 Fax 972 9 766 0461 Fax 602 485 3715 E mail info connectone com E mail info connectone com http www connectone com http www connectone com Pub No 20 5100 07_6 September 2004 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 It is forbidden by law to copy the software on any medium except as specifically allowed in the license agreement No part of this document may be reproduced or transmitted in any form or by any means electronic or mechanical including but not limited to photocopying recording transmitting via fax and or modem devices scanning and or information storage and retrieval systems for any purpose without the express written consent of Connect One iChip iChip LAN iChip Plus Socket iChip iConnector Embedded iModem Internet Controller Instant Internet SerialNET iLAN iModem Fax Messenger AT i and
46. CLS CLOSE SOCKET siese se Ves ede gee ds beleg ges se gees ids Vee gee ese es Set ges Se eed 10 12 11 SPECIAL MODEM COMMANDS ccccccccssssssssscscscssssssscssssssssssssssssssssssecees 11 1 11 1 IMCM ISSUE INTERMEDIATE COMMAND TO MODEM ssccccseeeeceeees 11 1 12 IP REGISTRATION siscstvisiscciseccccaesesicostecccecsesesiecetaceucdaccesicdetecsdocecesaieceddsacedanestscsase 12 1 12 1 SOCKET REGISTRATION rnn ae a a aa aa eaaa 12 1 12 2 WEB SERVER REGISTRATION iese ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 12 1 13 FLOW CONTROL sesse esse sedes se ds se dese Ge se eg Ge de Ge Ge Ge Ge de ee de ee se be Ge de Ge dee Ge Ge de de de Ge de de Ge de 13 1 13 1 HOST ICHIP SOFTWARE FLOW CONTROL ee ese ee ee ee ee ee ee ee ee ee ee ee ee 13 1 13 2 SOFTWARE FLOW CONTROL DIAGRAM DURING FTP SEND iese ees esse 13 2 13 3 SOFTWARE FLOW CONTROL DURING A SOCKET SEND ccccsseseeceeceececeeees 13 3 13 4 SOFTWARE FLOW CONTROL DIAGRAM DURING SOCKET SEND sseeeeeeeeee 13 4 13 5 HOST ICHIP HARDWARE FLOW CONTROL esse ee ee ee ee ee ee ee ee ee ee ee ee 13 5 14 ICHIP FIRMWARE UPDATE cccccsssssssssssssssssssssssssssssssssssssssssssssssssssssseces 14 1 15 ICHIP RAS SERVER iese sssssd ses sos dese sed se od de ee ve se ee do od ee od de de ee de od de oe da se ee Ge ee ei da 15 1 15 1 INFRODUCTION SE Se eo Ee Ee oe ee 15 1 152 RAS PARAMETERS RE SR es be ee ee A De
47. Connect One are trademarks of Connect One Ltd Copyright 2000 2004 Connect One Ltd All rights reserved CO110PC AT i Programmer s Manual Version 7 6 il Revision History Revision History 20 5100 07 6 7 6 Sep 2004 First Release of AT i Protocol subset for CO110PC Based on AT i Programmer s Manual revision 7_4b CO110PC AT i Programmer s Manual Version 7 6 iii Contents CONTENTS 1 ATH COMMAND SED ivicscscetccscicistteccssccedisetiscosdsonsesescasevoscsosovcescendvescsoocessdconssosssoocee 1 1 1 1 AT I COMMAND GUIDELINES iese see ese ee se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 1 1 1 2 AT I COMMAND FORMAT ede ee se sesse see ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 1 1 1 3 ESCAPE CODE SEOUENCE ese ee ee ee ee ee ee i ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 1 1 1 4 AUTO BAUD RATE DETECTION cccccccccccccsssseseeccccceccssessssscecccssssusnseeeeescssesanea 1 2 1 5 RESET VIA SERTAL SINK ee ee EE Gee Ge cust ee ee ee ee cide oe ee dee Ee 1 2 1 6 RESET VIA FORCED WATCHDOG ACTIVATION cccscecccceseececceseececceseececceneess 1 2 1 7 INTERNET SESSION HANG UP PROCEDURE sscecccceseececcescececcesceccccsseececeencess 1 3 1 8 MODEM STARTUPS rs see Sek ee ode se Poog ee se oe se gee de De ee ae cians Go es ee ee dee 1 3 1 9 OPTIONAL FIRMWARE REVISIONS eise esse ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 1 3 2 GENERAL FORMAT iassess
48. ET mode will extend across power down since it is assumed that once acting in this mode iChip will not normally be connected to an AT i aware host SerialNET mode may be terminated by a applying power to the iChip with the MDSEL signal pulled low for less than 5 seconds or b issuing the ESC sequence defined as lt half second Delay gt followed by 3 characters through the serial port When one of these events occurs iChip shall reboot after terminating SerialNET mode At this point iChip reverts to its normal operational mode and again responds to AT i commands CO110PC AT i Programmer s Manual Version 7 6 16 1 SerialNET Operation 16 3 Server Devices Server devices linger until approached by a remote client The remote client must know iChip s IP and Listen port address in order to establish communications A dial up device is normally offline and must thus be awakened to go online at a precise moment Moreover once it connects to the Internet it usually receives a dynamic IP address This address must be communicated in some way to the client device in order to establish a link across the Internet iChip resolves these problems by supporting a wake up call and automatically implementing one or two IP registration procedures This allows a client to wake up an iChip in SerialNET mode and retrieve its dynamic IP address from a registration server iChip waits for a RING signal on the modem to tr
49. Flush character When received SNET SerialNET socket will be flushed MCBF INT 0 1460 0 None iChip 110 Max characters before flushing the SNET SerialNET socket IATO INT 0 32768 0 None iChip 110 Inactivity timeout in seconds before SNET closing the SerialNET connection SNSI String 9 chars 5 8N 1 0 iChip 110 SerialNET mode Serial interface SNET configuration Defines baud bits parity stop and flow control STYP Byte 0 1 0 TCP iChip 110 Set the SerialNET mode socket type 0 SNET TCP or 1 UDP SNRD INT 0 3600 0 No Delay iChip 110 Delay time in seconds before SNET re enabling SerialNET mode after a failed connection PTD INT 0 65535 0 No Filter iChip 110 Specifies the number of Packets to Drop SNET during a SerialNET session Table 19 1 Nonvolatile Parameter Database CO110PC AT i Programmer s Manual Version 7 6 19 5 Nonvolatile Parameter Database 19 2 iFD Restore all Parameters to Factory Default Syntax AT iFD Restore iChip s nonvolatile parameter database values to factory defaults Parameters None Scope iChip CO110PC Command Options Each of iChip s nonvolatile parameters described in the following section has an associated default value This command restores all parameters to the default value An exception to this are the MIS Modem Init String and RPG Remote Parameter Group Password which will always retain the last s
50. GSM Modem n 5 Reserved n 6 Standard 2400 baud modem increased timeout n 7 GSM 536 limit packets to 536 bytes n 8 Reserved n 9 Wavecom Fastrack Cellular Modem 4100 Add 100 to any modem type to prohibit iChip from issuing an ATZ to the modem before dialing the ISP when an Internet session is activated This is useful if the modem needs to be initialized manually before an Internet session Note that an ATZ will be issued when the session is terminated Default n O Standard Hayes compatible Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHMTYP Returns current modem type designator The reply is followed by VOK Note 1 Configure the iChip to work with GPRS modems as follows 1 AT iMTYP 2 GSM GPRS modem type 2 AT iXRC 0 blind dialing 3 ATHISP1 lt SP Provider dial number gt usually 99 1 4 AT iMIS AT CGDCONT 1 IP lt Proxy gt Note 2 Changing from Modem type 4 Falcom GSM Modem CO110PC AT i Programmer s Manual Version 7 6 19 13 Nonvolatile Parameter Database When iChip is configured with MTYP 4 Falcom GSM Modem the MT YP parameter must first be changed to the special value 99 before it maybe changed to some other value CO110PC AT i Programmer s Manual Version 7 6 19 14 Nonvolatile Parameter Database 19 5 5 iWTC Wait Time Constant S7 to the required value using the ATS7 n Syntax AT iWTC n This parameter is used t
51. ISP Syntax AT iRTO n Parameters Command Options Default Scope Result code VOK VERROR AT iRTO Permanently set delay period in seconds between redials to ISP 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 n 0 3600 180 seconds iChip CO110PC If n is within limits Otherwise Report the current number of seconds to delay before redialing the ISP The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 33 Nonvolatile Parameter Database 19 5 24 iDNSn Define Domain Name Server IP Address Syntax AT iDNSn I P Parameters Command Options IP 0 0 0 0 IP IP add Default Scope Result code VOK VERROR ATHDNSn Permanently set 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 lt nnn gt lt nnn gt lt nnn gt lt nnn gt Where lt nnn gt 000 255 n 1 2 Empty No DNS defined IP add will be used to communicate to the Domain Name Server on the Internet Empty No DNS defined The DNS must be defined ad hoc iChip will retrieve a DNS IP to an empty DNS from the ISP if the ISP supports RFC 1877 PPP Extensions for Name Server Addresses
52. Manual Version 7 6 19 29 Nonvolatile Parameter Database 19 5 20 iUSRN Define Connection User Name Syntax AT iUSRN user Permanently set connection User Name Parameters user User name to be used when logging on to the ISP Command Options user Empty No user name defined user lt user name gt user name will be used to login to the ISP Default Empty No user name defined The login user name may be defined ad hoc Scope iChip CO110PC Result code VOK If user is an empty or a legal ISP login name VERROR Otherwise ATHUSRN Report the current login user name If the user name does not exist only lt CRLF gt will be returned The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 30 Nonvolatile Parameter Database 19 5 21 iPWD Define Connection Password Syntax AT iPWD pass Permanently set connection password Parameters pass Password to be used when logging on to the ISP Command Options pass Empty No password defined pass lt password gt password will be used to login to the ISP Default Empty No password defined The login password may be defined ad hoc Scope iChip CO110PC Result code VOK If password is an empty or a legal ISP login password VERROR Otherwise ATHPWD Report the current login password The reported value will consist of characters The number of characters shall reflect the number of characters in the actual passwor
53. NULL iChip 110 RAS Login User Name String 64chars NULL iChip 110 RAS Login Password 0 0 0 0 iChip 110 IP address assigned to iChip es RRMA String 64 chars NULL iChip 110 Set the Email address to use for dynamic IP address registration after going online RRSV String 64 chars NULL iChip 110 Set the server name IP and port to contact for dynamic IP address registration after going online RRWS String 128 chars NULL iChip 110 Set the Web Server URL used for dynamic registration after going online RRRL String 64 chars NULL iChip 110 Set the Return Link IP address to use when performing an IP address registration behind a NAT HSTN String 64 chars NULL iChip 110 iChip s Network Host Name Is included in all IP registration methods CO110PC AT i Programmer s Manual Version 7 6 19 4 Nonvolatile Parameter Database HSRV String 64 chars NULL iChip 110 Set the remote host server name IP and SNET port DSTR String 8 chars NULL iChip 110 Set the disconnection string template SNET LPRT Unsigned 0 65535 0 iChip 110 Set the SerialNET mode listen socket INT SNET MBTB INT 0 2048 o iChip 110 Max bytes to buffer while iChip is SNET establishing a connection MTTF Unsigned 0 65535 0 None iChip 110 Max inactivity timeout in milliseconds INT SNET before flushing the SerialNET socket FCHR Byte 1 char 0 None iChip 110
54. OK CO110PC AT i Programmer s Manual Version 7 6 19 22 Nonvolatile Parameter Database 19 5 13 iFLW Set Flow Control Mode Syntax AT iFLW n Set the flow control mode Parameters n 0 7 Command Options n Bitmapped flags BitO 0 Host S W flow control using Wait Continue control characters 1 Host H W flow control based on CTS RTS hardware signals Bit 1 O No Modem flow control 1 Modem H W flow control based on CTS RTS hardware signals Bit3 Reserved Default 0 Host S W flow control No modem H W flow control Scope iChip CO110PC Result code VOK If n is within limits See Note VERROR Otherwise AT HFLW Returns current flow control mode The reply is followed by I OK Note When setting Bit 0 Host H W flow control the CTSH signal must be LOW Enabled Otherwise iChip will return VERROR 063 CO110PC AT i Programmer s Manual Version 7 6 19 23 Nonvolatile Parameter Database 19 5 14 iPSE Set Power Save Mode Syntax AT iPSE n Parameters Command Options Default Scope Result code VOK VERROR AT iPSE Enable or Disable iChip s Power Save Mode n 0 1 n 0 Disable Power Save mode n 1 Enable Power Save mode When Power Save mode is enabled iChip will automatically shutdown most of its circuits after a period of 5 seconds without any activity on the host or modem serial ports Renewed activity on the serial ports will restore iChip to full op
55. PC ESFT Command Options lt text lines gt lt ASCII text line gt lt CRLF gt lt CRLF gt lt CRLF gt EOA uses the specified SMTP server to send the Email message Depending on the setting of the FLW parameter the flow control mode is either software or hardware Under software flow control mode the Host processor must respond to iChip s flow control characters The flow control protocol is detailed in the Host gt iChip Software Flow Control section later in this document Under hardware flow control the CTS RTS RS232 control signals must be connected and the host must respond to iChip s CTS signal The host may send data only when the CTS signal is asserted active low Stay On Line after completing the command Result code VOK After all text lines have been received and terminated by the line VERROR If a memory overflow has occurred before all text lines have been received Followed by VDONE After successfully sending the Email Allow a 2 5 sec delay for iChip re initialization following an Internet mode session or VONLINE After successfully sending the Email if the stay online flag was specified or VERROR If some error occurred during the send session CO110PC AT i Programmer s Manual Version 7 6 6 1 HTTP Client Interface 7 HTTP Client Interface 7 1 Syntax RLNK Retrieve Link ATH JRLNK URZ Parameters Scope Command Options lt protocol gt
56. Programmer s Manual Version 7 6 19 51 Nonvolatile Parameter Database 19 5 42 iHSRV Host Server Name IP Syntax AT iHSRV server_name port Permanently set the host server name or IP and port number to be used in SerialNET mode 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 server name defined Serial data transmitted from device in SerialNET mode will be ignored until a remote client accesses iChip server_name lt server gt server will be used in SerialNET mode to locate and establish a connection when serial data is transmitted from the device The server name may be any legal Internet server name which can be resolved by the iChip s DNS Domain Name Server settings The server name may also be specified as an absolute IP address given in DOT form port lt port number It is assumed that the host server is listening on port number Default Empty Scope iChip CO110PC SNET Result code VOK If server name is an empty or legal server name and port is within limits VERROR Otherwise ATHHSRV Report the current host server and port as lt server gt lt port gt If a server name does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 52 Nonvolatile Parameter Database 19 5 43 iDSTR Defin
57. SNET if n is within limits Otherwise Report the current value of the SerialNET device listen port The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 54 Nonvolatile Parameter Database 19 5 45 iRRSV Ring Response Host Server Name Syntax AT iRRS V server_name port Permanently set the IP registration server name or IP and port number 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 server_name lt ip_registration_server gt ip_registration_server will be used to locate and establish a connection after iChip establishes an Internet session connection The dynamically assigned IP address will be sent to the server in ASCII form after which the socket will be closed See Socket IP Registration port lt port number gt It is assumed that the host server is listening on port number Default Empty No server defined Scope iChip CO110PC Result code VOK if ring response server is an empty or legal server name and port is within limits VERROR Otherwise ATHRRSV Report the current IP registration server name and port number If a server name does not exist only lt CR LF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 55 Nonvolatile Parameter Da
58. T Version type code ss Sub version lt firmware option gt Empty for baseline firmware SNET for SerialNET option ESFT for Email send amp FTP option 2 Status string Modem data lt CR LF gt Command mode lt CR LF gt lt CR LF gt Connecting to ISP lt CR LF gt lt CR LF gt Connected to ISP lt CR LF gt lt CR LF gt Closing PPP lt CR LF gt lt CR LF gt Establishing SMTP lt CR LF gt lt CR LF gt Sending Email lt CR LF gt lt CR LF gt Establishing HTTP lt CR LF gt lt CR LF gt Carrier Lost lt CR LF gt 3 Reserved 4 I lt sockOsz gt lt sockIsz gt lt sock9sz gt sock lt i gt sz 2 0 Number of bytes pending in socket s input buffer lt 0 Negative value of Socket s Error code 5 nnnnnnnn Hexadecimal representation of iChip serial number 6 Reserved 7 Moor xxxx 16 bit Hex Value Bitmap A bit set to I indicates that the corresponding socket contains buffered data which needs to be read by the host bit 15 0 socket 9 8 7 6 2 4 3 2 1 0 8 Reserved Table 4 1 Report Status Message Format CO110PC AT i Programmer s Manual Version 7 6 4 2 Connection 5 Connection 5 1 iBDRA Forces iChip into Auto Baud Rate Mode Syntax AT iBDRA Forces the iChip into auto baud mode The following A AT or AT i command in any combination of upper or lower case from the host will synchronize on the host s baud rate Parameters None Scope iChip CO110PC
59. T line is not a Ox7E iChip will remain in Transparent mode and a regular modem to modem data session will transpire CO110PC AT i Programmer s Manual Version 7 6 15 3 RAS Server 15 3 2 SerialNET Mode The RAS may also be enabled while iChip is in SerialNet mode In this case however the modem RING strings will not be forwarded to the host serial port Once the PPP connection is established iChip will proceed to act as it would after receiving a RING event and creating a PPP connection to a remote RAS server That is a listen socket will be established on the LPRT socket available for a SerialNET connection This provides an alternative means to wake up a SerialNET server device CO110PC AT i Programmer s Manual Version 7 6 15 4 RAS Server 15 3 3 Lost Carrier When iChip is online as a result of a RAS connection and the Carrier signal is lost due to an error or due to the PPP client closing the connection iChip will check if the host used the PPP connection tried to open an internet session during the connection If the host did not use the connection or iChip was in SerialNET mode iChip will silently perform software reset and no indication of the disconnection will be given to the host Otherwise if the host did use the connection iChip will act as if this was a regular session created by the host that was terminated with a lost Carrier signal The error code will be returned to
60. To description to Contents of To description name field to Empty string to lt to_str gt The To description field in the Email header will contain to_str Empty iChip CO110PC ESFT If to is an empty or legal string Otherwise Report the current contents of the to parameter If the to parameter is empty only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 43 Nonvolatile Parameter Database 19 5 34 iREA Return Email Address Syntax AT iIREA Email Permanently set the Return Email Address This is the Email address that will be used when replying to this Email Parameters Email Email addressee Command Options Email Empty address No return address defined Email lt addr gt 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 Scope iChip CO110PC ESFT Result code VOK ATHREA Report the current value of the return Email address If the return Email address does not exist an empty line containing only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 44 Nonvolatile Parameter Database 19 5 35 iFRM Email From Description Name Syntax AT iFRM from Parameters Command Options Permanently set Email header From description from Conte
61. acklog gt was used when opening the listen socket identified by lt hn gt lt hn gt gt 0 A handle to an active connected socket 1 No connection has been established If lt hn gt is not an open listen socket or otherwise some error occurred CO110PC AT i Programmer s Manual Version 7 6 10 4 Direct Socket Interface 10 5 iSST Geta Single Socket Status Report Syntax AT iSST lt hn gt Retrieve a socket status report for a single socket This is a subset of the general AT iRP4 report command Parameters lt hn gt A TCP UDP socket handle Scope iChip CO110PC Command Options lt hn gt 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 listen socket Result code I lt sockstat gt Where lt sockstat gt gt 0 Number of bytes pending in socket lt hn gt s input buffer lt 0 Socket Error code VERROR If some error occurred CO110PC AT i Programmer s Manual Version 7 6 10 5 Direct Socket Interface 10 6 iSCS Geta Socket Connection Status Report Syntax AT iSCS lt hn gt Retrieve a socket s connection status report Parameters lt hn gt A TCP UDP socket handle Scope iChip CO110PC Command Options lt hn gt Must have been obtained by a previous execution of an AT iSTCP or ATHSUDP command during the current Internet mode session Or a socket accepted by a li
62. acter when it needs to pause the host The host application is required to monitor its serial receive line and pause the transmission when a WAIT control character is received 2 To resume the host transmission iChip will issue a CONTINUE control character The host is required to monitor its receive line after being paused in anticipation of this control character Once received the host may continue to transfer the data stream 3 If an error occurs during the Internet session while the host is transferring the data stream or while paused iChip will issue an ERROR control character if some error occurred Immediately after issuing this control character iChip will abort the Internet session and issue an I ERROR error number string The host must cease transmitting the data stream when the ERROR control character is received 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 13 1 Software Flow Control Characters CO110PC AT i Programmer s Manual Version 7 6 13 1 Flow Control 13 2 Software Flow Control Diagram During FTP Send ISSUE AT iFSND lt h gt lt sz gt No Fa les Send lt sz gt Bytes y Wait for I m OK Send Next Byte j END Byte Received No from iChip No Wait for No Error
63. ail To Description Name ie ees se ee ER ee ER ee ee 19 43 iREA Return Email Address sis ese ie see ee ee se ee ae se ee eg ae ie 19 44 iFRM Email From Description Name iese ese ees ss se ee ee se ee ee ee 19 45 iCCn Define Alternate Addressee SN es ee ER ee ee 19 46 iURL Default URL Address ees ee se RR Re AR ee se 19 47 FIRAR RAS RINGS RE RE ee aamtanntessstncess 19 48 iRAU Define RAS Login User Name se es se ee ER ee ee ee 19 49 iRAP Password for RAS AuthentiCatON ee esse ees se ee se ee ee 19 50 i IPA Active IP AGA ress lines SG EE GR Ge 19 51 iHSRV Host Server Name IP iese sides eg Ge ase ge 19 52 iDSTR Define Disconnection String for SerialNET Mode 19 53 iLPRT SerialINET Device Listen POTE ees see ee es ss se ee se ee ee se 19 54 iRRSV Ring Response Host Server Name iese ee esse ees es se ese ee se 19 55 iRRWS Ring Response Web Server ees see es se ee ER ee ee ee ee ee 19 56 iRRRL Ring Response Return Link ees se ee Re ER ee ee 19 57 EIS TN 1Chip Host NaME eerst es RO EE ea ee Ge ee 19 58 iMBTB Max Bytes To Buffer iese ee ees se ee es se Re Re ee AR ee ee se 19 59 iMTTF Max Timeout To Socket Flush iese ee ees se ee ee ee ee ee 19 60 iFCHR Flush Character esse EE Ne De en IG Re ge 19 61 iMCBF Maximum Characters Before Socket Flush ees sees esse 19 62 ilATO Inactivity Timeout es ue ea ee GE teaelatn tera bdiaen 1
64. al Version 7 6 7 2 SerialNET Mode Initiation 8 SerialNET Mode Initiation 8 1 iISNMD Activate SerialNET Mode Syntax ATHi SNMD Activate SerialNET mode Parameters None Scope iChip CO110PC SNET Command Options Optional Auto Link mode When this flag is specified iChip will immediately go online when activating SerialNET mode even when serial data has not yet arrived If the LPRT Listen Port parameter is defined iChip will open the listen port and await a connection If LPRT is not defined but HSRV Host Server is defined iChip will immediately open a SerialNET socket link to the server Result code VOK If all minimum required parameters for SerialNET mode operation are defined HSRV or LPRT and for iChip also ISP1 USRN PWD VERROR Otherwise Followed by VDONE After successfully activating SerialNET mode allow a 2 5 sec delay for iChip re initialization Note To terminate SerialNET mode issue the ESC sequence or power cycle iChip with the MDSEL signal held low After exiting SerialNET mode iChip will return to normal AT i Command mode CO110PC AT i Programmer s Manual Version 7 6 8 1 File Transfer Protocol FTP 9 File Transfer Protocol FTP 9 1 i FOPN FTP Open Session Syntax AT i FOPN lt server gt lt port gt lt user gt lt pass gt lt accnt gt Parameters Scope Command Options lt server gt Sport lt user gt lt pass gt
65. cted 74 Modem Connection with ISP lost 53 Illegal command code 75 Access denied to ISP server 54 Error when setting parameter 55 Error when getting parameter value 56 User abort 57 Error when trying to establish PPP 58 Error when trying to establish 80 No suitable message in mailbox SMTP 81 Unable to locate SMTP server 82 SMTP server timed out 61 Internal memory failure 83 SMTP failed 62 User aborted the system 84 86 RESERVED CO110PC AT i Programmer s Manual Version 7 6 AT i Result Code Summary VERROR nnn Continued nnn 87 Web Server IP registration 111 Serial data overflow failed 88 Socket IP registration failed 112 Command illegal when modem online 90 IP registration failed for all 115 SerialNET could not be started due to methods specified missing parameters 200 Socket does not exist 94 In Always Online mode 201 Socket empty on receive connection was lost and reestablished 95 A Watchdog reset event had 202 Socket not in use occurred and restarted iChip 96 A remote host that had taken 203 Socket Down over iChip through the LATI port had disconnected 97 Reserved 204 No available sockets 98 Reserved 205 Obsolete 206 PPP open failed for socket 100 Error restoring default 207 Error creating socket parameters 101 No ISP access numbers defined 208
66. currently established through the listen socket Once the listen socket is open it will automatically accept remote connect requests until the maximum allowed When a remote system connects through the listen socket a new TCP socket is spawned internally and is ready to send and receive data See the AT iLSST command for details on retrieving the handles of active sockets connected through a listen socket When a connected socket is closed the listen socket will allow a new connection in its place Result code I lt sock handle gt Upon successfully opening a TCP listen socket a socket handle is returned The socket handle lt sock handle gt is in the range 10 11 and is used to reference the socket in all following socket commands VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 10 3 Direct Socket Interface 10 4 iLSST Get a Listen Socket s Active Connection Status Syntax AT iLSST lt hn gt Parameters Scope Command Options lt hn gt Result code Retrieve handles of active socket connections established through the listen socket identified by lt hn gt lt hn gt A TCP listen socket handle of an open listen socket iChip CO110PC Must have been obtained by a previous AT iLTCP command during the current Internet session IX lt hn1 gt lt hnpackiog gt Where VERROR A list of active socket handles The list shall contain lt backlog gt elements where lt b
67. d If a password does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 31 Nonvolatile Parameter Database 19 5 22 iRDL Number of Times to Redial ISP Syntax AT iRDL n Parameters Command Options n Default Scope Result code VOK VERROR AT iRDL Permanently set the number of times to redial ISP 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 In the event that the number is busy or the ISP does not respond the system will attempt to redial up to n times as with the primary ISP number If all redial attempts are exhausted the system will quit with the error message All Redial Attempts Failed If the ISP does not pickup the line iChip will timeout and determine a redial situation after the number of seconds stored in the WTC iChip parameter 0 20 5 iChip CO110PC If n is within limits Otherwise Report the current value of the number of times to redial ISP The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 32 Nonvolatile Parameter Database 19 5 23 iRTO Delay Period Between Redials to
68. d during the current Internet mode session Stay On Line after completing the command When command has been received and about to be processed When the FTP link was the last open socket and after successfully closing the FTP link Allow a 2 5 sec delay for iChip re initialization following an Internet mode session After successfully closing the FTP link when additional sockets are still active or the stay online flag was specified Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 13 Direct Socket Interface 10 Direct Socket Interface 10 1 iSTCP Open and Connect a TCP Socket Syntax AT iSTCP lt host gt lt port gt lt lport gt Opens a TCP Transmission Control Protocol client socket and attempts to connect it to the specified lt port gt on a server defined by lt host gt Parameters lt host gt Logical name of the target server or a host IP address lt port gt 0 65535 target port lt lport gt Optional local port on iChip Scope iChip CO110PC Command Options lt host gt The server name may be any legal Internet server name which can be resolved by the iChip s DNS Domain Name Server settings The server name may also be specified as an absolute IP address given in DOT form lt port gt It is assumed that the server system is listening on the specified port lt lport gt May be optionally specified to force iChip to use port as the local port when
69. disabled iChip CO110PC If user is an empty or a legal login user name Otherwise Report the current RAS login user name If the user name does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 49 Nonvolatile Parameter Database 19 5 40 iRAP Password for RAS Authentication Syntax AT HiRAP Pass Parameters Command Options Permanently set 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 Pass or Pass A password will not be required to authenticate a remote PPP client connection to iChip s internal RAS Pass lt password gt password will be used to restrict access Default Scope Result code VOK VERROR ATHRAP of a remote PPP client connection to iChip s internal RAS Empty No Password defined iChip CO110PC If pass is an empty or legal Password Otherwise Report the current RAS Password If a Password does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 50 Nonvolatile Parameter Database 19 5 41 iIPA Active IP Address Syntax AT iIPA Reports the active IP address Parameters None Scope iChip CO110PC Note The IP address is always 0 0 0 0 when the iChip is offline CO110PC AT i
70. e printers Input only i e controllers and interactive bi directional communications The latter are subdivided further into clients and servers Generally clients initiate communications by sending service demands to a server while servers respond to client demands SerialNET mode reacts differently to client or server devices When a client device initiates communications Serial NET mode must establish a network connection to a remote server before data may flow between the two systems On the other hand when a remote client needs to invoke a device the remote client first contacts iChip and SerialNET is invoked to create a communication flow to the local server device SerialNET mode in iChip includes components to handle both server and client local devices The iChip under SerialNET mode will route full duplex data between a networked terminal and both types of devices 16 2 SerialNET Mode iChip s SerialNET mode is established by first defining all related parameters using AT i commands followed by a special Enter SerialNET Mode AT i command Once in SerialNET mode no additional AT i commands may be sent as the host serial link will be dedicated to raw local device data In this mode auto baud rate is also disabled since it cannot be guaranteed that the device will issue an a or A as its first character Thus a predefined fixed baud rate must be specified before switching over to SerialNET mode SerialN
71. e Disconnection String for SerialNET Mode Syntax AT iDSTR disconnect_string Permanently set SerialNET device disconnection string iChip will also go offline following this event Parameters disconnect_string String expected on 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 disconnect_string lt string gt string received on serial link will signal socket disconnection string is composed any mix of printable ASCII characters and characters represented by 2 hexadecimal digits as xhh where h is a hexadecimal digit 0 9 or A F Hexadecimal representation allows specifying non printable characters Default Empty Scope iChip CO110PC SNET Result code VOK If disconnect string is an empty or legal string VERROR Otherwise AT iDSTR Report the current contents of the disconnect_string parameter If the disconnect_string parameter is empty only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 53 Nonvolatile Parameter Database 19 5 44 iLPRT SerialNET Device Listen Port Syntax AT iLPRT n Parameters Default Scope Result code VOK VERROR AT iLPRT Permanently set the port number on which iChip will listen for client connections in SerialNET mode n 0 65535 0 no port iChip CO110PC
72. e host must adhere to this convention Most UARTs support hardware flow control however if this is not the case iChip s CTS signal should be monitored by the host software on a general purpose I O The host may also pause the iChip by de asserting its CTS signal If a transmission error occurs during processing of a send command SSND EOA FSND iChip shall accept all remaining characters pertaining to the current command as specified by the lt sz gt parameter before returning the relevant VERROR response HOST iChip Figure 13 3 Minimum Hardware Flow Control Connections CO110PC AT i Programmer s Manual Version 7 6 13 5 Firmware Update 14 iChip Firmware Update iChip CO110PC only accepts firmware updates directly over its local serial port iChip s boot loader contains a permanent preprogrammed monitor that governs the firmware update procedure To update iChip s firmware it is necessary to activate its monitor using one of two methods 1 Issue the AT iFU Firmware Update command 2 Apply power to iChip while the FUSEL signal pin 44 is held LOW When iChip s monitor is activated the CO110PC firmware update utility may be used to update a new firmware version Connect One s iChipConfig WIN PC Utility Version 2 3 38 and up supports CO110PC firmware update The iChipConfig Utility attempts to activate monitor mode by issuing the AT iFU command at a fixed baud rate of 115 Kbps Therefore iChip must
73. eady in operation In auto baud mode iChip expects an A or a character This is usually the first character sent since a meaningful command is always prefixed by AT I in Command mode The host may send an a or A to iChip to allow it to determine the host s baud rate It may also send a complete AT I command In any case the iChip will detect the A or a character determine the correct baud rate and configure iChip s serial channel during the stop bit Thus the serial port will always receive the next character at the correct baud rate The A itself is retained as well iChip supports auto baud rate detection for baud rates 2400 4800 9600 19200 38400 57600 and 115200 bits per second When the BDRF parameter contains a fixed baud rate iChip will initialize to the specified baud rate without entering the auto baud mode Commands issued by the host must be sent using that baud rate in order to be recognized In this case iChip may be forced into auto baud mode by holding the special input signal low for not more than five seconds after power up When the BDRM modem baud rate parameter contains an a value iChip assumes the attached modem has the auto baud rate feature Once the host gt iChip baud rate is determined the iChip 2 Modem baud rate will be set to the same Otherwise any other value in BDRM will be used as a fixed baud rate to the modem 1 5 Reset via Serial Link
74. eam When this is the case the host must monitor for a timeout condition of at least 5 seconds without any data being transmitted before seeing the VONLINE to deduce that the data stream is complete If lt sz gt was reported but a transmission error occurred preventing iChip from returning all lt sz gt data bytes an VERROR command will be issued after a 5 seconds non transmission period See FTP Receive Flow Diagram Followed by VONLINE After successfully retrieving the file contents CO110PC AT i Programmer s Manual Version 7 6 9 7 File Transfer Protocol FTP 9 8 iFSTO FTP Open File for Storage Syntax AT FSTO lt F_hn gt lt path gt lt sz gt Parameters Scope Command Options lt F_hn gt lt path gt Open a remote FTP server file for upload lt F_hn gt An open FTP Session handle lt path gt Destination file path name lt sz gt Optional size in bytes to reserve for the file on the remote FTP server iChip CO110PC ESFT 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 Following this command data is transferred to the remote file using one or more iFSND commands The file transfer is complete by issuing a iFCLF FTP File Close command Result code VOK VERROR If file lt path gt was successfully open for writing on the FTP serv
75. ed see preceding paragraph The BDRE parameter will then govern iChip s baud rate mode CO110PC AT i Programmer s Manual Version 7 6 16 5 FTP Theory of Operation 17 File Transfer Protocol FTP Theory of Operation 17 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 Email and direct socket manipulation As in all other iChip protocol implementations host involvement in the specifics of FTP is kept minimal iChip needs to deal with non standard FTP issues such as possible differences between FTP server responses on its own Multi stage FTP protocol sequences are atomized under iChip control to minimize complexity and need for host processor intervention The FTP protocol is described in RFC 959 17 2 iChip FTP Client Command Set Open FTP link to FTP Server e Retrieve File List from Server Change Directory on Server Retrieve File Contents from Server Open a New File on Server Open an existing File on Server for Append Send Binary Data to an open File on Server Close a File on Server After Binary Data Send Delete File on Server Close FTP Session 17 3 iChip FTP Client Operation Mode FTP specifies several operational modes The RFC calls for a minimum implementation which should be observed by all FTP server
76. ed to connect to iChip s remote AT 1 service 18 2 Remote AT i Commands When a remote client connects to iChip s LATI socket iChip redirects the socket s data flow to the AT 1 parser in effect allowing the socket to take over the parser Any data coming from the socket will be processed by iChip as if it came from the host serial port and the replies will be returned to the socket instead of being sent to the host serial port iChip will reply with an I BUSY to commands coming from the host serial port while the remote client is connected An exception to this is the Escape sequence On detection of from the host serial port iChip will close the remote connection and reboot If iChip was in the process of performing some Internet activity initiated by the host at the time the remote client connected iChip will allow this activity to end and the final reply to reach the host before passing control over the parser to the remote client 18 3 Closing a Remote AT i Session To close a remote AT 1 session the remote client can choose to issue AT iDOWN via the socket In response to this iChip will restart Only I OK will be returned over the socket before it is closed by iChip Alternatively the remote client may close the socket in order to disconnect leaving iChip s Internet session as is In the latter case iChip will return control over the parser to the local host port The LATI listen will remain active availab
77. ee ee Ge Ge Ee Re Die 15 1 15 3 RAS THEORY OFOPERATION eie ee ee ee ee ee se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 15 2 15 3 1 Ama PPP RAS Mod ie ee GE Ge Ee SS Ge Ge Ge Ge de i 15 3 1532 SerialNEL Mod ie ER sik ete esate Ge SES Pe Ge Re Es Re eed 15 4 ES LOS LA OE N RNR 15 5 15 34 RestriCHORS EE RS n ES Ge EE A Ge Ee Ge Eg Ge GE EE EG De Gee Ge Ee ee 15 6 16 SERIALNET THEORY OF OPERATION esse sees esse esse sesse sees ee ee ee ee ee ee ee ee ee ee ee 16 1 1624 INTRODUCTION iese esse ee dee Dye Dee Gegee gee a ee ee Ee Gee ee ede A EEO Sa 16 1 CO110PC AT i Programmer s Manual Version 7 6 Contents 16 2 SERIALNET MODE i e iese ese ee ese ee ee ee ee ee ee ke ee ee ee de Ge Re Re ee ee ee RR Re Re ee ee ee ee 16 1 16 3 SERVER DEVIEES Sel de esse ek es Vee Ee ee ee de apd ee ee sees sah bas Ve Gee ge bee bee 16 2 16 4 CLENE DEVICES oe GE Ee eb 16 2 16 5 AUTOMATIC SERIALNET SERVER WAKEUP PROCEDURE sees se ee ee ee ee ee ee 16 3 16 6 TRANSMIT PACKETS oan ese seges Ee es shes ee Eed ese os gee eke ee gee Eed bes EE og Gee 16 3 16 7 COMPLETING A SERIALNET SESSION esse ees sees ee se ee ee se ee ee ee es ee ee ee ee ee ee ee ee ee ee 16 4 16 8 SERIALNET FAILED CONNECTION SE Ge ee Gee ee GN Re ee gee ee ee 16 4 16 9 LOCAL SERIAL PORT CONFIGURATION ccssccccccccccsesessssececececseeessnseseeeseeseeenes 16 4 16 10 ACTIVATION COMMAND esse ese ee ee oe se ee ee ge ee ee ee Re Re ee de Ge RR Re
78. ee ee ee ee ee ee 7 2 7 1 HRLNK RETRIEVE LINK ees ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 7 2 8 SERTALNET MODE INITIATION eeeeseseeee sees esse sees sees ee ee ee ee ee ee ee ee ee oe oe ee ee Ge ee ee ee ee ee 8 1 8 1 ISNMD ACTIVATE SERIALNET MODE ese ss ee ee ee ee ee ee ee ee ee ee ee ee ee ee 8 1 9 FILE TRANSFER PROTOCOL FTP ccccccssssssscsccscccssssssscsscscccssesssscecccossees 9 1 9 1 I FOPN FTP OPEN SESSION ees ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 1 9 2 IFDL FTP DIRECTORY LISTING ee esse se se se se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 2 9 3 IFDNL FTP DIRECTORY NAMES LISTING ees ese ee ee ee ee ee ee ee ee ee ee ee ee 9 3 9 4 IFMKD FTP MAKE DIRECTORY esse se ss ee sees ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 4 9 5 IFCWD FTP CHANGE WORKING DIRECTORY esse esse see ee ee se se ee ee ee ee ee 9 5 9 6 IESZSETP EIE SESSE E GR ee 9 6 9 7 IFRCV FTP RECEIVE FILE esse ee se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 7 9 8 IFSTO FTP OPEN FILE FOR STORAGE eie ee ees ee ee ee ee se ee ee ee ee ee ee ee ee ee ee ee ee ee 9 8 CO110PC AT i Programmer s Manual Version 7 6 iv Contents 9 9 IFAPN FTP OPEN FILE FOR APPENDING ee ee ee ee se se ee ee ee ee ee ee ee ee ee ee ee ee ee 9 9 9 10 HESND FTP SEND FILE DATA woe ee esse se se se ee ee
79. ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 10 9 11 HECLESEIPCLOSEEBIEE esse ees Gees OOR tess Gee bee SO ee see ee ek ee Gee Gee bee di 9 11 9 12 EIEDEL FTP DELETE BILE GE Se Ee ea oe Me Ee ee ois faeces 9 12 9 13 IFCLS FTP CLOSE SESSION esse ee se se ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 9 13 10 DIRECT SOCKET INTERFACE ccccsssssssssscsssssssscssscssssssscsssssssssssssssceces 10 1 10 1 ISTCP OPEN AND CONNECT A TCP SOCKET esse esse ee ee ee ee ee se ee ee ee ee ee 10 1 10 2 SUDP OPEN A CONNECTIONLESS UDP SOCKET ee esse ee ee se ee ee ee ee ee ee 10 2 10 3 ILTCP OPEN A TCP LISTEN SOCKET iese sees ee ee ee se ee ee ee ee ee ee ee ee ee ee ee 10 3 10 4 ILSST GET A LISTEN SOCKET S ACTIVE CONNECTION STATUS ees 10 4 10 3 HSST GET A SINGLE SOCKET STATUS REPORT esse ee ee ee ee ee se ee ee ee see 10 5 10 6 HSCS GET A SOCKET CONNECTION STATUS REPORT ede see se es esse ee ee ee 10 6 10 7 ISSND SEND A BYTE STREAM TO A SOCKET esse sesse se ee ee ee se ee ee ee ee ee ee 10 7 10 8 ISRCV RECEIVE A BYTE STREAM FROM A SOCKET S INPUT BUFFER 10 8 10 9 IGPNM GET PEER NAME FOR A SPECIFIED SOCKET ccccccceseeeececeeeceeees 10 9 10 10 ISDMP DUMP SOCKET BUFFER ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 10 10 10 11 ISFSH FLUSH SOCKET S OUTBOUND DATA uu iese esse sees se se ee ee ee ee ee ee ee 10 11 10 12 IS
80. ell lt Ck gt Carriage Return Line terminator ASCII 13 2 1 AT i Commands by Category Parameters Description Command Prefix Required to precede all commands n 1 Echo all host characters lt par gt value Update Parameter Value Update parameter par to a new value The updated value is or stored in volatile memory RAM If iChip looses power the lt par gt value updated value is lost Use the AT iPARS command to retain updated values indefinitely For description of all available parameters see section 4 3 he parameter Parameter value is returned ED _ Factory Defaults Restores all parameters to Factory Defaults oe Store Parameter Updates Stores all parameter value updates to the nonvolatile to Nonvolatile Memory parameter database in Flash PARD Drop Parameter Updates Drops all parameter value updates effectively restoring to the value stored in the nonvolatile parameter database Request Status report Returns a status report value based on lt I gt Auto baud mode Forces the iChip into auto baud rate detection mode Connect to Internet This command forces iChip to go online establish an Internet session and optionally register its IP address Triggered Internet This command enters a mode where iChip will go online in Session Mode response to triggers from external signals It also supports a special Always Online mode DOWN Disconnect from Internet This command forces the iChip to terminate an Interne
81. er Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 8 File Transfer Protocol FTP 9 9 iFAPN FTP Open File for Appending Syntax AT iIFAPN lt F_hn gt lt path gt lt sz gt Parameters Scope Command Options lt F_hn gt lt path gt Open an existing remote FTP server file for Append lt F_hn gt An open FTP session handle lt path gt File path name lt sz gt Size in bytes to reserve for the file on server iChip CO110PC ESFT 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 Following this command data is transferred to the remote file using one or more iFSND commands The file transfer is complete by issuing a iRCLF FTP File Close command Result code VOK VERROR If file lt path gt was successfully open for appending on the FTP server Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 9 File Transfer Protocol FTP 9 10 iFSND FTP Send File Data Syntax AT iIFSND lt F_hn gt lt sz gt lt stream gt Upload data to a remote FTP server file Only valid after a successful AT iFSTO or AT iFAPN command Parameters lt F_hn gt An open FTP session handle lt sz gt The exact size of the data stream that follows lt stream gt a byte stream of size lt sz gt composing the remote file contents
82. erational mode 0 Disabled iChip CO110PC If n is within limits Otherwise Report the currently Power Save mode setting The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 24 Nonvolatile Parameter Database 19 5 15 iWDM Set Watchdog Activation Mode Syntax AT iWDM Set iChip s Watchdog operation mode Parameters n 0 4 Command Options n 0 Disabled Watchdog Function n Reserved for future use n 2 Enable Internal Watchdog circuit n 3 Reserved for future use n 4 Reserved for future use After the Watchdog circuit is enabled firmware stability and proper execution will be monitored In the event that the firmware crashes or does not execute properly the Watchdog circuit will generate a hard RESET Once iChip restarts it will 1 Restore the host serial port to the baud rate in effect when the WDR command was issued regardless of the BDRF parameter value 2 A modem hang up process will be performed to resolve the possible case where the modem was online when the RESET occurred 3 A BREAK condition is forced on the TXDH signal to notify the host that a Watchdog reset has occurred Default O Disabled Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHWDM Report the currently Watchdog activation setting The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 25 Nonvolatile Parameter Database
83. es a to the modem 5 Followed by ATH 1 8 Modem Startup After power up and baud rate determination iChip will issue the AT lt CR gt command to the modem to verify that the modem exists and is responding 1 9 Optional Firmware Revisions The CO110PC iChip device has a baseline firmware revision with support for basic Internet functionality Optional firmware revisions exist that enhance the baseline functionality as follows a SNET Adds SerialNET functionality to the baseline firmware b ESFT Adds Email Send and FTP functionality to the baseline firmware Some commands and parameters are restricted to a specific optional firmware version When this is the case it is listed in this manual under the Scope category as a Scope CO110PC SNET b Scope CO110PC ESFT All other commands and parameters exist in the baseline and are common to all firmware versions CO110PC AT i Programmer s Manual Version 7 6 1 3 General Format 2 General Format AT i lt cc gt lt del gt lt parameter gt lt CR gt lt cc gt or lt par gt 2 4 letter command code lt cc gt or parameter name lt par gt lt del gt Delimiter y lt parameter gt Optional parameter or data If lt parameter gt contents includes a lt del gt as defined above it must be enclosed in single or double quotes The terminating lt CR gt is considered as a terminating quote as w
84. et value Result code VOK After restoring parameters to default value CO110PC AT i Programmer s Manual Version 7 6 19 6 Nonvolatile Parameter Database 19 3 iPARS Store all Parameter Updates to Nonvolatile Database Syntax AT iPARS Store all parameter value updates currently in memory to the nonvolatile parameter database Parameter values are updated with AT 1 assignment commands AT i lt param gt lt value gt Following this command all current value updates will become permanent and shall retain their value after iChip is powered off Parameters None Scope iChip CO110PC Result code VOK After storing all parameter values CO110PC AT i Programmer s Manual Version 7 6 19 7 Nonvolatile Parameter Database 19 4 iPARD Drop all Parameter Updates Currently in Memory Syntax AT iPARD All parameter value updates currently in memory are dropped Following this command all parameters shall revert to the valued stored in the nonvolatile database Parameters None Scope iChip CO110PC Result code VOK After dropping all parameter value updates CO110PC AT i Programmer s Manual Version 7 6 19 8 Nonvolatile Parameter Database 19 5 Parameter Access Commands CO110PC AT i Programmer s Manual Version 7 6 19 9 Nonvolatile Parameter Database 19 5 1 iXRC Extended Result Code Syntax AT iXRC n Extended Result Code Same as ATXn This command selects which subset
85. g the ATA modem command During RAS PPP negotiations iChip will reply only to Escape sequence and AT iRPn commands Specifically iChip will reply Connecting as RAS to the AT iRP2 iChip Status command The Escape sequence may be used to abort the RAS session at any time The AT iRP2 command is the only means for the host processor to determine that a PPP session is in progress iChip manages the RAS protocol internally and does not transfer any information to the host Any other commands that may be received from the host will be disregarded by iChip Once the PPP connection has been fully negotiated and established iChip will respond to all AT i commands as when it is online Specifically iChip will reply RAS Connected to the AT iRP2 command As part of the PPP negotiation iChip will assign itself the default IP address 192 168 0 1 and allocate 192 168 0 2 as the client IP address However if the client requests a specific IP address iChip will always grant the client s request and use the client s IP minus as its own IP address The following restriction to the minus 1 rule will apply if the IP requested by the client minus is an IP address that ends with 0x00 or 0x255 as the last nibble iChip will assign itself with the client s IP plus 1 instead of minus 1 This is done to assure that the IP iChip assigns itself will never violate the rule that defines that a network or host IP segment may not be
86. header will be left empty subject lt subject string gt The Subject field in the Email header will contain subject string Default Empty Scope iChip CO110PC ESFT Result code VOK If subject is an empty or legal string VERROR Otherwise ATHiSBJ Report the current contents of the Subject parameter If no subject is defined only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 4 Nonvolatile Parameter Database 19 5 32 4iTOA Define Primary Addressee Syntax AT HTOA Email Permanently set Email addressee Parameters Email Email addressee This is the default Email addressee which will be used to direct Email messages sent by iChip Command Options Email Empty address No addressee defined Email lt addr gt _ addr will be used as a destination address for future Email SEND commands HEOA Default Empty No addressee defined Scope iChip CO110PC ESFT Result code VOK ATHTOA Report the current value of the Email addressee If the addressee does not exist an empty line containing only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 42 Nonvolatile Parameter Database 19 5 33 iTO Email To Description Name Syntax AT iTO to Parameters Command Options Default Scope Result code VOK VERROR AT iTO Permanently set Email header
87. ic 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 if a specific system is online or offline To overcome this problem iChip incorporates built in procedures designed to register its IP address on a server system each time it goes online Once registered client systems may interrogate the servers in order to verify the online status of a specific system and retrieve its currently assigned IP address The IP registration process is governed by several AT i parameters Once these parameters are configured iChip will register its IP address accordingly when it goes online as a result of an explicit AT i command AT iUP or as a result of automated Internet session establishment procedures such as a triggered Internet session or when going online as a SerialNET mode server In cases where the iChip uses a NAT gateway to the Internet it may be configured to register the NAT s IP address and a special port that is linked to the iChip in the NAT s configuration See details in the RRRL parameter description When this is the case the RRRL parameters IP and port will be used instead of the local IP and port values that iChip is assigned in both registration methods RRSV and RRWS iChip includes two IP registration methods
88. igger it into activity In this case the remote client device dials directly into iChip and hangs up after two rings When contacted iChip under SerialNET mode waits for the RING to subside and then dials into its ISP and connects to the Internet If the RRSV parameter contains a server name and port number iChip will register its IP address using the Socket registration method If the RRWS parameter contains a URL iChip will register its IP address using the Web server registration method Once connected iChip transfers all arriving data from the local device over the serial link Device responses are routed back to the initiating client Data will flow freely between the two systems until a predefined activity termination event is triggered upon which the remote connection is dropped iChip s MDSEL signal see iChip may be lowered to GND to emulate the RING event This is useful for testing and debugging purposes of the SerialNET connection procedure or as a means to cause iChip to activate the ring response procedure as a result of some TTL hardware signal 16 4 Client Devices Client devices initiate communications to a server When a client device first sends data on its serial link iChip in SerialNET mode buffers the incoming data bytes and attempts to establish a connection to a remote server After going online iChip will perform an IP registration process according to the RRSV and RRWS parameters Once the socket
89. ing the NAT s IP address to IP addr will allow reaching iChip from the Internet In SerialNET the LPRT parameter may be pre configured in the NAT to connect to the iChip device See SerialNET Server Devices Port Web_port Optional port to map iChip s Web server in order to allow surfing iChip across a NAT in association with P addr Default 0 0 0 0 No return link IP and Port defined Scope iChip CO110PC Result code VOK if JP is a legal IP address and Port is a legal IP port number VERROR Otherwise ATHRRRL Report the current return link IP and port The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 57 Nonvolatile Parameter Database 19 5 48 iHSTN iChip Host Name Syntax AT iHSTN host Permanently set the iChip s Network Host Name Parameters host Symbolic Host Name string Command Options host Empty Do not attempt to register a symbolic host name host lt NAME gt NAME will be stored as iChip s Host name NAME will be included in all IP registration method formats Default Empty No network Host name defined Scope iChip CO110PC Result code VOK If host is empty or a string VERROR Otherwise ATHHSTN Report the current Host name The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 58 Nonvolatile Parameter Database 19 5 49 iMBTB Max Bytes To Buffer Syntax AT iMBTB n Permanently set max bytes to b
90. is issued Otherwise Returns the code for the specified fixed modem baud rate The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 21 Nonvolatile Parameter Database 19 5 12 iLATI TCP IP Listen Socket to Service Remote AT 1 commands Syntax AT iLATI port Sets the Remote AT service Listen 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 65535 Command Options port 0 Remote AT i service disabled port lt portnum gt Listening port to be used by a remote system when connecting to iChip in order to send AT i commands over the Internet The Listen socket will accept one remote connect request When a remote system connects through the listen socket iChip will disable its local host serial port and spawn a new TCP IP socket ready to receive AT i commands AT i response strings will be transmitted back to the same socket When the connected socket is closed the local host serial port will be re enabled and the listen socket will be ready to accept a new connection The remote end may also issue the AT iDOWN command to force iChip to disconnect and reboot Default 0 Disabled Scope iChip CO110PC Result code VOK Upon successfully opening the remote AT i service TCP IP listen socket VERROR Otherwise ATHLATI Returns current AT i service Listen port number The reply is followed by I
91. isesds sede deed ee de ed se de es dd es eo Geo de eg dd ee deeg dd de es de eek eg se de eed 2 1 2 1 AT I COMMANDS BY CATEGORY ccccssecceccescececceeececcsseececcsseececeseececeeneess 2 1 3 AT I RESULT CODE SUMMARY esse sesse se see se se se se se se se se se ee ee ee Ge Ge Ge Ge Ge Ge 3 1 A REPORT STATUS issie See e ee sees dee Gesk de eo eg Ge de ee dee Ge No Ge eg ee ee ge Ge 4 1 4 1 IRPSREBORT STATUS SEN Ee DR siecle fe ak E isch tb chi 4 1 5 CONNECTION 2 sea ete sesse ee osse esse sede eed ede Ge doe ese edge ee eed soo ede be doe sesi edge de oe doe dd ed 5 1 5 1 IBDRA FORCES ICHIP INTO AUTO BAUD RATE MODE iese ese ee ee ee 5 1 5 2 IUP INITIATE INTERNET SESSION csccccccsseececccscececcscececcecececceeececeeneess 5 2 5 3 ITUP TRIGGERED INTERNET SESSION INITIATION cccecccceseececceseececeeeeecs 5 3 5 4 IDOWN TERMINATE INTERNET SESSION ccccsecececcseeccccescececceseececeeneess 5 5 5 5 IPING SEND A PING REQUEST TO A REMOTE SERVER esse ses esse esse ee ee 5 6 5 6 IWDR FORCE WATCHDOG RESET iese ee ee ee ee se ee ee ee ee ee ee ee ee ee ee ee ee ee 5 7 6 EMAIL SEND ievscsssccesstetscsecsieccsansccescias cuts do se sede be de Ge Gee ve ee See de Ee ge de ge Ede bedes ese ee se de ee dd ego 6 1 6 1 IEOA ACCEPT ASCII CODED LINES FOR IMMEDIATE EMAIL SEND 6 1 7 HTTP CLIENT INTERFACE sssssssssseeeee sees sees esse sees ee esse ee ee see ee ee ee ee ee ee
92. klog gt maximum of lt backlog gt concurrent connections Responds with a handle to the socket Maximum 2 listen sockets supported LSST lt hn gt Listen Socket Responds with a list of active socket handles Status accepted for listen socket identified by handle lt hn gt SST lt hn gt Single Socket Responds with the status of a single socket Status identified by handle lt hn gt Subset of RP4 Report SSND Socket Send Send a byte stream of size lt sz gt to the socket lt hn gt lt sz gt lt stream gt identified by handle lt hn gt flags auto flush socket SRCV lt hn gt lt max gt Socket Receive Receive a byte stream from the socket identified by handle lt hn gt Accept maximum lt max gt bytes If lt max gt is not specified all available bytes are retrieved GPNM lt hn gt Get Peer Name Retrieve Peer Name lt IP gt lt Port gt of a remote connection to a TCP UDP socket specified by the socket handle lt hn gt Dump all buffered data currently accumulated in a buffer socket s input buffer The socket remains open SESH lt hn gt Flush Socket s Flush immediately send accumulated data in a Outbound Data socket s outbound buffer If the flush and acknowledge flag is specified iChip will wait for the peer to acknowledge receipt of the TCP packet SCLS lt hn gt Close Socket Close a TCP UDP socket If the socket was the only open socket and the stay online flag
93. le to service additional remote connections Note sent over the LATI socket will not be recognized as an Escape Sequence 18 4 Caveats and Restrictions a When iChip is in auto baud rate detection mode after restarting with BDRF a or in response to the AT iBDRA command a remote AT 1 session cannot be established even if the LATI parameter contains a port value b 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 CO110PC AT i Programmer s Manual Version 7 6 18 1 Nonvolatile Parameter Database 19 Nonvolatile Parameter Database 19 1 Parameter Descriptions Parameter Type Range Default Scope Description XRC Byte 0 4 4 iChip 110 Extended Return code Same as ATXn DMD Byte 0 2 0 iChip 110 Modem Dial Mode ATD lt m gt m Tone 0 Pulse 1 None 2 MIS String 126 AT amp FEOV iChip 110 Modem initialization string May chars 1X4Q0 amp D2 contain several consecutive AT MIL3 r commands MTYP Byte 0 9 0 iChip 110 Modem Type Designator WTC Byte 0 255 45 iChip 110 Wait Time Constant Initialization constant for modem s S7 register Defines a timeout constant for a variety of modem activities TTO INT 0 3600
94. line when this command was issued it will close the Internet session in an orderly manner This includes closing all open sockets and disconnecting from the ISP When iChip boots up in SerialNET mode it will set the host serial channel to the fixed baud rate and serial interface parameters defined in the SNSI parameter In an iChip dial up environment the modem is polled for the RING string If the ring response server parameter RRSV contains a value iChip will wait for the RING strings to subside and connect to the Internet Once online it will establish a socket to the address in RRSV if defined The transmission contains the dynamic IP address received from the ISP and its Listen port on which iChip has an open listen socket ready to serve the remote client CO110PC AT i Programmer s Manual Version 7 6 16 4 SerialNET Operation iChip will go offline if one of the following events occurs 1 The remote peer closed the SerialNET socket 2 The IATO parameter was defined and timed out 3 The terminating string defined in the DSTR parameter was received When the optional Auto Link mode flag is specified 1Chip will immediately go online in response to the AT i SNMD command In this case if one of the terminating events occurs iChip will not go offline Rather the SerialNET socket will be closed while iChip will stay online iChip will exit SerialNET mode when one of the Escape procedures is activat
95. n 7 6 19 35 Nonvolatile Parameter Database 19 5 26 iSMA SMTP Authentication Method Syntax AT iSMA v Parameters Command Options Default Scope Result code VOK VERROR AT iSMA Permanently set SMTP authentication method vsOorl v 0 SMTP authentication will be disabled val iChip will support the AUTH LOGIN SMTP authentication method if forced by SMTP server 0 SMTP authentication disabled iChip CO110PC ESFT ifv Oorl Otherwise Report the current value of the SMTP authentication method The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 36 Nonvolatile Parameter Database 19 5 27 iSMU Define SMTP Login User Name Syntax AT iSMU user Parameters Command Options user Permanently set Authenticated SMTP login User Name user User name to be used when logging on to an SMTP server that requires authentication if SMA is set to anon zero value Empty No SMTP authentication user name defined user lt user name gt user name will be used to login to an Default Scope Result code VOK VERROR ATHSMU authenticated SMTP server Empty No user name defined iChip CO110PC ESFT If user is an empty or a legal SMTP login name Otherwise Report the current SMTP login user name If the user name does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version
96. nd a registration Email containing its IP address and local port and open a listen socket on that port The client after waking up the server connects to its ISP and starts polling the predefined mailbox for the server s registration Email Once this Email arrives the client opens a socket to the IP address and port defined in the Email The SWT SerialNET Wakeup Timeout parameter will define how long iChip will wait for this procedure to conclude before stopping Data will then flow until a predefined activity termination event is triggered upon which the remote connection is dropped 16 6 Transmit Packets Data originating in the local device is buffered packetized and transmitted to the remote system over the network Packets are formed as a result of meeting at least one of the following criteria 1 A predetermined amount of bytes have been received from the local link MCBF 2 The TCP IP connection MTU was met 3 A predetermined flush character has been received FCHR 4 A predetermined inactivity timeout event was triggered MTTF Until one of these events occurs data is buffered in iChip When an event occurs a packet is transmitted The event parameters are configured by setting AT i parameters prior to initiating SerialNET mode When a UDP connection is used data packets are atomic maintaining their original size When a TCP connection is used packets may be combined before being actually transmitted This follow
97. negotiate a PPP connection if a is received as the first character from the modem after the CONNECT line to indicate a PPP packet Otherwise iChip will revert to transparent mode communications allowing the host to conduct direct modem to modem data transfer 2 20 Add 100 to any RAR value to force iChip to activate its internal RAS even if the call was picked up by the host or the modem if a is received as the first character from the modem after the CONNECT line to indicate a PPP packet n 4 iChip CO110PC If n is within limits Otherwise Returns RAR s current value The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 48 Nonvolatile Parameter Database 19 5 39 iRAU Define RAS Login User Name Syntax AT iRAU user Parameters Command Options user Permanently set 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 Empty iChip s internal RAS is effectively disabled user lt user name gt user name will be used to establish login rights user Default Scope Result code VOK VERROR ATHRAU of a remote PPP client connection to iChip s internal RAS A user name will not be reguired to authenticate a remote PPP client connection to iChip s internal RAS Effectively unrestricting remote access Empty iChip s internal RAS is effectively
98. nnection without performing a software reset with the following exception if at the time of the detection the host was waiting for a reply from iChip or was in the process of sending binary data SSND or FSND iChip will report error code 094 as soon as it can and only then try to re establish the connection In all other cases iChip will give the host no indication of losing the carrier In the event of carrier lost iChip will close any open TCP active sockets but it will leave UDP sockets and TCP passive Listen sockets intact and update their local IP if a new IP is assigned after CO110PC AT i Programmer s Manual Version 7 6 5 3 Connection establishing a new PPP connection iChip will NOT close any open Internet sessions FTP sessions for example nor release the handle of the active TCP sockets giving the host a chance to read the session errors and get buffered incoming data from active TCP sockets 3 When the PER is larger than 0 and the PDSn parameters are configured iChip will verify that it is online by sending PING messages to the PING destination servers defined in PDSn at a polling frequency defined by PER If both PING destination servers do not respond iChip will conclude that the Internet connection has failed and will try to reestablish an Internet connection as described above for the case of a lost carrier signal Result code VOK if n is within limits Or VERROR Otherwise CO110PC AT i Programmer
99. nts of From description field from Empty string from lt from string gt The From description field in the Email header will contain from string Default Empty Scope iChip CO110PC ESFT Result code VOK If from is an empty or legal string VERROR Otherwise ATHERM Report the current contents of the from parameter If the from parameter is empty only lt CRLF gt will be returned The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 45 Nonvolatile Parameter Database 19 5 36 iCCn Define Alternate Addressee lt n gt Syntax AT iCCn Email Permanently set alternative addressee Parameters n 1 4 Email Email addressee This is the Email address which will be used to copy Email messages sent by iChip to the primary addressee list Command Options Email Empty address Alternate addressee n not defined Email lt addr gt _ addr will be used as alternate Email addressee n Default Empty No alternate addressees defined Scope iChip CO110PC ESFT Result code VOK AT iCCn Report the current value of alternate addressee n If the alternate addressee does not exist only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 46 Nonvolatile Parameter Database 19 5 37 iURL Default URL Address Syntax AT iURL URLadd Permanently set the URL address string used for downloading Web pages and files
100. o set the modem register command Parameters n 0 255 Command Options The WTC parameter defines a timeout constant for a 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 Default 45 seconds Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHWTC Report the current Wait Time Constant used The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 15 Nonvolatile Parameter Database 19 5 6 iTTO Syntax TCP Timeout ATHTTO n Parameters Command Options Default Scope Result code ATHTTO VOK VERROR Permanently set the number of seconds iChip will allot an Internet transaction to complete before returning the timeout error n 0 3600 seconds The TTO parameter defines the timeout constant for Internet transactions iChip will return with a timeout error for any TCP UDP IP transaction that didn t complete properly within n 10 Timeout measurement is defined between receipt of an AT i command and an iChip response to the host Timeout measurement begins only after establishing a PPP connection Furthermore an additional 10 15 seconds may be required to allow iChip to disconnect the modem n Q is a special case where internal timeout constants will be used 0 use iChip s factory default timeout values iChip
101. of the result messages will be used by the modem to inform the Host of the results of commands Parameters n 0 4 Command Options For a detailed description of the command options see the ATXn command in the AT command set manual for the modem in use Default 4 Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise AT HXRC Report the current Extended Result Code used when dialing the ISP The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 10 Nonvolatile Parameter Database 19 5 2 iDMD Modem Dial Mode Syntax AT iDMD n Permanently set 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 2 Command Options n 0 Use Tone dialing m T n l Use Pulse dialing m P n 2 Use modem s default dialing m Default 0 Tone Dialing Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise ATHDMD Report the current modem dial mode used when dialing the ISP The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 11 Nonvolatile Parameter Database 19 5 3 iMIS Modem Initialization String Syntax ATHiMIS str str Parameters Command Options str str lt string gt Permanently set the Modem Initialization String str Modem initialization st
102. opening the TCP socket If unspecified iChip will allocate a port from its internal pool Result code I lt sock handle gt Upon successfully opening and connecting the TCP socket to the lt host gt lt port gt a socket handle is returned The socket handle lt sock handle gt is in the range 0 9 and is used to reference the socket in all following socket commands VERROR Otherwise Note iChip uses port range 1025 2048 when assigning default local ports The host should refrain from specifying local ports in this range to ensure that Error 218 is not generated as a result of requesting local ports that overlap internal assignments CO110PC AT i Programmer s Manual Version 7 6 10 1 Direct Socket Interface 10 2 iSUDP Open a Connectionless UDP Socket Syntax AT iSUDP lt host gt lt rport gt lt lport gt Parameters Scope Command Options lt host gt lt rport gt lt lport gt Result code I lt sock handle gt VERROR Opens a UDP User Datagram Protocol socket and sets the remote system s lt host gt lt port gt address lt host gt Logical name of the target server or a host IP address Or 0 0 0 0 to open a non connected socket lt rport gt Remote port number to send to Or 0 to open a non connected socket lt lport gt Optional local UDP port to use iChip CO110PC The remote system s name may be any legal Internet server name which may be resolved
103. ory pathname iChip CO110PC ESFT Must have been obtained by a previous execution of an ATHFOPN command during the current Internet mode session Directory name A new directory will be created under the current directory as indicated by path If path includes nonexistent subdirectories some FTP servers will create them as well To acknowledge successful completion of the command If lt F_hn gt is not an open FTP Session or otherwise some error has occurred CO110PC AT i Programmer s Manual Version 7 6 9 4 File Transfer Protocol FTP 9 5 iFCWD FTP Change Working Directory Syntax AT iIFCWD lt F_hn gt lt path gt Change the current FTP working directory Parameters lt F_hn gt An open FTP Session handle lt path gt New directory path name Scope iChip CO110PC ESFT Command Options lt F_hn gt Must have been obtained by a previous execution of an AT iFOPN command during the current Internet mode session lt path gt Absolute or relative path name of the new directory The special directory signifies directory up Result code VOK After successfully changing the working directory VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 9 5 File Transfer Protocol FTP 9 6 FSZ FTP File Size Syntax AT iFSZ lt F_hn gt lt path gt Parameters Scope Command Options lt F_hn gt lt path gt Result code I lt file size gt VERROR
104. ote peer closed the SerialNET socket 570 PING destination not found 571 No reply to PING request Table 3 1 AT i Result Code Summary Note All iChip response strings are terminated with lt CR gt lt LF gt CO110PC AT i Programmer s Manual Version 7 6 3 3 Report Status 4 Report Status 4 1 iRP Report Status Syntax AT iRPi Return Appropriate Status Message Parameters i 0 1 2 4 5 7 Scope iChip CO110PC Command Options j Returns the iChip part number Returns the current firmware revision and date Returns the connection status Reserved Returns iChip socket status Returns unique serial number Reserved Returns socket buffers utilization bitmap iChip s DTRH signal pin 63 can be used to signal socket buffer status changes in hardware This signal is raised when new data in one or more sockets is available It is lowered when any socket is read i 8 Reserved Il ABWN RK OR OR SR OR II ON Default None Result code Status Message if i 0 1 2 4 5 or 7 Followed by VOK VERROR Otherwise CO110PC AT i Programmer s Manual Version 7 6 AT i Result Code Summary Status Message Format Report Format Option 0 COnnnPC ii nnn Version number ii Interface code S Serial 1 ICmmmTss_ lt firmware date gt lt firmware option gt mmm Major Version
105. ower cycled or issued the AT iBDRA command Default a Autobaud Scope iChip CO110PC Result code VOK If n is within limits iChip will continue operating in the current baud rate setting Further power ups will initialize the baud rate to the new selected value until a different AT iBDRF command is issued VERROR Otherwise AT iBDRF Returns the code for the specified fixed baud rate The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 20 Nonvolatile Parameter Database 19 5 11 Syntax iBDRM Define a Fixed Baud Rate on iChip Modem Connection AT iIBDRM n Parameters Command Options Default Scope Result code VOK VERROR ATHBDRM Set the baud rate on modem connection This parameter is saved to nonvolatile memory and activated after every power up 3 9 or a or h set baud rate to Autobaud set baud rate to 2400 set baud rate to 4800 set baud rate to 9600 set baud rate to 19200 set baud rate to 38400 set baud rate to 57600 set baud rate to 230400 S SS SSA SS Il Torn aankbwWom a auto baud The iChip lt modem connection will be set to the same baud rate as that detected on the host iChip connection iChip CO110PC If n is within limits iChip will continue operating in the current baud rate setting Further power up will initialize the baud rate to the new selected value until a different AT iBDRM command
106. r name or IP address nps will be PING ed in order to verify iChip s online status when iChip is in Always Online mode If the primary server does not respond iChip will try the secondary server if it exists When both servers do not respond to PING requests iChip will retry to establish the connection by going offline and then online again Empty No PING destination servers defined iChip CO110PC VOK Report the current value of PDSn If PDSn is empty an empty line containing only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 39 Nonvolatile Parameter Database 19 5 30 iPFR PING Destination Server Polling Frequency Syntax AT iPFR n Permanently set the time interval in seconds upon which iChip will issue a PING request to one of the PING destination servers Parameters n 0 65535 seconds Command Options Default 0 Disabled PING polling Scope iChip CO110PC Result code VOK If n is within limits VERROR Otherwise AT iPFR Report the current PING polling interval used The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 40 Nonvolatile Parameter Database 19 5 31 iSBJ Email Subject Field Syntax AT iSBJ subject Permanently set Email header Subject field Parameters subject Contents of subject field Command Options subject Empty string Subject Field in Email
107. ring Empty No modem initialization string defined 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 For example AT CGCONT IP V INTERNETY string must include the AT prefix and the modem reply is expected to include OK MIS may include several consecutive modem commands separated by a semicolon Each command must begin with AT and its modem reply must include OK iChip will send each AT command separately followed by lt CR gt and wait for the OK before proceeding Default Scope Result code VOK VERROR AT iMIS AT amp FEOV 1X4Q0 amp D2M1L3 Note This default value is shipped from the factory The AT iFD command does not restore MIS to this value iChip CO110PC If str is an empty or a legal string Otherwise Report the current modem initialization string If the modem initialization string is empty only lt CRLF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 12 Nonvolatile Parameter Database 19 5 4 iMTYP Set Type of Modem Connected to iChip Syntax AT iMTYP n Set the modem type Parameters n 0 9 Command Options n 0 Standard Hayes compatible Dial up Modem n 1 Reserved n 2 GSM Modem n 3 AMPS CM900 n 4 Falcom
108. ry _ current directory E eese AR eie a O FTP File Receive Download a file from the remote FTP server a file from fhe Download a file from the remote FTP server FTP server the file already exists it shall be overwritten FTP File Append Open a file on the remote FTP server for appending If the file does not already exists it shall be created FSND FTP File Send Send data to a file on the remote FTP server The file must have been opened for with a previous call to FSTO or FAPN FCLF FTP Close File Close the currently open file on the FTP server Any data uploaded to the file with FSND commands will be retained on the server FDEL FTP Delete File Delete a file from the remote FTP server s file system FCLS FTP Close Close the FTP link CO110PC AT i Programmer s Manual Version 7 6 2 2 AT i Command Set Command Function Parameters Description STCP lt host gt lt port gt Socket TCP Open and connect a TCP socket If the iChip is not lt lport gt online it shall be connected The responding system is assumed to be a server listening oon on the specified socket Responds with a handle to the socket SUDP Socket UDP Open connect and optionally bind a UDP socket lt host gt lt rport gt If the iChip is not online it shall be connected L lt lIport gt Responds with a handle to the socket LICP Listen Socket Open a TCP listen socket on lt port gt Allow a lt port gt lt bac
109. s iChip restricts its operation mode to the minimum implementation to assure best intersystem compatibility Character Types ASCII Non print Structure File Mode Stream 17 4 FTP Command Socket The FTP command socket is normally on port 21 decimal of an FTP server However other ports may be specified to support special cases CO110PC AT i Programmer s Manual Version 7 6 17 1 FTP Theory of Operation 17 5 FTP Receive Flow Issue AT iFRCV Command VERROR PERD Return VERROR YES ERRUR Return I ERROR YES lt sz gt YES equals 0 O FTP Data Available FTP Data Available Accumulate Quiet Time Quiet VONLINE or VERROR Retrieve FTP Data Reset Quiet Time Next chars VERROR Retrieve FTP Data Reset Ouiet Time NO Return VERROR lt sz gt equals 0 YES Wait For VONLINE Return VONLINE or VERROR Figure 17 1 FTP Receive Flowchart CO110PC AT i Programmer s Manual Version 7 6 17 2 Remote AT i Service 18 Remote AT i Service 18 1 Introduction The LATI parameter allows configuring iChip to maintain a communication channel which 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 non zero value iChip will open a TCP listen socket on port lt LATI gt after the PPP connection is established This listen socket may be us
110. s 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 may be governed locally using hardware flow control only CO110PC AT i Programmer s Manual Version 7 6 16 3 SerialNET Operation 16 7 Completing a SerialNET Session A SerialNET session is complete when one of the following occurs 1 The local device transmitted the disconnection string as defined in the DSTR parameter 2 Following an inactivity timeout as defined in the IATO parameter iChip will go offline when the SerialNET session is terminated 16 8 SerialNET Failed Connection If iChip fails to establish a SerialNET connection SerialNET mode will be deactivated for a delay period defined in the SNRD parameter 16 9 Local Serial Port Configuration Prior to entering SerialNET mode iChip s local serial port may be configured to comply with a wide range of devices by assigning a value to the SNSI parameter Serial port configuration entails settings to Baud rate 2400 4800 9600 19200 38400 56K or 115K bits per second Bits byte 7 or 8 Parity None Even or Odd Stop Bit lor2 Flow Control None 0 or Hardware 1 16 10 Activation Command iChip shall be forced into SerialNET mode by issuing the following command AT iJ SNMD If the minimal SerialNET parameters are defined iChip will reply with I OK followed by I DONE If iChip was on
111. sten socket Result code I lt sockstat gt Where lt sockstat gt 000 Socket is connected and with no associated errors lt 0 Socket Error code VERROR If some error occurred CO110PC AT i Programmer s Manual Version 7 6 10 6 Direct Socket Interface 10 7 iSSND Syntax Send a Byte Stream to a Socket ATHiSSND lt hn gt lt sz gt lt stream gt Parameters Scope Command Options lt hn gt lt sz gt lt stream gt oo flag Result code VOK VERROR Send a byte stream of size lt sz gt to the socket specified by the socket handle lt hn gt lt hn gt A TCP UDP socket handle of an open socket lt sz gt The exact size of the byte stream that follows lt stream gt a byte stream of size lt sz gt to be sent to the specified socket iChip CO110PC 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 listen socket 0 4GB An 8 bit byte stream of exactly size lt sz gt If lt sz gt 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 mode the Host processor must respond to iChip s flow control characters The flow control protocol is detailed in the Host 2 iChip Software Flow Control section later in this document Under
112. support editing of command lines using the backspace character Backspace characters are treated as data characters without further processing If a syntax error is found anywhere in a command line the remainder of the line will be ignored and the I ERROR result code will be returned Commands will only be accepted by iChip once the previous command has been fully executed which is normally indicated by the return of an appropriate result code 13 Escape Code Sequence While iChip is in Internet mode attending to the Internet communications it is possible to break into the data communications and abort the Internet mode in an orderly manner This is achieved by sending iChip a sequence of three ASCII characters after a half second silence period In response to this iChip will shut down the Internet communications terminate data transmission to the host and respond with an ERROR 056 message and return to command mode A maximum delay of 10mSec CO110PC AT i Programmer s Manual Version 7 6 1 1 AT i Command Set may still exist from the time the escape sequence was transmitted until iChip cuts off the transmission to the host 14 Auto Baud Rate Detection iChip supports auto baud rate detection on the host serial communications line After power up iChip will go in to auto baud mode when the BDRF parameter contains a The AT iBDRA command forces iChip into auto baud mode while it is alr
113. t session and go offline PING PING a remote system Send PING message and wait for its echo response PING Send PING message and wait for its echo response and wait for its echo response WDR RESET iChip This command forces a H W Reset to iChip by utilizing the internal watchdog circuitry or lt par gt value CO110PC AT i Programmer s Manual Version 7 6 2 1 AT i Command Set Parameters Description JEOA lt text gt Send textual Defines the textual contents of the Email body Email immediate Following this command several text lines may be sent in sequence Sending a CR CR line containing only a period terminates the text body JRLNK lt URL gt Retrieve Link Retrieve a file from a URL on a Web server If lt URL gt is not specified use the URL stored in the URL parameter EN EE Activate the iChip s dedicated Serial to Network aa EE mode SerialNET mode FOPN Open FTP Link Open an FTP command socket to a remote FTP server If the iChip is not online it shall be connected Once an FTP link is established it may be used to carry out operations on the server s file system FTP Directory Retrieve the remote FTP server s file directory Listing listing The full server dependant listing is returned Retrieve the remote FTP server s file directory name list listing Only file names are returned FMKD FTP Make Creates a directory on the remote FTP server Directory Directo
114. tabase 19 5 46 iRRWS Ring Response Web Server Syntax AT iIRRWS url Parameters Command Options url Permanently set the IP registration Web server URL url The Web Server URL to use for registration after going online Empty No IP registration URL defined url lt Reg_URL gt Default Scope Result code VOK VERROR ATHRRWS Reg URL will be used to dynamically register iChip s IP and Port after going online See Web Server IP Registration Empty No Registration Web server defined iChip CO110PC if Reg URL is an empty or legal URL string Otherwise Report the current IP registration Web server URL If a URL does not exist only lt CR LF gt will be returned The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 56 Nonvolatile Parameter Database 19 5 47 iRRRL Ring Response Return Link Syntax AT iIRRRL P Port Permanently set 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 listen port See Description of RRRL when registering IP Command Options IP 0 0 0 0 Empty No Return Link defined IP lt IP_add gt IP_addr will be used when registering after establishing an Internet session rather than the iChip s actual local IP address This is useful when iChip receives an internal IP address behind a NAT Assign
115. the first failure encountered If all registrations fail iChip will return VERROR 90 CO110PC AT i Programmer s Manual Version 7 6 12 2 Flow Control 13 Flow Control 13 1 Host gt iChip Software Flow Control When issuing an AT iSSND command to transfer data to a socket an ATHEOA command to transfer an Email or an AT i1FSND 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 However the data rates at the host and Internet ends are not always balanced This happens for several reasons 1 While iChip is logging on to the Internet and establishing a connection the host proceeds to send its data stream to iChip During this time iChip receives data from the host but cannot send it out 2 When using a TCP IP socket iChip may need to retransmit packets 3 Host and modem baud rates may differ The amount of buffer space available in iChip to accommodate for this imbalance is limited Therefore a flow control scheme is required to regulate hostiChip communications The FLW iChip parameter is set to reflect the preferred flow control mode The software driven flow control protocol is defined as follows 1 While the host is transferring the binary stream following the HSSND iEOA or FSND prefixes iChip will issue a WAIT control char
116. tion mode Upon receiving a H W signal trigger Modem RING or MDSEL signal pulled low establish a PPP Internet connection and carry out the IP registration process according to the relevant registration option parameters If any characters are received on the host port prior to receiving a H W signal iChip will exit this mode and function normally In this case to reinstate this mode issue AT i1TUP 1 again reset iChip by issuing the AT iDOWN command or recycle power Always online Whenever iChip is offline it will automatically attempt to establish a PPP Internet connection and possibly carry out the IP registration process according to the relevant registration option parameters iChip will disregard this mode and remain offline if 1 The MDSEL signal was pulled low during power up 2 The host had issued the Escape sequence Power must be recycled or the AT iDOWN command issued for this command to take effect If iChip is in auto baud rate mode BDRF a iChip will wait for the a character on the host serial port to resolve the baud rate after rebooting before going online Therefore it is recommended to set a fixed baud rate in this case Notes 1 In this mode iChip will 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 2 When a carrier lost event is detected iChip will automatically retry to establish a co
117. uffer while 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 Scope iChip CO110PC SNET Result code VOK If n is within limits VERROR Otherwise AT iIMBTB Report the current setting of max bytes to buffer The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 59 Nonvolatile Parameter Database 19 5 50 iMTTF Max Timeout To Socket Flush Syntax AT iIMTTF n Permanently set 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 Scope iChip CO110PC SNET Result code VOK If n is within limits VERROR Otherwise ATHMTTE Report the current timeout before SerialNET socket flush in milliseconds The reply is followed by I OK CO110PC AT i Programmer s Manual Version 7 6 19 60 Nonvolatile Parameter Database 19 5 51 iFCHR Flush Character Syntax AT iFCHR flush_chr Permanently set 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
118. w control Scope iChip CO110PC SNET Result code VOK If settings_str is a valid serial link setting string VERROR Otherwise ATHSNSI Report the current serial settings string The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 64 Nonvolatile Parameter Database 19 5 55 iSTYP SerialNET Device Socket Type Syntax AT HSTYP v Permanently set SerialNET socket type to v Parameters v Oorl Command Options v 0 TCP val UDP Default 0 TCP Scope iChip CO110PC SNET Result code VOK ifv Oorl VERROR Otherwise ATHSTYP Report the current value of the SerialNET socket type The reply is followed by VOK CO110PC AT i Programmer s Manual Version 7 6 19 65 Nonvolatile Parameter Database 19 5 56 iSNRD SerialNET Device Re initialization Delay Syntax AT iSNRD n Permanently set SerialNET mode re initialization delay in seconds Parameters n number of seconds iChip will pause before re initializing 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 The SNRD delay will not be in effect as a result of an Escape Sequence Command Options n 0 3600 Default 0 No delay Scope iChip CO110PC SNET Result code VOK If n is within limits VERROR Otherwise ATHSNRD Report the current SerialNET re

AT+i Programmer`s Manual - Copeland Communications, Inc.

Contents

Download Pdf Manuals

Related Search

Related Contents