Chapter 8 – Short Messages Commands

List Message +CMGL

Description: This command allows the application to read stored messages, by indicating the type of the message to read. The messages are read from the memory selected by the +CPMS command.

Values:

<index>: Place of storage in memory.

 

<stat>: Possible values, the status of messages in memory, are as follows:

 

Text Mode Possible Values

 

Status of Messages in Memory

 

“UREAD”

 

 

received unread messages

 

“READ”

 

 

received read messages

 

“USENT”

 

 

stored unsent messages

 

“SENT”

 

 

stored sent messages

 

“ALL”

 

 

all messages

 

Note: For SMS Status Reports, only “ALL” and “READ” values of the <stat> parameter will

 

list messages ; other values will only return OK.

 

<oa/da> : Origination/destination address value in string format.

 

<fo>:

First Octet, coded like SMS-SUBMIT first octet in document [4], default value is

 

 

17 for SMS-SUBMIT

 

 

<mr>:

Message Reference

 

 

<dt>:

Discharge Time in string format: “yy/MM/dd,hh :mm :ss±zz” (Year [00-99],

 

 

Month [01-12], Day [01-31], Hour, Minute, Second and Time Zone [quarters of

 

 

an hour] )

 

 

<st>:

Status of a SMS-STATUS-REPORT

 

<lang>:

Language

 

 

<encod>:

Encoding

 

 

<length> : Length of the text message (in bytes).

 

<data>:

Message text

 

Syntax: Command syntax: AT+CMGL=<stat>

Response syntax: +CMGL: <index>,<stat>,<da/oa>,<lang>, <encod>,<length><CR><LF><data> (for SMS-DELIVER and SMS-SUBMIT, may be followed by other <CR><LF>+CMGL:<index>…)

+CMGL: <index>,<stat>,<fo>,<mr>,<scts>,<dt>,<st> (for SMS-STATUS-REPORTonly, may be followed by other <CR><LF>+CMGL:<index>…)

Command

Possible Responses

AT+CMGL=“UREAD”

+CMGL: 1,”REC UNREAD”,”8585551212”,1,2,15

Note: List unread messages

<CR><LF>Unread message!

in text mode

+CMGL: 3,”REC UNREAD”, “8585551212”,

 

1,2,5<CR><LF>Hello

 

OK

 

Another message unread!

 

Note: 2 messages are unread, these messages will then have

 

their status changed to “REC READ” (+CSDH:0)

AT+CMGL=”READ”

+CMGL: 2,”REC READ”,”8585551212”,1,2,9<CR><LF>

Note: List read messages in

Keep cool

text mode

OK

AT+CMGL=”SENT”

OK

Note: List stored and sent

Note: No message found

messages in text mode

 

Multi-Tech Systems, Inc. CDMA Wireless AT Commands - PN S000294C

61

Page 61
Image 61
Multi-Tech Systems CDMA Wireless Modem manual List Message +CMGL, Index Place of storage in memory