Quectel LTE Standard MMS Application Note Download Page 6

Page: 6 / 27

LTE Standard Module Series

LTE Standard MMS Application Note

LTE_Standard_MMS_Application_Note 5 / 26

Introduction

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

details,

please

refer

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

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

Summary of Contents for LTE Standard MMS

Page 1: ...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 ...

Page 2: ... 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...

Page 3: ...sion Date Author Description 1 0 2017 12 08 Duke XIN Haley HUANG Initial 1 1 2020 02 20 Domingo DENG Cara TAO 1 Added AT 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 ...

Page 4: ...rs of MMS 7 2 2 AT QMMSEDIT Edit MMS Messages 10 2 3 AT QMMSEND Send MMS Messages 12 3 Examples 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 4 Error Handling 21 4 1 Executing MMS AT Commands Fails 21 4 2 PDP Activation Fails 21 4 3 Error Response of...

Page 5: ...ation 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 ...

Page 6: ... 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 por...

Page 7: ...se 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...

Page 8: ...id 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...

Page 9: ...eway port OK If gateway and port are specified configure proxy gateway and port OK Or CME ERROR err Write Command AT QMMSCFG character charset Response If charset is omitted query the current settings QMMSCFG character charset OK If charset is specified configure the character format OK Or CME ERROR err Write Command AT QMMSCFG sendparam valid pri sendrep readrep visible cla ss Response If valid p...

Page 10: ...OK Or 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 prox...

Page 11: ...to deliver the 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 Depend on network configuration class Integer type The class of the MMS message 0 Personal 1 Advertisement 2 Informational 3 Automatical 4 Depend on network configuration mode Integer type The header opt...

Page 12: ...tring OK Or CME ERROR err When function 0 delete all content about the MMS message OK Or CME ERROR err If function_configure is specified When function_configure 0 optstring needs to be omitted which means deleting the specified settings of function OK Or CME ERROR err When function_configure 1 optstring is specified which means setting the specified settings of function OK Or CME ERROR err Charac...

Page 13: ...is 6 The maximum length of address is 50 bytes If function 4 it is the MMS message title The maximum length of title is 200 bytes If function 5 it is the file name of attachment If the file name is started with RAM UFS or SD it indicates the file is from RAM UFS or SD card respectively It is strongly recommended to use files from RAM as attachments The max length of file name is 80 bytes the maxim...

Page 14: ...nd httprsp Integer type The response code of HTTP S for reference only For example 200 indicates HTTP S posts data successfully Please refer to Chapter 6 mmsrsp String type The response string from MMSC when MMS messages are failed to be sent and is for reference only err If MMS messages are sent successfully err is 0 Otherwise err indicates the error code of the operation Please refer to Chapter ...

Page 15: ...ipient test quectel com OK Delete the recipients by executing AT QMMSEDIT 1 0 AT QMMSEDIT 1 0 Delete a recipient OK AT QMMSEDIT 1 Query the recipients address OK 3 2 Add CC Recipients or BCC Recipients The operation of adding CC recipients differs from adding BCC recipients only in function value For CC recipients the function value is 2 For BCC recipients it is 3 AT QMMSEDIT 2 1 13856122546 Add a...

Page 16: ...the title of MMS message 7465737420454D3035206D6D73 is the hex string of test EM05 MMS in UTF8 OK AT QMMSEDIT 4 Query the title of the MMS message QMMSEDIT 4 UTF8 7465737420454D3035206D6D73 OK Delete the title by executing AT QMMSEDIT 4 0 AT QMMSEDIT 4 0 Delete the title of the MMS message OK AT QMMSEDIT 4 Query the title of the MMS message OK 3 4 Add Attachments Customers can add attachments for ...

Page 17: ... attachments QMMSEDIT 5 RAM test_mms txt OK In the following example the attachment is an RAM JPG file AT QFUPL RAM test_pic jpg 200 300 1 Upload a file to RAM The file will be saved as test_pic jpg and the maximum size of file is 200 bytes 300 indicates timeout value and 1 indicates ACK mode For more details please refer to Quectel_LTE_Standard_FILE_Application_Note CONNECT Input 200 bytes data Q...

Page 18: ...ile OK AT QFLST RAM Query the file list of RAM OK 3 5 Clear all Contents of MMS Messages Delete the content recipients CC recipients BCC recipients title and attachments of an MMS message by AT QMMSEDIT 0 AT QMMSEDIT 0 Clear all contents of the MMS message OK AT QMMSEDIT 1 Query recipients OK AT QMMSEDIT 2 Query CC recipients OK AT QMMSEDIT 3 Query BCC recipients OK AT QMMSEDIT 4 Query title of th...

Page 19: ...FG proxy 10 0 0 172 80 Configure the proxy address and port of MMSC 10 0 0 172 80 is for China Unicom OK AT QMMSCFG proxy Query the proxy address and port of MMSC QMMSCFG proxy 10 0 0 172 80 OK Step 3 Configure sending parameters AT QMMSCFG sendparam 6 2 0 0 2 4 Configure the sending parameters OK AT QMMSCFG sendparam Query the sending parameters QMMSCFG sendparam 6 2 0 0 2 4 OK Step 4 Edit the MM...

Page 20: ...be saved as test_ram txt and the maximum size of file is 100 bytes 300 indicates timeout value and 1 indicates ACK mode For more details please refer to Quectel_LTE_Standard_FILE_Application_Note CONNECT Input 100 bytes data QFUPL 100 0 OK AT QFLST RAM Query the file list of RAM QFLST RAM test_ram txt 100 OK AT QMMSCFG character ASCII Configure the character type as ASCII for RAM test_ram txt OK A...

Page 21: ...OK AT QMMSEDIT 5 1 RAM test_pic jpg RAM test_pic jpg is not a text file There is no need to specify the character set OK AT QMMSEDIT 5 Query the attachments QMMSEDIT 5 RAM test_ram txt QMMSEDIT 5 RAM test_pic jpg OK Step 5 Send the MMS message AT QMMSEND 100 Send the MMS message OK QMMSEND 0 200 Indicate the result of sending the MMS message Step 6 Clear content of the MMS message AT QMMSEDIT 0 Cl...

Page 22: ...rs by AT QICSGP command and make sure the APN of specified PDP context has been set 4 Make sure the specified PDP context ID is neither used by PPP nor activated by AT CGACT command 5 According to 3GPP specifications the module only supports three PDP contexts activated simultaneously so customers must make sure the number of activated PDP contexts is less than 3 If all above configurations are co...

Page 23: ...ard Module Series LTE Standard MMS Application Note LTE_Standard_MMS_Application_Note 22 26 deactivate the PDP context by AT QIDEACT command and re activate it by AT QIACT command then send the MMS message again ...

Page 24: ...llowing table Table 2 Summary of Error Codes err Meaning 751 Unknown error 752 URL length error 753 URL error 754 Invalid proxy type 755 Proxy address error 756 Invalid parameter 757 Recipient address full 758 CC recipient address full 759 BCC recipient address full 760 Attachments full 761 File error 762 No recipient 763 File not found 764 MMS busy 765 Server response failed 766 Error response of...

Page 25: ..._Standard_MMS_Application_Note 24 26 768 PDP activation failed 769 PDP deactivated 770 Socket creation failed 771 Socket connection failed 772 Socket read failed 773 Socket write failed 774 Socket closed 775 Timeout 776 Encode data error 777 HTTP S decode data error ...

Page 26: ...ror code httprsp indicates an error replied from MMSC Please refer to RFC2616 Hypertext Transfer Protocol HTTP 1 1 The details about httprsp are described in the following table Table 3 Description of HTTP S Response Code httprsp Meaning 200 OK 400 Bad request 403 Forbidden 404 Not found 409 Conflict 411 Length required 500 Internal server error 502 Bad gate way ...

Page 27: ...g Service Center PDP Packet Data Protocol SD Secure Digital UFS User File Storage URL Uniform Resource Locator SN Document Name Remark 1 Wap 209 mmsencapsulation 20020105 a Wap MMS protocol standard package of documents 2 RFC2616 Hypertext transfer protocol HTTP 1 1 3 Quectel_LTE_Standard_FILE_Application_Note LTE Standard FILE Application Note 4 Quectel_LTE_Standard_TCP IP _Application_Note Intro...

Search results

Summary of Contents for LTE Standard MMS

Reviews:

Related manuals for LTE Standard MMS

Brands by name

Popular brands

Quectel LTE Standard MMS, Application Note

Search results

Summary of Contents for LTE Standard MMS

Reviews:

Related manuals for LTE Standard MMS

Brands by name

Popular brands