Multi-Tech MTCBA-G-F1, MTCBA-G-F2, MTCBA-G-EN-F2, MTMMC-G-F2, MTSMC-G-F1 Reference Manual

Wireless GPRS-F1/F2 Modems

with IP Connectivity

MultiModem® GPRS (MTCBA-G)

ModemModule™ GPRS

SocketModem

®

GPRS (MTSMC-G)

(MTMMC-G)

AT Commands

and

Application Examples

Reference Guide

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 © 2003-2007, 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. F urthermore, 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.
2205 Woodale Drive
Mounds View, Minnesota 55112
Phone: [phone] or 800-328-9717
Fax: [phone]
Internet Address: http://www.multitech.com

Technical Support
Country By Email By Phone

France: [e-mail] +(33) 1-64 61 09 81
Europe, Asia, Africa: [e-mail] +(44) 118 959 7774
U.S., Canada, all others: [e-mail] 800-972-2439 or 763-717-5863

Revision History
Revision Level Date Description

A 03/18/04 Initial release. For use with Wavecom IP stack 2.00, firmw are version 640b.
B 05/20/05 For use with Wavecom IP stack 2.10, firmware version 641c.

Chapters added for UDP and PING. Added AT#RECiADD parameter. Updated text for

AT#SMTPUN and AT#SMTPPW. Added Error Codes 35841 (GPRS session lost) and

37123 (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 CALLSCREENNUM value Decimal Phone Number, added: Alphanumeric ASCII text

string up to 64 characters.
Removed Value 0 from PPPMODE.
Added Response Syntax to DISPLAYIP.
Added Syntax section to SENDERADDR.
Added new FTP command: FTPMODE.
Added FTPMODE and FTPTYPE parameters to FTPGET, FTPPUT, VFTP.
New 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: TCPTXDELAY.
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

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

#ANSWERMODE Set Answering Mode.......................................................................................................................7

#CALLBACKTIMER Set Automatic Call-Back Wait .....................................................................................................7

#CALLSCREENNUM Set Caller ID Service.................................................................................................................7

#REDIALCOUNT Set Connection Attempts Allowed...................................................................................................8

#REDIALDELAY Set Call Retry Delay.........................................................................................................................8

#PHYTIMEOUT Set Inactivity Time.............................................................................................................................8

#RINGCOUNT Set Number of Rings/Automatic Operation..........................................................................................8

#DIALN1 Set Primary Dial-Up Number........................................................................................................................8

#DIALN2 Set Secondary Dial-Up Number ...................................................................................................................9

#DIALSELECT Set Internet Connection Number.........................................................................................................9

#ISPPW Set ISP Password..........................................................................................................................................9

#ISPUN Set ISP User Name........................................................................................................................................9

#PPPMODE Set TCP/IP Behavior...............................................................................................................................9

#PPPMYIP Sets IP Address When Using PPP..........................................................................................................10

#PPPPEERIP Sets IP Address for Remote PPP.......................................................................................................10

#PPPSERVUN Sets User Name for Remote PPP Client...........................................................................................10

#PPPSERVPW Sets Remote PPP Client Password..................................................................................................10

#APNPW Sets Access Point Name Password...........................................................................................................10

#APNSERV Sets Access Point Name .......................................................................................................................11

#APNUN Sets Access Point User Name ...................................................................................................................11

#GPRSCID Sets PDP Context Identifier....................................................................................................................11

#GPRSMODE Activates Switching Between GSM and GPRS..................................................................................11

Incoming Call Management..........................................................................................................................................12

#ACCEPT Answer Incoming Call...............................................................................................................................12

#CONNECTIONSTOP Stop Communication.............................................................................................................12

#CONNECTIONSTART Start Communication...........................................................................................................13

Display Parameters.......................................................................................................................................................15

#DISPLAYIP Display IP Addresses ...........................................................................................................................15

#VPPP Display PPP Parameters...............................................................................................................................15

#VGPRS Display GPRS Parameters.........................................................................................................................16

#VPHY Display Physical Parameters.........................................................................................................................16

Chapter 3 – SMTP/POP3 Email Services.........................................................................................................................17

Parameter Definitions ...................................................................................................................................................17

#SENDERNAME Set Sender Name ..........................................................................................................................17

#SENDERADDR Set Sender Address.......................................................................................................................17

#CCREC1 / CCREC2 / CCREC3 Set Additional Recipient CC..................................................................................17

#DOMAIN Set Domain Name of the Sender..............................................................................................................17

#REC1, REC1ADD / REC2, REC2ADD / REC3, REC3ADD Set Email Address.......................................................18

#SUBJ1 / SUBJ2 / SUBJ3 Set Email Pre-Defined Subject Text ................................................................................18

#BODY1 / BODY2 / BODY3 Set Pre-Defined Email Combinations ...........................................................................18

#POP3HEADERMODE Send/Do Not Send POP3 Header........................................................................................19

#POP3PORT Set POP3 Server.................................................................................................................................19

#POP3PW Set POP3 Password................................................................................................................................19

#POP3SERV Set POP3 Address............................................................................................................................... 19

#POP3UN Set POP3 User Name..............................................................................................................................19

#SMTPPORT Set SMTP Server Port.........................................................................................................................20

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 3

Table of Contents

#SMTPPW Set SMTP Password...............................................................................................................................20

#SMTPSERV Set SMTP Server Address ..................................................................................................................20

#SMTPUN Set SMTP User Name .............................................................................................................................20

#DNSSERV1 Set DNS Server IP Address.................................................................................................................20

#DNSSERV2 Set Secondary DNS Server................................................................................................................. 21

#GETMAIL Retrieve Host Mail...................................................................................................................................21

#SENDMAIL1 / #SENDMAIL2 / #SENDMAIL3 Send Mail .........................................................................................22

#PUTMAIL Send Host Mail........................................................................................................................................23

Display Parameters.......................................................................................................................................................24

#VMAIL1 / #VMAIL2 / #VMAIL3 Display Email Parameters.......................................................................................24

#VPOP3 Display POP3 Parameters..........................................................................................................................24

#VSMTP Display SMTP Parameters .........................................................................................................................24

#VDNS Display DNS Parameters..............................................................................................................................25

Chapter 4 – FTP Services.................................................................................................................................................26

Parameter Definitions ...................................................................................................................................................26

#FTPPORT Enter FTP Server Port............................................................................................................................26

#FTPMODE Enter FTP Mode....................................................................................................................................26

#FTPTYPE Specify Data Type...................................................................................................................................26

#FTPSERV Specify FTP Server Address ..................................................................................................................26

#FTPUN Set FTP User Name....................................................................................................................................27

#FTPPW Set FTP Password......................................................................................................................................27

#FTPGETFILENAME Set FTP Download File Name.................................................................................................27

#FTPGETPATH Set FTP Path...................................................................................................................................27

#FTPPUTFILENAME Set FTP Upload File Name .....................................................................................................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

#LTCPTXDELAY 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 Number..................................................................................................................................34

#UDPSERV UDP Server............................................................................................................................................34

#UDPTXDELAY 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 – PING Services...............................................................................................................................................37

Parameters Definitions .................................................................................................................................................37

#PINGDELAY PING Delay Time................................................................................................................................37

#PINGNUM Number of PING Requests ....................................................................................................................37

#PINGREMOTE IP Address of PING Request ..........................................................................................................37

#PING Start PING Request........................................................................................................................................38

#VPING Display PING Parameters............................................................................................................................38

Chapter 8 – Miscellaneous Commands...........................................................................................................................39

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 4

Table of Contents

#VVERSION 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+WOPEN Start TCP/IP Stack................................................................................................................................44

AT#VVERSION Get Software Version........................................................................................................................44

AT#PPPMODE Set Parameter Value..........................................................................................................................44

AT+CPIN GSM Network Registration .........................................................................................................................44

AT+CGREG GSPRS Network Registration State.......................................................................................................44

Connect to the Internet ................................................................................................................................................45

Sending/Retrieving Email.............................................................................................................................................46

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 DNS 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 Email............................................................................................................................................................66

Sending an Email Containing Data from the Serial Port............................................................................................68

Sending a Pre-Defined Email 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

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

• DNS

• SMTP

• POP3

• FTP

• TCP socket

Definitions and Abbreviations

APN – Access Point Name
<DLE> – Escape Character
DNS – Domain Name 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
PSTN – Public Switched Telephone Network
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 correspon ding 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 Responses

AT+WOPEN=1

Note: Start the TCP/IP stack

AT+WOPEN=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

OK

Chapter 2 – Dialing Services

Chapter 2 – Dialing Services

Parameter Definitions

#ANSWERMODE Set Answering Mode

Definition: The TCP/IP stack can handle incoming calls. This parameter defines how the TCP/IP stack will behave

when receiving an incoming call.

Note: The ANSWERMODE parameter must be configured in accordance with ATS0 command, which

determines and controls the product automatic answering mode.

Values: 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 CALLSCREENNUM parameter.
(The RINGCOUNT parameter must be > 0).

2 Static Callback. The TCP/IP stack ignores the incoming call and then automatically di als (DIALN1

or DIALN2 determined by the DIALSELECT parameter) by issuing an AT#CONNECTIONSTART
command. As described below, the calling number must match the one specified in the
CALLSCREENNUM parameter. The RINGCOUNT 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#CONNECTIONSTART command. For this feature, the Caller ID
service is mandatory. As described below, the calling number must match the one specified in the
CALLSCREENNUM parameter. Ensure that the calling phone number is correctly provided by the
network.

Syntax: Set Value: AT#ANSWERMODE=<value>

Get Value: AT#ANSWERMODE? or AT#VPHY, AT#VALL

#CALLBACKTIMER Set Automatic Call-Back Wait

Definition: 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 ANSWERMODE parameter is
set to an automatic call-back mode (value>1). This timer starts at the end of the ringing signal.

Values: Integer between 2 and 255 inclusive. This timer is set in seconds. Default 2.
Syntax: Set Value: AT#CALLBACKTIMER=<value>

Get Value: AT#CALLBACKTIMER? or AT#VPHY, AT#VALL

#CALLSCREENNUM Set Caller ID Service

Definition: When receiving an incoming call, the caller identification (Caller ID) service all ows 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 ANSWERMODE parameter is set to

an automatic mode (value>0). This filtering doesn’t apply when the ANSWERMODE 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.

Values: 0 Zero. Not remote caller authorized. Default 0.

* All. No filtering is applie d 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 Number. Only the phone number configured here is authorized for incoming calls.

Alphanumeric ASCII text string up to 64 characters.

Syntax: Set Value: AT#CALLSCREENNUM=<value>

Get Value: AT#CALLSCREENNUM? or AT#VPHY, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 7

Chapter 2 – Dialing Services

#REDIALCOUNT Set Connection Attempts Allowed

Definition: This parameter indic ates how many unsuccessful connection attempts the TCP/IP stack software will

make before terminating the connection attempt activity.

Values: Integer between 0 and 14, incl usive. Def ault 5.

If the value is set to 0, the TCP/IP stack software will not make any call retry.

Syntax: Set Value: AT#REDIALCOUNT=<value>

Get Value: AT#REDIALCOUNT? or AT#VPHY, AT#VALL

#REDIALDELAY Set Call Retry Delay

Definition: This parameter controls the delay (in seconds), if any, that will exist between each call retry.
Values: 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.

Syntax: Set Value: AT#REDIALDELAY=<value>

Get Value: AT#REDIALDELAY? or AT#VPHY, AT#VALL

#PHYTIMEOUT Set Inactivity Time

Definition: 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.

Note: When the inactivity timer expires, the modem ends the communication.
Values: Integer between 1 and 255 inclusive. This timer is set in minutes. Default 15.
Syntax: Set Value: AT#PHYTIMEOUT=<value>

Get Value: AT#PHYTIMEOUT? or AT#VPHY, AT#VALL

Return Codes: TIMEOUT: The inactivity timer is reached; the modem ends the communication.

#RINGCOUNT Set Number of Rings/Automatic Operation

Definition: 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 ANSWERMODE parameter is set to an automatic mode (value>0).
If the ANSWERMODE parameter is used (value not 0), the RINGCOUNT value must also be >0.

Note: The RINGCOUNT parameter must be configured in accordance with the ATS0 configuration to

prevent conflicting interaction with the two features.

Values: Integer between 0 and 15 inclusive. Default 0.
Syntax: Set Value: AT#RINGCOUNT=<value>

Get Value: AT#RINGCOUNT? or AT#VPHY, AT#VALL

#DIALN1 Set Primary Dial-Up Number

Definition: This parameter is the primary dial-up phone number that will connect with the local ISP. Length

depends on country/region.

Values: Decimal ph one numbers. No default.
Syntax: Set Value: AT#DIALN1=<value>

Get Value: AT#DIALN1? or AT#VPHY, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 8

Chapter 2 – Dialing Services

#DIALN2 Set Secondary Dial-Up Number

Definition: This parameter is the secon dary dial-up phone number that will connect with the local ISP. Length

depends on country.

Values: Decimal ph one numbers. No default.
Syntax: Set Value: AT#DIALN2=<value>

Get Value: AT#DIALN2? or AT#VPHY, AT#VALL

#DIALSELECT Set Internet Connection Number

Definition: The value of this command determines the n umber 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.

Values: 1 Use primary dial-up number. Default 1.

2 Use secondary dial-up number

Syntax: Set Value: AT#DIALSELECT=<value>

Get Value: AT#DIALSELECT? or AT#VPHY, AT#VALL

#ISPPW Set ISP Password

Definition: 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.

Values: Alpha-numeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#ISPPW=<value>

Get Value: AT#ISPPW? or AT#VPPP, AT#VALL

#ISPUN Set ISP User Name

Definition: 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.

Values: Alpha-numeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#ISPUN=<value>

Get Value: AT#ISPUN? or AT#VPPP, AT#VALL

#PPPMODE Set TCP/IP Behavior

Definition: 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.

Values: 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.

Syntax: 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

Chapter 2 – Dialing Services

#PPPMYIP Sets IP Address When Using PPP

Definition: 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.

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default 0.0.0.0
Syntax: Set Value: AT#PPPMYIP=<value>

Get Value: AT#PPPMYIP? or AT#VPPP, AT#VALL

#PPPPEERIP Sets IP Address for Remote PPP

Definition: 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.

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default 0.0.0.0
Syntax: Set Value: AT#PPPPEERIP=<value>

Get Value: AT#PPPPEERIP? or AT#VPPP, AT#VALL

#PPPSERVUN Sets User Name for Remote PPP Client

Definition: 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.

Values: Alpha-numeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#PPPSERVUN=<value>

Get Value: AT#PPPSERVUN? or AT#VPPP, AT#VALL

#PPPSERVPW Sets Remote PPP Client Password

Definition: 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.

Values: Alpha-numeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#PPPSERVPW=<value>

Get Value: AT#PPPSERVPW? or AT#VPPP, AT#VALL

#APNPW Sets Access Point Name Password

Definition: #APNPW is the Access Point Name pass word parameter coming with the APNUN from the GSM

operator and provides GPRS access.

Values: Alphanumeric ASCII text string up to 120 characters. No default.
Syntax: Set Value: AT#APNPW=<value>

Get Value: AT#APNPW? or AT#VGPRS, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 10

Chapter 2 – Dialing Services

#APNSERV Sets Access Point Name

Definition: #APNSERV is the Access Point Name para meter coming from the GSM operator for providin g GPRS

access.

Values: Alphanumeric ASCII text string up to 120 characters. No default.
Syntax: Set Value: AT#APNSERV=<value>

Get Value: AT#APNSERV? or AT#VGPRS, AT#VALL

#APNUN Sets Access Point User Name

Definition: #APNUN is the Access Point Name User Name parameter coming with the APNPW from the GSM

operator for providing GPRS access.

Values: Alphanumeric ASCII text string up to 120 characters. No default.
Syntax: Set Value: AT#APNUN=<value>

Get Value: AT#APNUN? or AT#VGPRS, AT#VALL

#GPRSCID Sets PDP Context Identifier

Definition: #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.

Values: Numeric between 1 and 4 inclusive. Default 1.
Syntax: Set Value: AT#GPRSCID=<value>

Get Value: AT#GPRSCID? or AT#VGPRS, AT#VALL

#GPRSMODE Activates Switching Between GSM and GPRS

Definition: #GPRSMODE configures the activation of the software for switching between GSM and GPRS.
Values: 0 Configured for GSM use.

1 Configured for GPRS use. Default 1.

Syntax: 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

Chapter 2 – Dialing Services

Incoming Call Management

#ACCEPT Answer Incoming Call

Definition: 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 “RING” messages. Depending on the value of the

ANSWERMODE parameter, the TCP/IP stack may answer automatically or not.

If ANSWERMODE 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#CONNECTIONSTOP command ends the connection by going on hook.

Values: Read parameters:

ANSWERMODE

IPSPW

ISPUN

PPPMODE

PPPMYIP

PPPPEER (if PPPMODE is set in server mode)

PPPPEERIP

PPPSENDPW

PPPSENDUN

Syntax: AT#ACCEPT

Command Possible Responses

AT#ACCEPT
Note: Manual acceptance of

an incoming call

AT#ACCEPT
Note: Manual acceptance of

an incoming call
AT#ACCEPT

Note: Manual acceptance of
an incoming call

OK
Note: Beginning of the call setting process
CONNECT <speed>
Note: Modem speed negotiated between both sides
xxx.xxx.xxx.xxx
Note: IP address indication attributed to the TCP/IP stack
PPP OK
Note: The software is ready to run IP applications to send/receive data
NO CARRIER
Note: The modem handshaking process with the remote host is interrupted or
unsuccessful

PPP ERROR
Note: The PPP negotiation has failed (check ISPUN, ISPPW, PPPMODE, and the
configuration of the PPP peer)

#CONNECTIONSTOP Stop Communication

Definition: This command directs the TCP/IP stack to end a GPRS or GSM communication previous ly established

with a START command or AT#ACCEPT.

Values: No TCP/IP parameter is used for the execution of this command.
Syntax: AT#CONNECTIONSTOP

Command Possible Responses

AT#CONNECTIONSTOP
Note: Disconnect

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 12

OK
Note: Phone line is released

Chapter 2 – Dialing Services

#CONNECTIONSTART Start Communication

Definition: This command directs the TCP/IP stack to originate an outg oing 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

(DIALN1 or DIALN2 depending on DIALSELECT). If an error occurs, the TCP/IP stack
automatically re-attempts the call origination attempt, according to the REDIALCOUNT
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 APN using APNUN,

APNPW, GPRSCID parameters. Once the GPRS link is up, the product is connected to the
Internet. The AT#CONNECTIONSTOP command closes the GSM or GPRS connection by
going on hook.

Values: Read Parameters for GSM Mode:

DIALN1
DIALN2
DIALSELECT
ISPPW
ISPUN
REDIALCOUNT
REDIALDELAY

If PPPMODE set to 2 or 4:

PPPMYIP
PPPPEERIP
PPPSERVPW
PPPSERVUN

For GPRS Mode:

APNPW
APNSERV
APNUN
GPRSCID

Syntax: AT#CONNECTIONSTART

Command (GSM Mode) Possible Responses

AT#CONNECTIONSTART

Note: Request connection to GSM
network

AT#CONNECTIONSTART BUSY

DIALING
Note: Phone line is available

2124560123
Note: Dial DIALN1 or DIALN2 number depending on
DIALSELECT

CONNECT 9600
Note: 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

213.192.200.4
Note: IP address attributed to the TCP/IP stack

OK_Info_PPP
Note: As soon as the TCP/IP stack software displays this
message, it is ready to receive commands

Note: A busy signal is detected on the remote site
TCP/IP stack will wait REDIALDELAY seconds then dial again.
The redialing will continue until success or until the number of
call retries defined in parameter REDIALCOUNT has been
reached.

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 13

GSM Mode for AT#CONNECTIONSTART - continued

Command (GSM Mode) Possible Responses

AT#CONNECTIONSTART NO ANSWER

AT#CONNECTIONSTART NO CARRIER

AT#CONNECTIONSTART #CME ERROR : 37120

AT#CONNECTIONSTART #CME ERROR: 35865
AT#CONNECTIONSTART #CME ERROR: 35840

GPRS Mode

Command (GPRS Mode) Possible Responses

AT#CONNECTIONSTART
Note: Request connection to

GPRS network
AT#CONNECTIONSTART #CME ERROR: 35866

AT#CONNECTIONSTART
AT#CONNECTIONSTART #CME ERROR: 35868

Chapter 2 – Dialing Services

Note: There is no response from the remote site.
TCP/IP stack will wait REDIALDELAY seconds then dial again.
The redialing will continue until success or until the number of
call retries defined in parameter REDIALCOUNT has been
reached.

Note: The modem handshaking process with the remote host is
interrupted or unsuccessful.
TCP/IP stack will wait REDIALDELAY seconds then dial again.
The redialing will continue until success or until the number of
call retries defined in parameter REDIALCOUNT has been
reached.

#CME ERROR : 37121
#CME ERROR : 28980
#CME ERROR : 28981

Note: (only one response at a time): The PPP negotiation has
failed (check ISPUN, ISPPW, PPPMODE)

Note: The product is not registered on the network
Note: The product is already running (host is connected )

213.192.200.4

Note: IP address attributed to the TCP/IP stack

OK_Info_GPRSActivation

Note: GPRS session established and product connected to the
Internet

Note: All connection attempts will return this message if the
GPRS session cannot be established

#CME ERROR: 35865

Note: The product is not registered on the network
Note: Aborted GPRS connection; check APN parameters

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 14

Display Parameters

#DISPLAYIP Display IP Addresses

Definition: This command allo ws 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 OK message has been received from
the TCP/IP stack.

Values: Read Parameters:

PPPMYIP

PPPPEERIP

Syntax: AT#DISPLAYIP
Response Syntax: MY IP: xxx.xxx.xxx.xxx

PEER IP: xxx.xxx.xxx.xxx

GSM Mode

GPRS Mode

Command (GSM Mode) Possible Responses

AT#DISPLAYIP

Note: Request for local and
remote IP addresses

AT#DISPLAYIP

Note: Request for local and
remote IP addresses

Command (GPRS Mode) Possible Responses

AT#DISPLAYIP

Note: Request for local and
remote IP addresses

AT#DISPLAYIP

Note: Request for local and
remote IP addresses

MY IP: 1.2.3.4
PEER IP: 1.0.3.5
OK

Note: PPPMYIP (IP address attributed to the TCP/IP stack) and
PPPPEERIP (IP address attributed to the PPP peer) parameter
values

#CME ERROR: 35867

Note: No IP addresses have been attributed: no active
connection or PPP/IPCP negotiation not yet completed

MY IP: 1.2.3.4
Gateway IP: 1.0.3.5
OK

Note: PPPMYIP (IP address attributed to the TCP/IP stack) and
PPPPEERIP (IP address attributed to the PPP peer) parameter
values

#CME ERROR: 35867

Note: No IP addresses have been attributed: no active
connection or PPP/IPCP negotiation not yet completed

Chapter 2 – Dialing Services

#VPPP Display PPP Parameters

Definition: This command directs the TCP/IP stack to display all the AT# parameters related to the PPP layer

configuration.

Values: Read Parameters:

ISPPW
ISPUN
PPPMODE
PPPMYIP
PPPPEERIP
PPPSERVUN
PPPSERVPW

Syntax: AT#VPPP

Command Possible Responses

AT#VPPP #ISPUN: “myispun”

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 15

#ISPPW: “myisppwd:
#PPPMODE: 1
#PPPMYIP: “0.0.0.0”
#PPPPEERIP: “0.0.0.0”
#PPPSERVUN: “myname”
#PPPSERVPW: “mypasswd”
OK

Chapter 2 – Dialing Services

#VGPRS Display GPRS Parameters

Definition: This command directs the TCP/IP stack to display all the AT# parameters related to the GPRS

configuration.

Values: APNPW

APNSERV
APNUN
GPRSCID

Syntax: AT#VGPRS

Command Possible Responses

AT#VGPRS #GPRSCID: 1

#APNPW: “access”
#APNSERV: “a2myoperator.com”
#APNUN: “a2b”
OK

#VPHY Display Physical Parameters

Definition: This command directs the TCP/IP stack to display all the AT# parameters related to the ph ysical l ayer

configuration.

Values: ANSWERMODE

CALLBACKTIMER
CALLSCREENNUM
DIALN1
DIALN2
DIALSELECT
GPRSMODE
PHYTIMEOUT
REDIALCOUNT
REDIALDELAY
RINGCOUNT

Syntax: AT#VPHY

Command Possible Responses

AT#VPHY #ANSWERMODE: 0

#CALLBACKTIMER: 2
#CALLSCREENNUM: “0”
#DIALN1: “”
#DIALN2: “”
#DIALSELECT: 1
#GPRSMODE: 1
#PHYTIMEOUT: 15
#REDIALCOUNT: 5
#REDIALDELAY: 5
#RINGCOUNT: 0
OK

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 16

Chapter 3 – SMTP/POP3 Email Services

Chapter 3 – SMTP/POP3 Email Services

Parameter Definitions

#SENDERNAME Set Sender Name

Definition: The sender’s literal n ame (different from the SENDERADDR parameter, which is the sender’s email

address). This parameter will appear in the header of the email sent by the TCP/IP stack software, in
the field: “From:”

Values: Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for

instance, “machine 245”). No default.

Syntax: Set Value: AT#SENDERNAME=<value>

Get Value: AT#SENDERNAME? or AT#VSMTP, AT#VALL

#SENDERADDR Set Sender Address

Definition: To send emails, the TCP/IP stack soft ware must know the email address of the sender. The “sender” is

the email identification of the hardware platform itself or the optional attached equipment. This email
address will appear in the header of the email sent by the TCP/IP stack software, in the field “From:”

Values: Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for

instance [e-mail]). No default.

Syntax: Set Value: AT#SENDERADDR=<value>

Get Value: AT#SENDERADDR? or AT#VSMTP, AT#VALL

#CCREC1 / CCREC2 / CCREC3 Set Additional Recipient CC

Definition: The software can send email messages to an additional recipient as a "carbon copy". This parameter

contains the email address of the additional recipient. This email address will app ear in the header of
the email 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.

Values: Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for

instance [e-mail]). No default.

Syntax: 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

#DOMAIN Set Domain Name of the Sender

Definition: When sending an ema il 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 email address.

Values: Alphanumeric ASCII text string up to 120 characters. No default.
Syntax: Set Value: AT#DOMAIN=<value>

Get Value: AT#DOMAIN? or AT#VSMTP, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 17

Chapter 3 – SMTP/POP3 Email Services

#REC1, REC1ADD / REC2, REC2ADD / REC3, REC3ADD Set Email Address

Definition: To send email messages, the TCP/IP stack software must know the e-mail address of the recipient.

This email address will appear in the email header sent by the TCP/IP stack software, in the field ‘To:‘

The RECi parameter can hold a maximum of 10 email addresses, each email a ddress being at the most

120 characters long.

Values: RECi (i = 1, 2, or 3)

Alphanumeric ASCII text string up to 120 characters. The address must be provided in literal format (for

instance [e-mail]). No default.

Setting One Email 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 Email Address to the RECi Parameter / Resetting the Parameter:

To set 1 to 10 email addresses to the RECi parameter, enter the AT#RECiADD<CR> overwriting
command.

Each email address has to be an alphanumeric ASCii text string, in literal format (for instance,
[e-mail]). To add another email 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.

Note1: This command overwrites all previously set email addresses of the RECi parameter.
Note2: If more than ten addresses are entered, the 11

character will be ignored.

Example: AT#REC1ADD<CR>

[e-mail]<CRLF>
[e-mail]<CRLF>
<CTRL+Z>

th

and subsequent addresses until the end

#SUBJ1 / SUBJ2 / SUBJ3 Set Email Pre-Defined Subject Text

Definition: These parameters contain the pre-defined subject text that will be used by the TCP/IP stack to compose

the email header.

Values: Alphanumeric ASCII text string up to 120 characters. No default.
Syntax: 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

#BODY1 / BODY2 / BODY3 Set Pre-Defined Email Combinations

Definition: These parameters store pre-defined message bodies. They allow the host application to send pre-

defined email combinations.

Values: The body content has to be entered after the AT#BODY1<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. No default.

Syntax: Set Value: AT#BODYi=<value> (replace i with 1, 2, or 3)

Get Value: AT#BODYi? (replace i with 1, 2, or 3) or AT#VMAILi, AT#VALL

Example: AT#BODY1<CR>

Text string
<CTRL+Z>

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 18

Chapter 3 – SMTP/POP3 Email Services

#POP3HEADERMODE Send/Do Not Send POP3 Header

Definition: When receiving an email 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.

Values: 0 The email header will not be sent over the serial port while retrieving.

1 The email header will be sent over the serial port while retrieving. Default.

Syntax: Set Value: AT#POP3HEADERMODE=<value>

Get Value: AT#POP3HEADERMODE? or AT#VPOP3, AT#VALL

#POP3PORT Set POP3 Server

Definition: To reach the POP3 server, the TCP/IP stack software must know the port of the POP3 server used for

retrieving email.

Note: This parameter should be changed only by your net work administrator since it depends on

network infrastructure configuration including firewalls, proxy or specific TCP port translation settings.

Values: 5 digits (each digit between 0 and 9 inclusive). Note that numbers above 65,535 are illegal as the port

identification fields are 16 bits long in the TCP header. Default 110.

Syntax: Set Value: AT#POP3PORT=<value>

Get Value: AT#POP3PPORT? or AT#VPOP3, AT#VALL

#POP3PW Set POP3 Password

Definition: Password for POP3 account. To retrieve email messages sent to a specified email address, the TCP/IP

stack software must know the POP3 password that has been set for that email account.

Values: Alphanumeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#POP3PW=<value>

Get Value: AT#POP3PW? or AT#VPOP3, AT#VALL

#POP3SERV Set POP3 Address

Definition: To retrieve email messages, the T CP/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 email account is hosted (which is
not necessarily maintained by the local ISP).

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx) or

Alphanumeric ASCII text string up to 120 characters if DNS is available. No default.

Syntax: Set Value: AT#POP3SERV=<value>

Get Value: AT#POP3SERV? or AT#VPOP3, AT#VALL

#POP3UN Set POP3 User Name

Definition: User name for POP3 account. To retrieve email messages sent to a specified email address, the

TCP/IP stack software must know the POP3 user name that has been set for that email account.

Values: Alphanumeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#POP3UN=<value>

Get Value: AT#POP3UN? or AT#VPOP3, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 19

Chapter 3 – SMTP/POP3 Email Services

#SMTPPORT Set SMTP Server Port

Definition: To reach the SMTP server, the TCP/IP stack software must know the port of the SMTP server used for

sending email.

Note: 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.

Values: From 1 to 5 digits (each digit between 0 and 9 inclusive). Note that numbers above 65,535 are illegal

as the port identification fields are 16 bits long in the TCP header. Default 25.

Syntax: Set Value: AT#SMTPPORT=<value>

Get Value: AT#SMTPPORT? or AT#VSMTP, AT#VALL

#SMTPPW Set SMTP Password

Definition: To send email 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
email sending process.

If this parameter is an empty string, the authentication mode is inactive.
If both this parameter and the SMTPUN parameter are not empty, the authentication mode is active.

Values: Alphanumeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#SMTPPW=<value>

Get Value: AT#SMTPPW? or AT#VSMTP, AT#VALL

#SMTPSERV Set SMTP Server Address

Definition: To send email 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.

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx) or

Alphanumeric ASCII text string up to 120 characters if DNS is available. No default.

Syntax: Set Value: AT#SMTPSERV=<value>

Get Value: AT#SMTPSERV? or AT#VSMTP, AT#VALL

#SMTPUN Set SMTP User Name

Definition: To send email 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
email 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.

Values: Alphanumeric ASCII text string up to 64 characters. No default.
Syntax: Set Value: AT#SMTPUN=<value>

Get Value: AT#SMTPUN? or AT#VSMTP, AT#VALL

#DNSSERV1 Set DNS Server IP Address

Definition: In order to translate the server names from literal format into IP addresses, the TCP/IP stack software

implements the Domain Name System (DNS) protocol. The DNS Server IP address must be specified
for use by the TCP/IP stack software.

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default 0.0.0.0
Syntax: Set Value: AT#DNSSERV1=<value>

Get Value: AT#DNSSERV1? or AT#VDNS, AT#VALL

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 20

Chapter 3 – SMTP/POP3 Email Services

#DNSSERV2 Set Secondary DNS Server

Definition: In order to translate the server names from literal format into IP addresses, the TCP/IP stack software

implements the Domain Name System (DNS) protocol. The DNS Server IP address has to be specified
for use by the TCP/IP stack software. This secondary DNS server is used in the case where the primary
DNS server does not respond to a request.

Values: 32-bit number in dotted-decimal notation (i.e., xxx.xxx.xxx.xxx). Default 0.0.0.0
Syntax: Set Value: AT#DNSSERV2=<value>

Get Value: AT#DNSSERV2? or AT#VDNS, AT#VALL

#GETMAIL Retrieve Host Mail

Definition: This command allows the attached host to di rect the TCP/IP stack to retrieve the first mail present in the

POP3 server list. Once an IP link is established, the attached host can retrieve an email message at
any time (except when the TCP/IP stack software is already in a process using TCP resources). This
command is similar to a “check email box” feature issued by a standard messaging client on a PC.

Values: Read Parameters:

POP3HEADERMODE
POP3PORT
POP3UN
POP3PW
POP3SERV

Syntax: AT#GETMAIL

Command Possible Responses

AT#GETMAIL
Note: Retrieve

mail

AT#GETMAIL OK_Info_NoMail

AT#GETMAIL #CME ERROR: 38027

AT#GETMAIL #CME ERROR: <value>

OK_Info_Mail
<mail content>

Notes: This message is issued when one email message is located in the specified

POP3 mailbox.

Depending on the POP3HEADERMODE parameter, the TCP/IP stack sends

the email header over the serial port to the attached host.

The (CR)(LF)(.)(CR)(LF) sequence finally indicates the end of the email body.

Note: There is no email to retrieve in the POP3 mailbox.

Notes: The address of the POP3 server has not been resolved by the secondary DNS

server.

TCP/IP stack is not able to reach the primary and secondary DNS servers or a

wrong POP3 server address has been filled in.

Notes: An error has occurred during the communication with the remote POP3 server.

It may also happen during the data transfer after the MAIL message. In this
case, it is preceded by a (CR)(LF)(.)(CR)(LF) sequence.

This error can be due to one of the following reasons:

- The DNS servers are not able to resolve the POP3 server address

- The POP3 server is temporarily out of service

- The authentication (POP3UN, POP3PW) is not valid
See section ‘ Response messages and error codes’.

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 21

Chapter 3 – SMTP/POP3 Email Services

#SENDMAIL1 / #SENDMAIL2 / #SENDMAIL3 Send Mail

Definition: This command sends one of the 3 pre-defined email combinations. Once an IP link is established, the

attached host can direct the TCP/IP stack to send an email message at any time (except when the
TCP/IP stack software is already in a process using TCP resources).

The header of this email is built using the REC1/2/3, CCREC1/2/3 and SUBJ1/2/3 parameters while the

body is filled in the BODY1/2/3 parameter.

This command is similar to a “send email” operation issued by a standard messaging client on a PC.

Note: #SENDMAILi is used for #SENDMAIL1, #SENDMAIL2, or #SENDMAIL3.
Values: Read Parameters:

REC1 or REC2 or REC3
CCREC1 or CCREC2 or CCREC3
SUBJ1 or SUBJ2 or SUBJ3
BODY1 or BODY2 or BODY3
SENDERADDR
SENDERNAME
DOMAIN
SMTPPORT
SMTPSERV
SMTPPW
SMTPUN

Syntax: AT#SENDMAILi

Command Possible Responses

AT#SENDMAIL1
Note: Send predefined mail #1
AT#SENDMAIL2
Note: Send predefined mail #2
AT#SENDMAIL3
Note: Send predefined mail #3
AT#SENDMAIL2

AT#SENDMAIL1 #CME ERROR: <value>

OK

Note: Mail 1 has been successfully sent

OK
Note: Mail 2 has been successfully sent
OK

Note: Mail 3 has been successfully sent

#CME ERROR: 38027

Notes: The address of the SMTP server has not been resolved by the

secondary DNS server.

TCP/IP stack is not able to reach the primary or secondary

DNS servers or a wrong SMTP server address has entered.

Notes: An error has occurred during the communication with the

remote SMTP server. It may also happen during the data
transfer (after the OK message).

This error can be due to one of the following reasons:

- The DNS servers are not able to resolve the SMTP server
address

- The SMTP server is temporarily out of service

- The authentication (SMTPUN, SMTPPW) is not valid

- An email address specified in REC1 or CCREC1 is not valid

See section ‘Response messages and error codes’.

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 22

Chapter 3 – SMTP/POP3 Email Services

#PUTMAIL Send Host Mail

Definition: This command allo ws the attached host to send an email message containing body text passed to the

TCP/IP stack over the serial port. Once an IP link is established, the attached host can send an email
message at any time (except when the TCP/IP stack software is already in a process using TCP

resources).
The header of this email is built using the REC1, CCREC1 and SUBJ1 parameters.
This command is similar to a “send email” operation issued by a standard messaging client on a PC.

Values: Read Parameters:

REC1

CCREC1

SUBJ1

SENDERADDR

SENDERNAME

DOMAIN

SMTPPORT

SMTPSERV

SMTPPW

SMTPUN

Syntax: AT#PUTMAIL

Command Possible Responses

AT#PUTMAIL
Note: You have to configure

only receiver address1, copy
address1, and subject1
before or during the session,
but content (body) of the
email is typed when the
TCP/IP session is
established. Content is not
echoed.

<content>
Note: Content is not written

when typing
<CR><LF> . <CR><LF>
Note: Termination sequence
<CR> = <Enter>, <LF> =

<Ctrl Enter>
AT#PUTMAIL #CME ERROR: 38027

AT#PUTMAIL #CME ERROR: <value>

OK_Info_WaitingForData

Notes: An SMTP session has been successfully opened with the

remote SMTP server.

Once the TCP/IP stack has displayed this message, all the

data received on the serial port is sent within the email body.

The (CR)(LF)(.)(CR)(LF) sequence sent by the attached host

indicates the TCP/IP stack the end of the email body.

OK

Note: The mail has been successfully sent.

Notes: The address of the SMTP server has not be en resolved by

the secondary DNS server.

TCP/IP stack is not able to reach the primary or secondary

DNS servers or a wrong SMTP server address has been filled
in.

Notes: An error has occurred during the communication with the

remote SMTP server. It may also happen during the data
transfer (after the OK message).

This error can be due to one of the following reasons:

- DNS servers are not able to resolve the SMTP server
address.

- SMTP server is temporarily out of service.

- Authentication (SMTPUN, SMTPPW) is not valid.

- An email address specified in REC1 or CCREC1 is not
valid.

- An inactivity period of 50 seconds on the serial port.

See section ‘Response messages and error codes’

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 23

Chapter 3 – SMTP/POP3 Email Services

Display Parameters

#VMAIL1 / #VMAIL2 / #VMAIL3 Display Email Parameters

Definition: This command directs the TCP/IP stack to display all the AT# parameters related to the email

combinations configuration.

Notes:

• The BODY1 / BODY2 / BODY3 parameter values are not displayed. Their values can be displayed

using the AT#BODY1? / AT#BODY2? / AT#BODY3? Commands.

• #VMAILi is used for #VMAIL1 or #VMAIL2 or #VMAIL3.

Values: Read Parameters:

RECi (REC1 or REC2 or REC3)
CCRECi (CCREC1 or CCREC2 or CCREC3)
SUBJi (SUBJ1 or SUBJ2 or SUBJ3)

Syntax: AT#VMAILi

Command Possible Responses

AT#VMAIL1
Note: View predefined (nb 1)

mail header elements

#VPOP3 Display POP3 Parameters

Definition: Directs the TCP/IP stack to display all the AT# parameters related to the email retriever configuration.
Values: Read Parameters:

POP3HEADERMODE
POP3PORT
POP3PW
POP3SERV
POP3UN

Syntax: AT#VPOP3

Command Possible Responses

AT#VPOP3
Note: View POP3 parameters

#REC1=
#CCREC1=
#SUBJ1=
OK

#POP3HEADERMODE: 1
#POP3PORT: 110
#POP3PW: “mypop3passwd”
#POP3SERV: “pop3server”
#POP3UN: “mypop3un”
OK

#VSMTP Display SMTP Parameters

Definition: Directs the TCP/IP stack to display all the AT# parameters related to the email sender configuration.
Values: Read Parameters:

DOMAIN
SENDERADDR
SENDERNAME
SMTPPORT
SMTPPW
SMTPSERV
SMTPUN

Syntax: AT#VSMTP

Command Possible Responses

AT#VSMTP
Note: View SMTP parameters

Multi-Tech Systems, Inc. AT Commands for Wireless Modems with IP Connectivity (S000333D) 24

#DOMAIN: “a2myoper.com”
#SENDERADDR: “[e-mail]”
#SENDERNAME: “toto”
#SMTPPORT: 25
#SMTPPW: “mysmtppw”
#SMTPSERV: “smtp.a2myoper.com”
#SMTPUN: “mysmtpun”
OK