sim900a模塊資料sim900_mms_at command manual_v1 00_W

1、SIM900_MMS_ATCommand Manual_V1.00SIM900 MMS AT Command ManualGeneral NotesSIMCom offers this information as a service to its customers, to support application and engineering efforts that use the products designed by SIMCom. The information provided is based upon requirements specifically provided t

2、o SIMCom by the customers. SIMCom has not undertaken any independent search for additional relevant information, including any information that may be in the customers possession. Furthermore, system validation of this product designed by SIMCom within a larger electronic system remains the responsi

3、bility of the customer or the customers system integrator. All specifications supplied herein are subject to change.CopyrightThis document contains proprietary technical information which is the property of SIMCom Limited., copying of this document and giving it to others and the using or communicat

4、ion of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to change without notice at any

5、time.Copyright Shanghai SIMCom Wireless Solutions Ltd. 2010SIM900_MMS_AT Command Man1ual_V1.0022010.11.15Document Title:SIM900 MMS AT Command ManualVersion:1.00Date:2010-11-15Status:NewDocument Control ID:SIM900_MMS_AT Command Manual_V1.00SIM900 MMS AT Command ManualVersion HistorySIM900_MMS_AT Comm

6、and Man1ual_V1.0032010.11.15VersionChapterWhat is newV1.00OriginSIM900 MMS AT Command Manual1IntroductionThis document presents the AT command of MMS operation for SIM900. This document can apply to the same series of the modules which contain MMS function, like SIM900, SIM900D,SIM900B and SIM900A.1

7、.1Features1.2.SIM900 supports sending and receiving MMS only through HTTP protocol.Unicode (both little endian and big endian) and UTF8 are character sets supported and ASCII is supported only for English and numerals.The maximum data size of an MMS is 300 Kbytes. The maximum size of an image file i

8、s 300 Kbytes. The maximum size of a text file is 15360 bytes.The maximum number of files to be enclosed is 10.It is necessary to input text data into modem with header of Unicode (both little endian and big endian, “FF FE” is the header for Unicode little endian and “FE FF” is the header for Unicode

9、 big endian)It includes “MMS PUSH” in “+CMTI: ” when the received short message is a MMS push message (either M-Notification.ind or M-Delivery.ind 2).If the current received MMS push message is a concatenated message, it will include “,” after “MMS PUSH”. is the total number of the parts of the conc

10、atenated message and is the index of the current part in the whole concatenated message. For example: + CMTI: SM,1,MMS PUSH,2,1. In the URC, 2 means the concatenated push message include two parts and 1 means the current message is the first part. When all the parts of the concatenated push message

11、have been received, it will prompt “+CMTI: ” URC with “MMS PUSH” and without “,”. For example: +CMTI: SM,1,MMS PUSHX-profile parameters need to be configured for some MMS server, or some problems like image compression error may occur, also the x-profile address which is not configured by default sh

12、ould be set according to the customers own hardware environment.The output text from the modem is encoded with little endian Unicode, but the head ofUnicode is omitted..Reference1 SIM900 AT Commands Set2 wap-209-mmsencapsulation-20020105-aSIM900_MMS_AT Command Man1ual_V1.004201

13、0.11.15SIM900 MMS AT Command Manual1.3GlossarySIM900_MMS_AT Command Man1ual_V1.0052010.11.15MMSmultimedia short messageURLUniform Resource LocatorUARTUniversal Asynchronous Receiver and transmitterPDUProtocol Data UnitSIM900 MMS AT Command Manual2AT commands2.1AT+CMMSCURL2.2AT+CMMSPROTOSIM900_MMS_AT

14、 Command Man1ual_V1.0062010.11.15AT+CMMSPROTO Set the protocol parameter and MMS proxyTest CommandAT+CMMSPROTO=?Response+CMMSPROTO: “(0-255).(0-255).(0-255).(0-255)”,(0-65535)OKParametersSee Write CommandRead CommandAT+CMMSPROTO?Response+CMMSPROTO: ,OKAT+CMMSCURLSet the URL of the mms centerTest Com

15、mandAT+CMMSCURL=?Response+CMMSCURL: “URL”O(jiān)KParameterSee Write CommandRead CommandAT+CMMSCURL?Response+CMMSCURL: OKParameterSee Write CommandWrite CommandAT+CMMSCURL=ResponseOKorERRORor+CME ERROR: ParameterThe URL of the mms center.ReferenceNoteSIM900 MMS AT Command Manual2.3AT+CMMSCIDSIM900_MMS_AT C

16、ommand Man1ual_V1.0072010.11.15AT+CMMSCIDSet the network parameters for MMSTest CommandAT+CMMSCID=?Response+CMMSCID: (1-3) OKParameterSee Write CommandRead CommandAT+CMMSCID?Response+ CMMSCID: OKParameterSee Write CommandWrite CommandAT+CMMSCID=ResponseOKorERRORor+CME ERROR: Parameternetwork paramet

17、ers, refer to AT+SAPBRReferenceNoteParametersSee Write CommandWrite CommandAT+CMMSPROTO=,ResponseOKorERRORor+CME ERROR: ParametersIP address of MMS proxy.Port of MMS proxy.ReferenceNoteSIM900 MMS AT Command Manual2.4AT+CMMSSENDCFGSIM900_MMS_AT Command Man1ual_V1.0082010.11.15AT+CMMSSENDCFG Set the p

18、arameters for sending MMSTest Command AT+CMMSSENDC FG =?Response+ CMMSSENDCFG: (0-6), (0-3),(0,1), (0,1),(0-2),(0-4)OKParameterSee Write CommandRead Command AT+CMMSSENDC FG?Response+CMMSSENDCFG:,OKParameterSee Write CommandWrite CommandAT+CMMSSENDCFG=,ResponseOKorERRORor+CME ERROR: ParameterThe vali

19、d time of sent MMS0 1 hour1 12 hours2 24 hours3 2 days4 1 week5 maximum6 Not set (default)Priority0 lowest1 normal2 highest3 Not Set (default) Whether it need deliver report0 No(default)1 Yes Whether it need receive report0No(default)SIM900 MMS AT Command Manual2.5AT+CMMSEDITSIM900_MMS_AT Command Ma

20、n1ual_V1.0092010.11.15AT+CMMSEDITEnter or exit edit modeTest CommandAT+CMMSEDIT=?Response+CMMSEDIT: (0,1)OKParameterSee Write CommandRead CommandAT+CMMSEDIT?Response+CMMSEDIT: OKParameterSee Write CommandWrite CommandAT+CMMSEDIT=ResponseOKorERRORor+CME ERROR: ParameterWhether it allows to edit MMS0

21、Not allow to edit MMS1 Allow to edit MMSReferenceNote1YesWhether it need show the sender address0 hide the sender address1 show the sender address even if it is a secret address2 Not set (default)The class of the MMS0 Personal1 Advertisement2 Informational3 Auto4 Not set(default)ReferenceNoteRefer t

22、o 2SIM900 MMS AT Command Manual2.6AT+CMMSDOWNSIM900_MMS_AT Command Man1ual_V1.00102010.11.15AT+CMMSDOWN Download the file data or title from UARTTest CommandAT+CMMSDOWN=?Response+CMMSDOWN: PIC, (1-307200), (5000-),NAME+CMMSDOWN: TEXT, (1-15360), (2000-),NAME+CMMSDOWN: TITLE, (1-40), (2000-)OKRead Co

23、mmandAT+CMMSDOWN?ResponseERRORWrite CommandAT+CMMSDOWN=,ResponseCONNECTorERRORor+CME ERROR: ParametersA string parameter which indicates type of downloaded data“TITLE”: mms title data “TEXT”: mms text data “PIC”:mms image dataSize in bytes of the data to be downloaded.Maximum time in milliseconds to

24、 download data.The file name of the image or the text to be downloaded, including extended name. The default name for image is “image.jpg” and the default name for text is “text.txt”. and are in the range of 0255ReferenceNote It is strongly recommended to set the time long enough to download all the

25、 file data and make sure that the real size of the file to download is not bigger than . The maximum size of is 40 Bytes and only ASCII code is recognized for .It includes adding and deleting receipt, downloading and deleting files, downloading title to edit MMS.SIM900 MMS AT Command Manual2.7AT+CMM

26、SDELFILE2.8AT+CMMSSENDSIM900_MMS_AT Command Man1ual_V1.00112010.11.15AT+CMMSSENDStart mms sendingTest CommandAT+CMMSSEND=?Response+CMMSSEND: ADDRESSOKWrite CommandAT+CMMSSEND=ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicates address of recipients.Execution CommandAT+CMMSSEND

27、ResponseOKorERRORor+CME ERROR: AT+CMMSDELFILE Delete the file of the edited MMS by file indexTest Command AT+CMMSDELFI LE=?ResponseOKWrite CommandAT+CMMSDELFILE=ResponseOKorERRORor+CME ERROR: ParameterThe index of the file to be deleted in the MMS. Refer to+CMMSVIEWReferenceNoteThis command is valid

28、 when it is allowed to edit MMSSIM900 MMS AT Command Manual2.9 AT+CMMSRECP2.10 AT+CMMSCCSIM900_MMS_AT Command Man1ual_V1.00122010.11.15AT+CMMSCC Add copy recipientsTest CommandAT+CMMSCC =?Response+CMMSCC: ADDRESSOKRead CommandAT+CMMSCC?Response+CMMSCC: the list of sOKAT+CMMSRECPAdd recipientsTest Co

29、mmandAT+CMMSRECP=?Response+CMMSRECP: ADDRESSOKRead CommandAT+CMMSRECP?Response+CMMSRECP: the list of sOKParameterSee Write CommandWrite CommandAT+CMMSRECP=ResponseOKorERRORor+CME ERROR: Parameter a string parameter which indicates phone number or email address of recipients. The maximum length of th

30、e string is 40.ReferenceNoteThe maximum of recipients is 20 and this command is valid only when it is allowed to edit MMSReferenceNoteIt is not allowed to input when it not allowed to edit MMSSIM900 MMS AT Command Manual2.11 AT+CMMSBCCSIM900_MMS_AT Command Man1ual_V1.00132010.11.15AT+CMMSBCCAdd Secr

31、et RecipientsTest CommandAT+CMMSBCC =?Response+CMMSBCC: ADDRESSOKRead CommandAT+CMMSBCC?Response+CMMSBCC: the list of sOKParameterSee Write CommandWrite CommandAT+CMMSBCC=ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicates phone number or email address of secret recipients. Th

32、e maximum length of the string is 40.ReferenceNoteThe maximum of secret recipients is 20 and this command is valid only when it is allowed to edit MMSParameterSee Write CommandWrite CommandAT+CMMSCC=ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicates phone number or email addr

33、ess of copy recipients. The maximum length of the string is 40.ReferenceNoteThe maximum of copy recipients is 20 and this command is valid only when it is not allowed to edit MMSSIM900 MMS AT Command Manual2.12 AT+CMMSDELRECP2.13 AT+CMMSDELCCSIM900_MMS_AT Command Man1ual_V1.00142010.11.15AT+CMMSDELC

34、C Delete copy recipientsTest CommandAT+CMMSDELCC=?Response+CMMSDELCC: ADDRESSOKWrite CommandAT+CMMSDELCC=ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicates phone number or email address of copy recipients. The maximum length of the string is 40.Execution CommandAT+CMMSDELCCDe

35、lete all the copy recipients ResponseAT+CMMSDELRECP Delete recipientsTest Command AT+CMMSDELRE CP =?Response+CMMSDELRECP: ADDRESSOKWrite CommandAT+CMMSDELRECP =ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicates phone number or email address of recipient. The maximum length of

36、 the string is 40.Execution Command AT+CMMSDELRE CPDelete all the recipients ResponseOKReferenceNoteThis command is valid when it is allowed to edit MMSSIM900 MMS AT Command Manual2.14 AT+CMMSDELBCC2.15 AT+CMMSRECVSIM900_MMS_AT Command Man1ual_V1.00152010.11.15AT+CMMSRECVReceive MMSTest CommandAT+CM

37、MSRECV=?Response+CMMSRECV: (range of )OKWrite CommandAT+CMMSRECV=Response+CMMSRECV:,list of OKorERRORorAT+CMMSDELBCC Delete secret recipientsTest Command AT+CMMSDELBC C=?Response+CMMSDELBCC: ADDRESSOKWrite CommandAT+CMMSDELBCC =ResponseOKorERRORor+CME ERROR: Parametera string parameter which indicat

38、es phone number or email address of recipient. The maximum length of the string is 40.Execution Command AT+CMMSDELBC CDelete all the secret recipients ResponseOKReferenceNoteThis command is valid when it is allowed to edit MMSOKReferenceNoteThis command is valid when it is allowed to edit MMSSIM900

39、MMS AT Command Manual2.16 AT+CMMSVIEWSIM900_MMS_AT Command Man1ual_V1.00162010.11.15AT+CMMSVIEW Get the MMS into buffer and show the informationTest CommandAT+CMMSVIEW=?ResponseOKExecution CommandAT+CMMSVIEWResponse+CMMSVIEW: , , ”, “”, “”, ,list ofOKorERRORor+CME ERROR: ParametersThe index of the p

40、ush message saved in the SIM message box.The address of the senderThe time to receive the MMSthe title of the MMSThe size of the MMSThe index, name and size of every file included in the MMS. The types are defined as following.2 text3 text/html4 text/plain5 image6 image/gif7 image/jpg8 image/tif9 im

41、age/png10 smilReferenceNote This command is valid only when it is not allowed to edit MMS and the buffer for MMS will be clear up. So it is recommended to save the MMS in the buffer before receiving MMS. The received MMS is just saved in the buffer but not saved in theflashSIM900 MMS AT Command Manu

42、al2.17 AT+CMMSREAD2.18 AT+CMMSRDPUSHSIM900_MMS_AT Command Man1ual_V1.00172010.11.15AT+CMMSRDPUSH Read the information of the MMS PUSH messageTest CommandAT+CMMSRDPUS H =?Response+CMMSRDPUSH: (range of )AT+CMMSREAD Read the given file of the MMS in the bufferTest CommandAT+CMMSREAD=?ResponseOKWrite C

43、ommandAT+CMMSREAD=Response+CMMSREAD: File contentOKParametersthe index of the file to be read from the MMS in the buffer，i.e. the parameter in “AT+CMMSRECV” and “AT+CMMSVIEW”the file name to be readthe size of the file to be read.ReferenceNoteIf the file type is text, the character set of the output

44、 text is Unicode little endian without the header “FF FE”.+CME ERROR: Parameters The type of MMS0 Received mms1 Sent mms2 Unsent mmsThe address of th senderList of recipients, Separated by “;”List of copy recipients , Separated by “;”List of secret recipients , Separated by “;”The time of receive MM

45、SThe title of MMSData size of MMSSIM900 MMS AT Command ManualSIM900_MMS_AT Command Man1ual_V1.00182010.11.15OKWrite CommandAT+CMMSRDPUSH =Response+CMMSRDPUSH:2,”,”,”,”,”,OKor+ CMMSRDPUSH: 6, “”,”,OKor+ CMMSRDPUSH: 255OKor+CME ERROR: ParametersThe first parameter of the response should be 2 or 6, or

46、the other type of the MMS PDU.2m-notification-ind2. To inform the contents of areceived MMS6m-delivery-ind2. A delivery report 255 unknown MMS PDUThe index of the push message saved in the SIM message box.The address of the senderThe address of the receiverThe title of the MMSThe X-Mms-Transation-ID

47、2 of the received MMSThe X-Mms-Content-Location2 of the received MMSThe X-Mms-Class2 of the received MMS0 Personal1 Advertisement2 Informational3 AutoDate and time of the received push message.The size of the MMSThe status of the sent MMS0 Expired1 Retrieved2 Rejected3 DeferedSIM900 MMS AT Command M

48、anual2.19 AT+CMMSUA2.20 AT+CMMSPROFILESIM900_MMS_AT Command Man1ual_V1.00192010.11.15AT+ CMMSPROFILESet User Agent ProfileTest CommandAT+CMMSPROFI LE=?Response+CMMSPROFILE: UserAgentProfileAT+CMMSUA Set User AgentTest CommandAT+CMMSUA=?Response+CMMSUA: UserAgentOKParameterSee Write CommandRead Comma

49、ndAT+CMMSUA?Response+CMMSUA: OKParameterSee Write CommandWrite CommandAT+CMMSUA=ResponseOKorERRORor+CME ERROR: Parameterstring type user agent nameReferenceNote4UnrecognizedReferenceNote This command is valid only when it is not allowed to edit MMS and the buffer for MMS will be clear up. So it is reco