Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

[Previous: Modem Emulator - GPRS] [Next: Modem Emulator - Ignored Commands]

Modem Emulator - Short Message Service

The AT commands in this section are used for accessing the Short Message Service (SMS) subsystem.

AT+CMGD Delete Message

The AT+CMGD command allows deletion of messages from the message store.

If the <delflag> parameter is present and non-zero, the <index> is ignored. Otherwise, the message at the location <index> is deleted.

Possible values for <delflag> are as follows:

Conforms with 3GPP TS 27.005.

AT+CMGF Message Format

The AT+CMGF command can be used to set the SMS message format to PDU (0) or text (1). The default is PDU.

Conforms with: 3GPP TS 27.005.

AT+CMGL List Messages

The AT+CMGL command returns messages with status <stat> from the message store to the TE. If the status of a message listed is "REC UNREAD", status of that message should change to "REC READ".

Note that <scts> is only shown if the message is incoming, and <alpha> is shown if the <address> has a corresponding entry in the PhoneBook. <address_type> and <body_length> are shown if AT+CSDH=1.

Does not conform entirely with 3GPP TS 27.005, since only text mode (AT+CMGF=1) command is supported.

AT+CMGR Read From Storage Area

This command is used to read an SMS message from a certain location of the message storage area.

Note that the response to the set command depends on whether the message stored at the given index is a message that was received by the MT or one that is to be (or has been) sent by the MT.

In the first case, it will contain a <service_centre_timestamp>, and if the second, it may contain a <validity_period>.

The <address> field will contain the sender's address if the message stored at the given index is a message that was received by the MT, and the recipient's address if the message stored at the given index is a message that is to be (or has been) sent by the MT.

The fields <address_type>, <TPDU_first_octet>, <protocol_identifier>, <data_coding_scheme>, <service_centre_address>, <service_centre_address_type>, <sms_message_body_length> and <validity_period> are optional, and enabled by the AT+CSDH command.

The <address_text> field is optional and contains the string associated with the <address> in the address book of the MT.

The <message_status> field can have the following values:

Does not conform completely with 3GPP TS 27.005; this implementation only allows reading of SMS messages in text mode (AT+CMGF=1).

AT+CMGS Send Message

The AT+CMGS command can be used to send SMS messages in either PDU (AT+CMGF=0) or text (AT+CMGF=1) mode.

Execution command sends the message to the network. The message reference value <mr> is returned to the TE upon successful message delivery.

Conforms with: 3GPP TS 27.005.

AT+CMGW Write Message to Memory

The AT+CMGW command stores a message to memory storage. The memory location <index> of the stored message is returned. By default, the message status will be set to "REC UNREAD", however other status values may be given.

Does not conform completely with 3GPP TS 27.005; in this implementation, SMS message may only be written in text mode.

AT+CMMS More Messages to Send

The AT+CMMS command can be used to inform the modem that several SMS messages will be sent in quick succession, and the link should be held open for more efficient transmission.

This implementation does not do anything special for this command. The underlying modem will hold the link open when it judges that it would be advantageous to do so.

Conforms with: 3GPP TS 27.005.

AT+CNMI New Message Indications to TE

The AT+CNMI command is used to select the procedure for how receiving new messages from the network is indicated to the TE when the TE is active.

When the TE is inactive, message receiving is done as specified in 3GPP TS 23.038.

This implementation is currently a dummy implementation; it does nothing, and always returns error.

Conforms with: 3GPP TS 27.005.

AT+CPMS Preferred Message Storage

The AT+CPMS command can be used to set the preferred message storage for reading and writing SMS messages. The only message storage that is supported by this implementation is SM.

Conforms with: 3GPP TS 27.007.

AT+CRES Restore Settings

The AT+CRES command restores SMS settings from EEPROM. This is not supported in this implementation.

This implementation does not conform with 3GPP TS 27.005.

AT+CSAS Save Settings

The AT+CSAS command saved SMS settings to EEPROM. This is not supported in this implementation.

This implementation does not conform with 3GPP TS 27.005.

AT+CSCA Service Center Address

The AT+CSCA command reads or modifies the SMS service center address on the SIM.

Set command updates the SMS service center address on the SIM. Read command reports the current SMS service center address on the SIM.

Conforms with 3GPP TS 27.005.

AT+CSDH Show Text Mode Parameters

The AT+CSDH command controls whether extended text mode parameters are shown in response to AT+CMGL and AT+CMGR commands in text mode.

Conforms with 3GPP TS 27.005.

AT+CSMP Set Text Mode Parameters

The AT+CSMP command sets the additional parameters that are passed in the header of an SMS message when sending messages in text mode (AT+CMGF=1).

This implementation always sends SMS messages with the default GSM values, irrespective of what is set with AT+CSMP. Applications should use PDU mode for sending messages with specific header values.

Conforms with 3GPP TS 27.005.

AT+CSMS Select Message Service

The AT+CSMS command selects the short message service to use.

This implementation says that it supports service 0 and 1, mobile-terminated messages, mobile-originated messages, and cell broadcast messages, irrespective of the underlying modem's message support. The underlying modem will select the correct service automatically.

Conforms with 3GPP TS 27.005.

[Previous: Modem Emulator - GPRS] [Next: Modem Emulator - Ignored Commands]