background image

                                                                                                                                           

LTE  Module  Series 

                                                                                  EC2x&EG9x&EM05  SMTP  AT  Commands  Manual

 

 

EC2x&EG9x&EM05_SMTP_AT_Commands_Manual                                                                          3 / 31 

   
 

 

Contents 

About the Document ................................................................................................................................... 2

 

Contents ....................................................................................................................................................... 3

 

Table Index ................................................................................................................................................... 4

 

1

 

Introduction .......................................................................................................................................... 5

 

1.1.

 

Introduction about SSL Type ................................................................................................... 5

 

1.2.

 

The Process of Sending Email ................................................................................................ 6

 

1.3.

 

Description of Data Mode ........................................................................................................ 7

 

2

 

Description 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

 

3

 

Examples ............................................................................................................................................ 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

 

4

 

Error Handling .................................................................................................................................... 24

 

4.1.

 

Executing SMTP AT Command Fails .................................................................................... 24

 

4.2.

 

PDP Activation Fails .............................................................................................................. 24

 

4.3.

 

DNS Parse Fails .................................................................................................................... 25

 

4.4.

 

Error Response of AT+QSMTPPUT ...................................................................................... 25

 

5

 

Summary of Error Codes .................................................................................................................. 26

 

6

 

Summary of SMTP Protocol Error Codes ....................................................................................... 28

 

7

 

Appendix A References ..................................................................................................................... 30

 

 

 

Содержание EC2 Series

Страница 1: ...EC2x EG9x EM05 SMTP AT Commands Manual LTE Module Series Rev EC2x EG9x EM05_SMTP_AT_Commands_Manual_V1 0 Date 2017 12 08 Status Released www quectel com...

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

Страница 3: ...E Module Series EC2x EG9x EM05 SMTP AT Commands Manual EC2x EG9x EM05_SMTP_AT_Commands_Manual 2 31 About the Document History Revision Date Author Description 1 0 2017 12 08 Duke XIN Haley HUANG Initi...

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

Страница 5: ...M05 SMTP AT Commands Manual EC2x EG9x EM05_SMTP_AT_Commands_Manual 4 31 Table Index TABLE 1 SUMMARY OF ERROR CODES 26 TABLE 2 SUMMARY OF SMTP PROTOCOL ERROR CODES 28 TABLE 3 RELATED DOCUMENTS 30 TABLE...

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

Страница 7: ...y AT QSMTPCFG sslctxid sslctxID and configure the sslctxID by AT QSSLCFG ciphersuite sslctxID ciphersuites For more details about these commands please refer to Quectel_EC2x EG9x EM05_SSL_AT_ Commands...

Страница 8: ...mode and data mode In AT command mode the inputted data via COM port will be treated as AT command while in data mode it will be treated as data Inputting or pulling up DTR AT D1 should be set first c...

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

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

Страница 11: ...he 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_EC2x EG9x EM05_TCP IP _AT_Commands_Manual...

Страница 12: ...tel_test aol com QSMTPDST 2 quectel_test 21cn com OK Delete all recipients AT QSMTPDST 0 Delete all recipients OK AT QSMTPDST OK OK Write Command AT QSMTPDST mode type e mailaddr Response If the forma...

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

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

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

Страница 16: ...ould be deleted by AT QFDEL For more details of these commands please refer to Quectel_EC2x EG9x EM05_FILE_AT_Commands_Manual The mail service provider may have some restriction on single file size an...

Страница 17: ...ectel_EC2x EG9x EM05_FILE_AT_ Commands_Manual 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...

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

Страница 19: ...the format is correct and it is not sending an email OK QSMTPPUT err protocol_error If there is any error response CME ERROR err timeout Integer type The maximum time to send an email The range is 60...

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

Страница 21: ...means ASCII OK AT QSMTPSUB Query the subject of email QSMTPSUB 0 TEST SMTP OK AT QSMTPBODY 0 100 120 Edit email body The character set is 0 which means ASCII The maximum input length is 100 bytes and...

Страница 22: ...repeat Step 3 and Step 4 to re send emails Of course you can also repeat Step 2 to Step 4 to re send emails AT QIDEACT 1 Deactivate the PDP context which is activated for SMTP OK 3 2 Send an Email wit...

Страница 23: ...and sender address OK 3 3 Send an Email with STARTTLS Sending an email with STARTTLS means that the normal insecure connection will be upgraded to secure one through STARTTLS function thus for sending...

Страница 24: ...smtp 163 com 25 Set SMTP server address and port OK As the SMTP server is different the account information will be different as well As an example the following information is provided AT QSMTPCFG a...

Страница 25: ...ain status by AT CGREG command and make sure the PS domain has been registered 3 Query the PDP context parameters by AT QICSGP command and make sure the APN of specified PDP context has been set 4 Mak...

Страница 26: ...icates the sending is failed Please resend the email If resending is not successful please deactivate the PDP context by AT QIDEACT and re activate the PDP context by AT QIACT to resolve this issue If...

Страница 27: ...s according to the domain name 654 Network error such as failed to activate GPRS CSD context failed to establish the TCP connection with the SMTP server or failed to send an email to the SMTP server e...

Страница 28: ...or command unrecognized 671 Syntax error in parameters or arguments 672 Command not implemented 673 Bad sequence of commands 674 Command parameter not implemented 675 domain does not accept mail see R...

Страница 29: ...available closing transmission channel 450 Requested mail action not taken mailbox unavailable 451 Requested action aborted local error in processing 452 Requested action not taken insufficient syste...

Страница 30: ...LTE Module Series EC2x EG9x EM05 SMTP AT Commands Manual EC2x EG9x EM05_SMTP_AT_Commands_Manual 29 31 553 Requested action not taken mailbox name not allowed 554 Transaction failed...

Страница 31: ...mark 1 RFC2821 Simple Mail Transfer Protocol 2 RFC3207 SMTP service extension for secure SMTP over transport layer security 3 Quectel_EC2x EG9x EM05_TCP IP _AT_ Commands_Manual Introduction about EC2x...

Страница 32: ...LTE Module Series EC2x EG9x EM05 SMTP AT Commands Manual EC2x EG9x EM05_SMTP_AT_Commands_Manual 31 31 SSL Security Socket Layer TLS Transport Layer Security...

Отзывы: