Quectel EC2 Series Instrucciones de instalación

EC2x&EG9x&EM05 MMS

AT Commands Manual

LTE Module Series

Rev. EC2x&EG9x&EM05_MMS_AT_Commands_Manual_V1.0

Date: 2017-12-08

Status: Released

www.quectel.com

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 1 / 25

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: +86 21 5108 6236

Email: [email protected]om

Or our local office. For more information, please visit:

http://quectel.com/support/sales.htm

For technical support, or to report documentation errors, please visit:

http://quectel.com/support/technical.htm

Or email to: support@quectel.com

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.

THE INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF

QUECTEL WIRELESS SOLUTIONS 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.

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 2 / 25

About the Document

History

Revision

Date

Author

Description

1.0

2017-12-08

Duke XIN/

Haley HUANG

Initial

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 3 / 25

Contents

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

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

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

1Introduction..........................................................................................................................................5

1.1. The Process of Sending MMS Messages ..................................................................................5

2Description of MMS AT Commands...................................................................................................7

2.1. AT+QMMSCFG Configure Parameters of MMS......................................................................7

2.2. AT+QMMSEDIT Edit MMS Messages ...................................................................................10

2.2.1. Add Recipients............................................................................................................... 11

2.2.2. Add CC Recipients or BCC Recipients..........................................................................12

2.2.3. Edit the Title of MMS Messages ....................................................................................12

2.2.4. Add Attachments............................................................................................................13

2.2.5. Clear all Contents of MMS Messages ...........................................................................14

2.3. AT+QMMSEND Send MMS Messages..................................................................................15

3Examples ............................................................................................................................................17

3.1. Send MMS Messages...............................................................................................................17

4Error Handling....................................................................................................................................21

4.1. Executing MMSAT Commands Fails .......................................................................................21

4.2. PDPActivation Fails..................................................................................................................21

4.3. Error Response ofAT+QMMSEND...........................................................................................21

5Summary of Error Codes ..................................................................................................................22

6Description of HTTP(S) Response Codes.......................................................................................24

7Appendix A References.....................................................................................................................25

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 4 / 25

Table Index

TABLE 1: SUMMARY OF ERROR CODES ...................................................................................................... 22

TABLE 2: DESCRIPTION OF HTTP(S) RESPONSE CODE............................................................................ 24

TABLE 3: RELATED DOCUMENTS.................................................................................................................. 25

TABLE 4: TERMS AND ABBREVIATIONS........................................................................................................ 25

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 5 / 25

1Introduction

Quectel EC2x&EG9x&EM05 modules provide MMS application interface for sending messages including

multimedia objects (image, audio, rich text, etc.). This document is a reference guide to all the AT

commands defined for MMS.

This document is applicable to following Quectel modules.

EC2x (including EC25, EC21, EC20 R2.0 and EC20 R2.1)

EG9x (including EG91 and EG95)

EM05

1.1. The Process of Sending MMS Messages

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_EC2x&EG9x&EM05_TCP(IP)_AT_Commands_Manual

for details. 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_EC25&EC21_AT_Commands_Manual, Quectel_EG9x_AT_Commands_Manual and

Quectel_EM05_AT_Commands_Manual.

2) Activate the PDP context byAT+QIACT.

3) Configure the PDP context ID for MMS byAT+QMMSCFG="contextid",<contextID>.

Step 2: Configure URL and proxy of MMSC.

1) Configure the URL of MMSC by AT+QMMSCFG="mmsc",<URL>.

2) Configure the proxy of MMSC byAT+QMMSCFG="proxy",<gateway>,<port>.

Step 3: Configure sending parameters by AT+QMMSCFG="sendparam",<valid>,<pri>,<sendrep>,<vi

sible>,<class>.

Step 4: Edit MMS messages.

1) Add recipients’ address by AT+QMMSEDIT=1,1,<optstring>.

2) Add CC recipients’ address by AT+QMMSEDIT=2,1,<optstring>.

3) Add BCC recipients’ address by AT+QMMSEDIT=3,1,<optstring>.

4) Edit the title by AT+QMMSEDIT=4,1,<optstring>. The character set should be specified as title

byAT+QMMSCFG="character ",<charset> first.

5) Add attachments byAT+QMMSEDIT=5,1,<optstring>. The attachments can be RAM, UFS or SD

files. And the files can be uploaded to RAM, UFS or SD card by AT+QFUPL command. After

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 6 / 25

sending MMS messages successfully, the file should be deleted by AT+QFDEL command. If the

attachment is a text file, the character set should be specified by

AT+QMMSCFG="character",<charset> first. For more details, please refer to

Quectel_EC2x&EG9x&EM05_FILE_AT_Commands_Munual.

Step 5: Send MMS messages by AT+QMMSEND=<timeout>. It may take some time to send MMS

messages successfully. MMS messages should be sent again before output of “+QMMSEND:

<err>,<httprsp>[,<mmsrsp>]” which indicates the ending of sending MMS messages.

Step 6: Clear the content of an MMS message by AT+QMMSEDIT=0 and delete the files as attachments

by AT+QFDEL. For more details, please refer to Quectel_EC2x&EG9x&EM05_FILE_AT_

Commands_Munual.

Step 2 to Step 6 can be repeated, and Step 4 to Step 6 can be repeated too.

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 7 / 25

2Description of MMS AT Commands

2.1. AT+QMMSCFG Configure Parameters of MMS

The command can be used to configure PDP context ID, MMSC, proxy, character type and other MMS

parameters. If the Write Command only executes one parameter, it will query the current settings.

AT+QMMSCFG Configure Parameters of MMS

Test Command

AT+QMMSCFG=?

Response

+QMMSCFG: "contextid",(1-16)

+QMMSCFG: "mmsc",<URL>

+QMMSCFG: "proxy",<gateway>,(1-65535)

+QMMSCFG:

"character",("ASCII","UTF8","UCS2","GBK")

+QMMSCFG:

"sendparam"[,(0-6),(0-3),(0,1),(0,1),(0-2),(0-4)]

+QMMSCFG: "supportfield",(0,1)

Write Command

AT+QMMSCFG="contextid"[,<contex

tID>]

Response

If <contextID> is not omitted:

+CME ERROR: <err>

If <contextID> is omitted, query the current settings:

+QMMSCFG: "contextid",<contextID>

Write Command

AT+QMMSCFG="mmsc"[,<URL>]

Response

If <URL> is not omitted:

+CME ERROR: <err>

If <URL> is omitted, query the current settings:

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 8 / 25

+QMMSCFG: "mmsc",<URL>

Write Command

AT+QMMSCFG="proxy"[,<gateway>,

<port>]

Response

If <gateway> and <port> are not omitted,

+CME ERROR: <err>

If <gateway> and <port> are both omitted, query the current

settings:

+QMMSCFG: "proxy",<gateway>,<port>

Write Command

AT+QMMSCFG="character"[,<charse

t>]

Response

If <charset> is not omitted,

+CME ERROR: <err>

If <charset> is omitted, query the current settings:

+QMMSCFG: "character",<charset>

Write Command

AT+QMMSCFG="sendparam"[,<valid

>,<pri>,<sendrep>,<readrep>,<visibl

e>,<class>]

Response

If <valid>, <pri>, <sendrep>, <readrep>, <visible>, <class>

are not omitted:

+CME ERROR: <err>

If <valid>, <pri>, <sendrep>, <readrep>, <visible>, <class>

are all omitted, query the current settings:

+QMMSCFG:

"sendparam",<valid>,<pri>,<sendrep>,<readrep>,<visible

>,<class>

Write Command

AT+QMMSCFG="supportfield"[,<mod

e>]

Response

If <mode> is not omitted,

+CME ERROR: <err>

LTE Module Series

EC2x&EG9x&EM05 MMS AT Commands Manual

EC2x&EG9x&EM05_MMS_AT_Commands_Manual 9 / 25

Parameter

If <mode> is omitted, query the current settings:

+QMMSCFG: "supportfield",<mode>

<contextID> Integer type. The PDP context ID. The range is 1-16, and the default value is 1.

<URL> String type. The address of MMSC. The maximum length of URL is 100 bytes.

<gateway> String type. The IP address of MMS proxy. The maximum length of gateway is 50

bytes.

<port> Integer type. The port of MMS proxy. The range is 1-65535.

<charset> String type. The type of character set.

“ASCII”US-ASCII character set

“UTF8” UTF8 character set

“UCS2” ISO-10646-UCS-2 character set, big-endian order needs to be specified

“GBK” GBK character set

<valid> Integer type. The validity period of the MMS message.

0 1 hour

1 12 hours

2 24 hours

3 2 days

4 1 week

5 Maximum

6 Based on network configuration

<pri> Integer type. The priority of the MMS message.

0 Low

1 Normal

2 High

3 Based on network configuration

<sendrep> Integer type. Whether to deliver report.

0 No

1 Yes

<readrep> Integer type. Whether to read report.

0 No

1 Yes

<visible> Integer type. Whether to hide address.

0 Hide any address

1 Show all addresses, including BCC address

2 Based on network configuration

<class> Integer type. The class of the MMS message.

0 Personal

1 Advertisement

2 Informational

Otros manuales para EC2 Series

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Unidad de control de Quectel

Quectel

Quectel SC20-CE Manual de usuario

Quectel

Quectel BC95 Manual de usuario

Quectel

Quectel EC25-V Manual de usuario

Quectel

Quectel Smart EVB G5 Manual de usuario

Quectel

Quectel EG06 Series Manual de usuario

Quectel

Quectel BG96 Suplemento

Quectel

Quectel UG95 Suplemento

Quectel

Quectel L70 Instrucciones de instalación

Quectel

Quectel QuecOpen AG525R-GL Suplemento

Quectel

Quectel EC2 Series Instrucciones de instalación

Quectel

Quectel WCDMA UG Series Manual de usuario

Quectel

Quectel M50 Suplemento

Quectel

Quectel L76 Guía

Quectel

Quectel M66 Suplemento

Quectel

Quectel EC21 Series Suplemento

Quectel

Quectel LTE Module Series Instrucciones de instalación

Quectel

Quectel EM160R-GL Suplemento

Quectel

Quectel NB-IoT Module Series Suplemento

Quectel

Quectel EC25 series Manual de usuario

Quectel

Quectel LTE Module Series Manual de usuario

Quectel

Quectel EC25 Mini PCIe Suplemento

Quectel

Quectel L76 Manual de usuario

Quectel

Quectel BG95 Series Suplemento

Quectel

Quectel M80 Manual de usuario

Manuales populares de Unidad de control de otras marcas

Festo

Festo Compact Performance CP-FB6-E Manual de lista de piezas

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manual de usuario

JS Automation

JS Automation MPC3034A Manual de usuario

JAUDT

JAUDT SW GII 6406 Series Guía rápida

Spektrum

Spektrum Air Module System Manual de usuario

BOC Edwards

BOC Edwards Q Series Manual de usuario

KHADAS

KHADAS BT Magic Manual de usuario

Etherma

Etherma eNEXHO-IL Manual de usuario

PMFoundations

PMFoundations Attenuverter Manual de usuario

GEA

GEA VARIVENT Manual de usuario

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manual de usuario

Altronix

Altronix LINQ8PD Instrucciones de montaje

Eaton

Eaton Powerware Series Manual de usuario

WAGO

WAGO 750-407/040-000 Manual de usuario

Sony

Sony CCU-590 Manual de usuario

Graco

Graco 25D614 Manual de usuario

Task Force Tips

Task Force Tips YE-RF-900 Manual de programación

Shini

Shini SPV-U Series Manual de usuario