Wireless GPRS-F1/F2 Modems with IP Connectivity

Transcription

1 Wireless GPRS-F1/F2 Modems with IP Connectivity MultiModem GPRS (MTCBA-G) ModemModule GPRS (MTMMC-G) SocketModem GPRS (MTSMC-G) AT Commands and Application Examples Reference Guide

2 Copyright and Technical Support AT Commands for Wireless GPRS-F1/F2 Modems with IP Connectivity Reference Guide S000333D Products: MultiModem GPRS (MTCBA-G-F1/F2) ModemModule GPRS (MTMMC-G-F1/F2) SocketModem GPRS (MTSMC-G-F1/F2) Copyright This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi-Tech Systems, Inc. All rights reserved. Copyright , by Multi-Tech Systems, Inc. Multi-Tech Systems, Inc. makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Furthermore, Multi-Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi-Tech Systems, Inc. to notify any person or organization of such revisions or changes. Trademarks MultiModem, SocketModem, and the Multi-Tech logo are registered trademarks of Multi-Tech Systems, Inc. ModemModule is a trademark of Multi-Tech Systems, Inc. World Headquarters Multi-Tech Systems, Inc Woodale Drive Mounds View, Minnesota Phone: or Fax: Internet Address: Technical Support Country By By Phone France: support@multitech.fr +(33) Europe, Asia, Africa: support@multitech.co.uk +(44) U.S., Canada, all others: support@multitech.com or Revision History Revision Level Date Description A 03/18/04 Initial release. For use with Wavecom IP stack 2.00, firmware version 640b. B 05/20/05 For use with Wavecom IP stack 2.10, firmware version 641c. Chapters added for UDP and PIG. Added AT#RECiADD parameter. Updated text for AT#SMTPU and AT#SMTPPW. Added Error Codes (GPRS session lost) and (IP Connectivity library: Service is running. Unable to set parameter). The phrase IP Connectivity Library replaces SmartStack in the Error Codes. Added the command to erase the flash memory. C 01/20/06 For use with Wavecom IP stack 3.02, firmware version 651_. Added How to Open TCP/IP Stack to Chapter 1. To CALLSCREEUM value Decimal Phone umber, added: Alphanumeric ASCII text string up to 64 characters. Removed Value 0 from PPPMODE. Added Response Syntax to DISPLAIP. Added Syntax section to SEDERADDR. Added new FTP command: FTPMODE. Added FTPMODE and FTPTPE parameters to FTPGET, FTPPUT, VFTP. ew feature in TCP Socket Services is the addition of one more sockets. All TCP commands now include a socket id {1,2}. It affects the TCP Set and Get Syntax. Also, it affects the syntax of: LTCPSTART, LTCPSTOP, OTCP, and VTCP. Added new TCP command: TCPTXDELA. Added a new syntax example row in the table for OUDP. Added UDPSERV to the possible responses for VUDP. Updated the example table for all commands (VALL) with all the changes above. Added the TCP socket id in the Appendix A examples. D 05/17/07 Updated the Technical Support contact list and title page. Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 2

3 Table of Contents Contents Chapter 1 - Introduction...6 Definitions and Abbreviations...6 Presentation Rules...6 Open TCP/IP Stack...6 Chapter 2 Dialing Services...7 Parameter Definitions...7 #ASWERMODE Set Answering Mode...7 #CALLBACKTIMER Set Automatic Call-Back Wait...7 #CALLSCREEUM Set Caller ID Service...7 #REDIALCOUT Set Connection Attempts Allowed...8 #REDIALDELA Set Call Retry Delay...8 #PHTIMEOUT Set Inactivity Time...8 #RIGCOUT Set umber of Rings/Automatic Operation...8 #DIAL1 Set Primary Dial-Up umber...8 #DIAL2 Set Secondary Dial-Up umber...9 #DIALSELECT Set Internet Connection umber...9 #ISPPW Set ISP Password...9 #ISPU Set ISP User ame...9 #PPPMODE Set TCP/IP Behavior...9 #PPPMIP Sets IP Address When Using PPP...10 #PPPPEERIP Sets IP Address for Remote PPP...10 #PPPSERVU Sets User ame for Remote PPP Client...10 #PPPSERVPW Sets Remote PPP Client Password...10 #APPW Sets Access Point ame Password...10 #APSERV Sets Access Point ame...11 #APU Sets Access Point User ame...11 #GPRSCID Sets PDP Context Identifier...11 #GPRSMODE Activates Switching Between GSM and GPRS...11 Incoming Call Management...12 #ACCEPT Answer Incoming Call...12 #COECTIOSTOP Stop Communication...12 #COECTIOSTART Start Communication...13 Display Parameters...15 #DISPLAIP Display IP Addresses...15 #VPPP Display PPP Parameters...15 #VGPRS Display GPRS Parameters...16 #VPH Display Physical Parameters...16 Chapter 3 SMTP/POP3 Services...17 Parameter Definitions...17 #SEDERAME Set Sender ame...17 #SEDERADDR Set Sender Address...17 #CCREC1 / CCREC2 / CCREC3 Set Additional Recipient CC...17 #DOMAI Set Domain ame of the Sender...17 #REC1, REC1ADD / REC2, REC2ADD / REC3, REC3ADD Set Address...18 #SUBJ1 / SUBJ2 / SUBJ3 Set Pre-Defined Subject Text...18 #BOD1 / BOD2 / BOD3 Set Pre-Defined Combinations...18 #POP3HEADERMODE Send/Do ot Send POP3 Header...19 #POP3PORT Set POP3 Server...19 #POP3PW Set POP3 Password...19 #POP3SERV Set POP3 Address...19 #POP3U Set POP3 User ame...19 #SMTPPORT Set SMTP Server Port...20 Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 3

4 Table of Contents #SMTPPW Set SMTP Password...20 #SMTPSERV Set SMTP Server Address...20 #SMTPU Set SMTP User ame...20 #DSSERV1 Set DS Server IP Address...20 #DSSERV2 Set Secondary DS Server...21 #GETMAIL Retrieve Host Mail...21 #SEDMAIL1 / #SEDMAIL2 / #SEDMAIL3 Send Mail...22 #PUTMAIL Send Host Mail...23 Display Parameters...24 #VMAIL1 / #VMAIL2 / #VMAIL3 Display Parameters...24 #VPOP3 Display POP3 Parameters...24 #VSMTP Display SMTP Parameters...24 #VDS Display DS Parameters...25 Chapter 4 FTP Services...26 Parameter Definitions...26 #FTPPORT Enter FTP Server Port...26 #FTPMODE Enter FTP Mode...26 #FTPTPE Specify Data Type...26 #FTPSERV Specify FTP Server Address...26 #FTPU Set FTP User ame...27 #FTPPW Set FTP Password...27 #FTPGETFILEAME Set FTP Download File ame...27 #FTPGETPATH Set FTP Path...27 #FTPPUTFILEAME Set FTP Upload File ame...27 #FTPPUTPATH...27 #FTPGET Get Data from Server...28 #FTPPUT Put Data to Server...29 #VFTP Display FTP Parameters...29 Chapter 5 - TCP Socket Services...30 Parameter Definitions...30 #DLEMODE Set DLE Mode...30 #TCPPORT Set TCP Port for Remote Peer...30 #TCPSERV Set Address of Remote TCP Server...30 #LTCPTXDELA Time Delay...31 #LTCPSTART Open Listening Mode...31 #LTCPSTOP Close Listening Mode...32 #OTCP Open TCP Connection...32 #VTCP Display TCP Parameters...33 Chapter 6 UDP Socket Services...34 Parameters Definitions...34 #UDPPORT UDP Port umber...34 #UDPSERV UDP Server...34 #UDPTXDELA UDP Data Delay...34 #LUDPSTART Open an UDP Session in Listen Mode...35 #LUDPSTOP Close a Listening Mode UDP Session...35 #OUDP Open an Active UDP Session...36 #VUDP Display UDP Parameters...36 Chapter 7 PIG Services...37 Parameters Definitions...37 #PIGDELA PIG Delay Time...37 #PIGUM umber of PIG Requests...37 #PIGREMOTE IP Address of PIG Request...37 #PIG Start PIG Request...38 #VPIG Display PIG Parameters...38 Chapter 8 Miscellaneous Commands...39 Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 4

5 Table of Contents #VVERSIO Display Software Version...39 #VSTATE Display Current Status...39 #VALL Display All Parameters...39 #DELFLASH Erase Flash Memory Parameter Values...41 Chapter 9 - Response Messages and Error Codes...42 Response Messages...42 Error Codes...42 Appendix A Getting Started Examples...44 AT+WOPE Start TCP/IP Stack...44 AT#VVERSIO Get Software Version...44 AT#PPPMODE Set Parameter Value...44 AT+CPI GSM etwork Registration...44 AT+CGREG GSPRS etwork Registration State...44 Connect to the Internet...45 Sending/Retrieving FTP: Download / Upload Files...47 TCP Socket...48 Appendix B Detailed Examples...49 Serial Communication...49 Configuring the TCP/IP Stack through the Serial Port...53 Configuring Flow Control over the Serial Port...54 Using the DS Service...54 Connecting to an Internet Service Provider (ISP) through GSM Data...55 Using the TCP/IP Stack as a PPP Server in GSM Mode...57 Automatic Call-Back to Incoming Calls...58 Automatic Answer of Incoming Calls...60 Answering an Incoming Call...62 Connecting to the Internet through GPRS...64 Retrieving Sending an Containing Data from the Serial Port...68 Sending a Pre-Defined Combination...71 Downloading an FTP File...73 Uploading an FTP File...75 Setting a TCP Port to a Listening Mode...77 Opening a TCP Socket...78 Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 5

6 Chapter 1 - Introduction Chapter 1 - Introduction This document describes the AT parameters and command set available to configure and drive the TCP/IP stack and protocols available on wireless GSM/GPRS products that support IP connectivity. TCP/IP features and protocols available: PPP GPRS ICMP DS SMTP POP3 FTP TCP socket Definitions and Abbreviations AP Access Point ame <DLE> Escape Character DS Domain ame Server <ETX> Escape Character FTP File Transfer Protocol GPRS General Packet Radio Service GSM Global System for Mobile Communication IP Internet Protocol ISP Internet Service Provider POP Post Office Protocol PPP Point-to-Point Protocol PST Public Switched Telephone etwork SMTP Simple Mail Transfer Protocol Stack Low-Level Software TCP Transmission Control Protocol Presentation Rules In the following chapters, the AT commands are presented with as much precision as possible, through three paragraphs. Description The Description paragraph provides general information about the AT command or response behavior. Values - The Values paragraph provides the parameter values for the AT commands and their corresponding responses. Syntax The Syntax paragraph describes the way to use the command, the possible response, or answers. Schemas are provided where necessary. Open TCP/IP Stack Command AT+WOPE=1 ote: Start the TCP/IP stack Responses AT+WOPE=0 The TCP/IP stack is not opened. In some instances, this may be the default setting. Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 6

7 Chapter 2 Dialing Services Chapter 2 Dialing Services Parameter Definitions #ASWERMODE Set Answering Mode The TCP/IP stack can handle incoming calls. This parameter defines how the TCP/IP stack will behave when receiving an incoming call. ote: The ASWERMODE parameter must be configured in accordance with ATS0 command, which determines and controls the product automatic answering mode. 0 Ignore. Ignores the incoming call. In this case, it is the responsibility of the host to accept/not accept the incoming call by issuing the AT#ACCEPT command. Default 0. 1 Automatic Answer. The TCP/IP stack goes off hook and accepts the incoming call. As described below, the calling number must match the one specified in the CALLSCREEUM parameter. (The RIGCOUT parameter must be > 0). 2 Static Callback. The TCP/IP stack ignores the incoming call and then automatically dials (DIAL1 or DIAL2 determined by the DIALSELECT parameter) by issuing an AT#COECTIOSTART command. As described below, the calling number must match the one specified in the CALLSCREEUM parameter. The RIGCOUT parameter must be > 0. 3 Dynamic Callback. The TCP/IP stack ignores the incoming call and then automatically dials the calling number by issuing an AT#COECTIOSTART command. For this feature, the Caller ID service is mandatory. As described below, the calling number must match the one specified in the CALLSCREEUM parameter. Ensure that the calling phone number is correctly provided by the network. Set Value: AT#ASWERMODE=<value> Get Value: AT#ASWERMODE? or AT#VPH, AT#VALL #CALLBACKTIMER Set Automatic Call-Back Wait This parameter defines the number of seconds the TCP/IP stack will wait before an automatic call-back operation occurs after receiving an incoming call. It only applies when the ASWERMODE parameter is set to an automatic call-back mode (value>1). This timer starts at the end of the ringing signal. Integer between 2 and 255 inclusive. This timer is set in seconds. Default 2. Set Value: AT#CALLBACKTIMER=<value> Get Value: AT#CALLBACKTIMER? or AT#VPH, AT#VALL #CALLSCREEUM Set Caller ID Service When receiving an incoming call, the caller identification (Caller ID) service allows the TCP/IP stack to identify the phone number of the remote caller. This information is helpful in preventing unauthorized callers to trigger actions on the TCP/IP stack. This parameter allows the user to filter the incoming calls when the ASWERMODE parameter is set to an automatic mode (value>0). This filtering doesn t apply when the ASWERMODE parameter is set to 0. In this case, it is the host s responsibility to accept or reject the incoming call. If an incoming phone number is not authorized, the TCP/IP stack will ignore it. 0 Zero. ot remote caller authorized. Default 0. * All. o filtering is applied on incoming calls. All the remote phone numbers are authorized. This value must be set when wanting to receive incoming calls while the Caller ID service is not available. Decimal Phone umber. Only the phone number configured here is authorized for incoming calls. Alphanumeric ASCII text string up to 64 characters. Set Value: AT#CALLSCREEUM=<value> Get Value: AT#CALLSCREEUM? or AT#VPH, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 7

8 Chapter 2 Dialing Services #REDIALCOUT Set Connection Attempts Allowed This parameter indicates how many unsuccessful connection attempts the TCP/IP stack software will make before terminating the connection attempt activity. Integer between 0 and 14, inclusive. Default 5. If the value is set to 0, the TCP/IP stack software will not make any call retry. Set Value: AT#REDIALCOUT=<value> Get Value: AT#REDIALCOUT? or AT#VPH, AT#VALL #REDIALDELA Set Call Retry Delay This parameter controls the delay (in seconds), if any, that will exist between each call retry. Integer between 5 and 14 inclusive. Default 5. If this parameter is configured to zero, the TCP/IP stack software will attempt another connection immediately after terminating the previous unsuccessful attempt. Set Value: AT#REDIALDELA=<value> Get Value: AT#REDIALDELA? or AT#VPH, AT#VALL #PHTIMEOUT Set Inactivity Time This parameter is used by the TCP/IP stack software in order to terminate connections to the telephone line when a long period elapses without activity. Without activity is defined as a period when no data is transferred between the Internet and the TCP/IP stack software or between the TCP/IP stack software and the attached equipment. This timer prevents the telephone line from being connected indefinitely for any reason. ote: When the inactivity timer expires, the modem ends the communication. Integer between 1 and 255 inclusive. This timer is set in minutes. Default 15. Set Value: AT#PHTIMEOUT=<value> Get Value: AT#PHTIMEOUT? or AT#VPH, AT#VALL Return Codes: TIMEOUT: The inactivity timer is reached; the modem ends the communication. #RIGCOUT Set umber of Rings/Automatic Operation This parameter defines the number of rings that will be counted before an automatic operation occurs when receiving an incoming call. It applies only when the ASWERMODE parameter is set to an automatic mode (value>0). If the ASWERMODE parameter is used (value not 0), the RIGCOUT value must also be >0. ote: The RIGCOUT parameter must be configured in accordance with the ATS0 configuration to prevent conflicting interaction with the two features. Integer between 0 and 15 inclusive. Default 0. Set Value: AT#RIGCOUT=<value> Get Value: AT#RIGCOUT? or AT#VPH, AT#VALL #DIAL1 Set Primary Dial-Up umber This parameter is the primary dial-up phone number that will connect with the local ISP. Length depends on country/region. Decimal phone numbers. o default. Set Value: AT#DIAL1=<value> Get Value: AT#DIAL1? or AT#VPH, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 8

9 Chapter 2 Dialing Services #DIAL2 Set Secondary Dial-Up umber This parameter is the secondary dial-up phone number that will connect with the local ISP. Length depends on country. Decimal phone numbers. o default. Set Value: AT#DIAL2=<value> Get Value: AT#DIAL2? or AT#VPH, AT#VALL #DIALSELECT Set Internet Connection umber The value of this command determines the number called to establish an Internet connection. It configures the TCP/IP stack software to use the primary dial-up number or the secondary dial-up number. 1 Use primary dial-up number. Default 1. 2 Use secondary dial-up number Set Value: AT#DIALSELECT=<value> Get Value: AT#DIALSELECT? or AT#VPH, AT#VALL #ISPPW Set ISP Password This parameter sets the password for the ISP account. When communication is initiated and once the physical (modem) connection has been established with the ISP, the TCP/IP stack software must provide the ISP with the password associated with the account to be used. Alpha-numeric ASCII text string up to 64 characters. o default. Set Value: AT#ISPPW=<value> Get Value: AT#ISPPW? or AT#VPPP, AT#VALL #ISPU Set ISP User ame This parameter sets the user name of the ISP account. When communication is initiated and the physical (modem) connection has been established with the ISP, the TCP/IP stack software must provide the ISP with the user name associated with the account to be used. Alpha-numeric ASCII text string up to 64 characters. o default. Set Value: AT#ISPU=<value> Get Value: AT#ISPU? or AT#VPPP, AT#VALL #PPPMODE Set TCP/IP Behavior The TCP/IP stack can manage the access layer in different ways. This parameter selects the way the TCP/IP stack must run once the physical is layer successfully established. Integer between 0 and 4 inclusive. 1 Standard PPP. The TCP/IP stack behaves as a PPP client for outgoing calls and as a PPP server for incoming calls. Default 1. 2 Reverse PPP. The TCP/IP stack behaves as a PPP server for outgoing calls and as a PPP client for incoming calls. 3 PPP client only. The TCP/IP stack always behaves as a PPP client for both outgoing and incoming calls. 4 PPP server only. The TCP/IP stack always behaves as a PPP server for both outgoing and incoming calls. 9 Specific. This case is reserved for specific behavior. Set Value: AT#PPPMODE=<value> Get Value: AT#PPPMODE? or AT#VPPP, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 9

10 Chapter 2 Dialing Services #PPPMIP Sets IP Address When Using PPP When the TCP/IP stack behaves as a PPP server (according to the PPPMODE parameter setting), it is in charge of the IP address attribution mechanism. Once the PPP authentication is successfully achieved, the remote PPP peer asks the TCP/IP stack for an IP address. Then the related PPP layer, called IPCP, suggests an IP address to the peer that has been previously stored in the TCP/IP stack parameters. If the remote accepts this address, the IP link is then established. This parameter defines the IP address to be attributed to the TCP/IP stack when the PPP Server mode is running. 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default Set Value: AT#PPPMIP=<value> Get Value: AT#PPPMIP? or AT#VPPP, AT#VALL #PPPPEERIP Sets IP Address for Remote PPP When the TCP/IP stack behaves as a PPP server (according to the PPPMODE parameter setting), it is in charge of the IP address attribution mechanism. Once the PPP authentication is successfully achieved, the remote PPP peer asks the TCP/IP stack for an IP address. Then the related PPP layer, called IPCP, suggests an IP address to the peer that has been previously stored in the TCP/IP stack parameters. If the remote accepts this address, the IP link is then established. This parameter defines the IP address to be attributed to the remote PPP peer when the PPP Server mode is running. 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default Set Value: AT#PPPPEERIP=<value> Get Value: AT#PPPPEERIP? or AT#VPPP, AT#VALL #PPPSERVU Sets User ame for Remote PPP Client When the TCP/IP stack behaves as a PPP server (according to the PPPMODE parameter), it checks the remote PPP client login/password before granting access to the server. This parameter defines the user name that must be specified by the remote PPP client. Alpha-numeric ASCII text string up to 64 characters. o default. Set Value: AT#PPPSERVU=<value> Get Value: AT#PPPSERVU? or AT#VPPP, AT#VALL #PPPSERVPW Sets Remote PPP Client Password When the TCP/IP stack behaves as a PPP server (according to the PPPMODE parameter setting), it checks the remote PPP client login/password before granting access to the server. This parameter defines the password that must be specified by the remote PPP client. Alpha-numeric ASCII text string up to 64 characters. o default. Set Value: AT#PPPSERVPW=<value> Get Value: AT#PPPSERVPW? or AT#VPPP, AT#VALL #APPW Sets Access Point ame Password #APPW is the Access Point ame password parameter coming with the APU from the GSM operator and provides GPRS access. Alphanumeric ASCII text string up to 120 characters. o default. Set Value: AT#APPW=<value> Get Value: AT#APPW? or AT#VGPRS, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 10

11 Chapter 2 Dialing Services #APSERV Sets Access Point ame #APSERV is the Access Point ame parameter coming from the GSM operator for providing GPRS access. Alphanumeric ASCII text string up to 120 characters. o default. Set Value: AT#APSERV=<value> Get Value: AT#APSERV? or AT#VGPRS, AT#VALL #APU Sets Access Point User ame #APU is the Access Point ame User ame parameter coming with the APPW from the GSM operator for providing GPRS access. Alphanumeric ASCII text string up to 120 characters. o default. Set Value: AT#APU=<value> Get Value: AT#APU? or AT#VGPRS, AT#VALL #GPRSCID Sets PDP Context Identifier #GPRSCID is the PDP context identifier which specifies a particular PDP context definition. This parameter is local and may be used in other PDP context-related commands. umeric between 1 and 4 inclusive. Default 1. Set Value: AT#GPRSCID=<value> Get Value: AT#GPRSCID? or AT#VGPRS, AT#VALL #GPRSMODE Activates Switching Between GSM and GPRS #GPRSMODE configures the activation of the software for switching between GSM and GPRS. 0 Configured for GSM use. 1 Configured for GPRS use. Default 1. Set Value: AT#GPRSMODE=<value> Get Value: AT#GPRSMODE? or AT#VGPRS, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 11

12 Chapter 2 Dialing Services Incoming Call Management #ACCEPT Answer Incoming Call Command AT#ACCEPT This command directs the TCP/IP stack to answer an incoming call. When the TCP/IP stack receives an incoming call, it sends over the serial port the RIG messages. Depending on the value of the ASWERMODE parameter, the TCP/IP stack may answer automatically or not. If ASWERMODE is set to 0, it is the host that is responsible for answering the incoming call. Once the physical layer is up, the TCP/IP stack runs the applicable protocol as specified in the PPPMODE parameter. The AT#COECTIOSTOP command ends the connection by going on hook. Read parameters: ASWERMODE IPSPW ISPU PPPMODE PPPMIP PPPPEER (if PPPMODE is set in server mode) PPPPEERIP PPPSEDPW PPPSEDU AT#ACCEPT ote: Manual acceptance of an incoming call AT#ACCEPT ote: Manual acceptance of an incoming call AT#ACCEPT ote: Manual acceptance of an incoming call Possible Responses ote: Beginning of the call setting process COECT <speed> ote: Modem speed negotiated between both sides xxx.xxx.xxx.xxx ote: IP address indication attributed to the TCP/IP stack PPP ote: The software is ready to run IP applications to send/receive data O CARRIER ote: The modem handshaking process with the remote host is interrupted or unsuccessful PPP ERROR ote: The PPP negotiation has failed (check ISPU, ISPPW, PPPMODE, and the configuration of the PPP peer) #COECTIOSTOP Stop Communication This command directs the TCP/IP stack to end a GPRS or GSM communication previously established with a START command or AT#ACCEPT. o TCP/IP parameter is used for the execution of this command. AT#COECTIOSTOP Command AT#COECTIOSTOP Possible Responses ote: Disconnect ote: Phone line is released Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 12

13 Chapter 2 Dialing Services #COECTIOSTART Start Communication This command directs the TCP/IP stack to originate an outgoing call. Upon receiving this command, the TCP/IP stack attempts to complete a connection session according to the GPRSMODE parameter, selecting the GSM or GPRS mode. In GSM mode, the TCP/IP stack will dial the number according to the Dial Option parameter (DIAL1 or DIAL2 depending on DIALSELECT). If an error occurs, the TCP/IP stack automatically re-attempts the call origination attempt, according to the REDIALCOUT parameter. Once the physical layer is up, the TCP/IP stack runs the applicable protocol as specified in the PPPMODE parameter. In GPRS mode, the TCP/IP stack will establish a GPRS session with the AP using APU, APPW, GPRSCID parameters. Once the GPRS link is up, the product is connected to the Internet. The AT#COECTIOSTOP command closes the GSM or GPRS connection by going on hook. Read Parameters for GSM Mode: DIAL1 DIAL2 DIALSELECT ISPPW ISPU REDIALCOUT REDIALDELA If PPPMODE set to 2 or 4: PPPMIP PPPPEERIP PPPSERVPW PPPSERVU For GPRS Mode: APPW APSERV APU GPRSCID AT#COECTIOSTART Command (GSM Mode) AT#COECTIOSTART Possible Responses DIALIG ote: Phone line is available ote: Request connection to GSM network ote: Dial DIAL1 or DIAL2 number depending on DIALSELECT COECT 9600 ote: Modem speed negotiated between both sides. If the TCP/IP stack is configured for modem only operation (PPPMODE parameter), there are no more return codes ote: IP address attributed to the TCP/IP stack AT#COECTIOSTART _Info_PPP ote: As soon as the TCP/IP stack software displays this message, it is ready to receive commands BUS ote: A busy signal is detected on the remote site TCP/IP stack will wait REDIALDELA seconds then dial again. The redialing will continue until success or until the number of call retries defined in parameter REDIALCOUT has been reached. Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 13

14 Chapter 2 Dialing Services GSM Mode for AT#COECTIOSTART - continued Command (GSM Mode) Possible Responses AT#COECTIOSTART O ASWER ote: There is no response from the remote site. TCP/IP stack will wait REDIALDELA seconds then dial again. The redialing will continue until success or until the number of call retries defined in parameter REDIALCOUT has been reached. AT#COECTIOSTART O CARRIER ote: The modem handshaking process with the remote host is interrupted or unsuccessful. TCP/IP stack will wait REDIALDELA seconds then dial again. The redialing will continue until success or until the number of call retries defined in parameter REDIALCOUT has been reached. AT#COECTIOSTART #CME ERROR : #CME ERROR : #CME ERROR : #CME ERROR : ote: (only one response at a time): The PPP negotiation has failed (check ISPU, ISPPW, PPPMODE) AT#COECTIOSTART #CME ERROR: ote: The product is not registered on the network AT#COECTIOSTART #CME ERROR: ote: The product is already running (host is connected ) GPRS Mode Command (GPRS Mode) AT#COECTIOSTART ote: Request connection to GPRS network Possible Responses ote: IP address attributed to the TCP/IP stack _Info_GPRSActivation ote: GPRS session established and product connected to the Internet AT#COECTIOSTART #CME ERROR: ote: All connection attempts will return this message if the GPRS session cannot be established AT#COECTIOSTART #CME ERROR: ote: The product is not registered on the network AT#COECTIOSTART #CME ERROR: ote: Aborted GPRS connection; check AP parameters Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 14

15 Chapter 2 Dialing Services Display Parameters #DISPLAIP Display IP Addresses This command allows the attached host to view the attributed IP addresses that have been attributed during the IPCP phase of the PPP negotiation. Both local and remote PPP peer IP addresses are displayed. This command should be issued only once the PPP message has been received from the TCP/IP stack. Read Parameters: PPPMIP PPPPEERIP AT#DISPLAIP Response M IP: xxx.xxx.xxx.xxx PEER IP: xxx.xxx.xxx.xxx GSM Mode GPRS Mode Command (GSM Mode) AT#DISPLAIP ote: Request for local and remote IP addresses AT#DISPLAIP ote: Request for local and remote IP addresses Command (GPRS Mode) AT#DISPLAIP ote: Request for local and remote IP addresses AT#DISPLAIP ote: Request for local and remote IP addresses Possible Responses M IP: PEER IP: ote: PPPMIP (IP address attributed to the TCP/IP stack) and PPPPEERIP (IP address attributed to the PPP peer) parameter values #CME ERROR: ote: o IP addresses have been attributed: no active connection or PPP/IPCP negotiation not yet completed Possible Responses M IP: Gateway IP: ote: PPPMIP (IP address attributed to the TCP/IP stack) and PPPPEERIP (IP address attributed to the PPP peer) parameter values #CME ERROR: ote: o IP addresses have been attributed: no active connection or PPP/IPCP negotiation not yet completed #VPPP Display PPP Parameters This command directs the TCP/IP stack to display all the AT# parameters related to the PPP layer configuration. Read Parameters: ISPPW ISPU PPPMODE PPPMIP PPPPEERIP PPPSERVU PPPSERVPW AT#VPPP Command AT#VPPP Possible Responses #ISPU: myispun #ISPPW: myisppwd: #PPPMODE: 1 #PPPMIP: #PPPPEERIP: #PPPSERVU: myname #PPPSERVPW: mypasswd Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 15

16 Chapter 2 Dialing Services #VGPRS Display GPRS Parameters This command directs the TCP/IP stack to display all the AT# parameters related to the GPRS configuration. APPW APSERV APU GPRSCID AT#VGPRS Command Possible Responses AT#VGPRS #GPRSCID: 1 #APPW: access #APSERV: a2myoperator.com #APU: a2b #VPH Display Physical Parameters This command directs the TCP/IP stack to display all the AT# parameters related to the physical layer configuration. ASWERMODE CALLBACKTIMER CALLSCREEUM DIAL1 DIAL2 DIALSELECT GPRSMODE PHTIMEOUT REDIALCOUT REDIALDELA RIGCOUT AT#VPH Command Possible Responses AT#VPH #ASWERMODE: 0 #CALLBACKTIMER: 2 #CALLSCREEUM: 0 #DIAL1: #DIAL2: #DIALSELECT: 1 #GPRSMODE: 1 #PHTIMEOUT: 15 #REDIALCOUT: 5 #REDIALDELA: 5 #RIGCOUT: 0 Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 16

17 Chapter 3 SMTP/POP3 Services Chapter 3 SMTP/POP3 Services Parameter Definitions #SEDERAME Set Sender ame The sender s literal name (different from the SEDERADDR parameter, which is the sender s address). This parameter will appear in the header of the sent by the TCP/IP stack software, in the field: From: Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for instance, machine 245 ). o default. Set Value: AT#SEDERAME=<value> Get Value: AT#SEDERAME? or AT#VSMTP, AT#VALL #SEDERADDR Set Sender Address To send s, the TCP/IP stack software must know the address of the sender. The sender is the identification of the hardware platform itself or the optional attached equipment. This address will appear in the header of the sent by the TCP/IP stack software, in the field From: Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for instance xxxxxxx@web.zyx). o default. Set Value: AT#SEDERADDR=<value> Get Value: AT#SEDERADDR? or AT#VSMTP, AT#VALL #CCREC1 / CCREC2 / CCREC3 Set Additional Recipient CC The software can send messages to an additional recipient as a "carbon copy". This parameter contains the address of the additional recipient. This address will appear in the header of the sent by the TCP/IP stack software in the field Cc: For a given value n, the CCRECn parameter is directly associated with the RECn parameter. Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for instance xxxxx@web.com). o default. Set Value: AT#CCRECi=<value> (replace i with 1, 2, or 3) Get Value: AT#CCRECi? (replace i with 1, 2, or 3) or AT#VMAILi, AT#VALL #DOMAI Set Domain ame of the Sender When sending an message, the TCP/IP stack software must provide the SMTP server with the domain name of the sender. In some cases, this domain name may be different from the domain name included in the sender's address. Alphanumeric ASCII text string up to 120 characters. o default. Set Value: AT#DOMAI=<value> Get Value: AT#DOMAI? or AT#VSMTP, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 17

18 Chapter 3 SMTP/POP3 Services #REC1, REC1ADD / REC2, REC2ADD / REC3, REC3ADD Set Address To send messages, the TCP/IP stack software must know the address of the recipient. This address will appear in the header sent by the TCP/IP stack software, in the field To: The RECi parameter can hold a maximum of 10 addresses, each address being at the most 120 characters long. RECi (i = 1, 2, or 3) Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for instance xxxxx@company.com). o default. Setting One Address / Resetting the Parameter / Getting: Set value / reset the parameter: AT#RECi="Value" (replace i with 1, 2, or 3) Get value: AT#REC? (replace i with 1, 2, or 3) or AT#VMAILi, AT#VALL Setting One to Ten Address to the RECi Parameter / Resetting the Parameter: To set 1 to 10 addresses to the RECi parameter, enter the AT#RECiADD<CR> overwriting command. Each address has to be an alphanumeric ASCii text string, in literal format (for instance, dev @web.xyz). To add another address, enter the <CRLF> pair. To end the setting, enter the following character: 1A (in ASCII code), generated in a keyboard by CTRL+Z escape sequence. ote1: This command overwrites all previously set addresses of the RECi parameter. ote2: If more than ten addresses are entered, the 11 th and subsequent addresses until the end character will be ignored. Example: AT#REC1ADD<CR> 1@domain.fr<CRLF> 2@domain.com<CRLF> <CTRL+Z> #SUBJ1 / SUBJ2 / SUBJ3 Set Pre-Defined Subject Text These parameters contain the pre-defined subject text that will be used by the TCP/IP stack to compose the header. Alphanumeric ASCII text string up to 120 characters. o default. Set Value: AT#SUBJi=<value> (replace i with 1, 2, or 3) Get Value: AT#SUBJi? (replace i with 1, 2, or 3) or AT#VMAILi, AT#VALL #BOD1 / BOD2 / BOD3 Set Pre-Defined Combinations These parameters store pre-defined message bodies. They allow the host application to send predefined combinations. The body content has to be entered after the AT#BOD1<CR> command. It has to be an alphanumeric ASCII text string up to 120 characters followed this character: 1A (in ASCII code) and generated on a keyboard by CTRL+Z. o default. Set Value: AT#BODi=<value> (replace i with 1, 2, or 3) Get Value: AT#BODi? (replace i with 1, 2, or 3) or AT#VMAILi, AT#VALL Example: AT#BOD1<CR> Text string <CTRL+Z> Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 18

19 Chapter 3 SMTP/POP3 Services #POP3HEADERMODE Send/Do ot Send POP3 Header When receiving an message, the TCP/IP stack can be configured to send or not to send the POP3 header over the serial port. The POP3 header contains the From, Cc and Subject fields. 0 The header will not be sent over the serial port while retrieving. 1 The header will be sent over the serial port while retrieving. Default. Set Value: AT#POP3HEADERMODE=<value> Get Value: AT#POP3HEADERMODE? or AT#VPOP3, AT#VALL #POP3PORT Set POP3 Server To reach the POP3 server, the TCP/IP stack software must know the port of the POP3 server used for retrieving . ote: This parameter should be changed only by your network administrator since it depends on network infrastructure configuration including firewalls, proxy or specific TCP port translation settings. 5 digits (each digit between 0 and 9 inclusive). ote that numbers above 65,535 are illegal as the port identification fields are 16 bits long in the TCP header. Default 110. Set Value: AT#POP3PORT=<value> Get Value: AT#POP3PPORT? or AT#VPOP3, AT#VALL #POP3PW Set POP3 Password Password for POP3 account. To retrieve messages sent to a specified address, the TCP/IP stack software must know the POP3 password that has been set for that account. Alphanumeric ASCII text string up to 64 characters. o default. Set Value: AT#POP3PW=<value> Get Value: AT#POP3PW? or AT#VPOP3, AT#VALL #POP3SERV Set POP3 Address To retrieve messages, the TCP/IP stack software must know the address of the POP3 server that is to be used. The POP3 server must be the one where the specified account is hosted (which is not necessarily maintained by the local ISP). 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx) or Alphanumeric ASCII text string up to 120 characters if DS is available. o default. Set Value: AT#POP3SERV=<value> Get Value: AT#POP3SERV? or AT#VPOP3, AT#VALL #POP3U Set POP3 User ame User name for POP3 account. To retrieve messages sent to a specified address, the TCP/IP stack software must know the POP3 user name that has been set for that account. Alphanumeric ASCII text string up to 64 characters. o default. Set Value: AT#POP3U=<value> Get Value: AT#POP3U? or AT#VPOP3, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 19

20 Chapter 3 SMTP/POP3 Services #SMTPPORT Set SMTP Server Port To reach the SMTP server, the TCP/IP stack software must know the port of the SMTP server used for sending . ote: This parameter should be changed only by your network administrator since it depends on network infrastructure configuration including firewalls, proxy or specific TCP port translation settings. From 1 to 5 digits (each digit between 0 and 9 inclusive). ote that numbers above 65,535 are illegal as the port identification fields are 16 bits long in the TCP header. Default 25. Set Value: AT#SMTPPORT=<value> Get Value: AT#SMTPPORT? or AT#VSMTP, AT#VALL #SMTPPW Set SMTP Password To send messages, some SMTP servers are using an authentication process. In these cases, the TCP/IP stack software will provide the SMTP password (associated to the SMTP user name) for the sending process. If this parameter is an empty string, the authentication mode is inactive. If both this parameter and the SMTPU parameter are not empty, the authentication mode is active. Alphanumeric ASCII text string up to 64 characters. o default. Set Value: AT#SMTPPW=<value> Get Value: AT#SMTPPW? or AT#VSMTP, AT#VALL #SMTPSERV Set SMTP Server Address To send messages the TCP/IP stack software must know the address of the SMTP server that is to be used. In most cases, the local ISP maintains the SMTP server. 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx) or Alphanumeric ASCII text string up to 120 characters if DS is available. o default. Set Value: AT#SMTPSERV=<value> Get Value: AT#SMTPSERV? or AT#VSMTP, AT#VALL #SMTPU Set SMTP User ame To send messages, some SMTP servers use an authentication process. In these cases, the TCP/IP stack software will provide the SMTP user name (associated with a SMTP password) for the sending process. If this parameter is an empty string, the authentication mode is inactive. If both this parameter and the SMTPPW parameter are not empty, the authentication mode is active. Alphanumeric ASCII text string up to 64 characters. o default. Set Value: AT#SMTPU=<value> Get Value: AT#SMTPU? or AT#VSMTP, AT#VALL #DSSERV1 Set DS Server IP Address In order to translate the server names from literal format into IP addresses, the TCP/IP stack software implements the Domain ame System (DS) protocol. The DS Server IP address must be specified for use by the TCP/IP stack software. 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default Set Value: AT#DSSERV1=<value> Get Value: AT#DSSERV1? or AT#VDS, AT#VALL Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 20