Quectel AG35 SMTP Installation manual

AG35 SMTP
AT Commands Manual
LTE Module Series
Rev. AG35_SMTP_AT_Commands_Manual_V1.0
Date: 2017-10-13
www.quectel.com

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 1 / 30
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District, Shanghai 200233, China
Tel: [phone]
Email: [email protected]om
Or our local office. For more information, please visit:
http://www.quectel.com/support/salesupport.aspx
For technical support, or to report documentation errors, please visit:
http://www.quectel.com/support/techsupport.aspx
Or email to: [e-mail]
GENERAL NOTES
QUECTEL OFFERS THE INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS’ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL CO., LTD. TRANSMITTING, REPRODUCTION, DISSEMINATION AND EDITING OF THIS
DOCUMENT AS WELL AS UTILIZATION OF THE CONTENT ARE FORBIDDEN WITHOUT
PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS
ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL
OR DESIGN.
Copyright © Quectel Wireless Solutions Co., Ltd. 2017. All rights reserved.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 2 / 30
About the Document
History
Revision
Date
Author
Description
1.0
2017-10-13
Chris PENG/
Mandy WANG
Initial
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 3 / 30
Contents
About the Document...................................................................................................................................2
Contents.......................................................................................................................................................3
Table Index...................................................................................................................................................4
1Introduction..........................................................................................................................................5
1.1. Introduction about SSL Type...................................................................................................5
1.2. The Process of Sending Email................................................................................................5
1.3. Description of Data Mode........................................................................................................7
2Description of SMTP AT Commands.................................................................................................8
2.1. AT+QSMTPCFG Configure Parameters for SMTP Server..................................................8
2.2. AT+QSMTPDST Add or Delete Recipients........................................................................10
2.3. AT+QSMTPSUB Edit the Subject of an Email ...................................................................12
2.4. AT+QSMTPBODY Edit the Body of an Email.....................................................................13
2.5. AT+QSMTPATT Add or Delete Attachments for an Email..................................................15
2.6. AT+QSMTPCLR Clear the Content of an Email.................................................................16
2.7. AT+QSMTPPUT Send an Email.........................................................................................17
3Examples ............................................................................................................................................19
3.1. Send an Email without SSL...................................................................................................19
3.2. Send an Email with SSL........................................................................................................21
3.3. Send an Email with STARTTLS............................................................................................22
4Error Handling....................................................................................................................................24
4.1. Executing SMTPAT Command Fails....................................................................................24
4.2. PDPActivation Fails..............................................................................................................24
4.3. DNS Parse Fails....................................................................................................................24
4.4. Error Response ofAT+QSMTPPUT......................................................................................25
5Summary of Error Codes ..................................................................................................................26
6Summary of SMTP Protocol Error Codes .......................................................................................28
7Appendix A References.....................................................................................................................30
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 4 / 30
Table Index
TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 26
TABLE 2: SUMMARY OF SMTP PROTOCOL ERROR CODES...................................................................... 28
TABLE 3: RELATED DOCUMENTS.................................................................................................................. 30
TABLE 4: TERMS AND ABBREVIATIONS........................................................................................................ 30
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 5 / 30
1Introduction
AG35 provides SMTP application interface for sending emails. This document is a reference guide to all
the AT commands defined for SMTP.
1.1. Introduction about SSL Type
There are three kinds of connections between SMTP client and SMTP server:
Without SSL
SSL
STARTTLS
Some SMTP servers do not support connection without SSL, while some can support all of them.
Customers can choose one kind according to the mail service provider.
These three kinds of connections can be set by <ssltype> parameter in AT+QSMTPCFG=“ssltype”.
1. If <ssltype> is 0, it means “without SSL”. In this case, SSL function will not be used, and emails are
sent with insecure connection. The port of SMTP server depends on mail service provider, and it is
the port 25 usually.
2. If <ssltype> is 1, it means “SSL”. In this case, emails are sent with SSL/TLS encrypted SMTP. The
port of SMTP server depends on mail service provider, and it is the port 465 or 587 usually.
3. If <ssltype> is 2, it means “STARTTLS”. In this case, the normal insecure connection can be
upgraded to secure connection through STARTTLS function, for sending the mail data. The port of
SMTP server depends on mail service provider, and it is the port 25, 465 or 587 usually.
1.2. The Process of Sending Email
As AG35 supports SMTP protocol, customers can send emails easily by AG35 SMTP AT commands. The
general process is as follows:
Step 1: Configure and activate a PDP context.
1) Configure <APN>, <username>, <password> and other parameters of a PDP context by
AT+QICSGP. Please refer to Quectel_AG35_TCP(IP)_AT_Commands_Manual for details.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 6 / 30
If QoS settings need to be updated, configure them by AT+CGQMIN, AT+CGEQMIN,
AT+CGQREQ and AT+CGEQREQ commands. For more details, please refer to
Quectel_AG35_AT_Commands_Manual.
2) Activate the PDP context byAT+QIACT.
3) Configure the PDP context ID for SMTP by AT+QSMTPCFG=“contextid”,<contextID>.
Step 2: Configure SMTP server and user account.
1) Configure SSL type by AT+QSMTPCFG=“ssltype”,<ssltype>. If <ssltype> is SSL or STARTTLS,
customers should choose an SSL context by AT+QSMTPCFG=“sslctxid”,<sslctxID> and
configure the <sslctxID> by AT+QSSLCFG="ciphersuite",<sslctxID>,<ciphersuites>. For more
details about these commands, please refer to Quectel_AG35_SSL_AT_Commands_ Manual.
2) Configure SMTP server by AT+QSMTPCFG=“smtpserver”,<srvaddr>,<srvport>. <srvaddr> and
<srvport> parameters depend on the mail service provider.
3) Configure account information by AT+QSMTPCFG=“account”,<username>,<password>.
4) Configure sender information by AT+QSMTPCFG=“sender”,<sender_name>,<sender_email>.
Step 3: Edit the email content.
1) Configure the recipient email address by AT+QSMTPDST.
2) Configure the subject of email by AT+QSMTPSUB.
3) Configure the body of email by AT+QSMTPBODY.
4) Add attachments for the email by AT+QSMTPATT. The attachments can be RAM, UFS or SD
files. And the files can be uploaded to RAM, UFS or SD card by AT+QFUPL. After sending email
successfully, the file should be deleted by AT+QFDEL. For more details of these commands,
please refer to Quectel_AG35_FILE_Application_Note.
Step 4: Send email.
Send the email by AT+QSMTPPUT. It will take some time to send the email depending on the total
size of attachments and network status. When the sending action ends, “+QSMTPPUT:
<err>,<protocol_error>”will be returned.
Step 5: Clear the email content.
AT+QSMTPCLR will clear the email content configured in Step 3. The attached files should be
deleted by AT+QFDEL. For more details of these commands, please refer to
Quectel_AG35_FILE_Application_Note. Then repeat Step 3 and 4. If the SMTP server
information and user information need to be changed, then Step 2 to Step 4 should be repeated.
If emails have not been sent for a long time, such as 30 minutes or even longer, then the PDP
context should be deactivated by AT+QIDEACT=<contextID>. For more details, please refer to
Quectel_AG35_TCP(IP)_AT_Commands_Manual.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 7 / 30
1.3. Description of Data Mode
The COM port of AG35 module has two working modes: AT command mode and data mode. In AT
command mode, the inputted data via COM port will be treated asATcommand, while in data mode, it will
be treated as data.
Inputting “+++” or pulling up DTR (AT&D1 should be set first) can make the module exit from data mode.
To prevent the “+++” from being misinterpreted as data, the following sequence should be followed:
1) Do not input any character within 1s or longer before inputting “+++”.
2) Input “+++” within 1s, and no other characters can be inputted during the time.
3) Do not input any character within 1s after “+++” has been inputted.
When AT+QSMTPBODY is executed, the COM port will enter into data mode. All inputted data will be the
body of email. If the inputted data reaches the <body_length> or the time reaches <input_time>, the port
will exit from data mode automatically. If the inputted data is less than the <body_length>, customers can
finish editing body by inputting “+++” or changing DTR level from low to high before <input_time> reaches.
In such case, the COM port cannot reenter data mode by executingATO command.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 8 / 30
2Description of SMTP AT Commands
2.1. AT+QSMTPCFG Configure Parameters for SMTP Server
The command is used to configure SMTP server, user account and SSL settings. If the Write Command
only executes one parameter, it will query the current settings.
AT+QSMTPCFG Configure Parameters for SMTP Server
Test Command
AT+QSMTPCFG=?
Response
+QSMTPCFG: “account”,<username>,<password>
+QSMTPCFG: “sender”,<sender_name>,<sender_email>
+QSMTPCFG: “smtpserver”,<srvaddr>,<srvport>
+QSMTPCFG: “contextid”,(1-16)
+QSMTPCFG: “sslctxid”,(0-5)
+QSMTPCFG: “ssltype”,(0-2)
OK
Write Command
AT+QSMTPCFG=“account”[,<userna
me>,<password>]
Response
If <username> and <password> are not omitted:
OK
Or
+CME ERROR: <err>
If <username> and <password> are both omitted, query the
current settings:
+QSMTPCFG: “account”,<username>,<password>
OK
Write Command
AT+QSMTPCFG=“sender”[,<sender_
name>,<sender_email>]
Response
If <sender_name> and <sender_email> are not omitted:
OK
Or
+CME ERROR: <err>
If <sender_name> and <sender_email> are both omitted,
query the current settings:
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 9 / 30
+QSMTPCFG: “sender”,<sender_name>,<sender_email>
OK
Write Command
AT+QSMTPCFG=“smtpserver”[,<srva
ddr>,<srvport>]
Response
If <srvaddr> and <srvport> are not omitted:
OK
Or
+CME ERROR: <err>
If <srvaddr> and <srvport> are both omitted, query the current
settings:
+QSMTPCFG: “smtpserver”,<srvaddr>,<srvport>
OK
Write Command
AT+QSMTPCFG=“contextid”[,<conte
xtID>]
Response
If <contextID> is not omitted:
OK
Or
+CME ERROR: <err>
If <contextID> is omitted, query the current settings:
+QSMTPCFG: “contextid”,<contextID>
OK
Write Command
AT+QSMTPCFG=“sslctxid”[,<sslctxID
>]
Response
If <sslctxID> is not omitted:
OK
Or
+CME ERROR: <err>
If <sslctxID> is omitted, query the current settings:
+QSMTPCFG: “sslctxid”,<sslctxID>
OK
Write Command
AT+QSMTPCFG=“ssltype”[,<ssltype>
]
Response
If <ssltype> is not omitted:
OK
Or
+CME ERROR: <err>
If <ssltype> is omitted, query the current settings:
+QSMTPCFG: “ssltype”,<ssltype>
OK
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 10 / 30
Parameter
<username> String type. The user name for authentication. The maximum size of the
parameter is 50 bytes.
<password> String type. The password for authentication. The maximum size of the
parameter is 50 bytes.
<sender_email> String type. The email address of the sender. The maximum size of the parameter
is 50 bytes.
<sender_name> String type. The sender’s name that will be shown when the recipients receiving
the email. The maximum size of the parameter is 50 bytes.
<srvaddr> String type. The IP address or domain name of the SMTP server. The maximum
size of the parameter is 50 bytes.
<srvport> Integer type. The port of the SMTP server. The default value is 25. It may be
different depending on different SMTP server. For details, please query the
corresponding mail service provider.
<contextID> Integer type. The PDP context ID. The range is 1-16, and the default value is 1. It
should be activated by AT+QIACT before sending an email. For details, please
refer to Quectel_AG35_TCP(IP)_AT_Commands_Manual.
<sslctxID> Integer type. SSL context ID used for SMTP. The range is 0-5, and the default
value is 1. Customers should configure the SSL parameters by AT+QSSLCFG.
For details, please refer to Quectel_AG35_SSL_AT_Commands_Manual.
<ssltype> Integer type. Configure the SSL type. Please choose the SSL type according to
the mail service provider, since some SMTP servers do not support sending email
without SSL.
0 Without SSL
1 SSL
2 STARTTLS
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
2.2. AT+QSMTPDST Add or Delete Recipients
AT+QSMTPDST=1 can be used to add recipients. The maximum number of recipients is 20, including CC
recipients and BCC recipients. AT+QSMTPDST=0 can be used to delete all recipients.
AT+QSMTPDST Add or Delete Recipients
Test Command
AT+QSMTPDST=?
Response
+QSMTPDST: (0,1),(1-3),<emailaddr>
OK
Read Command
AT+QSMTPDST?
Response
[+QSMTPDST: <type>,<emailaddr><CR><LF>]
OK
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 11 / 30
Parameter
Example
//Add recipients.
AT+QSMTPDST=1,1,“[email protected]”//Add the recipient and the recipient type is 1
which means all recipients.
OK
AT+QSMTPDST=1,2,“[e-mail]”//Add the recipient and the recipient type is 2
which means CC recipients.
OK
AT+QSMTPDST?
+QSMTPDST: 1,“quectel[email protected]om”
+QSMTPDST: 2,“quectel[email protected]om”
OK
//Delete all recipients.
AT+QSMTPDST=0 //Delete all recipients.
OK
AT+QSMTPDST?
OK
Write Command
AT+QSMTPDST=<mode>[,<type>[,<e
mailaddr>]]
Response
If the format is correct and it is not sending an email:
OK
Or
+CME ERROR: <err>
<mode> Integer type. Add or delete recipients.
0 Delete
1 Add
<type> Integer type. The type of recipients.
1 All recipients
2 CC recipients
3 BCC recipients
<emailaddr> String type. The email address of recipients. The maximum size of the parameter
is 50 bytes.
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 12 / 30
2.3. AT+QSMTPSUB Edit the Subject of an Email
The command is used to edit the subject of an email. If <charset> is not ASCII, the inputted data should
be the hex string of the original subject.
Parameter
Example
//Add subject for an email and the <charset> is ASCII.
AT+QSMTPSUB=0,“TEST SMTP”//Edit subject and the character set is 0 which means ASCII.
OK
AT+QSMTPSUB? //Query subject of the email.
+QSMTPSUB: 0,“TEST SMTP”
OK
AT+QSMTPSUB Edit the Subject of an Email
Test Command
AT+QSMTPSUB=?
Response
+QSMTPSUB: (0-3),<subject>
OK
Read Command
AT+QSMTPSUB?
Response
+QSMTPSUB: <charset>,<subject>
OK
Write Command
AT+QSMTPSUB=<charset>,<subject>
Response
OK
Or
+CME ERROR: <err>
<charset> Integer type. The character set of the subject.
0 ASCII
1 UTF-8
2 GB2312
3 BIG5
<subject> String type. The subject of the email. If <charset> is 0, this string will be the subject of
the email. Otherwise, it is formatted as a hex string, e.g. “41” means the hex value
0x41. If the character set is ASCII, the length of <subject > is 0-100 in unit of byte. If
the character set is not ASCII, the length of <subject> should be even and the range
is 0-200 in unit of byte.
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 13 / 30
//Add subject for email and the <charset> is UTF8. “7465737420534D5450” is the hex string of “TEST
SMTP”.
AT+QSMTPSUB=1,"7465737420534D5450" //Edit subject and the character set is 1 which means
UTF8.
OK
AT+QSMTPSUB? //Query subject of the email.
+QSMTPSUB: 1,“7465737420534D5450”
OK
2.4. AT+QSMTPBODY Edit the Body of an Email
The command is used to edit the body of an email. When AT+QSMTPBODY is executed, the module will
enter into data mode. All inputted data will be the body of email. If the inputted data reaches the
<body_length> or the time reaches <input_time>, the module will exit from data mode automatically. If the
inputted data is less than the <body_length>, customers can finish editing body by inputting “+++” or
changing DTR level from low to high before <input_time> reaches. The maximum size of the email body
is 10 Kbytes. The actual body length is the inputted data length.
Parameter
<charset> Integer type. The character set of the body.
0 ASCII
AT+QSMTPBODY Edit the Body of an Email
Test Command
AT+QSMTPBODY=?
Response
+QSMTPBODY: (0-3),(1-10240),(1-65535)
OK
Read Command
AT+QSMTPBODY?
Response
OK
Write Command
AT+QSMTPBODY=<charset>,<body_l
ength>[,<input_time>]
Response
If the format is correct and it is not sending an email:
CONNECT
<Input body data>
+QSMTPBODY: <input_length>
OK
If there is any error, response:
+CME ERROR: <err>
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 14 / 30
1 UTF-8
2 GB2312
3 BIG5
<body_length> Integer type. The specific length of body. If the length of inputted data is less than the
specific value <body_length>, customers can exit from data mode by “+++”. The
actual length of the body is the inputted data length. The range is 1-10240. Unit: byte.
<input_length> The actual length of the inputted body.
<input_time> Integer type. The maximum time to upload email body from COM port. The range is
1-65535, and the default value is 90. Unit: second.
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
Example
//Edit email body and the body length is 100 bytes.
AT+QSMTPBODY=0,100,120 //Edit email body. The character set is 0 which means ASCII,
and the maximum input length is 100 bytes and the maximum
input time is 120s.
CONNECT
<Input 100 bytes data> //Input 100 bytes data.
+QSMTPBODY: 100
OK
//If the actual inputted data is less than the specified length, customers can stop editing the body by
inputting “+++”.
AT+QSMTPBODY=0,100,120 //Edit email body. The character set is 0 which means ASCII,
and the maximum input length is 100 bytes and the maximum
input time is 120s.
CONNECT
<Input 90 bytes data> //Input “+++”.
+QSMTPBODY: 90
OK
//If the actual inputted data is less than specified length and the maximum input time expires, AG35 will
end the editing of body automatically.
AT+QSMTPBODY=0,100,120 //Edit email body. The character set is 0 which means ASCII, and
the maximum input length is 100 bytes and the maximum input
time is 120s.
CONNECT
<Input 90 bytes data> //120s later.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 15 / 30
+QSMTPBODY: 90
OK
2.5. AT+QSMTPATT Add or Delete Attachments for an Email
Attachments for email can be added by AT+QSMTPATT=1. When adding an attachment, the file index
should be specified. As a result, different attachments should have different file index. The maximum
number of attachments is 10.
The attachments can be RAM, UFS or SD files (RAM files are strongly recommended). Files can be
uploaded to RAM, UFS or SD card by AT+QFUPL. After sending the email successfully, the files in RAM,
UFS or SD card should be deleted by AT+QFDEL. For more details of these commands, please refer to
Quectel_AG35_FILE_Application_Note. The mail service provider may have some restriction on single
file size and total size.
AT+QSMTPATT=0 can be used to delete all attachments.
Parameter
AT+QSMTPATT Add or Delete Attachments for an Email
Test Command
AT+QSMTPATT=?
Response
+QSMTPATT: (0,1),(1-10),<file_name>
OK
Read Command
AT+QSMTPATT?
Response
[+QSMTPATT:
<file_index>,<file_name>,<file_size><CR><LF>]
OK
Write Command
AT+QSMTPATT=<mode>[,<file_index
>,<file_name>]
Response
OK
Or
+CME ERROR: <err>
<mode> Integer type. Add or delete the attachment.
0 Delete
1 Add
<file_index> Integer type. The index of the attachment. The range is 1-10.
<file_name> String type. The file name of the attachment to be added. The maximum size of
the parameter is 50 bytes.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 16 / 30
Example
//Customers can add attachments from RAM. After the email is sent, the file uploaded to RAM should be
deleted by AT+QFDEL. The detailed example is shown as follows:
AT+QFUPL=“RAM:test.txt”,200,300,1 //Upload a file to RAM. The file will be saved as “test.txt”
and the maximum size of file is 200 bytes. 300 indicates
timeout, and 1 indicates ACK mode. For details, please
refer to Quectel_AG35_FILE_Application_Note.
CONNECT
<Input 200 bytes data>
+QFUPL: 200,707
OK
AT+QFLST=“RAM:*”
+QFLST: “RAM:test.txt”,200
OK
AT+QSMTPATT=1,1,“RAM:test.txt”//Add an attachment for email and the file index is 1.
OK
AT+QSMTPATT? //Query the attachments.
+QSMTPATT: 1,“RAM:test.txt”,200
OK
//Of course, you can delete all attachments as follows:
AT+QSMTPATT=0 //Delete all attachments for the email.
OK
AT+QSMTPATT? //Query the attachments.
OK
2.6. AT+QSMTPCLR Clear the Content of an Email
AT+QSMTPCLR will clear all the configurations of AT+QSMTPDST, AT+QSMTPSUB, AT+QSMTPBODY
and AT+QSMTPATT.
<file_size> Integer type. The size of the attachment. Unit: byte.
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
AT+QSMTPCLR Clear the Content of an Email
Test Command
AT+QSMTPCLR=?
Response
OK
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 17 / 30
Parameter
Example
AT+QSMTPCLR //Clear the recipients, subject, body and attachments for
the email.
OK
AT+QSMTPDST? //Query the recipients of the email.
OK
AT+QSMTPSUB? //Query the subject of the email.
+QSMTPSUB: 0,""
OK
AT+QSMTPATT? //Query the attachments of the email.
OK
2.7. AT+QSMTPPUT Send an Email
It may take some time for an email to be completely sent, which depends on the total size of attachments
and network status. Customers should not send email again before receiving “+QSMTPPUT:
<err>,<protocol_error>”which indicates the ending of sending an email. If <err> is not 0, the email can be
resent by executingAT+QSMTPPUT=<timeout> directly.
Execution Command
AT+QSMTPCLR
Response
OK
Or
+CME ERROR: <err>
<err> Integer type. The error code of the operation. Please refer to Chapter 5.
AT+QSMTPPUT Send an Email
Test Command
AT+QSMTPPUT=?
Response
+QSMTPPUT: (60-65535)
OK
Write Command
AT+QSMTPPUT=<timeout>
Response
If the format is correct and it is not sending an email:
OK
+QSMTPPUT: <err>,<protocol_error>
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 18 / 30
Parameter
Example
AT+QSMTPPUT=300 //Send the email and the maximum time is 300s.
OK
+QSMTPPUT: 0,0 //The email has been sent successfully. If <err>
is not 0, the email can be resent by executing
AT+QSMTPPUT=<timeout> directly.
If there is any error, response:
+CME ERROR: <err>
<timeout> Integer type. The maximum time to send an email. The range is 60-65535. Unit:
second.
<err> Integer type. The error code of the operation. Please refer to Chapter 5. If it is 0, it
means the operation is successful.
<protocol_error> Integer type. For reference only. Indicates the original error code from SMTP
server which is defined in SMTP protocol. For details, please refer to Chapter 6. If
it is 0, it is invalid.
Quectel
Confidential

LTE Module Series
AG35 SMTP AT Commands Manual
AG35_SMTP_AT_Commands_Manual Confidential / Released 19 / 30
3Examples
3.1. Send an Email without SSL
Sending an email without SSL means that SSL function will not be used, and the email will be sent with
insecure connection. For example:
//Step 1: Configure and activate the PDP context.
AT+QICSGP=1,1, “UNINET”,“”,“”,1 //Configure PDP context 1. APN is “UNINET” for
China Unicom.
OK
AT+QIACT=1 //Activate PDP context 1.
OK //Activated successfully.
AT+QIACT? //Query the state of PDP context.
+QIACT: 1,1,1,“10.7.157.1”
OK
AT+QSMTPCFG=“contextid”,1 //Set the PDP context ID as 1. The PDP context
ID must be activated first.
OK
//Step 2: Configure SMTP server and user account.
AT+QSMTPCFG=“ssltype”,0 //Set the SSL type as without SSL for SMTP. In
this case, SSL function will not be used, and
emails will be sent with insecure connection.
AT+QSMTPCFG="smtpserver","smtp.163.com",25 //Set the IP address or domain name and port of
SMTP server. The port of SMTP server depends
on mail service provider.
OK
AT+QSMTPCFG="account","sishen664551","wq664551" //Set username and password.
OK
AT+QSMTPCFG="sender","sishen664551","[e-mail]" //Set sender name and sender
address. The sender name
will be shown when the
email is received.
OK
Quectel
Confidential