Westermo GD-01 US, GD-01 TCP Interface Manual

GSM
Modem
www.westermo.com
©
Westermo Teleindustri AB • 2005
AT-Commands
Interface Guide
GD-01
GD-01 TCP/GD-01 US
2 6196-2220
Contents
Short form list of AT commands .................................................................................................... 3–8
List of AT-commands
................................................................................................................................ 9–175
General commands
.................................................................................................................................... 10–17
Call Control commands
....................................................................................................................... 18–25
Network service commands
.......................................................................................................... 26–33
Security commands
................................................................................................................................... 34–40
Phonebook commands
.......................................................................................................................... 41–52
Short Messages commands
............................................................................................................. 53–74
Supplementary Services commands
.................................................................................. 75–92
Data commands
.......................................................................................................................................... 93–103
Fax commands
.......................................................................................................................................... 104–114
V24-V25 commands
........................................................................................................................... 115–125
Specific AT commands
................................................................................................................... 126–146
AT commands for GPRS
.............................................................................................................. 148–175
Data / Commands multiplexering protocoll
..................................................... 176–178
Error codes from modem
.......................................................................................................... 179–184
GSM 04.11 Annex E-2: Mobile originating SM-transfer
...................... 185–188
Power down mode via RS-232
.............................................................................................. 189–190
GSM sequences list
.............................................................................................................................. 191–192
Application example
........................................................................................................................ 193–200
GSM network operators, subscriptions and services
.......................................... 201
Antenna installation information
................................................................................................... 202
Glossary
............................................................................................................................................................................ 203
Trouble shooting/FAQ
................................................................................................................................... 204
Related documents
............................................................................................................................................ 205
36196-2220
Command Description Direct +CSAS &W &F Default
Save value
+CGMI Manufacturer identification – +CGMM Request model identification – +CGMR Request revision identification – +CGSN Product Serial Number – +CSCS Select TE character set x x “PPCP437” +WPCS Phonebook Character Set x x “TRANSPARENT” +CIMI Request IMSI – +CCID Card Identification – +GCAP Capabilities list – +CPOF Power off – +CFUN Set phone functionality – +CPAS Phone activity status – +CMEE Report Mobile Equipment errors x x 0 +CKPD Keypad control – +CCLK Clock Management – +CALA Alarm Management
Short form list of AT commands
S-registers Description Direct +CSAS &W &F Default
Save value
S0 Ring signals before auto answer - - x x 0
General commands
Command Description Direct +CSAS &W &F Default
Save value
D Dial command - – H Hang–Up command – A Answer a call – +CEER Extended error report – +VTD DTMF signals tone duration – +VTS Send DTMF signals – %Dn Automatic dialing with DTR x x 0 +CICB Incoming Call Bearer x x 2 +CSNS Single Numbering Scheme x x 0
Call control commands
26 26 26 27 27 28 28 29 29 29 30 31 31 32 32 33
Page
34 36 37 37 38 38 39 40 41
Page
4 6196-2220
Command Description Direct +CSAS &W &F Default
Save value
+CSQ Signal Quality – +COPS Operator selection x x x 0,2 +CREG Network registration x x 0 +WOPN Read operator name – +CPOL Preferred operator list
Network service commands
Command Description Direct +CSAS &W &F Default
Save value
+CPIN Enter PIN – +CPIN2 Enter PIN2 – +CPINC PIN remaining attempt number – +CLCK Facility lock – +CPWD Change password
Security commands
Command Description Direct +CSAS &W &F Default
Save value
+CPBS Select phonebook memory storage - - - - ­+CPBR Read phonebook entries - - - - ­+CPBF Find phonebook entries - - - - ­+CPBW Write phonebook entry - - - - ­+CPBP Phonebook phone search - - - - ­+CPBN Move action in phonebook - - - - ­+CNUM Subscriber number - - - - ­+WAIP Avoid phonebook init - - x x 0 +WDCP Delete Calls Phonebook - - - - ­+CSVM Set Voice Mail Number x - - x 0
Phonebook commands
42 43 46 47 48
Page
50 52 53 54 56
Page
57 58 59 60 62 63 65 66 67 68
Page
56196-2220
Command Description Direct +CSAS &W &F Default
Save value
+CSMS Select message service x 0 +CNMA New Message Acknowledgement – +CPMS Preferred Message Storage – +CMGF Preferred Message Format x x 1 +CSAS Save Settings – +CRES Restore settings – +CSDH Show text mode parameters x x 0 +CNMI New message indication x x 0,1,0,0,0 +CMGR Read message – +CMGL List message – +CMGS Send message – +CMGW Write Message to Memory – +CMSS Send Message From Storage +CMSS – +CSMP Set Text Mode Parameters x x 1,167,0,0 +CMGD Delete message – +CSCA Service center address x SIM dependant +CSCB Select Cell Broadcast Message Types – +WCBM Cell Broadcast Message Identifiers – +WMSC Message status modification – +WMGO Message overwriting – +WUSS Unchange SMS Status x x 0
Short Messages commands
Command Description Direct +CSAS &W &F Default
Save value
+CCFC Call forwarding – +CLCK Call barring – +CPWD Modify SS password – +CCWA Call waiting x x 0 +CLIR Calling line identification restriction – +CLIP Calling line identification presentation x x 0 +COLP Connected line identification presentation x x 0 +CAOC Advice of charge – +CACM Accumulated call meter – +CAMM Accumulated call meter maximum – +CPUC Price per unit and currency table – +CHLD Call related supplementary services – +CLCC List current calls – +CSSN Supplementary service notifications x x 0,0 +CUSD Unstructured supplementary service data x x 0 +CCUG Closed user group x 0,0,0
Supplementary Services commands
70 71 73 74 75 75 75 76 78 80 81 82 83 84 86 87 88 89 89 90 90
Page
91 92 94 94 96 97 98
99 100 101 102 103 104 105 107 108
Page
6 6196-2220
Command Description Direct +CSAS &W &F Default
Save value
+CBST Bearer type selection x x 0,0,1 +FCLASS Select mode – +CR Service reporting control x x 0 +CRC Cellular result codes x x 0 +ILRR DTE–DCE local rate reporting x x 0 +CRLP Radio link protocol parameters x x 61,61,48,6,1 +DOPT Others radio link parameters x x 1,1 %C Select data compression x x 2 +DS V42 bis data compression x x 3,0,4096,20 +DR V42 bis data compression report x x 0 \N Select data error correcting mode x x 0
Data commands
Command Description Direct +CSAS &W &F Default
Save value
+FTM Transmit speed – +FRM Receive speed – +FTH HDLC transmit speed – +FRH HDLC receive speed – +FTS Stop transmission and wait – +FRS Receive silence
Fax class 1 commands
Command Description Direct +CSAS &W &F Default
Save value
+FDT Transmit Data – +FDR Receive Data – +FET Transmit page punctuation – +FPTS Page transfer status parameters – +FK Terminate Session – +FBOR Page transfer bit order x x 0 +FBUF Buffer size report – +FCQ Copy quality checking x x 0 +FCR Capability to receive x x 1 +FDIS Current sessions parameters x x 0,5,0,0,2,0,0,0,0 +FDCC DCE capabilities parameters x x 0,5,0,0,2,0,0,0,0 +FLID Local ID string – +FPHCTO Page transfer timeout parameter x x 30
Fax class 2 commands
109 111 112 113 113 114 115 116 117 118 119
Page
120 121 121 122 122 123
Page
125 125 125 126 126 126 127 127 127 128 130 130 130
Page
76196-2220
Command Description Direct +CSAS &W &F Default
Save value
+IPR Fixed DTE rate x 9600 +ICF DTE–DCE character framing x 3,4 +IFC DTE–DCE local flow control x 2,2 &C Set DCD signal x 1 &D Set DTR signal x 1 &S Set DSR signal x 1 O Back to online mode – Q Result code suppression x x 0 V DCE response format x x 1 Z Default configuration – &W Save configuration – &T Auto–tests – – E Echo – x 1 &F Restore factory settings – &V Display configuration – I Request identification information – +WMUX Data / Commands Multiplexing x x 0
V24-V25 commands
Command Description Direct +CSAS &W &F Default
Save value
+CCED Cell environment description – +CCED Automatic RxLev indication – +WIND General Indications x x 0 +WLPR Read Language Preference – +WLPW Write Language Preference – +WAC Abort command – +WDWL Downloading – – +WDR Data Rate x 2 +WHWV Hardware Version – +WDOP Date of Production – +WSTR Status Request – +WSCAN Scan – – +WRIM Ring Indicator Mode – +W32K 32kHz Power down Mode – +WSSW Internal Software version – +WCCS Custom Character Set – +WLCK Lock – – +CPHS CPHS command x x 0 +WMIR Customer storage mirror – +WMBN CPHS Mail Box Number – +WRST Reset – – +WATH Hang–up –
Specific AT commands
131 132 133 134 134 135 135 135 136 136 137 137 138 138 139 140 141
Page
142 143 144 146 147 147 148 148 149 149 150 151 152 153 153 154 156 158 159 159 161 162
Page
8 6196-2220
Command Description Direct +CSAS &W &F Default
Save value
+CGDCONT Define PDP Context – +CGQREQ Requested Quality of Service Profile – +CGQMIN (Minimum acceptable)
Quality of Service Profile – +CGATT GPRS attach or detach – +CGACT PDP context activate or deactivate – +CGDATA Enter data state – +CGCLASS GPRS mobile station class – +CGSMS Select service for MO SMS messages – +CGEREP GPRS event reporting – +CGREG GPRS network registration status – D Request GPRS IP service – +CGAUTO Automatic response to a network
request for PDP context activation – +CGANS Manual response to a network
request for PDP context activation – +CGPADDR Show PDP address – +CGCOUNTERS PDP Counters Infos – +WGPRS GPRS PARAMETERS CUSTOM: – +WGAUTH Set authentication parameters – +WGIPCPINF Get IPCP informations
AT commands for GPRS
164 166
170 172
173 174 175 177 178 180 181
183
184 186
187 188 190 191
Page
96196-2220
List of AT-commands
Commands always start with AT (which means ATtention) and finish with a <CR> character.
Information responses and result codes
Responses normally start and end with <CR><LF>, except when the modem is set to “short result code format” with the command ATV0, or when the ATQ1 (no result codes) command is used.
If command syntax is incorrect, an ERROR string is returned. If extended error result codes are configured (+CMEE) and if command syntax is correct but with some incorrect parameters, the +CME ERROR: <Err> or +CMS ERROR: <SmsErr> strings are returned with different error codes. If the command line has been performed suc­cessfully, an OK string is returned. In some cases, such as “AT+CPIN?” or (unsolicited) incoming events, the product does not return the OK string as a response.
In the AT-command list below, <CR> and <CR><LF> are intentionally omitted.
Special AT-commands
In addition to the commands listed below there are two special commands that do not start with AT.The first command is “A/” without any <CR>.This command makes the modem repeat the last entered command.The second special command is the “+++” (also without <CR>).This command is called “escape sequence” and is used when the modem is in dedicated mode (online mode).When entering “+++” in dedicated mode, the modem will switch from “online mode” to “online command mode”.This means that it is possible to send commands to the local modem.The escape sequence is useful when disconnecting the active call.The disconnection is made with the ATH command (see the list of AT-commands below).The ATO command can also be used when in “online com­mand mode”.
10 6196-2220
General commands
+CGMI – Manufacturer identification
Description:
This command gives the GSM engine manufacturer identification.
Syntax:
AT+CGMI
Command example Possible responses Note
AT+CGMI WAVECOM MODEM Module manufacturer
OK
+CGMM – Request model identification
Description:
This command is used to get the supported frequency bands.With multi-band products the response may be a combination of different bands.
Syntax:
AT+CGMM
Command example Possible responses Note
AT+CGMM MULTIBAND 900E 1800 Support of 900
OK and 1800 MHz
+CGMR – Request revision identification
Description:
This command is used to get the GSM engine software version.
Syntax:
AT+CGMR
Command example Possible responses Note
AT+CGMR 430a09gm.2D ... Software release 4.30
OK
116196-2220
+CGSN – Product Serial Number
Description:
This command allows the user application to get the IMEI (International Mobile Equipment Identifier) of the product.
Syntax:
AT+CGSN
Command example Possible responses Note
AT+CGSN 135790248939 IMEI read from EEPROM
OK
AT+CGSN +CME ERROR: 22 IMEI not found
in EEPROM
+CSCS – Select TE character set
Description:
This command informs the ME which character set is used by the TE.The ME can convert each character of entered or displayed strings.This is used to send, read or write short messages. See also +WPCS for the phonebooks’ character sets.
Syntax:
AT+CSCS=<Character Set>
<Character Set> may be one of the following parameters “GSM” GSM default alphabet. “PCCP437” PC character set code page 437.
“CUSTOM” User defined character set (see also. +WCCS command). “HEX” Hexadecimal mode. No character set used; the user can
read or write hexadecimal values.
Command example Possible responses Note
AT+CSCS=”GSM” OK Command valid AT+CSCS=”PCCP437” OK Command valid AT+CSCS=? +CSCS: ("GSM"... Possible values
OK
12 6196-2220
+WPCS – Phonebook Character Set
Description:
This specific command informs the ME which character set is used by the TE for the phonebooks.The ME can convert each character of entered or displayed strings. This is used to read or write phonebook entries. See also +CSCS for the short messages character sets.
Syntax:
AT+WPCS=<Character Set>
<Character Set> may be one of the following parameters “TRANSPARENT” Transparent mode. The strings are displayed and entered
as they are stored in SIM or in ME.
“CUSTOM” User defined character set
(see also. +WCCS command).
“HEX” Hexadecimal mode. No character set used ; the user can
read or write hexadecimal values.
Command example Possible responses Note
AT+WPCS=”TRANSPARENT” OK Command valid AT+WPCS=”CUSTOM” OK Command valid AT+WPCS=? +WPCS: ("TRANSP... Possible values
OK
+CIMI – Request IMSI
Description:
This command is used to read and identify the IMSI (International Mobile Station Identity) of the SIM card.The PIN may need to be entered before reading the IMSI.
Syntax:
AT+CIMI
Command example Possible responses Note
AT+CIMI 208200120320598 IMSI value (15 digits)
136196-2220
+CCID – Card Identification
Description:
This command orders the product to read the EF-CCID file on the SIM card. If there is no EF-CCID file present on the SIM, the +CCID answer will not be sent, but the OK message will be returned.
Syntax:
AT+CCID
Command example Possible responses Note
AT+CCID +CCID:“123456789... EF-CCID is present,
hexadecimal format AT+CCID? +CCID:“123456789... Same result as +CCID AT+CCID=? OK No parameter but this
command is valid
+GCAP – Capabilities list
Description:
This command gets the complete list of capabilities.
Syntax:
AT+GCAP
Command example Possible responses Note
AT+GCAP +GCAP: +CGSM +FCLASS Supports GSM and FAX
OK commands
+CPOF – Power down modem software
Description:
This specific command stops the GSM software stack as well as the hardware layer. The AT+CFUN=0 command is equivalent to +CPOF.
Syntax:
AT+CPOF
Command example Possible responses Note
AT+CPOF OK Command valid
14 6196-2220
+CFUN – Set phone functionality
Description:
This command selects the mobile station’s level of functionality.When the application wants to stop the product with a power off, or if the application wants to force the product to execute an IMSI DETACH procedure, then it must send:
AT+CFUN=0 (equivalent to AT+CPOF)
This command executes an IMSI DETACH and makes a backup copy of some internal parameters in SIM and in EEPROM.The SIM card cannot then be accessed. If the mobile equipment is not powered off by the application after this command has been sent, a re-start command
AT+CFUN=1
...will have to be issued to restart the whole GSM registration process. If the mobile equipment is turned off after this command, then a power on will automatically restart the whole GSM process.The AT+CFUN=1 command restarts the entire GSM stack and GSM functionality: a complete software reset is performed.All parameters are reset to their previous values if AT&W was not used.
If you write entries in the phonebook (+CPBW) and then reset the product directly (AT+CFUN=1, with no previous AT+CFUN=0 command), some entries may not be writ­ten (the SIM task does not have enough time to write entries in the SIM card). In addition, the OK response will be sent at the last baud rate defined by the +IPR command.With the autobauding mode the response can be at a different baud rate, it is therefore preferable to save the defined baud rate with AT&W before directly sending the AT+CFUN=1 command.
Syntax:
AT+CFUN=<functionality level> <functionality level> may be one of the following parameters 0 Execute an IMSI detach
1 Restart the whole GSM registration process.
Command example Possible responses Note
AT+CFUN? +CFUN: 1 Full functionality indicated
OK Command valid AT+CFUN=0 OK Detach from network. AT+CFUN=1 OK Set the full functionality
mode with a complete software reset
156196-2220
+CPAS – Phone activity status
Description:
This command returns the activity status of the mobile equipment.
Syntax:
AT+CPAS
Command example Possible responses Note
AT+CPAS +CPAS: <pas> Current activity status OK Defined values:
<pas> may be one of the following parameters 0 ready (allow commands from TA/TE)
1 unavailable (does not allow commands) 2 unknown 3 ringing (ringer is active) 4 call in progress 5 asleep (low functionality)
+CMEE – Report Mobile Equipment Errors
Description:
This command disables or enables the use of the “+CME ERROR: <xxx>” or “+CMS ERROR:<xxx>” result code instead of simply “ERROR”.
See chapter ”error codes” for ”+CME ERROR” result codes description and ”+CMS ERROR” result codes.
Syntax:
AT+CMEE=<error reporting flag> <error reporting flag> may be one of the following parameters 0 Disable ME error reports, use only ”ERROR”
1 Enable long error reports, ”+CME ERROR xxx”
or ”+CMS ERROR xxx”
Command example Possible responses Note
AT+CMEE=0 OK Disable ME error reports,
use only « ERROR »
AT+CMEE=1 OK Enable
”+CME ERROR: <xxx>” or ”+CMS ERROR: <xxx>”
16 6196-2220
+CKPD – Keypad control
Description:
This command emulates the ME keypad by sending each keystroke as a character in a <keys> string.The supported GSM sequences are listed below in this manual. If emulation fails, a +CME ERROR: <err> is returned. If emulation succeeds, the result depends on the GSM sequence activated.
NOTE: In the case where the FDN phonebook is activated, the sequences concerning
“call forwarding” are allowed only if the entire sequence is written in the FDN.
Syntax:
AT+CKPD=<keys> <keys> may be a string of the following characters 0-9,*,# characters allowed in the keypad control string
Command example Possible responses Note
AT+CKPD=”*#21#” +CCFC: 0,7 Check every call
forwarding status
AT+CKPD=”1234” +CME ERROR 3 Sequence not allowed
+CCLK – Clock Management
Description:
This command is used to set or get the current date and time of the ME real-time clock. Default date/time is “98/01/01,00:00:00” (January 1st, 1998 / midnight).
Syntax:
AT+CCLK=<date and time string> <date and time string> is a string with the following format: “yy/MM/dd,hh:mm:ss” Valid years are 98 (for 1998) to 97 (for 2097).
The seconds field is not mandatory.
Command example Possible responses Note
AT+CCLK=”00/06/09,17:33:00” OK set date to June 9th, 2000,
and time to 5:33pm AT+CCLK=”00/13/13,12:00:00” +CME ERROR 3 Incorrect month entered AT+CCLK? +CCLK: “00/06/09... current date is June 9th,
2000, time is also reported
176196-2220
+CALA – Alarm Management
Description:
This command is used to set alarms date/time in the ME. The maximum number of alarms is 16. Seconds are not taken into account.
Syntax:
AT+CALA=<date and time string> (set alarm) AT+CALA=””,<index> (delete alarm) <date and time string> is a string with the following format: “yy/MM/dd,hh:mm:ss” Valid years are 98 (for 1998) to 97 (for 2097).
The seconds field is not mandatory.
<index> is a number from 0 to 15.
Command example Possible responses Note
AT+CALA= ”00/06/09,07:30” OK Set an alarm for June 9th,
2000 at 7:30 am, alarm stored
AT+CALA= ”99/03/05,13:00:00” +CME ERROR 3 Invalid alarm
(date/time expired)
AT+CALA? +CALA: list all alarms Note: three
“00/06/08,15:25:00”,0 alarms are set +CALA: “00/06/09,07:30:00”,1 (index 0, 1, 2) +CALA: “00/06/10,23:59:00”,2
+CALA: An alarm occurs (index 0) “00/06/08,15:25:00”,0
AT+CALA=””,2 OK Delete alarm index 2
Note: Alarm index 2
deleted
AT+CALA? +CALA:
“00/06/09,07:30:00”,1 List all alarms,
only one alarm (index 1)
18 6196-2220
Call Control commands
D and DL – Dial command
The ATD command is used to data or fax call. As per GSM 02.30, the dial command also controls supplementary services.
For a data or a fax call, the application sends the following ASCII string to the product (the bearer must be previously selected with the +CBST command):
ATD<nb> where <nb> is the destination phone number.
For a voice call, the application sends the following ASCII string to the product: (the bear­er may be selected previously, if not a default bearer is used).A voice call must be used when sending DTMF tones.
ATD<nb>; where <nb> is the destination phone number.
Please note that for an international number, the local international prefix does not need to be set (usually 00) but does need to be replaced by the ‘+’ character.
Example: to set up a data call to the Westermo Sweden office from another country, the AT command is:“ATD+4616428000”
Note that some countries may have specific numbering rules for their GSM handset numbering.
The ATDL command dials the last valid dialled number.
The response to the ATD command is one of the following:
Verbose result code Numeric code Description with ATV0 set
OK 0 if the call succeeds, for
voice call only
CONNECT <speed> 10,11,12, 13,14,15 <speed> if the call succeeds, for
data calls only takes the value negotiated by the product.
BUSY 7 If the called party is
already in communication
NO ANSWER 8 If no hang up is detected
after a fixed network time-out
NO CARRIER 3 Call setup failed or
remote user release. Use the AT+CEER command to know the failure cause
196196-2220
Direct dialling from a phonebook (stored in the SIM card) Direct dialling can be performed with the following command: ATD> <index>; to call <index> from the selected phonebook
(by the +CPBS command)
ATD> “BILL”; to call “BILL” from the selected phonebook ATD> mem <index> (mem is “SM”, “LD”,“MC”,“ME”, “RC”,“MT” or “SN”,
see +CPBS command) allows direct dialling from a phonebook number. Does not function with "ON" mem..15
Syntax:
ATD<nb>[<I>][;] ATD>[<mem>]<index>[<I>][;] ATD>[<mem>]<name>[<I>][;]
<nb> is the number to dial.
Command example Possible responses Note
AT+CPBS? +CPBS:”SM”,8,10 ADN phonebook is
selected, 8 locations are used and 10 locations are available
ATD>SM6; OK Call index 6 from
AND phonebook and call succeeds
Command specific information
When the FDN phonebook has been locked, only numbers beginning with the digits of FDN phonebook entries can be called. For example, if “014629” is entered in the FDN phonebook all the phone numbers beginning with these 6 digits can be called.
The CLIR supplementary service subscription can be overridden for this call only. “I” means “invocation” (restrict CLI presentation). “i” means “suppression” (allow CLI presentation).
Control of CUG supplementary service information by “G” or “g” is allowed for this call only.The index and info values set with the +CCUG command are used.
An outgoing call attempt could be refused if the AOC service is active and credit has expired (NO CARRIER).
When trying to set up an outgoing call while there is an active call, the active call is first put on hold, then the call set up is carried out.
20 6196-2220
GSM sequences
As per GSM 02.30, GSM sequences may be controlled using dial commands.These sequences can contain “*”,“#”, but “;” is forbidden. If the sequence is not supported or fails, +CME ERROR: <err> is returned. In the case where the FDN phonebook is activat­ed, the sequences concerning call forwarding are allowed only if there are written in the FDN.
Example of using GSM sequences:
Command example Possible responses Note
ATD*#21# +CCFC: 0,7 Check any call forwarding
status, no call forwarding reported
ATD**61*+33146290800**25# OK Register call forwarding
on no reply, with no reply timer fixed at 25 s, result:
done. ATD*2# +CME ERROR 3 Bad sequence See the enf of the manual for the list of supported sequences.
H – Hang-Up command
Description:
The ATH (or ATH0) command is used by the application to disconnect the remote user. In the case of multiple calls, all calls are released (active, on-hold and waiting calls). The ATH1 command disconnects the current outgoing call, only in dialing or alerting state (ie. ATH1 can be used only after the ATD command, and before its terminal response (OK, NO CARRIER, ...). It can be useful in the case of multiple calls.
Syntax:
ATH
Command example Possible responses Note
ATH OK Ask for disconnection,
result: every call, if any, are
released ATH1 OK Ask for outgoing call
disconnection,
Result: Outgoing call,
if any, is released
216196-2220
A – Answer a call
Description:
When the product receives a call, it sets the RingInd signal and sends the ASCII “RING” or “+CRING: <type>” 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 com­mand.
Syntax:
ATA
Command example Possible responses Note
RING Incoming call
ATA OK Answer to this incoming
call, call accepted
ATH OK Disconnect call OK,
call disconnected
+CEER – Extended error report
Description:
This command gives the cause of call release when the last call set up (originating or answering) failed.
Syntax:
AT+CEER
Command example Possible responses Note
ATD123456789 NO CARRIER Outgoing voice call,
call setup failure
AT+CEER +CEER: Error <xxx> Ask for reason of release,
OK <xxx> is the cause
information element values from GSM recom­mendation 04.08 or specific, call accepted
For the cause information element from GSM 04.08 see further in this manual. “NO CARRIER” indicates that the AT+CEER information is available for failure diagnosis.
22 6196-2220
+VTD, +VTS – DTMF signals
+VTD Description:
The product enables the user application to send DTMF tones over the GSM network. This command is used to define tone duration (the default value is 300 ms).
+VTD Syntax:
AT+VTD=<n> where <n>*100 gives the duration in ms. If n < 4, tone duration is 300 ms.
Command example Possible responses Note
AT+VTD=6 OK To define 600 ms tone
duration, command valid AT+VTD=0 OK To set the default value
+VTS Description:
The product enables the user application to send DTMF tones over the GSM network. This command enables tones to be transmitted. DTMF tones can only be transmitted when there is an active call.
+VTS Syntax:
AT+VTS=<Tone> where <Tone> is in {0-9,*,#,A,B,C,D}.
Command example Possible responses Note
AT+VTS=A OK Command valid AT+VTS=11 +CME ERROR: 4 If the <Tone> is wrong AT+VTS=4 +CME ERROR: 3 If there is no communica-
tion
Informative example:
To send tone sequence 13#, the application sends: AT+VTS=1;+VTS=3;+VTS=#
236196-2220
AT%Dn – Automatic dialing with DTR
Description:
This command enables and disables
• automatic dialling of the phone number stored in the first location of the ADN phonebook,
• automatic sending of the short message (SMS) stored in the first location of the SIM.
The number is dialled when DTR OFF switches ON. The short message is sent when DTR OFF switches ON.
Syntax:
AT%D<n>[ ;] Where <n> is 0, 1 or 2
Command example Possible responses Note
AT%D1; OK Activates DTR number
dialling DTR is OFF DTR switches ON The number in the first
location of the ADN is
dialled automatically DTR switches OFF The product goes off-
hook AT%D2 OK Activates DTR short
message sending
Defined values: <n>
AT%D0 Disables automatic DTR
number dialling / message
transmission. AT%D1 Activates automatic DTR
dialling if DTR switches
from OFF to ON; Dials
the phone number in the
first location of the ADN
phonebook. Data or Fax
call. AT%D2 Activates automatic DTR
short message transmis-
sion if DTR switches from
OFF to ON.
24 6196-2220
+CICB – Incoming Call Bearer
Description:
This specific command is used to set the type of incoming calls when no incoming bearer is given (see +CSNS).
NOTE: setting the +CICB command affects the current value of +CSNS.
Syntax:
AT+CICB=<mode>
Command example Possible responses Note
AT+CICB=1 OK If no incoming bearer,
force a fax call
AT+CICB=2 OK If no incoming bearer,
force a voice call
AT+CICB? +CICB: 2 Interrogate value,
incoming bearer: voice call
AT+CICB=? +CICB: (0-2) Test command, speech,
data or fax may be reported
Defined values: <mode>
0: Data 1: Fax 2: Speech
256196-2220
+CSNS – Single Numbering Scheme
Description:
This command selects the bearer to be used when an MT single numbering scheme call is set up (see +CICB). NOTE: setting the +CSNS command affects the current value of +CICB.
Syntax:
AT+CSNS
Command example Possible responses Note
AT+CSNS=2 OK force a fax call AT+CSNS=0 OK force a voice call AT+CSNS? +CSNS: 0 Interrogate value,
incoming bearer:
voice call AT+CSNS=? +CSNS: (0,2,4) Test command,
voice, data or fax default
incoming bearer
Defined values: <mode>
0: Voice 2: Fax 4: Data
26 6196-2220
Network service commands
+CSQ – Signal Quality
Description:
This command is used to ascertain the received signal strength indication (<rssi>) and the channel bit error rate (<ber>) with or without a SIM card inserted.
Syntax:
AT+CSQ
Command example Possible responses Note
AT+CSQ +CSQ: <rssi>,<ber> <rssi> and <ber>
as defined below
OK
Defined values: <rssi>
0: –113 dBm or less
1: –111 dBm 2–30: –109 to –53 dBm 31: –51dBm or greater 99: not known or not detectable
<ber>
0–7: as RXQUAL values in the table GSM 05.08
99: not known or not detectable
276196-2220
+COPS – Operator selection
Description:
There are three possible ways of selecting an operator (PLMN):
• The product is in manual mode. It then tries to find the operator specified by the appli­cation and if found, tries to register.
• The product is in automatic mode. It then tries to find the home operator and if found, tries to register. If not found, the product automatically searches for another network.
• The product enters into manual/automatic mode, and then tries to find an operator as specified by the application (as in manual mode). If this attempt fails it enters automatic mode. If this is successful, the operator specified by the application is selected. The mobile equipment then enters into automatic mode.
NOTE:The read command returns the current mode and the currently selected operator. In manual mode, this PLMN may not be the one set by the application (as it is in the search phase). These commands are not allowed during one communication.
Syntax:
To force an attempt to select and register on a network, the application must send the following command: Command syntax:AT+COPS=<mode>, [<format> [ , <oper> ] ]
Possible responses: AT+COPS=<mode>:
OK (Network is selected with full service) +CME ERROR: 30 (No network service)
+CME ERROR: 32 (Network not allowed – emergency calls only) +CME ERROR: 3 (Not allowed during one Communication) +CME ERROR: 4 (Incorrect parameters) +CME ERROR: 527 (Please wait, and retry your selection later) +CME ERROR: 528 (Location update failure – emergency calls only) +CME ERROR: 529 (Selection failure – emergency calls only)
Response syntax for AT+COPS?:
+COPS: <mode> [, <format>, <oper> ]
Response syntax for AT+COPS=?:
+COPS: [list of supported (<stat>, long alphanumeric <oper>, short alphanu-
meric <oper>s, numeric <oper>) s]
If an incoming call occurs during a PLMN list request, the operation is aborted (+CME ERROR: 520) and the unsolicited RING appears
28 6196-2220
Command example Possible responses Note
AT+COPS? +COPS: 0,2,20801 Ask for current PLMN,
OK reported PLMN is
France Telecom Orange
AT+COPS=? +COPS: Ask for PLMN list, home
(2,”F Itinéris”,”Itline”,”20801”), PLMN is France
OK (3,”FSFR”,”SFR”,”20810”)
Telecom, SFR network has been detected
AT+COPS=1,2,20810 +CME ERROR: 32 Ask for registration on
SFR network, network not allowed – emergency calls only
AT+COPS=1,1,23433 +CME ERROR: 529 Ask for registration on
UK Orange network Selection failed – emer­gency calls only
AT+COPS=0 OK Register on home net-
work, succeeded
AT+COPS=3,0 OK Set <format> to long
alphanumeric
AT+COPS? +COPS: 0,0,”Orange F” Ask for current PLMN,
OK home PLMN is
France Telecom Orange
AT+COPS=2 OK Request deregistration
from network, OK
AT+COPS? +COPS: 2 Ask for current PLMN
Note: ME is unregistered until <mode>=0 or 1 is selected.31
296196-2220
Defined values:
The parameters values are the following ones:
<mode>
0: automatic (default value) 1: manual 2: deregistration ; ME will be unregistered until <mode>=0 or 1 is selected. 3: set only <format> (for read command AT+COPS?) 4: manual / automatic (<oper> shall be present), if manual selection fails, auto-
matic mode is entered.
<format>
0: long alphanumeric format <oper> 1: short alphanumeric format <oper> 2: numeric <oper> (default value) <stat>: status of <oper>
<stat>
0: unknown 1: available 2: current 3: forbidden
<oper>
Operator identifier (MCC/MNC in numeric format only for operator selection). The long alphanumeric format can be up to 16 characters long (see appendix 18.12 for operator names description, field is “Name”).The short alphanumeric format can be up to 8 characters long..32
30 6196-2220
+CREG – Network registration
Description:
This command is used by the application to ascertain the registration status of the product.
Syntax:
AT+CREG= <mode>
Response Syntax
+CREG: <mode>, <stat> [ ,<lac>,<ci> ] for AT+CREG? Command only
Command example Possible responses Note
AT+CREG? +CREG: <mode>,<stat> As defined above
OK
AT+CREG=0 OK Disable network registra-
tion unsolicited result code, command valid
AT+CREG=1 OK Enable network registra-
tion unsolicited result code, command valid
AT+CREG=2 OK Enable network registra-
tion and location informa­tion unsolicited result code, command valid
AT+CREG=? +CREG: (0-2) 0,1,2 <mode> values are
supported
Defined values: <mode>
0: Disable network registration unsolicited result code (default) 1: Enable network registration code result code +CREG: <stat> 2: Enable network registration and location information unsolicited
result code +CREG:
<stat>
0: not registered, ME is not currently searching for a new operator. 1: registered, home network. 2: not registered, ME currently searching for a new operator to register to. 3: registration denied. 4: unknown. 5: registered, roaming.
316196-2220
<lac>
string type; two byte location area code in hexadecimal format (e.g. “00C3” equals 195 in decimal).
<ci>
string type; two byte cell ID in hexadecimal format.
+WOPN – Read operator name
Description:
This specific command returns the operator name in alphanumeric format when given the numeric format.
Syntax:
AT+WOPN=<format>,<NumOper>
Response syntax:
+WOPN: <format>,<AlphaOper>
Command example Possible responses Note
AT+WOPN=? OK Test command AT+WOPN=0,20801 +WOPN: 0,”Orange F” Give an operator
OK in numeric format,
alphanumeric answer
AT+WOPN=0,99999 +CME ERROR: 22 Give a wrong operator,
not found
Defined values:
<format>
is the required format. Only long (0) and short (1) alphanumeric formats are supported.
<NumOper>
is the operator in numeric format.
<AlphaOper>
is the operator in long or short alphanumeric format (see operator listing in the end of the manual.
32 6196-2220
+CPOL – Preferred operator list
Description:
This command is used to edit the SIM preferred list of networks.
Syntax:
AT+CPOL= [ <index> ][ , <format> [ , <oper> ] ]
The different possibilities are:
• AT+CPOL = <index> to delete an entry.
• AT+CPOL = , <format> to set the format used by the read command (AT+CPOL?).
• AT+CPOL = , <format>, <oper> to put <oper> in the next free location.
• AT+CPOL = <index> , <format> , <oper> to write <oper> in the <format> at the <index>.
The supported format are the same as for the +COPS command. The length of this list is limited to 8 entries.
336196-2220
Command example Possible responses Note
AT+CPOL? +CPOL:1,2,26201 Ask for preferred list of
+CPOL: 6,2,20810 networks, preferred list OK of networks in numeric
format
AT+CPOL=,0 OK Select long alphanumeric
format
AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” Ask for preferred list of
+CPOL: 6,0,”F SFR” network, Preferred list of OK networks in long
alphanumeric format AT+CPOL=7,2,20801 OK Add a network to the list AT+CPOL? CPOL: 1,0,”D1-TELEKOM” Ask for preferred list of
+CPOL: 6,0,”F SFR” networks, preferred list +CPOL: 7,0,”Orange F” of networks in long
OK alphanumeric format AT+CPOL=7 OK Delete 7th location AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” Ask for preferred list of
+CPOL: 6,0,”F SFR” networks, Preferred list
OK of networks in long
alphanumeric format
AT+CPOL=8,2,77777 OK Add a new network to
the list
AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” Ask for preferred list of
+CPOL: 6,0,”F SFR” networks, preferred list
+CPOL: 8,2,77777” of networks in long
OK alphanumeric format but
8th entry is unknown so the product edits it in the numeric format
AT+CPOL=9,0,”Orange F” Add a new network to
the list (text format)
AT+CPOL? +CPOL: 1,0,”D1-TELEKOM” Ask for preferred list of
+CPOL: 6,0,”F SFR” networks, preferred list
+CPOL: 8,2,77777” of networks in long
+CPOL: 9,0,”Orange F” alphanumeric format
OK
34 6196-2220
Security commands
+CPIN – Enter PIN
Description:
This command is used to enter 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). The application is responsible for checking the PIN after each reset or power on – if the PIN was enabled.
Syntax:
AT+CPIN=<pin>
Command example Possible responses Note
AT+CPIN=1234 OK Enter PIN, result: PIN
code is correct
AT+CPIN=5678 +CME ERROR: 3 Enter PIN, Operation not
allowed, PIN previously entered
After 3 unsuccessful attempts to enter the PIN (Personal Identification Number), the PUK (Personal Unblocking Key) will be required. PUK validation forces the user to enter a new PIN code as a second parameter and this will be the new PIN code if PUK valida­tion succeeds. CHV1 is then enabled if PUK1 is correct.
The application therefore uses this command: AT+CPIN=<Puk>,<NewPin>
Command example Possible responses Note
AT+CPIN=00000000,1234 +CME ERROR: 16 Enter PUK and new PIN,
result: Incorrect PUK
AT+CPIN=12345678,1234 OK Enter PUK and new PIN,
2nd attempt, PUK
correct, new PIN stored To ascertain which code must be entered (or not), the following query command can be used: AT+CPIN?
The possible responses are:
+CPIN: READY ME is not pending for any password +CPIN: SIM PIN CHV1 is required +CPIN: SIM PUK PUK1 is required +CPIN: SIM PIN2 CHV2 is required +CPIN: SIM PUK2 PUK2 is required +CPIN: PH-SIM PIN SIM lock (phone-to-SIM) is required +CPIN: PH-NET PIN Network personnalisation is required +CME ERROR: <err> SIM failure (13) absent (10) etc.
356196-2220
Please note that in this case the mobile equipment does not end its response with the OK string.The response +CME ERROR: 13 (SIM failure) is returned after 10 unsuccessful PUK attempts.The SIM card is then out of order and must be replaced by a new one.
Example:
3 failed PIN validations + 1 successful PUK validation
Command Responses Note
AT+CPIN? +CPIN: SIM PIN Read the PIN status
The product requires SIM PIN
AT+CPIN=1235 +CME ERROR: 16 First attempt to enter a
SIM PIN,Wrong PIN
AT+CPIN=1236 +CME ERROR: 16 Second attempt,
Wrong PIN
AT+CPIN=1237 +CME ERROR: 16 Third attempt,
Wrong PIN
AT+CPIN? +CPIN: SIM PUK Read PIN state,The prod-
uct requires PUK
AT+CPIN=99999999,5678 OK The PUK is entered, the
new PIN shall be 5678 PUK validation is OK. New Pin is 5678
AT+CPIN? +CPIN: READY Read PIN state,
the product is ready
If the user tries to do something which requires PIN2 (CHV2), the product will refuse the action with a “+CME ERROR: 17” (SIM PIN2 required).The product then waits for SIM PIN2 to be given. Of course, if SIM PIN2 is blocked, SIM PUK2 is required instead of SIM PIN2. For example, the product needs PIN2 to write in the fixed dialling phonebook (FDN), so if SIM PIN2 authentication has not been performed during the current session, SIM PIN2 is required.
Command example Possible responses Note
AT+CPBS=”FD” OK Choose FDN AT+CPBW=5,”01290917”, Write in FDN at location
129,”Jacky” +CME ERROR: 17 5, SIM PIN2 is required AT+CPIN? SIM PIN2 SIM PIN2 is required AT+CPIN=5678 OK Enter SIM PIN2 AT+CPBW=2,”01290917”, Write in FDN at location
129,”Jacky” OK 5, now writing in FDN is
allowed
Please note that the product only requests PIN2 or PUK2 once.Therefore, if they are not entered properly, the next +CPIN? command will return “+CPIN: READY”.
36 6196-2220
+CPIN2 – Enter PIN2
Description:
This specific command is used to validate the PIN2 code (CHV2), or to validate the PUK2 code (UNBLOCK CHV2) and to define 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.
Syntax:
AT+CPIN2=<pin2>
Command example Possible responses Note
AT+CPIN2=1234 OK Enter PIN2,
code is correct
AT+CPIN2=5678 +CME ERROR: 3 Enter PIN2, operation not
allowed, PIN2 previously entered
After 3 unsuccessful attempts, PUK2 will then be required. PUK2 validation forces the user to enter a new PIN2 code as a second parameter and this will be the new PIN2 code if PUK1 validation succeeds.The application therefore uses this command:
AT+CPIN2=<puk2>,<NewPin2>
Command example Possible responses Note
AT+CPIN2=00000000,1234 +CME ERROR: 16 Enter PUK2 and new
PIN2, Incorrect code (PUK2)
AT+CPIN2=12345678,1234 OK Enter PUK2 and new
PIN2, 2nd attempt PUK2 correct, new PIN2 stored To find out which code must be entered (or not), the following query com­mand can be used:
AT+CPIN2? +CPIN2: READY No PIN2 is needed
+CPIN2: SIM PIN2 PIN2 is required +CPIN2: SIM PUK2 PUK2 is required +CME ERROR: <err> Absent (10) etc...
376196-2220
+CPINC – PIN remaining attempt number
Description:
This specific command is used to get the number of valid attempts for PIN1 (CHV1), PIN2 (CHV2), PUK1 (UNBLOCK CHV1) and PUK2 (UNBLOCK CHV2) identifiers.
Syntax:
AT+CPINC
Response Syntax
+CPINC: <n1>,<n2>,<k1>,<k2>
Command example Possible responses Note
AT+CPINC +CPINC: 2,3,10,10 Get the number of
attempts left, first CHV1 attempt was a failure
AT+CPINC? +CPINC: 2,3,10,10 Get current values, first
attempt was a failure
AT+CPINC=? OK Get possible values
Defined values: <n1>, <n2>
are the attempts left for PIN1, PIN2 (0 = blocked, 3 max)
<k1>, <k2>
are the attempts left for PUK1, PUK2 (0 = blocked, 10 max) For this to work, the card should be present at the time of initialization, otherwise an
error will be sent (+CME ERROR: 10).
38 6196-2220
+CLCK – Facility lock
Description:
This command is used by the application to lock, unlock or interrogate an ME or network facility <fac>.
NOTE: Test SIM cards (with MCC=001 & MNC=01) doesn’t check “PS”,“PN”,
“PU”,“PP” and “PC” locks.
Syntax:
AT+CLCK= <fac>,<mode>[,<passwd>[,<class>] ]
Response syntax:
+CLCK: <status> [ ,<class1> ]<CR><LF>+CLCK: <status>,<class2> [ ... ] ]
Command example Possible responses Note
AT+CLCK=”SC”,1,1234 OK Enable PIN,
PIN was correct
AT+CLCK? +CLCK:(“PS”,0),(“SC”,0), Read PIN status,
(“FD”,0),(“PN“,0),(“PU“,0), PIN is enabled, no SIM (“PP“,0),(“PC“,0) lock, no network lock,
OK no information on Call
barring (no longer supported in GSM 07.07)
AT+CLCK=”SC”,0,5555 +CME ERROR: 16 Disable PIN, PIN was
wrong AT+CPIN=1234 OK Enter PIN, PIN was good AT+CLCK=? +CLCK:(“PS”,”SC”,”AO”, Request supported facili-
”OI”,”OX”,”AI”,”IR”, ties, supported facilities ”AB”, ”AC”, ”FD”,"PN", "PU","PP",”PN”)
OK
AT+CLCK=”PN”,1,12345678 OK Activate network lock,
Network lock activated AT+CLCK=”AO”,1,1234,2 OK Activate all outgoing calls
barring for data calls
Call barring is activate AT+CLCK=”AO”,2 +CLCK: 1,2 Query BAOC status,
OK BAOC activate for data
calls only AT+CLCK=”SC”,0,0000 +CME ERROR: 521 Disable PIN, PIN deactiva-
tion is forbidden with this
SIM card.
396196-2220
Defined values: <fac>
“PS”: SIM lock facility with a 8 digits password. “SC“: PIN enabled (<mode> = 1) / disabled (<mode> = 0) “AO”: BAOC (Barr All Outgoing Calls) “OI”: BOIC (Barr Outgoing International Calls) “OX”: BOIC-exHC (Barr Outgoing. International Calls except to Home Country) “AI”: BAIC (Barr All Incoming Calls) “IR”: BIC-Roam (Barr Inc.When Roaming outside Home Country) “AB”: All Barring services “AG”: All outGoing barring services “AC”: All inComing barring services “PN”: Network lock with a 8 digits password (NCK). “PU”: Network Subset lock with a 8 digits password (NSCK). “PP”: Service Provider lock with a 8 digits password (SPCK). “PC”: Corporate lock with a 8 digits password (CCK). “FD”: SIM Fixed Dialing Numbers (FDN) memory feature
(PIN2 is required as <password>)
<mode>
0: unlock the facility 1: lock the facility 2: query status
<class>
A facility status can be changed for only one class, or for all classes (7 or omitted). 1: Voice (telephony)
2: Data (apply to all bearer services) 4: Fax (facsimile services) 8: Short Message service 7: Equal to all classes (Default value)
Any attempt to combine different classes will result in activation / deactivation / interrogation of all classes.
Password maximum length is given with the AT+CPWD=? Command. NOTE: It will not possible to lock the FDN phonebook if this one is not loaded..
40 6196-2220
+CPWD – Change password
Description:
This command is used by the application to change a password (PIN, call barring, NCK, etc.).The facility values <fac>) 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.
Syntax:
AT+CPWD= <fac>, <oldpwd>, <newpwd>
Command example Possible responses Note
AT+CPWD=? +CPWD: (“PS”,8),(“SC”,8), Possible values,
(“AO”,4),(“OI”,4),(“OX”,4), CHV1/CHV2 (“AI”,4),(“IR,4),(“AB”,4), must be on 8 digits (“AG”,4),(“AC”,4),(“P2”,8), maximum (4mn), for call (“FD”,8),("PN",8),("PU",8), barring, on 4 digits ("PP",8), ("PC",8) maximum
OK
AT+CPWD=”SC”,1234,5555 OK Change PIN, PIN was cor-
rect AT+CPWD=”SC”,1234,5555 +CME ERROR: 16 Change PIN, PIN was
wrong AT+CPIN=5555 OK Enter PIN, PIN was
correct AT+CPWD=”PN”,12345678, Change NCK, NCK
00000000 OK changed for net lock
416196-2220
Phonebook commands
+CPBS – Select phonebook memory storage
Description:
This command selects phonebook memory storage. The available phonebooks are: “SM“: ADN (SIM phonebook)
“FD”: FDN (SIM Fix Dialling, restricted phonebook) “ON”: MSISDN (SIM own numbers) “EN”: EN (SIM emergency number) “LD”: LND (combined ME and SIM last dialing phonebook) “MC”: MSD (ME missed calls list) “ME”: ME (ME phonebook) “MT”: MT (combined ME and SIM phonebook) “RC”: LIC (ME received calls list) “SN”: SDN (Services dialing phonebook)
Syntax:
AT+CPBS
Command example Possible responses Note
AT+CPBS=”SM” OK Select ADN phonebook,
ADN phonebook is selected
AT+CPBS=? +CPBS: ("SM","LD","MC", Possible values, only “EN”
phonebook is not "ON","ME","RC","MT","SN") supported with this OK SIM card.
AT+CPBS? +CPBS:”SM”,10,20
OK
Status,ADN phonebook selected, 10 locations used, 20 locations available. The ADN phonebook could not be selected as FDN is active.
42 6196-2220
+CPBR – Read phonebook entries
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).
Syntax:
AT+CPBR
Command example Possible responses Note
AT+CPBR=? +CPBR: (1-50),20,10 Test command,
OK 50 locations
(from 1 to 50), max length for phone number is 20 digits, 10 characters max for the text
AT+CPBR=12,14 +CPBR: 12,”112”,129,
”Emergency” Read entries from 12
to 14, Display locations
+CPBR: 13,”+331290909”, 12,13,14 with location,
145,”Fred” number, type (TON/NPI),
+CPBR: 14,”0146290808”, text
129,”Zazi”
OK
AT+CPBR=10 +CPBR:10,”0146290921”, Read entry 10, display
129,”Rob” location 10
OK
AT+CPBR=11 +CPBR:11,”0146290921”, Read entry 11 (UCS2
129, ”8000010002FFFF” format), display location 11
OK
AT+CPBR=52 +CME ERROR: 21 Read entry 52 (wrong),
Invalid index
436196-2220
+CPBF – Find phonebook entries
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", "SN" phone­books and for the “EN” phonebook, which does not contain alphanumeric fields. It is possible to use this command with UCS2 strings. If a wrong UCS2 format is entered, the string is considered as an ASCII string.
Syntax:
AT+CPBF
Command example Possible responses Note
AT+CPBF=? +CPBF: 20,10 Test command, max
OK length for phone number
is 20 digits, 10 characters for the text
AT+CPBF=“E” +CPBF: 12,”112”,129, Read entries with “E”,
”Emergency” display locations
+CPBF: 15,”+331290101”, with text field starting
145,”Eric” with “E”
OK
AT+CPBF=”H” +CME ERROR: 22 Read entries with “H”,
entry not found
AT+CPBF=”800001FFFF” +CPBF: 11, ”0146290921”, Read entries starting with
129,”8000010002FFFF” 0001 UCS2 character,
OK display locations with
text field starting with 0001 UCS2 character
AT+CPBF=”8045C” +CME ERROR: 22 Read entries with
“8045C” (ASCII format), entry not found. The string has a wrong UCS2 format, it is there­fore considered as an ASCII string.
44 6196-2220
+CPBW Write phonebook entry
Description:
This command writes a phonebook entry in location number <index> in the current phonebook memory storage. “RC” and “MC” phonebooks could be only erased by +CPBW. Adding field and/or modifying field is not allowed for these phonebooks.This command is not allowed for “EN”, “LD”,“MC”, “RC”,“MT”,“SN” phonebooks, which can not be written.
Syntax:
AT+CPBW=<index>[,<number>[,<type>[,<text>]]]
Command example Possible responses Note
AT+CPBW=? +CPBW: (1-50),20, Test command, 50 loca-
(129,145),10 tions, phone number =
OK 20 digits max,TON/NPI
of 129 or 145, text length = 10
AT+CPBW= 3 OK Erase location 3, location
3 erased
AT+CPBW=5,”112”,129, Write at location 5,
”SOS” OK location 5 written
AT+CPBW=5,”01290917”, Overwrite location 5,
129,”Jacky” OK location 5 overwritten
AT+CPBW=6,”01292349”, Write location 6 (UCS2
129,”8000410042” OK format for the <text>
field), location 6 is written
AT+CPBW=,”+3314522 Write at the first location
1100”,145,”SOS” OK available, first location
available is written
AT+CPBW=,”0345221100”, Write at the first location
129,”SOS” +CME ERROR: 20 available, phonebook full
AT+CPBW=57,”112”,129, Write at location 57
”WM” +CME ERROR: 21 (wrong), invalid index
AT+CPBW=7,”0123456789 Write at location 7 a
01234567890”,129, phone number ”WAVE” +CME ERROR: 26 exceeding the limit
(21 digits), phone number too long
AT+CPBW=7,”012233 Write at location 7 along
4455”,129,”WESTERMO text (11 TEL” characters),Text too long
+CME ERROR: 24
456196-2220
AT+CPBW=8,”01292349”, Write location, location
129,”80xyz” OK 8 is written.The string
has a wrong UCS2 format, it is therefore considered as an ASCII string
When the fixed dialling phonebook (FDN) is locked, this command is not allowed. Moreover, when the FDN is unlocked, PIN2 is required to write in the FDN phonebook. But if PIN2 authentication has been performed during the current session, the +CPBW command with FDN is allowed.
Command example Possible responses Note
AT+CPBS=”FD” OK Choose FDN AT+CPBW=5,”01290917”, Write in FDN at location
129,”Jacky” +CME ERROR: 17 5, SIM PIN2 is required AT+CPIN? SIM PIN2 SIM PIN2 is required AT+CPIN=5678 OK Enter SIM PIN2 AT+CPBW=5,”01290917”, Write in FDN at
129,”Jacky” OK location 5, writing in FDN
is now allowed
Defines values:
<index> integer type value depending on the capacity of the phonebook memory. <number> phone number in ASCII format. <type> TON/NPI (Type of address octet in integer format).
NOTE: for the <type> parameter, all values are allowed from 0 to 255, but the MSB will
be set to 1 in all cases (example: a <type> value of 17 will be written as
145).
<text> string type.
NOTE 1: For the <text> parameter all strings starting with “80” ,“81” or “81” are
considered in UCS2 format. See the APPENDIX E (Coding of Alpha fields in the SIM for UCS2).
NOTE 2: The +CSCS (Select Character set) command does not affect the format
for phonebook entries.
46 6196-2220
+CPBP – Phonebook phone search
Description:
This specific command orders the product to search the phonebook for an item with the same phone number as that defined in the parameter.
Syntax:
AT+CPBP=<PhoneNumber> <PhoneNumber> is coded like any GSM 07.07 or GSM 07.05 phone number.
Command example Possible responses Note
AT+CPBP=”+331290101” +CPBP: 15,”+331290101”, Search entries correspon-
145,”Eric” ding to this phone
OK number, display the entry
corresponding to the specified phone number
AT+CPBP=”+331290101” +CPBP: 15,”01290101”, Search entries correspon-
129,”Eric” ding to this phone
OK number, display the entry
corresponding to the specified phone number
AT+CPBP=”01290202” +CPBP: 15,”+331290202”, Search entries correspon-
145,”David” ding to this phone
OK number, display the entry
corresponding to the specified phone number
AT+CPBP=”+331288575” +CPBP: 15,”+331290101”, (UCS2 format)
145, ”8045682344FFFF” Search entries correspon-
OK ding to this phone
number, display the entry corresponding to the specified phone number
AT+CPBP=”0129” +CME ERROR: 22 Search entries correspon-
ding to this phone num­ber, entry not found.
476196-2220
+CPBN – Move action in phonebook
Description
This specific command instructs the product to make a forward or backward move in the phonebook (in alphabetical order).This command is not allowed for the “EN” phone­book – which does not contain alphanumeric fields.
Syntax:
AT+CPBN=<mode>
Command example Possible responses Note
AT+CPBN=? +CPBN: (0–5) Test command, possible
OK modes
AT+CPBN=0 +CPBN: 15,”+331290101”, Read the first location,
145,”Eric” display the first location
OK
AT+CPBN=2 +CPBN: 5,”+33147658987”, Read the next location,
145,”Frank” display the second location
OK
AT+CPBN=2 +CPBN: 6,”+331290302”, Read the next location,
145,”Marc” display the third location
OK
AT+CPBN=3 +CPBN: 5,”+33147658987”, Read the previous loca-
145, ”Frank” tion, display the
OK second location
AT+CPBN=1 +CPBN: 6,”+331290302”, Read the last location,
145,”Marc” display the last location
OK
AT+CPBN=2 +CPBP: 15,”+331290101”, Read the next location,
145, ”Eric” display the first location
OK
48 6196-2220
Using mode 4 and 5 with +CPBF command and CPBW:
Command example Possible responses Note
AT+CPBF=”Er” +CPBF: 15,”+331290101”, Find ”Er” in phonebook,
145, ”Eric” Display the location
OK
AT+CPBN=2 +CPBN: 5,”+33147658987”, Read the next location,
145, ”Frank” display the following
OK location
AT+CPBF=”Er” +CPBF: 15, ”+331290101”, Find ”Er” in phonebook,
145, ”Eric” display the location
OK
AT+CPBN=4 +CPBF: 15, ”+331290101”, Get the last location read,
145, ”Eric” display the last location
OK read
AT+CPBW=,”0146290800”, Write an item at the first
129,”WM” OK location available, no infor-
mation about this location
AT+CPBN=4 +CPBF: 15, ”+331290101”, Get the last location read,
145,”Eric” display the last location
OK read
AT+CPBN=5 AT+CPBN=38,”0146290800, Display the last item
129,”WM” written with its location
AT+CPBN=4 AT+CPBN=38,”0146290800, Get the last item read,
129,”WM” now the last item read is
the last written item too
AT+CPBF=”800041FFFF” +CPBF: 15,”+3312345”,145, Find”800041” in phone-
”8000414339FFFF” book, Display this loca-
OK tion
AT+CPBN=4 +CPBF: 15,”+3312345”,145, Get the last location read,
”8000414339FFFF” display the last location
OK read
Please note that the AT+CPBN=5 command is useful after an AT+CPBW command used without a location.
Defined values: <mode>
0: First item 1: Last item 2: Next valid item in alphabetical order 3: Previous valid item in alphabetical order 4: Last item read (usable only if a read operation has been performed on the
current phonebook since the end of initialization (+WIND: 4))
5: Last item written (usable only if a write operation has been performed on the
current phonebook since the end of initialization (+WIND: 4)).
496196-2220
+CNUM – Subscriber number
Description:
This command returns the subscriber MSISDN(s). If the subscriber has different MSISDNs for different services, each MSISDN is returned in a separate line.
Syntax:
AT+CNUM Response syntax: +CNUM: <alpha1>, <number1>, <type1> <CR><LF>
+CNUM: <alpha2>, <number2>, <type2> ....
Command example Possible responses Note
AT+CNUM +CNUM:”Phone”, Get MSISDN(s)
“0612345678”,129
+CNUM:”Fax”,
“0687654321”,129
+CNUM:”80001002FFFF”,
“+0183773”, 145 (UCS2 format)
AT+CNUM=? OK
Defined values: <alphax> optional alphanumeric string associated with <numberx>
<numberx> string type phone number with format as specified by <typex> <typex> type of address byte in integer format.51
50 6196-2220
+WAIP – Avoid phonebook init
Description:
This specific command allows the initialization of all phonebooks to be inhibited during subsequent boots.
Syntax:
AT+WAIP=<mode>
Command example Possible responses Note
AT+WAIP? +WAIP:0 Current values?
OK
AT+WAIP=? +WAIP: (0,1) Possible values?
OK
AT+WAIP =1 OK Inhibit initialization of
phonebooks (next boot)
AT&W Save modifications
in EEPROM
Caution: The given value should be stored in EEPROM.Therefore, the AT&W
command must be used to save the new <mode> value.
NOTE: No phonebook commands are allowed if +WAIP=1 (after boot).
If a phonebook command is entered, a “+CME ERROR: 3” is returned.
Defined values: <mode>
0: Normal initialization (with phonebooks) 1: No phonebook initialization.52
516196-2220
+WDCP – Delete Calls Phonebook
Description:
This specific command allows to delete the calls listed in some phonebooks.
Syntax:
AT+WDCP=<calls phonebook>
Command example Possible responses Note
AT+WDCP? OK AT+WDCP=? +WDCP: ("LD","MC","RC") Possible values?
OK The result is the identi-
fiers of the a list of calls
AT+WDCP=”LD” OK Delete all the content of
Last Dialing phonebook.
Defined values: <calls phonebook>
“LD”: SIM (ME extended) Last dialing phonebook “MC”: ME missed calls list phonebook “RC”: ME received calls list phonebook
52 6196-2220
+CSVM Set Voice Mail Number
Description:
This commands allows to set/get and enable/disable the voice mail number in memory.
Syntax:
AT+CSVM=<mode>[,<number>[,<type>]]
Command example Possible responses Note
AT+CSVM? +CSVM: 1,”660”,129 Get mail number, result:
OK voice mail number “660”
is activated
AT+CSVM=? +CSVM: (0-1),(129,145) Possible values?
OK
AT+CSVM=0,”888”,129 OK Disable Voice Mail num-
ber and change value to “888”.
Defined values: <mode>
0: Disable the voice mail number 1: Enable the voice mail number
<number>
Phone number in ASCII format.
<type>
TON/NPI (Type of address byte in integer format).
NOTE: For the <type> parameter, all values are allowed from 0 to 255, but the MSB
will be set to 1 in all cases (ex: a <type> value of 17 will be written as 145).
536196-2220
Short Messages commands
Parameters definition
The parameters below are used in the short message commands.
<da> Destination Address, coded like GSM 03.40 TP-DA <dcs> Data Coding Scheme, coded like in document [5]. <dt> Discharge Time in string format:“yy/MM/dd,hh:mm:ss±zz”
(Year [00-99], Month [01-12], Day [01-31], Hour, Minute, Second and Time Zone [quarters of an hour] )
<fo> First Octet, coded like SMS-SUBMIT first octet in
GSM 03.40, default value is 17 for SMS-SUBMIT
<index> Place of storage in memory. <length> Text mode (+CMGF=1): number of characters PDU mode
(+CMGF=0): length of the TP data unit in octets
<mem1> Memory used to list, read and delete messages
(+CMGL, +CMGR and +CMGD).
<mem2> Memory used to write and send messages
(+CMGW, +CMSS).
<mid> CBM Message Identifier. <mr> Message Reference. <oa> Originator Address. <pid> Protocol Identifier. <pdu> For SMS: GSM 04.11 SC address followed by GSM 03.40
TPDU in hexadecimal format, coded as specified in GSM
03.40 for CBS: GSM 03.41 TPDU in hexadecimal format
<ra> Recipient Address. <sca> Service Center Address <scts> Service Center Time Stamp in string format:
“yy/MM/dd,hh:mm:ss±zz” (Year/Month/Day,Hour:Min:Seconds±TimeZone)
<sn> CBM Serial Number <st> Status of a SMS-STATUS-REPORT <stat> Status of message in memory. <tooa> Type-of-Address of <oa>. <tora> Type-of-Address of <ra>. <tosca> Type-of-Address of <sca>. <total1> Number of message locations in <mem1>. <total2> Number of messages locations in <mem2. <used1> Total number of messages locations in <mem1>. <used2> Total number of messages locations in <mem2. <vp> Validity Period of the short message, default value is 167
54 6196-2220
+CSMS Select message service
Description:
The supported services are originated (SMS-MO) and terminated short message (SMS­MT) + Cell Broadcast Message (SMS-CB) services.
Syntax:
AT+CSMS=<service>
Command example Possible responses Note
AT+CSMS=0 +CSMS: 1,1,1 SMS AT command Phase
OK 2 version 4.7.0,
SMS-MO, SMS-MT and SMS-CB supported
AT+CSMS=1 +CSMS: 1,1,1 SMS AT command Phase
2 +, SMS-MO, SMS-MT and SMS-CB supported
AT+CSMS? +CSMS: 0,1,1,1 Current values? GSM
OK 03.40 and 03.41
(SMS AT command Phase 2 version 4.7.0
AT+CSMS=? +CSMS: (0,1) Possible services OK
Defined values: <service>
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.
556196-2220
+CNMA New Message Acknowledgement
Description:
This command allows reception of a new message routed directly to the TE to be acknowledged. In TEXT mode, only positive acknowledgement to the network (RP-ACK) is possible. In PDU mode, either positive (RP-ACK) or negative (RP-ERROR) acknowl­edgement to the network is possible.Acknowledge with +CNMA is possible only if the +CSMS parameter is set to 1 (+CSMS=1) when a +CMT or +CDS indication is shown (see +CNMI command). If no acknowledgement is given within the network timeout, an RP-ERROR is sent to the network, the <mt> and <ds> parameters of the +CNMI com­mand are then reset to zero (do not show new message indication).
Syntax in text mode:
AT+CNMA
Syntax in PDU mode:
AT+CNMA [ = <n> [ , <length> [ <CR> PDU is entered <ctrl-Z / ESC> ] ] ]
NOTE: PDU is entered using <ackpdu> format instead of <pdu> format
(e.g.. SMSC address field is not present).
Example of acknowledgement of a new message in TEXT mode:
Command example Possible responses Note
AT+CMGF=1 OK Set TEXT mode AT+CNMI=2,2,0,0,0 OK <mt>=2
+CMT:“123456”, Received message
”98/10/01, 12:30 00+00”, 129, 4, 32, 240,“15379”, 129,5<CR><LF>
AT+CNMA OK Acknowledge the message
received Note: send positive acknowledgement to the network
AT+CNMA +CMS ERROR: 340 Try to acknowledge again
Note: no +CNMA acknowledgment expected
56 6196-2220
Example of acknowledgement of a new message in PDU mode:
Command example Possible responses Note
AT+CMGF=0 OK Set PDU mode
+CMT: Message received
,2907913366003000F 1240B913366920547F3000 0003003419404800B50621 5D42ECFE7E17319
AT+CNMA=2,<length><CR> OK Negative acknowledge­...Pdu message...<Ctrl-Z/ESC> ment for the message.
Send a negative acknowledgement to the network (RP-ERROR) with PDU message (<ackpdu> format).
Defined values: <n>: Type of acknowledgement in PDU mode
0: send RP-ACK without PDU (same as TEXT mode) 1: send RP-ACK with optional PDU message 2: send RP-ERROR with optional PDU message
<length>:
Length of the PDU message
576196-2220
+CPMS Preferred Message Storage
Description:
This command allows the message storage area to be selected (for reading, writing, etc).
Syntax:
AT+CPMS=<mem1>,[<mem2>]
Command example Possible responses Note
AT+CPMS=? +CPMS: ((“SM”,”BM”,”SR”), Possible message
(“SM”)) storages.
OK
AT+CPMS? +CPMS:“SM”, 3, 10, Read, write...SMS
”SM”, 3,10 from/to SIM 3 SMS are
OK stored in SIM. 10 is the
total memory available in SIM
AT+CPMS=”AM” +CMS ERROR: 302 Select false message
storage
AT+CPMS=”BM” +CPMS: 2,20,3,10 Select CBM message
OK storage. Read, list, delete
CBM from RAM 2 CBM are stored in RAM
AT+CPMS? +CPMS: “BM” ,2,20, Read list, delete CBM
”SM”, 3,10 from RAM Write SMS
OK to SIM
Defined values: <mem1>: Memory used to list, read and delete messages. It can be:
“SM”: SMS message storage in SIM (default)
“BM”: CBM message storage (in volatile memory).
“SR”: Status Report message storage (in SIM if the EF-SMR file exists, otherwise in
the ME non volatile memory)
NOTE: “SR” ME non volatile memory is cleared when another SIM card is inserted.
It is kept, even after a reset, while the same SIM card is used.
<mem2>: Memory used to write and send messages “SM”: SMS message storage in SIM (default).
If the command is correct, the following message indication is sent: +CPMS: <used1>,<total1>,<used2>,<total2>
When <mem1> is selected, all following +CMGL, +CMGR and +CMGD commands are related to the type of SMS stored in this memory.
58 6196-2220
+CMGF – Preferred Message Format
Description:
The message formats supported are text mode and PDU mode. In PDU mode, a com­plete SMS Message including all header information is given as a binary string (in hexa­decimal format).Therefore, only the following set of characters is allowed: {‘0’,’1’,’2’,’3’,’4’,’5’,’6’,’7’,’8’,’9’,‘A’, ‘B’,’C’,’D’,’E’,’F’}. Each pair or characters is converted to a byte (e.g.:‘41’ is converted to the ASCII character ‘A’, whose ASCII code is 0x41 or 65). In Text mode, all commands and responses are in ASCII characters. The format selected is stored in EEPROM by the +CSAS command.
Syntax:
AT+CMGF
Command example Possible responses Note
AT+CMGF ? +CMGF: 1 Current message format:
OK Text mode
AT+CMGF=? +CMGF: (0-1) Possible message format:
Text or PDU OK modes are available
Example, sending an SMS Message in PDU mode
Command example Possible responses Note
AT+CMGF=0 OK Set PDU mode AT+CMGS=14<CR> +CMGS: 4
000103069121436500 Send complete MSG in 0004C9E9340B OK PDU mode, no SC
address
Defined values:
The <pdu> message is composed of the SC address (« 00 means no SC address given, use default SC address read with +CSCA command) and the TPDU message. In this example, the length of octets of the TPDU buffer is 14, coded as GSM 03.40. In this case the TPDU is: 0x01 0x03 0x06 0x91 0x21 0x43 0x65 0x00 0x00 0x04 0xC9 0xE9 0x34 0x0B, which means regarding GSM 03.40:
<fo> 0x01 (SMS-SUBMIT, no validity period) <mr> (TP-MR) 0x03 (Message Reference) <da> (TP-DA) 0x06 0x91 0x21 0x43 0x65 (destination address +123456) <pid> (TP-PID) 0x00 (Protocol Identifier) <dcs> (TP-DCS) 0x00 (Data Coding Scheme: 7 bits alphabet) <length> (TP-UDL) 0x04 (User Data Length, 4 characters of text) TP-UD 0xC9 0xE9 0x34 0x0B (User Data: ISSY)
TPDU in hexadecimal format must be converted into two ASCII characters, e.g. octet with hexadecimal value 0x2A is presented to the ME as two characters ‘2’ (ASCII 50) and ‘A’ (ASCII 65).
596196-2220
+CSAS – Save Settings
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.
Syntax:
AT+CSAS
Command example Possible responses Note
AT+CSAS OK Store +CSAS and +CSMP
parameters
+CRES – Restore settings
Description:
All settings specified in the +CSCA and +CSMP commands are restored from EEPROM if the SIM card is Phase 1 or from the SIM card if it is a Phase 2 SIM card.
Syntax:
AT+CRES
Command example Possible responses Note
AT+CRES OK Restore +CSAS and
+CSMP parameters
+CSDH – Show text mode parameters
Description:
This command gives additional information on text mode result codes.This information is given in brackets in the +CMTI, +CMT, +CDS, +CMGR, +CMGL commands.
Syntax:
Command Syntax: AT+CSDH
Command example Possible responses Note
AT+CSDH? +CSDH: 0 Current value, Do not
OK show header values
60 6196-2220
+CNMI – New message indication
Description:
This command selects the procedure for message reception from the network.
Syntax:
AT+CNMI=<mode>,<mt>,<bm>,<ds>,<bfr>
Command example Possible responses Note
AT+CNMI=2,1,0,0,0 OK <mt>=1
AT+CMTI:“SM”,1 message received AT+CNMI=2,2,0,0,0 OK <mt>=2 +CMT:“123456”, ”98/10/01, message received
12:30 00+00”, 129,4,32,240,“15379”,
129,5<CR><LF> AT+CNMI=2,0,0,1,0 OK <ds>=1 AT+CMGS= +CMGS: 7 Send a message in text
”+33146290800”<CR> mode, successful trans­Message to send <ctrl-Z> OK mission
+CDS: 2, 116, message was correctly
”+33146290800”, 145, delivered
“98/10/01,12:30:07+04”,
“98/10/01
12:30:08+04”, 0
Defined values: <mode>
controls the processing of unsolicited result codes. Only <mode>=2 is supported. Any other value for <mode> (0,1 or 3) is accepted (return code will be OK), but the pro­cessing of unsolicited result codes will be the same as with<mode>=2.
Possible values:
0: Buffer unsolicited result codes in the TA. If TA result code buffer is full, indica-
tions can be buffered in some other place or the oldest indications may be dis­carded and replaced with the new received indications
1: Discard indication and reject new received message unsolicited result codes
when TA-TE link is reserved. Otherwise forward them directly to the TE
2: Buffer unsolicited result codes in the TA when TA-TE link is reserved and flush
them to the TE after reservation. Otherwise forward them directly to the TE
3: Forward unsolicited result codes directly to the TE.TA-TE link specific inband
used to embed result codes and data when TA is in on-line data mode
616196-2220
<mt>
sets the result code indication routing for SMS-DELIVERs. Default is 0.
Possible values:
0: No SMS-DELIVER indications are routed. 1: SMS-DELIVERs are routed using unsolicited code: +CMTI: “SM”,<index> 2: SMS-DELIVERs (except class 2 messages) are routed using unsolicited code:
+CMT: [<alpha>,] <length> <CR> <LF> <pdu> (PDU mode) or +CMT: <oa>,[<alpha>,] <scts> [,<tooa>, <fo>, <pid>, <dcs>, <sca>, <tosca>, <length>] <CR><LF><data> (text mode)
3: Class 3 SMS-DELIVERS are routed directly using code in <mt>=2 ;
Message of other classes result in indication <mt>=1
<bm>
set the rules for storing received CBMs (Cell Broadcast Message) types depend on its coding scheme, the setting of Select CBM Types (+CSCB command) and <bm>. Default is
0.
Possible values:
0: No CBM indications are routed to the TE. The CBMs are stored. 1: The CBM is stored and an indication of the memory location is routed to the
customer application using unsolicited result code: +CBMI:“BM”, <index>
2: New CBMs are routed directly to the TE using unsolicited result code. +CBM:
<length><CR><LF><pdu> (PDU mode) or +CBM:<sn>,<mid>,<dcs>,<page>,<pages>(Text mode) <CR><LF> <data>
3: Class 3 CBMs: as <bm>=2. Other classes CBMs: as <bm>=1..63
<ds>
for SMS-STATUS-REPORTs. Default is 0.
Possible values:
0: No SMS-STATUS-REPORTs are routed. 1: SMS-STATUS-REPORTs are routed using unsolicited code: +CDS: <length>
<CR> <LF> <pdu> (PDU mode) or +CDS: <fo>,<mr>, [<ra>] , [<tora>], <scts>,<dt>,<st> (Text mode)
2: SMS-STATUS-REPORTs are stored and routed using the unsolicited result
code: +CDSI: “SR”,<index>
62 6196-2220
<bfr>
Default is 0.
Possible values:
0: TA buffer of unsolicited result codes defined within this command is flushed to
the TE when <mode> 1...3 is entered (OK response shall be given before flushing the codes)
1: TA buffer of unsolicited result codes defined within this command is cleared
when <mode> 1...3 is entered.
+CMGR – Read message
Description:
This command allows the application to read stored messages.The messages are read from the memory selected by +CPMS command.
Syntax:
AT+CMGR=<index>
Response syntax for text mode:
+CMGR:<stat>,<oa>,[<alpha>,] <scts> [,<tooa>,<fo>, <pid>,<dcs>,<sca>, <tosca>,<length>] <CR><LF> <data> (for SMS-DELIVER only)
+CMGR: <stat>,<da>,[<alpha>,] [,<toda>,<fo>,<pid>,<dcs>, [<vp>], <sca>, <tosca>,<length>]<CR><LF> <data> (for SMS-SUBMIT only)
+CMGR: <stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> (for SMS-STATUS-REPORT only)
Response syntax for PDU mode:
+CMGR: <stat>, [<alpha>] ,<length> <CR><LF> <pdu>
A message read with status “REC UNREAD” will be updated in memory with the status “REC READ”.
NOTE: the <stat> parameter for SMS Status Reports is always “READ”.
636196-2220
Example:
Command example Possible responses Note
AT+CMTI:“SM”,1 New message received
AT+CMGR=1 +CMGR:“REC UNREAD”,
”0146290800”, Read the message ”98/10/01,18:22:11+00”, <CR><LF> ABCdefGHI
OK
AT+CMGR=1 +CMGR:“REC UNREAD”, Read the message again,
”0146290800”, note that the message is
”98/10/01,18:22:11+00”, read now
<CR><LF> ABCdefGHI
OK AT+CMGR=2 +CMS ERROR: 321 Read at a wrong index AT+CMGF=0;AT+CMGR=1 +CMGR: 2,,<length> In PDU mode Note:
<CR><LF><pdu> Message is stored but
OK unsent, no <alpha>field AT+CMGF=1;+CPMS=”SR”; Reset to text mode, set
+CNMI=,,,2 OK read memory to
“SR”, and allow storage of further SMS Status Report into “SR” memory
AT+CMSS=3 +CMSS: 160 OK Send an SMS previously
+CDSI:“SR”,1 stored
New SMS Status Report stored in “SR” memory at index 1
AT+CMGR=1 +CMGR: "READ",6,160, Read the SMS Status
"+33612345678", Report 129,"01/05/31, 15:15:09+00", "01/05/31,15:15:09+00",0
OK
64 6196-2220
+CMGL – List message
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.
Syntax:
AT+CMGL=<stat>
Response syntax for text mode:
+CMGL: <index>,<stat>,<da/oa>[,<alpha>], [<scts>, <tooa/toda>, <length>] <CR><LF><data> (for SMS-DELIVER and SMS-SUBMIT, may be followed by other <CR><LF>+CMGL:<index>...)
+CMGL: <index>,<stat>,<fo>,<mr>,[<ra>],[<tora>],<scts>,<dt>,<st> (for SMS-STATUS-REPORT only, may be followed by other <CR><LF>+CMGL:<index>...)
Response syntax for PDU mode:
+CMGL: <index>,<stat>, [<alpha>], <length> <CR><LF> <pdu> (for SMS-DELIVER, SMS-SUBMIT and SMS-STATUS-REPORT, may be followed by other <CR><LF>+CMGL:<index>...)
Command example Possible responses Note
AT+CMGL=“REC UNREAD” +CMGL: 1,”REC UNREAD”, List unread messages in
”0146290800”, text mode, 2 messages <CR><LF> are unread, these Unread message! messages will then have +CMGL: 3, their status changed to ”REC UNREAD”, “REC READ” (+CSDH:0) “46290800”, <CR><LF>
OK
AT+CMGL=”REC READ” +CMGL: 2,”REC READ”, List read messages in text
”0146290800”, mode <CR><LF>
OK
AT+CMGL=”STO SENT” OK List stored and sent
messages in text mode, result: no message found
AT+CMGL=1 +CMGL: 1,1,,26 <CR><LF> List read messages in
07913366003000F3040 PDU mode B913366920547F4 B913366920547F4 001300119041253040074 1AA8E5A9C5201
OK
656196-2220
Defined values: <stat> possible values (status of messages in memory):
Text mode PDU mode Status of messages possible values possible values in memory
“REC UNREAD” 0 received unread messages “REC READ” 1 received read messages “STO UNSENT” 2 stored unsent messages “STO SENT” 3 stored sent messages “ALL” 4 all messages
NOTE: For SMS Status Reports, only “ALL” / 4 and “READ” / 1 values of the <stat>
parameter will list messages ; other values will only return OK.
+CMGS – Send message
Description:
The <address> field is the address of the terminal to which the message is sent.To send the message, simply type, <ctrl-Z> character (ASCII 26). The text can contain all existing characters except <ctrl-Z> and <ESC> (ASCII 27).This command can be aborted using the <ESC> character when entering text. In PDU mode, only hexadecimal characters are used (‘0’...’9’,’A’...’F’).
Command syntax in text mode:
AT+CMGS= <da> [ ,<toda> ] <CR> text is entered <ctrl-Z / ESC >
Command syntax in PDU mode:
AT+CMGS= <length> <CR> PDU is entered <ctrl-Z / ESC >
Command example Possible responses Note
AT+CMGS=” Send a message in text
+33146290800”<CR> +CMGS: <mr> mode ,result:
<ctrl-Z> OK Please call me soon, Fred.
successful transmission
AT+CMGS= Send a message in PDU
<length><CR><pdu> +CMGS: <mr> mode, result:
<ctrl-Z> OK successful transmission The message reference, <mr>, which is returned to the application is allocated by the
product.This number begins with 0 and is incremented by one for each outgoing mes­sage (successful and failure cases); it is cyclic on one byte (0 follows 255).
NOTE: this number is not a storage number – outgoing messages are not stored.
66 6196-2220
+CMGW – Write Message to Memory
Description:
This command stores a message in memory (either SMS-SUBMIT or SMS-DELIVERS). The memory location <index> is returned (no choice possible as with phonebooks +CPBW).Text or PDU is entered as described for the Send Message +CMGS command.
Command syntax in text mode:
AT+CMGW= <oa/da> [,<tooa/toda> [,<stat> ] ] <CR> enter text <ctrl-Z / ESC>
Command syntax in PDU mode:
AT+CMGW= <length> [,<stat>] <CR> give PDU <ctrl-Z / ESC>
Response syntax:
+CMGW: <index> or +CMS ERROR: <err> if writing fails
Command example Possible responses Note
AT+CMGW= +CMGW: 4 Write a message in text
”+33146290800”<CR> mode, result:
Hello how are you? <ctrl-Z> OK Message stored in index 4 AT+CMGW=<length><CR> +CMGW: <index> Write a message in PDU
<pdu><ctrl-Z> OK mode, result:
message stored in <index>
Defined values: Parameter Definition: <oa/da>: Originating or Destination Address Value in string format. <tooa/toda>: Type of Originating / Destination Address. <stat>: Integer type in PDU mode (default 2 for +CMGW), or string type
in text mode (default “STO UNSENT” for +CMGW). Indicates the status of message in memory. If <stat> is omitted, the stored mes­sage is considered as a message to send.
<stat>
0: “REC UNREAD” 1: “REC READ” 2: “STO UNSENT” 3: “STO SENT” <length> Length of the actual data unit in octets.
676196-2220
+CMSS – Send Message From Storage
Description:
This command sends a message stored at location value <index>.
Command syntax:
AT+CMSS=<index>[,<da> [,<toda>] ]
Response syntax:
+CMSS: <mr> or +CMS ERROR: <err> if sending fails If a new recipient address <da> is given, it will be used instead of the one stored with the message
Command example Possible responses Note
AT+CMGW +CMGW: 5 Message stored with
=0660123456<CR> index 5
Today is my birthday OK AT+CMSS=5, 0680654321 CMSS:<mr> Send the message 5 to a
OK different destination
number
68 6196-2220
+CSMP – Set Text Mode Parameters
Description:
This command is used to select a value for <vp>, <pid>, and <dcs>.
Syntax:
AT+CSMP=<fo>, <vp>, <pid>,<dcs>
Command example Possible responses Note
AT+CSMP? +CSMP: 0,0,0,0 Current values, result no
OK validity period <dcs>=
PCCP437 alphabet (8 bits ‡ 7 bits)
AT+CMPS=17,23,64,244 OK <vp> = 23 (2 hours,
relative format), <dcs> = GSM 8 bits alphabet.
Defined values:
The <fo> byte comprises 6 different fields : b7 b6 b5 b4 b3 b2 b1 b0
RP UDHI SRR VPF RD MTI
RP: Reply Path, not used in text mode. UDHI: User Data Header Information, b6=1 if the beginning of
the User Data field contains a Header in addition to the short message. This option is not supported in +CSMP command, but can be used in PDU mode (+CMGS).
SRR: Status Report Request, b5=1 if a status report is
requested.This mode is supported.
VPF: Validity Period Format
b4=0 & b3=0 -> <vp> field is not present b4=1 & b3=0 -> <vp> field is present in relative format Others formats (absolute & enhanced) are not supported.
RD: Reject Duplicates, b2=1 to instruct the SC to reject an
SMS-SUBMIT for an SM still held in the SC which has the same <mr> and the same <da> as the previously submit­ted SM from the same <oa>.
MTI: Message Type Indicator
b1=0 & b0=0 -> SMS-DELIVER (in the direction SC to MS) b1=0 & b0=1 -> SMS-SUBMIT (in the direction MS to SC)
696196-2220
In text mode <vp> is only coded in “relative” format.The default value is 167 (24 hours).
This means that one octet can describe different values:
VP value Validity period value 0 to 143 (VP + 1) x 5 minutes (up to 12 hours) 144 to 167 12 hours + ( (VP – 143) x 30 minutes ) 168 to 196 (VP – 166) x 1 day 197 to 255 (VP – 192) x 1 week
<pid>
is used to indicate the higher layer protocol being used or indicates interworking with a certain type of telematic device. For example, 0x22 is for group 3 telefax, 0x24 is for voice telephone, 0x25 is for ERMES. <dcs> is used to determine the way the information is encoded. Compressed text is not supported. Only GSM default alphabet, 8 bit data and UCS2 alphabet are supported.
70 6196-2220
+CMGD – Delete message
Description:
This command is used to delete one or several messages from preferred message storage (“BM” SMS CB ‘RAM storage’,“SM” SMSPP storage ‘SIM storage’ or “SR” SMS Status-Report storage).
Syntax:
AT+CMGD=<Index> [,<DelFalg>]
Command example Possible responses Note
+CMTI:”SM”,3 New message received
AT+CMGR=3 +CMGR:“REC UNREAD”, Read the received
”0146290800”, message. Unread
“98/10/01,18 :19 :20+00” message received from
<CR><LF> 0146290800
on the 01/10/1998 at 18H19m 20s
AT+CMGD=3 OK Delete it, result:
Message deleted
AT+CMGD=1,0 OK The message from the
preferred message storage at the location 1 is deleted
AT+CMGD=1,1 OK All READ messages from
the preferred message storage are deleted
AT+CMGD=1,2 OK All READ messages and
SENT mobile originated messages are deleted
AT+CMGD=1,3 OK All READ, SENT and
UNSENT messages are deleted
AT+CMGD=1,4 OK All messages are deleted.
716196-2220
Defined values: <index>
1-20:When the preferred message storage is “BM”. Integer type values in the range of
location numbers of SIM Message memory when the preferred message storage is “SM” or “SR”.
<DelFlag>
0: Delete message at location <index>. 1: Delete All READ messages 2: Delete All READ and SENT messages 3: Delete All READ, SENT and UNSENT messages 4: Delete All messages.
NOTE: when the preferred message storage is “SR”, as SMS status reports are assumed
to have a “READ” status, if <DelFlag> is greater than 0, all SMS status reports will be deleted.
+CSCA – Service center address
Description:
This command is used to indicate which service center the message must be sent to.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 initialising the SMS. This address is then permanently valid.The application may change it if necessary.
Syntax:
AT+CSCA
Command example Possible responses Note
AT+CMGS= +CMS ERROR: 330 Send a message, result:
“+33146290800”<CR> service center
Hello, how are you?<ctrl-Z> unknown AT+CSCA=”0696741234” OK Service center
initialization
AT+CMGS= +CMGS: 1 Successful transmission.
”+33146290800”<CR>
Happy Birthday ! <ctrl-Z> OK
72 6196-2220
+CSCB – Select Cell Broadcast Message Types
Description:
This command selects which types of CBMs are to be received by the ME,This command is allowed in both PDU and text modes.
Syntax:
AT+CSCB= <mode>, [ <mids>, [ <dcss> ] ] The <bm> parameter of +CNMI command controls the message indication.
Test read command (AT+CSCB ?) is not supported.The activation of CBM reception (<mode>=0) can select only specific Message Identifiers (list in <mids>) for specific Languages (list in <dcss>), but the deactivation stops any reception of CBMs (only AT+CSCB=1 is allowed) Message Identifiers (<mids> parameter) indicates which type of message identifiers the ME should listen to.
Supported languages (<dcss> parameter) are:
0 for German, 1 for English, 2 for Italian, 3 for French, 4 for Spanish, 5 for Dutch, 6 for Swedish, 7 for Danish, 8 for Portuguese,
9 for Finnish, 10 for Norwegian, 11 for Greek, 12 for Turkish, 13 for Hungarian, 14 for Polish and 32 for Czech.
Command example Possible responses Note
AT+CSCB=0, OK Accept SMS-CB types,
”15-17,50,86”,”” 15,16,17,50 and 86 in any
language, CBMs can be received
AT+CBM: 10<CR><LF> CBM length of a received
00112233445566778899 Cell Broadcast message
(SMS-CB), CBM bytes in PDU mode.
AT+CSCB=1 OK Deactivate the reception
of CBMs CBM reception is completely stopped.
736196-2220
+WCBM – Cell Broadcast Message Identifiers
Description:
This command is used to read the EF-CBMI SIM file. Remark: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.
Syntax:
AT+WCBM= <mids>
Command example Possible responses Note
AT+WCBM= OK Write 4 messages
”10,100,1000,10000” identifiers in EF-CBMI,
CBMIs are stored in EF-CBMI
AT+WCBM? +WCBM=”10,100, Read the CBMIs in
1000,100000” EF-CBMI. 4 CBMIs are
stored in EF-CBMI
+WMSC – Message status modification
Syntax:
AT+WMSC= <loc>, <status>
Defined values: <loc>
location number of the stored message (integer)
<status> new status to be stored, as for +CMGL command:
PDU Mode Text Mode 0 “REC UNREAD”
1 “REC READ” 2 “STO UNSENT” 3 “STO SENT”
Possible responses:
OK if the location is valid +CMS ERROR: 321 if <loc> is invalid or free +CMS ERROR: 302 if the new <status> and the previous one are incompatible (1)
NOTE 1: The accepted status changes are from READ to NOT READ and vice versa,
and from SENT to NOT SENT and vice versa. If all the parameters are correct, the product overwrites the whole SMS in SIM. Only the first byte (Status byte) is changed..
74 6196-2220
+WMGO – Message overwriting
Description:
The +CMGW command writes an SMS to the first location available.To write an SMS to a specified location, the +WMGO command forces the product to write an SMS (with the +CMGW command) to the location specified with +WMGO, but for just one +CMGW command.
Syntax:
AT+WMGO= <loc>
Defined values: <loc>
location number of the SIM record to write or overwrite
Possible responses:
OK if <loc> is a valid SMS location, for AT+WMGO=?
and for AT+WMGO? +CMS ERROR: 321 if <loc> is out of the SIM capacity range. +WMGO: <loc> for AT+WMGO?
On the next AT+CMGW command, the record number used will be the one specified by the AT+WMGO command. The location is forgotten and, in order to perform a second overwrite, +WMGO has to be used again. If the external application specifies a free location, and if an incoming message is received before the AT+CMGW command, the product may store the incoming message at a location available.This could be the one specified by +WMGO (the product does not prevent from this). If the user then issues an AT+CMGW command without changing the AT+WMGO location, the new message will be overwritten!
NOTE: that this location number is not kept over a software reset.
+WUSS – Unchange SMS Status
Description:
The +WUSS command allows to keep the SMS Status to UNREAD after +CMGR or +CMGL.
Syntax:
AT+WUSS = <mode>
Defined values: <mode>
0: The SMS Status will not change. 1: The SMS Status will change.
Possible responses:
OK
756196-2220
Supplementary Ser vices commands
+CCFC – Call forwarding
Description:
This commands allows control of the "call forwarding" supplementary service.
Syntax:
AT+CCFC= <reason>, <mode> [, <number> [,<type> [,<class> [,<subaddr> [, <satype> [,<time> ] ] ] ] ] ]
Response syntax:
+CCFC: <status>, <class1> [, <number>, <type> [,<subaddr>, <satype> [,<time> ] ] ] [ <CR><LF>+CCFC: <status>, <class2> [, <number>, <type> [,<subaddr>, <satype> [,<time> ] ] ] [ ... ] ]
Command example Possible responses Note
AT+CCFC=0,3,”0146290800” OK Register to an
unconditional call forwarding
AT+CCFC=0,2 +CCFC:1,1, Interrogate unconditional
”0146290800”,129 call forwarding.
Call forwarding active for voice
<CR><LF>+CCFC:1,2, Call forwarding active for
”0146290802”,129 data
<CR><LF>+CCFC:1,4,
”0146290804”,129 Call forwarding active for
OK fax
AT+CCFC=0,4 OK Erase unconditional call
forwarding
NOTE: +CCFC responses are not sorted by <class> parameter, but only by the order
of network response.
Defined values: <reason>
0: Unconditional 1: Mobile busy 2: No reply 3: Not reachable 4: All call forwarding 5: All conditional call forwarding
76 6196-2220
<mode>
0: Disable 1: Enable 2: Interrogate 3: Registration 4: Erasure
<class>
1: Voice 2: Data 3: Fax 4: Short Messages 5: All classes
NOTE: The combination of different classes is not supported, it will only result in the
activation / deactivation / status request of all classes.
In the case where the FDN phonebook is activated, the registration is restricted to the phone numbers written in the FDN.
<subaddr> not managed <satype> not managed <time> For <reason> = 2 (No reply), 4 (all call forwarding) and 5
(all conditional call forwarding), time to wait (1 to 30) in seconds before call is forwarded. Default value is 20.
+CLCK – Call barring
Description:
This command allows control of the call barring supplementary service. Locking, unlock­ing or querying the status of call barring is possible for all classes or for a class.
Syntax:
AT+CLCK= <fac>, <mode> [, <password> [, <class> ] ] Response Syntax: (for <mode>=2 and command successful) +CLCK: <status> [, <class1> [ <CR><LF>+CLCK: <status>, <class2> [... ] ]
Command example Possible responses Note
AT+CLCK=”AO”,1,1234 OK Command valid AT+CLCK=”AO”,0,5555 +CME ERROR: 16 Wrong password AT+CLCK=”AO”,0,1234 OK Command valid
776196-2220
Defined values: <fac>
Barring for outgoing calls “AO” BAOC (Barr All Outgoing Calls) “OI” BOIC (Barr Outgoing International Calls) “OX” BOIC-exHC (Barr Outgoing International Calls except to
Home Country) Barring for incoming calls “AI” BAIC (Barr All Incoming Calls) “IR” BIC-Roam (Barr Incoming Calls when Roaming outside
the home country)
For all calls barring (<mode>=0 only) “AG” All outGoing barring services ”AC” All inComing barring services ”AB” All Barring services
<mode>
0: Unlocks the facility 1: Locks the facility 2: Query status
<class>
See description for +CCFC (Call forwarding).A combination of different classes is not supported. It will only result in the activation / deactivation / status request for all class­es.
The password code is over 4 digits maximum.
78 6196-2220
+CPWD – Modify SS password
Description:
This command is used by the application to change the supplementary service password.
Syntax:
AT+CPWD=<fac>,<OldPassword>, <NewPassword> for <fac> see +CLCK command with only “P2” facility added (SIM PIN2).
Command example Possible responses Note
AT+CPWD=”AO”,1234,5555 OK Change Call Barring
password, result: Password changed
AT+CPWD=”AO”,1234,5555 +CME ERROR: 16 Change password, result:
Wrong password
AT+CPWD=”AO”,5555,1234 OK Change password, result:
Password changed
Whatever the facility, the change of password applies to all call barring.
+CCWA – Call waiting
Description:
This command allows control of the call waiting supplementary service. The product will send a +CCWA unsolicited result code when the call waiting service is enabled.
Syntax:
AT+CCWA=<n>, [ <mode> [, <class> ] ]
Response Syntax: (for <mode>=2 and command successful) +CCWA: <status> [, <class1> [ <CR><LF>+CCWA: <status>, <class2>[ ... ] ]
Unsolicited result:
+CCWA: <number>, <type>, <class> [ ,<alpha>] (when waiting service is enabled)
796196-2220
Command example Possible responses Note
AT+CCWA=1,1,1 OK Enable call waiting for
voice calls
AT+CCWA=1,2 +CCWA:1,1 Interrogate call waiting,
OK result: Call waiting
active for voice calls.
+CCWA:”0146290800”, Number and name of the
145,1, ”FREDDY” waiting voice call or +CCWA:”0146290800”, (UCS2 format),
145,1, ”8023459678FFFF”
AT+CCWA=1,0,7 OK Erase call waiting voice
call waiting (no number)
+CCWA:,,1
Defined values: <n> Result code presentation status in the TA
0: Disable 1: Enable
<mode>
0: Disable 1: Enable 2: Query status.
<class>
1: Voice 2: Data 3: Fax Short 4: Messages 5: All classes
A combination of different classes is not supported. It will only result in the activation / deactivation / status request for all classes.
<alpha>
Optional string type alphanumeric representation of <number> corresponding to the entry found in the ADN or FDN phonebook.
80 6196-2220
+CLIR – Calling line identification restriction
Description:
This command allows control of the calling line identification restriction supplementary service.
Syntax:
AT+CLIR=<n>
Response Syntax:
+CLIR :<n>,<m> (for AT+CLIR ?)
Command example Possible responses Note
AT+CLIR=2 OK AT+CLIR ? +CLIR :<n>,<m> Ask for current
OK functionality, result: <n>
and <m> as defined here­below
Defined values: <n>
Sets the line ID restriction for outgoing calls 0: Presentation indicator is used according to the subscription of the CLIR service
1: CLIR invocation 2: CLIR suppression
<m>
Shows the subscriber CLIR status in the network 0: CLIR not provisioned
1: CLIR provisioned in permanent mode 2: Unknown (no network...) 3: CLIR temporary mode presentation restricted 4: CLIR temporary mode presentation allowed.80
816196-2220
+CLIP – Calling line identification presentation
Description:
This command allows control of the calling line identification presentation supplementary service. When presentation of the CLI (Calling Line Identification) is enabled (and calling subscriber allows), +CLIP response is returned after every RING (or +CRING) result code.
Syntax:
AT+CLIP=<n>
Response Syntax:
+CLIP: <n>,<m> for AT+CLIP? +CLIP: <number>, <type>[ ,<subaddr>, <satype>, <alpha> ] for an incoming call, after
each RING or +CRING indication
Command example Possible responses Note
AT+CLIP=1 OK Enable CLIP Note AT+CLIP? +CLIP:<n>,<m> Ask for current
OK functionality, <n>
and <m> defined as
below RING Incoming call +CLIP:“0146290800”,
129,1,,,”FRED” or
+CLIP:“0146290800”,129,1,,, Incoming call with
”8000204212FFFF” number and name
presentation
(UCS2 format)
AT+CLIP=0 OK Disable CLIP presentation
Defined values: <n>
parameter sets/shows the result code presentation in the TA 0: Disable
1: Enable
<m>
Parameter shows the subscriber CLIP service status in the network 0: CLIP not provisioned
1: CLIP provisioned 2: Unknown (no network...)
82 6196-2220
+COLP – Connected line identification presentation
Description:
This command allows control of the connected line identification presentation supplementary service – useful for call forwarding of the connected line.
Syntax:
AT+COLP=<n>
Response syntax:
+COLP: <n>,<m> for AT+COLP? +COLP: <number>,<type> [ ,<subaddr>, <satype>, <alpha> ] after ATD command,
before OK or CONNECT <speed>
Command example Possible responses Note
AT+COLP=1 OK Activate COLP AT+COLP? +COLP:1,1 Ask for current
OK functionality, COLP is
enabled and provisioned
ATD146290928; +COLP: or
”0146290928”,129,,,”JOE”
+COLP:“0146290800”,129,1,,, (UCS2 format)
”8000204212FFFF” Outgoing call,
OK connected outgoing line
number and name presentation
AT+COLP=0 OK Deactivate COLP
Defined values: <n>
Parameter sets/shows the result code presentation status in the TA 0: Disable 1: Enable
<m>
Parameter shows the subscriber COLP service status in the network 0: COLP not provisioned 1: COLP provisioned 2: Unknown (no network).
836196-2220
+CAOC – Advice of charge
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 <mode>=0, the command returns the current call meter value (CCM) from the ME. If AOC is supported, the command can also enable unsolicited event reporting on CCM information. The unsolicited result code +CCCM: <ccm> is sent when the CCM value changes. Deactivation of unsolicited event reporting is performed with the same command. If AOC is supported, the Read command indicates whether unsolicited reporting is activated or not.
Syntax:
AT+CAOC= <mode>
Command example Possible responses Note
AT+CAOC=0 +CAOC:“000A08” Query CCM value, result:
OK display Current
Call Meter value
(CCM=2568)
AT+CAOC=1 OK Deactivate unsolicited
report of CCM value
AT+CAOC=2 OK Activate unsolicited
report of CCM value
AT+CAOC ? +CAOC :<mode> Request mode result:
OK display unsolicited
report mode (1 or 2)
AT+CAOC=? +CAOC: (0-2) Request supported
OK modes, result: 0,1,2
modes supported
Defined values: <mode>
0: query CCM value 1: deactivate the unsolicited reporting of CCM value 2: activate the unsolicited reporting of CCM value
<ccm>
string type; three bytes of the current call meter value in hexadecimal format (e.g. “00001E” corresponds to the decimal value 30); value is in home units and bytes are coded in a similar way as the ACMmax value in SIM.
84 6196-2220
+CACM – Accumulated call meter
Description:
This command resets the Advice of Charge for accumulated call meter value in SIM file EFACM.The ACM contains the total number of home units for both the current and pre­ceding calls. SIM PIN2 is required to reset the value. If setting fails in an ME error, +CME ERROR: <err> is returned.The Read command returns the current value of the ACM.The ACM value (entered or displayed) is in hexadecimal format with 6 digits.
Syntax:
AT+CACM
Command example Possible responses Note
AT+CACM? +CACM:“000400” Request ACM value
OK result: Display ACM
value (ACM=1024)
AT+CACM= 1234 OK Request ACM reset, real
PIN2 is “1234”
AT+CACM= 0000 +CME ERROR: 16 Request ACM reset with
wrong PIN2 value
AT+CACM? +CACM:“000000” Request ACM value,
OK result: display ACM
value (ACM = 0)
856196-2220
+CAMM – Accumulated call meter maximum
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: <err> is returned.The Read command returns the current value of ACMmax. The ACMmax value (entered or displayed) is in hexadecimal format with 6 digits.
Syntax:
AT+CAMM
Command example Possible responses Note
AT+CAMM=”000400”,1234 OK Request ACMmax update,
PIN2 is “1234”,
result:ACMmax updated
to 1024
AT+CAMM=”000400”,0000 +CME ERROR: 16 Request ACMmax update,
PIN2 is “1234”, result:
Incorrect password
AT+CAMM ? +CAMM: “000400” Request ACMmax value,
result:ACMmax = 1024 OK
86 6196-2220
+CPUC – Price per unit and currency table
Description:
The set command sets the parameters for Advice of Charge related to price per unit and the currency table in SIM file EFPUCT. PUCT information can be used to convert the home units (as used in +CAOC, +CACM and +CAMM) into currency units. SIM PIN2 is required to set the parameters. If setting fails in an ME error, +CME ERROR: <err> is returned.
Syntax:
AT+CPUC
Command example Possible responses Note
AT+CPUC=”FFR”,”0.82”,1234 OK Request Currency and
Price per unit update
AT+CPUC=”FFR”,”0.82”,1111 + CME ERROR: 16 Request Currency and
PPU update (wrong PIN2), result: Incorrect password
AT+CPUC? +CPUC:”FFR”,”0.82” Currency= “FFR”,
OK Request Currency and
Price Price per unit= “0.82”
876196-2220
+CHLD – Call related supplementary services
Description:
This command is used to manage call hold and multiparty conversation (conference call). Calls can be put on hold, recovered, released or added to a conversation.
Syntax:
AT+CHLD= < n >
Response syntax:
+CHLD: (0-4, 11-17, 21-27) for AT+CHLD=?
Defined values: <n>
0: Release all held calls or set User Determined User Busy (UDUB) for a waiting
call. 1: Release all active calls (if any exist) and accepts the other (held or waiting) call. 1X: Release a specific call X (active, held or waiting) 2: Place all active calls (if any exist) on hold and accepts the other
(held or waiting) call. 2X: Place all active calls on hold except call X with which communication is
supported. 3: Adds a held call to the conversation. 4: Connects the two calls and disconnects the subscriber from both calls
(Explicit Call Transfer).
88 6196-2220
+CLCC – List current calls
Description:
This command is used to return a list of current calls.
Syntax:
AT+CLCC
Response syntax:
OK if no calls are available +CLCC: <id1>, <dir>, <stat>, <mode>, <mpty> [ ,<number>, <type>
[<alpha> ] ][ <CR><LF> +CLCC: <id2>, <dir>, <stat>, <mode>, <mpty> [ ,<number>, <type>
[<alpha> ] ] [...] ] ]
Defined values: <idx>
Integer type, call identification as described in GSM 02.30
<dir>
0: mobile originated (MO) call 1: mobile terminated (MT) call
<stat> (state of the call): 0: active
1: held 2: dialling (MO call) 3: alerting (MO call) 4: incoming (MT call) 5: waiting (MT call)
<mode>(teleservice): 0: voice
1: data 2: fax 9: unknown
<mpty>
0: call is not one of multiparty (conference) call parties 1: call is one of multiparty (conference) call parties
<number>: string type phone number in format specified by <type> <type>: type of address octet in integer format <alpha>: optional string type alphanumeric representation of <number>
corresponding to the entry found in phonebook. (for UCS2 format see commands examples +CLIP, +CCWA or +COLP)
896196-2220
+CSSN – Supplementary service notifications
Description:
This command refers to supplementary service related network initiated notifications. When <n>=1 and a supplementary service notification is received after a mobile origi­nated call setup, intermediate result code +CSSI:<code1>[,<index>] is sent before any other MO call setup result codes.When <m>=1 and a supplementary service notification is received during a call, unsolicited result code +CSSU:<code2>[,<index>[,<number>,<type>]] is sent.
Syntax:
AT+CSSN= <n>, <m>
Response syntax:
+CSSN: <n>, <m> for AT+CSSN? +CSSN: (0-1), (0-1) for AT+CSSN=?
Defined values: <n>
(parameter sets/shows the +CSSI result code presentation status): 0: disable
1: enable
<m>
(parameter sets/shows the +CSSU result code presentation status): 0: disable
1: enable
<code1>
4: closed User Group call, with CUG <index> 5: outgoing calls are barred 6: incoming calls are barred 7: CLIR suppression rejected
90 6196-2220
<code2>
1: closed User Group call, with CUG <index> 2: call has been put on hold (during a voice call, <number> & <type> fields
may be present)
3: call has been retrieved (during a voice call, <number> & <type> fields
may be present)
4: multiparty call entered (during a voice call, <number> & <type> fields
may be present) 5: call on hold has been released (during a voice call) 7: call is being connected (alerting) with the remote party in alerting state
in Explicit Call Transfer operation (during a voice call) 8: call has been connected with the other remote party in Explicit Call
Transfer operation (during a voice call,
<number> & <type> fields may be present) <index> Closed User Group index <number> String type phone number <type> Type of address
916196-2220
+CUSD – Unstructured supplementary service data
Description:
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.
This command is used to:
• enable or disable the CUSD indication sent to the application by the product when an incoming USSD is received
• send and receive USSD strings
Syntax:
AT+CUSD = <n> [ ,<str> [ <dcs> ] ]
Defined values: <n>
0: Disable the result code presentation 1: Enable the result code presentation 2: Cancel session (not applicable to read command response) In case of
enabled presentation, a +CUSD (as direct answer to a send USSD) is then indicated with: +CUSD: <m> [,<str>,<dcs> ]
<m>
0: no further user action required (network initiated USSD-Notify, or no
further information needed after mobile initiated operation)
1: further user action required (network initiated USSD-Request, or further
information needed after mobile initiated operation) 2: USSD terminated by network 4: Operation not supported <str> is network string, converted in the selected character set <dcs> is the data coding scheme received (GSM TS 03.38).
Syntax to send and receive USSD:
AT+CUSD= <n> [,<str> [,<dcs>]] NOTE: Please, be aware that the send USSD command needs the user to re-enter
the <n> parameter !
Defined values to send and receive USSD: <str> is the USSD string to be sent. <dcs> the default alphabet and the UCS2 alphabet are supported.
When the product sends a USSD, an OK response is first returned, the intermediate +CUSD indication comes subsequently. In case of error, a +CUSD: 4 indication is returned.
92 6196-2220
+CCUG – Closed user group
Description:
The Closed User Group Supplementary Service enables subscribers to form closed user groups with restricted access (both access to and from).The CUG supplementary serv­ice is described in GSM 02.85.This service is provided on prior arrangement with the service provider. Subscription options should be selected at implementation.
The +CCUG command is used to:
• activate/deactivate the control of CUG information for all following outgoing calls,
• select a CUG index,
• suppress outgoing access (OA). OA allows a member of a CUG to place calls outside the CUG,
• suppress the preferential CUG. Preferential is the default CUG used by the network when it does not receive an explicit CUG index.
Syntax:
AT+CCUG = <n> [ ,<index> [ <info> ] ]
Defined values: <n>
0: Disable CUG mode (default) 1: Enable CUG mode
<index>
0-9: CUG index (0 default), 10: Preferred CUG
<info>
0: No information (default) 1: Suppress OA 2: Suppress preferential CUG 3: Suppress OA and preferential CUG
To activate the control of the CUG information by call, add [G] or [g] to the ATD command. Index and info values will be used.
936196-2220
Data commands
+CBST – Bearer type selection
Description:
This command applies to both outgoing and incoming data calls, but in a different way. For an outgoing call, the two parameters (e.g. <speed> and <ce>) apply, whereas for an incoming call, only the <ce> parameter applies.
NOTE 1: For incoming calls, if <ce> is set to T only and the network offers NT only or
vice versa, then the call is released.
NOTE 2: The former values of 100 and 101 for <ce> are retained for compatibility pur-
poses but should no longer be used, values 2 and 3 should be used instead.
Syntax:
AT+CBST= <speed>, <name>, <ce>
Command example Possible responses Note
AT+CBST=? +CBST: Test command
(0-8,12,14,65,66,68, 70,71,75),(0),(0-3)
OK
AT+CBST=7,0,1 OK Ask for a bearer, result:
Bearer supported
AT+CBST? +CBST:7,0,1 Current values
OK
AT+CBST=81,0,0 +CME ERROR: 4 Ask for a bearer, result:
Bearer not supported
Defined values:
No data compression is provided and only asynchronous modem is supported (<name> = 0).
94 6196-2220
<speed>
0: (default) Autobauding (modem type: none) 1: 300 bps (modem type:V.21) 2: 1 200 bps (modem type:V.22) 3: 1 200/75 bps (modem type:V.23) 4: 2 400 bps (modem type:V.22bis) 5: 2 400 bps (modem type:V.26ter) 6: 4 800 bps (modem type:V.32) 7: 9 600 bps (modem type:V.32)
8: Specific 12: 9 600 bps (modem type:V.34) 14*: 14 400 bps (modem type:V.34) 65: 300 bps (modem type:V.110) 66: 1 200 bps (modem type:V.110) 68: 2 400 bps (modem type:V.110) 70: 4 800 bps (modem type:V.110) 71: 9 600 bps (modem type:V.110) 75*: 14 400 bps (modem type:V.110)
(*)This speed configures data and fax 14.4 kbps bearers.
<ce>
Connection element 0: Transparent only
1: (default) Non transparent only 2: Transparent preferred 3: Non transparent preferred
956196-2220
+FCLASS – Select mode
Description:
This command puts the product into a particular operating mode (data or fax).
Syntax:
AT+FCLASS= <n>
Command example Possible responses Note
AT+FCLASS=? +FCLASS: (0,1) Test command, result:
OK Fax class 2 not
supported
AT+FCLASS=? +FCLASS: (0,1,2) Test command, result:
OK Fax class 2 supported AT+FCLASS=0 OK Data mode requested AT+FCLASS=1 OK Fax class 1 mode requested AT+FCLASS? +FCLASS: 1 Current value
OK
Defined values: <n>
0: Data 1: Fax class 1 2: Fax class 2
96 6196-2220
+CR – Service reporting control
Description:
This command enables a more detailed type of service reporting in the case of incoming or outgoing data calls. Before sending the CONNECT response to the application, the product will specify the type of data connection that has been set up.
These report types are:
+CR:ASYNC For asynchronous transparent +CR: REL ASYNC For asynchronous non-transparent +CR: GPRS For GPRS (only when GPRS option)
Syntax:
AT+CR
Command example Possible responses Note
AT+CR=0 OK Extended reports disabled AT+CR=1 OK Extended reports enabled
976196-2220
+CRC – Cellular result codes
Description:
This command gives 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. +CRING: FAX for fax calls +CRING: GPRS GPRS network request for PDP context activation,
(only in GPRS option)
Syntax:
AT+CRC
Command example Possible responses Note
AT+CRC=0 OK Extended reports disabled AT+CRC=1 OK Extended reports enabled
+ILRR – DTE-DCE local rate reporting
Description:
This parameter controls whether or not the extended-format “+ILRR:<rate>” informa­tion text is transmitted from the DCE to the DTE.The <rate> reported represents the current (negotiated or renegotiated) DTE-DCE rate. If enabled, the intermediate result code is transmitted in an incoming or outgoing data call, after any data compression report, and before any final result code (CONNECT). <rate> can take the following val­ues: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200.
Syntax:
AT+ILRR
Command example Possible responses Note
AT+ILRR=0 OK Local port rate report
disabled
AT+ILRR=1 OK Local port rate report
enabled
98 6196-2220
+CRLP – Radio link protocol parameters
Description:
This command allows the radio link protocol parameters used for non transparent data transmission to be changed.
Syntax:
AT+CRLP=<iws>,<mws>,<T1>,<N2>, <ver>
Command example Possible responses Note
AT+CRLP=? +CRLP: (0-61),(0-61), Test command
(40-255),(1,255),(0,1)
OK AT+CRLP=61,61,48,6,0 OK Set new parameters AT+CRLP? AT+CRLP: 61,61,48,6,0 Current values
Defined values:
This command accepts 5 parameters.
<iws> 0-61: Down window size, (default is 61), <mws> 0-61: Up window size, (default is 61), <T1> 40-255: Acknowledgement timer in units of 10ms, (default is 48) <N2> 1-255: Retransmission attempts, (default is 6), <ver> 0-1:Version number. If V42bis is supported the version
is 1, If V42bis is not supported the version is 0
996196-2220
+DOPT – Others radio link parameters
Description:
This command allows some supplementary radio link protocol parameters to be changed.
Syntax:
AT+DOPT=<reset_allowed>,<dtx_allowed>
Command example Possible responses Note
AT+DOPT=1 OK Set new parameters AT+DOPT=? (0,1),(0,1) Test command, result:
DTX is supported
OK AT+DOPT=1,1 OK Set new parameters AT+DOPT? 1,1 Current values
OK
Defined values: <reset_allowed>
0: Data communication is hung up in case of bad radio link. 1: (default) Data communication continues in case of bad radio link (possi-
ble loss of data) < dtx_allowed > 0: Normal mode
1: (default) Economic battery mode
(not supported by all networks).
100 6196-2220
%C – Select data compression
Description:
This command enables or disables data compression negotiation if this feature is sup­ported on the product.
Syntax:
AT%C<n>
Command example Possible responses Note
AT%C0 OK Feature supported AT%C2 OK V.42bis supported AT%C? 2 Current value
OK
Defined values: <n>
0: (default) no compression 2: V.42bis compression if supported.
Loading...