Version: 04.00
Date: May 29, 2002
Doc Id: TC3X_ATC_01_V04.00
Status: Released
General note
With respect to any damages arising in connection with the described product or this document,
Siemens shall be liable according to the General Conditions on which the delivery of the described
product and this document are based.
This product is not intended for use in life support appliances, devices or systems where a malfunction
of the product can reasonably be expected to result in personal injury. Siemens AG customers using
or selling this product for use in such applications do so at their own risk and agree to fully indemnify
Siemens for any damages resulting from illegal use or resale.
Applications incorporating the described product must be designed to be in accordance with the
technical specifications provided in these guidelines. Failure to comply with any of the required
procedures can result in malfunctions or serious discrepancies in results.
Furthermore, all safety instructions regarding the use of mobile technical systems, including GSM
products, which also apply to cellular phones must be followed.
Handheld applications such as mobile phones or PDAs incorporating the described product must be in
accordance with the guidelines for human exposure to radio frequency energy. The Specific
Absorption Rate (SAR) of the application must be evaluated and approved to be compliant with
national and international safety standards or directives.
Subject to change without notice at any time.
Copyright
Copying of this document and giving it to others and the use or communication of the contents thereof,
are forbidden without express authority. Offenders are liable to the payment of damages. All rights
reserved in the event of grant of a patent or the registration of a utility model or design.
7.1.12 SIEMENS release cause for L3 Advice of Charge (AOC) (AT+CEER) ...............................192
7.1.13 GSM Release cause for Supplementary Service call (AT+CEER).......................................192
7.1.14 SIEMENS release cause for Call-related Supplementary Services (CRSS) (AT+CEER)...193
7.2 Summary of PIN requiring AT Commands............................................................................194
7.3 AT commands available before entering the SIM PIN..........................................................196
7.4 Standard GSM service codes ...............................................................................................198
7.4.1 Additional notes on ^SCCFC, ^SCCWA, ^SCLCK ...............................................................200
7.5 GSM and UCS2 alphabet tables...........................................................................................202
TC3X_ATC_01_V04.00 Page 6 of 204 29.05.2002
AT Command Set
0 Version History
This chapter reports modifications and improvements over previous versions of the document.
"AT Command Set" Version TC3x-ATC-01-V03.10=> TC3x5-ATC-01-04.00
Chapter Page AT command What is new
1.5 13 Character sets Chapter revised and associated character set tables
in Chapter 7.5 updated.
1.6 14 Flow control How to use flow control.
1.4.2 12 Any command Maximum length of command line buffer added. Note
regarding on sequential order of concatenated
commands added.
2.3 16 AT\Qn Further details added: Using RTS/CTS handshake.
Restoring AT\Q settings.
2.21 28 ATS2 Command description added.
4.2 58f AT+CALA Statement regarding the URC +CALA <text> revised:
If autobauding is active neither the URC +CALA nor
the individual <text> will appear.
4.6 and
4.6.1
4.18
4.18.3
4.24.1 87 AT+CMUX Fax specific AT commands are not usable.
4.31.1 99 AT+CPIN Timing algorithm of incorrect password corrected
4.42 114 AT+CSQ Note added: Realistic BER values can be obtained
4.5 63 AT+CBST Command syntax corrected: Parameter <speed> is
4.21 83 AT+CLVL Further notes regarding the usage of AT+CLVL and
4.23 85 AT+CMUT Further notes regarding the usage of AT+MUT and
4.39 111 AT+CRSM Chapter revised.
5.4
5.2
5.10 134 AT+CNMI Note regarding AT^SSCONF added.
5.7 130 AT+CMGW Parameter <length> corrected (only required for PDU,
64f
65
75
79
122
121
AT+CCFC New <class> parameters added.
Further examples added.
AT+CLCK New <class> parameters added.
Under parameter “PS” lock, the following statement
has been removed: “ME may remember numbers of
previously used cards.”
Further examples for call barring added.
AT\Q3 (hardware flow control) is recommended.
Minimum bit rate set with AT+IPR: 4.8 kbps
only if there is a call in progress.
mandatory.
AT^SNFV added.
AT^SNFM added.
AT+CMGL
AT+CMGR
Note regarding AT^SSCONF added.
Note regarding the handling of Class 0 short
messages added.
not for text mode).
Result code after failure of storing a message to the
SIM card (ME returns OK).
Statement about sending e-mails via SMS corrected:
If not recognized by provider, @ may be replaced with
“*”.
TC3X_ATC_01_V04.00 Page 7 of 204 29.05.2002
AT Command Set
6.2 144ff AT^MONI Examples on page 144 updated.
<chann> and <rs> explained in greater detail
References for 3GPP TS 05.05 and 05.08 added
Frequency hopping will now be indicated with “h”
(instead of the previously used “0”.
Notes modified: If during a connection the radio cell is
changed, the parameters PWR and RXLev of the
‘Serving Cell’ part will not be updated.
Statement regarding RING line revised.
Statement regarding different values of identical cell
monitoring parameters (used for AT^MONI,
AT^MONP and AT^SMONC) added.
6.3 146 At^MONP <chann> and <rs> explained in greater detail
Notes modified: During a connection new neighbour
cells can be added, but their parameters C1 and C2
will be updated after the call.
5.15 141 AT+CSMP Command syntax corrected, first parameter
mandatory
6.5 148 AT^SBC Default setting of <current> described
Automatic shutdown explained in more detail
6.7 152 AT^SCKS URC not stored when ME is powered down
6.19 162 AT^M20 Description revised
7.1.5- 7.1.14 181 - 193 Several AT+CEER location Ids and release causes added
7.1.3 185 URCs Further explanations relating to URCs
7.2 / 7.3 194/196 Usability of AT commands with or without PIN authentication: Both lists
updated
TC3X_ATC_01_V04.00 Page 9 of 204 29.05.2002
AT Command Set
1 Introduction
1.1 Scope of the document
This document presents the AT Command Set for the Siemens cellular engines
TC35 Module
TC37 Module
TC35 Terminal
The AT commands detailed in this document are generally supported by all products. Where
differences occur, they are noted in the chapter that refers to the command. In the present version, the
only exceptions concern the following commands:
Table 1: Product specific use of AT commands
AT command TC35 / TC37 Modules TC35 Terminal
AT+CALA, Chapter 4.2 Alarm mode and reminder call fully
applicable
AT^SSYNC, Chapter 6.39 SYNC pin may be assigned
different functions: <mode> 0 or 1.
AT^SBC, Chapter 6.5 All functions fully applicable
Does not support Alarm mode.
Please ignore any information
relating to the subject.
The reminder call can be used as
described.
SYNC pin supports only <mode>=1
(LED status).
Command not applicable.
1.2 Supported product versions and related documents
Please note that TC35, TC37 Modules and TC35 Terminal are using the same firmware, referred to as
TC35. The present AT Command Set applies to all products based on the TC35 software version
04.00.
Related documents
[1] TC35 / TC37 Hardware Interface Description (applies to TC35 and TC37)
[2] TC3x Release Notes related to TC35 software version 04.00 (applies to TC35, TC37 and TC35T)
[3] TC3x Multiplexer User's Guide (applies to TC35, TC37 and TC35T)
[4] Application Note 16: Updating TC35 Firmware (applies to TC35, TC37 and TC35T)
[5] TC35 Terminal Hardware Interface Description (applies to TC35T)
[6] TC35 MC35 Terminal User's Guide (applies to TC35T and MC35T)
[7] Application Note 02: Audio Interface (applies to TC35, TC37 and TC35T)
Prior to using TC35 /TC37 or TC35T or upgrading to a new firmware release, be sure to carefully read
the latest product information provided in the Release Notes.
To visit the Siemens Website you can use the following link:
http://www.siemens.com/wm
TC3X_ATC_01_V04.00 Page 10 of 204 29.05.2002
AT Command Set
1.3 Conventions
Throughout the document, the GSM engines are referred to as ME (Mobile Equipment), MS (Mobile
Station), TA (Terminal Adapter), DCE (Data Communication Equipment) or facsimile DCE (FAX
modem, FAX board). When the Siemens product names are required to distinguish the two models,
TC3x is short for the engine type and TC35T for the terminal.
To control your GSM engine you can simply send AT Commands via its serial interface. The
controlling device at the other end of the serial line is referred to as TE (Terminal Equipment), DTE
(Data Terminal Equipment) or plainly ´the application´ (probably running on an embedded system).
1.4 AT command syntax
The "AT" or "at" prefix must be set at the beginning of each command line. To terminate a command
line enter <CR>.
Commands are usually followed by a response that includes “<CR><LF><response><CR><LF>”.
Throughout this document, only the responses are presented, <CR><LF> are omitted intentionally.
Table 2: Types of AT commands and responses
Test command AT+CXXX=? The mobile equipment returns the list of parameters and
value ranges set with the corresponding Write command
or by internal processes.
Read command AT+CXXX? This command returns the currently set value of the
parameter or parameters
Write command AT+CXXX=<...> This command sets user-definable parameter values.
Execution command AT+CXXX The execution command reads non-variable parameters
affected by internal processes in the GSM engine.
1.4.1 Using parameters
· Default parameters are underlined throughout this document.
· Optional parameters are enclosed in square brackets. If optional parameters are omitted, the
current settings are used until you change them.
· Optional parameters or subparamters can be omitted unless they are followed by other
parameters. If you want to omit a parameter in the middle of a string it must be replaced by a
comma. Example:
AT+CPBW=,<number>,<type>,<text> writes a phonebook entry to the first free memory location.
AT+CPBW=<index>,<number>,<type>,<text> writes a phonebook entry to the memory location
specified by <index>.
· When the parameter is a character string, e.g. <text> or <number>, the string must be enclosed in
quotation marks, e.g. "Charlie Brown" or "+49030xxxx". Symbols within quotation marks will be
recognized as strings.
· All spaces will be ignored when using strings without quotaton marks.
· It is possible to omit the leading zeros of strings which represent numbers.
· In case of using V.25ter commands without giving an optional parameter, its value is assumed to
be 0.
TC3X_ATC_01_V04.00 Page 11 of 204 29.05.2002
AT Command Set
1.4.2 Combining AT commands on the same command line
You may enter several AT commands on the same line. This eliminates the need to type the "AT" or
"at" prefix before each command. Instead, it is only needed once at the beginning of the command
line. Use a semicolon as command delimiter.
The command line buffer accepts a maximum of 391 characters. If this number is exceeded none of
the commands will be executed and TA returns ERROR.
The table below lists the AT commands you cannot enter together with other commands on the same
line. Otherwise, the responses may not be in the expected order.
Table 3: Illegal combinations of AT commands
V.25ter commands With
GSM 7.07 commands With
FAX commands, Prefix AT+F
Siemens commands, Prefix AT^S
GSM 7.05 commands (SMS) --- To be used standalone
Commands starting with AT& --- To be used standalone
AT+IPR --- To be used standalone
Note: Generally, appending the same or mixed AT commands should be avoided. If nevertheless
you need to do enter several commands on the same line, note that the number of subsequent
commands is limited.
1.4.3 Entering successive AT commands on separate lines
When you enter a series of AT commands on separate lines, leave a pause between the preceding
and the following command until OK appears. This avoids sending too many AT commands at a time
without waiting for a response for each.
TC3X_ATC_01_V04.00 Page 12 of 204 29.05.2002
AT Command Set
1.5 Supported character sets
The ME supports two character sets: GSM 03.38 (7 bit, also referred to as SMS alphabet) and UCS2
(16 bit, refer to ISO/IEC 10646). See Chapter 4.40 for information about selecting the character set.
Character tables are provided in Chapter 7.5.
Due to the constraints described below it is recommended to prefer the USC2 alphabet in any external
application.
If the GSM alphabet is selected all characters sent over the serial line are in the range from 0 ... 127.
CAUTION: GSM alphabet is not ASCII alphabet!
Several problems resulting from the use of the GSM alphabet:
1. "@" character with GSM alphabet value 0 is not printable by an ASCII terminal program (e.g.
Microsoft
2. "@" character with GSM alphabet value of binary 0 will terminate any C string!
This is because the \0 is defined as C string end tag. Therefore, the GSM Null character may
cause problems on application level when using a ´C´-function as „strlen()“. This can be avoided if
it is represented by an escape sequence as shown in Table 4.
By the way, this may be the reason why even network providers often replace "@"with “@=*” in
their SIM application.
When sending e-mails via SMS the @ character may also be replaced with “*” as defined in GSM
03.40 (3GPP TS 23.040).
3. Other characters of the GSM alphabet are misinterpreted by an ASCII terminal program. For
example, GSM "ö" (as in "Börse") is assumed to be "|" in ASCII, thus resulting in "B|rse". This is
because both alphabets mean different characters with values hex. 7C or 00 and so on.
4. In addition, decimal 17 and 19 which are used as XON/XOFF control characters when software
flow control is activated, are interpreted as normal characters in the GSM alphabet.
When you write characters differently coded in ASCII and GSM (e.g. Ä, Ö, Ü), you need to enter
escape sequences. Such a character is translated into the corresponding GSM character value and,
when output later, the GSM character value can be presented. Any ASCII terminal then will show
wrong responses.
CAUTION: Often, the editors of terminal programs do not recognize escape sequences. In this case,
an escape sequence will be handled as normal characters. The most common workaround to this
problem is to write a script which includes a decimal code instead of an escape sequence. This way
you can write, for example, short messages which may contain differently coded characters.
TC3X_ATC_01_V04.00 Page 13 of 204 29.05.2002
AT Command Set
1.6 Flow control
Flow control is essential to prevent loss of data or avoid errors when, in a data or fax call, the sending
device is transferring data faster than the receiving side is ready to accept. When the receiving buffer
reaches its capacity, the receiving device should be capable to cause the sending device to pause
until it catches up.
There are basically two approaches to regulate data flow: software flow control and hardware flow
control. The High Watermark of the input / output buffer should be set to approximately 60% of the
total buffer size. The Low Watermark is recommended to be about 30%. The data flow should be
stopped when the capacity rises close to the High Watermark and resumed when it drops below the
Low Watermark. The time required to cause stop and go results in a hysteresis between the High and
Low Watermarks.
In Multiplex mode, it is recommended to use hardware flow control. For details please refer to [3].
1.6.1 Software flow control (XON/OFF flow control)
Software flow control sends different characters to stop (XOFF, decimal 19) and resume (XON,
decimal 17) data flow. The only advantage of software flow control is that three wires would be
sufficient on the serial interface.
1.6.2 Hardware flow control (RTS/CTS flow control)
Hardware flow control sets or resets the RTS/CTS wires. This approach is faster and more reliable,
and therefore, the better choice. When the High Watermark is reached, CTS is set inactive until the
transfer from the buffer has completed. When the Low Watermark is passed, CTS goes active once
again.
To achieve smooth data flow, ensure that the RTS/CTS lines are present on your application platform.
The application should include options to enable RTS/CTS handshake with the GSM engine. This
needs to be done with the AT command AT\Q3 - it is not sufficient to set RTS/CTS handshake in the
used Terminal program only.
The default setting of the GSM engine is AT\Q0 (no flow control) which must be altered to AT\Q3
(RTS/CTS hardware handshake on). The setting is stored volatile and must be restored each time
after the GSM engine was switched off. For further details refer to Chapter 2.3.
AT\Q has no read command. To verify the current setting of AT\Q, simply check the settings of the
active profile with AT&V.
Often, fax programs run an intialization procedure when started up. The intialization commonly
includes enabling RTS/CTS hardware handshake, eliminating the need to set AT\Q3 once again.
However, before setting up a CSD call, you are advised to check that RTS/CTS handshake is set.
Note: After deactivating the RTS line, the ME may still send up to 32 bytes. This can be easily
handled if the buffer of the host application is sufficiently sized, and if a hysteresis is
implemented in its Rx buffer as mentioned in Chapter 1.6. A total buffer capacity of 256 bytes
has been proved to work well.
TC3X_ATC_01_V04.00 Page 14 of 204 29.05.2002
AT Command Set
2 Standard V.25ter AT Commands
These AT Commands are related to ITU-T (International Telecommunication Union,
Telecommunication sector) V.25ter document.
TC35, TC37 and TC35T support the registers S0-S29. You can change
S0,S3,S4,S5,S6,S7,S8,S10,S18 by using the appropriate ATSn commands. All the other registers are
read-only and for internal usage only!
2.1 A/ Repeat previous command line
Execute command
Response
A/
Repeats previous command line. Line does not need to end with terminating
character.
Parameter
Reference
V.25ter
Note
· After beginning with the character “a“ or „A“, a second character “t“ ,”T“ or “/“
has to follow. In case of using a wrong second character, it is necessary to
start again with character “a“ or “A“.
· If autobauding is active (see +IPR, pg. 40) A/ (and a/) cannot be used.
2.2 +++ Switch from data mode to command mode
Execute command
+++
Reference
V.25ter
Response
This command is only available during data calls. The +++ character sequence
causes the TA to cancel the data flow over the AT interface and switch to
command mode. This allows you to enter AT commands while maintaining the
data connection to the remote device.
OK
To prevent the +++ escape sequence from being misinterpreted as data, it must
be preceded and followed by a pause of at least 1000 ms. The +++ characters
must be entered in quick succession, all within 1000 ms.
Note:
· To return from on-line command mode to on-line data mode: Enter ATO as
described in Chapter 2.17.
TC3X_ATC_01_V04.00 Page 15 of 204 29.05.2002
AT Command Set
2.3 AT\Qn Flowcontrol
Execute command
AT\Q<n>
Reference
Response
OK
Parameter
<n> 0 AT\Q0 No flow control 1 AT\Q1 XON/XOFF software flow control
2 AT\Q2 Only CTS by DCE
3 AT\Q3 RTS/CTS hardware flow control
Note
Line state refers to RS-232 levels.
The setting of AT\Q is stored volatile and must be restored each time after the
GSM engine was switched off. Also, there is no way to store AT\Q to the user
defined profile.
See also Chapter 1.6 for general information on flow control.
Required for the following procedures: incoming
or outgoing data calls, fax calls.
Often, the initialization routine of Fax programs
includes enabling RTS/CTS handshake,
eliminating the need to issue AT\Q3 once again.
2.4 ATA Answer a call
Execute command
ATA
Reference
V.25ter
TA causes remote station to go off-hook (e.g. answer call).
Note1: Any additional commands on the same command line are ignored.
Note2:This command may be aborted generally by receiving a character during
execution. It can´t be aborted in some connection setup states, such as
handshaking.
Response
Response in case of data call, if successfully connected:
CONNECT<text> TA switches to data mode.
Note:<text> output only if +ATX parameter setting with value > 0.
Response in case of voice call, if successfully connected:
OK
When TA returns to command mode after call release:
OK
Response if no connection:
NO CARRIER
Parameter
Note
See also AT+ATX and chapter 7.1.4 for <text>
TC3X_ATC_01_V04.00 Page 16 of 204 29.05.2002
AT Command Set
2.5 ATD Mobile originated call to dial a number
Execute command
ATD[<n>]
[<mgsm][;]
Reference
V.25ter/GSM
07.07
This command can be used to set up outgoing voice, data or fax calls. It also
serves to control supplementary services.
Note:
The command may be aborted generally when receiving an ATH command during
execution. It can´t be aborted in some connection setup states, such as
handshaking. Two different call setup options can be determined for voice calls:
TA returns OK either after dialing was completed or after call has been
established. The setting is made with AT^SM20 (see Chapter 6.19). In data
connections, call setup always terminates when the call has been established.
Response
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If a connection cannot be set up:
NO CARRIER
If successfully connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
Parameter
<n> String of dialling digits and optionally V.25ter modifiers (dialling digits):
0-9, * , #, +, A, B, C
V.25ter modifiers: these are ignored: ,(comma), T, P, !, W, @
Emergency call:
<n> = 112 worldwide number (no SIM needed)
<mgsm> String of GSM modifiers:
I Activates CLIR (disables presentation of own phone number to called
party)
i Deactivates CLIR (enables presentation of own phone number to
called party)
<;>Only required to set up voice calls. TA remains in command mode.
Note
· Before setting up a data call, check that RTS/CTS handshake is enabled. See
Chapters 1.6 and 2.3.
· Parameter “l“ and “i“ only if no *#-code is within the dial string.
· <mgsm> is not supported for data calls.
· <n> is default for last number that can be dialled by ATDL.
· See also +ATX and chapter 7.1.4 for <text>.
· The *# codes can only be used with voice calls (i.e. use ´; ´) only.
· If ATD is used with a USSD command (e.g. ATD*100#;) an AT+CUSD=1 is
executed implicitly. (see AT+CUSD, pg. 116).
TC3X_ATC_01_V04.00 Page 17 of 204 29.05.2002
AT Command Set
2.6 ATD><mem><n> Originate call to phone number <n> in memory <mem>
This command allows you to dial a phone number from a specific phonebook. To initiate a call, enter
a two letter abbreviation for the phonebook <mem>, followed by the memory location <n> of the
desired entry. The location range of each phonebook can be queried by AT+CPBR (see Chapter
4.28).
Execute command
ATD><mem>
<n>[<mgsm>][;]
Parameter
TA attempts to set up an outgoing call to the specified number.
Note: This command may be aborted generally by receiving a character during
execution. Abortion is not possible during some states of connection
setup such as handshaking.
Response
If error is related to ME functionality:
+CME ERROR: <err>
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If connection cannot be set up:
NO CARRIER
If successfully connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
<mem> phonebook:
"SM” SIM phonebook (storage depending on SIM card)
”FD” SIM fixdialling phonebook (pos. 1-7)
”LD” SIM last-dialling-phonebook (usually the last 10 numbers
dialed are stored on the SIM card, no matter whether or not the
calls were successfully set up)
”MC” ME missed (unanswered received) calls list (up to 10 numbers)
”RC” SIM received calls list
”ME” ME Phonebook (up to 50 numbers)
”ON” SIM (or ME) own numbers (MSISDNs) list
Note: <mem> must be included in quotation marks (""), if parameter
<mgsm> is used. If not, quotation marks are optional.
<n> Integer type memory location in the range of locations available in
the selected memory, i.e. the index number returned by AT+CPBR.
<mgsm>I Activates CLIR (disables presentation of own phone number to
called party)
TC3X_ATC_01_V04.00 Page 18 of 204 29.05.2002
AT Command Set
i Deactivates CLIR (enables presentation of own phone number
<;>Only required to set up voice calls. TA remains in command mode.
Reference
V.25ter/GSM
07.07
Example
Note
· There is no <mem> for emergency call (“EN”).
· Command is not supported for data call!
· Parameter <mgsm> only if no *# code is within the dial string.
· The *# codes can only be used with voice calls (i.e.if “;” is appended).
· See also ATX and chapter 7.1.4 for <text>.
To query the location number of the phonebook entry:
AT+CPBR=1,xx
TA returns the entries available in the active phonebook.
To dial a number from the SIM phonebook, for example the number stored to
location 15:
ATD>SM15;
OK
To dial a phone number stored in the last dial memory on the SIM card:
ATD>LD9;
OK
to called party)
TC3X_ATC_01_V04.00 Page 19 of 204 29.05.2002
AT Command Set
2.7 ATD><n> Originate call to phone number selected from active memory
This command can be used to dial a phone number selected from the active memory. The active
memory is the phonebook selected with AT+CPBS (see Chapter 4.29). To set up a call simply enter
the memory location of the desired entry. The memory location range of each phonebook can be
queried by AT+CPBR (see Chapter 4.28).
Execute command
ATD><n>[<mgsm>][;]
Reference
V.25ter/GSM 07.07
TA attempts to set up an outgoing call to the stored number.
Note: This command may be aborted generally by receiving a character
during execution. It can´t be aborted in some connection setup states,
such as handshaking.
Response
If error is related to ME functionality:
+CME ERROR: <err>
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If a connection cannot be set up:
NO CARRIER
If successfully connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
Parameter
<n>integer type memory location should be in the range of locations
available in the memory used, i.e. the index number returned by
AT+CPBR.
<mgsm> I Activates CLIR (disables presentation of own phone number to
called party)
i Deactivates CLIR (enables presentation of own phone number
to called party)
<;>Only required to set up voice calls. TA remains in command mode.
Note
· Parameter <mgsm> only if no *# code is within the dial string.
· Command is not supported for data call!
· The *# codes can only be used with voice calls (i.e.if “;” is appended).
· See also +ATX and chapter 7.1.4 for <text>.
TC3X_ATC_01_V04.00 Page 20 of 204 29.05.2002
AT Command Set
2.8 ATD><str> Originate call to phone number in memory with
corresponding field
This command searches the active phonebook for a given string <str> and dials the assigned phone
number. The active phonebook is the one set with AT+CPBS.
Execute command
ATD><str>[mgsm][;]
Reference
V.25ter/GSM 07.07
TA attempts to set up an outgoing call to stored number
Note: This command may be aborted generally by receiving a character
during execution. It can´t be aborted in some connection setup states,
such as handshaking.
Response
If error is related to ME functionality:
+CME ERROR: <err>
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If a connection cannot be set up:
NO CARRIER
If successfully connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
Parameter
<str>string type value (“x”), which should equal an alphanumeric field in
at least one phonebook entry in the searched memories; used
character set should be the one selected with Select TE Character
Set +CSCS. <str> can contain escape sequences as described in
chapter „“, pg. 11.
<str> must be wrapped in quotation marks (""), if escape sequences
or parameter <mgsm> are used or if the alphanumeric strings
contains a blank. If not, quotation marks are optional.
<mgsm> I Activates CLIR (disables presentation of own phone number to
called party)
i Deactivates CLIR (enables presentation of own phone number to
called party)
<;>Only required to set up voice calls. TA remains in command mode.
Note
Command is not supported for data calls! See also ATX and Chapter 7.1.4 for
<text>
TC3X_ATC_01_V04.00 Page 21 of 204 29.05.2002
AT Command Set
2.9 ATDI Mobile originated call to dialable ISDN number <n>
Execute command
ATDI<n>[;]
Parameter
Reference
V.25ter
TA attempts to set up an outgoing call to ISDN number.
Note:This command may be aborted generally by receiving a character during
execution. This command cannot be aborted in some connection setup
states, such as handshaking.
Response
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If a connection cannot be set up:
NO CARRIER
If successful connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
<n> [+]<d> phone number
string with maximum length of 20 characters
+ international dialling format
<d> ISDN number
string of digits: +,0-9, A, B, C
<;> voice call
TC3X_ATC_01_V04.00 Page 22 of 204 29.05.2002
AT Command Set
2.10 ATDL Redial last telephone number used
Execute command
ATDL[;]
Reference
V.25ter
This command redials the last voice and data call number used in the ATD
command.
· To redial the last data call number simply enter ATDL
· To redial the last voice call number type ATDL;
Note: The command may be aborted generally by receiving a character during
execution. This command cannot be aborted in some connection setup
states, such as handshaking.
Response
If there is no last number or number is not valid:
+CME ERROR
If no dialtone (parameter setting ATX2 or ATX4):
NO DIALTONE
If busy (parameter setting ATX3 or ATX4):
BUSY
If a connection cannot be set up:
NO CARRIER
If successfully connected and non-voice call:
CONNECT<text> TA switches to data state.
Note: <text> output only if +ATX parameter setting with value > 0.
When TA returns to command mode after call release:
OK
If successfully connected and voice call:
OK
Parameter
<;> voice call
Note
In case of voice calls “;” is necessary.
TC3X_ATC_01_V04.00 Page 23 of 204 29.05.2002
AT Command Set
2.11 ATE Enable command echo
Write command
ATE[<value>]
Reference
V.25ter
This setting determines whether or not the TA echoes characters received from
TE during command state.
Response
OK
Parameter
<value> 0 Echo mode off
1 Echo mode on
Note
In case of using the command without parameter, <value> is set to 0.
2.12 ATH Disconnect existing connection
Execute command
ATH[n]
Reference
V.25ter
Disconnects any call in progress, such as voice calls, fax or CSD data calls.
Response
OK
Note:
OK is issued after circuit 109 (DCD) is turned off (RS-232 level), if it was
previously on.
Parameter
<n> 0 terminate call
Note
Using ATH in Multiplex mode (AT+CMUX)
· ATH terminates every data call, even if it is issued via logical channels 2 or 3.
· This behaviour is in accordance with ITU-T V.25 ter; (07/97, see „6.3.6 Hook
control“: "ATH is terminating any call in progress.")
TC3X_ATC_01_V04.00 Page 24 of 204 29.05.2002
AT Command Set
2.13 ATI Display product identification information
Execute command
ATI
Reference
V.25ter
Response
ME issues product information text
SIEMENS
REVISION TC35 x.yy
xx.yy
OK
Explanation of „Revision“ parameter: Version xx and variant yy of software
release.
Note
2.14 ATI[value] Display additional identification information
Execute command
ATI[value]
Reference
V.25ter
Response
Delivers no specific information and simply returns OK.
Note
TC3X_ATC_01_V04.00 Page 25 of 204 29.05.2002
AT Command Set
2.15 ATL Set monitor speaker loudness
Execute command
ATL[val]
Reference
V.25ter
Response
OK
Note
· The two commands ATL and ATM are implemented only for V.25ter
compatibility reasons and have no effect.
· In multiplex mode the command is supported on logical channel 1 only.
2.16 ATM Set monitor speaker mode
Execute command
ATM[val]
Reference
V.25ter
Response
OK
Note
· The two commands ATL and ATM are implemented only for V.25ter
compatibility reasons and have no effect.
· In multiplex mode the command is supported on logical channel 1 only.
2.17 ATO Switch from command mode to data mode
Execute command
ATO[n]
Reference
V.25ter
Response
ATO is the corresponding command to the +++ escape sequence described in
Chapter 2.2: When you have established a data call and TA is in command mode,
ATO causes the TA to resume the data connection and return to data mode.
If connection is not successfully resumed
NO CARRIER
or
TA returns to data mode from command mode CONNECT <text>
Note: <text> output only if +ATX parameter setting with value > 0.
Parameter
<n>0 switch from command mode to data mode
Note
TC3X_ATC_01_V04.00 Page 26 of 204 29.05.2002
AT Command Set
2.18 ATQ Set result code presentation mode
Write command
ATQ[<n>]
Reference
V.25ter
Response
Specifies whether or not the TA transmits any result code to the TE. Information
text transmitted in response is not affected by this setting.
If <n>=0:
OK
If <n>=1:
(none)
Parameter
<n> 0 DCE transmits result code
1 Result codes are suppressed and not transmitted
Note
2.19 ATP Select pulse dialling
Execute command
ATP
Reference
V.25ter
Response
OK
Note
No effect for GSM
2.20 ATS0 Set number of rings before automatically answering the call
Read command
ATS0?
Write command
ATS0=<n>
Reference
V.25ter
Response
<n> OK
Specifies whether or not the TA will accept an incoming data / fax call without
user intervention. <n> determines the number of rings to wait before the TA will
automatically answer.
Response
OK
Parameter
<n> 000 disables automatic answer mode 001-255 enables automatic answering after specified number of rings
Note
· Auto-answer mode is only applicable to data or fax calls.
· If <n> is set too high, the calling party may hang up before the call can be
automatically answered.
· The correlation between ATS7 and ATS0 is important.
Example: Call setup may fail if ATS0=20 and ATS7=30.
TC3X_ATC_01_V04.00 Page 27 of 204 29.05.2002
AT Command Set
2.21 ATS2 Escape code sequence
Read command
ATS2?
Response
S2 determines the decimal value of the ASCII character used in the escape code
sequence, which serves, during a data call, to change from data to command
mode. Compare Chapter 2.2.
The default value 043 is equivalent to an ASCII “+”. Please note that the value
cannot be changed, and therefore, test or write commands are not supported.
Reference
V.25ter
Note
2.22 ATS3 Write command line termination character
Read command
ATS3?
Write command
ATS3=<n>
Parameter
Reference
V.25ter
Response
<n> OK
This parameter setting determines the character recognized by TA to terminate
an incoming command line.
Response
OK
<n> 000-013-127 command line termination character
Note
2.23 ATS4 Set response formatting character
Read command
ATS4?
Write command
ATS4=<n>
Parameter
Reference
V.25ter
TC3X_ATC_01_V04.00 Page 28 of 204 29.05.2002
Response
<n> OK
This parameter setting determines the character generated by the TA for result
code and information text.
Response
OK
<n> 000-010-127 response formatting character.
Note
AT Command Set
2.24 ATS5 Write command line editing character
Read command
ATS5?
Write command
ATS5=<n>
Parameter
Reference
V.25ter
Response
<n> OK
This parameter setting determines the character recognized by TA as a request
to delete the immediately preceding character from the command line.
Response
OK
<n> 000-008-127 command line editing character
Note
2.25 ATS6 Set pause before blind dialling
Read command
ATS6?
Write command
ATS6=<n>
Parameter
Reference
V.25ter
Response
<n> OK
No effect for GSM
Response
OK
<n> 000-255 number of seconds to wait before blind dialling.
Note
TC3X_ATC_01_V04.00 Page 29 of 204 29.05.2002
AT Command Set
2.26 ATS7 Set number of seconds to wait for connection completion
Read command
ATS7?
Write command
ATS7=<n>
Parameter
Reference
V.25ter
Response
<n> OK
Specifies the number of seconds the TA will wait for the completion of the call
setup when answering or originating a data call. Also referred to as "no answer
timeout". To put it plainly, this is the time to wait for the carrier signal. If no carrier
signal is received within the specified time, the TA hangs up.
Response
OK
<n>0 <n>000 – 060 no. of seconds to wait for connection completion.
Note
· Values greater than 60 cause no error, but <n> will be restored to the
maximum value of 60.
· If called party has specified a high value for ATS0=<n>, call setup may fail.
· The correlation between ATS7 and ATS0 is important.
Example: Call setup may fail if ATS7=30 and ATS0=20.
· ATS7 is only applicable to data calls.
2.27 ATS8 Set number of seconds to wait for comma dial modifier
Read command
ATS8?
Write command
ATS8=<n>
Reference
V.25ter
Response
<n> OK
No effect for GSM
Response
OK
Note
TC3X_ATC_01_V04.00 Page 30 of 204 29.05.2002
AT Command Set
2.28 ATS10 Set disconnect delay after indicating the absence of data carrier
Read command
ATS10?
Write command
ATS10=<n>
Parameter
Reference
V.25ter
Response
<n> OK
This parameter setting determines the amount of time, that the TA remains
connected in absence of a data carrier. If the data carrier is detected before
disconnect, the TA remains connected.
Response
OK
<n> 001-002-254 number of tenths of seconds of delay
Note
2.29 ATS18 Extended error report
Test command
ATS18?
Execute command
ATS18=<n>
Reference
Siemens
Response
<n> OK
TA returns an extended report of the reason for the last call release and location.
<n> 0 – 255, odd numbers set extended error report and even
numbers disable this feature.
Response
+Cause: <location ID>: <reason > OK
Parameter
<location ID> Location ID as number code (see subclause 7.1.5).
<reason> Reason for last call release as number code (see subclause
7.1.5).
Note
This command works for data calls only. For voice calls please use AT+CEER.
2.30 ATT Select tone dialling
Execute command
ATT
Reference
V.25ter
Response
OK
Note
No effect for GSM
TC3X_ATC_01_V04.00 Page 31 of 204 29.05.2002
AT Command Set
2.31 ATV Set result code format mode
Write command
ATV[<value>]
Reference
V.25ter
Response
This parameter setting determines the contents of the header and trailer
transmitted with result codes and information responses.
When <value> =0
0
When <value> =1
OK
Parameter
<value>
0 Information response: <text><CR><LF>
Short result code format: <numeric code><CR>
1Information response:<CR><LF><text><CR><LF> Long result code format: <CR><LF><verbose code><CR><LF>
Note
In case of using the command without parameter <value> will be set to 0.
Information responses described in chapter 7 (verbose code and numeric code).
2.32 ATX Set CONNECT result code format and call monitoring
Write command
ATX[<value>]
Reference
V.25ter
Response
This parameter setting determines whether or not the TA detects the presence of
dial tone and busy signal and whether or not TA transmits particular result codes.
OK
Parameter
<value>
0 CONNECT result code only returned, dial tone and busy
detection are both disabled
1 CONNECT<text> result code only returned, dial tone and busy
detection are both disabled
2 CONNECT<text> result code returned, dial tone detection is
enabled, busy detection is disabled
3 CONNECT<text> result code returned, dial tone detection is
disabled, busy detection is enabled
4 CONNECT<text> result code returned, dial tone and busy
detection are both enabled
Note
Related <text> see chapter 7.1.4.
TC3X_ATC_01_V04.00 Page 32 of 204 29.05.2002
AT Command Set
2.33 ATZ Set all current parameters to user defined profile
Execute command
ATZ[<value>]
Reference
V.25ter
Response
TA sets all current parameters to the user profile stored with AT&W (see Chapter
2.39 on page 37). If a connection is in progress, it will be terminated. The user
defined profile is stored to the non-volatile memory.
Note: If invalid, the user profile will be reset to the factory default profile. Any
additional commands on the same command line will be ignored. A delay of
300 ms is required before next command is sent, otherwise “OK” response may
be corrupted.
OK
Parameter
<value> 0 Reset to user profile
Note
The GSM engines referred to in this manual can be assigned two profiles: the
factory profile (restored with AT&F) and the user profile (stored with AT&W). See
Chapter 2.36 for details on AT&F.
2.34 AT&C Set circuit Data Carrier Detect (DCD) function mode
Write command
AT&C[<value>]
Reference
V.25ter
Response
This parameter determines how the state of circuit 109(DCD) relates to the
detection of received line signal from the distant end.
OK
Parameter
<value> 0 DCD line is always ON.
1 DCD line is ON in the presence of data carrier only.
Note
Line state refers to RS-232 levels.
TC3X_ATC_01_V04.00 Page 33 of 204 29.05.2002
AT Command Set
2.35 AT&D Set circuit Data Terminal Ready (DTR) function mode
Write command
AT&D[<value>]
Reference
V.25ter
Response
This command is only intended for data calls. The <value> parameter determines
how the TA responds when circuit 108/2 (DTR) is changed from ON to OFF
during data mode.
OK
Parameter
<value> 0 TA ignores status on DTR.
1 ON->OFF on DTR: Change to command mode while retaining
the connected call.
2 ON->OFF on DTR: Disconnect data call, change to command
mode. During state DTR = OFF is auto-answer off.
Note
Line state refers to RS-232 levels.
2.36 AT&F Set all current parameters to manufacturer defaults
Execute command
AT&F[value]
Reference
V.25ter
Response
TA sets all current parameters to the manufacturer defined profile.
OK
Parameter
<value>0 set all TA parameters to manufacturer default
Note
· List of parameters reset to manufacturer default (sorted by the associated AT
commands):
E, Q, V, X, +CBST, +CRLP, +CRC, +CR, +CNMI, +CMEE, +CSMS, ^SCKS,
^SACM, +CREG, +CLIP, the S Parameters, &D, &C, &S
· In addition to the default profile, you can store an individual one with AT&W. To
alternate between the two profiles enter either ATZ (loads user profile) or AT&F
(restores factory profile). Refer to Chapter 2.39 for AT&W and Chapter 2.33 for
ATZ.
TC3X_ATC_01_V04.00 Page 34 of 204 29.05.2002
AT Command Set
2.37 AT&S Set circuit Data Set Ready (DSR) function mode
Write command
AT&S<value>
Parameter
Reference
V.25ter
Response
This parameter determines how the TA sets circuit 107 (DSR) depending on the
communication state of the TA interfacing TE.
OK
<value> 0 DSR always on.
1 TA in command mode: DSR is OFF.
TA in data mode: DSR is ON.
Note
Line state refers to RS-232 levels.
TC3X_ATC_01_V04.00 Page 35 of 204 29.05.2002
AT Command Set
2.38 AT&V Display current configuration
Execute command
AT&V[<n>]
without Multiplex
mode or
configuration on
channel 1 if
Multiplex mode
is enabled
Logical channels
2 and 3
(Multiplex mode
enabled)
Reference
Response
TA returns the current parameter setting. The configuration varies depending on
whether or not PIN authentication has been done, or Multiplex mode has been
activated.
Parameter
<n>0 profile number
PIN entered (see AT+CPIN, pg. 95) PIN not entered Configuration
2.39 AT&W Store current configuration to user defined profile
Execute command
AT&W[<n>]
Reference
V.25ter
TA stores the current settings to a user defined profile in the non-volatile memory.
Response
OK or if error is related to ME functionality: ERROR / +CME ERROR: <err>
Parameter
<n>0 number of profile
Note
The user defined profile will be loaded automatically after PowerUp. Use ATZ to
restore user profile and AT&F to restore factory settings. Until the first use of
AT&W, ATZ works as AT&F. See Chapter 2.33 for details on ATZ and Chapter
· List of settings stored to profile on multiplexer channels 2 and 3:
ATE, ATQ, ATV, ATX, AT+CRC, AT+CMGF, AT+CSDH, AT+CNMI, AT+ILRR,
AT+CMEE, AT^SMGO, AT+CSMS, AT^SACM, ^SCKS, AT+CREG, AT+CLIP,
AT+COPS. (Parameters for data call are not relevant on channels 2 and 3.)
TC3X_ATC_01_V04.00 Page 37 of 204 29.05.2002
AT Command Set
2.40 AT+GCAP Request complete TA capabilities list
Test command
AT+GCAP=?
Execute command
AT+GCAP
Reference
V.25ter
Response
OK
Parameter
Response
TA reports a list of additional capabilities.
+GCAP: <name>
OK
Parameter
<name> e.g.: +CGSM,+FCLASS
Note
+CGSM: The response text shows which GSM commands of the ETSI standard
are supported.
2.41 AT+GMI Request manufacturer identification
Test command
AT+GMI=?
Execute command
AT+GMI
Reference
V.25ter
Response
OK
Response
TA reports information to identify the manufacturer.
SIEMENS
OK
Note
See also ”AT+CGMI Request manufacturer identification”.
2.42 AT+GMM Request TA model identification
Test command
AT+GMM=?
Execute command
AT+GMM
Reference
V.25ter
Response
OK
TA reports one or more lines of information text which permit the user to identify
the specific model of device.
TC35
OK
Note
See also ”AT+CGMM Request model identification”.
TC3X_ATC_01_V04.00 Page 38 of 204 29.05.2002
AT Command Set
2.43 AT+GMR Request TA revision identification of software status
Test command
AT+GMR=?
Execute command
AT+GMR
Reference
V.25ter
Response
OK
Response
TA returns product software version identification text.
REVISION x.yy
OK
x.yy Version x and variant yy of software release.
Note
See also AT+CGMR Request revision identification of software status
2.44 AT+GSN Request TA serial number identification(IMEI)
Test command
AT+GSN=?
Execute command
AT+GSN
Parameter
Reference
V.25ter
Response
OK
Response
TA reports one or more lines of information text which permit the user to identify
the individual device.
<sn>
OK
<sn> IMEI of the telephone(International Mobile station Equipment Identity)
Note
The serial number (IMEI) varies for every individual ME device.
TC3X_ATC_01_V04.00 Page 39 of 204 29.05.2002
AT Command Set
2.45 AT+ILRR Set TE-TA local rate reporting
Test command
AT+ILRR=?
Read command
AT+ILRR?
Write command
AT+ILRR=
<value>
Intermediate result code
Reference
V.25ter
Example
Response
+ILRR: (list of supported <value>s) OK
Parameter
See write command
Response
+ILRR: <value> OK
Parameter
See write command
The write command specifies whether or not an intermediate result code shall
indicate the currently used local rate when an incoming or outgoing data call is
established. The message is transmitted from the DCE (= TA) to the DTE (=TE)
before the final result code of the connection setup (e.g. CONNECT) appears.
Response
OK
Parameter
<value> 0 Disables reporting of local port rate1 Enables reporting of local port rate
+ILLR:<rate>
Parameter
<rate> port rate setting in bit per second
0 (Autobauding, see Chapter 2.46.1)
300
600
1200
2400
4800
9600
14400
19200
28800
38400
57600
115200
Note
ATD030112233445
+ILRR: 57600
CONNECT 9600/RLP
TC3X_ATC_01_V04.00 Page 40 of 204 29.05.2002
AT Command Set
2.46 AT+IPR Set fixed local rate
Test command
AT+IPR=?
Read command
AT+IPR?
Write command
AT+IPR=<rate>
Reference
V.25ter
Response
+IPR: (list of supported auto-detectable <rate>s), (list of supported fixed-only
<rate>s) OK
Parameter
See write command
Response
+IPR: <rate> OK
Parameter
See write command
This command specifies the DTE-DCE bitrate. When you set a fix rate, make sure
that both DTE (TE) and DCE (= TA) are configured to the same rate. When you
select autobauding the DCE will automatically recognize the bitrate currently used
by the DTE.
A selected bitrate takes effect following the issue of any result code associated
with this command (e.g. OK).
The setting is stored in the non-volatile memory and will be used whenever the
engine is powered up again. However, in case of autobaud mode (+IPR=0) the
detected DCE bitrate will not be saved and, therefore, needs to be be resynchronized after restarting the GSM engine (see Chapter 2.46.1).
Response
OK or if error is related to ME functionality: ERROR / +CME ERROR: <err>
Parameter
<rate> bit rate per second
0 (Autobauding, see Chapter 2.46.1)
· when you download new firmware (i.e. a firmware update does not restore the
factory setting);
· in the event of power failure.
Generally, AT +IPR=x should be used as a standalone command. If nevertheless
combinations with other commands on the same line cannot be avoided, there are
several constraints to be considered:
· Avoid combinations with the AT commands listed in Chapter 1.4.2.
TC3X_ATC_01_V04.00 Page 41 of 204 29.05.2002
AT Command Set
· Take into account that a delay of 100 ms is required between a response to the
last command (e.g. OK) and the next command on the same line.
· When you enter AT+IPR=0, autobauding will be activated after the response to
the last command is received.
· When local echo is active (ATE1) and you enter AT+IPR=x with other
commands you may encounter the following problem: If switching to the new
bit rate takes effect while a response is being transmitted, the last bytes may
be sent at the new bit rate and thus, not properly transmitted. The following
commands will be correctly sent at the new bit rate.
2.46.1 Autobauding
Autobauding allows the GSM engine to automatically detect the bitrate configured in the host
application. The serial interface of the GSM engine supports autobauding for the following bitrates:
1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200. Factory setting is autobauding enabled. This
gives you the flexibility to put the GSM engine into operation no matter what bitrate your host
application is configured to.
To take advantage of autobaud mode specific attention must be paid to the following requirements:
Synchronization between DTE and DCE
Ensure that DTE and DCE are correctly synchronized and the bitrate used by the DTE is detected by
the DCE (= ME). To allow the bitrate to be synchronized simply issue an "AT" or "at" string. This is
necessary
· after you have activated autobauding
· when you start up the GSM engine while autobauding is enabled. It is recommended to wait 3 to 5
seconds before sending the first AT character. Otherwise undefined characters might be returned.
If you want to use autobauding and autoanswer at the same time, you can easily enable the
synchronization, when you activate autobauding first and then configure the autoanswer mode
(ATS0=0).
Restrictions on autobauding operation
· The serial interface has to be operated at 8 data bits, no parity and 1 stop bit (factory setting).
· The A/ command (and a/) cannot be used.
· Only the strings „AT“ or „at“ can be detected (neither „aT“ nor „At“).
· The Unsolicited Result Codes "^SYSSTART", "^SYSSTART ALARM MODE" and "^SYSSTART
CHARGE-ONLY MODE" are not indicated when you start up the ME while autobauding is enabled.
This is due to the fact that the new bitrate is not detected unless DTE and DCE are correctly
synchronized as described above.
· Any other Unsolicited Result Codes that may be issued before the ME detects the new bitrate (by
receiving the first AT command string) will be sent at the previous bitrate.
· It is not recommended to switch to autobauding from a bitrate that cannot be detected by the
autobaud mechnism (e.g. 300 baud). Responses to +IPR=0 and any commands on the same line
might be corrupted.
· When entering several AT commands on the same line, consider the requirements described in the
Notes of Chapter 2.46.
· See also AT+ILRR Set TE-TA local rate reporting , pg. 39
Autobauding and multiplex mode
If autobauding is active you cannot switch to multiplex mode (see +CMUX, pg. 86). Vice versa, when
you run the multiplex mode, the write command AT+IPR=<rate> cannot be used.
TC3X_ATC_01_V04.00 Page 42 of 204 29.05.2002
AT Command Set
3 AT Commands for FAX
The following commands can be used for FAX transmission.
If the ME is acting as a Fax-Modem to a PC-based application (e.g. „WinFax“) it is necessary to select
the proper Service Class (Fax Class) provided by the ME. The ME reports its Service Class
capabilities, both the current setting and the range of services available. This is provided by the
AT+FCLASS command (see pg. 45).
Note: When sending a FAX with a standard FAX application for Personal Computers it is
recommended to use Autobauding (AT+IPR=0).
Currently defined Service Class values (see TIA/EIA-592-A)
ME +FCLASS parameter Service Class Reference, Standard
C
C
0 data modem
1 Service Class 1 EIA/TIA-578-A
1.0 Service Class 1 ITU-T T.31
C
2 manufacture specific this document and EIA PN-2388 (draft)
2.0 Service Class 2 TIA/EIA-592
2.1 Service Class 2 TIA/EIA-592-A or ITU-T T.32
8 Voice DCE TIA IS-101
Reserved
Note: Be aware that there is a difference between Service Classes 2 and 2.0! Only the first is
applicable to the ME.
e.g. TIA/EIA-602 or ITU V.25ter
3.1 AT+FBADLIN Bad Line Threshold
Read command
AT+FBADLIN?
Write command
AT+FBADLIN=
<badlin>
Reference
EIA PN-2388
This command defines the “Copy-Quality-OK”-threshold. If <badline>
consecutive lines have pixel count errors in normal resolution (98 dpi) mode,
then the copy quality is unacceptable. If <badline> * 2 consecutive lines have
pixel count errors in fine resolution (196 dpi) mode, then the copy quality is
unacceptable. “Copy Quality Not OK” occurs if either the error percentage is too
high or too many consecutive lines contain errors. A value of 0 implies that error
checking is not present or disabled.
Response
<badlin> OK
Parameter
See write command
Response
OK
If error is related to ME functionality:
ERROR
Parameter
<badlin>0 – 10 – 255 bad lines
Note
Used for Fax class 2 only
TC3X_ATC_01_V04.00 Page 43 of 204 29.05.2002
AT Command Set
3.2 AT+FBADMUL Error Threshold Multiplier
Read command
AT+FBADMUL?
Write command
AT+FBADMUL=
<n>
Reference
EIA PN-2388
This command defines the “Copy-Quality-OK” multiplier. The number of lines
received with a bad pixel count is multiplied by this number. If the result
exceeds the total number of lines on the page the error rate is considered too
high. A threshold multiplier value of 20 corresponds to a 5% error rate. A value
of 0 implies that error checking is not present or disabled.
Response
<badmul> OK
Parameter
See write command
Response
OK
If error is related to ME functionality:
ERROR
Parameter
<n>0 – 20 – 255
Note
Used for Faxclass 2 only
3.3 AT+FBOR Query data bit order
Test command
AT+FBOR=?
Read command
AT+FBOR?
Write command
AT+FBOR=<bor>
Reference
EIA PN-2388
Query the bit order for receive-mode. The mode is set by the ME dependent on
the selected Service Class, see “AT+FCLASS Fax: Select, read or test service
class”, pg. 45.
Response
(list of supported bit order modes <bor>s)
OK
Parameter
See write command
Response
<bor> OK
Parameter
See write command
Response
OK
Parameter
<bor>0 direct bit order for both Phase C and for Phase B/D data.
1 Reversed bit order for Phase C data, direct Bit Order for
Phase B/D data.
Note
Used for Fax class 2 only
TC3X_ATC_01_V04.00 Page 44 of 204 29.05.2002
AT Command Set
3.4 AT+FCIG Query or set the Local polling id
Test command
AT+FCIG =?
Read command
AT+FCIG?
Write command
AT+FCIG =<id>
Reference
EIA PN-2388
Response
(max. length of Local Polling ID string) (range of supported ASCII character
values) OK
Parameter
See write command
Response
<id> OK
Parameter
See write command
Response
OK
Parameter
<id>Local Polling ID string, max. length and possible content as reported
by test command. Default value is empty string (“”).
Note
See also “AT+FLID Query or set the Local Id setting capabilities”, pg. 51.
Used for Faxclass 2 only
3.5 AT+FCLASS Fax: Select, read or test service class
Test command
AT+FCLASS=?
Read command
AT+FCLASS?
Write command
AT+FCLASS=
<n>
Reference
EIA/TIA-592-A
See introduction to fax commands, pg. 43.
Response
(list of supported <n>s) OK
Parameter
See write command
Response
<n> OK
Parameter
See write command
The ME is set to a particular mode of operation (data, fax). This causes the MA
to process information in a manner suitable for that type of information.
Response
OK
Parameter
<n> 0 data (e.g. EIA/TIA-602 or ITU V.25ter)
1 Fax class 1 (EIA/TIA-578-A, Service Class 1)
2 Fax class 2 (EIA/TIA SP-2388, an early draft version of
EIA/TIA-592-A – Service class 2.1)
Note
Using Error Correcting Mode (ECM) when sending FAXes over GSM should be
avoided.
TC3X_ATC_01_V04.00 Page 45 of 204 29.05.2002
AT Command Set
3.6 AT+FCQ Copy Quality Checking
Test command
AT+FCQ =?
Read command
AT+FCQ?
Write command
AT+FCQ =<cq>
Reference
EIA PN-2388
This command controls Copy Quality checking when receiving a fax.
Response
(list of supported copy quality checking <cq>s)
OK
Parameter
See write command
Response
<cq> OK
Parameter
See write command
Response
OK
Parameter
<cq>0 No copy quality checking. The ME will generate Copy
Quality OK (MCF) responses to complete pages.
1 ME can check 1-D phase data. The connected application
must check copy quality for 2-D phase C data
Note
Used for for Faxclass 2 only.
3.7 AT+FCR Capability to receive
Write command
AT+FCR=<cr>
Reference
EIA PN-2388
Response
OK
Parameter
<cr> 0 ME will not receive message data. This can be used when
the application has insufficient storage. The ME can send
and can be polled for a file.
This command allows the connected application to sense and constrain the
capabilities of the facsimile DCE (=ME), from the choices defined in CCITT
T.30 Table 2.
Response
(list of <VR>s), (list of <BR>s), (list of <WD>s), (list of <LN>s), (list of <DF>s),
(list of <EC>s), (list of <BF>s), (list of <ST>s)
OK
Parameter
VR: Vertical Resolution, BR: Bit Rate, WD: Page Width, LN: Page Length, DF:
Data Compression Format, EC: Error Correction Mode, BF: Binary File
Transfer Mode, ST: Scan Time/Line.
Note: For further information see AT+FDIS, pg. 49
Response
<dcc> OK
Parameter
See write command
Response
OK
Parameter
VR: Vertical Resolution, BR: Bit Rate, WD: Page Width, LN: Page Length, DF:
Data Compression Format, EC: Error Correction Mode, BF: Binary File
Transfer Mode, ST: Scan Time/Line.
Note: For further information see AT+FDIS, pg. 49
Note
Used for Faxclass 2 only
TC3X_ATC_01_V04.00 Page 47 of 204 29.05.2002
AT Command Set
3.9 AT+FDFFC Data Compression Format Conversion
Test command
AT+FDFFC=?
Read command
AT+FDFFC?
Write command
AT+FDFFC =<df>
Reference
EIA PN-2388
This parameter determines the ME response to a mismatch between the data
format negotiated for the facsimile session, reported by the +FDCS:DF
subparameter, and the Phase C data desired by the controlling application,
indicated by the optional +FDT:DF subparameter, or the +FDIS=DF
subparameter for the +FDR operation.
Response
(list of supported <df>s) OK
Parameter
See write command
Response
<df> OK
Parameter
See write command
Response
OK
Parameter
<df> 0 Mismatch checking is always disabled. The controlling
application has to check the +FDCS: DF subparameter and
transfer matching data.
This command allows the controlling application to sense and constrain the
capabilities used for the current session. It uses +FDIS to generate DIS or
DTC messages directly, and uses +FDIS and received DIS messages to
generate DCS messages.
Response
(list of <VR>s), (list of <BR>s), (list of <WD>s), (list of <LN>s), (list of <DF>s),
(list of <EC>s), (list of <BF>s), (list of <ST>s)
Scan Time/Line ST 0 *) 0 ms (at VR= normal)
1 5 ms
2 10 ms
3 10 ms
4 20 ms
5 20 ms
6 40 ms
7 40 ms
*) Note: Only the default value needs to be implemented. Use test command
to check which parameter values are really possible!
Note
Used for Faxclass 2 only
TC3X_ATC_01_V04.00 Page 49 of 204 29.05.2002
AT Command Set
3.11 AT+FDR Begin or continue phase C data reception
Execute command
AT+FDR
Reference
EIA PN-2388
The +FDR command initiates transition to Phase C data reception.
Response
CONNECT
or
OK
If error is related to ME functionality:
ERROR
Note
Used for Faxclass 2 only
3.12 AT+FDT Data Transmission
Execute command
AT+FDT
Write command
AT+FDT =<dt>
Reference
EIA PN-2388
This command requests the ME to transmit a Phase C page. When the ME is
ready to accept Phase C data, it issues the negotiation responses and the
CONNECT result code to the application.
In Phase B, the +FDT command releases the ME to proceed with negotiation,
and releases the DCS message to the remote station. In Phase C, the +FDT
command resumes transmission after the end of a data stream transmited
before.
Response
CONNECT
Response
CONNECT
Parameter
<dt>DF,VR,BR,WD,LN comma separated parameter list
Data Compression Format DF 0 1-D modified Huffman
1 2-D modified read
2 2-D uncompressed mode
This command indicates that the current page or partial page is complete. An
ERROR response code results if this command is issued while the mode is onhook.
Response
OK
Parameter
<ppm> Post Page Message Codes
1 another document next
2 no more pages or documents
4 another page, procedure interrupt
5 another document, procedure interrupt
Note
Used for Faxclass 2 only
3.14 AT+FK Kill operation, orderly FAX abort
Execute command
AT+FK
Reference
This command causes the TA to terminate the session in an orderly manner.
Response
OK
Note
Used for Faxclass 2 only
3.15 AT+FLID Query or set the Local Id setting capabilities
Test command
AT+FLID =?
Read command
AT+FLID?
Write command
AT+FLID =<lid>
Reference
EIA PN-2388
Response
(max. character length of Local ID string) (range of supported ASCII character
values) OK
Parameter
See write command
Response
< lid > OK
Parameter
See write command
Response
OK
Parameter
<lid> Local ID string, max. length and possible content as reported by test
command. Default value is empty string (“”).
Note
See also “AT+FCIG Query or set the Local polling id ”, pg. 44.
Used for Faxclass 2 only
TC3X_ATC_01_V04.00 Page 51 of 204 29.05.2002
AT Command Set
3.16 AT+FMDL Identify Product Model
Read command
AT+FMDL?
Reference
Siemens
Send the model identification to the TA
Response
Gipsy Soft Protocolstack
OK
Note
Used for Faxclass 2 only
3.17 AT+FMFR Request Manufacturer Identification
Read command
AT+FMFR?
Reference
Siemens
Send the manufacturer identification to the TA
Response
SIEMENS
OK
Note
Used for Fax class 2 only
3.18 AT+FOPT Set bit order independently
Write command
AT+FOPT=<opt>
Reference
Siemens
Model specific command to set bit order independently of the understanding
which is "mirrored" and which is direct.
Response
OK
Parameter
<opt> 0 non-standard
1 standard
Note
Used for Fax class 2 only
TC3X_ATC_01_V04.00 Page 52 of 204 29.05.2002
AT Command Set
3.19 AT+FPHCTO DTE Phase C Response Timeout
Read command
AT+FPHCTO?
Write command
AT+FPHCTO=
<tout>
Reference
EIA PN-2388
The time-out value <tout> determines how long the DCE will wait for a command
after reaching the end of data when transmitting in Phase C. When time-out is
reached, the DCE assumes that there are no more pages or documents to send.
Response
<tout> OK
Parameter
See write command
Parameter
<tout> 0 – 30 – 255 time-out value in 100ms units.
Response
OK
If error is related to ME functionality:
ERROR
Note
Used for Fax class 2 only
3.20 AT+FREV Identify Product Revision
Test command
AT+FREV?
Reference
Siemens
Sends the revision identification to the TA
Response
V2.550
OK
Note
Used for Fax class 2 only
3.21 AT+FRH Receive Data Using HDLC Framing
Execute command
AT+FRH=<mod>
Reference
TIA/EIA-578
This command causes the TA to receive frames using the HDLC protocol and the
modulation defined below. An ERROR response code results if this command is
issued while the modem is on-hook.
+FRS=n causes the TA to report an OK result code to the TE after <time> 10
millisecond intervals of silence have been detected on the line. This command is
aborted if any character is received by the DTE. The modem discards the
aborting character and issues an OK result code. An ERROR response code
results if this command is issued while the mode is on-hook.
Response
OK
If error is related to ME functionality:
ERROR
Parameter
<time>0 – 255 no. of 10 millisecond intervals
Note
Used for Faxclass 1 only
3.24 AT+FTH Transmit Data Using HDLC Framing
Write command
AT+FTH=<mod>
Reference
TIA/EIA-578
This command causes the TA to transmit data using HDLC protocol and the
modulation mode defined below. An ERROR response code results if this
command is issued while the modem is on-hook.
Response
CONNECT
Parameter
<mod> 3 V.21 Ch2 300 bps
Note
Used for Faxclass 1 only
TC3X_ATC_01_V04.00 Page 54 of 204 29.05.2002
AT Command Set
3.25 AT+FTM Transmit Data
Test command
AT+FTM=?
Write command
AT+FTM=<mod>
Reference
TIA/EIA-578
Response
(List of supported modulation modes) OK
Parameter
See write command
This command causes the TA to transmit data using the modulation mode
defined below. An ERROR response code results if this command is issued while
the modem is on-hook.
This command causes the TA to terminate a transmission and wait for <time> 10
millisecond intervals before responding with the OK result code to the DTE.
Response
An ERROR response code results if this command is issued while the modem is
on-hook.
Parameter
<time> 0 – 85 no. of 10 millisecond intervals
Note
Used for Fax class 1 only
TC3X_ATC_01_V04.00 Page 55 of 204 29.05.2002
AT Command Set
3.27 AT+FVRFC Vertical resolution format conversion
Test command
AT+FVRFC =?
Read command
AT+FVRFC?
Write command
AT+FVRFC
=<vrfc>
Reference
EIA PN-2388
This command determines the DCE response to a mismatch between the vertical
resolution negotiated for the facsimile session and the Phase C data desired by
the DTE.
Response
(List of supported mismatch checking modes) OK
Parameter
See write command
Response
<vrfc> OK
Parameter
See write command
Response
OK
Parameter
<vrfc>0 disable mismatch checking.
2 enable mismatch checking, with resolution conversion of 1-D
data in the DCE, and an implied AT+FK command executed
on 2-D mismatch detection
Note
Used for Fax class 2 only
The following AT commands are dummy commands. Invoking these commands will not cause
ERROR result codes, but these commands have no functionality.
AT+FAA Auto Answer mode
AT+FECM Error Correction Mode control
AT+FLNFC Page Length format conversion
AT+FLPL Indicate document available for polling
AT+FMINSP Minimum Phase C speed
AT+FRBC Phase C data receive byte count
AT+FREL Phase C received EOL alignment
AT+FSPL Enable polling
AT+FTBC Phase C data transmit byte count
AT+FWDFC Page width format conversion
TC3X_ATC_01_V04.00 Page 56 of 204 29.05.2002
AT Command Set
4 AT Commands originating from GSM 07.07
These AT Commands are according to ETSI (European Telecommunications Standards Institute)
GSM 07.07 document.
4.1 AT+CACM Accumulated call meter (ACM) reset or query
Test command
AT+CACM=?
Read command
AT+CACM?
Write command
AT+CACM=
[<passwd>]
Reference
GSM 07.07
Response
OK
Parameter
Response
TA returns the current ACM value.
+CACM: <acm> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<acm> string type; three bytes of the current ACM value in hexadecimal
format (e.g. “00001E” indicates decimal value 30) 000000 – FFFFFF
Parameter
<passwd> string type:
SIM PIN2
Response
TA resets the Advice of Charge related to the accumulated call meter (ACM)
value in SIM file EF(ACM). ACM contains the total number of home units both
for the current and preceding calls.
OK
If error is related to ME functionality:
+CME ERROR: <err>
TC3X_ATC_01_V04.00 Page 57 of 204 29.05.2002
AT Command Set
4.2 AT+CALA Set alarm time
Test command
AT+CALA=?
Read command
AT+CALA?
Write command
AT+CALA=<time>
[,<n>[,<type>[,<te
xt>]]]
Test command returns supported array index values <n>, alarm types <type>,
and maximum length of the text <tlength> to be output.
Response
+CALA: (list of supported <n>s), (list of supported <type>s), (range of
supported <tlength>) OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
Read command returns the list of current active alarm settings in the ME.
Response
+CALA: <time>[,<n>[,<type>[,<text>]]]
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
The write command sets an alarm time in the ME. When the alarm is timed out
and executed the ME returns an Unsolicited Result Code (URC). The alarm call
can adopt two functions, depending on whether or not you switch the GSM
engine off after setting the alarm:
Reminder call: You can use the alarm function as a wake-up or reminder call.
For this purpose, set the alarm as described below and do not
switch off or power down the ME. When executed the call
comes as an Unsolicited Result Code.
Applies to TC35, TC37 and TC35 Terminal.
Alarm mode: You can use the alarm call to restart the ME when powered
down. For this purpose, set the alarm as described below. Then
power down the ME by entering the AT^SMSO command (pg.
159). When the alarm time is reached, the ME will wake up to
Alarm mode. To prevent the ME from unintentionally logging
into the GSM network, Alarm mode provides restricted
operation. Upon wake-up, the ME indicates an Unsolicited
Result Code which reads: ^SYSSTART ALARM MODE". A
limited number of AT commands is available during Alarm
mode: AT+CCLK, AT+CALA, AT^SBC, AT^SCTM, AT^SMSO.
The ME remains deregistered from the GSM network. If you
want the ME to return to full operation (normal operating mode)
it is necessary to drive the ignition line (IGT pin of ZIF interface)
to ground. If your application is battery powered note that
charging cannot be started while ME is in Alarm mode. For
details please refer to the "Hardware Interface Description"
supplied with your GSM engine.
Applies to TC35 / TC37 modules. TC35 Terminal does not
support the Alarm mode.
Response
OK
If setting fails:
+CME ERROR: <err> Refer Chapter 7.1.1, pg. 181, for <err> values.
TC3X_ATC_01_V04.00 Page 58 of 204 29.05.2002
AT Command Set
Unsolicited result code
Reference
GSM 07.07
Parameter
<time>string type value; format is "yy/MM/dd,hh:mm:ss", where characters
indicate year (two last digits), month, day, hour, minutes. E.g. 6th of
May 2001, 22:10:00 hours equals to “01/05/06,22:10:00" (see also
+CCLK). Note: if <time> equals current date and time or is to an
earlier date, TA returns +CME ERROR: <21>.
<n>integer type value indicating the array index of the alarm. Index starts
with 0. If only this value is returned by the test command, it is default
and indicates that only one alarm time is possible; however, if a
second alarm time is set, the previous alarm is deleted.
<type>integer type value indicating the type of the alarm
0 Alarm indication: text message via serial interface
<text>string type value indicating the text to be displayed when alarm time
is reached; maximum length is <tlength>. After first connection to
power supply <text> is undefined.
Note: <text> will be stored to the non-volatile flash memory when the
device enters the Power Down mode via AT^SMSO (pg. 159). Once
saved, it will be available upon next power-up, until you overwrite it by
typing another text. This eliminates the need to enter the full string
when setting a fresh alarm and thus, saves memory due to the limited
number of flash memory write cycles (e.g. 100.000).
<tlength> integer type value indicating the maximum length of <text>. The
maximum length is 16.
Indicates reminder call:
+CALA: <text>
Indicates ME wake-up into Alarm mode:
^SYSSTART ALARM MODE
+CALA: <text>
If autobauding is active (AT+IPR=0) the URCs ^SYSSTART ALARM MODE
and +CALA: <text> do not appear. Therefore, avoid using Alarm mode in
conjunction with autobauding.
Note
· <text> should not contain characters which are coded differently in ASCII
and GSM (e.g. Ä, Ö, Ü), see also Chapter 7.5.
· In the event of power outage the GSM engine retains the current alarm
setting, but the RTC will be reset to <time> = “00/01/01,00:00:00” and must
be restored after resume of power (see also AT+CCLK, pg. 67. It is only in
Power Down mode, that the RTC is kept powered from a dedicated voltage
regulator, thus saving the current date and time.
· When the GSM engine wakes up to Alarm mode, the system takes 1s to re-
initialize the RTC and to update the current time. Therefore, it is
recommended to wait 1s before using the AT+CCLK command (for example
1s after ^SYSSTART has been output).
· Please consider when using multiplex mode (+CMUX, pg. 86):
- It is possible to use +CALA with every logical channel (1 – 3).
- The total no. of possible alarm events is shared by all channels. If <n> =
0 is returned by the test command, this indicates that only one common
TC3X_ATC_01_V04.00 Page 59 of 204 29.05.2002
AT Command Set
Examples
alarm time is possible for all logical channels.
- For every channel a different <text> parameter can be stored.
- <text> will be output on the same logical channel the alarm was entered.
If not in multiplex mode, <text> will be output independent of the related
channel.
- The read command returns all pending alarms, independent on which
logical channel an alarm was entered. It´s up to the user to identify these
alarms by specific <text>s.
Example 1:
You may want to configure a reminder call for May 31, 2001, at 9.30h, including
the message "Good Morning".
Write command:
AT+CALA="01/05/31,09:30:00",0,0,"Good Morning"
OK
Do not switch off the GSM engine. When the alarm is executed the ME returns
the following URC:
+CALA: Good Morning
Example 2:
To set a fresh alarm using the same message as in Example 1, simply enter
date and time. <n>, <type>, <text>, <tlength> can be omitted:
AT+CALA="01/05/31,08:50:00"
OK
When the alarm is executed the URC comes with the same message:
+CALA: Good Morning
Example 3:
To configure the alarm mode, e.g. for May 20, 2001, at 8.30h, enter
AT+CALA="01/05/20,08:30:00"
OK
Next, power down the ME:
AT^SMSO
^SMSO: MS OFF
When the alarm is executed the ME wakes up to Alarm mode and displays a
URC. If available, this line is followed by the individual <text> most recently
saved. If no individual message was saved only the first line appears.
^SYSSTART ALARM MODE
+CALA: Good Morning
Table 5: Summary of AT commands available in Alarm mode
AT command Use
AT+CALA Set alarm time
AT+CCLK Set date and time of RTC
AT^SBC In Alarm mode, you can only query the present current consumption and check
whether or not a charger is connected. The battery capacity is returned as 0,
regardless of the actual voltage (since the values measured directly on the cell
are not delivered to the module).
AT^SCTM Query temperature of GSM engine
AT^SMSO Power down GSM engine
TC3X_ATC_01_V04.00 Page 60 of 204 29.05.2002
AT Command Set
4.3 AT+CAMM Accumulated call meter maximum (ACMmax) set or query
Test command
AT+CAMM=?
Read command
AT+CAMM?
Write command
AT+CAMM=
[<acmax>[,<passwd>]]
Reference
GSM 07.07
Response
OK
Parameter
Response
TA returns the current ACMmax value.
+CAMM: <acmmax> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
Response
TA sets the Advice of Charge related to the accumulated call meter
maximum value in SIM file EF (ACMmax). ACMmax contains the
maximum number of home units allowed to be consumed by the
subscriber.
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<acmmax> string type; three bytes of the max. ACM value in
hexadecimal format (e.g. “00001E” indicates decimal value
30) 000000 disable ACMmax feature 000001-FFFFFF
<passwd> string type
SIM PIN2
Note
TC3X_ATC_01_V04.00 Page 61 of 204 29.05.2002
AT Command Set
4.4 AT+CAOC Advice of Charge information
Test command
AT+CAOC=?
Read command
AT+CAOC?
Write command
AT+CAOC=<mode>
Execute command
AT+CAOC
Reference
GSM 07.07
Response
+CAOC: (list of supported <mode>s) OK
Parameter
See write command
Response
+CAOC: <mode> OK
Parameter
See write command
Response
TA sets the Advice of Charge supplementary service function mode.
If error is related to ME functionality:
+CME ERROR: <err>
If <mode>=0, TA returns the current call meter value
OK
Parameter
<mode> 0 query CCM value
<ccm> string type; three bytes of the current CCM value in hexadecimal
format (e.g. “00001E” indicates decimal value 30); bytes are
similarly coded as ACMmax value in the SIM 000000-FFFFFF
Response
TA returns the current call meter value
If error is related to ME functionality:
+CME ERROR: <err>
If <mode>=0, TA returns the current call meter value
+CAOC: <ccm> OK
Parameter
See write command
Note
TC3X_ATC_01_V04.00 Page 62 of 204 29.05.2002
AT Command Set
4.5 AT+CBST Select bearer service type
Test command
AT+CBST=?
Read command
AT+CBST?
Write command
AT+CBST=
<speed>[,<name>
[,<ce>]]
Reference
GSM 07.07
Response
+CBST: (list of supported <speed>s),(list of supported <name>s),(list of
supported <ce>s) OK
Parameter
See write command
Response
+CBST: <speed>,<name>,<ce>
OK
Parameter
See write command
Response
TA selects the bearer service <name>, the data rate <speed> and the
connection element <ce> to be used when data calls are originated. The
settings also apply to mobile terminated data calls, especially when single
numbering scheme calls or calls from analog devices are received (see also
Chapter 4.41).
· GSM 02.02[1]: List of allowed combinations of subparameters.
· The PLMN influences the second air interface (to the terminator), therefore
another mode may be established by the network.
· In multiplex mode (AT+CMUX Enter multiplex mode, pg. 86), the bearer
capabilities using 14400 bps (14,75) are not available. Incoming calls are
negotiated at 9600bps. If multiplex mode is active, the bearer capability
automatically switches to +CBST=7,0,1.
TC3X_ATC_01_V04.00 Page 63 of 204 29.05.2002
AT Command Set
4.6 AT+CCFC Call forwarding number and conditions control
<reas> 0 unconditional
1 mobile busy
2 no reply
3 not reachable
4 all call forwarding (includes reasons 0, 1, 2 and 3)
5 all conditional call forwarding (includes reasons 1, 2 and 3)
<mode> 0 disable call forwarding
1 enable call forwarding
2 query status of call forwarding
3 register <number> and activate call forwarding
4 erase <number> and deactivate call forwarding
<number> string type phone number of forwarding address in format
specified by <type>.
If you select <mode> = 3, the phone <number> will be registered
in the network. This allows you to disable / enable CF to the
same destination without the need to enter the phone number
once again. Depending on the services offered by the provider
the registration may be mandatory before CF can be used. The
number remains registered in the network until you register
another number or erase it using <mode> = 4.
<type> type of address in integer format; default 145 when dialling string
includes international access code character “+”, otherwise 129
TC3X_ATC_01_V04.00 Page 64 of 204 29.05.2002
AT Command Set
Reference
GSM 07.07,
GSM 02.04,
GSM 02.82
<class> integer or sum of integers each representing a <class> of
information:
1 voice
2 data
4 fax
8 short message service
16 data circuit sync
32 data circuit async
64 dedicated packet access
128 dedicated PAD access
x combination of some of the above classes.
For example, the default setting 7 represents the sum of
the integers 1, 2 and 4 (CF for voice, data and fax). The
value 255 covers all classes. If the <class> parameter is
omitted, the default value 7 is used.
<time> time to wait before call is forwarded, rounded to a multiple of 5 sec..
1...20..30 (only for <reas>=no reply)
<status> 0 not active
1 active
Note
· Please note that you can register, disable, enable and erase <reas>
4 and 5 as described above. However, it is not possible to query the status
of <reas> 4 and 5 with AT+CCFC. Instead, you may use the ATD
command followed by *'# codes to check the status of these two reasons.
See Chapter 7.4 for a complete list of *# GSM codes. See also examples
below.
· The AT+CCFC command offers a broad range of call forwarding options
according to the GSM specifications. However, when you attempt to set a
call forwarding option which is not provisioned or not yet subscribed to, the
setting will not take effect regardless of the response returned. The
responses in these cases vary with the network (for example “OK”,
“Operation not allowed”, “Operation not supported” etc.). To make sure
check the call forwarding status with <mode>=2.
4.6.1 Examples: Call forwarding
Please note that when you configure or query call forwarding without specifying any classes, the
settings will refer to classes 1, 2 and 4 only (=default). The handling of classes is equivalent to
AT+CLCK (Chapter 4.18.3).
Example 1
Example 2
TC3X_ATC_01_V04.00 Page 65 of 204 29.05.2002
To register the destination number for unconditional call forwarding (CFU):
at+ccfc=0,3,"+493012345678",145
OK
Remember that call forwarding will be activated for voice, data and fax
(default classes) when you register the destination number.
To query the status of CFU without specifying <class>:
<reas>=4 or 5 cannot be used to query the status of all call forwarding
reasons (see also notes above):
at+ccfc=4,2
+CME error: operation not supported
at+ccfc=5,2
+CME error: operation not supported
TC3X_ATC_01_V04.00 Page 66 of 204 29.05.2002
AT Command Set
4.7 AT+CCLK Real Time Clock
Test command
AT+CCLK=?
Read command
AT+CCLK?
Write command
AT+CCLK=<time>
Reference
GSM 07.07
Response
OK
Response
+CCLK: <time>
OK/ERROR/+CME ERROR
Parameter:
<time>: string type value; format is "yy/MM/dd,hh:mm:ss", where characters
indicate year (two last digits), month, day, hour, minutes, seconds;
e.g. 6th of May 2001, 22:10:00 hours equals to “01/05/06,22:10:00"
Response
OK/ERROR/+CME ERROR
Parameter:
<time>see read command
Note
· <time> is retained if the device enters the Power Down mode via
AT^SMSO (pg. 162).
· <time> is lost if power is totally disconnected and if no separate battery
back-up for the clock is provided via the ZIF cable. In this case, the clock
starts with <time> = “00/01/01,00:00:00” upon next power-up.
· See AT+CALA, pg. 58.
· When the GSM engine wakes up to Alarm mode, the system takes 1s to
re-initialize the RTC and to update the current time. Therefore, it is
recommended to wait 1s before using the AT+CCLK command (for
example 1s after ^SYSSTART has been output).
TC3X_ATC_01_V04.00 Page 67 of 204 29.05.2002
AT Command Set
4.8 AT+CEER Extended error report
Test command
AT+CEER=?
Execute command
AT+CEER
Reference
GSM 07.07
Response
OK
TA returns an extended error report of the reason for the last call release and
location.
Response
+CEER: <location ID>, <reason > , <ss_release>OK
Parameter
<location ID> Location ID as number code (see subclause 7.1.5)
<reason>Reason for last call release as number code (see subclause
7.1.5)
<ss_release>Release cause for last Supplementary Service Call
(see subclause 7.1.13)
Note
· AT+CEER is not available for data calls, please use ATS18=1.
· Default output in the case of a no-error-situation is +CEER: 0,0,0.
TC3X_ATC_01_V04.00 Page 68 of 204 29.05.2002
AT Command Set
4.9 AT+CFUN Set phone functionality
The AT+CFUN command serves to query or select the level of functionality <fun> of the ME. Level
"full functionality" is where high current is drawn, depending on the operating mode, e.g. IDLE, TALK
or DATA mode. "Minimum functionality" is where minimum power is drawn, referred to as SLEEP
mode.
For detailed information on the various operating modes and the current consumption please see the
"Hardware Interface Description" supplied with your GSM engine.
Test command
AT+CFUN=?
Read command
AT+CFUN?
Write command
AT+CFUN=[<fun>
[,<rst>]]
Response
+CFUN: (list of supported <fun>s), (list of supported <rst>s)
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See below
Response
+CFUN: <fun>
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See below
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<fun>0 Minimum functionality (SLEEP mode)
AT+CFUN=0 disconnects any call in progress. The SLEEP
mode starts after remaining network activities are
terminated. While SLEEP mode is in effect, the AT interface
is not accessible. Consequently, once you have issued
AT+CFUN=0, do not send further characters. Otherwise
these characters remain in the input buffer and may delay
the output of an URC (see pg. 185, e.g. “RING”).
1 Full functionality (IDLE, TALK, DATA, mode)
<rst> 0 The <rst> parameter can only be used if +CFUN=1. Due to
the command syntax, you need to enter <fun>, followed by
<rst>, where <fun> is only a placeholder and has no effect.
See examples below.
1 ME resets and restarts to full functionality.
After reset and restart, PIN 1 authentication is necessary.
Therefore, you are required to use AT+CPIN again. If
autobauding is enabled it is recommended to wait 3 to 5
seconds before entering the first AT command. For details
on autobauding refer to Chapter 2.46.1
TC3X_ATC_01_V04.00 Page 69 of 204 29.05.2002
AT Command Set
Reference
GSM 07.07
Example 1
Example 2
Example 3
Note
· To check that ME has entered the SLEEP mode, it is recommended to
measure the supply current. Depending on the configuration of the SYNC
pin, the SLEEP mode may also be indicated by a status LED (see
„AT^SSYNC Configure SYNC Pin“, pg. 177).
· When in SLEEP mode, the following events may cause the ME to wake up:
incoming call, Real Time Clock alarm, falling edge of RTS (RS-232, 2.65V
CMOS level) and receipt of an unsolicited result code (URC, see chapter
7.1.3).
· In multiplex mode, the CFUN profile is shared by all multiplexer channels.
When you change the CFUN state on one logical channel, all other logical
channels adopt the same state.
To check the level of functionality use the read command:
AT+CFUN?
+CFUN: 1 Default mode after ME was restarted.
Remember that the AT interface is not accessible in SLEEP mode.
Consequently, the read command is only useful when the ME is set to full
functionality.
To set the ME to SLEEP mode enter
AT+CFUN=0
OK
When, for example, an SMS is being received and indicated by an unsolicited
result code (URC), the ME wakes up to full operation.
+CMTI: "SM",5 Note that the URC used in this example will appear
only if CMTI=1,1 was configured before. See Chapters
5.10 and 7.1.3.
After this, you may want to verify the operating status:
AT+CFUN?
+CFUN: 1 Indicates that ME has entered full functionality mode.
To reset and restart the ME:
AT+CFUN=1,1 or alternatively, AT+CFUN=0,1
OK
^SYSSTART Note that ^SYSSTART appears only if AT+IPR¹0. If the
ME is in autobaud mode, it is recommended to wait 3 to
5 seconds before entering the first AT command.
After the GSM engine was reset and restarted you are required to enter PIN 1:
AT+CPIN
+CPIN: SIM PIN
OK
TC3X_ATC_01_V04.00 Page 70 of 204 29.05.2002
AT Command Set
4.10 AT+CGMI Request manufacturer identification
Test command
AT+CGMI=?
Execute command
AT+CGMI
Reference
GSM 07.07
Response
OK
Response
TA returns manufacturer identification text.
SIEMENS
OK
Note
See also ”AT+GMI Request manufacturer identification”.
4.11 AT+CGMM Request model identification
Test command
AT+CGMM=?
Execute command
AT+CGMM
Reference
GSM 07.07
Response
OK
Response
TA returns product model identification text.
TC35
OK
Note
See also ”AT+GMM Request TA model identification”.
4.12 AT+CGMR Request revision identification of software status
Test command
AT+CGMR=?
Execute command
AT+CGMR
Reference
GSM 07.07
Response
OK
Response
TA returns product firmware version identification text.
REVISION x.yy
OK
x.yy Version x and variant yy of software release
Note
See also AT+GMR Request TA revision identification of software status
TC3X_ATC_01_V04.00 Page 71 of 204 29.05.2002
AT Command Set
4.13 AT+CGSN Request product serial number identification (IMEI) identical
to GSN
Test command
AT+CGSN=?
Execute command
AT+CGSN
Reference
GSM 07.07
Response
OK
Response
TA returns identification text for determination of the individual ME.
<sn> OK
Parameter
<sn> IMEI of the telephone (International Mobile station Equipment Identity)
Note
See also ”AT+GSN Request TA serial number identification”.
4.14 AT+CHLD Call hold and multiparty
Test command
AT+CHLD=?
Execute command
AT+CHLD=[<n>]
Reference
GSM 07.07
Response
+CHLD: (list of supported <n>s)
OK
Response
TA controls the supplementary services Call Hold, MultiParty and Explicit Call
Transfer. Calls can be put on hold, recovered, released, added to conversation
and transferred.
Note: Supplementary services are only applicable to teleservice 11 (Speech tele-
phony).
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<n> 0 Terminate all held calls; or set UDUB (User Determined User
Busy) for a waiting call, i.e. reject the waiting call.
1 Terminate all active calls (if any) and accept the other call
(waiting call or held call)
1X Terminate the active call X (X= 1-7)
2 Place all active calls on hold (if any) and accept the other call
(waiting call or held call) as the active call
2X Place all active calls except call X (X= 1-7) on hold
3 Add the held call to the active calls
Note
In conflicting situations, e.g. when a waiting call comes while there are already
held calls, the above procedures apply to the waiting call only. For example,<n>=0 rejects the waiting call, but does not affect the held calls.
TC3X_ATC_01_V04.00 Page 72 of 204 29.05.2002
AT Command Set
4.15 AT+CHUP Hang up call
Test command
AT+CHUP=?
Execute command
AT+CHUP
Reference
GSM 07.07
Response
OK
Cancels all active and held calls.
Response
OK/ERROR
Note
AT+CHUP implements the same behaviour as ATH (see Chapter 2.12).
4.16 AT+CIMI Request international mobile subscriber identity
Test command
AT+CIMI=?
Execute command
AT+CIMI
Reference
GSM 07.07
Response
OK
Response
TA returns < IMSI> for identifying the individual SIM which is attached to ME.
<IMSI> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<IMSI> International Mobile Subscriber Identity (string without quotes)
Note
TC3X_ATC_01_V04.00 Page 73 of 204 29.05.2002
AT Command Set
4.17 AT+CLCC List current calls of ME
Test command
AT+CLCC=?
Execute command
AT+CLCC
Reference
GSM 07.07
Response
OK
Parameters
Response
TA returns a list of current calls of ME. If command successful, but no calls are
available, no information response is sent to TE.
<idx>Integer type; call identification number as described in GSM
02.30[19] subclause 4.5.5.1; this number can be used in +CHLD
command operations
<dir>0 mobile originated (MO) call 1 mobile terminated (MT) call
<stat>state of the call:
0 active
1 held
2 dialing (MO call)
3 alerting (MO call)
4 incoming (MT call)
5 waiting (MT call)
<mode> bearer/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; 145 when dialling string
includes international access code character “+”, otherwise 129
<alpha>string type alphanumeric representation of <number>
corresponding to the entry found in phonebook; used character
set should be the one selected with command Select TE
Character Set +CSCS
Note
TC3X_ATC_01_V04.00 Page 74 of 204 29.05.2002
AT Command Set
4.18 AT+CLCK Facility lock
Test command
AT+CLCK=?
Execute command
AT+CLCK=<fac>,
<mode>
[,<passwd>
[,<class>]]
Response
+CLCK: (list of supported <fac>s) OK
Parameter
See execute command
Use this command to lock, unlock or interrogate a ME or a network facility
<fac>. The command can be aborted when network facilities are being set or
interrogated.
Response
If <mode>¹2 and command is successful
OK
If <mode> = 2 and command is successful
+CLCK: <status>[,<class1>[<CR><LF>
+CLCK: <status>, class2....]] OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<fac> Phone security locks set by client or factory:
“SC” SIM (lock SIM cards). SIM requests password upon ME power-
“PS” Phone locked to SIM card. ME requests password when other
“FD” SIM fixed dialling memory: If the mobile is locked to "FD", only
"CS" Keypad lock (not supported since keypad cannot be directly
Note: Primarily intended for the client to take safety precautions, "SC",
up and when this lock command is issued. "SC" lock is protected
with SIM PIN1. The number can be modified with AT+CPWD or
AT^SPWD. See examples in Chapter 4.18.2 for further
explanations.
than current SIM card is inserted.
If set individually by the client, the password for the "PS" lock
can be specified with AT+CPWD or AT^SPWD.
If set by factory (e.g. for a prepaid mobile), the password is
supplied by the provider or operator.
the phone numbers stored to the "FD" memory can be dialled
(depending on the SIM card, usually up to 7 numbers). If PIN2
authentication has not been performed during the current
session, PIN2 is requested as <passwd>.
connected to the GSM engine)
"PS" and "FD" can be configured individually. "PS" may also be
factory set.
"PS" lock is frequently referred to as "phone lock", or "device
lock". Accordingly, the password may be called "phone code" or
"device code". The "PS" password is not associated with the
PUK of the SIM card. If incorrectly entered three times, the
Master Phone Code is required to lift the lock. Once the Master
Phone Code has been acctepted, the mobile is operational, and
the "PS" lock is no longer active. If needed it must be set once
again. See Chapter 4.31.1 and examples below for further
details.
TC3X_ATC_01_V04.00 Page 75 of 204 29.05.2002
AT Command Set
Factory set SIM locks
“PF” lock Phone to the very First SIM card
“PN” Network Personalisation
“PU” Network subset Personalisation
“PP” Service Provider Personalisation
“PC” Corporate Personalisation
Note: Typical examples of factory set SIM locks are prepaid phones or
network locks, used to restrict the operation of a mobile to a
specific provider or operator. The client should be aware that
each of these lock types can only be unlocked if the associated
password is available. For example, a mobile can be locked to
accept only SIM cards from the respective provider, or even one
single SIM card. Once a different SIM card is inserted the ME will
prompt the client to enter a specific code. This is not the PUK of
the SIM card, but usually an 8-digit code which needs to be
requested from the provider.
The locks can only be set by the manufacturer and need to be
agreed upon between the parties concerned, e.g. provider,
operator, distributor etc. on the one side and the manufacturer
on the other side. For details contact your local dealer or
Siemens AG.
See Chapter 4.31 and 4.31.1 for further instructions.
Supplementary Service: Call barring:
“AO” BAOC (Bar All Outgoing Calls)
“OI” BOIC (Bar Outgoing International Calls)
“OX” BOIC-exHC (Bar Outgoing International Calls except to Home
Country)
“AI” BAIC (Bar All Incoming Calls)
“IR” BIC-Roam (Bar Incoming Calls when Roaming outside the home
country)
“AB” All Barring services (applicable only for <mode>=0)
“AG” All outGoing barring services (applicable only for <mode>=0)
“AC” All inComing barring services (applicable only for <mode>=0)
Note: The availability of the Supplementary Services varies with the
network. To benefit from call barring the client will need to
subscribe them, though a limited number of call barring types
may be included in the basic tariff package. Call barring is
protected by a password supplied from the provider or operator.
Usually there is one password which applies to all call barring
options. For details contact your provider.
<mode> 0 unlock
1 lock
2 query status
<passwd> password
See Chapters 4.34 and 6.36 for instructions of how to specify
passwords.
<class> integer or sum of integers each representing a <class> of information:
1 voice
2 data
4 fax
8 short message service
16 data circuit sync
TC3X_ATC_01_V04.00 Page 76 of 204 29.05.2002
AT Command Set
Reference
GSM 07.07
32 data circuit async
64 dedicated packet access
128 dedicated PAD access
x combination of some of the above classes.
For example, the default setting 7 represents the sum of the
integers 1, 2 and 4 (call barring for voice, data and fax). The
value 255 covers all classes. If the <class> parameter is
omitted, the default value 7 is used.
See examples in 4.18.3 for the correct handling of class numbers.
<status> 0 off
1 on
Note
*# codes sent with ATD cannot be used to enter the Master Phone Code.
To lock or unlock the SIM card: The "SC" parameter enables or disables the
SIM PIN authentication (PIN 1) when you power up the GSM engine:
AT+CLCK="SC",1,9999 Activates SIM card lock.
OK As a result, SIM PIN 1 must be entered to
enable ME to register to the GSM network.
AT+CLCK="SC",0,9999 Unlocks SIM card.
OK When powered up, ME registers to the GSM
network without requesting SIM PIN1.
Note: Depending on the services offered by the
provider, this feature is not supported by all
SIM card types. If so, the command returns
ERROR when you attempt to unlock the card.
To query the status of the SIM card lock:
AT+CLCK="SC",2
+clck: 1 SIM card is locked. SIM PIN1 must be entered
to enable ME to register to the GSM network.
4.18.2 Examples: Phone lock
Example 1
TC3X_ATC_01_V04.00 Page 77 of 204 29.05.2002
Be sure that PIN 1 authentication is valid:
AT+CPIN?
+CPIN: SIM PIN
OK
AT+CPIN=9999
OK
AT Command Set
Example 2
Example 3
Example 4
Example 5
To lock the mobile to the currently inserted SIM card, first specify a password (=
a phone code):
AT+CPWD="PS",,1234 If "PS" lock has not been set before: enter new
OK password.
or:
AT+CPWD="PS",1234,3333 To replace existing "PS" password: Enter old
OK and new one.
Then, activate the phone lock:
AT+CLCK="PS",1,3333 Locks the mobile to the current SIM card.
OK
To deactivate the phone lock:
AT+CLCK="PS",0,3333 Enter lock type "PS", followed by 0 to lift the
OK lock. Then type "PS" lock password.
As a result, the mobile accepts any SIM card and can be operated after the
card's SIM PIN 1 was entered.
To operate the mobile with the SIM card for which "PS" lock was activated:
AT+CPIN? Enter SIM PIN used when locking the mobile.
+CPIN: SIM PIN "PS"lock password is not needed.
AT+CPIN=9999
OK
To operate the mobile with other SIM card than the one used for the "PS" lock:
Enter SIM PIN of present card, followed by "PS" lock password.
AT+CPIN? Enter SIM PIN of present SIM card.
+CPIN: SIM PIN
AT+CPIN=1111
OK SIM PIN accepted.
AT+CPIN?
+CPIN: PH-SIM PIN "PS" lock password is required.
AT+CPIN=3333
OK "PS" lock password has been accepted.
Attempt to unblock the "PS" lock using an invalid password:
AT+CPIN? Enter SIM PIN of present SIM card.
+CPIN: SIM PIN
AT+CPIN=1111
OK SIM PIN accepted.
AT+CPIN?
+CPIN: PH-SIM PIN "PS" lock password is required.
AT+CPIN=4444 Bad password is given:
+CME ERROR: incorrect password
TC3X_ATC_01_V04.00 Page 78 of 204 29.05.2002
AT Command Set
Example 6
Example 7
After the "PS" lock password was incorrectly entered three times in a row:
AT+CPIN=12345678 Master Phone Code has been accepted. As a
result, the mobile is operational, and the "PS"
lock is totally removed. If needed, it must be set
once again.
Attempt to unblock the "PS" lock using an invalid Master Phone Code: Due to
the timing algorithm explained in Chapter 4.31.1 the intervals between each
attempt are getting longer. See also AT^SPIC in Chapter 6.32.
As an alternative to the AT+CPIN command you can use AT+CPWD. In this
case the following syntax shall be observed: AT+CPWD=PS,Master Phone
Code[,new password].
AT+CPWD=PS,12345678 Deactivates the "PS" lock.
Or
AT+CPWD=PS,12345678,3333 Deactivates the present "PS" lock
and sets a new "PS" lock.
4.18.3 Examples: Call barring
Please note that when you configure or query call barring without specifying any classes, the settings
will refer to classes 1, 2 and 4 only (default setting).
Remember that most of the call barring types have to be subscribed to. Usually, the service is subject
to a password supplied from the provider.
Example 1
Example 2
When checking the status of barring for outgoing international calls without
specifying classes, please note that the ME returns only the status of voice,
data, fax calls. The status of SMS will not be indicated.
at+clck=oi,2,0000 or without <passwd>: at+clck=oi,2
+CLCK: 1,1 outgoing international voice calls barred
+CLCK: 1,2 outgoing international data calls barred
+CLCK: 1,4 outgoing international fax calls barred
OK
To check the call barring status of all services, you are required to enter the
integer sum referring to all classes:
at+clck=oi,2,0000,15 or without <passwd>: at+clck=oi,2,,15
+CLCK: 1,1 outgoing international voice calls barred
+CLCK: 1,2 outgoing international data calls barred
+CLCK: 1,4 outgoing international fax calls barred
+CLCK: 1,8 outgoing international SMS barred
TC3X_ATC_01_V04.00 Page 79 of 204 29.05.2002
AT Command Set
Example 3
Example 4
Example 5
Example 6
OK
To activate call barring for outgoing international voice and data calls:
at+clck=oi,1,0000,3 (where 3 is the sum of class 1 + class 2)
OK
To disable call barring for outgoing international fax (class 4) and SMS (class 8)
calls:
at+clck=oi,0,0000,12 (where 12 is the sum of class 4 + class 8)
OK
To check whether actions in example 3 and 4 were successful, check the status
of barring for all outgoing international calls:
at+clck=oi,2,0000,15
+CLCK: 1,1 outgoing international voice calls barred
+CLCK: 1,2 outgoing international data calls barred
+CLCK: 0,4 outgoing international fax calls are allowed
+CLCK: 0,8 outgoing international SMS are allowed
OK
To allow outgoing international calls without specifying classes:
at+clck=oi,0,0000,15
OK
To query status without specifying classes:
at+clck=oi,2
+CLCK: 0,1 outgoing international voice calls allowed
+CLCK: 0,2 outgoing international data calls allowed
+CLCK: 0,4 outgoing international fax calls allowed
4.19 AT+CLIP Calling line identification presentation
Test command
AT+CLIP=?
Read command
AT+CLIP?
Write command
AT+CLIP=<n>
Unsolicited result
code
Reference
GSM 07.07
This command refers to the GSM supplementary service CLIP (Calling Line
Identification Presentation) that enables a called subscriber to get the calling line
identity (CLI) of the calling party when receiving a mobile terminated call.
Response
+ CLIP: (list of supported <n>s) OK
Parameter
See write command
Response
+CLIP: <n>, <m> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
Set command enables or disables the presentation of the CLI at the TE. It has no
effect on the execution of the supplementary service CLIP in the network.
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<n> 0 suppress unsolicited result codes
1 display unsolicited result codes
<m>0 CLIP not provisioned
1 CLIP provisioned
2 unknown
When CLIP is enabled at the TE (and is permitted by the calling subscriber), an
unsolicited result code is returned after every RING (or +CRING: <type>) at a
mobile terminating call.
Voice call response format:
+CLIP: <number>, <type>,,,,<CLI validity>
Data/FAX call response format:
+CLIP: <number>, <type>
Parameter
<number> string type phone number of calling address in format specified by
<type>
<type> type of address octet in integer format; 145 when dialling string
includes international access code character “+”, otherwise 129.
<CLI validity>
0 CLI valid
1 CLI has been withheld by the originator.
3 CLI is not available due to interworking problems or limitations
of originating network. <number> shall be an empty string ("")
and <type> value will not be significant.
Note
TC3X_ATC_01_V04.00 Page 81 of 204 29.05.2002
AT Command Set
4.20 AT+CLIR Calling line identification restriction (by *# sequence)
The AT+CLIR command is not supported. Instead, you can handle CLIR on a call-by-call basis using
the ATD command and a *# sequence.
Read command
ATD*#31#
Execute commands
ATD*31#<Phonenumber>[;]
ATD#31#<Phonenumber>[;]
Note:
Run the Read command to query status:
Response
+CLIR: <n>,<m>
Defined values
<n>(parameter shows the settings for outgoing calls):
0 presentation indicator is used according to the
subscription of the CLIR service
1 CLIR invocation
2 CLIR suppression
<m>(parameter shows the subscriber CLIR service status in
the network):
0 CLIR not provisioned
1 CLIR provisioned in permanent mode
2 unknown (e.g. no network, etc.)
3 CLIR temporary mode presentation restricted
4 CLIR temporary mode presentation allowed
The Execute commands allow you to enable or disable the
presentation of your phone number to the called party when you set
up a call:
Deactivate CLIR = enable presentation of own phone number
to called party
Activate CLIR = suppress presentation of own phone number to
called party
<Phonenumber> = phone number of called party
TC3X_ATC_01_V04.00 Page 82 of 204 29.05.2002
AT Command Set
4.21 AT+CLVL Loudspeaker volume level
Test command
AT+CLVL=?
Read command
AT+CLVL?
Write command
AT+CLVL=<level>
Reference
GSM 07.07
Response
+CLVL: (list of supported <level>s)OK
Response
+CLVL: <level>
OK/ERROR/+CME ERROR
Response
OK/ERROR/+CME ERROR
Parameter
<level> Loudspeaker Volume Level (0-4)
Note
· The write command can only be used in audio mode 2 – 6.
· The values of the volume steps can be specified with the parameters
<outCalibrate[0]>,...<outCalibrate[4]> of the AT^SNFO command (see
Chapter 6.24).
· As an alternative to AT+CLVL, you can use AT^SNFV as described in
Chapter 6.27. The parameter <level> is identical with <outStep> used
in the AT^SNFV command.
· Any change to <level> (or <outStep>) takes effect in audio modes 2 to
6. That is, when you change <level> (or <outStep>) and then select
another mode with AT^SNFS, the same value will be applied. The
only exception is audio mode 1 which is fixed to <level>=4 (or
<outStep>=4).
· The value of <level> (or <outStep> is stored non-volatile when the ME
is powered down with AT^SMSO or reset with AT+CFUN=1,1. Any
other values changed with AT^SNFO need to be saved with
AT^SNFW for use after restart.
TC3X_ATC_01_V04.00 Page 83 of 204 29.05.2002
AT Command Set
4.22 AT+CMEE Report mobile equipment error
Test command
AT+CMEE=?
Read command
AT+CMEE?
Write command
AT+CMEE=<n>
Example
Reference
GSM 07.07
Response
+CMEE: (list of supported <n>s) OK
Parameter
See write command
Response
+CMEE: <n> OK
Parameter
See write command
This command controls the presentation of the result codes +CMEERROR:<err> and CMS:<err> that indicate errors relating to ME
functionality.
When you power down or reset the ME with AT+CFUN=1,1 the setting will
be reset to its default. The levels 1 or 2 need to be selected every time
you reboot the ME, or may be included, for permanent use, in the user
profile saved with AT&W.
Response
OK
Parameter
<n> 0 disable result code (only 'ERROR' will be displayed)
1 enable result code and use numeric values
2 enable result code and use verbose values
To obtain enhanced error messages it is recommended to choose <n>=2.
AT+CMEE=2
OK
Note
· The possible error result codes are listed in chapter 7
· In multiplex mode (see “AT+CMUX Enter multiplex mode”, pg. 86) the
setting applies only to the logical channel where selected. The setting
on the other channels may differ.
TC3X_ATC_01_V04.00 Page 84 of 204 29.05.2002
AT Command Set
4.23 AT+CMUT Mute control
Test command
AT+CMUT=?
Read command
AT+CMUT?
Write command
AT+CMUT=<n>
Reference
GSM 07.07
Response
+CMUT: (list of supported <n>s)
OK
Response
+CMUT: <n>
OK/ERROR/+CME ERROR
Response
OK/ERROR/+CME ERROR
Parameter
<n>: 0 mute off
1 mute on
Note
This command can be used in all audio modes (1 to 6) and during a voice
call only. See AT^SNFS in Chapter 6.26 for more details on the various
audio modes.
Users should be aware that when they switch back and forth between
different audio modes the value of <mute> does not change. This means
that the status of mute operaton is retained until explicitly changed.
As alternative, you can use the AT^SNFM command described in
Chapter 6.22.
TC3X_ATC_01_V04.00 Page 85 of 204 29.05.2002
AT Command Set
4.24 AT+CMUX Enter multiplex mode
TC35 / TC37 and TC35 Terminal support Multiplex mode according to the GSM 07.10 Multiplexer
Protocol and enables one physical serial asynchronous interface to be partitioned into three virtual
channels. This allows you to take advantage of up to 3 simultaneous sessions running on the serial
interface. Each session represents a stream of bytes conveying various data; such as voice, fax,
data, SMS, phonebook information, battery status etc. For example, you can transfer data over one
channel while two further channels are free to control the GSM engine with AT commands. It should
be noted, however, that voice, data or fax calls cannot be established simultaneously, since the
mobile device provides just one air interface to the network.
To make the three virtual interfaces (channels) available, both the GSM engine and the customer
application must contain Mux components which communicate over the Multiplexer Protocol. In the
GSM engine, the Mux/MP software is already incorporated. The customer application should either
integrate the TC35 Mux/MP software or include a Mux/MP program developed by the customer. The
AT+CMUX write command starts the multiplexing protocol control channel.
Refer to [3] which provides to a detailed description of the Multiplex functionality implemented in
TC35 / TC37 and TC35 Terminal and step-by-step instructions of how to install and configure the
MUX mode. The source files of the TC35 Mux/MP software can be supplied on request. Please
contact your local dealer to obtain the latest installation software and user's guide.
Subparameters defined in GSM07.07 are adjusted for control and logical
channels as follows:
<subset>0 UIH frames used only (control channel)
Note
1. The write command is used to enter the multiplex mode. The setup of
the logical channels is initiated by the TE, i.e. the TE acts as initiator.
This means that the TE shall ensure that logical channels are
established before any further actions on the channels can be started.
2. There is a timeout of five seconds, if the multiplexer protocol is enabled
and no multiplexer control channel is established. The GSM engine
TC3X_ATC_01_V04.00 Page 86 of 204 29.05.2002
AT Command Set
returns to the AT command mode.
3. There are various options to switch from data mode to command mode:
a) Escape sequence +++
b) Circuit 108/2 (DTR) changes from ON to OFF, reaction depends on
command at&d (caution if AT&D0: TA ignores status on DTR).
c) The message Modem Status Command (MSC) for control channel is
defined by the multiplexer protocol GSM07.10. MSC conveys V.24
signals. Bit 3 of Control Signal Octet is DTR, reaction depends on
command at&d (caution if AT&D0: TA ignores status on DTR).
4. The parameter maximum frame size (N1) of AT+CMUX in GSM07.07 is
fixed to 97 and cannot be changed. All other parameters are not
available.
5. Multiplex mode can be terminated with AT ^SMSO (Chapter 6.18, pg.
159). It has to be reestablished after power-on.
4.24.1 Restricted use of AT commands in Multiplex mode
In Multiplex mode, the operation of several AT commands varies from the normal mode. This chapter
summarizes the concerned commands. For general rules and restrictions to be considered in Multiplex
mode please refer to [3].
Data calls can only be set up on logical channel 1. Due to this restriction, AT commands have a
different behaviour on channels 2+3 compared to channel 1. Several commands are not available,
others return different responses. These commands are listed in the table below:
Table 6: Availability of AT commands on virtual channels
Command Behaviour on channel 1 Differences on channel 2+3
+++ as described not usable
ATE as described as described
AT+CBST as described not usable
AT+CR as described not usable
AT+CRLP as described not usable
AT+F.... (Fax commands) not usable not usable
AT&C as described not usable
AT&D as described not usable
AT&F as described data call parameters not changed
AT&S as described not usable
AT&V as described data call parameters not displayed
ATA as described no data calls
ATD as described no data calls
ATDI<n> as described not usable
ATO as described not usable
ATS0 1)
ATS3 1)
ATS4 1)
ATS5 1)
as described not usable
as described as described
as described as described
as described not usable
TC3X_ATC_01_V04.00 Page 87 of 204 29.05.2002
AT Command Set
Command Behaviour on channel 1 Differences on channel 2+3
ATS6 1)
ATS7 1)
ATS8 1)
ATS10 1)
ATS18 1)
as described not usable
as described not usable
as described not usable
as described not usable
as described not usable
AT\Q<n> as described not usable
ATZ as described data call parameters not changed
1
)
Siemens GSM engines support the registers S0 - S29. You can change S0, S3, S4, S5, S6, S7,S8,
S10 and S18 using the related ATSn commands (see starting from pg. 27). The other registers are
read-only and for internal use only!
Table 7: Summary of AT commands with different behaviour in Multiplex mode
Command Description Chapter
AT\Q<n> It is recommended to use hardware flow control (AT\Q3). XON/XOFF
2.3
flow control (AT\Q1) is not supported in Multiplex mode
ATH Terminates any call in progress, no matter what channel was used to
2.12
enter ATH
AT&V Different default configurations on channels 1, 2 and 3 2.38
AT+IPR Before you start Multiplex mode, it is recommended to set the ME to
2.46
57600 bps, especially if you want to use all the three channels. Once
it is activated, the bitrate on channels 2 + 3 should be set to 19200
bps.
Minimum bit rate in Multiplex mode: 4.8 kbps
AT+IPR=0 Autobauding is not compatible with Multiplex mode. It is neither
2.46.1
possible to start MUX when autobauding is active, nor to set
autobauding during Multiplex mode.
AT+CALA Alarm calls can be separately configured on each channel. The read
4.2
command returns the total number of alarm calls activated on all
channels.
AT+CBST 14400 bps bearer capabilities are not available in Multiplex mode.
4.5
Incoming calls are negotiated at 9600bps. If multiplex mode is active,
the bearer capability automatically switches to +CBST=7,0,1.
AT+CMEE Presentation mode can be separately configured for each channel. 4.22
AT+CNMA If Multiplex mode is activated the +CNMI parameter will be set to zero
5.9
on all channels, if one channel fails to acknowledge an incoming
message within the required time.
AT+CNMI Phase 2+ parameters can only be used on one channel. The
5.10
parameter for <mt> and <ds> on the other channels have to be set to
zero.
If either a SM or a Status Report is not acknowledged, all +CNMI
parameter will be set to zero on all channels.
TC3X_ATC_01_V04.00 Page 88 of 204 29.05.2002
AT Command Set
4.25 AT+COPN Read operator names
Test command
AT+COPN=?
Execute command
AT+COPN
Reference
GSM 07.07
Response
OK
TA returns the list of operator names from the ME. Each operator code
<numericn> that has an alphanumeric equivalent <alphan> in the ME memory
is returned.
<numericn>string type; operator in numeric form; GSM location area
identification number
<alphan> string type; operator in long alphanumeric format; can contain
up to 16 characters
Note
See also AT^SPLM, pg. 173
TC3X_ATC_01_V04.00 Page 89 of 204 29.05.2002
AT Command Set
4.26 AT+COPS Operator selection
This command can be used to query the present status of the ME's network registration and to
determine whether automatic or manual network selection shall be used.
Automatic mode: Lets the ME automatically search for the home operator. If successful the ME
registers to the home network and enters the IDLE mode. If the home network
is not found, ME goes on searching. If then a permitted operator is found, ME
registers to this operator. If no operator is found the ME remains unregistered.
Manual mode: Desired operator can be manually entered, using the AT+COPS write
command syntax. If operator is found, ME registers to this operator. If the
selected operator is forbidden, the ME remains unregistered.
Manual/automatic: In this mode, the ME first tries to find the operator that was manually entered.
If the ME fails to register to this operator, then it starts to select automatically
another network.
Test command
AT+COPS=?
Read command
AT+COPS?
Write command
AT+COPS=
<mode>
[,<format>[,<oper>]]
TA returns a list of quadruplets, each representing an operator present in the
network. The list of operators is presented in the following order: Home
network, networks referenced in SIM, and other networks. Two commas in a
succession (,,) are a placeholder for the non-implemented <format>1 (short
alphanumeric operator name).
Response
+COPS: (list of supported (<stat>, long alphanumeric <oper>,, numeric
<oper>s) [,(list of supported <mode>s), (list of supported <format>s)] OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameters
<stat> 0 unknown
1 operator available
2 current operator (registered)
3 forbidden operator
<oper> operator as per <format>
<mode> 0 - 4 see write command
<format> 0 - 2 see write command
TA returns the current mode and, if registered, the currently used operator. If
the ME is unregistered, <format> and <oper> are omitted.
Response
+COPS: <mode>[, <format>[, <oper>]] OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameters
See write command
The write command allows you to choose whether the GSM network operator
is to be selected automatically or manually. When using the manual mode, the
<operator> must be entered, no matter whether you want to search for the
home operator or another one.
TC3X_ATC_01_V04.00 Page 90 of 204 29.05.2002
AT Command Set
Reference
GSM 07.07
Example 1
Example 2
Response
OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameters
<mode> 0 automatic mode; <oper> field is ignored
1 manual operator selection
<oper> field must be present, <format> can only be = 2
2 manually deregister from network and remain unregistered
until mode 0,1,4 is selected
3 set <format> for read command +COPS?
4 combination of manual/automatic mode;
if manual selection fails, ME switches to automatic mode
<oper> operator as per <format>
(<mode>=0). (<oper> field must be present)
<format> 0 long format alphanumeric <oper>; up to 16 characters
2numeric <oper>; GSM Location Area Identification number
Note
To query the present status of ME's network registration using the test
command:
D1",,"26201"),(3,"Interkom",,"26207"),,(0-4),(0,2)
OK
Registered operator is D2. The other operators are present in the network, but
not allowed to be used with the current SIM card.
To query the status of the ME's network registration using the read command:
AT+COPS?
+COPS: 0,0,"D2" (command returns mode, format, registered operator)
OK
Attempt to manually select a forbidden operator:
AT+COPS=1,2,26203
OK
If the selected operator was not allowed, the ME is now unregistered. The
read command will return only the mode, but no operator:
AT+COPS?
+COPS: 1
In this case, the test command returns only that the desired operator is
available (<stat=1). Nevertheless, the registration is not successful. Please
use the AT+CREG command (Chapter 4.37) to verify the registration status.
D1",,"26201"),(3,"Interkom",,"26207"),,(0-4),(0,2)
OK
AT+CREG?
+CREG: 0,3 (where 3 = registration denied)
OK
TC3X_ATC_01_V04.00 Page 91 of 204 29.05.2002
AT Command Set
4.27 AT+CPAS Mobile equipment activity status
Test command
AT+CPAS=?
Execute command
AT+CPAS
Reference
GSM 07.07
Response
+CPAS: (list of supported <pas>s) OK
Parameter
See execute command
Response
TA returns the activity status of ME.
+CPAS: <pas> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<pas> 0 ready 3 incoming call (ringing)
4 call in progress or call hold
Note
TC3X_ATC_01_V04.00 Page 92 of 204 29.05.2002
AT Command Set
4.28 AT+CPBR Read current phonebook entries
Test command
AT+CPBR=?
Execute command
AT+CPBR=<ind
ex1>[,<index2>]
Example
Response
TA returns location range supported by the current storage as a compound value
and the maximum length of <number> and <text> fields.
Note:
If SIM storage is selected, the length may not be available. If storage does not
offer format information, the format list should be empty parentheses.
+CPBR: (list of supported <index>s), <nlength>, <tlength> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<index>supported range of location numbers (maximum number
depends on storage type)
<nlength>max. length of phone number, normally 20, for a small
number of locations 40
<tlength>max. length of text assigned to phone number (depending on
storage type 16 - 18 characters including blanks)
Response
TA returns phonebook entries in location number range <index1> ... <index2>
from the current phonebook memory storage selected with +CPBS. If <index2> is
left out, only location <index1> is returned.
<index1> location number where reading starts
<index2> location number where reading ends
<number> phone number
<type> type of address octet in integer format; 145 when dialling string
includes international access code character “+”, otherwise 129.
<text> string type field of maximum length <tlength>. Character set as
specified with +CSCS.
1. First, run the Test command to find out the maximum range of entries stored
in the active phonebook:
AT+CPBR=?
TA returns the supported values in the format: +CPBR: (1-100),20,17 where
100 is the supported range of location numbers, 20 is the length of the phone
number and 17 is the maximum length of the text associated text.
2. Now, run the Execute command to display the phonebook entries sorted by
location numbers.
AT+CPBR =1,100
+CPBR 1,"+999999",145,"Charlie"
+CPBR: 2,"+777777",145,"Bill"
+CPBR: 3,"+888888",145,"Arthur" .........
Reference
Note
GSM 07.07
TC3X_ATC_01_V04.00 Page 93 of 204 29.05.2002
AT Command Set
4.29 AT+CPBS Select phonebook memory storage
Test command
AT+CPBS=?
Read command
AT+CPBS?
Write command
AT+CPBS=
<storage>
Parameter
Reference
GSM 07.07
Response
+CPBS: (list of supported <storage>s) OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
Response
TA returns currently selected memory:
+CPBS: <storage>,<used>,<total> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command
Response
TA selects current phonebook memory storage, which is used by other
phonebook commands.
OK
If error is related to ME functionality:
+CME ERROR: <err>
<storage> “SM” SIM phonebook (storage depends on SIM Card)
If the mobile is locked to FD, only the numbers stored to the
FD memory can be dialled. To edit the FD phonebook PIN 2
is required. See AT+CLCK Facility lock and AT^SLCK
Facility lock.
“MC” ME missed (unanswered received) calls) (MC Phonebook
storage pos.1-10) list (+CPBW not applicable to this storage
“RC” ME received calls list (+CPBW not applicable for this
storage) (RC Phonebook storage pos.1-10)
“ON” SIM (or ME) own numbers (MSISDNs) list
“ME” ME Phonebook (storage pos.1-50)
<used>Integer type value indicating the number of used locations in
selected memory
<total>Integer type value indicating the maximum number of locations
allowed in the selected memory
Note
This command can be used right after power-on to get selected <storage>.
Since data need to be loaded from the SIM, values of <used> and <total> might
not be available for the first 20 seconds.
TC3X_ATC_01_V04.00 Page 94 of 204 29.05.2002
AT Command Set
4.30 AT+CPBW Write phonebook entry
Test command
AT+CPBW=?
Write command
AT+CPBW=
[<index>]
[,<number>
[[,<type>]
[,<text>]]]
Reference
GSM 07.07
Response
TA returns location range supported by the current storage, the maximum
length of <number> field, supported number formats of the storage and the
maximum length of <text> field.
Note: The length may not be available while SIM storage is selected. If storage
does not offer format information, the format list should be empty
parenthesises.
+CPBW: (list of supported <index>s), <nlength>, (list of supported <type>s),
<tlength> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
See write command.
This command writes a phonebook entry to the memory location <index> of the
active memory.
The memory location number <index> is followed by the phone number
<number> (in the format <type>) and the associated <text>.
If writing fails, an ME error +CME ERROR: <err> is returned.
Parameter
<index>Location number within phonebook memory, total range is given
in test command response
<number>Phone number, maximum length is given as <nlength> in test
command response
<type>Type of phone number (address octet in integer format); 145 when
dialling string includes international access code character “+”,
otherwise 129 (refer GSM 04.08 subclause 10.5.4.7)
<text>Text assigned to the phone number, maximum length is given in
test command response <tlength>. Character set as specified with
+CSCS. See note below.
<nlength>Max. length of phone number, normally 20, for a small number of
locations 40
<tlength>Max. length of text assigned to phone number (depending on
storage type 16 - 18 characters including blanks)
Response
OK/ERROR/+CME ERROR
To delete a phonebook entry simply enter the location number:
AT+CPBW=<index>
To write a phonebook entry to the first free location number:
AT+CPBW=,<number>,<type>,<text>
Note
If <text> contains characters which are coded differently in ASCII and GSM
(e.g. Ä, Ö, Ü), these characters have to be entered via escape sequences as
described in chapter „“, pg. 11.
TC3X_ATC_01_V04.00 Page 95 of 204 29.05.2002
AT Command Set
4.31 AT+CPIN Enter PIN
Test command
AT+CPIN=?
Read command
AT+CPIN?
Response
OK
Response
TA returns an alphanumeric string indicating whether or not a password is
required.
+CPIN: <code> OK
If error is related to ME functionality:
+CME ERROR: <err>
Parameter
<code>
SIM PIN authentication
READY PIN has already been entered. No further entry
SIM PIN ME is waiting for SIM PIN1.
SIM PUK ME is waiting for SIM PUK1 if PIN1 was
SIM PIN2 ME is waiting for PIN2, when the attempt to
SIM PUK2 ME is waiting for PUK2 to unblock a disabled
Phone security locks set by client or factory
PH-SIM PIN ME is waiting for phone-to-SIM card password if
PH-SIM PUK ME is waiting for Master Phone Code, if the
Factory set SIM locks
PH-FSIM PIN ME is waiting for phone-to-very-first-SIM card.
PH-FSIM PUK ME is waiting for phone-to-very-first-SIM card
needed.
disabled after three failed attempts to enter
PIN1.
access PIN2 requiring features was
acknowledged with +CME ERROR:17 (e.g. if
client attempts to edit the FD phonebook).
PIN2. Necessary if preceding command was
acknowledged with error +CME ERROR:18.
"PS" lock is active and user inserts other SIM
card than the one used for the lock. ("PS" lock is
also referred to as phone or antitheft lock).
above "PS" lock password was incorrectly
entered three times.
Necessary when "PF" lock was set. When
powered up the first time, ME locks itself to the
first SIM card put into the card holder. As a
result, operation of the mobile is restricted to this
one SIM card (unless the PH-FSIM PUK is used
as described below).
unblocking password to be given. Necessary
when "PF" lock is active and other than first SIM
card is inserted.
TC3X_ATC_01_V04.00 Page 96 of 204 29.05.2002
AT Command Set
Write command
AT+CPIN=<pin>
[,<new pin>]
Reference
GSM 07.07
PH-NET PIN ME is waiting for network personalisation
password
PH-NET PUK ME is waiting for network personalisation
unblocking password
PH-NS PIN ME is waiting for network subset personalisation
password
PH-NS PUK ME is waiting for network subset unblocking
password
PH-SP PIN ME is waiting for service provider
personalisation password
PH-SP PUK ME is waiting for service provider
personalisation unblocking password
PH-C PIN ME is waiting for corporate personalisation
password
PH-C PUK ME is waiting for corprorate personalisation
unblocking password
See Chapters 4.18 and 6.13 for information on lock types.
Response
The write command lets the ME store the entered password. This may be for
example the SIM PIN1 to register to the GSM network, or the SIM PUK1 to
replace a disabled PIN with a new one, or the PH-SIM PIN if the client has
taken precautions for preventing damage in the event of loss or theft etc. See
above for the list of passwords.
OK
If error is related to ME functionality:
+CME ERROR: <err>
If no PIN request is pending (for example if PIN authentication has been done
and the same PIN is entered again) ME responds +CME ERROR: operation notallowed. No action is required from your part.
Parameter
<pin>password (string type), usually SIM PIN1.
If the requested password was a PUK, such as SIM PUK1 or PHSIM PUK or PH-FSIM PUK or another password, then <pin> must
be followed by <newpin>.
<new pin> if the requested code was a PUK: specify a new password or
restore the former disabled password. See Chapter 4.31.1 for
more information about when you may need to enter the PUK.
Note
· Caution: After entering a password with AT+CPIN all other commands that
need access to data on the SIM card may be blocked for up to 20 seconds!
· Successful PIN authentication only confirms that the entered PIN was
recognized and correct. The output of the result code OK does not
necessarily imply that the mobile is registered to the desired network.
Typical example: PIN was entered and accepted with OK, but the ME fails
to register to the network. This may due to missing network coverage,
denied network access with currently used SIM card, no valid roaming
TC3X_ATC_01_V04.00 Page 97 of 204 29.05.2002
AT Command Set
agreement between home network and currently available operators etc.
The ME offers various options to verify the present status of network
registration: For example, the AT+COPS? (Chapter 4.26) command
indicates the currently used network. With AT+CREG (Chapter 4.37) you
can also check the current status and activate an unsolicited result code
which appears whenever the status of the network registration changes (e.g.
when the ME is powered up, or when the network cell changes).
· Wait 10 seconds after PIN input before using SMS related commands.
· <pin> and <new pin> can also be entered in quotation marks (e.g. ”1234”).
· To check the number of remaining to attempts to enter the passwords use
the AT^SPIC command. See Chapter 6.32.
· See also Chapter 7.2 „Summary of PIN requiring AT Commands“.
· See Chapters 4.34 and 6.36 for information on passwords.
TC3X_ATC_01_V04.00 Page 98 of 204 29.05.2002
AT Command Set
4.31.1 What to do if PIN or password authentication fails?
PIN1 / PUK1: After three failures to enter PIN 1, the SIM card is blocked (except for emergency
calls). To unblock the SIM card, the client needs to enter the associated PUK (= PIN
Unblocking Key / Personal Unblocking Key). After ten failed attempts to enter the
PUK, the SIM card will be invalidated and no longer operable. In such a case, the card
needs to be replaced.
To unblock a disabled PIN1, use the AT+CPIN command and enter the PUK when
prompted by the response +CME ERROR: 12. Alternatively, you can use the ATD
command followed by the GSM code **05*PUK*newPIN*newPIN#.
PIN2 / PUK2: PIN2 prevents unauthorized access to the features listed in Chapter 4.32. The
handling of PIN2 varies with the provider. PIN2 may either be a specific code supplied
along with an associated PUK2, or a default code such as 0000. In either case, the
client is advised to replace it with an individual code. Incorrect input of PUK2 will
permanently block the additional features subject to PIN2 authentification, but usually
has no affect on PIN1.
To unblock a disabled PIN2, use the AT+CPIN command and enter the PUK2 when
prompted by the response +CPIN: SIM PUK2 or after the equivalent error code: +CME
ERROR: 18 was returned. Alternatively, you can use the ATD command followed by
the GSM code **052*PUK*newPIN*newPIN#.
Phone lock: If the mobile was locked to a specific SIM card (= "PS" lock or phone lock), the PUK
that came with the SIM card cannot be used to remove the lock. After three failed
attempts to enter the correct password, ME returns +CPIN: PH-SIM PUK (= response
to read command AT+CPIN?), i.e. it is now waiting for the Master Phone Code. This is
an 8-digit device code associated to the IMEI number of the mobile which can only by
obtained from the manufacturer or provider. When needed, contact Siemens AG and
request the Master Phone Code of the specific module.
Please note that, in contrast to Siemens mobile phones, the GSM engines do not
support the option of sending the Master Phone Code with ATD and a
*#0003*<number># GSM code. Therefore, enter the Master Phone Code when
prompted after input of AT+CPIN. For instructions see the examples provided in
Chapter 4.18.2).
As an alternative, you can use the AT+CPWD command and specify a new password
for <fac>="PS". To do so, enter the Master Phone Code for <oldpwd> followed by
<newpwd>, where <newpwd> may be the former disabled "PS" password or a new
one (see examples in Chapters 4.18.2 and 4.34).
Usually, the Master Phone Code will be supplied by mail or e-mail. If the received
number is enclosed in the *# codes typically used for mobile phones, it is important to
crop the preceding *#0003* characters and the appended #.
Example: You may be given the string *#0003*12345678#. When prompted
for the PH-SIM PUK simply enter 12345678.
If incorrectly input, the Master Phone Code is governed by a specific timing algorithm:
(n-1)*256 seconds (see table below). The timing should be considered by system
integrators when designing an individual MMI.
Table 8: Timing algorithm of icorrect password input
Number of failed attempts Time to wait before next input is allowed
1st failed attempt No time to wait
2nd failed attempt 4 seconds
3rd failed attempt 3 * 256 seconds
4th failed attempt 4 * 256 seconds
5th failed attempt 5 * 256 seconds
6th failed attempt and so forth 6 * 256 seconds and so forth
TC3X_ATC_01_V04.00 Page 99 of 204 29.05.2002
AT Command Set
SIM locks: These are factory set locks, such as "PF", "PN", "PU", "PP", "PC". An 8-digit unlocking
code is required to operate the mobile with a different SIM card, or to lift the lock. The
code can only be obtained from the provider.
Failure to enter the password is subject to the same timing algorithm as the Master
Phone Code (see
Table 8).
Call barring: Supported modes are "AO", "OI", "OX", "AI", "IR", "AB", "AG", "AC". If the call barring
password is entered incorrectly three times, the client will need to contact the service
provider to obtain a new one.
Summary of related chapters: Related +CME errors are listed in Chapter 7.1.1. For further
instructions and examples see Chapters 4.18 (AT+CLCK Facility
lock), 6.13 (AT^SLCK Facility lock, 4.34 (AT+CPWD Change
password) and 6.36 (AT^SPWD Change password for a lock. A
complete list of **# codes is provided in Chapter 7.4.
TC3X_ATC_01_V04.00 Page 100 of 204 29.05.2002
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.