You are on page 1of 105

4.

SOFTWARE INTERFACE

4.1 GENERAL
The operating functions of the g18 modem are implemented in the base unit into which the g18 is integrated. The g18 is a GSM900/1800/1900 Phase II+ device with GPRS capabilities. The corresponding functions are implemented conforming to V.25ter, GSM07.07, and GSM07.05.
The standards bodies regularly update these standards, therefore there is no guarantee that the commands supported by the g18 exactly conform to the latest versions of these specifications. Some commands listed in these standards do not apply in the GSM environment.

4.2 MODEM COMMUNICATION MODES


The g18 modem supports the following communications modes: voice, data, SMS and fax.

4.2.1

Voice Communication

Note

Analog Audio: Analog audio communication is provided via a standard analog headset such as the headset used with the StarTAC cellular phone. In this case, the controls for answering calls, dialing, and hanging up are provided by the AT command set interface. This mode is used if the modem is integrated into a handheld terminal that supports voice communications. Digital Audio: Digital audio is provided by the Motorola Proprietary DSC interface. This interface is used when an external handset, like that used in an automotive installation, is used. In this case, the call controls are provided on the handset. DSC handsets that support this interface are manufactured by and available from Motorola. The AT command set can also be used to control calls. The DSC interface is a Motorola proprietary feature that requires licensing from Motorola. Please contact your Motorola representative for more information.

AT+C commands conforming to GSM07.07 and GSM07.05 and a number of manufacturer-specific AT commands are available via the serial interface of the g18 for functionality implementation. Commands are input via the operating functions of the base unit. The base unit translates the operating functions into AT commands and the g18 executes the requested action.
You should wait to receive OK before sending a new AT command.
Note

The V.25ter modem guidelines apply to the time sequence of interference commands. In accordance with these guidelines, commands start with the string AT and end with a carriage return (<CR> or 0x0D). Commands are acknowledged with OK or ERROR. A command currently being processed will be interrupted by each subsequent incoming character, so the next command must not be sent until the acknowledgement has been received that the command has been processed. If this does happen, the current command will be cancelled.

4.2.1.1 Configuration Setup and Audio Routing in g18


Voice Connectivity The g18 is an OEM data and voice module. Voice connectivity can be performed using two main channels: analog voice and digital voice.

98-08901C39-A

27

Software Interface

The audio route for the different devices is described in the following table, where HF refers to the connected external speaker and microphone, and DHFA refers to the external car kit. Table 9. Voice Connectivity
Configuration Setup Off hook handset (overrides all other conditions) On hook handset, or absence of handset: HF + HF was selected by ATS96 command HF + HF was not selected by ATS96 command DHFA Headset + HF was selected by ATS96 command Headset + HF was not selected by AT command HF external speaker with echo cancelling HF external speaker, without echo cancelling DHFA speaker Headset with echo cancelling Headset without echo cancelling Audio Route to Handset

there will be a lot of echo (for example, in a hands-free device). Echo Cancel - Suppresses a large amount of the output sound picked up by the input device (cancels all echo). Noise Suppress - Improves audio quality in all modes. If the application uses the DSC bus, HF selection can be performed via the new IP. Table 11. Regular (HS) and HF Mode using DSC Bus
Characteristics Echo Cancelling (EC) Sidetone Regular Mode (Handset) Disable + HF mode + Enable Mute Disable +

Echo Suppression (ES) DSC Mic

+ Enable Mute

Table 10. Regular (HS) and HF Mode using RS232 To activate the hands free mode, see the following table:
Characteristics Echo Cancelling (EC) Sidetone Regular Mode (Handset) Disable + HF mode + Enable Mute ATS96 = 0 Echo Suppression (ES) + Enable Full Duplex Disable Default Half Duplex

Table 12. HF Mode Selection using AT Commands


Command ATS96 = 1 Description Hands free mode ON Hands free mode OFF Hands free mode OFF Notes + Enable Mute Once the HF has been set, the setting is kept in the flex even after power cycling the g18.

Sidetone - Reduces the microphone audio input that is routed to the selected speaker so that the people speaking will hear themselves talking. This also creates a slight echo because the speaker sound then gets picked up again by the microphone and again output to the speaker, and so on. Echo suppress is designed to take care of this echo. Echo Suppress - Cancels a small amount of the output sound picked up by the input device (suppresses the echo). It is designed to be used where there will be little or no echo (for example, in a handset) rather than where

4.2.2

Data Communication

There are two modes in which to use the data port: GPRS: This mode is for package data communication. This mode starts from the command mode and after an initialization of a PDP context the data sent from the DTE will be over PPP. A GPRS wizard is available to do the

28

98-08901C39-A

Software Interface

PDP connectivity (for PC applications). This is a very effective tool for transferring data at a high rate and only when data is available, without the need to dial again. CSD - Circuit Switch Data: The default setting for the g18 is RS232 full flow control. In this mode, data, SMS and Fax class 1 are transferred using a full flow control (hardware flow control), Xon/Xoff or non-flow control. The main difference between this mode and the GPRS mode is the need to dial the desired number whenever data needs to be transferred.
The g18 does not support non-transparent CSD with a baud rate of less than 4800 bps.
Note

4.2.3

SMS Communication

Block mode: This is a binary SMS presentation. An application SMS build is required for this mode. Text mode: This mode is not supported by the g18. PDU mode: This is the recommended mode for SMS communications. Note that the PDU packet has a complex structure, so careful examination of GSM 04.11 and GSM 03.40 is required.

4.2.4

Fax Communication

Table 13. Features Supported using CSD/GPRS


CSD Flow Control HW Xon/Xoff None Transparent Non transparent SMS PDU mode SMS Block mode Class 1 Supports HW Xon/Xoff None Data over PPP Class 1, 2 and 4 1 uplink 1,2 or 3 downlinks CS1, CS2, CS3, CS4 Supports

Class 1: This is the basic set of fax commands that is supported by all types of fax machines. To support fax communication with g18, use WinFax in your computer. Class 2: This mode is not supported by the g18.

4.3 BASIC OPERATIONS 4.3.1 Making a Voice Call


Enter the PIN number which enables the SIM card (4-8 digits). Initiates the voice call to the remote phone. The voice communications commence. Phone book storage should first be selected at+cpbs=sm. Phone number corresponding to the name entered. Phone number from register #1 after setting at&z1=035658452. Phone number from register #0 after setting at&z1=035658452. Phone number from SIM card #101, for example, ATD>SM101. Note: Only the second OK for the voice call notifies the user that the call is established. Hangs up the voice call. Note: In multi-party calls, ATH does not end the last call, only AT+CHLD=1 does.

Data Type

AT+CPIN=nnnn SMS

Fax GPRS Flow Control

ATDnnnnnn OR

AT*Dnnnnn OR ATD><index> OR ATD>name OR ATDS=n (n=0 to 3) OR ATDS=n (n=0 to 3) OR ATD><mem><ind ex>

Data Type Multi Slot

Coding Schemes

ATH

98-08901C39-A

29

Software Interface

4.3.2

Receiving a Voice Call


Enter the PIN number that enables the SIM Card (4 -8 digits). Enables cellular result codes extended format. A remote phone dials the g18 voice number. If AT+CRC=1, VOICE indicates an incoming voice call. If AT+CRC=0 then +RING indicates an incoming call. Note: To retrieve the call type, use the CMER command. Answers the call

4.3.5

Receiving a Data Call

AT+CPIN=nnnn

The remote modem dials the g18 data number. AT+CRC=1 Enables cellular result codes extended format. The remote phone dials the g18 voice number. If AT+CRC=1, DATA indicates an incoming data call.

AT+CRC=1

+CRING:VOICE or +RING

+CRING: REL ASYNC or +RING

If AT+CRC=0, then +RING indicates an incoming call. Note: To retrieve the call type, use the CMER command. Answers manually. ATS0=1 enables an automatic answer after one ring. Escapes from Online mode. Hangs up call. Note: In multi-party calls, ATH does not end the last call, only AT+CHLD=1 does.

ATA ATA

4.3.3

Commencing Voice Communication


Hangs up. Call ends. Note: In multi-party calls, ATH does not end the last call, only AT+CHLD=1 does.

+++ ATH or AT+CHUP

ATH or AT+CHUP

If the remote phone hangs up first, the modem will stay online, (AT+CPAS returns +CPAS:004) for approximately 60 seconds, at which point it will time out and the call will be cleared (AT+CPAS returns +CPAS: 000). At any time during this period, the modem can execute an ATH command.

If the remote phone hangs up first, the modem will stay online (+CPAS:004) for approximately 60 seconds, at which point it will time out and the call will be cleared (+CPAS: 000). At any time during this period, the modem can execute an ATH command.

4.3.6 4.3.4 Making a CSD - Data Call


Dials the remote modem. Indicates that the connection is made. Proceeds with data communications. Escapes to Command mode. Returns to Online mode. Escapes to Command mode. Hangs up the connection.

Enabling Cell Broadcast (CB) Reception

Send AT+CKPD=M>>S>>>>>S<SCC
ATDnnnnnnn CONNECT xxxx

In order to receive the CB message on the TE, use the AT+CNMI command. For example: AT+CNMI=0,2,2,0,0

+++ ATO +++ ATH or AT+CHUP

30

98-08901C39-A

Software Interface

4.3.7

Setting Up the g18 in CSD Mode

When the modem is ready to accept more data, it sets the CTS signal to Active Low again.

When a data call is received, the RI signal goes to Active Low for one second and then to Inactive High for four seconds repeatedly, as shown below.

Figure 32. RI Waveform Figure 34. g18 Sending Data Hardware Flow Control

When a data carrier is detected by the g18, it sets the DCD signal to Active Low.
The g18 does not support non-transparent CSD with a baud rate of less than 4800 bps.
Note

4.4.1.2 Receiving Data


When data is received by the g18, the only dynamic signal during the data transfer is RXD, with which the data is sent to the terminal. The DTE device should keep DTR ON. RTS can be used to alert the g18 that the DTE buffer is full.

Figure 33. g18 Receiving a Data Call

4.4 SENDING AND RECEIVING DATA IN DIFFERENT FLOW CONTROLS 4.4.1 Flow Control Set to Hardware Flow Control (FC)

Figure 35. g18 Receiving Data Hardware Flow Control

4.4.2

Flow Control - Flow Control Set to Xon/Xoff

4.4.1.1 Sending Data


When data is sent by the g18, the only dynamic signals through the data transfer are TXD and CTS. The DTE device should be kept at DTR ON. TXD is used in order to transmit the data from the terminal to the g18, and CTS is used in order to control the data flow. When data is transferred too rapidly to the modem, at a rate which is greater than its transfer rate, and its buffers become full, the modem sets CTS to Inactive High, until it completes the transfer.

The g18 should be configured to Xon/Xoff flow control, using AT&K4. To return to the hardware flow control, use AT&K3.

4.4.2.1 Sending Data


When data is sent in this mode, it is transferred on the TXD line. The DTE device should keep DTR ON. When data is transferred too rapidly to the modem, its buffers may become full, and the transmission cannot succeed. In this case, it sends an Xoff signal to the terminal on the RXD line. When the modem has sent the data in the buffer and is ready to receive more data, it sends an Xon signal on the RXD line.

98-08901C39-A

31

Software Interface

4.4.3.1 Sending Data


When data is sent in this mode, it is transferred on the TXD line, and there is no flow control. The DTE device should keep DTR ON. When the modem cannot keep up with the rate of data transmission from the terminal, an error occurs. Figure 36. Sending Data Xon/Xoff

4.4.2.2 Receiving Data


When data is received in Xon/Xoff flow control, the data is transferred from the g18 to the terminal on the RXD line. The DTE device should keep DTR ON. Figure 38. Sending Data in None FC

4.4.3.2 Receiving Data


When data is received by the g18, the only dynamic signal during the data transfer is RXD, with which the data is sent to the terminal. The DTE device should keep DTR ON. Figure 37. g18 Receiving Data Xon/Xoff

Note

In the figure above, the Z Modem transfer protocol was used, with crash recovery setup. When an error is encountered, the terminal sends a message to the sending side, asking it to resend the specific block.

Figure 39. g18 Receiving Data in None FC

4.4.3

Flow Control Set to None

4.5 CALL WAITING, CALL FORWARDING, AND CONFERENCE CALLS


These operations are network dependent, and are not supported by some networks. Some networks behave unexpectedly, such as roaming or call dropout.

The g18 should be configured to Xon/Xoff, using AT&K0. To return to the hardware flow control, use AT&K3.
Note

32

98-08901C39-A

Software Interface

4.6 SENDING AN SMS 4.6.1 Sending an SMS in PDU Mode


Enter the PIN number that enables the SIM card (4 - 8 digits). Select message service response. The response will be +CSMS:001,001,001. Select preferred message storage. The response will be similar to +CPMS:001,0015,001,01 5, depending on your SIM card.
Note

The message is terminated with a Control-Z character (0x1A).

AT+CMGS=19 >07914483056100F511000B914410927856F40000000541 E190F804<CTRL-Z> 07 = LENGTH OF SCA element including the TON/NPI 91 = TON/NPI,TON=9=Type of number, NPI=1=Numbering Plan Identifier 4483056100F5 SCA =SERVICE CENTER ADDRESS (This means that the real phone number for the SCA is 44-385-016-005). Explanation of phone number coding: One hexadecimal digit for each phone number digit is used. Each pair of hexadecimal digits is considered an octet (8 bit binary number). Then, the two hexadecimal digits are reversed in order to form a semi-octet. So, the phone digits 3, 8 will become 0x3, 0x8, then 0x38, and then reversed to become 0x83. The ASCII characters 8 and 3, the string 83 are then inserted into the full ASCII string above. Since there is an odd number of digits, the last digit, 5, is placed in the lower nibble of the last octet and then its top nibble is filled with 1s. This means that 5 becomes 0x5, then 0x05, then 0xf5, and then f5, which are the last two characters in the Service Center address. Refer to ETSI 04.11 for more details. Looking at the remainder of the message after the SCA, we find the Transport Protocol Data Unit (TPDU). The TPDU contains the destination device address (phone number), and the user data or message. There are 38 characters, which represent 19 octets, this being the length of the TPDU. 11000B914410927856F40000000541E190F804 = TPDU 11 = 8 bits MTI,RD,VPF,SRR,UDHI,RP,MMS,SRI 00 = MR Message Reference 0B914410927856F4 = DA Transport Destination Address 0B = Number of digits (11) in phone number 91=TON/NPI (as above) 4410927856F4 = Destination phone number 44-012-987-654
The destination phone number is converted to an ASCII string in the same manner as the SCA.

AT+CPIN=nnnn

AT+CSMS=0

AT+CPMS=SM

AT+CMGS= <length of TPDU><cr> <SCA><TPDU><ctrl-Z> <SCA>: Service Center Address, refer to GSM 04.11 <TPDU>: Transport Protocol Data Unit, refer to GSM 03.40

For example: AT+CMGS=19 >07914483056100F511000B914410927856F40000000541 E1905804<0x1A> will return +CMGS:000 after sending ABCDE to phone number 44-012-987-654 via the SMS center at 44-385-016-005.
This is an example only. This particular SMS center is a UK number.
Note

The following ASCII string is the ASCII representation of the hexadecimal values that will be transmitted as a binary string. F4 below means that the hexadecimal values 0xF and 0x4 will be transmitted over the air. CMGS=19 is the length of the TPDU in octets, see below.

Note

98-08901C39-A

33

Software Interface

The user data control information and the user data follow the phone number: 0000000541e190f804 00 = PID Protocol ID 00 = DCS Data Coding Scheme 00 = VP Validity Period 05 = UDL User Data Length 41E190F804 = The user data ABCDE Description of encoding the user data: The user data is encoded as GSM characters. The GSM character set is a method of encoding 7 bit ASCII characters into 8 bit numbers. GSM only supports 128 characters with ASCII values 0x00 to 0x7f. Since these only need 7 bits to define them, and the SMS message is transmitted as a series of 8-bit values, GSM uses a method of packing the series of 7 bit values into 8 bit octets. For example: ABCDE is encoded as 41E190F804 as follows. A B C D E in ASCII hexadecimal is: 0x41 0x42 0x43 0x44 0x45 in 8 bit binary is: 01000001 01000010 01000011 01000100 01000101 The most significant bit is truncated, resulting in a series of seven bit values. The now unused most significant bit(s) are packed with enough least significant bits from the following value to make up eight bits.

4.6.3

Sending an SMS in CSD Mode

When sending an SMS in PDU mode, after executing the at+cmgs=n command, the DCD line goes to Active Low, and the data is transferred on the TXD line. After executing the <Ctrl+Z> command, the DCD line returns to Active High, and the message is sent via the phone.

Figure 40. Sending an SMS

4.6.4

Receiving an SMS
Enter the PIN which enables the SIM card (4 -8 digits). Selects the message service. Selects the preferred message storage. Allows buffering of unsolicited result codes in the TA. Indication of memory location is routed to TE. Is displayed (001 message location).

AT+CPIN="nnnn"

AT+CSMS=0 AT+CPMS="SM"

AT+CNMI=0,1

This results in the string of eight-bit hexadecimal numbers 0x41, 0xE1, 0x90, 0x58, 0x04. By continuing this process, a string of 160 ASCII characters can be stored as a string of 140 bytes (octets). The Service Center Address is described in ETSI GSM 04.11. The Transport Protocol Data Unit is described in ETS GSM 03.40.
Sending and receiving of SMS messages interfere with each other when the time interval between them is too short, or when both operations take place simultaneously.

+CMTI: "SM",001

To display incoming messages: AT+CMGL=4 AT+CMGR=1 Lists all the stored messages. Reads the message at location 001.

Note

4.6.2

Sending an SMS in PDU Mode Wave Forms


98-08901C39-A

34

Software Interface

+CMGR: 000,,102 0380214304028021000069905 02100000064D227925804994 0D321F21A946A4153F45B4E 0735CBF379F85C064DCB727 B7A5C0651CB73BA0B444597 41D17A7ABC0609E5EFBB1B 647CE341CA7A1B3E073DED 6539888A2E8398617D1E447C 9F5DA0986C46ABD96EB81C 4C01. OK.

This is a string of GSM characters, which must be translated back into ASCII. The process is the reverse of the coding process described previously. This converts the characters back from a series of octets to a series of 7 bit ASCII numbers. Looking at the first 6 octets:

Once the message has been received, the next step is to decode it into something comprehensible. This particular message is generated by a Rohde and Schwarz CMD55 GSM Test station. In the first line of data, we see the information about the service center, followed by the TPDU. 038021430402802100006990502100000064D2279258049 940D321F21A946A4 03 = Length of service center address 80 = Type of number = unknown, number plan identifier = unknown 2143 = Service center address = 1234 04 = MTI = SMS-DELIVER, MMS = no more messages, SRI = no status report UDHI = no UD header, RP = reply path not set 02 = OA length 80 =TON = unknown, NPI = unknown 21 = OA = 12 00 = PID =Protocol ID 00 = DCS = Data Coding Scheme 69905021000000=SCTS Service Center Time Stamp = 5th Sept. 1996 12:00:00 GMT 64=UDL=User Data Length=100 octets Following is the user data: D2279258049940D321F21A946A4153F45B4E0735CBF3 79F85C064DCB727B7A5C0651CB73BA0B44459741D1 7A7ABC0609E5EFBB1B647CE341CA7A1B3E073DED6 539888A2E8398617D1E447C9F5DA0986C46ABD96EB 81C4C01

This decoding process continues for the entire user data string. Translating the entire string comes up with ROHDE & SCHWARZ THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG.

4.6.5

Sending and Receiving Binary Data Via SMS

Your specific application may require binary data to be sent, instead of an ASCII text message. In this case, you can simply insert your raw data as the user data, instead of using the GSM character coding process. This limits you to 140 octets of data. So long as your application controls the encoding and decoding of the SMS PDUs at either end of the solution, you can use the 140 octets of user data as you see fit.

4.6.6

Receiving an SMS in CSD Mode Wave Forms

When an SMS is received, it is stored on the SIM card. Figure 41 shows a reading command sent on the TXD line, and the message transferred from the SIM card to the terminal.

Figure 41. Receiving an SMS

98-08901C39-A

35

Software Interface

4.6.6.1 SMS Error Messages


Message Types #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define MMISMS_MSG_TYPE_LIST_REQUEST MMISMS_MSG_TYPE_GET_MESSAGE MMISMS_MSG_TYPE_GET_FIRST_MESSAGE MMISMS_MSG_TYPE_GET_NEXT_MESSGAE MMISMS_MSG_TYPE_TRANSFER_INC_SMS MMISMS_MSG_TYPE_INDICATE_INC_SMS MMISMS_MSG_TYPE_TRANSFER_INC_CBS MMISMS_MSG_TYPE_INSERT_SMS MMISMS_MSG_TYPE_DELETE_MESSAGE MMISMS_MSG_TYPE_TE_UNABLE_TO_PROCESS MMISMS_MSG_TYPE_TE_SET_MESSAGE_REQUEST MMISMS_MSG_TYPE_TE_BEGIN_SMS_MODE MMISMS_MSG_TYPE_TE_END_SMS_MODE MMISMS_MSG_TYPE_ACKNOWLEDGE_MESSAGE MMISMS_MSG_TYPE_MESSAGE_LIST MMISMS_MSG_TYPE_MESSAGE MMISMS_MSG_TYPE_GET_MESSAGE_FAILURE MMISMS_MSG_TYPE_INC_MESSAGE MMISMS_MSG_TYPE_MESSAGE_ARRIVED MMISMS_MSG_TYPE_INSERT_SMS_COMPLETE MMISMS_MSG_TYPE_INSERT_SMS_FAILURE MMISMS_MSG_TYPE_DELETE_MESSAGE_COMPLETE MMISMS_MSG_TYPE_DELETE_MESSAGE_FAILURE MMISMS_MSG_TYPE_MT_UNABLE_TO_PROCESS 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x1d 0x1e 0x1f 0x20 0x21 0x22 0x23 0x24 0x25 0x26 0x27 0x28 0x29 38 Added to support 07.05

36

98-08901C39-A

Software Interface

Message Types #define #define #define #define MMISMS_MSG_TYPE_REQUEST_CONFIRMED MMISMS_MSG_TYPE_SET_MESSAGE_CONFIRMED MMISMS_MSG_TYPE_SET_MESSAGE_FAIL_CONFIRMED MMISMS_MSG_TYPE_MT_END_SMS_MODE 0x2a 0x2b 0x2c 0x3f

Information Element Identifier #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define MMISMS_IEI_SHORT_MSG_REF MMISMS_IEI_TRANSFER_TYPE MMISMS_IEI_INDICATE_TYPE MMISMS_IEI_INSERT_TYPE MMISMS_IEI_SHORT_MSG_INDEX MMISMS_IEI_CBS_SHORT_MSG_INDEX MMISMS_IEI_SHORT_MSG_DATA MMISMS_IEI_CBS_SHORT_MSG_DATA MMISMS_IEI_CAUSE MMISMS_IEI_INDEX_COUNT MMISMS_IEI_CBS_TRANSFER_TYPE MMISMS_IEI_PAGE_INDEX MMISMS_IEI_LAST_SHORT_MSG MMISMS_IEI_CONFIRM_TYPE MMISMS_IEI_TP_FAILURE_CAUSE 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x0B 0x0C 0x0D 0x0E

98-08901C39-A

37

Software Interface

Transfer CBS Types #define #define #define #define #define #define MMISMS_CBS_TRANSFER_TYPE_NO_CBS MMISMS_CBS_TRANSFER_TYPE_TE_SPECIFIC MMISMS_CBS_TRANSFER_TYPE_RESERVED MMISMS_CBS_TRANSFER_TYPE_ALL_CBS MMISMS_CBS_TRANSFER_TYPE_BIT_MASK MMISMS_CBS_TRANSFER_TYPE_RESERVED_BIT_MASK 0x00 0x01 0x02 0x03 0x03 0xFC first two bits bits 3 to 8

Indicate Types #define #define #define #define #define #define #define #define #define #define #define #define MMISMS_INDICATE_TYPE_NO_MSG MMISMS_INDICATE_TYPE_RESERVED MMISMS_INDICATE_TYPE_ALL_SMS MMISMS_INDICATE_TYPE_TE_SPECIFIC_SMS MMISMS_INDICATE_TYPE_ALL_CBS MMISMS_INDICATE_TYPE_TE_SPECIFIC_CBS MMISMS_INDICATE_TYPE_ALL_CBS_SMS MMISMS_INDICATE_TYPE_ALL_TE_SPECIFIC_MSG MMISMS_INDICATE_TYPE_REPORT MMISMS_INDICATE_TYPE_BIT_MASK MMISMS_INDICATE_TYPE_REPORT_BIT_MASK MMISMS_INDICATE_TYPE_RESERVED_BIT_MASK 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x07 0x08 0xF0 first three bits fourth bit bits 5 to 8

38

98-08901C39-A

Software Interface

Cause Values #define #define #define #define #define #define #define #define MMISMS_CAUSE_NO_SUCH_MESSAGE MMISMS_CAUSE_NO_MEMORY MMISMS_CAUSE_NO_AIR_INTERFACE MMISMS_CAUSE_RECEIVING_ENTITY_BUSY MMISMS_CAUSE_COMMAND_NOT_UNDERSTOOD MMISMS_CAUSE_INCOMING_DATA_CALL MMISMS_CAUSE_USER_INVOKED_EXIT MMISMS_CAUSE_MESSAGE_TRANSFER_FAILED 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x87

Short Message Statuses #define #define #define #define #define #define MMISMS_STATUS_NOT_READ MMISMS_STATUS_NOT_SENT MMISMS_STATUS_NOT_READ_SENT MMISMS_STATUS_READ MMISMS_STATUS_SENT MMISMS_STATUS_READ_SENT 0x00 0x00 0x00 0x01 0x01 0x01

Confirm Types #define #define #define #define #define MMISMS_CONFIRM_TYPE_BEGIN_SMS_REQ_CNF MMISMS_CONFIRM_TYPE_TRANSFER_INC_SMS_REQ_CNF MMISMS_CONFIRM_TYPE_TRANSFER_INC_CBS_REQ_CNF MMISMS_CONFIRM_TYPE_INDICATE_INC_SMS_REQ_CNF MMISMS_CONFIRM_TYPE_ATTEMPT_SEND_SMS_REQ_CNF 0x00 0x01 0x02 0x03 0x04 Added to support 07.05

98-08901C39-A

39

Software Interface

Number of SMS Message Headers per Page #define #define #define MMISMS_NUM_HEADERS_PER_PAGE MMISMS_MIN_PAGE_INDEX MMISMS_MAX_PAGE_INDEX 5 1 51

Text Mode and PDU Mode Error Values #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define MMISMS_ERROR_ME_FAILURE MMISMS_ERROR_ME_SMS_SERVICE_RESERVED MMISMS_ERROR_OPERATION_NOT_ALLOWED MMISMS_ERROR_OPERATION_NOT_SUPPORTED MMISMS_ERROR_INVALID_PDU_MODE_PARAMETER MMISMS_ERROR_INVALID_TEXT_MODE_PARAMETER MMISMS_ERROR_SIM_NOT_INSERTED MMISMS_ERROR_SIM_PIN_NECESSARY MMISMS_ERROR_PH_SIM_PIN_NECESSARY MMISMS_ERROR_SIM_FAILURE MMISMS_ERROR_SIM_BUSY MMISMS_ERROR_SIM_WRONG MMISMS_ERROR_MEMORY_FAILURE MMISMS_ERROR_INVALID_MEMORY_INDEX MMISMS_ERROR_MEMORY_FULL MMISMS_ERROR_SMSC_ADDRESS_UNKNOWN MMISMS_ERROR_NO_NETWORK_SERVICE MMISMS_ERROR_NETWORK_TIMEOUT MMISMS_ERROR_UNKNOWN_ERROR 300 301 302 303 304 305 310 311 312 313 314 315 320 321 322 330 331 332 500

40

98-08901C39-A

Software Interface

Text Mode and PDU Mode Error Values (Continued) #define MMISMS_SUCCESS 512

#define

TD_SMS_RP_CAUSE_MASK

127

0x7F (MSB of RP-Cause is an ext bit)

#define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define #define

TD_SMS_RP_CAUSE_NUM_MO_RP_CAUSES TD_SMS_RP_CAUSE_NUM_MT_RP_CAUSES TD_SMS_RP_CAUSE_UNASSIGNED_NUMBER TD_SMS_RP_CAUSE_OPERATOR_BARRING TD_SMS_RP_CAUSE_CALL_BARRED TD_SMS_RP_CAUSE_SM_TRANSFER_REJECTED TD_SMS_RP_CAUSE_MEMORY_CAPACITY_EXCEEDED TD_SMS_RP_CAUSE_DESTINATION_OUT_OF_ORDER TD_SMS_RP_CAUSE_UNIDENTIFIED_SUBSCRIBER TD_SMS_RP_CAUSE_FACILITY_REJECTED TD_SMS_RP_CAUSE_UNKNOWN_SUBSCRIBER TD_SMS_RP_CAUSE_NETWORK_OUT_OF_ORDER TD_SMS_RP_CAUSE_TEMPORARY_FAILURE TD_SMS_RP_CAUSE_CONGESTION TD_SMS_RP_CAUSE_NO_RESOURCES TD_SMS_RP_CAUSE_FACILITY_NOT_SUBSCRIBED TD_SMS_RP_CAUSE_FACILITY_NOT_IMPLEMENTED TD_SMS_RP_CAUSE_INVALID_RP_MR TD_SMS_RP_CAUSE_SEMANTICAL_ERROR TD_SMS_RP_CAUSE_MANDATORY_IE_ERROR

22 8 1 8 10 21 22 27 28 29 30 38 41 42 47 50 69 81 95 96 Bad RP-MR Error in an IE Mandatory IE missing/ has error (MT specific)

98-08901C39-A

41

Software Interface

#define

TD_SMS_RP_CAUSE_RP_MT_NOT_IMPLEMENTED

97

Specific message type not supported RP-MT not compatible with SM-RL state IE missing or nonexistent Protocol error unspecified

#define

TD_SMS_RP_CAUSE_BAD_STATE

98

#define

TD_SMS_RP_CAUSE_IE_NOT_IMPLEMENTED

99

#define

TD_SMS_RP_CAUSE_UNSPECIFIED_ERROR

111

#define #define

TD_SMS_RP_CAUSE_INTERWORKING_ERROR TD_SMS_RP_CAUSE_SUCCESS

127 128 INTERNAL MOTOROLA DEFINITION INTERNAL MOTOROLA DEFINITION INTERNAL MOTOROLA DEFINITION INTERNAL MOTOROLA DEFINITION INTERNAL MOTOROLA DEFINITION

#define

TD_SMS_RP_CAUSE_SUCCESS_ACK

129

#define

TD_SMS_RP_CAUSE_NO_TRANSACTION_ID

253

#define

TD_SMS_RP_CAUSE_CM_INTERNAL_ERROR

254

#define

TD_SMS_RP_CAUSE_RL_TIMEOUT

255

SMS TIMERS #define TD_TIMER_LENGTHS_CMSMS_TC1M 20000 20 sec for both mob. orig. and mob. term. SMS CM 45 sec for SMS mobile originated relay layer TR1M timeout 35 sec for SMS memory available relay layer TRAM timeout 60 sec for "Message Read Now?" message window timeout msec msec

#define

TD_TIMER_LENGTHS_MMISMS_TR1M

45000

#define

TD_TIMER_LENGTHS_MMISMS_TRAM

35000

#define

TD_TIMER_LENGTHS_MMISMS_SHORTCUT_MSG_TIMEOUT

60000

#define #define

TD_TIMER_LENGTHS_MMISMS_TL_IP_ACK TD_TIMER_LENGTHS_MMIIPS_IP_RING_IND_VALUE

60000 5000

42

98-08901C39-A

Software Interface

SMS TIMERS #define #define TD_TIMER_LENGTHS_MMISMS_VIAG_SCAN MMISMS_SET_TR1M_TIMER 60000 (1) 60 sec timer in msec Used by send_timer method to determine which timer task port a timer primitive is sent to.

#define

MMISMS_RESET_TR1M_TIMER

(0)

4.6.7

Sending a Fax

4.6.7.1 Installing the Modem Driver


From the Control Panel, select Modems > Add modem > Next > (Windows finds "standard modem" on one of the COM ports) > Change > Have Disk > Enter the path to modem driver (for example, D:\motorola\modem) and select L-series > Next > Finish. (You may have to restart before using the modem.)

Using the AT+CGATT=1 command. You can check your connection status by using the AT+CGATT? command AT+CGDCONT=1,"IP","RTY","123.32.45.9 Following are the three main ways in which to activate PDP context: 1. If the GPRS Wizard application is used, double-click the button predefined as the dialer for this provider to automatically establish PDP context. If the g18 was not previously attached to GPRS, it will be attached automatically. Setup Configuration 1. Enter into the wizard parameters provided by your operator. 2. Set definitions to allow your http\ftp browser to use the g18 as a port to the Internet. Usage 1. Open the GPRS wizard. 2. Double-click the dialer icon to select and activate the provider of your choice (multiple providers may be displayed in the list). 3. After dialing, your temporary IP address and then the GPRS DATA session message will be displayed on the handset. 4. Minimize the GPRS wizard window and use your http\ftp browser (Internet Explorer, Netscape). 2. If you use AT commands to activate PDP context, you must perform the following steps: 1. Define the PDP contact (profile). For example: AT+CGDCONT=1,"IP","RTY"," 2. Define Quality of Service. For example: At+CGQREQ=3,2,4,5,8,12 3. Define minimum acceptable Quality of Service. For example: At+CGQMIN=1,0,0,0,0 4. Activate PDP context using the AT+CGACT=1 command.

4.6.7.2 Configuring the Modem in WinFax


1. 2. 3. Run WinFax. Select Tools > Program Setup > Modems and Communications Devices > Properties. Set Motorola L Series to Active (WinFax begins testing the modem and the result is Failed. This result is acceptable). Click Next and select CLASS 1 (Hardware Flow Control) > Next > Finish, set Default (or other) > OK . In the Modem and Communications Devices Properties window, click Properties. In General > Communications port, set the COM port to which the modem is connected and initialize it at 57600 bps.

4. 5. 6.

4.6.8

Establishing GPRS PDP Context

When using the GPRS Network for HTTP/FTP browsing, you must be attached to the GPRS Network before activating PDP context. Connection may be performed in one of the following two ways: Automatically after powering up your MS. The GPRS logo is displayed on your screen.

98-08901C39-A

43

Software Interface

Note

Bear in mind that the AT command AT+CGACT is not supported in all countries with GPRS. A GPRS connection is also possible with ATD*99#. See the following section for more information.

Note

When buffering the DTE message data in the g18 (both inbound and outbound data), the following apply: Turning off the g18 clears any buffered data. Removing power from the g18 clears any buffered data. Whenever the DTE drops the PPP connection with the g18, via LCP terminate, the buffered data is cleared. Whenever the g18 drops the PPP connection with the DTE, with LCP terminate, the buffered data is cleared. LCP termination triggers the termination of the data in the g18 buffer. Whenever the g18 drops the PPP connection with the DTE, without an LCP terminate, the buffered data is cleared. Dropping the DTR also clears the buffer. When the network sends a deactivation message or a detached message, the g18 buffer is cleared. When the g18 transfers data in the uplink and GPRS coverage is lost, the data may flow-off. If the mobile has lost coverage and is unable to send the packets from the DTE to the network, the buffers will continue to store the packets until the buffers are full. The DTE will then be flowed off and the packets will be stored until they can be sent to the GPRS network. The amount of time that takes before the user is notified is specified in the T3312 timer that is located in the mobile side. The default delay time of T3312 is 54 minutes, as per the GSM 0408 specification. After 54 minutes, the g18 deactivates the PDP session.

Setup Configuration AT+CGQMIN=1,0,0,0,0,0 AT+CGQREQ=1,0,0,0,0,0 AT+CGCONT=1,"IP","APN","0.0.0.0",0,0 // APN replace it with the provider name AT AT &F0 &D2 &C1 E0 AT V1 W1 S95=47 AT&K3 ATD*99#
The above list is only for the AT command level. PPP information (DNSs) is not shown here.
Note

3.

Using the ATD* command set: The GSM 07.07 version 7.5.0, Chapter 10.2.1.1 states: Request GPRS service 'D': D*<GPRS_SC>[*[called_address>][*[L2P][*<cid>]]] ]# The g18 supports TCP/IP protocol only, and this command can be used in the following format: ATD*99***(CID)# The CID includes the APN (defined by the AT+CGDCONT command) to which you want to be connected. (This depends on the ability of the SIM card to be attached to the different networks) The format ATD*99# may also be used. In this case, the g18 will first try to activate a non-empty (predefined) CID. If the attempt fails, the g18 will try the next CID, and so on. 3

You can now change the PIN number by using the +CPIN command as follows: AT+CPIN=Old PIN#, New PIN#

4.6.10

Writing into the Fix Dialing (FD) Phone Book

Send AT+CLCK="FD",2 (Query Status)

4.6.9
1

Changing the PIN Code Number

If the response is: +CLCK: 1,7Enter AT+CLCK="FD",0,"PIN2". After receiving OK, write operations are allowed in the FD area. If the response is: +CLCK: 0,7 enter AT+CLCK="FD",1,"PIN2", OK, then enter AT+CLCK="FD",0,"PIN2".

Check your CPIN status. If AT+CPIN? returns +CPIN: READY then proceed to the next step. If AT+CPIN? returns +CPIN: SIM PIN, enter the PIN number and recheck whether the status is READY. Check that AT+CLCK=SC,2 returns +CLCK: 1,7. If not, send AT+CLCK=SC,1, your PIN# command.

44

98-08901C39-A

Software Interface

After receiving OK, write operations are allowed in the FD area. at+cpbs="fd" OK at+cpbw=10,"123",,"time" ERROR at+clck="fd",2 +CLCK: 0,7 OK at+clck="fd",0,"7391" OK at+clck="fd",2 +CLCK: 0,7 OK at+cpbw=10,"123",,"time" OK The following is an example of a SIM card that is configured with the Fixed Dial number phonebook of 0 possible entries: at+cmee=2 OK at+clck=? +CLCK: ("CS","SC","AO","OI","OX","AI","IR","AB","AG","AC", "FD") OK at+clck="FD",2 +CLCK: 3,7 OK at+cpbs=? +CPBS: ("FD","LD","ME","MT","SM","DD","RC") OK at+clck="FD",0,"8625" OK at+clck="FD",2 +CLCK: 0,7 OK at+cpbs="FD" +CME ERROR: "operation not allowed"

Possible explanations could be Fixed Dial Phonebook not available or No memory space available on the SIM card for the fixed Dial Phonebook.

4.7 BASIC AT COMMANDS


Table 14 lists the basic AT commands for the g18 modem. Most of the basic commands are from the V.25ter reference. Commands shown in bold are factory defaults. The format of the command is: AT<command> For example: ATE0 will turn off the echo command.
To repeat the command, use the command A/ which will repeat the previous command. This is not prefixed with AT.

Note

Table 14. Basic Call Control Commands (Including V.25ter)


Command A Function Goes off-hook and attempts to answer a call. Dial modifier. For voice calls use ATDxxx; or AT*Dxxxx or ATD>102 or ATD>DAN or ATDS=1 or ATDS=0 or ATD>SM101. Turns off command echo. Turns on command echo. No action, compatibility only. Initiates a hang-up sequence. Reports product code. Reports pre-computed checksum. Reports processor name. Reports firmware revision. Reports product name.

Dn

E0 E1 F H I0 I1 I2 I3 I4

98-08901C39-A

45

Software Interface

Table 14. Basic Call Control Commands (Including V.25ter) (Continued)


Command I6 L M N P O Q0 Q1 Sn=x Sn? S0 Function Reports processor name. No action, compatibility only.

Table 14. Basic Call Control Commands (Including V.25ter) (Continued)


Command S95 Function Bitmap register for extended result code. Echo cancelling feature for audio devices by ATS96=1. Antenna diagnostic feature: ATS97? responds with 000 or 001. 000 means that either the antenna is not connected or the hardware does not support this feature. ATS98=1 allows the handsets backlight to behave as if the unit was not powered by using the TS line. It will turn off the backlight immediately, for the first time after powering up. Note: ATS98=x is allowed only for x=1. ATS99=x to define the length in ms of the hardware pulse given when the GPRS coverage is changed from no coverage to coverage. The pulse length is 2x when the data indication is sent. The default value is 30 ms; 0 value is not allowed. S99 responds with an error if the value is greater than 2,147,483,647 or equal to zero. ATS100=x, where x defines the number of seconds. To avoid frequent hardware interrupts, the g18 uses hardware indication for data only after x seconds from the last sent character to the DTE. The default value of x is 1 second; 0 value is not allowed. S100 responds with an error if the value is greater than 32,767 or equal to zero. Sets the wakeup line forever when x=1, and resets it when x=0. ATS101? returns the current state. These operations are allowed only when the factory bit is set. When the parameters are wrong, or the factory bit is not set, it returns an error. No action, compatibility only. Reports short form (terse) result codes.

S96 No action, compatibility only. No action, compatibility only. No action, compatibility only. Goes on-line. S98 Allows result codes to the DTE. Inhibits result codes to the DTE. Sets value x for S-register n. Returns the value of S-register n. Reads/sets the number of rings before Automatic Answer. Reads/sets Escape code character. Reads/sets Carriage return code character. Line feed code character. Command line editing character. Note: In command line editing, all characters with a hexadecimal value of 0 to $1F, except for Backspace, Line Feed and Carriage Return, are ignored. Wait time for data call carrier. ATS24=0 The g18 is not in sleep mode. ATS24=# The g18 is in sleep mode and will enter sleep mode after # seconds. Refer to How/When to Wake Up the Unit, page 15. Bit map registers. T V0 S101 S100 S99 S97

S2 S3

S4 S5

S7 S24

Sn for n equal to 14, 21, 22, 31, 36, 39, 40, 41

46

98-08901C39-A

Software Interface

Table 14. Basic Call Control Commands (Including V.25ter) (Continued)


Command V1 Function Reports long form (verbose) result codes. Reports DTE in Error Correction (EC) mode. Reports basic call progress result codes: OK, CONNECT, RING, NO CARRIER (also for busy, if enabled, and dial tone not detected), NO ANSWER, and ERROR. Reports basic call progress result codes and connection baud rates: OK, CONNECT, RING, NO CARRIER (also for busy, if enabled, and dial tone not detected), NO ANSWER, CONNECT XXXX, and ERROR. Reports all calls progress result codes and connection rates: OK, CONNECT, RING, NO CARRIER, NO ANSWER, CONNECT XXXX and ERROR. No action, compatibility only. Resets to default configuration. DCD is forced ON at all times. DCD is set to ON when the CSD carrier is detected or when the GPRS session is started. DCD is set to ON when the PDP is active and the IP address is received from the network. This command should not be used with a computer dial-up networking program. Interprets the DTR on-to-off transition. The modem ignores DTR. Interprets the DTR on-to-off transition. The modem performs as asynchronous to command mode.

Table 14. Basic Call Control Commands (Including V.25ter) (Continued)


Command &D2 Function Interprets the DTR on-to-off transition. The modem hangs up. Interprets the DTR on-to-off transition. The modem hangs up. Restores the factory configuration 0. Restores the factory configuration 1. No action, compatibility only. No action, compatibility only. Disables all DTE/DCE flow controls. Enables RTS/CTS DTE/DCE flow controls. Enables XON/XOFF DTE/DCE flow controls. Enables RTS/CTS DTE/DCE flow controls. No action, compatibility only. No action, compatibility only. No action, compatibility only. Selects a direct asynchronous mode. (This has no effect on the g1,8 since it only has a non-transparent mode.) Modem negotiates an error corrected link (default). (This has no effect on the g18, since it only has a non-transparent mode.) Selects an asynchronous operation in normal mode. (This has no effect on the g18, since it only has a non-transparent mode.) No action, compatibility only. Defines the DSR's behavior. (This is always active).

W0

&D3

X0

&F0 &F1 &G &J

X1

&K0 &K3

X4

&K4

&K6

Y Z &C0 &C1

&L &M &P &Q0

&C2

&Q5

&Q6

&D0

&D1

&R &S

98-08901C39-A

47

Software Interface

Table 14. Basic Call Control Commands (Including V.25ter) (Continued)


Command &T &V Function No action, compatibility only. Displays the current configuration and stores the profiles. Stores the active profile in NVRAM profile 0. Stores the active profile in NVRAM profile 1. Recalls the stored profile 0 upon power up. Recalls the stored profile 1 upon power up. Stores the dial string x (up to 35 characters) into location n = (0 to 3). Selects the direct mode. (This has no effect on the g18, since it only has a non-transparent mode.) Selects the reliable link mode. (This has no effect on the g18, since it only has a non-transparent mode.) Same as ATA. Dials voice call numbers. No action, compatibility only. No action, compatibility only. Repeats last command. Returns the value of the last updated S-Register. Lists the supported AT commands.

Table 15. Advanced AT Commands List


Command +CRTT +CIPE +CIP Function Selects ring tone. Enables/disables CIP command. Sends IP primitives over RS232 (IP primitives are messages used by the DSC bus). Selects the baud rate. Indicates the GPRS coverage. Supported for DTR line test command. Supported for CTS line test command. Supported for DTE wake line control command. Lists the messages without changing their attributes. Reads the message without changing its attributes. Changes the message attributes. Sends the message from storage.

&W0

&W1

+CBAUD +CGPRS +MTDTR +MTCTS +MCWAK E +MMGL

&Y0

&Y1

&Zn=x

\N1

+MMGR \N2

+MMGA +CMSS

AT*A AT*D AT*P AT*V A/ AT?

4.8 ERROR CORRECTION AND COMPRESSION (ECC) COMMANDS


The g18 modem supports the commands listed in Table 16. Table 16. Supported ECC Commands List
Command %C0 Function Disables data compression. (This has no effect on the g18, since it does not have compression.) Enables MNP 5 data compression. (This has no effect on the g18, since it does not have compression.)

AT$

%C1

48

98-08901C39-A

Software Interface

Table 16. Supported ECC Commands List (Continued)


%C2 Enables V.42 bis data compression. (This has no effect on the g18, since it does not have compression.) Enables both V.42 bis and MNP 5 compression. (This has no effect on the g18, since it does not have compression.) Sets the maximum block size in MNP to 64. Sets the maximum block size in MNP to 128.

4.10 ETSI 07.07 STANDARD


The following tables list the commands defined by ETSI standard 07.07 Phase 1, which are supported by the g18 modem. For a more detailed description of ETSI commands, refer to ETSI document GSM 07.07 prETS 300 916, GSM 07.05, GSM 03.40 Sections 9.1 and 9.2, GSM 04.11 Sections 8.2.5.1 and 8.2.5.2, and GSM 03.38. For each command it is recommended that you use the ? option to query the modem for the particular details of each command. For example, use AT+CR? to get the full details on the +CR command.

%C3

\A0

\A1

Table 18. General ETSI 07.07 Commands


\A2 Sets the maximum block size in MNP to 192. Sets the maximum block size in MNP to 256. Uses XON/XOFF flow controls. Not supported by the g18. Shows the status of the commands and S-Registers in effect. Command +CGMI Description Requests manufacturer identification Requests model identification Requests revision identification Requests product serial number identification Selects TE character set Requests international mobile subscriber identity Requests overall capabilities of TA Reference 5.1

\A3

\G

+CGMM

5.2

\S

+CGMR

5.3

+CGSN

5.4

4.9 FAX CLASS 1 COMMANDS


Table 17. FAX Class Commands
Command "FCLASS" Function Selects mode Remark +CIMI 0 data 1 fax Class 1 Class 1 Class 1 Class 1 Class 1 Class 1 Class 1 Class 1 +CSCS

5.5

5.6

+GCAP

"FAE" "FRH" "FRM" "FRS" "FTH" "FTM" "FTS"

fax_auto_answer fax_receive_hdlc_data fax_receive_data fax_receive_silence fax_transmit_hdlc_data fax_transmit_data fax_transmit_silence

V25ter section 6.1.9

Table 19. ETSI 07.07 Call Control Commands and Methods


Command +CSTA Description Selects type of address and selects dial characters allowed in dial string Reference 6.1

98-08901C39-A

49

Software Interface

Table 19. ETSI 07.07 Call Control Commands and Methods (Continued)
Command D Description Dial modes Dial modifiers for V.25ter dialing (TP!W,>IiGg) V.25ter: Direct dialing from phone books where x is the location Call mode Hangs-up call (similar to ATH) Selects bearer service type (baud rate, V110/ RLP, and so on.) Radio link protocol parameters Service reporting control (result codes) Extended error report (report failure reason of last call) Cellular result codes Call control commands Reference 6.2

Table 20. ETSI 07.07 Mobile Extended Error Report (Continued)


Command +CEER ERROR Description 21 Call rejected 22 Number changed 26 Non selected user clearing 27 Destination out of order 28 Invalid number format (incomplete number) 29 Facility rejected 30 Response to STATUS ENQUIRY 31 Normal, unspecified 34 No circuit/channel available 38 Network out of order 41 Temporary failure 42 Switching equipment congestion 43 Access information discarded 44 Requested circuit/channel unavailable 47 Resources unavailable, unspecified 49 Quality of Service unavailable 50 Requested facility not subscribed 55 Incoming calls barred within the CUG 57 Bearer capability not authorized 58 Bearer capability not presently available 63 Service or option not available, unspecified 65 Bearer service not implemented 69 Requested facility not implemented 70 Only restricted digital information bearer capability is available 79 Service or option not implemented, unspecified 81 Invalid transaction identifier value 87 User not member of CUG 88 Incompatible destination 91 Invalid transit network selection 95 Semantically incorrect message 96 Invalid mandatory information 97 Message type non-existent or not implemented 98 Message type not compatible with protocol state 99 Information element non-existent or not implemented 100 Conditional IE error 101 Message not compatible with protocol state

Dx

6.3

+CMOD +CHUP

6.4 6.5

+CBST

6.7

+CRLP

6.8

+CR

6.9

+CEER

6.10

+CRC ITU-T V.25ter

6.11 6.20

Table 20. ETSI 07.07 Mobile Extended Error Report

Command +CEER +CEER ERROR

Description Extended error report 1 Unassigned or unallocated number 3 No route to destination 6 Channel unacceptable 8 Operator determined barring 16 Normal call clearing 17 User busy 18 No user responding 19 User alerting, no answer

50

98-08901C39-A

Software Interface

Table 20. ETSI 07.07 Mobile Extended Error Report (Continued)


Command +CEER ERROR Description 102 Recovery on timer expiry 111 Protocol error, unspecified 127 Inter-working, unspecified

Table 22. ETSI 07.07 Mobile Equipment Control and Status Commands
Command + Description Phone activity status (off, on, online) Return Code - Meaning +CPAS:000 - Ready +CPAS:001Unavailable +CPAS:002 - Unknown +CPAS:003 - Ringing +CPAS:004 - Call in process +CPAS:005 - Asleep +CPIN Enter/change PIN (4 - 8 digits) Signal quality Mobile equipment control mode (optional if keypad and display not supported) Keypad control Display Control - upon sending AT+CMER=0,0,1 current text display report is received Indicator Control - upon sending AT+CMER=0,0,0,1 current indicator report is received Mobile equipment event reporting Selects phone book memory storage (optional if phone book not supported) Reads phone book entries Finds phone book entries 8.3 Reference 8.1

Table 21. ETSI 07.07 Network Service Related Commands


Command +CNUM +CREG +COPS Description Subscriber number Network registration GSM network operator selection Facility lock Changes password Calling line identification presentation Calling line identification restriction Call forwarding number and conditions Call waiting Call-related supplementary services Reject an incoming call, and divert it to the voice mail (not to another number) Advice of charge Lists current calls and asynchronous answers Preferred operator list Reference 7.1 7.2 7.3 +CSQ +CLCK +CPWD +CLIP 7.4 +CMEC 7.5 7.6 +CKPD 7.7 +CDIS*

8.5 8.6

8.7 8.8

+CLIR

+CCFC

7.10 +CIND

+CCWA +CHLD

7.11 7.12

8.9

+CTFR1*

7.13

+CMER

8.10

+CPBS 7.15 7.17 +CPBR 7.18 +CPBF

8.11

+CAOC +CLCC

8.12

+CPOL

*This command is based on the +CTFR standards.

8.13

98-08901C39-A

51

Software Interface

Table 22. ETSI 07.07 Mobile Equipment Control and Status Commands (Continued)
Command +CPBW Description Writes phone book entry Restricts SIM access Mute control use AT+CIP with IP_MUTE_REQ command for mute toggling Reference 8.14

Table 23. ETSI 07.07 Mobile Equipment Errors and Status Reports (Continued)
+CME ERROR 17 SIM PIN2 required 18 SIM PUK2 required 20 Memory full 21 Invalid index 22 Not found 23 Memory failure 24 Text string too long 25 Invalid characters in text string 26 Dial string too long 27 Invalid characters in dial string 30 No network service 31 Network time-out 32 Network not allowed emergency calls only 9.2

+CRSM +CMUT

8.18 8.24

*This command is not supported by the g18. To obtain +CDIS functionality, follow the instructions above. This command is not supported by the g18. To obtain +CIND functionality, follow the instructions above. This command is not supported by the g18. To obtain +CMUT functionality, use +CIP AT command, and follow the instructions above.

Table 23. ETSI 07.07 Mobile Equipment Errors and Status Reports
Command +CMEE Description Report mobile equipment error 0 Phone failure 1 No connection to phone 2 Phone-adaptor link reserved 3 Operation not allowed 4 Operation not supported 5 PH-SIM PIN required 6 PH-FSIM PIN required 7 PH-FSIM PUK required 10 SIM not inserted 11 SIM PIN required 12 SIM PUK required 13 SIM failure 14 SIM busy 15 SIM wrong 16 Incorrect password Reference 9.1

4.11 V.25TER COMMANDS USED WITH GSM


The following are the V.25ter commands that can be used with GSM. Table 24. V.25ter Commands Used with GSM
Command &C Description DCD (received line signal detector) behavior. DTR (data terminal ready) behavior. Set to factory-defined configuration. Request complete capabilities list. Request manufacturer identification. V.25ter Reference 6.2.8

+CME ERROR

9.2

&D

6.2.9

&F

6.1.2

+GCAP

6.1.9

+CGMI

6.1.4

52

98-08901C39-A

Software Interface

Table 24. V.25ter Commands Used with GSM (Continued)


Command +CGMM Description Request model identification. Request revision identification. Request product serial number ID (IMEI). Answer. Dial. Command echo. Hook control. Request identification information. Return to online data state. Automatic answer. Read/set escape code character. Command line termination character. Response formatting character. Command line editing character. Connection completion time-out. Sleep mode. Bit map registers. Note: S14 is a read only register. When trying to type it will return OK but value is not changed. 6.2.1 V.25ter Reference 6.1.5

Table 24. V.25ter Commands Used with GSM (Continued)


Command S95 Description Bitmap register for extended result code. Echo cancelling feature for audio devices by ATS96=1. After sending this command, the radio should be restarted to activate this feature. Antenna diagnostic feature: ATS97? will respond with 000 or 001. 000 means that either the antenna is not connected or the hardware does not support this feature. ATS98=1 allows the handsets backlight to behave as if the unit was not powered by using the TS line. It turns off the backlight immediately, for the first time after powering up. Note: ATS98=x is allowed only for x=1. ATS99=x, where x defines the length in ms of the hardware pulse given when GPRS coverage is changed from no coverage to coverage. The pulse length is 2x when data indication is sent. The default value is 30 ms; 0 value is not allowed. S99 responds with an error if the value is greater than 2,147,483,647. V.25ter Reference

+CGMR

6.1.6

S96

+CGSN

6.1.7

A D E H I

6.3.5 6.3.1 6.2.4 6.3.6 6.1.3

S97

S98 6.3.7

S0 S2

6.3.8

S3

S99

S4

6.2.2

S5

6.2.3

S7

6.3.10

S24 Sn for n equals to 14, 21, 22, 31, 36, 39, 40, 41

98-08901C39-A

53

Software Interface

Table 24. V.25ter Commands Used with GSM (Continued)


Command S100 Description ATS100=x, where x defines the number of seconds. To avoid frequent hardware interrupts, the g18 uses hardware indication for data only after x seconds from the time the last character was sent to the DTE. The default value of x is 1 second; 0 value is not allowed. S100 responds with an error if the value is greater than 32,767. Sets wakeup line forever when x=1, and resets it when x=0. ATS101? returns the current state. These operations are allowed only when the factory bit is set. When the parameters are incorrect, or the factory bit is not set, returns an error. DCE response format. Result code selection and call progress monitoring control. Restores stored profile 0 Restores stored profile 1 6.2.6 6.2.7 V.25ter Reference

Table 25. V.25ter Voice Commands (Continued)


Command ; Dial modifier A H Description Modifier for voice dial.

Voice answer. Voice hang-up.

4.12 ETSI 07.05 STANDARD (SMS)


The following tables list the complete set of commands as described in ETSI standard 07.05. For each command it is recommended that you use the ? option to query the modem for the particular details of each command. For example, use AT+CR? to get the full details on the +CR command. Block mode is a stand-alone mode that makes use of full text commands and responses to send and receive SMS messages. This is an older mode that is provided for compatibility reasons. It is recommended that PDU mode be used instead of block mode. Text mode is not supported by the modem. PDU mode is the preferred method since it is the simplest and easiest to use.

S101

4.12.1

Block Mode

V X

SMS block mode is described fully in GSM 07.05, section 2. Table 26. ETSI 0705 TE Commands Sent from Host to Phone
Command ACKNOWLEDGE MESSAGE Description Acknowledges receipt of INC MESSAGE or MESSAGE ARRIVED Deletes SMS message Terminates SMS/CBS mode of the DTE/DCE interface ETSI 07.05 Reference 2.4.1.12

Z0 Z1

6.1.1 6.1.1

Table 25. V.25ter Voice Commands


Command *A *D ATD*99 ATD*100 Description Voice answer. END SMS MODE Voice dial. Request GPRS service "D". Manually accepts a network request. DELETE MESSAGE

2.4.1.9

2.4.1.11

54

98-08901C39-A

Software Interface

Table 26. ETSI 0705 TE Commands Sent from Host to Phone (Continued)
Command GET FIRST MESSAGE Description Retrieves the first message stored on the phone Retrieves a specific message stored on the phone Retrieves the next message stored on the phone Requests notification of any incoming SMS messages Sends an SMS message Requests list of messages stored on the phone Requests direct transfer of broadcast messages directly to host computer Requests direct transfer of incoming SMS messages from the air directly to host computer Indicates that a phone message could not be processed ETSI 07.05 Reference

Table 27. ETSI07.05 MT Responses Sent from Phone to Host


Response Description Hosts request to delete a message has been completed Hosts request to delete a message has failed Phone is exiting SMS mode Request for a message cannot be fulfilled Incoming message transfer to host has been requested Hosts request to insert a message has been completed Hosts request to insert a message has failed Indicates a message has been requested Indication of incoming messages has been requested Indicates receipt of LIST REQUEST Request received and will be performed Hosts request could not be processed ETSI 07.05 Reference 2.4.2.8

2.4.1.3 DELETE MESSAGE COMPLETE 2.4.1.2 DELETE MESSAGE FAILURE END SMS MODE GET MESSAGE FAILURE INC MESSAGE 2.4.1.8

GET MESSAGE

2.4.2.9

GET NEXT MESSAGE

2.4.1.4

2.4.2.11

2.4.2.3

INDICATE INC SMS

2.4.1.6

2.4.2.4

INSERT SMS

INSERT SMS COMPLETE

2.4.2.6

LIST REQUEST

2.4.1.1 INSERT SMS FAILURE 2.4.1.7

2.4.2.7

TRANSFER INC CBS

MESSAGE

2.4.2.2

MESSAGE ARRIVED 2.4.1.5 MESSAGE LIST REQUEST CONFIRMED 2.4.1.10 UNABLE TO PROCESS

2.4.2.5

TRANSFER INC SMS

2.4.2.1

2.4.2.12

UNABLE TO PROCESS

2.4.2.10

98-08901C39-A

55

Software Interface

4.12.2

Text Mode

Table 28. ETSI 07.05 Text Mode (Continued)


Command +CMS Description 311 SIM PIN required 312 PH-SIM PIN required 313 SIM failure 314 SIM busy 315 SIM incorrect 316 SIM PUK required 317 SIM PIN2 required 318 SIM PUK2 required 320 Memory failure 321 Invalid memory index 322 Memory full 330 SMSC address unknown 331 No network service 332 Network timeout 340 No +CNMA acknowledgement expected 500 Unknown error Deletes message Service centre address Indicates new message Lists messages Reads message Acknowledges new message to ME/TA Sends message from storage ETSI 07.05 Reference 3.2.5

Text mode is fully described in GSM 07.05, section 3. The g18 module does not support text mode, however the following commands are supported, since they are useful for PDU mode. Table 28. ETSI 07.05 Text Mode
Command +CSMS Description Select message service (phase 2, phase 2+, and so on) Preferred message storage Message format: PDU or text mode selection, PDU = default Enter SMS block mode protocol Message service failure result code: 0 - 127 GSM 04.11 Appendix E-2 values 128 - 255 GSM 03.40 sub-clause 9.2.3.22 values 300 ME failure 301 SMS service of ME reserved 302 Operation not allowed 303 Operation not supported 304 Invalid PDU mode parameter 305 Invalid text mode parameter 310 SIM not inserted ETSI 07.05 Reference 3.2.1

+CPMS

3.2.2

+CMGF

3.2.3

+CESP

3.2.4

+CMS

3.2.5

+CMGD +CSCA

3.5.4 3.3.1

+CNMI

3.4.1

+CMGL +CMGR +CNMA

3.4.2 3.4.3 3.4.4

+CMSS

3.5.2

56

98-08901C39-A

Software Interface

4.12.3

PDU Mode

4.13 GPRS COMMANDS


Table 30. ETSI 07.07 Commands for GPRS
Command +CGDCONT Function Defines, modifies or removes a PDP context Defines, modifies or removes a requested Quality of Service profile Defines, modifies or removes a minimum required Quality of Service profile Attaches/detaches GPRS requests Activates/deactivates PDP context request Shows PDP address Interfacing mobile station class parameters (stores, manages, retrieves) Reference 10.1.1

PDU mode is described fully in GSM 07.05 Section 4. PDU mode uses the same commands and responses as the Text mode described above. However, PDU mode uses different formats for the following commands and responses. In addition, refer to GSM 04.11 and GSM 03.40 for details on formatting the Service Center Address and Transport Data Protocol Unit of the SMS PDU. Table 29. ETSI 0705 PDU Mode
Command +CMGL +CMGR +CMGS +CMGW +CNMA Description Lists messages Reads message Sends message Writes message Acknowledges new message to ME/TA Sends message from storage ETSI 07.05 Reference 4.1 4.2 4.3 4.4

+CGQREQ

10.1.2

+CGQMIN

10.1.3

+CGATT

10.1.4

+CGACT 4.6 +CGPADDR +CMSS 4.7 +CGCLASS

10.1.5

10.1.8 10.1.11

98-08901C39-A

57

G. AT COMMANDS

7.1 BASIC FUNCTIONALITY


Make sure that the g18 is mounted and linked correctly to the developer board. The power supply must provide 3-6 V DC without any voltage spikes. Use Telix or any other terminal program on your computer and set it to a normal RS232 connection, using a one-to-one connection cable. After all the links have been established correctly, use the power switch to power up the board.

7.1.1

PIN and PUK Code Entry

If your SIM card requests a PIN number, do the following:


AT Command at+cpin=nnnn Reaction +CME ERROR: <err> Enables the SIM card. Remarks nnnn = PIN number (4 - 8 digits). If PIN is correct, OK is shown. If PIN is incorrect, ERROR is shown. When incorrect PIN is entered: ERROR When correct PIN is entered: OK at+cpin? +CPIN: <code>+CME ERROR: <err> Responds with information about the SIM and the PIN. When no SIM is available: ERROR When PIN is not needed: +CPIN:READY When PIN is needed: +CPIN: SIM PIN When PUK number is needed: +CPIN: SIM PUK When PIN2 is blocked: +cpin: SIM PUK2

G1 is the group containing the following AT commands: Basic AT commands (includes ATD, ATA, ATH). AT+CKPD (to simulate handset key strokes). AT+CMER (to obtain handset screen output).

98-08901C39-A

69

AT Commands

G2 is the group containing the AT commands which interacts with the ME. The following commands are accepted when the ME is pending SIM PIN, SIM PUK or PH-SIM (GSM 7.07 section 8.3): +CGMI, +CGMM, +CGMR, +CGSN, +CPAS, +CPIN.
+CPIN? Code Output SIM PIN SIM PUK -

SIM/PIN Status

Allowed Commands G1 G1 G1, G2 G1, G2 G1 All All G1 All

AT Command Result for Non-allowed Commands SIM not inserted SIM failure SIM PIN required SIM PUK required SIM failure Depends on AT command Depends on AT command SIM failure Depends on AT command

+CPIN? Result

No SIM Bad SIM Required SIM Card PIN PIN1 Blocked Permanent Blocked (PUK) PIN2 Required PIN2 Blocked Permanent Blocked (PUK2) Other

SIM not inserted SIM failure OK OK SIM failure OK OK SIM failure OK

SIM PUK2 READY

The following AT commands are enabled without a valid SIM: GCAP, GMI, GMR, IFC, CEER, CGMI, CGMM, CGMR, CGSN, CHUP, CIPE, CKPD, CMEE, CMER, CIP, CRC, CSQ, CR, MTDTR.
Note

7.1.2

Feedback from the System


AT Command Reaction Provides the software version. For example, E6.02.07. PC Card: g18_v_E6_02_07. CGMI: MOTOROLA. +cnum: VOICE,054445561,129. +cnum: DATA,054626515,129. +cnum: FAX,054562511,129. For example, +COPS: 000, 000, IL ORANGE. Remarks

ati3

at+cgmr at+cgmi at+cnum

Provides hardware information. Provides hardware information. Provides the subscriber number.

at+cops?

Provides the name of the network operator.

70

98-08901C39-A

AT Commands

AT Command at+csq

Reaction Provides the signal strength indication, for example +csq: 031,099.

Remarks For example, +CSQ: 030, 099. Note: Does not support BER information. 0 = disabled. 1 = enabled. 2 = enabled. For example, AT+CMER=0,0,1,1,0.

at+cmee=1 or 2

Reports mobile equipment error. Must always be set to 2.

at+cmer

Reports mobile equipment events to the IP.

7.1.3

Establishing a Voice Call

The following procedure shows the basic commands to be sent to the g18 to establish a voice call.
AT Command Reaction Power up the g18. at+cpin=xxxx Enables the SIM card. DSC LED lights up. xxxx = PIN number (4 - 8 digits). OK. No Carrier. Remarks

ATD (phone number); AT*D (phone number) ATD> <index>; ATD> <name> ATDS=n (n=0 to 3) ATD><mem><index>;

or or or or or

Dials the phone number (voice call). For example, ATD123456; ATD>102; OR ATD>DAN OR ATDS=1; OR ATDS=0 OR ATD>SM101; Redials the last number. Current call is a voice call. Hangs up.

Atdl at*dxxxx Ath

Note: In Multi-party calls, ATH does not end the last call, only AT+CHLD=1 does.

In a voice call, when the other side hangs up, DTE receives a NO CARRIER" message. Only the second OK in a voice call notifies the user that the call was established.
Note

98-08901C39-A

71

AT Commands

7.1.4

Answering a Voice Call

The following procedure shows the basic commands to be sent to the g18 to answer a voice call.
AT Command Reaction Power up the g18. at+cpin=nnnn ata Enables the SIM card. Answers the call. nnnn = PIN number (4 - 8 digits). Remarks

7.1.5

Finding a Phone Book Entry

The following procedure shows the basic commands to be sent to the g18 to find a phone book entry.
Remarks

AT Command

Reaction Power up the g18.

at+cpin=nnnn at+cpbs=mt at+cpbf= Name

Enables the SIM card. Enables the phone and SIM memory. The g18 shows the number on that position +cpbf: xxx, phone number, yyy, Name of the entry.

nnnn = PIN number (4 - 8 digits).

The NAME is a string up to 3 characters. <xxx> Position in the memory. 0-100 Phone memory. 101-220 SIM card memory. <yyy> 129 Normal number. 145 International number.

72

98-08901C39-A

AT Commands

7.1.6

Writing a Phone Book Entry


AT Command Reaction Power up the g18. Remarks

at+cpin=nnnn at+cpbs=mt at+cpbw=xxx,Phone number, yyy, Name of the entry

Enables the SIM card. Enables the phone and SIM memory. The g18 writes the number on that position.

nnnn = PIN number (4 - 8 digits).

<xxx> 0-100 101-220 <yyy> 129 145

Position in the memory. Phone memory. SIM card memory. Normal number. International number.

7.1.7

Reading a Phone Book Entry


AT Command Reaction Power up the g18. Remarks

at+cpin= nnnn at+cpbs= mt at+cpbr= xxx

Enables the SIM card. Enables the phone and SIM memory. The g18 shows the number on that position +CPBR: xxx, phone number, yyy, Name.

nnnn = PIN number (4 - 8 digits).

<xxx> 0-100 101-220 <yyy> 129 145

Position in the memory. Phone memory. SIM card memory. Normal number. International number.

7.1.8

Phone Book Function


AT Command Reaction This AT should be the first one to be used to select the phone book. Remarks FD = SIM fix dialing phone book. LD = last dialing phone book. ME = ME phone book. MT = ME and SIM phone book. SM = SIM phone book. DD = Direct-dial phone book. RC = ME received calls list. MC = ME missed calls list.

at+cpbs=NN

98-08901C39-A

73

AT Commands

AT Command at+cpbs? at+cpbs=?

Reaction For example, +CPBS: SM,45, 100 +CPBS: (FD,LD,ME,MT, SM,DD,"RC","MC") For example: at+cpbr=101 +CPBR: 101,123456,129,AVI

Remarks

List of supported memory.

at+cpbr= xxx

<xxx> is a number from 0 to 100, used to read from ME phone books and 101 to 220, used to read from SIM phone books.

7.1.9

Sending an SMS in PDU Mode


AT Command Reaction Power up the g18. Remarks

at+cpin=nnnn at+csms=<service>

Enables the SIM card. Selects the message service response: +CSMS: <mt>,<mo>,<bm> +CSMS: 001,001,001 OK.

nnnn = PIN number (4 - 8 digits). <Service> 0 for phase 2

<mt>,<mo>,<bm> 1 supported 2 not supported

at+cpms=sm

Preferred message storage response: +CPMS:<used1>,<total1>,<used2>,< total2> +CPMS: 001,0015,001,015 OK. Sends an SMS in PDU mode return: +CMGS: 000. Sends TEST: to phone # 49 -172 - 6188234 to SMS center 49 -172 - 2720000. For the coding of SMS, refer to SMS Error Messages, page 36.

at+cmgs=160 >0791947122720 00011000c91947 1628128430000a 704f4f29c0e ctrl-z

7.1.10

Establishing GPRS PDP Context

When using the GPRS network for HTTP/FTP browsing, you must be connected to the GPRS network before the activation of PDP context. Connection may be performed in one of two ways: Automatically, after powering up of your MS. On the screen, the GPRS logo is displayed. Using the AT+CGATT=1 command.

74

98-08901C39-A

AT Commands

You can check your connection status by using the AT+CGATT? command: AT+CGDCONT=1, IP,RTY,123.32.45.9 Following are the three main ways in which to activate PDP context: 1. If the GPRS Wizard application is used, double-click the button predefined as the dialer for this provider to automatically establish PDP context. If the g18 was not previously attached to GPRS, it will be attached automatically. Setup Configuration 1. Enter into the wizard parameters provided by your operator. 2. Set definitions to allow your http\ftp browser to use the g18 as a port to the Internet. Usage 1. Open the GPRS wizard. 2. Double-click the dialer icon to select and activate the provider of your choice (multiple providers may be displayed in the list). 3. After dialing, your temporary IP address and then the GPRS DATA session message will be displayed on the handset. 4. Minimize the GPRS wizard window and use your http\ftp browser (Internet Explorer, Netscape). 2. If you use AT commands to activate PDP context, you must perform the following steps: 1. Define the PDP contact (profile). For example: AT+CGDCONT=1,IP,RTY, 2. Define Quality of Service. For example: At+CGQREQ=3,2,4,5,8,12 3. Define minimum acceptable Quality of Service. For example: At+CGQMIN=1,0,0,0,0 4. Activate PDP context using the AT+CGACT=1 command.
Bear in mind that the AT command AT+CGACT is not supported in all countries with GPRS. A GPRS connection is also possible with ATD*99#. See the following section for more information.
Note

Setup Configuration AT+CGQMIN=1,0,0,0,0,0 AT+CGQREQ=1,0,0,0,0,0 AT+CGCONT=1,IP,APN,0.0.0.0,0,0 // APN replace it with the provider name AT AT &F0 &D2 &C1 E0 AT V1 W1 S95=47 AT&K3 ATD*99#
The above list is only for the AT command level. PPP information (DNSs) is not shown here.
Note

3.

Using the ATD* command set: To select the provider, protocol and the profile, use ATD*99***(CID)#. In fact, providers use the ATD*99# command to attach to their GPRS service.

98-08901C39-A

75

AT Commands

7.2 AT COMMAND LISTING 7.2.1 ATD, Dialing


AT Command atd<number> Reaction <busy>, <no carrier> Remarks <number> Data/Fax number <busy> Called party is not available <no carrier> No connection to the number For voice calls only

ATD (phone number); AT*D (phone number) ATD> <index>; ATD> <name> ATDS=n (n=0 to 3) ATD><mem><index>; ATDL ATD*99

or or or or or

Without ;, is for Data Call

Requests GPRS service "D". Manual acceptance of a network request. Current call is a voice call.

at*d xxxxxx

Only the second OK for the voice call notifies the user that the call was established.
Note

Example at*d06113611404 OK OK atd06512467; atdl ATDL: 06512467; OK OK // When the call is connected // When the call is connected //Another format for a voice call //Dial last number

76

98-08901C39-A

AT Commands

ath NO CARRIER OK atd06113611404 OK BUSY NO CARRIER atd06113611404 CONNECT // Data call - success // Data call

7.2.2

AT+CAOC, Charge Advice


AT Command Reaction +caoc: <xxxx> Remarks <mode> 0 = Query CCM value <xxxx> The actual price of the current call (hex).

at+caoc=<mode>

Only available if the local network supports this command.


Note

Example at+caoc=? +CAOC: 0 OK at+caoc=0 +CAOC: 000000 OK

98-08901C39-A

77

AT Commands

7.2.3

AT+CCFC, Call Forwarding Number and Conditions


AT Command Reaction +CCFC: (0,1,2,3,4,5) Remarks <Reason> 0 Unconditional 1 Mobile busy 2 No reply 3 Not reachable 4 All calls forwarding 5 All conditional calls forwarding <Mode> 0 Disable 1 Enable 2 Query status 3 Registration 4 Erasure <Type> 145 International number 129 Regular number <Time> 1-30 Time to wait before the call is forwarded when there is no reply (default) <Class> 7 Equal for all classes

at+ccfc = <reason>,<mode>[,<number>[,<type >[,<class>[,<subaddr>[,<satype>[,<ti me>]]]]]] at+ccfc=?

Returns all reasons supported

The third parameter must be a multiple of 5 (0,5,10,...) at+ccfc=5,2 and at+ccfc=4,2 are not supported by the network.
Note

The first registration mode also enables the call forward.

Example AT+CCFC=? +CCFC: (0,1,2,3,4,5) OK AT+CCFC? +CME ERROR: Operation not allowed at+ccfc=0,3,01256316830,129,1 OK AT+CCFC=0,2 +CCFC: 1,1,+441256316830,1

78

98-08901C39-A

AT Commands

+CCFC: 0,2 +CCFC: 0,4 OK at+ccfc=0,4,,,1 OK

7.2.4

AT+CCWA, Call Waiting


AT Command Reaction Enables the call waiting feature Remarks <n>shows the result code in TA 0 Disable 1 Enable <mode> 0 Disable 1 Enable 2 Query <status> 0 Not active 1 Active <class x> 1 Voice 2 Data 4 Fax

at+ccwa=<n>, <mode>, <class x> at+ccwa=? at+ccwa?

+CCWA: (list of supported <n>s) +CCWA: <n>

The unsolicited result code does not include the alpha tag within the double-quote.
Note

Example At+ccwa=? +ccwa: 00,01 OK at+ccwa=0,0 OK at+ccwa=0,2 +ccwa: 0,1 +ccwa: 0,2 +ccwa: 0,4 OK //status query

98-08901C39-A

79

AT Commands

at+ccwa=1,1 OK at+ccwa=1,2 +ccwa: 1,1 +ccwa: 1,2 +ccwa: 1,4 OK

//Enable call waiting for voice call

7.2.5

AT+CHLD, Call Related Supplementary Services


AT Command Reaction Switches between the active calls +CHLD: (supported <mode>s) +CME ERROR: operation not allowed Remarks <mode> 0 Releases all held calls or sets User Determined User Busy (UDUB) for a waiting call. 1 Releases all active calls (if any exist) and accepts the other (held or waiting) call. 1X Releases a specific active call X. 2 Places all active calls (if any exist) on hold and accepts the other (held or waiting) call. 2X Places all active calls on hold except call X with which communication will be supported. If there is no such call, returns error 22. 3 Adds a held call to the conversation.

at+chld=<mode> at+chld=? at+chld?

CALL STATE (+CLCC) CHLD = 0 IDLE Error 3. CHLD = 1 Error 3.

+CHLD modes

CHLD = 1X Error 3.

CHLD = 2 Error 3.

CHLD = 2X Error 3. If there is no such call, returns error 22.

CHLD = 3 Error 3.

80

98-08901C39-A

AT Commands

CALL STATE (+CLCC) CHLD = 0 SINGLE ACTIVE Error 3. CHLD = 1 Release active.

+CHLD modes (Continued)

CHLD = 1X When X = 1, release is active. If not, returns error 22. Releases a specific call x. If there is no such call, returns error 22.

CHLD = 2 Puts call on hold.

CHLD = 2X Error 3. If there is no such call, returns error 22. Split. If there is no such call, returns error 22.

CHLD = 3 Error 3.

MPTY ACTIVE

Error 3.

Release mpty call. Returns 2 "no carrier" when there are 2 outgoing calls. Error 3.

Put mpty on hold.

Error 3.

INCOMING CALL

Releases incoming call.

Error 3.

Error 3.

Error 3. If there is no such call, returns error 22. Error 3. If there is no such call, returns error 22.

Error 3.

ACTIVE + WAITING

Releases waiting call.

Releases active call and accepts waiting call.

Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22.

Puts active call on hold and accepts the waiting call.

Error 3.

MPTY ACTIVE + WAITING

Releases waiting call.

Release mpty, accepts waiting.

Puts mpty on hold, accepts the waiting call.

Splits. If there is no such call, returns error 22.

Error 3.

SINGLE HELD

Releases held call.

Accepts held call.

Accepts held call.

Error 3. If there is no such call, returns error 22.

Error 3.

HELD MPTY

Releases held call.

Accept mpty call.

Accepts mpty call.

Error 3. If there is no such call, returns error 22.

Error 3.

98-08901C39-A

81

AT Commands

CALL STATE (+CLCC) CHLD = 0 DUAL Releases held call. CHLD = 1 Releases active, accepts the other call.

+CHLD modes (Continued)

CHLD = 1X Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. if there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. If there is no such call, returns error 22. Releases a specific call x. if there is no such call, returns error 22.

CHLD = 2 Switches.

CHLD = 2X Error 3. If there is no such call, returns error 22.

CHLD = 3 Makes a conference call.

DUAL + MPTY ACTIVE

Releases held call.

Releases mpty, accepts the other call.

Switches.

Error 3. If there is no such call, returns error 22.

Makes a conference call.

DUAL+ MPTY HELD

Releases held call.

Releases active, accepts the mpty.

Switches.

Error 3. If there is no such call, returns error 22.

Makes a conference call.

HELD + WAITING

Releases waiting call.

Accepts the waiting call.

Accepts the waiting call.

Error 3. If there is no such call, returns error 22.

Error 3.

HELD MPTY + WAITING

Releases waiting call.

Accepts the waiting call.

Accepts the waiting call.

Error 3. If there is no such call, returns error 22.

Error 3.

DUAL + WAITING

Releases waiting call.

Releases active, accepts waiting call.

Error 3 (too many calls on hold).

Error 3. If there is no such call, returns error 22.

Joins the dual calls.

DUAL + MPTY ACTIVE + WAITING

Releases waiting call.

Releases mpty active, accepts waiting call.

Error 3 (too many calls on hold).

Error 3. If there is no such call, returns error 22.

Joins the dual and the mpty calls.

82

98-08901C39-A

AT Commands

CALL STATE (+CLCC) CHLD = 0 DUAL + MPTY HELD + WAITING Releases waiting call. CHLD = 1 Releases active, accepts waiting call.

+CHLD modes (Continued)

CHLD = 1X Releases a specific call x. If there is no such call, returns error 22.

CHLD = 2 Error 3 (too many calls on hold).

CHLD = 2X Error 3. If there is no such call, returns error 22.

CHLD = 3 Joins the dual and the mpty calls.

Split: Places all active calls on hold except a specific call. Switch:Puts the active call on hold and accepts the held call.
Note

Error 3: "operation not allowed" Error 22: "not found"

Example at+chld=? +CHLD: (0,1,1X,2,2X,3) OK at+chld =1 //ME is not in conversation //list of supported <n>s

+CME ERROR: operation not allowed RING ata OK at+chld NO CARRIER at+chld=2 OK at+chld=2 OK at+chld=2 OK at+chld=2 OK 98-08901C39-A 83 //Incoming intruder call //First call goes to hold and second call is received //Second call goes to hold and first call becomes active //Call is reconnected //Call goes to hold

AT Commands

at+chld=3 at+chld=21 OK

//Add the held call to the conversation //Second call goes to hold

7.2.6

AT+CLCC, List Current Calls


AT Command Reaction +CLCC: <id1>,<dir>,<call state>,<mode>,<mpty>[, <number>,<type> OK +CLCC: 0 +CLCC: 1 or Remarks <Direction> 0 Mobile originated call 1 Mobile terminated call <Call State> 0 Active 1 Held 2 Dialing 3 Alerting 4 Incoming 5 Waiting 6 Released <Mode> 0 Voice Call 1 Data 2 Fax <Multiparty> 0 Call is not part of a conference call 1 Call is one of multiparty call parties <Phone Number> <Type> 129 Normal number 145 International number with access character +

at+clcc

at+clcc=? at+clcc?

Alpha string from phone book is not displayed. Add non-standard "released" state.
Note

Asynchronous answers are also allowed, by using at+clcc=1. In Release state, the call mode will always be zero.

Example AT+CLCC=? OK AT+CLCC? +CME ERROR: operation not allowed

84

98-08901C39-A

AT Commands

at*d01256316830 OK OK AT+CLCC +CLCC: 1,0,0,0,0,01256316830,129,Shmuel OK AT+CHUP NO CARRIER

7.2.7

AT+CLCK, Facility Lock


AT Command Reaction +CME ERROR: <err> when <mode>=2 and command successful: +CLCK: <status>, <class1> Remarks <Facility> CS Key pad SC SIM Card AO Block all outgoing calls OI Block all outgoing international calls OX Block outgoing international calls except to home country AI Block all incoming calls IR Block incoming calls when roaming outside home country AB All blocking services AG All outgoing blocking services AC All incoming blocking Services FD SIM fixed dialing feature <Mode> 0 Unlock 1 Lock 2 Query status < Password> Call Block password or PIN1 to Lock/ Unlock SIM or PIN2 for SIM Fixed Dialing Feature <Class> Sum of integers representing of information for call blocking services 1 Voice 2 Data 4 Fax <Status> 0 Not active 1 Active

at+clck=<facility>, <mode>[,<password>[,<class>]]

at+clck=? +CLCK: (list of supported facilities)

98-08901C39-A

85

AT Commands

Example AT+CLCK=? +CLCK: (CS,SC,AO,OI,OX,AI,IR,AB,AG, AC,FD) OK AT+CLCK? +CME ERROR: operation not allowed AT+CLCK=CS,2 +CLCK: 0,7 OK AT+CLCK=FD,2 +CLCK: 0,7 OK // means that write operations into FD area are possible if PIN2 was entered at least once after power up.

7.2.8

AT+CLIP, Calling Line Identification Presentation


AT Command Reaction Shows the number of the calling party +CLIP: <n>,<m> +CLIP: (000,001) Remarks <n> 0 disable 1 enable <m> 0 Clip not provisioned 1 Clip provisioned 2 Unknown

at+clip=<n> at+clip? at+clip=?

Example at+clip=1 OK RING +CLIP: +496113611404,145 RING +CLIP: +496113611404,145

86

98-08901C39-A

AT Commands

at+clip=? +CLIP: (000,001) OK at+clip=0 OK RING

7.2.9

AT+CLIR, Calling Line Identification Restriction


AT Command Reaction Shows the own number at the called party +clir: <n>,<m> Remarks <n> 0 Used according to the subscription of the clir service 1 Enable 2 CLIR suppression in permanent mode <m> 0 Clir not provisioned 1 Clir provisioned 2 Unknown 3 Clir temporarily restricted 4 Clir temporarily allowed

at+clir =<n>

at+clir?

at+clir=?

+clir: (list of supported <n>s)

Example at+clir=? +CLIR: (0,1,2) OK at+clir? +clir: 000,004 at+clir=2 OK at+clir? +clir: 002,004

98-08901C39-A

87

AT Commands

7.2.10

AT+CMEE, Report Mobile Equipment


AT Command Reaction Shows a description of the error Remarks <n> 0 Disable 1 Enable (numeric) 2 Enable (verbose)

at+cmee=<n>

Example at+cmee? +CMEE: 000 OK at+cmee=? +CMEE: (0-2) OK. at+cmee=1 OK at+cmee? +CMEE: 1 OK at+cmee=2 OK at+cmee? +CMEE: 2 OK

88

98-08901C39-A

AT Commands

7.2.11

AT+CMGS, Sending an SMS Message


AT Command Reaction Sends the SMS message Remarks <length> Number of octets coded in the TP <cr> After terminating with<cr>, the PDU can be given from the TE <crtl-z> Indicates the end of the PDU

(cmgf=0) at+cmgs=<length> <cr> >PDU is given <ctrl-z/ESC>

The message is terminated with control-Z character (0x1A)

7.2.12 AT+CNUM, Subscriber Number


AT Command at+cnum Reaction Remarks Shows the numbers which were entered into My Phone Numbers from the Handset menu.

Example at+CNUM=? OK at+CNUM +CNUM: voice, 054556426, 129 +CNUM: data, 054667739, 129 +CNUM: fax, 054422417, 129 at+CNUM=? +CNUM: voice, 054525215, 129 +CNUM: data, 054215155, 129 +CNUM: fax, 054626618, 129 OK

98-08901C39-A

89

AT Commands

7.2.13

AT+COPS, Operator Selection


AT Command Reaction Selects the operator +COPS: list of supported (<stat>, long alpha numeric <oper>, short alphanumeric <oper>, numeric <oper>) +COPS: <mode>,<present>,<oper> Remarks <mode> 0 Automatic 1 Manual 2 De-register from network 3 Set only <format> 4 Manual/automatic <format> 0 Long alphanumeric 1 Short alphanumeric 2 Numeric <Operator status> 0 Unknown 1 Available 2 Current 3 Forbidden

at+cops=<mode>,<format>,<oper> at+cops=?

at+cops?

Example at+cops=?
When set command (=) is used without entering <oper>, the response is OK but no action will be performed (at+cops=<mode>,<format><cr>, the response is OK).
Note

When manually de-registering from the network using AT+COPS=1,2, the phone automatically searches for a new network and logs in.

+COPS: (2,,D2 PRIVAT,26202),(0,,A1,23201),(0,,F SFR,20810),(0,,GR PANAFON,20205),(0,, S EURO,24008),(0,,EUROTEL-CZ,23002),(0,,NL LIBERTEL,20404),(0,,I OMNI,22210),(3,, D1-TELEKOM,26201),,( 0,1,2,3,4),(0,1,2) OK at+cops? +COPS: 0,0,D2 PRIVAT OK at+cops=0 OK at+cops=1 OK at+cops=1,0,d1-telekom +CME ERROR: 027

90

98-08901C39-A

AT Commands

at+cops=1,1,d02 OK at+cops=1,1,d01 +CME ERROR: 100 at+cops=2 OK at+cops=3 OK at+cops=4 OK at+cops=4,2,d01 OK at+cops=4,2,26201 ERROR at+cops=4,0,D1-Telekom ERROR at+cops=4,0,d1-telekom ERROR at+cops=4,2,d OK at+cops=4,2,d02 OK

98-08901C39-A

91

AT Commands

7.2.14 AT+CPBS, Selected Phone Book Memory Storage


AT Command at+cpbs=<storage> Reaction +CPBS: <storage>[,<used>,<total>] Remarks <storage> FD SIM fix dialing phone book LD Last dialing phone book ME ME phone book MT ME and SIM phone book SM SIM phone book DD Direct Dial phone book RC ME received calls list MC ME missed calls list

The g18 responds to at+cpbs=? with the current initialized phone books: +CPBS:("FD","LD","ME","MT","SM","DD","RC","MC"). It may take up to 45 seconds to see all the phone books.
Note

MC (missed calls) and RC (received calls) share the same area. They are both limited to a total of 10 records, and they are both sorted by their time stamps, where the first record in phone book is the latest call received or not answered.

Example at+cpbs=? +CPBS: (FD,LD,ME,MT,SM,DD,RC,MC) OK at+cpbs? +CPBS: 0,0 OK at+cpbs=fd OK at+cpbs? +CPBS: FD,1,10 OK at+cpbs=DC +CME ERROR: 003 at+cpbs=LD OK

92

98-08901C39-A

AT Commands

at+cpbs? +CPBS: LD,10,10 OK at+cpbs=me OK at+cpbs? +CPBS: ME,0,100 OK at+cpbs=MT OK at+cpbs? +CPBS: MT,14,200 OK at+cpbs=SM OK at+cpbs? +CPBS: SM,14,100 OK

98-08901C39-A

93

AT Commands

7.2.15

AT+CPBW, Writing Phone Book Entries


AT Command Reaction +cpbw: (list of supported <index>s),[<nlength>], (list of supported <type>s), [<tlength>] Remarks <index> Location number of the phone book <number> Phone number in format <type> <type> type of address: 129 - Normal format 145 - International format <text> Name of the entry <nlength> with maximum length of <number> <tlength> Maximum length of <text>

at+cpbw=[<index>], [,<number> [<type> [,<text>]]]

When creating a new entry without a name, the response is OK, but no action takes place.
Note

The telephone book "MT" is a combination of "ME" and "SM". Entries should be written to a specific phone book (ME or SM) instead of to the MT phone book. When writing to the SM or ME phone book, the g18 validates the string length for phone number and label, as defined for the specific phone book. When writing to the MT phone book, the g18 is unable to detect errors with a string length less than that allowed in MT phone book, but more than what is defined in the specific phone book. In this case, the write action is not rejected, but the number and text will be truncated to the limit allowed for the specific phone book.

Example, at+cpbs=sm;+cpbw=? +CPBW: (101-220),020,(255,129,145),014 OK at+cpbs=mt;+cpbw=? +CPBW: (001-220),032,(255,129,145),016 OK In the next statement, try to write a record to the SM area in the MT phone book (record 110 is in this area), with 21 digits for the phone number, and 15 digits for text. This is valid for the MT phone book, and therefore no error is expected. However, since it is written to the SM area, the phone number is truncated to 20 digits, and the text is truncated to 14 digits. at+cpbw=110,123456789012345678901,,123456789012345 // No error when writing to MT, to a slot defined in the SM phone book OK at+cpbr=110 +CPBR: 110,12345678901234567890,129,12345678901234 // Record wrriten to phone book as defined in the definition limitation. OK // MT phone book definitions: number length limited to 32, text length limited to 16. // SM phone book definitions: number length limited to 20, text length limited to 14.

94

98-08901C39-A

AT Commands

at+cpbs=mt OK at+cpbw=? +CPBW: (1-200),32,(255,129,145),18 at+cmee=1 OK at+cpbw=140,+496113611404,145,Raum 1004 +CME ERROR: 003 at+cpbw=140,496113611404,145,Raum1004 +CME ERROR: 003 at+cpbs=SM OK at+cpbw=140,496113611404,145,Raum1004 OK at+cpbs=ME OK at+cpbw=73,491726706014,145,eigene number +CME ERROR: 100 at+cpbw=73,491726706014,145,eigene number OK at+cpbw=190,491728788793,145,Freundin +CME ERROR: 021. at+cpbs? +CPBS: ME,2,100 OK at+cpbs=MT OK

98-08901C39-A

95

AT Commands

at+cpbw=73,496128970912,145,Eigene Number OK at+cpbw=190,491728788793,145,Freundin OK

7.2.16

AT+CPIN, Enter Pin


AT Command Reaction +CME ERROR: <err> Enters or changes pin number. When entering the pin, a new pin is not required +CPIN: <code>+CME ERROR: <err> Remarks <puk> PUK code for blocked phone <pin> Current pin <newpin> New pin (after changing or after entering PUK) 4 - 8 digits

at+cpin=[<puk>or <pin>[<newpin>]

at+cpin?

The following AT commands are enabled without a valid SIM: GCAP, GMI,GMR, IFC, CEER, CGMI, CGMM, CGMR, CGSN, CHUP, CIPE, CKPD, CMEE, CMER, CIP, CRC, CSQ, CR.
Note

When PUK is required, and only one parameter is given in +CPIN, error "PUK is required" is returned.

Example at+cpin=3011 OK at+cpin=? OK at+cpin? +CPIN: READY OK at+cpin=3011,2811 OK at+cpin1111 ERROR at+cpin? +CPIN: SIM PIN

96

98-08901C39-A

AT Commands

OK at+cpin=71388330,3011 OK AT+CLCK=FD,2 +CLCK: 0,7 OK AT+CLCK=FD,1,2035 OK AT+CLCK=FD,2 +CLCK: 1,7 OK AT+CPBS=FD OK AT+CPBW=1,343434,129 // Try to change entry in the phonebook +CME ERROR: SIM PIN2 required AT+CPIN? +CPIN: READY OK AT+CLCK=FD,0,1234 // Wrong PIN2 is inserted // Select FD phonebook // Closing FD phonebook for changes, and allowed to originate calls // only to the numbers from the FD phonebook // Checking the status of Fix Dialing phonebook // Enable dialing of all numbers

+CME ERROR: incorrect password A/ // Wrong PIN2 is inserted +CME ERROR: incorrect password A/ // Wrong PIN2 is inserted +CME ERROR: SIM PUK2 required AT+CPIN? +CPIN: SIM PUK2 OK AT+CPIN=61356375,2035 // Enter PUK2 and new PIN2 OK AT+CPIN? +CPIN: READY OK at+cpin=2222 // Incorrect PIN // PIN2 is blocked. Need PUK2 to release it.

98-08901C39-A

97

AT Commands

ERROR at+cpin? +CPIN: SIM PIN OK at+cpin=3333 ERROR at+cpin? +CPIN: SIM PIN OK at+cpin=4444 ERROR at+cpin? +CPIN: SIM PUK OK at+cpin=58887756,1234 OK // SIM is locked and PUK number is required // Incorrect PIN // Incorrect PIN

98

98-08901C39-A

AT Commands

7.2.17

AT+CREG, Network Registration


AT Command Reaction Remarks <n> 0 Disables network registration Unsolicited result code 1 Enables network registration unsolicited result code 2 Enables network registration and location information Unsolicited result code <stat> 0 Not registered 1 Registered (home network) 2 Not registered but ME search for a network 3 Registration denied 4 Unknown 5 Registered roaming <lac> 2 Byte location code (hex) <ci> 2 bytes cell ID (hex)

at+creg=<n> at+creg? +creg: <n>,<stat>[,<lac>,<ci>]. OK +CREG: (0,1,2)

at+creg=?

Example at+creg=? +CREG: (000,001,002) OK at+creg? +CREG: 000,001 OK at+creg=2 OK at+creg? +CREG: 002,001,6202,6113 OK at+creg=1 OK at+creg? +CREG: 001,001 OK at+creg=0

98-08901C39-A

99

AT Commands

OK at+creg=2,5 ERROR at+creg? +CREG: 002,001,6202,6113 OK at+creg=1 OK at+creg? +CREG: 001,001 OK

7.2.18

CSTA, Selecting Type of Address


AT Command Reaction Remarks <type> number format 129 Local phone number 145 With international access character +

at+csta=<type> at+csta? +csta: <type> OK +csta: (129,145)

at+csta=?

Example at+csta? +CSTA: 129 OK at+csta=145 OK at+csta? +CSTA: 145 OK at+csta=129 OK at+csta? +CSTA: 129 OK

100

98-08901C39-A

AT Commands

7.2.19

AT+CBST, Selecting Bearer Service Type


AT Command Reaction +cbst: <speed>,<name>,<ce> OK +CME ERROR: operation not allowed +CBST: (list of supported <speed>), (list of supported <name>), (list of supported <ce>) Remarks <speed> 0 autobauding 4 2400 bps (V.22bis) 5 2400 bps (V.26ter) 6 4800 bps (V.32) 7 9600 bps (V.32) 68 2400 bps (V.110) 70 4800 bps (V.110) 71 9600 bps (V.110) <name> 0 data circuit asynchronous <ce> 0 Transparent 1 Non-transparent 2 Both, transparent preferred 3 Both, non-transparent preferred

at+cbst? at+cbst=<speed>,<name>,<ce>

at+cbst=?

The g18 supports baud rates of 4800 to 9600 bps.


Note

Example at+cbst=? +CBST: (000,004-007,068,070,071), (000), (000-003) OK at+cbst? +CBST: 007,000,001 OK at+cbst=1,0,1 OK at+cbst? +CBST: 001,000,000 OK at+cbst=7,3,4 +CME ERROR: operation not allowed at+cbst=7,0,1

98-08901C39-A

101

AT Commands

OK at+cbst? +CBST: 007,000,001 OK

7.2.20

AT+CGMI, Requesting Manufacturer Identification


AT Command Reaction +cgmi: <manufacture> Remarks <manufacture> Name of the manufacturer

at+cmgi

Example at+cgmi +CGMI: MOTOROLA OK at+cgmi? ERROR

7.2.21 AT+CGMM, Requesting Model Identification


AT Command at+cgmm Reaction +cgmm: <model> Remarks <model> Model identification

Example at+cgmm? ERROR at+cgmm=? OK at+cgmm +cgmm: L Series OK

102

98-08901C39-A

AT Commands

7.2.22

AT+CGMR, Requesting Revision Identification


AT Command Reaction +cgmr: <revision> Remarks <revision> Revision number of the software Requests revision identification

at+cgmr

Example at+cgmr? ERROR at+cgmr=? OK at+cgmr +cgmr: g18_vE6.02.07 OK

7.2.23

AT+CGSN, Requesting Product Serial Number Identification


AT Command Reaction +cgsn <sn> <sn> IMEI number Remarks

at+cgsn

Example at+cgsn? ERROR at+cgsn=? OK at+cgsn +CGSN: 447764074608839 OK

98-08901C39-A

103

AT Commands

7.2.24

AT+CHUP, Hanging Up Calls


AT Command Reaction Phone hangs up Remarks

at+chup=

Example at+chup=? OK at+chup OK RING at+chup? ERROR

7.2.25 AT+CMGD, Deleting SMS Messages


AT Command at+cmgd=<index> Deletes SMS Reaction Remarks <index> Position of the SMS in the storage

Delete SMS with ID=0 is not allowed. Delete SMS with ID=75 is allowed.
Note

Delete SMS with illegal ID or with non-existent SMS, ends with "Invalid index"

Example at+cmgd ERROR at+cmgd=? OK at+cmgd? ERROR at+cmgl=? +CMGL: (000-004) OK at+cmgl +CMGL: 001,000,023

104

98-08901C39-A

AT Commands

0791947122723033040B831027492204F000009930926145148004C2A2F308 OK at+cmgd=1 OK at+cmgl OK

7.2.26

AT+CMGF, Message Format


AT Command Reaction +cmgf: <mode> Remarks <mode> 0 PDU mode 1 Text mode (not supported)

at+cmgf= <mode>

Example at+cmgf? +CMGF: 000 OK at+cmgf=? +CMGF: (000) OK at+cmgf=1 +CME ERROR: operation not allowed

98-08901C39-A

105

AT Commands

7.2.27

AT+CMGL, Listing Messages


AT Command Reaction Lists SMS messages with a selected status Remarks <stat> 0 "REC UNREAD" received unread message (i.e. new message) 1 "REC READ" received read message 2 "STO UNSENT" stored unsent message 3 "STO SENT" stored sent message 4 "ALL" all messages

at+cmgl=<stat> at+cmgl

Use of any valid value of +CMGL parameter (0-4) lists of all messages. The selection list of messages is valid only in software versions above E6.01.10
Note

Example at+cmgl=? +CMGL: (000-004) OK at+cmgl +CMGL: 001,000,023 0791947122723033040B831027492204F000009930926145148004C2A2F308 OK.


Wait for OK before sending new AT commands.
Note

7.2.28

AT+CMGR, Reading Messages


AT Command Reaction Reads SMS message +CMS ERROR: <err> Remarks <index> Location of the SMS in the storage

at+cmgr=<index>

Example at+cmgr=2 +CMGR: 001,,023 0791947122723033040B831027492204F000009930927190948004C2A2F308 OK 106 98-08901C39-A

AT Commands

7.2.29

AT+CPAS, Phone Activity Status


AT Command Reaction +CPAS: <pas> +CME ERROR: <err> Remarks <pas> 0 Ready 1 Unavailable 2 Unknown 3 Ringing (MT calls) 4 Call in progress 5 Asleep

AT+CPAS

AT+CPAS=?

+CPAS: (list of supported <pas>s) +CME ERROR: <err>

Example at+CPAS +CPAS: 000 OK at+CPAS=? +CPAS: (000-005) OK at+cpas? ERROR

7.2.30

AT+CPBR, Reading Phone Book Entries


AT Command Reaction +cpbr: <index>,<number>,<type>,<text> Remarks <index> Location number in the storage <number> Phone number in the <type> format <type> 129 Local number 145 International number with access character + <text> Name of the entry

at+cpbr= <index>

98-08901C39-A

107

AT Commands

Example at+cpbr=? +CPBR: (1-200),32,18 OK at+cpbr=73 +CPBR: 73, +496128970912,145, Eigene Number OK at+cpbr=10 OK at+cpbr=101 +CPBR: 101,+491721212,145,D2-Kundenbetreuung OK at+cpbr=74 +CPBR: 74,+496113611400,145,test OK at+cpbr=124 +CPBR: 124,+4917222333,145,D2-Hotelservice OK // Empty entry

7.2.31

AT+CPMS, Preferred Message Storage


AT Command Reaction +CPMS: <used1>,<total1>,<used2>,<total> Remarks <mem> Memory storage <used> Used memory storage <total> Total memory storage

at+cpms=<mem1>, <mem2>

Example at+cpms=? +CPMS: (SM),(SM)

108

98-08901C39-A

AT Commands

OK at+cpms? +CPMS: SM,005,020,SM,005,020 OK a OK at+cpms=SM +CPMS: 005,020,005,020 OK at+cpms? +CPMS: SM,005,020,SM,005,020 OK

7.2.32

AT+CSCA, Service Center Address


AT Command Reaction +csca: <sca>,<type> Remarks <sca> Service center number <type> format of the number 129 Local number 145 International number with access character +

at+csca= <sca>,<type>

Example at+csca? +CMS ERROR: SMSC address unknown at+csca=? OK at+csca=491722270333,145 OK at+csca? +CSCA: +491722270333,145 OK

98-08901C39-A

109

AT Commands

7.2.33

AT+CSCS, Selecting TE Character Set


AT Command Reaction +cscs: <chset> Remarks <chset> GSM GSM alphabet IRA International alphabet

at+cscs= [<chset>

Example at+cscs=? +CSCS: (GSM,IRA) OK at+cscs? +CSCS: IRA OK at+cscs=gsm OK at+cscs? +CSCS: GSM OK at+cscs=IRA OK at+cscs? +CSCS: (IRA) OK

110

98-08901C39-A

AT Commands

7.2.34

AT+CSMS, Selecting the Message Service


AT Command Reaction Selects the message service +CSMS: <mt>, <mo>, <bm> +CMS ERROR: <err> <Service> 0 GSM 03.40 and 03.41. The syntax of SMS AT commands is compatible with GSM 07.05 Phase 2 version 4.7.0. Phase 2+ features which do not require new command syntax may be supported. <mt>,< mo>,< bm> 0 Type not supported 1 Type supported Remarks

at+csms at+csms =<service>

at+csms?

+CSMS: <service>, <mt>, <mo>, <bm> +CSMS: (list of supported <service>)

at+csms=?

Example at+csms ERROR at+csms=? +CSMS: (000) OK at+csms? +CSMS: 000,001,001,001 OK at+csms=0 +CSMS: 001,001,001 OK

98-08901C39-A

111

AT Commands

7.2.35

AT+CSQ, Signal Quality


AT Command Reaction +CSQ: <rssi>,<ber> <rssi> 0 0 Bars 1 1 Bar 10 2 Bars 20 3 Bars 30 4 Bars 31 5 Bars Remarks

at+csq

<-108 dBm -102 to -108 dBm -93 to -101 dBm -87 to -92 dBm -77 to -86 dBm >-76 dBm

<ber> (in percent) 99 Not known or detectable

Example at+csq +CSQ: 030 ,099 OK at+CSQ=? +CSQ: (000-031,099), (099)//


BER information is not supported.
Note

7.2.36

AT+CEER, Extended Error Report


AT Command Response +CEER: <report> OK Error

at+CEER at+CEER=? At+CEER?

Example at+ceer=? OK at+ceer? ERROR at+ceer +CEER: No information available OK

112

98-08901C39-A

AT Commands

7.2.37

AT+CKPD, Keypad Control


AT Command Reaction OK +CME ERROR: <err> Remarks <Keys> # Hash (number sign) * Star (*) 09 Number keys : Escape character for manufacturerspecific keys ; Escape character for string entering < Left arrow > Right arrow C/c Clear display (C/CLR) D/d Volume down E/e Connection end (END) L/l Phone lock (LOCK) M/m Menu (MENU) Q/q Quiet/mute (MUTE) S/s Connection start (SEND) T/t Store/memory (STO/M/M+) U/u Volume up V/v Down arrow Y/y Delete last character (C) :0 Smart button. (Colon followed by zero) :a Voice annotator ^ Up arrow <time>, <pause>: 0255 025.5 seconds (default values are manufacturer specific, but should be long enough that a normal ME can handle key strokes correctly).

at+CKPD=<Keys>[,<time>[,<pause>]]

Example at+ckpd=? OK at+ckpd=M ERROR at+ckpd=M>>S OK

98-08901C39-A

113

AT Commands

7.2.38

AT+FCLASS, Selecting a Mode


AT Command Response If n= 0 or n=1 OK. If not, returns ERROR <n> FCLASS: (list of supported <n>s)

at+FCLASS=<n> at+FCLASS? at+FCLASS=?

Example AT+FCLASS=? FCLASS: 0, 1 OK AT+FCLASS? +FCLASS: 0 OK

7.2.39

AT+GCAP, Requesting Complete Capabilities List


AT Command Response GCAP: (list of capabilities)

at+GCAP

Example AT+GCAP +GCAP: +FCLASS OK AT+GCAP=? ERROR AT+GCAP ERROR

114

98-08901C39-A

AT Commands

7.2.40

AT+CMOD, Calling Mode


AT Command Reaction Remarks <mode> 0 single mode 1 alternating voice/fax (teleservice 61) +CMOD: <mode> +CMOD: (list of supported <mode>s)

+CMOD=[<mode>]

+CMOD? +CMOD=?

Example AT+CMOD =? +CMOD: (000, 001) OK AT+CMOD? +CMOD: 000 OK AT+CMOD=1 OK

7.2.41

AT+CRLP, Radio Link Protocol


AT Command Reaction Remarks <iws>, <mws>, <T1>, <N2>: IWF to MS window size (default 61), MS to IWF window size (default 61), Acknowledgement timer T1 (default 48), Retransmission attempts N2 (default 6) in integer format (refer to GSM 04.22 [18] subclause 5.4.3) +CRLP= <iws>,<mws>,<T1>,<N2> +CRLP= (list of supported <iws>s), (list of supported <mws>s), (list of supported <T1>s), (list of supported <N2>s)

+CRLP= [<iws>[,<mws>[,<T1>[,<N2>]]]]

+CRLP? +CRLP=?

98-08901C39-A

115

AT Commands

Example AT+CRLP=? +CRLP: (010-061),(010-061),(048-255),(006-010) OK AT+CRLP? +CRLP: 061, 061, 048, 006 OK

7.2.42

AT+CR, Service Reporting Control


AT Command Reaction Remarks <mode> 0 Disables reporting 1 Enables reporting <serv> REL ASYNC Asynchronous nontransparent REL SYNC Synchronous nontransparent

+CR= [<mode>]

+CR? +CR=?

+CR: <mode> +CR: (list of supported<mode>s)

Example AT+CR ERROR AT+CR=? +CR: (000,001) OK AT+CR? +CR: 000 OK

116

98-08901C39-A

AT Commands

7.2.43

AT+CRC, Cellular Result Codes


AT Command Reaction Remarks <mode> 0 Disables extended format 1 Enables extended format <type>: REL ASYNC FAX VOICE Asynchronous nontransparent Facsimile (TS 62) Normal voice (TS 11)

+CRC= [<mode>]

+CRC? +CRC?

+CRC: <mode> +CRC: (list of supported <modes>s)

Example AT+CRC? +CRC:000 OK AT+CRC ERR1OR AT+CRC=? +CRC: (000,001) OK

98-08901C39-A

117

AT Commands

7.2.44

AT+CNMI, New Message Indications to TE+CNMI


AT Command Reaction +CMS ERROR: <err> Remarks <mode> 0 Buffer unsolicited result codes in the TA. If TA result code buffer is full, indications can be buffered elsewhere or the oldest indications may be discarded and replaced with the new received indications. <mt> 0 No SMS DELIVER indications are routed to the TE route message to TE. 1 Indication of memory location is routed to the TE. 2 SMS DELIVER indications are routed directly to TE. <bm> 0 No CBM indications are routed to TE. 2 New CBMs are routed directly to TE. <ds> 0 No SMS-STATUS-REPORTs are routed to the TE. 1 SMS-STATUS-REPORTs are routed to the TE using unsolicited result code: +cds: <length><cr><lf><pdu>. <bfr> 0 TA buffer of unsolicited result codes defined within this command is flushed to TE when <mode> 13 is entered (OK response is given before flushing the codes).

+CNMI=[<mode>[,<mt>[,<bm>[,<ds> [,<bfr>]]]]]

+CNMI?

+CNMI: <mode>,<mt>,<bm>,<ds>,<bfr> +CNMI: (list of supported <mode>s), (list of supported <mt>s), (list of supported <bm>s), (list of supported <ds>s), (list of supported <bfr>s)

+CNMI=?

While conducting a g18 data call, the arrival of an SMS resets the +CNMI setting, thereby notifying that something unexpected has occurred.
Note

After automatically transferring a SMS/CBM message to the DTE (mt=2 and/or bm=2), the g18 waits for a +CNMA response from the DTE (within one minute). If DTE does not respond within this time, or if another message arrives from the network, the g18 saves the message in SIM, exits from SMS mode, and sets all CNMI parameters to zero.

118

98-08901C39-A

AT Commands

In the following scenario: 1 2 3 AT CNMI=0,1,0,1,0 or CNMI=0,2,0,1,0 MO DATA call, connected state. SM received.

The g18 will end SMS mode and reset the CNMI parameters.This will indicate to the user that something occurred during the data call. Example at+cmgl OK No messages on SIM at+cnmi=0,2,2,1 OK at+cnmi? +CNMI: 000,002,002,001,000 OK +CMT: 026 //First message indication 07917952140230F2040B917952545608F500001010034171700007B12915D49C1E01 at+cnma // Response of the DTE OK +CMT: 036// Second message indication 07917952140230F2040B917952545608F500001010034183800013C7E793086A3EA5CEA4F308A23E 41D96715 at+cnma// Response of the DTE OK +CMT: 026// Third message indication 07917952140230F2040B917952545608F500001010034102030007332911D49C1E01 at+cnmi? +CNMI: 000,000,000,000,000// CNMI parameters changed since the DTE did not response with +CNMA OK at+cmgl +CMGL: 001,000,,026// The third message stored in the SIM 07917952140230F2040B917952545608F500001010034102030007332911D49C1E01 OK at+cmgl +CMGL: 001,001,,026 07917952140230F2040B917952545608F500001010034102030007332911D49C1E01 +CMGL: 002,000,,029 // New message also stored in the SIM

07917952140230F2040B917952545608F50000101003414240000BCEE215D42C4EA7C16311

98-08901C39-A

119

AT Commands

OK at+cnmi=0,2,2,1// Setting CNMI parameters to receive new messages again on DTE OK at+cnmi=? +CNMI: (000),(000-002),(000,002),(000,001),(000) OK at+cmni? ERROR at+cnmi=0,2,2,1,0 OK

7.2.45

AT+CMEC, Mobile Equipment Control Mode


AT Command Reaction +CMEC ERROR: <err> Remarks <keyp> 0 ME can be operated only through its keypad 2 ME can be operated from both ME keypad and TE <disp> 0 Only ME can write to its display <ind> 0 Only ME can set the status of its indications

+CMEC= [<keyp>[,<disp>[,<ind>]]]

+CMEC? +CMEC=?

+CMEC: <keyp>,<disp>,<ind> +CMEC: (list of supported <keyp>s), (list of supported <disp>s), (list of supported <ind>s)

Example AT+CMEC? +CMEC: 02, 00, 00 OK AT+CMEC=? +CMEC: (00,02), (00), (00) OK AT+CMEC=2, 0, 0 OK

120

98-08901C39-A

AT Commands

7.2.46

AT+CMER, Mobile Equipment Event Reporting


AT Command Reaction +CME ERROR: <err> Remarks <mode> 0 Buffer unsolicited result codes in the TA; if TA result code buffer is full, codes can be buffered elsewhere or the oldest ones can be discarded. <keyp> 0 No keypad event reporting <disp> 0 No display event reporting 1 Display event reporting +CDEV: <Upper corner>, <text>, <Lower corner>. The display height is 54 pixels: 0-53. The upper corner refers to the starting high point and the lower corner refers to the bottom right ending point. <text> New value of text element. <ind> 0 No indicator event reporting 1 Indicator event +CIEV: <ind>, <value>. <ind> indicates the indicator order number and <value> is the new value of indicator. +ciev:00, 00 Battery indicator (0-3) +ciev:01, xx Signal bars # (xx=1-5) +ciev:02, xx Service availability 0/1 +ciev:03, xx SMS envelope ind (0/1) +ciev:04, xx Call in progress (0/1) +ciev:05, xx Roaming indicator (0/1) +ciev:06, xx Sim pin1 requested (0/1) +ciev:07, x Sim SMS full (0/1) +ciev:08, x GPRS coverage (0/1) <bfr> 0 TA buffer of unsolicited result codes defined within this command is cleared when <mode> 13 is entered.

+CMER= [<mode>[,<keyp>[, <disp>[,<bfr>]]]]]

+CMER?

+CMER: <mode>, <keyp>, <disp>, <ind>, <bfr>

98-08901C39-A

121

AT Commands

AT Command +CMER=?

Reaction +CMER: (list of supported <mode>s), (list of supported <keyp>s), (list of supported <disp>s), (list of supported <ind>s), (list of supported <bfr>s)

Remarks

Example AT+CMER=? +CMER: (00), (00), (00,01), (00,01), (00) OK AT+CMER? +CMER: 00, 00, 00, 00, 00 OK AT+CMER=0, 0, 1, 0, 0 OK

122

98-08901C39-A

AT Commands

7.2.47

AT+CPBF, Finding Phone Book Entries


AT Command Reaction +CPBF: <index1>, <number>, <type>, <text> [[] <CR><LF>+CBPF: <index2>, <number>, <type>, <text>] +CME ERROR: <err> Remarks <index1>, <index2> Integer type values in the range of location numbers of phone book memory <number> String type phone number of format <type> <type> Type of address octet in integer format (refer GSM 04.08 [8] subclause 10.5.4.7) <find text>, <text> String type field of maximum length <tlength> Character set as specified by command Select TE Character Set +CSCS <nlength> Integer type value indicating the maximum length of field <number> <tlength> Integer type value indicating the maximum length of field <text>

+CPBF=<findtext>

+CPBF=?

+CPBF: <nlength>, <tlength> +CME ERROR: <err>

Example at+cpbs =SM OK at+cpbf =? +CPBF: 020, 014 OK at+cpbf =RON +CPBF: 105, 035655555, 129, RON +CPBF: 106, 054564254, 129, RONEN OK

98-08901C39-A

123

AT Commands

at+cpbf =ron OK at + cpbf = /list of all entries

+CPBF: 101, 6251455, 129, AVI +CPBF: 102, 052646651, 129, DAVID +CPBF: 103, 04621515, 129, BEN +CPBF: 104, 02665111, 129, CHRIS +CPBF: 105, 03565555, 129, RON +CPBF: 106, 054564254, 129, RONEN OK

7.2.48

AT+CESP, Entering SMS Block Mode


AT Command Reaction OK Remarks Prior to entering the block mode

at+cesp at+cesp=?

Example at+cesp OK

7.2.49

AT+CMGW, Writing Messages


AT Command Reaction +cmgw: <index> Remarks <nn> The message length <index> The location of the stored message is returned

At+cmgw=<nn>

Example at+cmgw=24 >07917952140230F2040B917952545630F200000070528141630005A060B10902 <ctr/Z> +CMGW: 001 OK

124

98-08901C39-A

AT Commands

7.2.50

AT+CTFR1, Diverting an Incoming Call to the Voice Mail


AT Command Reaction +CME ERROR: <err> OK Remarks If there is no waiting call in progress

AT+CTFR1

Example RING at+ctfr1 OK at+ctfr1 // When a call is not received +CME ERROR: operation not allowed

7.2.51 AT+CNMA, DTE Confirming the Previous Message


AT Command AT+CNMA OK Reaction Remarks Must be sent within 60 seconds from the arrival of the message to the DTE. If not, the message will be stored on the SIM card and the parameters of the CNMI command will be set to zero.

Refer to AT+CNMI, New Message Indications to TE+CNMI, page 118for examples.


Note

7.2.52

AT+CBAND, Changing Band


AT Command Reaction OK ERROR +CBAND: <N> +CBAND: 3,4 Remarks Wait for power cycle to apply the change. Not valid value <N> 3 For 1900Mhz 4 For 900/1800Mhz

AT+CBAND = N

AT+CBAND? AT+CBAND=?

98-08901C39-A

125

AT Commands

Example at+cmee=2 OK at+cband? +CBAND: 4 OK at+cpin? +CPIN: READY OK at+cband=3 OK at+cpin? +CME ERROR: no network service // g18 waits for power cycle

7.2.53

AT+CBAUD, Setting the Baud Rate


AT Command Reaction OK ERROR Remarks <n> <rate> 0 300 1 600 2 1200 3 2400 4 4800 5 9600 6 19200 7 38400 8 57600 9 Auto baud rate detection

AT+CBAUD=<n> OR AT+CBAUD=<rate>

For example, AT+CBAUD=8 is equivalent to AT+CBAUD=57600. Using AT+CBAUD=<baud> with <baud> value other than 9 will disable the auto baud rate detection feature.
Note

126

98-08901C39-A

AT Commands

7.2.54

AT+CGPRS, GPRS Coverage


AT Command Reaction +CGPRS: <mode>, OK ERROR Remarks <mode> 0 No GPRS coverage 1 GPRS coverage

AT+CGPRS AT+CGPRS?

Example AT+CGPRS +CGPRS: 0 OK AT+CGPRS? +CGPRS: 0 OK AT+CGPRS=1 +CME ERROR: operation not allowed
This command without an attachment will return always zero.
Note

7.2.55

AT+CGPADDR, Showing the PDP Address


AT Command Reaction +CGPADDR: <cid>,<PDP_addr> [<CR><LF>+CGPADDR: <cid>,<PDP_addr> +CGPADDR:(list of defined <cid>s)

AT+CGPADDR=[<c id> [,<cid> [,]]]

AT+CGPADDR=?

Example AT+CGPADDR=? +CGPADDR: (1,2,3) OK

98-08901C39-A

127

AT Commands

7.2.56

AT+CGCLASS, GPRS MS Class


AT Command Reaction OK ERROR +CGCLASS: <class> +CGCLASS: (list of supported <class>s)

AT+ +CGCLASS= [<class>]

AT +CGCLASS? AT +CGCLASS=?

Example AT+CGCLASS=? +CGCLASS: (B) OK AT+CGCLASS=B OK AT+CGCLASS=A ERROR

7.2.57

AT+CGDCONT, Defining the PDP Context


AT Command Reaction OK ERROR

+CGDCONT=[<cid> [,<PDP_type> [,<APN> [,<PDP_addr> [,<d_comp> [,<h_comp> [,<pd1> [,[,pdN]]]]]]]]] AT+CGDCONT?

+CGDCONT: <cid>, <PDP_type>, <APN>,<PDP_addr>, <data_comp>, <head_comp>[,<pd1>[,[,pdN]]] [<CR><LF>+CGDCONT: <cid>, <PDP_type>, <APN>,<PDP_addr>, <data_comp>, <head_comp>[,<pd1>[,[,pdN]]] +CGDCONT: (range of supported <cid>s), <PDP_type>,,,(list of supported <d_comp>s), (list of supported <h_comp>s)[,(list of supported <pd1>s)[,[,(list of supported <pdN>s)]]] [<CR><LF>+CGDCONT: (range of supported <cid>s), <PDP_type>,,,(list of supported <d_comp>s), (list of supported <h_comp>s)[,(list of supported <pd1>s)[,[,(list of supported <pdN>s)]]]

AT+CGDCONT=?

128

98-08901C39-A

AT Commands

Example AT+CGDCONT=? +CGDCONT: (1-3),(IP),,,(0,1),(0,1) OK AT+CGDCONT? +CGDCONT: 1,IP,,0.0.0.0,0,0 +CGDCONT: 2,IP,,0.0.0.0,0,0 +CGDCONT: 3,IP,,0.0.0.0,0,0 OK AT+CGDCONT=1,IP,RTY,123.32.45.9 OK AT+CGDCONT=4 ERROR / / Only allowed to set up to 3 PDP contexts

7.2.58 AT+CGQMIN, Quality of Service Provider


AT Command AT+CGQMIN=[<cid> [,<precedence> [,<delay> [,<reliability.> [,<peak> [,<mean>]]]]]] AT+CGQMIN? OK ERROR Reaction

+CGQMIN: <cid>, <precedence >, <delay>, <reliability>, <peak>, <mean> [<CR><LF>+CGQMIN: <cid>, <precedence >, <delay>, <reliability.>, <peak>, <mean> []] +CGQMIN: <PDP_type>, (list of supported <precedence>s), (list of supported <delay>s), (list of supported <reliability>s), (list of supported <peak>s), (list of supported <mean>s) [<CR><LF>+CGQMIN: <PDP_type>, (list of supported <precedence>s), (list of supported <delay>s), (list of supported <reliability>s), (list of supported <peak>s), (list of supported <mean>s)

AT +CGQMIN=?

98-08901C39-A

129

AT Commands

Example AT+CGQMIN=? +CGQMIN: (1-3),(0-3),(0-4),(0-5),(0-9),(0-18,31) OK AT+CGQMIN? +CGQMIN: 1,2,4,3,9,10 +CGQMIN: 2,2,4,3,9,10 +CGQMIN: 3,2,4,3,9,10 OK
For more details about Quality of Service, refer to ETSI specification GSM 03.60.
Note

7.2.59

AT+CGACT, PDP Context Activation/Deactivation Request


AT Command Reaction OK ERROR +CGACT: <cid>, <state> [<CR><LF>+CGACT: <cid>, <state> +CGACT: (list of supported <state>s)

AT+CGACT=[<state> [,<cid> [,<cid>[,]]]] AT+CGACT?

AT +CGACT=?

Example AT+CGACT=? +CGATT: (0, 1) OK AT+CGACT? +CGACT: 1,0 +CGACT: 2,0 +CGACT: 3,0

130

98-08901C39-A

AT Commands

OK AT+CGACT=1 ERROR // GPRS network not present.


In some GPRS networks, for example Germany, +CGACT is not supported. The ATD*99# command can be used to make a connection.
Note

7.2.60

AT+CGATT, GPRS Attach/Detach Request


AT Command Reaction OK ERROR +CGATT: <state> +CGATT: (list of supported <state>s)

AT+CGATT= [<state>]

AT+CGATT? AT+CGATT=?

Example AT+CGATT=? +CGATT: (0, 1) OK AT+CGATT? +CGATT: 0 OK AT+CGATT=1 ERROR AT+CGATT=0 OK

98-08901C39-A

131

AT Commands

7.2.61

AT+CGQREQ, Defining/Modifying/Removing a Requested Quality of Service Profile


AT Command Reaction OK ERROR +CGQREQ: <cid>, <precedence >, <delay>, <reliability>, <peak>, <mean> +CGQREQ: <PDP_type>, (list of supported <precedence>s), (list of supported <delay>s), (list of supported <reliability>s), (list of supported <peak>s), (list of supported <mean>s)

AT+CGQREQ=[<cid> [,<precedence> [,<delay>[,<reliability.> [,<peak> [,<mean>]]]]]] AT+CGQREQ?

AT+CGQREQ=?

Example AT+CGQREQ=? + CGQREQ: (1-3),(0-3),(0-4),(0-5),(0-9),(0-18,31) OK AT+CGQREQ? +CGQREQ: 1,2,4,3,9,10 +CGQREQ: 2,2,4,3,9,10 +CGQREQ: 3,2,4,3,9,10 OK At+CGQREQ=1,0,,0,0,0 +CGQREQ: 1,0,4,0,0,0 +CGQREQ: 2,2,4,3,9,10 +CGQREQ: 3,2,4,3,9,10 OK

7.2.62

AT+CIMI, Requesting International Mobile Subscriber Identity (IMEI)


AT Command Reaction OK ERROR Remarks <IMSI> +CME ERROR: <err>

AT+CIMI

132

98-08901C39-A

AT Commands

Example AT+CIMI=? OK

7.2.63

AT+CRSM, Restricting SIM Access


AT Command Reaction OK ERROR CRSM: (176), (197, 214, 242, 243) Remarks Only command 176 is supported. +CRSM: <sw1>,<sw2>[,<response>] +CME ERROR: <err> <fileid> 197 IMSI 214 GID1 242 ICC ID 243 GID2 <sw1>, <sw2>:Reason 0 0 Success 0 1 SEEM not allowed: SIM card has been removed or no such element. 0 2 Bad record number: Record number is out of valid range 0 3 Bad PIN: User has entered an incorrect PIN code 0 4 Other technical problem: SIM card malfunction 0 5 Unavailable: Data is temporarily unavailable (initializing) 255 253 Not Allowed: Call processor is still initializing 255 254 Bad Device: Call processor has an internal error 255 255 Locked: Phone is locked by user <response> Response of a successful completion of the command previously issued (hexadecimal character uppercase format). The requested data will be returned.

AT+CRSM=<command>[,<fileid>

AT+CRSM=?

Example AT+CRSM=? CRSM: (176),(197,214,242,243) OK AT+CRSM=176,214 CRSM: 0,0,FFFFFFFFFFFFFFFFFF00 0000000000000000 OK

98-08901C39-A

133

AT Commands

7.2.64

AT+CPOL, Preferred Operator List


AT Command Reaction +CME ERROR: <err> Remarks <index> Integer type; the order number of the operator in the SIM preferred operator list <format> of <oper> 0 Long format alphanumeric 1 Short format alphanumeric 2 Numeric <oper> string type; <format> Indicates whether the format is alphanumeric or numeric

AT+CPOL=[<index>][,<format> [,<oper>]]

AT+CPOL?

+CPOL: <index1>,<format>,<oper1> [<CR><LF>+CPOL: <index2>,<format>,<oper2> [...]] +CME ERROR: <err> +CPOL: (list of supported <index>es),(list of supported <format>s)

AT+CPOL=?

Example AT+CPOL =? +CPOL: (1-32),(0-2) OK AT+CPOL ? +CPOL: 001, 002, 425-01 +CPOL:00 2, 002, 250-99 OK AT+CPOL =1 OK AT+CPOL =1 +CME ERROR: Not found // Index 1 is emptied before test

134

98-08901C39-A

AT Commands

7.2.65

AT+CIPE, ENABLE +CIP AT Command


AT Command Reaction OK +CME ERROR: <err> Remarks <mode> 0 Disable +CIP command 1 Enable +CIP command

AT+CIPE=<mode>

AT+CIPE?

+CIPE: <mode> OK +CIPE: <list of supported modes> OK

AT+CIPE=?

Example AT+CIPE=1 OK AT+CIPE? +CIPE: 1 OK AT+CIPE=? +CIPE: (0, 1) OK

7.2.66 AT+CIP, IP Primitive Over AT Command


AT Command AT+CIP=<Data length> ,<Prim_Id>,<Sub_addr> ,<Data> Reaction +CIP: <Data length>, <Prim id Cnf/ Ind>, <Data> OK Remarks Data length (characters) In decimal Prim_Id - in hex (2 bytes) Sub_addr (Destination) - in hex (2 bytes) Data - in hex Note: 2 characters in 1 byte

+CME ERROR: <err>

Example at+cip=8,a842,0020,00010001 +CIP: 38,a844,0001093033353638343133318105726F6E6974 OK

98-08901C39-A

135

AT Commands

7.2.67

AT+CRTT, Selecting the Ring Tone


AT Command Reaction OK Remarks <RingTypeNumber> 0 Standard 1 British 2 French 3 German 4 Bravo 5 3 Tone 6 Siren 7 Quick 8 1 Ring 9 High 10 Music <operation> 0 Play Set

AT+CRTT= <RingTypeNumber>,<operation>

ERROR AT+CRTT? +CRTT: <RingTypeNumber> OK +CRTT: <list of supported tone type numbers>, <list of supported operations> OK

AT+CRTT=?

Example AT+CRTT=? +CRTT: (0-10), (0,1) OK AT+CRTT=4, 1 OK AT+CRTT? +CRTT: 4 OK

136

98-08901C39-A

AT Commands

7.2.68

AT+CPWD, Changing the Password


AT Command Reaction +CME ERROR: <err> Remarks <fac> string type; facility (upper/lower case acceptable) CS Control surface (keypad) SC SIM card AO Block all outgoing calls OI Block outgoing international calls OX Block outgoing international calls except to home country AI Block all incoming calls IR Block incoming calls when roaming outside home country AB All blocking services AG All outgoing blocking services AC All Incoming blocking services FD SIM fixed dialing feature (not supported) P2 SIM PIN2 <oldpwd>, <newpwd> string type <oldpwd> The same as the password specified for the facility from the ME user interface or using the command Change Password +CPWD. <newpwd> The new password; maximum length of password can be determined with <pwdlength>. <pwdlength> Integer type; maximum length of the password for the facility.

AT+CPWD=<fac>,<oldpwd>, <newpwd>

AT+CPWD=?

+CPWD: list of supported (<fac>,<pwdlength>s) +CME ERROR: <err>

7.2.69

Fax AT Commands
AT Command Function Select mode 0 Data 1 Fax Class 1 Remarks

"FCLASS"

"FAE"

fax_auto_answer

98-08901C39-A

137

AT Commands

AT Command "FRH" "FRM" "FRS" "FTH" "FTM" "FTS"

Function fax_receive_hdlc_data fax_receive_data fax_receive_silence fax_transmit_hdlc_data fax_transmit_data fax_transmit_silence Class 1 Class 1 Class 1 Class 1 Class 1 Class 1

Remarks

7.2.70

AT+MTDTR, DTR Line Test Command


AT Command Reaction Returns 1 when DTR is active and 0 when DTR is not active OK Returns 1 when DTR is active and 0 when DTR is not active

AT+MTDTR AT+MTDTR=? AT+MTDTR?

The command is accepted even when the SIM card is missing.


Note

7.2.71

AT+MTCTS, CTS Line Test Command


AT Command Reaction Remarks Deactivates CTS. Wait approximately 1 second and then activate CTS. OK

AT+MTCTS

AT+MTCTS=?

138

98-08901C39-A

AT Commands

7.2.72

AT+MCWAKE, DTE Wake Line Control Command


AT Command Reaction Remarks <Mode> 0 Send no indication 1 Send indication when GPRS coverage goes off 2 Send indication when GPRS coverage goes on (default) +MCWAKE: (0, 1, 2) +MCWAKE: <Mode>

AT+MCWAKE= <Mode>

AT+MCWAKE=? AT+MCWAKE?

7.2.73 AT+CMSS, Send Message from Storage


AT Command AT+CMSS=<index>[,<da>[,<toda>]] Reaction If PDU mode (+CMGF=0) and sending successful: +CMSS: <mr>[,<scts>] If sending fails: +CMS ERROR: <err> <mr> <scts> <da> <toda> Remarks Message reference Service center time stamp Destination address Type of destination address 129 145

AT+CMSS=?

Example AT+CMSS=1, 054511511 +CMSS: 000

98-08901C39-A

139

AT Commands

7.2.74

AT+MMGL, Message List


AT Command Reaction If PDU mode (+CMGF=0) and command successful: +MMGL: <index>,<stat>,[<alpha>],<length> <CR><LF><pdu> [<CR><LF>+MMGL:<index>,<stat>, [<alpha>],<length><CR><LF><pdu> [...]] If not: +CMS ERROR: <err> +MMGL: (list of supported <stat>s) Remarks <stat> 0 REC UNREAD received unread message 1 REC READ received read message 2 STO UNSENT stored unsent message 3 STO SENT stored sent message 4 ALL all messages

+MMGL[=<stat>]

+MMGL=?

This new AT command returns the SMS message list without changing the message status from unread to read. It is used in the same way as +CMGL.
Note

This command is supported in software versions above E6.01.10.

7.2.75 AT+MMGR, Read Message


AT Command +MMGR=<index> Reaction If PDU mode (+CMGF=0) and command successful: +MMGR: <stat>,[<alpha>],<length><CR><LF><pdu> If not: +CMS ERROR: <err> OK

+MMGR=?

This new AT command returns the SMS message list without change the message status from unread to read. It is used in the same way as +CMGL.
Note

This command is supported in software versions above E6.01.10.

140

98-08901C39-A

AT Commands

7.2.76

AT+MMGA, Changing the Message Attributes


AT Command Reaction OK +CME ERROR: <err> Remarks <index> An integer between 1 and 75 <attribute> 0 <received-unread> 1 <received-read>

+MMGA = <index>, <attribute>

+MMGA =?

+MMGA: (001 075), (000-001) OK +CME ERROR: <err>

This command is supported in software versions above E6.01.10.


Note

SMS attributes can be one of the following: received-unread, received-read, stored-sent, and stored-unsent. Since there are new AT commands: MMGR & MMGL that return the message without changing its attribute from receivedunread to received-read, this set command can be used to change the specific message attribute from receivedunread to received-read and vice versa. The test command returns the entire available <index>es and <attribute>s supported by this command.

98-08901C39-A

141

AT Commands

142

98-08901C39-A

You might also like