Multi-Tech Systems GPRS (MTMMC-G), GPRS (MTSMC-G) Read Message +CMGR

Chapter 9 – Short Messages Commands

Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 68

Read Message +CMGR

Description: This command allows the application to read stored messages. The messages are read from the

memory selected by the +CPMS command.

Syntax: Command syntax: AT+CMGR=<index>

Response syntax for text mode:

For SMS-DELIVER only

+CMGR: <stat>,<oa>,[<alpha>,] <scts> [,<tooa>,<fo>,<pid>,<dcs>,<sca>,<tosca>,<length>]

<CR><LF> <data>

For SMS-SUBMIT only

+CMGR: <stat>,<da>,[<alpha>,] [,<toda>,<fo>,<pid>,<dcs>, [<vp>], <sca>,

<tosca>,<length>]<CR><LF> <data>

For SMS-STATUS-REPORT only)

+CMGR: <stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st>

Response syntax for PDU mode:

+CMGR: <stat>, [<alpha>] ,<length> <CR><LF> <pdu>

Notes: A message read with status “REC UNREAD” will be updated in memory with the status “REC READ”.

The <stat> parameter for the SMS Status Reports is always “READ”.

Syntax: Command Syntax: AT+CMGR=<index>

Command Possible responses

AT+CMTI: “SM”,1

Note: New message received

AT+CMGR=1

Note: Read the message +CMGR: “REC UNREAD��,”0146290800”,

”98/10/01,18:22:11+00”,<CR><LF>

ABCdefGHI

OK

AT+CMGR=1

Note: Read the message again +CMGR: “REC UNREAD”,”0146290800”,

”98/10/01,18:22:11+00”,<CR><LF>

ABCdefGHI

OK

Note: Message is read now

AT+CMGR=2

OK

Note: Location empty

AT+CMGF=0 ;+CMGR=1

Note: In PDU mode

+CMGR: 2,,<length> <CR><LF><pdu>

OK

Note: Message is stored but unsent, no <alpha>field

AT+CMGF=1;+CPMS=”SR”;+CNMI=,,,2

Reset to text mode, set read memory to

“SR”, and allow storage of further SMS

Status Report into “SR” memory

OK

AT+CMSS=3

Send an SMS previously stored +CMSS: 160

OK

+CDSI: “SR”,1

New SMS Status Report stored in “SR” memory at

index 1

AT+CMGR=1

Read the SMS Status Report +CMGR: "REC UNREAD",6,160, "+33612345678",129,

"01/05/31,15:15:09+00",

"01/05/31,15:15:09+00",0

OK

Contents

Main Wireless GSM/GPRS Modems AT Commands Page Contents Page Page Page Page Page Chapter 1 Introduction Scope of This Document Related Documents Definitions Chapter 2 AT Command Featu re s Line Settings Command Line Information Responses and Result Codes Chapter 3 General Behaviors SIM Card Insertion and Removal Procedures Background Initialization About the Length of Phone Numbers Example: Page Chapter 4 General AT Commands Manufacturer Identification +CGMI Request Model Identification +CGMM Request Revision Identification +CGMR Product Serial Number +CGSN Select TE Character Set +CSCS Phonebook Character Set +WPCS Request IMSI +CIMI Card Identification +CCID Capabilities List +GCAP Repeat Last Command A/ Power Off +CPOF Set Phone Functionality +CFUN Phone Activity Status +CPAS Report Mobile Equipment Errors +CMEE Keypad Control +CKPD Clock Management +CCLK Alarm Management +CALA Chapter 5 Call Control Commands Dial Command D Hang-Up Command H Answer a Call A Remote Disconnection Extended Error Report +CEER DTMF Signals +VTD, +VTS +VTD Redial Last Telephone Number DL Automatic Dialing with DTR %D Automatic Answer S0 Incoming Call Bearer +CICB Single Numbering Scheme +CSNS Gain Control +VGR, +VGT Page Microphone Mute Control +CMUT Speaker & Microphone Selection +SPEAKER Echo Cancellation +ECHO Page Page SideTone Modification +SIDET Initialize Voice Parameters +VIP Chapter 6 Network Service Commands Signal Quality +CSQ Operator Selection +COPS Page Network Registration +CREG Operator List Management +WOLM Read Operator Name +WOPN Page Selection of Preferred PLMN List +CPLS Preferred Operator List +CPOL Page Read Operator Name +COPN Chapter 7 Security Commands Enter PIN +CPIN Page Enter PIN2 +CPIN2 PIN Remaining Attempt Number +CPINC Facility Lock +CLCK Change Password +CPWD Chapter 8 Phonebook Commands Introduction to Phonebook Commands About the Parameters SIM Contact Structure Extended SIM Contact Structure Select Phonebook Memory Storage +CPBS Read Phonebook Entries +CPBR Page Write Phonebook Entry +CPBW Page Page Find Phonebook Entries +CPBF Phonebook Phone Search +CPBP Move Action in Phonebook +CPBN Subscriber Number +CNUM Avoid Phonebook Initialization +WAIP Delete Calls Phonebook +WDCP Set Voice Mail Number +CSVM Contact Selector +WCOS Create and Delete a Phonebook Group +WPGW Read a Phonebook Group +WPGR Settings of a Phonebook Group +WPGS Chapter 9 Short Messages Parameters Definition Select Message Service +CSMS New Message Acknowledgement +CNMA Example of New Message Acknowledgement in TEXT Mode Example of New Message Acknowledgement in PDU Mode: Preferred Message Storage +CPMS Preferred Message Format +CMGF Save Settings +CSAS Restore Settings +CRES Show Text Mode Parameters +CSDH New Message Indication +CNMI Page Read Message +CMGR List Message +CMGL Send Message +CMGS Write Message to Memory +CMGW Send Message from Storage +CMSS Set Text Mode Parameters +CSMP Delete Message +CMGD Service Center Address +CSCA Select Cell Broadcast Message Types +CSCB Cell Broadcast Message Identifiers +WCBM Message Status Modification +WMSC Message Overwriting +WMGO Change or Do Not Change SMS Status +WUSS Copy Messages +WMCP More Messages to Send +CMMS Chapter 10 Supplementary Services Commands Call Forwarding +CCFC Call Barring +CLCK Modify SS Password +CPWD Call Waiting +CCWA Calling Line Identification Restriction +CLIR Calling Line Identification Presentation +CLIP Connected Line Identification Presentation +COLP Advice of Charge +CAOC Accumulated Call Meter +CACM Accumulated Call Meter Maximum +CAMM Price Per Unit and Currency Table +CPUC Call Related Supplementary Services +CHLD List Current Calls +CLCC Supplementary Service Notifications +CSSN Unstructured Supplementary Service Data +CUSD Closed User Group +CCUG Chapter 11 Data Commands Using AT Commands During a Data Connection Switch from Online to Offline Mode Switch from Offline to Online Mode Bearer Type Selection +CBST Select Mode +FCLASS Service Reporting Control +CR Cellular Result Codes +CRC DTE-DCE Local Rate Reporting +ILRR Radio Link Protocol Parameters +CRLP Other Radio Link Parameters +DOPT Select Data Compression %C V42bis Data Compression +DS V42bis Data Compression Report +DR Select Data Error Correcting Mode \N Ch ap te r 12 V.24 an d V.2 5 Commands Important Fixed DTE Rate +IPR DTE-DCE Character Framing +ICF DTE-DCE Local Flow Control +IFC Set DCD Signal &C Set DTR Signal &D Set DSR Signal &S Back to Online Mode O Result Code Suppression Q DCE Response Format V Default Configuration Z Save Configuration &W Auto-Tests &T Echo E Restore Factory Settings &F Display Configuration &V Request Identification Information I Multiplexing Mode +WMUX Chapter 13 Specific AT Commands Cell Environment Description +CCED Combination of the requested dump is supported (addition of the values 1, 2, 4, and 8): Values of MCC/MNC are set to 0 in the case of No service. General Indications +WIND To activate a specific WIND indication, <IndLevel> must have a value described above. To activate several WIND indications, <IndLevel> must have a value just before the last Page Analog Digital Converter Measurements +ADC Mobile Equipment Event Reporting +CMER Read Language Preference +WLPR Write Language Preference +WLPW Read GPIO Value +WIOR Write GPIO Value +WIOW Input/Output Management +WIOM <GpioDir> bit values for GPI and GPO are ignored. <GpioVal> bit values for GPI are ignored. Abort Command +WAC Play Tone +WTONE Play DTMF Tone +WDTMF Downloading +WDWL Voice Rate +WVR Data Rate +WDR Select Voice Gain +WSVG Status Request +WSTR Scan +WSCAN Ring Indicator Mode +WRIM 32kHz Power Down Mode +W32K Change Default Melody +WCDM Custom Character Set +WCCS Lock +WLCK CPHS Command +CPHS Chapter 13 Specific AT Commands Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 127 Unsolicited Result: Voice Mail Indicator +WVMI Unsolicited Result: Diverted Call Indicator +WDCI Network Operator Name +WNON CPHS Information +WCPI Customer Service Profile +WCSP Customer Storage Mirror +WMIR Change Default Player +WCDP CPHS Mail Box Number +WMBN Alternate Line Service +WALS Wavecom Open AT Control Command +WOPEN Page Reset +WRST Set Standard Tone +WSST Hang-up +WATH Multi-Band Selection +WMBS Chapter 14 SIM Toolkit Overview of SIM Application Toolkit Functionality Profile Download Proactive SIM Messages Exchanged During a SIM Toolkit Operation SIM Toolkit Commands SIM Toolkit Set Facilities +STSF SIM Toolkit Facilities Error Codes Example SIM Toolkit Indication +STIN or +STRIL SIM Toolkit Get Information +STGI Page Page Unsolicited Result: SIM Toolkit Control Response +STCR SIM Toolkit Give Response +STGR Page Chapter 14 SIM Toolkit Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 148 OK Chapter 15 GPRS commands Define PDP Context +CGDCONT Page Quality of Service Profile Requested +CGQREQ Page Page Quality of Service Profile Minimum Acceptable +CGQMIN GPRS Attach or Detach +CGATT PDP Context Activate or Deactivate +CGACT Enter Data State +CGDATA GPRS Mobile Station Class +CGCLASS Select Service for MO SMS Messages +CGSMS GPRS Event Reporting +CGEREP GPRS Network Registration Status +CGREG Request GPRS IP Service D Network Requested PDP Context Activation Automatic Response to a Network Request for PDP Context Activation S0 Manual Acceptance of a Network Request for PDP Aontext Activation A Manual Rrejection of a Network Request for PDP Context Activation H Automatic Response to a Network Request for PDP Context Activation +CGAUTO Manual Response to a Network Request for PDP Context Activation +CGANS Show PDP Address +CGPADDR Cellular Result Codes +CRC Service Reporting Control +CR Extended Error Report +CEER GPRS Parameters Customization +WGPRS Page Examples of Full GPRS AT Commands Activation of an IP PDP Context Example 1 Example 2 Network Request Chapter 16 Other AT Commands Appendix A Result Codes, Failure Causes, Other Tables Chapter Summary ME Error Result Code: +CME ERROR: <error> Message Service Failure Result Code +CMS ERROR Specific Error Result Codes Page Failure Cause from GSM 04.08 Recommendation +CEER Continued: Failure Cause from GSM 04.08 Recommendation +CEER Specific Failure Cause for +CEER GSM 04.11 Annex E-2: Mobile Originating SM-Transfer Unsolicited Result Codes Final Result Codes Intermediate Result Codes Parameter Storage Mode Page GSM Sequences List Security Call Forwarding Call Barring Call Waiting Number Presentation Operator Names CPHS Information Field CSP Constants Page Appendix B - ME SIM Toolkit Support Appendix C Structure of the Terminal Profile Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 188 Appendix C Structure of the Ter mi na l P rofi le Appendix C Structure of the Terminal Profile Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 189 Appendix D Command Type and Next Action Indicator Appendix E Coding of Alpha fields in the SIM for UCS2 Page Appendix F Command Execution and Dependence on SIM General Commands Call Control Commands Network Service Commands Security Commands Phonebook Commands Short Messages Commands Supplementary Services Commands Data Commands V24-V25 Commands Specific AT Commands SIM Toolkit Commands GPRS Commands Index % & + 3 A B C Page D E F G H N O P Q R