Short Message Service Commands TRM250
Short Message Service Related Commands
AT+CSMS Select Message Service
The command selects messaging service and returns the types of messages supported by the ME.
AT+CMGF Message Format
The command specifies the input and output format of the short messages. <mode> indicates the format of messages used with Test, Read, Write and Execution Commands and unsolicited result codes resulting from received messages.
The format of messages can be either PDU mode (entire TP data units used) or text mode (headers and body of the messages given as separate parameters). Text mode uses the value of parameter <chset> specified by AT+CSCS command to inform the character set to be used in the message body in the TA-TE interface.
AT+CSCA Service Center Address
The Write Command updates the SMSC address when mobile originated SMS are transmitted. In text mode, the setting is used by Write Command. In PDU mode, setting is used by the same command, but only when the length of the SMSC address is coded into the <pdu> parameter which equals to zero
AT+CPMS Preferred Message Storage
The command selects the memory storages <mem1>, <mem2> and <mem3> to be used for reading, writing, etc.
AT+CMGD Delete Message
The command deletes short messages from the preferred message storage <mem1> location <index>. If <delflag> is presented and not set to 0, then the ME shall ignore <index> and follow the rules of <delflag> shown as below
AT+CMGL List Message
The Read Command returns messages with status value <stat> from preferred message storage <mem1> to the TE. If the status of the message is “REC UNREAD”, the status in the storage changes to “REC READ”. When executing command AT+CMGL without status value <stat>, it will report the list of SMS with “REC UNREAD” status.
AT+CMGR Read Message
The Read Command returns SMS message with location value <index> from message storage <mem1> to the TE. If status of the message is “REC UNREAD”, status in the storage changes to “REC READ”.
AT+CMGS Send Message
The Write Command sends a short message from TE to network (SMS-SUBMIT). After invoking the write command, wait for the prompt “>” and then start to write the message. After that, enter <CTRL-Z> to indicate the ending of PDU and begin to send the message. Sending can be cancelled by giving <ESC> character. Abortion is acknowledged with “OK”, though the message will not be sent. The message reference <mr> is returned to the TE on successful message delivery. The value can be used to identify message upon unsolicited delivery status report result code
AT+CMMS More Message to Send
The command controls the continuity of the SMS relay protocol link. If the feature is enabled (and supported by the currently used network) multiple messages can be sent faster as the link is kept open.
AT+CMGW Write Message to Memory
The Write and Execution Commands store short messages from TE to memory storage <mem2>, and then the memory location <index> of the stored message is returned. Message status will be set to “stored unsent” by default, but parameter <stat> also allows other status values to be given.
The syntax of input text is the same as the one specified in AT+CMGS Write Command.
AT+CMSS Send Message from Storage
The Write Command sends messages with location value <index> from message storage <mem2> to the network. If a new recipient address <da> is given for SMS-SUBMIT, it shall be used instead of the one stored with the message.
AT+CNMA New Message Acknowledgement to UE/TE
The Write and Execution Commands confirm successful receipt of a new message (SMS-DELIVER or SMS-STATUS-REPORT) routed directly to the TE. If the UE does not receive acknowledgement within required time (network timeout), it sends an RP-ERROR message to the network. The UE will automatically disable routing to the TE by setting both <mt> and <ds> values of AT+CNMI to 0.
AT+CNMI SMS Event Reporting Configuration
The Write Command selects the procedure on how the received new messages from the network are indicated to the TE when TE is active, e.g. DTR is at low level (ON). If TE is inactive (e.g. DTR is at high level (OFF)), message receiving should be done as specified in 3GPP TS 23.038.
AT+CSDH Show SMS Text Mode Parameters
The Write Command controls whether detailed header information is shown in text mode result codes
AT+CSMP Set SMS Text Mode Parameters
The command is used to set values for additional parameters needed when a short message is sent to the network or placed in a storage in text mode
AT+QCMGS Send Concatenated Messages
The command is used to send concatenated massages. Different from AT+CMGS, when sending a concatenated message via this command, each segment of the concatenated message must be identified by the additional parameters: <uid>, <msg_seg> and <msg_total>. When sending all segments of the message one by one, AT+QCMGS must be executed multiple times (equal to <msg_total>) for each segment. This command is only used in text mode (AT+CMGF=1).
AT+QCMGR Read Cocatenated Messages
The function of this command is similar to AT+CMGR, except that the message to be read is a segment of concatenated messages, and parameters <uid>, <msg_seg> and <msg_total> would be shown in the result. Several segments should be concatenated to a whole concatenated message according to these three parameters. Similar to AT+QCMGS, AT+QCMGR is only used in text mode (AT+CMGF=1).