Table of Commands

<< Click to Display Table of Contents >>

 

Table of Commands

N1/B1

Command

Description

Type

Reading or Writing

Remarks

0

AT+CMGF = 1

SMS in text mode

Value not used

Writing

This Driver has the same functionality and is used the same way in both PDU and Text modes. The mode must be changed when the GSM modem lacks support for the currently selected mode

1

AT+CSCA = "<string>"

Writes SMS service center's address

String

Writing

 

2

AT+Cpin = <integer>

Enters PIN

Integer

Writing

 

3

AT+CMGD = <integer>

Deletes SMS message

Integer

Writing

This value contains a message's number

4

AT+CMGR = <integer>

Reads SMS message

String

Reading

The B2 parameter defines the index of the message to read. If it is equal to 0 (zero), this index is 1 (one). Returns a block of Strings. For more information, please check the notes

5

<string>[Ctrl-Z]

Sends SMS message (after "AT+CMGS = ...", Command 6)

String

Writing

Variable must be the message's String. Different command in PDU mode but with the same operation. For more information, please check the notes

6

AT+CMGS = "<string>"

Sends SMS message (preparation)

String

Writing

Variable must be the destination number (String). Different command in PDU mode but with the same operation. For more information, please check the notes

7

AT+CSQ

Reads signal quality

Integer

Reading

Please check the notes

8

AT+GMM

Requests TA model identification

String

Reading

 

9

AT+ICF?

Reads modem configuration

Integer

Reading

Returns a block of integers

10

AT+IPR?

Reads fixed local rate

Integer

Reading

 

11

AT+CPAS

Reads mobile equipment activity status

Integer

Reading

 

12

AT+COPS?

Reads operator selection

String

Reading

 

13

AT+CMGF?

Reads SMS message format

Integer

Reading

 

14

AT+CNMI?

Reads new SMS message indications

Integer

Reading

 

15

AT+CSCA?

Reads SMS service center address

String

Reading

 

16

AT+GSN

Requests TA serial number identification (IMEI)

String

Reading

 

17

AT+CIMI

Requests international mobile subscriber identity

String

Reading

 

18

AT+CMGL = "ALL" (Text mode)

AT+CMGL = 4 (four, PDU mode)

Reads all SMS messages

String

Reading

Returns a block of Strings. Different command in PDU mode but with the same operation. For more information, please check the next note

19

AT+Cpin = "<integer>"

Enters PIN with quotation marks

Integer

Writing

 

20

AT+CFUN?

Reads current functionality level

Integer

Reading

Possible values are 0: Minimum functionality or 1: Full functionality. For other values, please check the device's manual to interpret all valid values

21

AT+CFUN = <integer>

Sets functionality level

Integer

Writing

Same as above

22

AT+CMGF = 0 (zero)

SMS in PDU mode

Value not used

Writing

This Driver has the same functionality and is used the same way in both PDU and Text modes. The mode must be changed when the GSM modem lacks support for the currently selected mode

9999

 

Reads the response of the last writing command

Integer

Reading

Useful to get the result of a writing command

 

NOTES

The signal quality command can be seen in a Block Tag with two Elements. The first Element is a number indicating signal's strength and the second Element is the bit error rate as a percentage. The value 99 is shown if that rate is unknown.

If there is one or more SMS messages, a list in Tag Reported by Events with N blocks is returned, where N is the number of message blocks received. If there are no messages, it returns a null list without generating an OnRead event. Users must have a Block Tag with as many Elements as message data returned by a modem. Please check E3 User's Manual to understand the concept of Tags Reported by Events.

When sending a text message in PDU mode, the Driver sends the AT+CMGS command together with an encoded hexadecimal String containing both the destination number and the message content with additional information necessary for sending it. Since the last destination number used is stored in this Driver, users can send multiple text messages, in Tag 5 (five), while only preparing once for each destination number, in Tag 6(six).

 

For example, a message in the following format:

+CMGL: 2,"REC READ","+555155555555",,"13/12/03,16:19:59-08"[0D][0A]Message[0D][0A]

 

Forms a Block Tag with seven Elements with the following structure:

Element 1: 2 (two, message index)

Element 2: REC READ (message status)

Element 3: +555155555555 (source number)

Element 4: <null> (no contact name)

Element 5: 13/12/03 (Date)

Element 6: 16:19:59-08 (Time)

Element 7: Message (SMS)

 

A message in PDU mode is in a different format, but the resulting Block Tag is the same.

Was this page useful?