background image

Chapter 3 – SMTP/POP3 Email Services 

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

18

 

 

#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 address 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 [email protected]). 

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, 
[email protected]). 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

th

 and subsequent addresses until the end 

character will be ignored. 

Example:

 AT#REC1ADD<CR> 

[email protected]<CRLF> 

[email protected]<CRLF> 

<CTRL+Z> 

 

 

#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> 

Содержание ModemModule GPRS

Страница 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: ...Asia Africa support multitech co uk 44 118 959 7774 U S Canada all others support multitech com 800 972 2439 or 763 717 5863 Revision History Revision Level Date Description A 03 18 04 Initial releas...

Страница 3: ...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 Switch...

Страница 4: ...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 Parame...

Страница 5: ...ernet 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 Configur...

Страница 6: ...ervice 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 Protoco...

Страница 7: ...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 TC...

Страница 8: ...ween 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...

Страница 9: ...acters 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 in...

Страница 10: ...te 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...

Страница 11: ...es 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 P...

Страница 12: ...PSENDUN Syntax AT ACCEPT Command Possible Responses AT ACCEPT Note Manual acceptance of an incoming call OK Note Beginning of the call setting process CONNECT speed Note Modem speed negotiated between...

Страница 13: ...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 PPPMO...

Страница 14: ...DIALCOUNT has been reached AT CONNECTIONSTART CME ERROR 37120 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...

Страница 15: ...eer parameter values AT DISPLAYIP Note Request for local and remote IP addresses CME ERROR 35867 Note No IP addresses have been attributed no active connection or PPP IPCP negotiation not yet complete...

Страница 16: ...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...

Страница 17: ...dress must be provided in literal format for instance xxxxxxx web zyx No default Syntax Set Value AT SENDERADDR value Get Value AT SENDERADDR or AT VSMTP AT VALL CCREC1 CCREC2 CCREC3 Set Additional Re...

Страница 18: ...dress 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 add...

Страница 19: ...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 e...

Страница 20: ...lue 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...

Страница 21: ...aging client on a PC Values Read Parameters POP3HEADERMODE POP3PORT POP3UN POP3PW POP3SERV Syntax AT GETMAIL Command Possible Responses AT GETMAIL Note Retrieve mail OK_Info_Mail mail content Notes Th...

Страница 22: ...NDERNAME DOMAIN SMTPPORT SMTPSERV SMTPPW SMTPUN Syntax AT SENDMAILi Command Possible Responses AT SENDMAIL1 Note Send predefined mail 1 OK Note Mail 1 has been successfully sent AT SENDMAIL2 Note Send...

Страница 23: ...otes 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 Th...

Страница 24: ...predefined nb 1 mail header elements REC1 CCREC1 SUBJ1 OK VPOP3 Display POP3 Parameters Definition Directs the TCP IP stack to display all the AT parameters related to the email retriever configurati...

Страница 25: ...IP Connectivity S000333D 25 VDNS Display DNS Parameters Definition Directs the TCP IP stack to display all the AT parameters related to the DNS servers configuration Values Read Parameters DNSSERV1 D...

Страница 26: ...t Value AT FTPMODE value Get Value AT FTPMODE or AT VFTP AT VALL FTPTYPE Specify Data Type Definition Before transferring files from a specified FTP server the TCP IP stack software must specify the t...

Страница 27: ...FTP Path Definition In order for the TCP IP stack software to get a file from the FTP server the TCP IP stack software must know the path of the relevant file For example it could be list Values Alpha...

Страница 28: ...as DLE DLE The attached host must then decode the FTP flow to remove these escape characters Values Read Parameters FTPGETFILENAME FTPGETPATH FTPPORT FTPSERV FTPTYPE FPTMODE FTPPW FTPUN Syntax AT FTP...

Страница 29: ...ses AT FTPPUT Note Start sending data OK_WaitingForData Note TCP IP stack is ready to send data from the serial port to the remote FTP server TCP IP stack then immediately transfers all the data sent...

Страница 30: ...Internet are sent to the host through the serial port preceded by a DLE character Default id 1 2 Syntax Set Value AT DLEMODE id value Get Value AT DLEMODE id or AT VTCP id AT VALL TCPPORT Set TCP Por...

Страница 31: ...DLEMODE parameter is set to 1 the TCP IP stack will interpret an ETX character only as a close request if a DLE character does not precede it As a consequence the attached host must send ETX characte...

Страница 32: ...DLE DLE Similarly each ETX character present in the payload data of the TCP frame will be coded by the TCP IP stack on the serial port as DLE ETX Each DLE character will be coded as DLE DLE The attach...

Страница 33: ...ion This command directs the TCP IP stack to display all the AT parameters related to the TCP socket configuration Values Read Parameters DLEMODE TCPPORT TCPSERV TCPTXDELAY id 1 2 Syntax AT VTCP id wi...

Страница 34: ...e remote must have a defined UDPSERV IP address If the UDP session is initiated in active mode use the remote IP address Note No IP filter is applied if the parameter value is 255 255 255 255 Values 3...

Страница 35: ...host is to issue an ETX character Note The TCP IP stack will only interpret an ETX character as a close request if it is not preceded by a DLE character As a consequence an ETX character must be sent...

Страница 36: ...ning of UDP socket OK_Info_WaitingForData Notes This message signals that the UDP socket has been opened All data from the attached host remote UDP peer is immediately transferred by the TCP IP stack...

Страница 37: ...NGDELAY or AT VPING AT VALL PINGNUM Number of PING Requests Definition This command sets the number of PING echo requests to issue to PINGREMOTE Values From 1 to 255 inclusive Default value is 4 Synta...

Страница 38: ...wavecom com wavecom com is alive time 900 ms wavecom com is alive time 800 ms wavecom com is alive time 900 ms wavecom com is alive time 900 ms OK Note TCP IP stack sends PINGNUM 10 requests AT PING C...

Страница 39: ...connected AT VSTATE STATE AUTHENTICATING OK Note Connection Not yet PPP negotiated PPP OK message AT VSTATE STATE CONNECTED OK Note Connected to Internet An IP address has been attributed to the TCP I...

Страница 40: ...FTPUN mylogin FTPPW mypassword FTPTYPE 1 FTPGETFILENAME FTPGETPATH FTPPUTFILENAME Testseb3 txt FTPPUTPATH POP3HEADERMODE 1 POP3PORT 110 POP3PW POP3SERV POP3UN DOMAIN a2bouygtel com SENDERADDR toto bou...

Страница 41: ...This command erases the contents of parameter flash memory Used prior to a hard reset of the modem it results in the default values being written into the parameter memory Note The current parameter v...

Страница 42: ...eved on server 3077 OK_Info_PPP PPP connection successful 3086 OK_Info_GPRSActivation GPRS connection successful Error Codes Error Codes Numeric Description 34817 Bad command Unknown command 34819 Bad...

Страница 43: ...nswer from DNS servers or the domain name resolution could not be completed by the server 38028 Distant Sender email address rejected by server 38029 Distant Recipient email address rejected by server...

Страница 44: ...sion AT VVERSION Note Check the TCP IP stack software version VERSION eDsoft W302_V01 00 67826 Mar 18 2003 18 42 19 AT PPPMODE Set Parameter Value Command Responses AT PPPMODE 1 Note Set a parameter v...

Страница 45: ...IALING 0860000000 Note The remote modem answers a call CONNECT 9600 213 30 30 30 Note Dynamic IP address attributed by the network OK_Info_PPP Note The PPP link is established AT CONNECTIONSTOP Note W...

Страница 46: ...end sequence OK_Info_WaitingForData Note The software is ready to receive incoming data not echoed At the end of date the CR LF CR LF sequence ends the email This sequence can be sent by a keyboard u...

Страница 47: ...command to data mode The host can send the data that will compose the file Data not echoed To notify the end of data the host has to send the ETX character CTRL C on the keyboard This character is ec...

Страница 48: ...in the IP address Data Note Data flow is bidirectional Data Note Data flow is bidirectional Note The socket can be closed locally by the attached host sending an ETX character CTRL C on the keyboard...

Страница 49: ...d by the software numeric or alpha numeric responses ATV parameter Note Data format is 8 data bits no parity 1 stop bit Output Viewing a parameter After typing AT Mnemonic The modem sends the followin...

Страница 50: ...ase of a positive result or if an error occurs 2 It s not possible for host to exit DATA mode Command Mode Data Mode for FTP FTP service FTP through AT FTPPUT ENTRY FLOW Enter in DATA mode The Ok_Info...

Страница 51: ...e host This data will be sent to the remote TCP peer Exit DATA mode 1 The host ends the DATA mode by sending the ETX character not preceded by DLE on the serial port 2 The modem ends the DATA mode if...

Страница 52: ...e host this message is not preceded by the ETX character Socket TCP service TCP socket through AT LTCPSTART or AT OTCP OUTPUT FLOW Enter in DATA mode The Ok_Info_WaitingForData message sent to the hos...

Страница 53: ...thout quotes after the For example AT FTPPORT 21 Note CR is a carriage return ASCII 13 character signaling the end of the command line It is possible to set parameter values while either Offline i e n...

Страница 54: ...currently offer the possibility to get this address during PPP negotiation AT DNSSERV1 Secondary DNS The IP address of the secondary backup DNS server must be stored in dotted decimal notation xxx xx...

Страница 55: ...arameters Registration on the network AT command The product has to be registered on the GSM network AT CREG 1 GSM mode Deactivate the GPRS mode to switch in the GSM mode AT GPRSMODE 0 ISP Primary Num...

Страница 56: ...PP Connection for an outgoing call AT CONNECTIONSTART CONNECT 9600 1 2 3 4 Ok_Info_Ppp CME ERROR 38980 CME ERROR 38981 CME ERROR 37120 CME ERROR 37121 CME ERROR 35865 Remote Response Network Available...

Страница 57: ...l PPP server The user must specify these values when creating the PPP client on his computer like for a standard ISP AT PPPSERVUN PPPSERVPW PPP server IP address Once the negotiation is successfully c...

Страница 58: ...LLSCREENNUM number if ANSWERMODE is set to 3 by internally issuing an AT CONNECTIONSTART command if the associated CLI Calling Line Identity matches the CALLSCREENNUM parameter AT ANSWERMODE 2 call ba...

Страница 59: ...ty S000333D 59 Automatic Call Back to Incoming Calls Continued Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM...

Страница 60: ...r need the caller line identity service from the operator and the AT CLIP 1 command sent to the software RINGCOUNT and ANSWERMODE must be configured in accordance with the ATS0 configuration for not i...

Страница 61: ...vity S000333D 61 Automatic Answer of Incoming Calls Continued Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM a...

Страница 62: ...y service from the operator and the AT CLIP 1 command sent to the software Automatic answer deactivation When the ANSWERMODE parameter is set to 0 the modem lets the attached host decide whether the i...

Страница 63: ...odems with IP Connectivity S000333D 63 Process diagram ANSWERMODE 0 N Automatic AT ACCEPT AT CONNECTIONSTART CLIP xxxxxxxx RINGCOUNT Reached Y N ANSWERMODE 1 Y N CALLSCREENNUM authorized Y CALLBACKTIM...

Страница 64: ...GprsActivation message as a response code to the attached equipment via the serial port The modem will then wait for commands from the attached equipment AT command AT CONNECTIONSTART Related Paramete...

Страница 65: ...000333D 65 Connecting to the Internet through GPRS Continued Process diagram GPRS Connection for an outgoing call AT CONNECTIONSTART CME ERROR 35865 Opening GPRS Context Network Available 1 2 3 4 Ok_I...

Страница 66: ...witch from command mode to data mode At the end of the data flow the sequence CR LF CR LF notifies the host to switch from data mode to command mode When there is no mail waiting in the POP3 account t...

Страница 67: ...OK_Info_Mail CR LF CR LF POP3 server address solved Authentication successfull POP3 server responding Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary DNS serv...

Страница 68: ...host over the serial port is not echoed Note When using this command the software will use the following parameters to compose the email header SUBJ1 for the email subject REC1 for the recipient email...

Страница 69: ...tion AT SMTPPW Domain Domain name of the sender AT DOMAIN Sender name The sender s name which appears in the email header in the field From AT SENDERNAME Sender email address Email address of the send...

Страница 70: ...ingForData OK SMTP server address solved SMTP login required SMTP server responding Authentication successfull Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary...

Страница 71: ...TIONSTART before sending this command After the sending process the modem will keep the communication established If the RECn SENDERADDR and DOMAIN parameters are empty the response from the modem to...

Страница 72: ...dress solved SMTP login required SMTP server responding Authentication successfull Y N Y N Y N Y N N Y N Resolution made on primary DNS server Resolution made on secondary DNS server CME ERROR 38027 Y...

Страница 73: ...shed this command instructs the modem to logon to the remote FTP server and then to start the download of the specified file by issuing a standard GET command AT FTPGET Data flow The modem response co...

Страница 74: ...oading an FTP File Continued Process diagram AT FTPGET CR Ok_Info_DataBegin FTP server address solved Y N Y N Authentication successfull N Y FTP server responding Y N Resolution made on primary DNS se...

Страница 75: ...er and then to start the upload of the specified file by issuing a standard PUT command AT FTPPUT Data flow The modem returns the Ok_Info_WaitingForData message for indicating to the attached host tha...

Страница 76: ...Process diagram AT FTPPUT CR Ok_Info_WaitingForData FTP server address solved Y N Y N Authentication successfull N Y FTP server responding Y N Resolution made on primary DNS server Data not echoed ETX...

Страница 77: ...ally opens the TCP session and issues an Ok_Info_WaitingForData message over the serial port Data flow Once the TCP socket has been successfully opened all the data received from this session is sent...

Страница 78: ...if ETX characters received on the serial port must be interpreted by the modem as a close command When the DLEMODE parameter is set to 0 an open TCP session can only be closed by the remote TCP server...

Отзывы: