Quectel LTE Standard MMS Istruzioni per l'installazione e il funzionamento

LTE Standard MMS

Application Note

LTE Standard Module Series

Rev. LTE_Standard_MMS_Application_Note_V1.1

Date: 2020-02-20

Status: Released

www.quectel.com

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 1 / 26

Our aim is to provide customers with timely and comprehensive service. For any

assistance, please contact our company headquarters:

Quectel Wireless Solutions Co., Ltd.

Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai,

China 200233

Tel: +86 21 5108 6236

Email: info@quectel.com

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

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

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

http://www.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 Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 2 / 26

About the Document

Revision History

Version

Date

Author

Description

1.0

2017-12-08

Duke XIN/

Haley HUANG

Initial

1.1

2020-02-20

Domingo DENG/

Cara TAO

1. AddedAT command syntax (Chapter 1.2).

2. Added commands AT+QMMSCFG?,

AT+QMMSEDIT?, AT+QMMSEND? and

AT+QMMSCFG="connecttimeout" (Chapter 2).

3. Added parameter <function_configure> and

updated the response description for

AT+QMMSEDIT (Chapter 2.2).

 LTE Standard Module Series 
 LTE Standard MMS Application Note 
 
LTE_Standard_MMS_Application_Note 3 / 26 
 
 
 
Contents 
About the Document.................................................................................................................................. 2 
Contents...................................................................................................................................................... 3 
Table Index.................................................................................................................................................. 4 
1Introduction......................................................................................................................................... 5 
1.1. The Process of Sending MMS Messages ................................................................................. 5 
1.2. AT Command Syntax................................................................................................................. 6 
2Description of MMS AT Commands.................................................................................................. 7 
2.1. AT+QMMSCFG Configure Parameters of MMS..................................................................... 7 
2.2. AT+QMMSEDIT Edit MMS Messages .................................................................................. 10 
2.3. AT+QMMSEND Send MMS Messages................................................................................. 12 
3Examples ........................................................................................................................................... 14 
3.1. Add Recipients......................................................................................................................... 14 
3.2. Add CC Recipients or BCC Recipients.................................................................................... 14 
3.3. Edit the Title of MMS Messages.............................................................................................. 15 
3.4. Add Attachments...................................................................................................................... 15 
3.5. Clear all Contents of MMS Messages ..................................................................................... 17 
3.6. 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 <err> Code................................................................................................................... 23 
6Description of HTTP(S) Response Codes...................................................................................... 25 
7Appendix A References.................................................................................................................... 26 
 

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 4 / 26

Table Index

Table 1: Types of AT Commands and Responses....................................................................................... 6

Table 2: Summary of Error Codes.............................................................................................................. 23

Table 3: Description of HTTP(S) Response Code.....................................................................................25

Table 4: Related Documents......................................................................................................................26

Table 5: Terms and Abbreviations..............................................................................................................26

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 5 / 26

1Introduction

Quectel LTE Standard 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 the following Quectel LTE Standard modules.

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

EG9x (EG95 and EG91)

EM05

EG2x (EG25-G and EG21-G)

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. For more details, please refer to

Quectel_LTE_Standard_TCP(IP)_Application_Note. 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_LTE_Standard_AT_Commands_Manual.

2) Activate the PDP context by AT+QIACT.

3) Configure the PDP context ID for MMS by AT+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 by AT+QMMSCFG="proxy",<gateway>,<port>.

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

<visible>,<class>.

Step 3: 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

by AT+QMMSCFG="character",<charset> first.

5) Add attachments by AT+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 Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 6 / 26

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

Step 4: 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 5: 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_

LTE_Standard_FILE_AT_Commands_Manual.

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

1.2. AT Command Syntax

Table 1: Types of AT Commands and Responses

1. <...>: Parameter name. Angle brackets < > are not included in the actual command line. The

parameter with an underscore "_" takes the default value.

2. [...]:Optional parameters. Square brackets [ ] are not included in the actual command line. The

default values will be used when optional parameters are omitted unless otherwise stated.

Test Command

AT+<x>=?

This command returns the list of parameters and value ranges

set by the corresponding Write Command or internal processes.

Read Command

AT+<x>?

This command returns the currently set value of the parameter

or parameters.

Write Command

AT+<x>=<…>

This command sets the user-definable parameter values.

Execution

Command

AT+<x>

This command reads non-variable parameters affected by

internal processes in the module.

NOTES

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 7 / 26

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",(range of supported

<contextID>s)

+QMMSCFG: "mmsc",<URL>

+QMMSCFG: "proxy",<gateway>,(range of supported

<port>s)

+QMMSCFG: "character",(list of supported <charset>s)

+QMMSCFG: "sendparam"[,(range of supported

<valid>s),(range of supported <pri>s),(list of supported

<sendrep>s),(list of supported <readrep>s),(range of

supported <visible>s),(range of supported <class>s)]

+QMMSCFG: "supportfield",(list of supported <mode>s)

+QMMSCFG: "connecttimeout",(list of supported

<connect_timeout>s)

Read Command

AT+QMMSCFG?

Response

Write Command

AT+QMMSCFG="contextid"[,<contextID

Response

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

+QMMSCFG: "contextid",<contextID>

If <contextID> is specified:

+CME ERROR: <err>

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 8 / 26

Write Command

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

Response

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

+QMMSCFG: "mmsc",<URL>

If <URL> is specified, configure MMSC URL:

+CME ERROR: <err>

Write Command

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

rt>]

Response

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

current settings:

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

If <gateway> and <port> are specified, configure proxy

gateway and port:

+CME ERROR: <err>

Write Command

AT+QMMSCFG="character"[,<charset>]

Response

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

+QMMSCFG: "character",<charset>

If <charset> is specified, configure the character format:

+CME ERROR: <err>

Write Command

AT+QMMSCFG="sendparam"[,<valid>,<

pri>,<sendrep>,<readrep>,<visible>,<cla

ss>]

Response

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

<class> are all omitted, query the current settings:

+QMMSCFG: "sendparam",<valid>,<pri>,<sendrep>,<

readrep>,<visible>,<class>

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

<class> are all specified:

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 9 / 26

Parameter

+CME ERROR: <err>

Write Command

AT+QMMSCFG="supportfield"[,<mode>]

Response

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

+QMMSCFG: "supportfield",<mode>

If <mode> is specified:

+CME ERROR: <err>

Write Command

AT+QMMSCFG="connecttimeout"[,<con

nect_timeout>]

Response

If <connect_timeout> is omitted, query the current

settings:

+QMMSCFG:"connecttimeout",<connect_timeout>

If <connect_timeout> is specified, configure the timeout

for MMS TCP handshake:

+CME ERROR: <err>

Characteristics

The command takes effect immediately.

The configurations will not be saved.

<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, and the default value is

80.

<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

Indice

Altri manuali Quectel Unità di controllo

Quectel

Quectel RM510Q-GL Supplemento

Quectel

Quectel UG96 Manuale utente

Quectel

Quectel EG95-E Manuale utente

Quectel

Quectel EC21 Series Supplemento

Quectel

Quectel LTE-A Series Supplemento

Quectel

Quectel LCC Series Manuale utente

Quectel

Quectel LTE Module Series Manuale utente

Quectel

Quectel BC95 Supplemento

Quectel

Quectel EG25-G Supplemento

Quectel

Quectel BG96-NA Supplemento

Quectel

Quectel SC20-CE Manuale utente

Quectel

Quectel EC20 Manuale di servizio

Quectel

Quectel BC660K-GL Manuale utente

Quectel

Quectel LTE Module Series Manuale utente

Quectel

Quectel WCDMA UG FILE Series Manuale di installazione

Quectel

Quectel EG91 Series Supplemento

Quectel

Quectel EP06 Manuale utente

Quectel

Quectel RG50-Q Series Manuale utente

Quectel

Quectel EC25 series Guida

Quectel

Quectel EC200A Series Supplemento

Quectel

Quectel EG91 Series Supplemento

Quectel

Quectel FC64E Supplemento

Quectel

Quectel EC25 series Istruzioni per l'installazione

Quectel

Quectel LPWA Series Manuale utente

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente