Wireless GSM/GPRS Modems MultiModem® GPRS (MTCBA-G) MMCModem™ GPRS (MTMMC-G) SocketModem ® GPRS (MTSMC-G) AT Commands Reference Guide
Copyright and Technical Support AT Commands for Wireless GSM/GPRS Modems Reference Guide These Commands Apply to the Following Products: MultiModem® GPRS (MTCBA-G) MultiModem® GPRS-USB (MTCBA-G-U) MultiModem® GPRS with Ethernet Interface (MTCBA-G-EN) MMCModem™ GPRS (MTMMC-G) SocketModem® GPRS (MTSMC-G) PN S000293I, Revision I Copyright This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi-Tech Systems, Inc. All rights reserved.
Table of Contents Contents Chapter 1 – Introduction................................................................................................................................................ 9 Scope of This Document ............................................................................................................................................ 9 Related Documents .................................................................................................................................
Table of Contents Chapter 6 – Network Service Commands .................................................................................................................. 31 Signal Quality +CSQ ............................................................................................................................................... 31 Operator Selection +COPS ....................................................................................................................................
Table of Contents Cell Broadcast Message Identifiers +WCBM..........................................................................................................75 Message Status Modification +WMSC ................................................................................................................... 75 Message Overwriting +WMGO...............................................................................................................................
Table of Contents Display Configuration &V ..................................................................................................................................... 105 Request Identification Information I ...................................................................................................................... 105 Multiplexing Mode +WMUX ...................................................................................................................................
Table of Contents Chapter 15 – GPRS commands ................................................................................................................................ 149 Define PDP Context +CGDCONT ........................................................................................................................ 149 Quality of Service Profile Requested +CGQREQ ..................................................................................................
Table of Contents Supplementary Services Commands ..................................................................................................................... 195 Data Commands .................................................................................................................................................... 195 V24-V25 Commands ..............................................................................................................................................
Chapter 1 – Introduction Chapter 1 – Introduction Scope of This Document This document describes the AT-command based messages exchanged between an application and the Multi-Tech Systems, Inc. products in order to manage GSM-related events or services. Related Documents This interface specification is based on the following recommendations: [1] ETSI GSM 07.
Chapter 2 – AT Command Features Chapter 2 – AT Command Features Line Settings A serial link handler is set with the following default values (factory settings): • Autobaud • 8 bits data • 1 stop bit • no parity • RTS/CTS flow control Please use the +IPR, +IFC and +ICF commands to change these settings. Command Line Commands always start with AT (which means ATtention) and finish with a character.
Chapter 3 – General Behaviors Chapter 3 – General Behaviors SIM Card Insertion and Removal Procedures SIM card Insertion and Removal procedures are supported. Software functions rely on positive reading of the hardware SIM detect pin. This pin state (open/closed) is permanently monitored. When the SIM detect pin indicates that a card is present in the SIM connector, the product tries to set up a logical SIM session.
Chapter 3 – General Behaviors Since the maximum length for the numbers in the ADN, FDN, and LND phonebooks is 60 digits: • if the user tries to dial a number that exceeds 60 digits: +CME: 3 Before the user can perform a call, the number of free records in the EFEXT1 is checked for availability of free space to store this number. • If there are free records left, the call is setup. • Otherwise, +CME: 20 error is returned (Memory Full). See Recommendation 3GPP 11.11 for more details.
Chapter 4 – General AT Commands Chapter 4 – General AT Commands Manufacturer Identification +CGMI Description: Values: Syntax: Displays the manufacturer identification. No parameters AT+CGMI Command AT+CGMI Note: Get manufacturer identification Possible responses WAVECOM MODEM OK Note: Command valid, Wavecom modem Request Model Identification +CGMM Description: Values: Syntax: Displays the supported frequency bands. With multi-band products the response may be a combination of different bands.
Chapter 4 – General AT Commands Product Serial Number +CGSN Description: Values: Syntax: Allows the user application to get the IMEI (Interrnational Mobile Equipment Identity, 15-digit number) of the product.
Chapter 4 – General AT Commands Request IMSI +CIMI Description: Values: Syntax: Reads and identifies the IMSI (International Mobile Subscriber Identity) of the SIM card. The PIN may need to be entered before reading the IMSI.
Chapter 4 – General AT Commands Power Off +CPOF Description: Values: Syntax: Stops the GSM software stack as well as the hardware layer or modem activity. The AT+CFUN=0 command is equivalent to +CPOF. No parameters AT+CPOF[=1] Command AT+CPOF Note: Stop GSM stack AT+CPOF=1 Note: Stop the modem Possible responses OK Note: Command valid OK Note: Command valid Note: After AT+CPOF[=1], the modem will not respond to AT commands. To reset it, use the hard reset.
Chapter 4 – General AT Commands Phone Activity Status +CPAS Description: Values: Syntax: Returns the activity status of the mobile equipment.
Chapter 4 – General AT Commands Clock Management +CCLK Description: Values: Syntax: Sets or gets the current date and time of the ME real-time clock. String format for date/time is “yy/MM/dd,hh:mm:ss” Note: Valid years are 98 (for 1998) to 97 (for 2097). The second field is not mandatory. Default st date/time is “98/01/01,00:00:00” (January 1 , 1998 / midnight).
Chapter 5 – Call Control Commands Chapter 5 – Call Control Commands Dial Command D Description: The ATD command sets a voice or data call. As per GSM 02.30, the dial command also controls supplementary services. Data Calls For a data call, the application sends the following ASCII string to the product (the bearer must be previously selected with the +CBST command): ATD where is the destination phone number.
Chapter 5 – Call Control Commands Direct Dialing from a Phonebook (stored in the SIM card) can be performed with the following commands: ATD> ; to call from the selected phonebook (by the +CPBS command) ATD> “BILL”; to call “BILL” from the selected phonebook ATD> mem allows direct dialing from a phonebook number is SM, LD, MC, ME, RC, MT or SN.
Chapter 5 – Call Control Commands Answer a Call A Description: Values: Syntax: When the product receives a call, it sets the RingInd signal and sends the ASCII “RING” or “+CRING: ” string to the application (+CRING if the cellular result code +CRC is enabled). Then it waits for the application to accept the call with the ATA command. No parameters.
Chapter 5 – Call Control Commands Syntax: AT+VTD= Command AT+VTD=6 Note: To define 600 ms tone duration AT+VTD=0 Note: To set the default value (70 ms ± 5 ms) AT+VTD? Note: Query current tone duration AT+VTD=? Possible responses OK Note: Command valid OK AT+VTD: OK AT+VTD: <0-255> OK +VTDS Description: The product enables the user application to send DTMF tones over the GSM network. This command enables tones to be transmitted only when there is an active call.
Chapter 5 – Call Control Commands Automatic Dialing with DTR %D Description: This command enables and disables: • Automatic dialing of the phone number stored in the first location of the ADN phonebook, (or FDN phonebook, if it is activated using the +CLCK command). • Automatic sending of the short message (SMS) stored in the first location of the SIM. The number is dialed when the DTR OFF switches ON. The short message is sent when DTR OFF switches ON.
Chapter 5 – Call Control Commands Incoming Call Bearer +CICB Description: Values: Syntax: This command sets the type of incoming calls when no incoming bearer is given (see +CSNS). Note: Setting the +CICB command affects the current value of +CSNS.
Chapter 5 – Call Control Commands The application sends the following: AT+VGR= for receive gain 0 to 15 16 to 31 32 to 47 48 to 63 64 to 79 80 to 95 96 to 111 112 to 127 128 to 143 144 to 159 160 to 175 176 to 191 192 to 207 208 to 223 224 to 255 +6 db +4 db +2 db +0 db -2 db -4 db -6 db -8 db -10 db -12 db -14 db -16 db -18 db -20 db -22 db AT+VGT= Controller 1 0 to 31 32 to 63 64 to 95 96 to 127 128 to 159 160 to 191 192 to 223 224 to 255 for transmit gain Controller 1 +30 db +33 db +36 db +3
Chapter 5 – Call Control Commands Microphone Mute Control +CMUT Description: This command mutes the microphone input on the product (for the active microphone set with the +SPEAKER command). This command is only allowed during a call. Values: 0 microphone mute off (default value). 1 microphone mute on.
Chapter 5 – Call Control Commands Echo Cancellation +ECHO Description: This command enables, disables or configures the Echo Cancellation functions for voice calls (in rooms, in cars, etc.). It is necessary to tune the Microphone gain (AT+VGT) and the Speaker gain (AT+VGR) before activating the Echo Cancellation.
Chapter 5 – Call Control Commands ♦ Convergence time in quiet condition: This parameter expresses duration as the number of GSM speech frames (20 ms each) containing far end speech, upon which the switch only mechanism must run in quiet conditions. The allowed range is [162 - 32767]. The default is 200. ♦ Convergence time in noise condition: This parameter is the same as ConvergenceTime1 but for the noise condition. The allowed range is [162 - 32767].
Chapter 5 – Call Control Commands Syntax: Command Syntax: For Algold=1: AT+ECHO=[,[,,,,]] For Algold=6: AT+ECHO=[,[,,,,,,,,,,,,]] Response Syntax: For Algold=1: ECHO: ,,,,, For Algold=6: ECHO: ,,,,
Chapter 5 – Call Control Commands SideTone Modification +SIDET Description: This command sets the level of audio feedback in the speaker (microphone feedback in the speaker).
Chapter 6 – Network Service Commands Chapter 6 – Network Service Commands Signal Quality +CSQ Description: This command determines the received signal strength indication () and the channel bit error rate () with or without a SIM card inserted. Values: : 0 1 2 to 30 31 99 -113 dBm or less -111 dBm -109 to –53 dBm -51dBm or greater not known or not detectable : 0…7: 99 as RXQUAL values in the table GSM 05.
Chapter 6 – Network Service Commands Operator identifier (MCC/MNC in numeric format only for operator selection) The long alphanumeric format can be up to 16 characters long (see Codes and Values Appendix for operator names description, field is “Name”). The short alphanumeric format can be up to 8 characters long.
Chapter 6 – Network Service Commands Network Registration +CREG Description: This command is used by the application to ascertain the registration status of the product. Values: 0 Disable network registration unsolicited result code (default) 1 Enable network registration code result code +CREG: 2 Enable network registration and location information unsolicited result code +CREG: ,, if there is a change of network cell.
Chapter 6 – Network Service Commands Syntax: Command Syntax: AT+WOLM=,,[,,, Response Syntax for AT+WOLM=? OK Response Syntax for AT+WOLM? (lists all the available PLMN) Command AT+WOLM=1,1,20812,”WM”,”WM PLMN” Note: Add a new PLMN at location 1 AT+WOLM=2,1 Note: Read the PLMN at location 1 AT+WOLM=2,11 Note: Read the PLMN at location 11 AT+WOLM=1,1,20812,”WM1”,”WM1 PLMN” Note: Modify and existing PLMN AT+WOLM=? Note: Test command AT+WOLM? Note: Display current lis
Chapter 6 – Network Service Commands Values: 0 Use long alphanumeric format 1 Use short alphanumeric format 2 Reserved for future use 3 Erase NITZ PLMN list if = 0 4 Access to EEPROM to read or write the method to use for getting PLMN names Read access if omitted Write access if (=) provided. is the operator in numeric format. is the operator in long or short alphanumeric format (see Codes and Values for Operator Names in the Appendix).
Chapter 6 – Network Service Commands Syntax: Command syntax: AT+WOPN=,[,] Response syntax: +WOPN: , Command AT+WOPN=? Note: Test command AT+WOPN=0,20801 Note: Give an operator in numeric format Possible responses OK +WOPN: 0,”Orange F” OK Note: Alphanumeric answer AT+WOPN=0,99999 +CME ERROR: 22 Note: Give a wrong operator Note: Not found AT+WOPN=0,2081,36 +WOPN: 0, “OrangeF” Note: Give an operator in numeric format for lac 36 OK Note: Alphanumeric answer AT+WOPN=3
Chapter 6 – Network Service Commands Preferred Operator List +CPOL Description: This command edits (or updates) the SIM preferred list of networks. This list is read in the SIM file selected by the command AT+CPLS. Values: : position of the operator record in the Sim preferred operator list. Use AT+CPOL=? to view the maximum index of the selected EF.
Chapter 6 – Network Service Commands Command AT+CPOL? Note: Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL? Note: Ask for preferred list of networks With EF_PLMNwAct selected and present AT+CPOL=,0 Note: Select long alphanumeric format AT+CPOL? Note: Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=7,2,20801 Note: Add a network to the list AT+CPOL? Note: Ask for preferred list of networks With only EF_PLMNsel present AT+CPOL=7 Note: Delete 7th location AT+C
Chapter 6 – Network Service Commands Read Operator Name +COPN Description: This command returns the list of all operator names (in numeric and alphanumeric format) stored in the module. Values: : is the operator in numeric format : is the operator in long alphanumeric format Syntax: Command Syntax: AT+COPN Response Syntax: +COPN: , Command AT+COPN Note: Ask for list of operators AT+COPN=? Possible responses +COPN: 23201,”A1” +COPN: 23203,”Amax.
Chapter 7 – Security Commands Chapter 7 – Security Commands Enter PIN +CPIN Description: This command enters the ME passwords (CHV1 / CHV2 / PUK1 / PUK2, etc.), that are required before any ME functionality can be used. CHV1/CHV2 is between 4 and 8 digits long, PUK1/PUK2 is only 8 digits long. If the user application tries to make an outgoing call before the SIM PIN code (CHV1) has been confirmed, then the product will refuse the “ATD” command with a “+CME ERROR: 11” (SIM PIN required).
Chapter 7 – Security Commands Example: Three failed PIN validations + one successful PUK validation AT+CPIN? Read the PIN status +CPIN: SIM PIN The product requires SIM PIN AT+CPIN=1235 First attempt to enter a SIM PIN +CME ERROR: 16 Wrong PIN AT+CPIN=1236 Second attempt +CME ERROR: 16 Wrong PIN AT+CPIN=1237 Third attempt +CME ERROR: 16 Wrong PIN AT+CPIN? +CPIN: SIM PUK Read PIN state The product requires PUK AT+CPIN=99999999,5678 OK AT+CPIN? +CPIN: READY The PUK is entered, the new PIN shall be 5678 PUK
Chapter 7 – Security Commands Enter PIN2 +CPIN2 Description: Values: Syntax: This command validates the PIN2 code (CHV2) or the PUK2 code (UNBLOCK CHV2) and defines a new PIN2 code. Of course, the +CPIN command allows PIN2 or PUK2 codes to be validated, but only when the last command executed resulted in PIN2 authentication failure. PIN2 length is between 4 and 8 digits; PUK2 length is 8 digits only.
Chapter 7 – Security Commands Facility Lock +CLCK Description: This command locks, unlocks or interrogates an ME or network facility . Note: Test SIM cards (with MCC=001 & MNC=01) do not check “PS”, “PN”, “PU”, “PP” and “PC” locks. Values: supported facilities: “PS”: SIM lock facility with an 8-digit password. “SC“: PIN enabled ( = 1) / disabled ( = 0) “AO”: BAOC (Barr All Outgoing Calls) “OI”: BOIC (Barr Outgoing International Calls) “OX”: BOIC-exHC (Barr Outgoing.
Chapter 7 – Security Commands Change Password +CPWD Description: Values: Syntax: This command changes a password (PIN, call barring, NCK, etc.). The facility values () are the same as for the +CLCK command with a “P2” facility to manage SIM PIN2. For the network lock (“PN”), unlocking is forbidden after 10 failed attempts to disable (unlock) the network lock with an incorrect password. supported facilities: “PS”: SIM lock facility with an 8-digit password.
Chapter 8 – Phonebook Commands Chapter 8 – Phonebook Commands Introduction to Phonebook Commands A phonebook group can hold up to 100 entries. These entries can come from different phonebooks (SIM and/or Flash phonebook). When a SIM is inserted, the phonebook selected by default is set by the command +CPBS.
Chapter 8 – Phonebook Commands Select Phonebook Memory Storage +CPBS Description: This command selects phonebook memory storage. Note on ADN and FDN activation: When FDN has been activated with the +CLCK command, the selection of ADN phonebook is possible only if ADN staus bit3 is set to 1 (EF file “is readable and can be updated when invalidated”). Please refer to Recommendation 3GPP 11.11 for more details.
Chapter 8 – Phonebook Commands Read Phonebook Entries +CPBR Description: This command returns phonebook entries for a range of locations from the current phonebook memory storage selected with +CPBS. Note: For all phonebook read commands (+CPBR, +CPBF, +CPBN, +CPBP, +CNUM), the TON/NPI MSB of each number is set to 1 (ex: a TON/NPI stored as 17 is displayed as 145). If the AT+WCOS =1 command has been used, the response will include structure.
Chapter 8 – Phonebook Commands CPBR Command Table Continued Command AT+CPBS=”SM” Note: ADN phonebook AT+CPBR=1 AT+CPBW=1,”0123456”,, ”test”,1 Note: Add an external entry in the SIM with group number (1) AT+CPBR=1 Possible responses OK +CPBR=1,”0123456”,129,”test” OK OK +CPBR=1”0123456”,129,”test”,1 OK Multi-Tech Systems, Inc.
Chapter 8 – Phonebook Commands Write Phonebook Entry +CPBW Description: This command writes a phonebook entry in location number in the current phonebook memory storage. Notes: • “RC” and “MC” phonebooks could be erased only by +CPBW. Adding a field and/or modifying a field is not allowed for these phonebooks. • This command is not allowed for “EN”, “LD”, “MC”, “RC”, “MT”, and “SN” phonebooks (they cannot be written).
Chapter 8 – Phonebook Commands +CPBW Command Table Continued Command AT+CPBW=5,”01290917”,129,”Jacky” Note: Overwrite location 5 AT+CPBW=6,”01292349”,129,”8000410042” Note: write location 6 (UCS2 format for the field) AT+CPBW=8,”01292349”,129,”80xyz” Note: write location AT+CPBW=5,”01290917”,129,”Jacky” Note: write an extended entry AT+WCOS=1 Note: Phonebook extended AT+CPBW=5,”01290917”,129,”Jacky”1 Note: Write an extended entry AT+WCOS=0 Note: Phonebook not extended AT+CPBS=”ME” Note: ME Phonebook
Chapter 8 – Phonebook Commands +CPBW Command Table Continued Command AT+CPBR=1 AT+CPBW=1,”0123456,,”test”,1 Note: Add an extended entry in SIM with group number 1 AT+CPBR=1 Possible responses +CPBR:1,”0123456,”129,”test” OK OK +CPBR:1,”0123456,”129,”test”,1 OK OK AT+CPBW=13,”+331290909”,145,”Fred”, ”0141284549”,129,“0600003210”,129,”0141280000”, 129, “019876543210”,129, fred@mail_address.
Chapter 8 – Phonebook Commands Find Phonebook Entries +CPBF Description: This command returns phonebook entries with alphanumeric fields starting with a given string. The AT+CPBF= “” command can be used to display all phonebook entries sorted in alphabetical order. This command is not allowed for "LD", "RC", "MC" phonebooks and for the “EN” phonebook, which does not contain alphanumeric fields. It is possible to use this command with UCS2 strings.
Chapter 8 – Phonebook Commands Phonebook Phone Search +CPBP Description: This command orders the product to search the phonebook for an item with the same phone number as that defined in the parameter. The searched phone number is the FIRST one that the user can enter with AT+CPBW. For example, with this command strin, we can search only the phone number (+331290909): AT+CPBW=13,”+331290909”,145,”Fred”,”0141284549”,129,“0600003210”,129,”0141280000”, 129, “019876543210”,129,fred@mail_address.
Chapter 8 – Phonebook Commands AT+CPBP= continued Command Possible responses AT+WCOS=1 OK Note: Phonebook extended AT+CPBP=”Test” +CPBF: 1,”0123456789”,129,”Test Note: Read entries with “Test” ME”,”9876543210”,129,””,””,””,email@mail_address.com,”post address’,0 Note: Display locations with text field starting with “Test”, extended entry. Move Action in Phonebook +CPBN Description: This specific command performs a forward or backward move in the phonebook (in alphabetical order).
Chapter 8 – Phonebook Commands Using mode 4 and 5 with +CPBF command and CPBW: Command Possible responses AT+CPBF=”Er” +CPBF: 15,”+331290101”,145,”Eric” Note: Find ”Er” in phonebook OK Note: Display the location AT+CPBN=2 +CPBN: 5,”+33147658987”,145,”Frank” Note: Read the next location OK Note: Display the following location AT+CPBF=”Er” +CPBF: 15,”+331290101”,145,”Eric” Note: Find ”Er” in phonebook OK Note: Display the location AT+CPBN=4 +CPBF: 15,”+331290101”,145,”Eric” Note: Get the last location read OK
Chapter 8 – Phonebook Commands Avoid Phonebook Initialization +WAIP Description: Values: Syntax: This specific command allows the initialization of all phonebooks to be inhibited during subsequent boots.
Chapter 8 – Phonebook Commands Contact Selector +WCOS Description: This commands enables/disables the displaying of extended contact. Values: 0 Select the SIM contacts 1 Select the extended contacts for phonebook entries 2 Internal use only.
Chapter 8 – Phonebook Commands Read a Phonebook Group +WPGR Description: This commands reads the phonebook group entries, the phonebook group name or the number or used records in a group.
Chapter 8 – Phonebook Commands Settings of a Phonebook Group +WPGS Description: This commands sets the parameters of a phonebook group. Values: 0 Read group settings 1 Write group settings Index of the group Parameter is optional if =1. 0 All refused. Incoming call is forwarded to the voice mailbox 1 All accepted.
Chapter 9 – Short Messages Commands Chapter 9 – Short Messages Parameters Definition - Destination Address, coded according to the GSM Technical Specification 03.
Chapter 9 – Short Messages Commands Select Message Service +CSMS Description: The Supported Services include originated (SMS-MO) and terminated short messages (SMS-MT) as well as Cell Broadcast Message (SMS-CB) services. Values: 0 SMS AT commands are compatible with GSM 07.05 Phase 2 version 4.7.0. 1 SMS AT commands are compatible with GSM 07.05 Phase 2 + version .
Chapter 9 – Short Messages Commands Example of New Message Acknowledgement in PDU Mode: Command AT+CSMS=1 Note: SMS AT Commands compatible with GSM 07.05 Phase 2 + version AT+CMGF=0 Note: Set PDU mode AT+CNMI=2,2,0,0,0 Note: =2 AT+CNMA=2,2 >00D3 Note: Negative ACK to the SMS. Reason is: memory capacity exceeded AT+CNMA=2,2 >00D3 Note: Negative ACK to the SMS. Reason is: SIM memory storage is full AT+CNMA=2,2 >00D3 Note: Negative ACK to the SMS.
Chapter 9 – Short Messages Commands Preferred Message Storage +CPMS Description: This command allows the message storage area to be selected (for reading, writing, etc). Values: : SM ME BM SR Memory used to list, read and delete messages. It can be: SMS message storage in SIM (default) SMS message storage in Flash CBM message storage (in volatile memory).
Chapter 9 – Short Messages Commands Command Syntax: AT+CPMS=,[],[] continued Command AT+CPMS= “SM” Note: Selecting SM for reading, writing and storing has not changed AT+CPMS? Possible responses +CPMS: “4,10,4,99,4,99 OK +CPMS: “SM”,4,10,”ME”,4,99,”ME”,4,99 OK Note: Read SMS from SIM. Write and store SMS from/to flash Preferred Message Format +CMGF Description: The message formats supported are text mode and PDU mode.
Chapter 9 – Short Messages Commands Save Settings +CSAS Description: All settings specified by the +CSCA and +CSMP commands are stored in EEPROM if the SIM card is a Phase 1 card or in the SIM card if it is a Phase 2 SIM card.
Chapter 9 – Short Messages Commands New Message Indication +CNMI Description: This command selects the procedure for message reception from the network. Values: Controls the processing of unsolicited result codes Important Note: Only =2 is supported. Any other value for (0,1 or 3) is accepted (return code will be OK), but the processing of unsolicited result codes will be the same as with =2. 0 Buffer unsolicited result codes in the TA.
Chapter 9 – Short Messages Commands Syntax: Command Syntax: AT+CNMI=,,,, Command Possible responses AT+CNMI=2,1,0,0,0 Note: =1 OK AT+CNMI=2,2,0,0,0 Note: =2 AT+CNMI=2,0,0,1,0 Note: =1 AT+CMGS=”+33146290800” Happy Birthday! Note: Send a message in text mode AT+CMTI: “SM”,1 Note: message received OK +CMT: “123456”,”98/10/01,12:30 00+00”,129,4,32,240, “15379”,129,5 Note: message received OK +CMGS: 7 OK Note: Successful transmission +CDS: 2, 116, ”+
Chapter 9 – Short Messages Commands Read Message +CMGR Description: This command allows the application to read stored messages. The messages are read from the memory selected by the +CPMS command.
Chapter 9 – Short Messages Commands List Message +CMGL Description: This command allows the application to read stored messages, by indicating the type of the message to read. The messages are read from the memory selected by the +CPMS command.
Chapter 9 – Short Messages Commands Send Message +CMGS Description: The
field is the address of the terminal to which the message is sent. To send the message, simply type, character (ASCII 26). The text can contain all existing characters except and (ASCII 27). This command can be aborted using the character when entering text. In PDU mode, only hexadecimal characters are used (‘0’…’9’,’A’…’F’).Chapter 9 – Short Messages Commands Write Message to Memory +CMGW Description: This command stores a message in memory (either SMS-SUBMIT or SMS-DELIVERs). The memory location is returned (no choice possible as with phonebooks +CPBW). Text or PDU is entered as described for the Send Message +CMGS command.
Chapter 9 – Short Messages Commands Send Message from Storage +CMSS Description: This command sends a message stored at location value . Values: Syntax: Command syntax: AT+CMSS=[, [,] ] Response syntax: +CMSS: or +CMS ERROR: if sending fails If a new recipient address is given, it will be used instead of the one stored with the message.
Chapter 9 – Short Messages Commands Syntax: Command Syntax: AT+CSMP=, , , Command Possible responses AT+CSMP? +CSMP: 0,0,0,0 OK Note: current values Note: No validity period = PCCP437 alphabet (8 bits Æ 7 bits) AT+CMPS=17,23,64,244 OK Note: = 23 (2 hours, relative format) Note: Command correct = GSM 8 bits alphabet Reminder: Enter value in decimal format Delete Message +CMGD Description: This command deletes one or several messages from preferred message storage (“B
Chapter 9 – Short Messages Commands Service Center Address +CSCA Description: This command indicates the service center to which the message must be sent. The product has no default value for this address. If the application tries to send a message without having indicated the service center address, an error will be generated. Therefore, the application must indicate the SC address when initializing the SMS. This address is then permanently valid. The application may change it if necessary.
Chapter 9 – Short Messages Commands Cell Broadcast Message Identifiers +WCBM Description: This specific command is used to read the EF-CBMI SIM file. The EF-CBMI file is not used with the +CSCB command. The application should read this file (using AT+WCBM ?) and combine the Message Identifiers with those required by the application.
Chapter 9 – Short Messages Commands Message Overwriting +WMGO Description: The +CMGW command specifies a location in the SMS or Flash memory for the next SMS to be stored when the +CMGW indicates a message is ready to be stored. The defined location is used only once: +WMGO has to used again to perform another overwrite.
Chapter 9 – Short Messages Commands Change or Do Not Change SMS Status +WUSS Description: The +WUSS command allows the SMS Status to be kept at UNREAD after the +CMGR or +CMGL commands are used.
Chapter 9 – Short Messages Commands Copy Messages +WMCP Description: This command copies the SMS from the SIM to the Flash or from the Flash to the SIM.
Chapter 9 – Short Messages Commands Command Syntx: AT+WMCP=[,] Continued Command AT+CPMS=”ME” Note: Select ME for reading AT+CMGD=0,4 Note: Erase all the SMS stored in the Flash AT+CPMS? Note: Read the SMS storage AT+WMCP=0 Note: Copy all the SMS from the SIM to the Flash AT+CPMS? Note: Read the SMS storage Possible responses +CPMS: 2,99,2,99,4,10 OK OK +CPMS: “ME”,0,99,”ME”,0,99,”SM”,4,10 OK Note: No SMS is stored in the Flash OK +CPMS: “ME”,4,99,”ME”,4,99,”SM”,4,10 OK Note: 4 SMS are stored
Chapter 10 – Supplementary Services Commands Chapter 10 – Supplementary Services Commands Call Forwarding +CCFC Description: This commands allows control of the "call forwarding" supplementary service.
Chapter 10 – Supplementary Services Commands Call Barring +CLCK Description: This command allows control of the call barring supplementary service. Locking, unlocking or querying the status of call barring is possible for all classes or for a specific class, but not for a combination of some.
Chapter 10 – Supplementary Services Commands Call Waiting +CCWA Description: This command controls the call waiting supplementary service. The product will send a +CCWA unsolicited result code when the call waiting service is enabled. Values: : result code presentation status in the TA 0 Disable 1 Enable 0 Disable 1 Enable 2 Query status 0 Type of address byte in integer format (refer to Rec GSM 04.08 [8] sub clause 10.5.4.
Chapter 10 – Supplementary Services Commands Calling Line Identification Restriction +CLIR Description: This command controls the Calling Line Identification restriction supplementary service.
Chapter 10 – Supplementary Services Commands Connected Line Identification Presentation +COLP Description: This command controls the connected line identification presentation supplementary service - useful for call forwarding of the connected line.
Chapter 10 – Supplementary Services Commands Advice of Charge +CAOC Description: This refers to the Advice of Charge supplementary service (GSM 02.24 and GSM 02.86), which enables the subscriber to obtain information on call cost. With =0, the command returns the current call meter value (CCM) from the modem (ME). If AOC is supported, the command can also enable unsolicited event reporting on CCM information. The unsolicited result code +CCCM: is sent when the CCM value changes.
Chapter 10 – Supplementary Services Commands Accumulated Call Meter Maximum +CAMM Description: The set command sets the Advice of Charge related to accumulated call meter maximum value in SIM file EFACMmax. ACMmax contains the maximum number of home units the subscriber is allowed to consume. When ACM (see +CACM) reaches ACMmax, calls are prohibited. SIM PIN2 is required to set the value. If setting fails in an ME error, +CME ERROR: is returned. The Read command returns the current value of ACMmax.
Chapter 10 – Supplementary Services Commands Call Related Supplementary Services +CHLD Description: This command manages call hold and multiparty conversation (conference call). Calls can be put on hold, recovered, released or added to a conversation. Values: 0 1 1x 2 2x 3 4 Syntax: Release all held calls or set User Determined User Busy (UDUB) for a waiting call. Release all active calls (if any exist) and accepts the other (held or waiting) call.
Chapter 10 – Supplementary Services Commands List Current Calls +CLCC Description: This command returns a list of current calls. Values: integer type, call identification as described in GSM 02.
Chapter 10 – Supplementary Services Commands Supplementary Service Notifications +CSSN Description: This command refers to supplementary service related network initiated notifications.
Chapter 10 – Supplementary Services Commands Unstructured Supplementary Service Data +CUSD Description: Values: Syntax: The USSD supplementary service is described in GSM 02.90. It is based on sequences of digits which may be entered by a mobile user with a handset. A sequence entered is sent to the network which replies with an alphanumerical string, for display only, or for display plus request for the next sequence.
Chapter 10 – Supplementary Services Commands Closed User Group +CCUG Description: Values: Syntax: The Closed User Group Supplementary Service enables subscribers to form closed user groups with restricted access (both access to and from). The CUG supplementary service is described in GSM 02.85. This service is provided on prior arrangement with the service provider. Subscription options should be selected at implementation.
Chapter 11 – Data Commands Chapter 11 – Data Commands Using AT Commands During a Data Connection To use AT Commands during a data connection (such as while the product is in online mode), it is necessary either to switch to offline mode, or to use the +WMUX command to enable Commands / Data multiplexing. Switch from Online to Offline Mode To switch from online mode to offline mode, the “+++” sequence must be sent.
Chapter 11 – Data Commands Bearer Type Selection +CBST Description: Values: Syntax: This command applies to both outgoing and incoming data calls, but in a different way. For an outgoing call, the two parameters (e.g., and ) apply; whereas, for an incoming call, only the parameter applies. Notes: • For incoming calls, if is set to T, only and the network offers NT only or vice versa. Then the call is released.
Chapter 11 – Data Commands Select Mode +FCLASS Description: This command puts the product into a particular operating mode (data or fax).
Chapter 11 – Data Commands Cellular Result Codes +CRC Description: This command shows more detailed ring information for an incoming call (voice or data). Instead of the string “RING”, an extended string is used to indicate which type of call is ringing (e.g. +CRING: VOICE). These extended indications are: +CRING: ASYNC for asynchronous transparent +CRING: REL ASYNC for asynchronous non-transparent +CRING: VOICE for normal speech.
Chapter 11 – Data Commands Radio Link Protocol Parameters +CRLP Description: This command changes the radio link protocol parameters used for non transparent data transmission.
Chapter 11 – Data Commands Select Data Compression %C Description: This command enables or disables data compression negotiation if this feature is supported on the product.
Chapter 11 – Data Commands V42bis Data Compression Report +DR Description: This command determines whether or not the use of V42bis is allowed for an incoming or outgoing data call, if this feature is provided by the product. The intermediate result code represents current DCE-DCE data compression type. The format of this result code is as follows: +DR: NONE Data compression is not in use +DR: V42B Rec. V.42 bis is in use in both directions +DR: V42B RD Rec. V.
Chapter 12 – V.24 and V.25 Commands Chapter 12 – V.24 and V.25 Commands Important All commands described hereafter will to the currently selected (and used) UART. Fixed DTE Rate +IPR Description: This commands specifies the data rate at which the DCE will accept commands. Notes: • The serial autobauding feature is supported and covers the following serial speeds only: 2400, 4800, 9600, 19200, 38400, 57600 bps. Beyond those serial speeds, proper operation of the modem is not guaranteed.
Chapter 12 – V.24 and V.25 Commands DTE-DCE Character Framing +ICF Description: This command determines the local serial port start-stop (asynchronous) character framing that the DCE uses.
Chapter 12 – V.24 and V.25 Commands DTE-DCE Local Flow Control +IFC Description: This command is controls the operation of local flow control between the DTE and DCE.
Chapter 12 – V.24 and V.25 Commands Set DTR Signal &D Description: This commands controls the Data Terminal Ready (DTR) signal.
Chapter 12 – V.24 and V.25 Commands DCE Response Format V Description: This command determines the DCE response format, with or without header characters . Result codes are provided as numeric or verbose.
Chapter 12 – V.24 and V.25 Commands Auto-Tests &T Description: This command runs various auto-tests. Values: 0 1 2 Syntax: Perform software auto-tests The response will be OK if no software problem is detected (EEPROM, RAM, and ROM checksums); otherwise, a simple ERROR response is sent.
Chapter 12 – V.24 and V.25 Commands Display Configuration &V Description: This command is used to display the modem configuration. Values: 0 Displays the modem configuration in RAM. Default value if no parameter provided. 1 Displays the modem configuration in EEPROM. 2 Displays the modem factory configuration.
Chapter 12 – V.24 and V.25 Commands Multiplexing Mode +WMUX Description: This command manages the data/AT commands in multiplexing mode. See Appendix B for the Data/Commands multiplexing protocol description. Values: 0 Multiplexing disabled. When the product is online (data communication in progress), no AT command can be used (default). 1 Multiplexing enabled. Data flows and AT commands are multiplexed while in online mode (data communication in progress).
Chapter 13 – Specific AT Commands Chapter 13 – Specific AT Commands Cell Environment Description +CCED Description: This command can be used by the application to retrieve the parameters of the main cell and of up to six neighboring cells. There are two possible methods for the external application to determine these cell parameters: • On request by the application • Automatically by the product every 5 seconds. Automatic mode is not supported during registration.
Chapter 13 – Specific AT Commands • Combination of the requested dump is supported (addition of the values 1, 2, 4, and 8): Value Requested Dump 1 +CCED response: Main Cell only 2 +CCED response: Neighbors 1 to 6 3 +CCED response: Main Cell; then Neighbors 1 to 6 +CCED response: Timing Advance Only 4 5 6 7 8 +CCED response: Main Cell; then Timing Advance +CCED response: Neighbors 1 to 6; then Timing Advance +CCED response: Main Cell; then Neighbors 1 to 2, then Timing Advance +CSQ response: Main Cell
Chapter 13 – Specific AT Commands General Indications +WIND Description: This command provides a general mechanism to send unsolicited non-standardized indications to the application. The indicators are: • Indication of a physical change on the SIM detect pin from the connector (meaning SIM inserted, SIM removed) • Indication during mobile originated call setup that the calling party is ringing. • Indication of the availability of the product to receive AT commands after boot.
Chapter 13 – Specific AT Commands 14 15 16 The rack has been detected as Open. The modem received a NITZ information message from the network. SMS and SMS CB services are ready. For Event 10: : SIM phonebook "SM” “FD” “ON” “SN” “EN” : 0 Not Reloaded from SIM (no change since last init or SIM remove) 1 Reloaded from SIM to internal memory (at least one entry has changed) For Event 11: : 128-bit “fingerprint” of the phonebook.
Chapter 13 – Specific AT Commands Additional Notes: • The AT+WIND? command is supported and indicates the . • AT+WIND settings are automatically stored in non volatile memory (EEPROM). This means the &W command does not need to be used and the selected flows are always activated after boot. • Default value is 0: no flow activated, no indication.
Chapter 13 – Specific AT Commands Mobile Equipment Event Reporting +CMER Description: This command enables or disables sending of unsolicited result codes in the case of a key press. Values: (keypad) 0 No keypad event reporting. 1 Keypad event reportings are routed using unsolicited code: +CKEV: , only those key pressings, which are not caused by +CKPD are indicated. 2 Keypad event reportings are routed using unsolicited code: +CKEV: , all key pressings are indicated.
Chapter 13 – Specific AT Commands Read Language Preference +WLPR Description: Read a Language Preference value of EF-LP. The first indices should have the highest priority. Values: Offset in the available languages range (SIM dependent) Values for language. See Recommendation 3GPP TS 23.038.
Chapter 13 – Specific AT Commands Read GPIO Value +WIOR Description: Read the requested GPI or GPIO pin value. Notes: • By default (e.g., after a reset), the I/O ports configuration is set by the +WIOM command. • This command is allowed only on a GPIO not allocated by an Open-AT embedded application or for bus operations. • When the BT chip is switched on, the GPIO5 is not available anymore. Values: Up to ten I/O ports are available. The value is between 0 and 9.
Chapter 13 – Specific AT Commands Input/Output Management +WIOM Description: This command sets the default GPIO’s configuration (input or output) after reset, and each GPIO default value (if set as an output) after reset. Notes: • This command is allowed only on a GPIO not allocated by the Open-AT embedded application or for bus operations. • When UART is activated, GPIOs 0 and 5, GPO2 and GPI are not available anymore.
Chapter 13 – Specific AT Commands Abort Command +WAC Description: This command allows SMS, SS and PLMN selection related commands to be aborted.
Chapter 13 – Specific AT Commands Play Tone +WTONE Description: Values: This command allows a tone to be played on the current speaker or on the buzzer. Frequency, gain and duration can be set. 0 Stop playing. 1 Play a tone Sets the destination (mandatory if =1) 1 Speaker 2 Buzzer Sets tone frequency (in Hz) (mandatory if =1). nd Sets the 2 tone frequency (in Hz) (mandatory if =1). Available with speaker only.
Chapter 13 – Specific AT Commands Play DTMF Tone +WDTMF Description: This command allows a DTMF tone to be played on the current speaker. DTMF, gain, and duration can be set. Note: This command is only used to play a DTMF tone. To send a DTMF over the GSM network, use the +VTS command. Values: 0 Stop playing. 1 Play a DTMF tone Sets the DTMF to play in (mandatory if =1). Value must be in {0-9,*,#,A,B,C,D} (0-15) Sets tone gain.
Chapter 13 – Specific AT Commands Voice Rate +WVR Description: This command allows the voice rate for bearer voice to be configured for outgoing and incoming calls. Note: According to the modem’s capabilities, the following voice coding type are allowed: • Modem that supports AMR: FR, EFR, AMR-FR, AMR-HR are supported. • Modem that does not support AMR: FR, EFR, HR are supported. Values: Voice coding type.
Chapter 13 – Specific AT Commands Data Rate +WDR Description: This command allows the data rate for bearer data to be configured for outgoing and incoming calls. Values: : Data Coding Type for Outgoing Calls. Data Coding Type 0 1 2 3 Preferred Other Supported Types Type FR HR FR FR Default Values Default incoming voice calls rate FR HR HR : Data Coding Type for Incoming Calls.
Chapter 13 – Specific AT Commands Select Voice Gain +WSVG Description: The product has 2 voice gain controllers. This specific command selects the microphone gain controller.
Chapter 13 – Specific AT Commands Scan +WSCAN Description: This command displays the received signal strength indication () for a specified frequency (in absolute format). This command is not allowed during communication. Values: frequency in absolute format 0 -113 dBm or less 1 -111 dBm 2...
Chapter 13 – Specific AT Commands 32kHz Power Down Mode +W32K Description: This command allows the 32kHz power down mode to be enabled or disabled: • When power down mode is entered, the product uses a 32kHz internal clock during inactivity stages (regardless of its nominal internal clock). • When enabled, power down mode is active after 1 to 15 minutes. The mode is not stored in EEPROM: the command has to be repeated after a reset.
Chapter 13 – Specific AT Commands Custom Character Set +WCCS Description: This command allows you to edit and display the custom character set tables. These tables are used by the “CUSTOM” mode of +CSCS and the +WPCS commands. In this CUSTOM mode, when you enter a string, it is converted into the GSM alphabet using the Custom To GSM table. In a similar way, when the user requests a string display, the string is converted from the GSM alphabet using the Custom alphabet and Custom alphabet extension tables.
Chapter 13 – Specific AT Commands Lock +WLCK Description: This command allows the modem to be locked on a specific network operator. Note: Test SIM cards (with MCC=001 & MNC=01) doesn’t check these locks. Values: “PS” “PN” “PU” “PP” “PC” SIM lock facility with a 8 digits password (PCK). Network lock with a 8 digits password (NCK). Network subset lock with a 8 digits password (NSCK). Service provider lock with a 8 digits password (SPCK).
Chapter 13 – Specific AT Commands CPHS Command +CPHS Description: This command is used to activate, deactivate or interrogate a CPHS feature (e.g., Voice Mail Indicator, Mail Box Number…) Note: This command may answer +CME ERROR: 3 if the CPHS feature is disabled or if the SIM card does not support this CPHS feature.
Chapter 13 – Specific AT Commands AT+CPHS? +CPHS: 1,1 +CPHS: 2,0 +CPHS: 3,1 +CPHS: 4,0 +CPHS: 5,1 +CPHS: 6,1 +CPHS: 7,1 OK Interrogate the status of CPHS functionality Voice mail indicator functionality is activated Mail box number functionality is deactivated Alternate Line Serve functionality is activated Divert Call Indicator functionality is deactivated Network Operator functionality is activated CPHS Information functionality is activated Customer Service Profile functionality is activated **** the m
Chapter 13 – Specific AT Commands Unsolicited Result: Voice Mail Indicator +WVMI Description: This unsolicited indication gives the status of the LINE 1, LINE 2, or Data mailbox. The +CPHS command can be used to know the status of the voice mail indicator for each line. Values: 1 Line 1 2 Line 2 3 Data 0 No message waiting.
Chapter 13 – Specific AT Commands Network Operator Name +WNON Description: This indication provides the name of the network operator (as a character string). This command is the response to the AT+CPHS 2,5 [,] command. Values: 0 Long format operator name 1 Short format operator name. Default.
Chapter 13 – Specific AT Commands Customer Service Profile +WCSP Description: This indication tells whether or not a service is accessible to the customer. This command is the response to the AT+CPHS 2,7,] command. Values: value indicating the CSP field to display (See Codes and Values in the Appendix). 0 service is not customer-accessible 1 service is customer-accessible Note: The field Alternate Line Service (CPHS Teleservices Group) sets the ALS feature at initialization.
Chapter 13 – Specific AT Commands CPHS Mail Box Number +WMBN Description: This command sets the different mailbox numbers in SIM. The +CPHS command can be used to know which mailbox numbers can be updated. Values: 1 Line 1 2 Line 2 3 Data Phone number in ASCII format TON/NPI (Type of address byte in integer format) name of mailbox Notes: • For the parameter, all strings starting with “80”, “81”, or “82” are considered in UCS2 format.
Chapter 13 – Specific AT Commands Alternate Line Service +WALS Description: This command allows you to set and to get the active line. The CPHS command can be used to know which line is active.
Chapter 13 – Specific AT Commands Wavecom Open AT Control Command +WOPEN Description: ® This command starts, stops, deletes, and gets information about the current Open AT embedded application. ® This command also allows you to erase the Open AT flash objects storage place and to configure the Application and Data (A&D) storage place size. Values: 0 Stop the Open AT embedded application. If this one was running, the product resets 1 Start the Open AT embedded application.
Chapter 13 – Specific AT Commands AT+WOPEN=3 AT+WOPEN=1 Note: Start the embedded application AT+WOPEN=3 AT+WOPEN=4 AT+WOPEN=0 Note: Stop the embedded application AT+WOPEN=3 AT+WOPEN=4 AT+WOPEN=6 AT+WOPEN=6,1280 AT+WOPEN=6,768 AT+WOPEN=6,900 AT+WOPEN=6 AT+WOPEN=5 OK Note: The objects flash are erased OK +WIND: 3 Note: Product reset in order to start the embedded application +CME ERROR: 532 Note: The embedded application is activated so the objects flash are not erased +CME ERROR: 532 Note: The embedde
Chapter 13 – Specific AT Commands Reset +WRST Description: This command resets the modem after the time specified by the parameter.
Chapter 13 – Specific AT Commands Hang-up +WATH Description: This command disconnects the remote user, specifying a release cause and the location. In the case of multiple calls, all calls are released (active, on-hold and waiting calls). Values: : decimal value from 1 to 127 See table “Failure Cause from GSM 04.08 recommendation.” : optional parameter (default value =0) values as defined in 04.
Chapter 13 – Specific AT Commands Multi-Band Selection +WMBS Description: Use this command to select the GSM bands on which the modem will work. This command is allowed only if the selected bands are supported. You can choose whether the change is immediate or not: • Either the modem has to be reset to take this change into account (this is the default) • or the GSM stack restarts immediately on the specified band(s).
Chapter 14 – SIM Toolkit Chapter 14 – SIM Toolkit Overview of SIM Application Toolkit SIM Toolkit, also known as “SIM Application Toolkit,” introduces new functionalities which open the way to a broad range of value added services. The principle is to allow service providers to develop new applications (e.g.. for banking, travel, ticket booking, etc.) for subscribers and to download them into the SIM.
Chapter 14 – SIM Toolkit Messages Exchanged During a SIM Toolkit Operation The following scheme shows the SIM Toolkit commands and unsolicited results that are exchanged. +STSF=X,XXXXXXXX STEP 1: Configuration and Activation +STIN=X STEP 2: SIM sends pro-active command MULTI-TECH Modem Customer +STGI=X Application +STGI response STEP 3: Customer application gets all the information. +STCR:X +STGR=X,XXXXXX STEP 4: User response is sent to the SIM.
Chapter 14 – SIM Toolkit SIM Toolkit Commands SIM Toolkit Set Facilities +STSF Description: This command allows SIM Toolkit facilities to be activated, deactivated or configured. Values: 0 Deactivates the SIM Toolkit functionalities. 1 Activates the SIM Toolkit functionalities. 2 Configures the SIM Toolkit functionalities. (160060C01F – 5FFFFFFF7F) (hex format) Default: 1F6BFFFF1F 1-255 Timeout for user responses (multiple of 10 seconds).
Chapter 14 – SIM Toolkit Example AT+CMEE=1 Enable the reporting of mobile equipment errors OK AT+WIND=15 Set indications OK AT+CPAS +CPAS: 0 OK AT+STSF=? Query ME Status ME is ready.
Chapter 14 – SIM Toolkit SIM Toolkit Indication +STIN or +STRIL Unsolicited Result In order to allow the customer application to identify the pro-active command sent via SIM Toolkit, a mechanism of unsolicited SIM Toolkit indications (+STIN) is implemented. Syntax: AT+STIN: Option: 0 Indicates that a ‘Setup Menu’ pro-active command has been sent from the SIM. 1 Indicates that a ‘Display Text’ pro-active command has been sent from the SIM.
Chapter 14 – SIM Toolkit SIM Toolkit Get Information +STGI Description: This command allows to get the information (text to display, menu information, priorities…) of a proactive command sent from the SIM. The information is returned only after receiving a SIM Toolkit indication (+STIN).
Chapter 14 – SIM Toolkit Values when CmdType=1 (Display text) 0 Normal priority of display 1 High priority of display Text to display in ASCII format 0 Clear message after a delay (3 seconds) 1 Wait for user to clear message Values when CmdType=2 (Get Inkey) 0 Digit (0-9, *, #,and +) 1 SMS alphabet default 2 UCS2 0 No help information available 1 Help information available Text information in ASCII format Values when CmdType=3 (Get Input) 0
Chapter 14 – SIM Toolkit Values when CmdType=6 (Sel Item) (1-255) (1-255) (1-255) 0 1 No help information available Help information available Contains a pro-active command identifier.
Chapter 14 – SIM Toolkit Unsolicited Result: SIM Toolkit Control Response +STCR Description: When the customer application makes an outgoing call or an outgoing SMS and if the call control facility is activated, CALL CONTROL and SMS CONTROL responses can be identified. This is also applicable to SS calls. Values: 0 Control response not allowed. 1 Control response with modification. Called number, Service Center Address or SS String in ASCII format.
Chapter 14 – SIM Toolkit Values when CmdType=0 (Select an item from the main menu) 1 Item selected by the user. 2 Help information required by user. Contains the item identifier of the item selected by the user. Values when CmdType=1 (Confirm the display text clearing) No values. Values when CmdType=2 (Get Inkey) 0 Session ended by user. 1 Response given by the user. 2 Help information required by user. Contains the key pressed by the user.
Chapter 14 – SIM Toolkit Example Initially, all facilities are activated, the PIN is not required and the SIM Toolkit functionality is activated. +STIN: 0 The main menu has been sent from the SIM. AT+STGI=0 Get information about the main menu +STGI: 1,3,”BANK”,0 The main menu contains 3 items. +STGI: 2,3,”QUIZ”,0 +STGI: 3,3,”WEATHER”,0 OK AT+STGR=0,1,1 The item 2 of the main menu has been selected. OK +STIN: 6 The Sel item menu has been sent from the SIM.
Chapter 15 – GPRS Commands Chapter 15 – GPRS commands Important: GPRS commands are not available under GSM-only software. Define PDP Context +CGDCONT Description: This command specifies PDP context parameter values for a PDP context identified by the local context identification parameter, . Four PDP contexts can be defined through the software. A special form of the set command, +CGDCONT= causes the values for context number to become undefined.
Chapter 15 – GPRS Commands Syntax: Command Syntax: AT+CGDCONT Command AT+CGDCONT=[ [, [, [, [, [,]]]]]] AT+CGDCONT? AT+CGDCONT=? AT+CGDCONT: 1, “IP” “internet”; AT+CGCONT=2, “IP”, “abc.com” AT+CGDCONT=? AT+CGCONT? Possible responses OK ERROR +CGDCONT: , , ,, , [+CGDCONT: , , ,, , [...
Chapter 15 – GPRS Commands Quality of Service Profile Requested +CGQREQ Description: This command allows the DTE to specify a Quality of Service Profile that is used when the modem sends an Activate PDP Context Request message to the network. The set command specifies a profile for the context identified by the local context identification parameter, . Since this is the same parameter that is used in the +CGDCONT command, the +CGQREQ command is effectively an extension to the +CGDCONT command.
Chapter 15 – GPRS Commands Reliability GTP Mode Class 0 Subscribed 1 Acknowledged LLC Frame Mode LLC Data RLC Block Mode Traffic Type Protection Subscribed by the Nwk / default if value is omitted Acknowledged Protected Acknowledged Non real-time traffic, error-sensitive application that cannot cope with data loss. 2 Unacknowledged Acknowledged Protected Acknowledged Non real-time traffic, error-sensitive application that can cope with infrequent data loss.
Chapter 15 – GPRS Commands Syntax: Command Syntax: Command AT+CGQREQ=[ [, [, [, [, [,]]]]]] AT+CGQREQ? AT+CGQREQ=? AT +CGQREQ=1,1,4,5,2,14 AT+CGQREQ=? AT+CGQREQ? Possible Response(s) OK ERROR +CGQREQ: , , , , , [+CGQREQ: , , ,
Chapter 15 – GPRS Commands Quality of Service Profile Minimum Acceptable +CGQMIN Description: This command allows the DTE to specify a minimum acceptable profile which is checked by the modem against the negotiated profile returned in the Activate PDP Context Accept message. The set command specifies a profile for the context identified by the local context identification parameter, .
Chapter 15 – GPRS Commands GPRS Attach or Detach +CGATT Description: The execution command is used to attach the modem to, or detach the modem from, the GPRS service. After the command has completed, the modem remains in V.25ter command state. If the modem is already in the requested state, the command is ignored and the OK response is returned. If the requested state cannot be achieved, an ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command.
Chapter 15 – GPRS Commands PDP Context Activate or Deactivate +CGACT Description: The execution command activates or deactivates the specified PDP context (s). After the command has completed, the modem remains in V.25ter command state. If any PDP context is already in the requested state, the state for that context remains unchanged. If the requested state for any specified context cannot be achieved, an ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command.
Chapter 15 – GPRS Commands Enter Data State +CGDATA Description: The command causes the modem to perform the necessary actions to set up communication between the DTE and the network. This may include performing a GPRS attach and one PDP context activation. If the value is not defined to the modem, the modem will return an ERROR or +CME ERROR response. Otherwise, the modem issues the intermediate result code CONNECT and enters V.25ter online data state.
Chapter 15 – GPRS Commands GPRS Mobile Station Class +CGCLASS Description: The set command is used to set the modem to operate according to the specified GPRS mobile class. If the requested class is not supported, an ERROR or +CME ERROR response is returned. The read command returns the current GPRS mobile class. The test command is used for requesting information on the supported GPRS mobile classes.
Chapter 15 – GPRS Commands Select Service for MO SMS Messages +CGSMS Description: The set command specifies the service or service preference that the modem will use to send MO SMS messages. The read command returns the currently selected service or service preference. The test command requests information on the currently available services and service preferences.
Chapter 15 – GPRS Commands GPRS Event Reporting +CGEREP Description: Set command enables or disables sending of unsolicited result codes, +CGEV: XXX from modem to DTE in the case of certain events occurring in the GPRS modem or the network. controls the processing of unsolicited result codes specified within this command. Read command returns the current mode and buffer settings. Test command returns the modes and buffer settings supported by the modem as compound values.
Chapter 15 – GPRS Commands GPRS Network Registration Status +CGREG Description: The set command controls the presentation of an unsolicited result code +CGREG: when =1 and there is a change in the modem's GPRS network registration status, or code +CGREG: [,,] when =2 and there is a change of the network cell.
Chapter 15 – GPRS Commands Request GPRS IP Service D Description: This command causes the modem to perform whatever actions are necessary to establish communication between the DTE and the external PDN. The V.25ter 'D' (Dial) command causes the modem to enter the V.25ter online data state and, with the DTE, to start the specified layer 2 protocol. The modem returns CONNECT to confirm acceptance of the command prior to entering the V.25ter online data state.
Chapter 15 – GPRS Commands Network Requested PDP Context Activation In this mode of operation, the modem behaves like an answering modem and accepts the normal V.25ter commands associated with answering a call. If GPRS-specific configuration commands are required, they may be sent to the modem as part of the modem initialization commands. The +CGAUTO command is used to select modem compatibility mode. Automatic Response to a Network Request for PDP Context Activation S0 The V.
Chapter 15 – GPRS Commands Automatic Response to a Network Request for PDP Context Activation +CGAUTO Description: The set command disables or enables an automatic positive response (auto-answer) to the receipt of a Request PDP Context Activation message from the network. It also provides control over the use of the V.25ter basic commands 'S0', 'A and 'H' for handling network requests for PDP context activation. The setting does not affect the issuing of the unsolicited result code RING or +CRING.
Chapter 15 – GPRS Commands Manual Response to a Network Request for PDP Context Activation +CGANS Description: The execution command requests the modem to respond to a network request for GPRS PDP context activation which has been signalled to the DTE by the RING or +CRING: unsolicited result code. The parameter allows the DTE to accept or reject the request. If is 0, the request is rejected and the modem returns OK to the DTE.
Chapter 15 – GPRS Commands Show PDP Address +CGPADDR Description: The execution command returns a list of PDP addresses for the specified context identifiers. The test command returns a list of defined s. Values: A numeric parameter which specifies a particular PDP context definition. If no is specified, the addresses for all defined contexts are returned. A string that identifies the modem in the address space applicable to the PDP. The address may be static or dynamic.
Chapter 15 – GPRS Commands Service Reporting Control +CR Description: This command enables a more detailed service reporting for incoming or outgoing calls. Before sending the CONNECT response to the application, the GSM modem will precisely define the type of data connection being established.
Chapter 15 – GPRS Commands GPRS Parameters Customization +WGPRS Description: This command modifies some of the GPRS parameters: • The ATTACH-STATUS (the modem doesn’t automatically make a GPRS attachment after initialization) • The PDP-INIT-STATUS (activate automatically some defined PDP Contexts after initialization) and • The user-defined multislot class. This parameter represents the GPRS class chosen by the user to perform power saving (by reducing TX [or uplink] time slots).
Chapter 15 – GPRS Commands Syntax: Command Syntax: AT+WGPRS=,,[],[] Command AT+WGPRS=? AT+WGPRS? AT+WGPRS=2,1,3 Note: Set ACTIVABLE to ON on PDP context 3 AT+WGPRS=7,1 Note: Set automatic re-attachment to the network and reactivation of PDP context in case of change of operator for MCC/MNC AT+WGPRS=4,,,18 Note: Choose GPRS multislot class 8 AT+WGPRS=? Note: Request range of values AT+WGPRS? Note: − Automatic re-attachment at init not activated − Automatic reactivation of PDP
Chapter 15 – GPRS Commands Examples of Full GPRS AT Commands Activation of an IP PDP Context Example 1 AT +CGDCONT=1, "IP", "internet"; +GCDCONT=2, "IP", "abc.com" OK ATD*99***1# CONNECT Example 2 AT +CGCLASS=”CG” OK +CGREG: 1 AT +CGDCONT=1, "IP", "internet" OK AT +CGQREQ=1,1,4,5,2,14 OK AT +CGQMIN=1,1,4,5,2,14 OK AT +CGATT=1 OK AT +CGACT=1,1 OK //Remark about +CGDATA: the goal of this command is the same as ATD*99*** AT +CGDATA=1 CONNECT ……. Data transfer …….
Chapter 16 – Other AT Commands Chapter 16 – Other AT Commands V.25ter Recommendation The commands not listed in this document are not supported. For these commands, the product will then answer with "ERROR". All modulation control, error control and data compression commands are not recognized. An "ERROR" string will be returned. GSM 07.05 Recommendation All the 07.05 commands not described in this manual are not implemented. The product will answer "ERROR" to these commands. GSM 07.
Appendix A – Result Codes, Failure Causes, Other Tables Appendix A – Result Codes, Failure Causes, Other Tables Chapter Summary The following tables are included in Appendix A: • ME error result code: +CME ERROR: • Message service failure result code: +CMS ERROR • Specific error results codes • Failure Cause from GMS 05.08 recommendation (+CEER) • Specific Failure Cause for +CEER • GSM 04.
Appendix A – Result Codes, Failure Causes, Other Tables ME Error Result Code: +CME ERROR: 3 4 5 10 11 12 13 16 Meaning Operation not allowed Operation not supported PH-SIM PIN required (SIM lock) SIM not inserted SIM PIN required SIM PUK required SIM failure Incorrect password 17 18 SIM PIN2 required SIM PUK2 required 20 21 22 Memory full Invalid index Not found 24 26 27 30 32 40 42 Text string too long Dial string too long Invalid characters in dial string No network service Network
Appendix A – Result Codes, Failure Causes, Other Tables Message Service Failure Result Code +CMS ERROR is defined as below: Meaning 1 to 127 Error cause values from the GSM recommendation 04.
Appendix A – Result Codes, Failure Causes, Other Tables Continued: Specific Error Result Codes Meaning 544 CMUX connection Timeout (no answer from the remote); i.e., no DLCO opened response. 545 A CMUX session has been started on a physical UART, and the user tries to start another CMUX session on another physical UART. The error, +CME ERROR: 545 is raised on the UART where AT+CMUX command is trying to be started again.
Appendix A – Result Codes, Failure Causes, Other Tables Failure Cause from GSM 04.
Appendix A – Result Codes, Failure Causes, Other Tables Continued: Failure Cause from GSM 04.
Appendix A – Result Codes, Failure Causes, Other Tables GSM 04.
Appendix A – Result Codes, Failure Causes, Other Tables Unsolicited Result Codes Verbose Result Code +CALA: < time string>, +CBM: (PDU) or +CBM:,,,,… (Text mode) +CBMI: “BM”, Numeric (V0 set) As verbose As verbose Description Alarm notification Cell Broadcast Message directly displayed As verbose Cell Broadcast Message stored in mem at location +CCCM: As verbose Current Call Meter value +CCED: As verbose (specific) Cell Envir
Appendix A – Result Codes, Failure Causes, Other Tables Parameter Storage Mode Parameter Storage Mode AT&W Command (E2P) Command (E2P) AT+CSAS (SIM, E2P) General commands +CMEE X +CSCS X +WPCS X Call Control commands %D ATS0 X +CICB X +CSNS X +ECHO X X AT&F (SIM, E2P) X X X 0 “PCCP437” “TRANSPARENT” X X X X X 0 0 (no auto-answer) 2 (speech) 0 (voice) ,1,0,3,10,7 (Algo ID 1) ,3,30,8000,256 (Algo ID 3) 1,2 0 (Spk 1 & Mic 1) 128 (speaker 1) 32 (speaker 2) 32 (mic 1 & ctrl 1) 0 (others) +SIDET +SPEA
Appendix A – Result Codes, Failure Causes, Other Tables Parameter Storage Mode AT&W Command (E2P) Command (E2P) V24 – V25 commands &C X &D X &S X E X Q X V X +ICF X +IFC X +IPR X +WMUX X Specific commands +ADC +CMER X +CPHS AT&F (SIM, E2P) X X X X X +WCCS X +WCDM +WCDP +WDR +WIND +WIOM +WRIM +WSVG +WVR X X X X X X X X SIM Toolkit commands +STSF X GPRS commands +GCAUTO +GCCLASS +GCDCONT +GCEREP +GCREG +GCSMS +WGPRS AT+CSAS (SIM, E2P) X X X X X X X X X X X 1 2 1 1 0 1 3,4 2,2 115200 0 0 0
Appendix A – Result Codes, Failure Causes, Other Tables GSM Sequences List In accordance with GSM Technical Specification 02.30, the product supports the following GSM sequences, which can be used through the ATD and the +CKPD commands.
Appendix A – Result Codes, Failure Causes, Other Tables Call Barring Note: SC values are listed below.
Appendix A – Result Codes, Failure Causes, Other Tables CPHS Information Field CPHS Information Description Data Field Bit Field All information CSP service activated and allocated SST service activated and allocated Mailbox Number service activated and allocated Operator Name Shortform service activated and allocated Information Numbers service activated and allocated RFU RFU RFU Voice Message Waiting Indicator for Line 1 Voice Message Waiting Indicator for Line 2 Data Message Waiting Indicator Call Fo
Appendix A – Result Codes, Failure Causes, Other Tables CSP Constants Service Group: Call Offering Service Call Forwarding Unconditional Call Forwarding on User Busy Call Forwarding on No Rely Call Forwarding on User Not Reachable Call Transfer External Value 1 2 3 4 5 Service Group: Call Restriction Service Barring of All Outgoing Calls Barring of Outgoing International Calls Barring of Outgoing International Calls except those directed to the Home PLMN country Barring of All Outgoing Calls BIC Roam Ex
Appendix A – Result Codes, Failure Causes, Other Tables Service Group: Phase 2+ Services Service Menus concerned with GPRS functionality Menus concerned with High Speed Circuit Switched Data functionality ASCII Voice Group call menus ASCII Voice Broadcast service menus Multi Subscriber profile menus Multi band: Restriction of menus allowing user to select a particular GSM 900/1800 or 1900 band External Value 65 66 67 68 69 70 Service Group: Value Added Services Service Restriction of menus options for man
Appendix B – ME SIM Toolkit Support Appendix B - ME SIM Toolkit Support TABLE 1 – Support of SIM Toolkit classes (This has been extracted from the GMS Technical Specification 11.14.
Appendix C – Structure of the Terminal Profile Appendix C – Structure of the Terminal Profile First byte (Download): b8 b7 b6 b5 b4 Second byte (Other): b8 b7 b6 b5 b3 b4 b3 b2 b2 b1 Profile download User choice SMS-PP data download Cell Broadcast data download Menu selection '9E XX' response code for SIM data download error Timer expiration USSD string data object supported in Call Control RFU, bit=0 Set by product to 1 Set by product to 1 User choice Set by product to 1 Command result Call Co
Appendix C – Structure of the Terminal Profile Fifth byte (Event driven information): b8 b7 b6 b5 b4 b3 b2 b1 Proactive SIM: SET UP EVENT LIST Event: MT call Event: Call connected Event: Call disconnected Event: Location status Event: User activity Event: Idle screen available Event: Card reader status b8 Set by product to 1 Set by product to 1 Set by product to 1 Set by product to 1 Set by product to 1 User choice User choice Set by product to 0 Sixth byte: (reserved for Event driven information extens
Appendix D – Command Type and Next Action Indicator Appendix D – Command Type and Next Action Indicator This table has been extracted from the GMS Technical Specification 11.14.
Appendix E – Coding of Alpha Fields in the SIM for UCS2 Appendix E – Coding of Alpha fields in the SIM for UCS2 The coding can take one of the three following structures. If the ME supports UCS2 coding of alpha fields in the SIM, the ME shall support all three coding schemes for character sets containing 128 characters or less; for character sets containing more than 128 characters, the ME shall at least support the first coding scheme.
Appendix E – Coding of Alpha Fields in the SIM for UCS2 Example 3 Byte 1 '82' Byte 2 '05' Byte 3 '05' Byte 4 '30' Byte 5 '2D' Byte 6 '82' Byte 7 'D3' Byte 8 '2D' Byte 9 '31' In the above example • Byte 2 indicates there are 5 characters in the string • Bytes 3 and 4 contain a sixteen bit base pointer number of '0530', pointing to the first character of the Armenian character set. • Byte 5 contains a GSM Default Alphabet character of '2D', which is a dash "-".
Appendix F – Command Execution and Dependence on SIM Appendix F – Command Execution and Dependence on SIM The following table lists AT command execution syntax and the execution condition. The SIM dependency column indicates if the command behavior will vary if another card is used. For example, it will vary for phonebook reading commands. The Intermediate column indicates if intermediate response can occur.
Appendix G – Conditions for Command Execution and SIM Dependence Network Service Commands AT commands AT+CSQ AT+COPS AT+CREG AT+WOPN AT+CPLS AT+CPOL AT+COPN Conditions +WIND: 3 +WIND: 4 +WIND: 3 +WIND: 3 PIN After PIN entered After PIN entered SIM dependence N Y N N Y Y N Intermediate N N Y N N Y N Security Commands AT commands AT+CPIN AT+CPIN2 AT+CPINC AT+CLCK AT+CPWD Conditions +WIND: 1 after PIN entered +WIND: 1 +WIND: 4 +WIND: 4 SIM dependence Y Y Y Y Y Intermediate N N N N N Phonebook Commands
Appendix G – Conditions for Command Execution and SIM Dependence Supplementary Services Commands AT commands AT+CCFC AT+CLCK AT+CPWD AT+CCWA AT+CLIR AT+CLIP AT+COLP AT+CAOC AT+CACM AT+CAMM AT+CPUC AT+CHLD AT+CLCC AT+CSSN AT+CUSD AT+CCUG Conditions +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 After PIN entered After PIN entered After PIN entered After PIN entered After PIN entered After PIN entered After PIN entered +WIND: 5,2 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 4 SIM dependence Y Y Y Y Y Y Y Y Y Y Y Y N N N Y Inte
Appendix G – Conditions for Command Execution and SIM Dependence Specific AT Commands AT commands AT+CCED AT+WIND AT+ADC AT+CMER AT+WLPR AT+WLPW AT+WIOR AT+WIOW AT+WIOM AT+WAC AT+WTONE AT+WDTMF AT+WDWL AT+WVR AT+WDR AT+WSVG AT+WSTR AT+WSCAN AT+WRIM AT+W32K AT+WCDM AT+WCCS AT+WLCK AT+CPHS AT+WMIR AT+WCDP AT+WMBN AT+WALS AT+WOPEN AT+WRST AT+WSST AT+WATH AT+WMBS Conditions +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 1 +WIND: 3 +WIND: 1 +WIND: 1 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 3 +WIND: 3 +W
Appendix G – Conditions for Command Execution and SIM Dependence GPRS Commands AT commands AT+CGDCONT AT+CGQREQ AT+CGQMIN AT+CGATT AT+CGACT AT+CGDATA AT+CGCLASS AT+CGCLASS AT+CGSMS AT+CGREP AT+CGREG AT+CGAUTO AT+CGANS AT+CGADDR AT+WGPRS Conditions +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 3 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 4 +WIND: 3 SIM dependence Intermediate N N None N Multi-Tech Systems, Inc.
Index Index % %C Select Data Compression ........................................ 97 %D Automatic Dialing with DTR ..................................... 23 & &C Set DCD Signal ...................................................... 101 &D Set DTR Signal....................................................... 102 &F Restore Factory Settings ........................................ 104 &S Set DSR Signal....................................................... 102 &T Auto-Tests ..................................
Index +STCR Unsolicited Result SIM ToolKit Control Response ................................................................................... 146 +STGI SIM ToolKit Get Information .............................. 143 +STGR SIM ToolKit Give Response ............................ 146 +STIN or STRIL SIM ToolKit Indication ........................ 142 +STSF SIM ToolKit Set Facilities ................................. 140 +VGR, +VGT Gain Control .............................................
Index Commands, General Alarm Management +CALA ........................................ 18 Capabilities list +GCAP................................................ 15 Card Identification +CCID ............................................ 15 Clock Management +CCLK ........................................ 18 Keypad control +CKPD ............................................... 17 Manufacturer Identification +CGMI .............................. 13 Phone activity status +CPAS .....................................
Index Write Language Preference +WLPW ........................ 113 Commands, Supplementary Services Accumulated Call Meter +CACM ................................ 85 Accumulated Call Meter Maximum +CAMM ............... 86 Advice of Charge +CAOC ........................................... 85 Call Barring +CLCK .................................................... 81 Call Forwarding +CCFC.............................................. 80 Call Related Supplementary Services +CHLD............
Index Move Action in Phonebook +CPBN................................ 54 MS Mobile Station ............................................................ 9 MTC Mobile Terminated Call ............................................ 9 Multi-Band Selection +WMBS ...................................... 137 Multiplexing Mode +WMUX ........................................... 106 N N Select Data Error Correcting Mode ............................. 98 Network Operator Name +WNON ................................
Index U Unsolicited Result Codes .............................................. 179 Unsolicited Result Diverted Call Indicator +WDCI ........ 128 Unsolicited Result SIM ToolKit Control Response +STCR ................................................................................... 146 Unsolicited Result Voice Mail Indicator +WVMI............ 128 Unstructured Supplementary Service Data +CUSD ....... 90 Using Commands During Data Connection..................... 92 V V DCE Response Format .................