Siemens TC65 Terminal. Manual (Version: 02.000)

3.2 AT+CIND

3.2

AT+CIND Indicator control

The AT+CIND command controls the presentation of Indicator Event Reports related to various functions such

as battery charge level, signal quality, service availability, sound generation, indication of unread short mes-

sages, full SMS storage, call in progress or roaming activities.

Use of AT+CIND has become outdated. Rather we recommend the more powerful AT^SIND command which is

easier to use and provides additional indicators. All indicators provided by AT+CIND can be handled with

AT^SIND as well.

AT+CIND supports two ways to get the values related to indicators:

• One approach is to query the current status of each indicator by using the read command AT+CIND?. It

returns the status no matter whether the indicator has been registered with the write command

AT+CIND=[<mode>[,<mode>[,...]]].

• The other way is an event-driven notification based on the "+CIEV" URCs. In this case, the ME will automat-

ically send a message to the application, whenever the value of an indicator changes. The application should

be designed to react adequately when receiving a URC.

The presentation of these URCs depends on two settings:

- The indicators must be registered with the write command AT+CIND=[<mode>[,<mode>[,...]]]. When the

ME is switched on all of them are in registered mode. Any indicator can be excluded if deregistered with

<mode>=0. To register or deregister an indicator the AT+CIND write command requires to type the value

<mode>=1 or 0 exactly at the position where the indicator is located in the list. This is not necessary with

AT^SIND which allows to specify indicators by name. See examples below.

- The presentation of the registered indicators must be enabled with AT+CMER.

Syntax

Test Command

AT+CIND=?

Response(s)

+CIND: (<indDescr>, list of supported <indValue>s)[, (<indDescr>, list of supported <indValue>s)[,

...]]

Read Command

AT+CIND?

Response(s)

+CIND: <indValue>[, <indValue>[, ...]]

ERROR

+CME ERROR: <err>

Write Command

AT+CIND=<mode>[, <mode>[, ...]]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Parameter Description

<indValue>^(num)

Integer type value, which shall be in range of corresponding <indDescr>

Page 80 of 567

3.2 AT+CIND

<indDescr>^(str)

String values and their <indValue> ranges.

More indications are available via AT^SIND. Therefore use of AT^SIND for control of all indications is recom-

mended.

The following indications are accessible via AT+CIND:

"battchg"

Battery charge level 0..4 or 5 if no measuring is performed, e.g because no bat-

tery is connected. Also refer to AT^SBC.

"signal"

Signal quality (0..7)

The indicated value is the bit error rate of the signal received. Bit errors are esti-

mated values. See also AT+CSQ.

"service"

Service availability (0-1)

0: Not registered to any network

1: Registered to home network or, if "roam"=1 then registered to another net-

work

"sounder"

Sounder activity (0-1)

Reports every event that causes the ME to generate a tone.

Value 1 means for example:

Incoming call - ME is ringing. Note that the URC "+CIEV: sounder" will be out-

put only if ringing tones are activated with AT^SRTC.

Waiting call - ME generates waiting call tone (if call waiting is enabled).

Outgoing call - ME generates Call Progress tone.

Outgoing call - ME generates BUSY tone.

The value changes to 0 when the tone stops.

"message"

Unread short message at memory location <mem1> (0-1); refer to AT+CPMS

"call"

Call in progress (0-1). Indicator value is "1" if at least one call is in state "active"

or "held".

Depending on the parameter <succ> selected with AT^SCFG the indicator

"call" will be issued

• when a state transition ends in state "active" or state "unknown", if

<succ>="restricted",

• when any state transition (including transitions beginning or ending in state

"unknown") occurs in the list of active calls or when a traffic channel is

established, if <succ>="verbose".

Also refer to Section 7.1, Call Status Information.

"roam"

Roaming indicator (0-1)

0: Registered to home network or not registered

1: Registered to other network

"smsfull"

A short message memory storage in the MT has become full (1) or memory

locations are available (0), i.e. range is (0-1)

"rssi"

Received signal (field) strength (0..5)

0: signal strength <= -112 dbm

1-4: signal strength in 15 dbm steps

5: signal strength >= -51 dbm

Received signal (field) strength can also be obtained with AT+CSQ. However,

the signal strength is scaled to value range 0..31 by this command.

<mode>^(num)

Indicator is deregistered. The indicator will not be presented as "+CIEV" URC,

but can be queried with AT+CIND?.

[1]^(&F)(P)

Indicator is registered, indicator event report allowed.

Page 81 of 567

3.2 AT+CIND

Notes

• Due to its restrictive value range, indicator "call" does not clearly reflect specific call states (such as alerting,

active, held etc.), but rather serves to trigger the application to retrieve the new call status from the list of cur-

rent calls with the AT commands AT^SLCC, AT+CLCC or AT^SCNI.

• If AT^SCFG setting <succ>="verbose", indicator "call" will be issued also when a traffic channel is estab-

lished, or when a call enters states "terminating" or "dropped" (see Call Status Information).

In these cases, the relevant information about the cause of the display is available only from AT command

AT^SLCC.

Examples

EXAMPLE 1

^SYSSTART

AT+CPIN=9999

AT+CIND?

+CIND: 5,0,1,0,0,0,0,0

The battery is either full or no battery is connected to the ME. The bit

error rate of the signal quality is not available (since there is no call in

progress). The ME is registered to its home network.

AT+CMER=2,0,0,2

Now activate the Indicator Event Report with AT+CMER.

+CIEV: battchg,5

+CIEV: signal,0

+CIEV: service,1

+CIEV: sounder,0

+CIEV: message,0

+CIEV: call,0

+CIEV: roam,0

+CIEV: smsfull,0

+CIEV: rssi,5

Full receive signal strength.

ATD0123456;

Make a call.

+CIEV: sounder,1

A set of "+CIEV" URCs is received.

+CIEV: call,1

+CIEV: sounder,0

+CIEV: call,0

Called party hangs up.

NO CARRIER

AT+CIND=,,,0,,0

Deregister the indicators "sounder" and "call".

ATD0123456;

Dial the same call.

This time, no URCs are displayed.

NO CARRIER

Called party hangs up.

EXAMPLE 2

Deactivation of indicator "sounder" via AT+CIND

AT+CIND?

Query the current status of indicators.

+CIND: 5,0,1,0,1,0,0,0,4

AT+CIND=,,,0

To deactivate indicator "sounder" (= fourth item in list of indicators).

EXAMPLE 3

Deactivation of indicator "sounder" via AT^SIND

AT^SIND="sounder",0

To deactivate indicator "sounder".

^SIND: sounder,0,0

Page 82 of 567

3.3 AT^SIND

3.3

AT^SIND Extended Indicator Control

Designed for extended event indicator control AT^SIND

• offers greater flexibility than the standard command AT+CIND,

• offers several extra indicators,

• can show the current status of all indicators supported by AT+CIND and AT^SIND,

• can be used to register or deregister the indicators of both commands,

• displays all indicator event reports via "+CIEV" URCs.

Presentation mode of the generated URCs is controlled via AT+CMER.

The AT^SIND read command provides a list of all indicators supported by AT+CIND and AT^SIND. Each indica-

tor is represented with its registration mode and current value.

The AT^SIND write command can be used to select a single indicator in order to modify its registration and to

view the current value.

Syntax

Test Command

AT^SIND=?

Response(s)

^SIND: (<indDescr>, list of supported <indValue>s)[, (<indDescr>, list of supported <indValue>s)[,

...]], (list of supported <mode>s)

Read Command

AT^SIND?

Response(s)

^SIND: <indDescr>, <mode>, <indValue>

[^SIND: <indDescr>, <mode>, <indValue>]

ERROR

+CME ERROR: <err>

Write Command

AT^SIND=<indDescr>, <mode>

Response(s)

^SIND: <indDescr>, <mode>, <indValue>

In case of: <indDescr>="eons" and <mode>=2

^SIND: <indDescr>, <mode>, <indValue>, <eonsOperator>, <servProvider>

In case of: <indDescr>="nitz" and <mode>=2

^SIND: <indDescr>, <mode>, <nitzUT>, <nitzTZ>, <nitzDST>

ERROR

+CME ERROR: <err>

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3

Charge

Last

SIEMENS

Page 83 of 567

3.3 AT^SIND

Unsolicited Result Codes

URC 1

Format of the standard indicator:

+CIEV: <indDescr>, <indValue>

Value related to an indicator has changed.

URC 2

Format of the "adnread" indicator issued when accessing the ADN phonebook records stored on the SIM:

+CIEV: <indDescr>, <adnEntry>, <adnNumber>, <adnType>, <adnText>

+CIEV: <indDescr>, "READY"

One URC is issued for every used Abbreviated Dialing Number (ADN) phonebook record. After the last record

of the ADN phonebook was read, a URC with "READY" tag signals end of processing.

URC 3

Format of the Voice Message indicator, if the number of waiting messages is delivered by the network:

+CIEV: <indDescr>, <indValue>, <vmCounter>

If the number of waiting messages is not delivered the standard indicator applies.

URC 4

Format of the "eons" indicator:

+CIEV: <indDescr>, <indValue>, <eonsOperator>, <servProvider>

One URC is issued for each new LAI (Location Area Information) broadcast by the network.

URC 5

Format of the "nitz" indicator:

+CIEV: <indDescr>, <nitzUT>, <nitzTZ>, <nitzDST>

Parameter Description

<indDescr>^(str)

String values and their <indValue> ranges.

All indicators supported by AT+CIND are accessible with this command, too. A detailed description of these indi-

cators can be found there.

The following indicators are accessible via AT^SIND only:

"audio"

Activity of the built-in audio unit.

Audio unit not active.

Audio unit is active, for example:

MO voice call: Indicator is output with value 1 when dialing starts.

MT voice call: Indicator is output with value 1 when call is ringing.

MO / MT voice call established: Indicator shows value 1.

Incoming fax and data calls: The "audio" indicator shows value 1 while

call is ringing, and reverts to 0 after call was accepted with ATA.

"vmwait1"

Voice Message Waiting Indication for line 1

The value 0 notifies that no new voice message is available, and is pro-

vided by the service center to clear the voice message indication after

the subscriber has retrieved all voice messages.

The value 1 notifies the subscriber that the mailbox contains one or

several messages.

"vmwait1" and "vmwait2" indicate the receipt of a special short message with

a Voice Message Waiting Indicator. The service must be provisioned by the

operator.

The numbers 1 or 2 in "vmwait1" and "vmwait2" are related to the two lines of

the Alternate Line Service (ALS), also defined in CPHS Phase 2 standard. For

further details refer to the AT^SALS command.

Page 84 of 567

3.3 AT^SIND

The presentation mode of the indicator varies with the operator: If more than

one message are waiting, some operators only indicate the first one, others

deliver the indicator each time a new voice message is put into the mailbox.

After the subscriber has retrieved all voice messages the service center auto-

matically sends another message indication which provides the value 0.

Some operators may also send the number of waiting voice messages along

with the indication. In this case, the number will be displayed by the TC65 as

part of the URC. For example, "+CIEV: vmwait1,1,5" notifies that five new voice

messages are waiting. However, it should be noted that neither the read com-

mand AT^SIND? nor the write command AT^SIND=<mode>,2 display the

number of waiting messages.

The "vmwait" indicators do not apply if a network provider signals new voice

mail(s) via standard SMS. In this case the indicator "message" will be displayed

(see AT+CIND).

"vmwait2"

Voice Message Waiting Indication for line 2

See description of "vmwait1".

"ciphcall"

Ciphering Status Change Indication

Current call or SMS is not ciphered.

Current call or SMS is ciphered.

As stated in GSM specifications 02.07 and 02.09 the ciphering indicator feature

allows the TC65 to detect that ciphering is not switched on and to indicate this

to the user.

The ciphering indicator feature may be disabled by the home network operator

setting data in the "administrative data" field (EF_AD) in the SIM, as defined in

GSM 11.11.

If this feature is not disabled by the SIM, then whenever a connection is in

place, which is, or becomes unenciphered, an indication shall be given to the

user. This enables the user's decision how to proceed.

Read command returns valid ciphering status only if a call is in progress or

active.

If EF_AD setting disables the ciphering indicator feature read command always

indicates a ciphered link and no URC presentaion will take place.

The following restrictions apply if the same serial channel is used for AT^SIND

"ciphcall" indication and for the action triggering this URC. In general, the rec-

ommended solution is to use a dedicated channel for all status signalling via

URCs.

• If an unciphered mobile originated SMS is performed, AT^SIND "ciphcall"

URCs on the same serial channel will be issued after the related "OK" and

indicate the ciphering state at this time.

• If an unciphered mobile originated data call is performed, AT^SIND "ciph-

call" URCs on the same serial channel will be issued after the interface is

not longer blocked by the call (call is released or temporarily stopped) and

indicate the ciphering state at this time.

"adnread"

Abbreviated Dialing Number (ADN) Phonebook Read Indication

Phonebook reading is not finished.

Phonebook reading is finished.

Every time after entering the AT+CPIN the module starts reading the ADN

phonebook. This can be used to enable the TE to output the phonebook

records as URCs. The advantage is that the user does not need to wait until

the phonebook read command AT+CPBR is accessible after entering the SIM

PIN (depending on the SIM card this may take up to 30 seconds without RSA

or 2 minutes with RSA).

If <mode>=1 all used ADN phonebook records stored on the SIM will be output

as URCs after SIM PIN authentication has been performed successfully. A

URC with "READY" tag issued at the end of the list indicates that TC65 has fin-

ished reading the phonebook.

Note that the settings of AT^SIND and AT+CMER will be restored to their default

Page 85 of 567

3.3 AT^SIND

values when restarting the TC65. Therefore it is recommended that the set-

tings be enabled before entering the SIM PIN. This can be done, for example,

after rebooting the TC65.

"eons"

Enhanced Operator Name String (EONS) Indication

The Enhanced Operator Name String indicator feature allows the TC65 to out-

put various operator names for different PLMN identities via URC. It also allows

the output of a different operator name based on a subset of the registered net-

work by using a range of Location Area Codes (LACs) or a single LAC.

The presentation of the "eons" indicator is determined by network activity. For

example, the indicator appears every time a location update occurs or a NITZ

information is sent, no matter whether or not the status of the EONS informa-

tion has changed. This means that the same EONS information may be

reported several times.

The EONS tables are stored in the SIM card and will be read at power-up.

Following are the SIM Elementary Files that are affected by the introduction of

EONS feature in the SIM card:

EF_SST (SIM Service Table) - describes which features are active.

EF_OPL (Operator PLMN List) - contains the PLMN identification and location ID

together with the index of the corresponding PNN record

EF_PNN (PLMN Network Name) - contains the full and short form version of the

network name for the registered PLMN

If the Operator Name Source is CPHS Operator Name String long and short

form, refer to <indValue>, the following two SIM Elementary Files will be

used:

EF_ONString (Operator Name String) - contains the name of the PLMN operator

who issued the SIM.

EF_OPShort (Operator Name Short form) - contains a short form of the name of

the PLMN operator who issued the SIM.

"nitz"

Network Identity and Time Zone indication

This indicator shows the time relevant information elements of an MM Informa-

tion (MMI) or GMM Information (GMMI) message received from the network

(see GSM 24.008, ch. 9.2.15a and 9.4.19). The network usually sends a NITZ

indicator when the mobile attaches to the network, when it enters a location

area with different time zone or when a daylight change occurs.

A NITZ indicator may consist of the following parameters: Universal Time (UT),

local Time Zone (TZ), Daylight Saving Time (DST). All information elements of

MMI/GMMI are optional and therefore, the presentation of the parameters

<nitzUT>, <nitzTZ>, <nitzDST> varies with the network. For example, the

network may send all three parameters UT, TZ, DST, or only UT and TZ or only

TZ.

UT is indicated in usual date/time format and represents the current world time

(GMT) at the moment when sent.

TZ is given as a positive (east) or negative (west) offset from UT in units of 15

minutes.

DST shows the number of hours added to the local TZ because of daylight sav-

ing time (summertime) adjustment. Usually DST is 1 hour but it can be also 2

hours in certain locations.

Example for time and time zone with DST:

+CIEV: nitz,"04/07/23,13:39:20",-28,1

In this example TZ is -28, showing a time offset of -7 hours (west) to Universal

Time/GMT (which never changes for DST). DST is 1 which indicates that one

hour was added to TZ because of Daylight Saving Time. If a network does not

send the DST parameter the TZ value would be -32 (8 hours west) as would

be done in winter:

+CIEV: nitz,"04/11/23,13:39:20",-32

Please be aware that despite the last NITZ value can be looked up again via

"AT^SIND=nitz,2" the returned values may be out of date. Especially the UT

Page 86 of 567

3.3 AT^SIND

value is obsolete because there is no internal NITZ clock and therefore no con-

tinuation of UT.

NITZ values are lost when the module detaches from network. Also when a

manual network selection fails and the module automatically falls back to the

previous network the NITZ values cannot be recalled. Nevertheless an indi-

cated time zone is valid until a new MMI/GMMI will trigger another NITZ indi-

cation.

"simstatus"

SIM Status Indication

The SIM Status indicator allows the TC65 to output the status of the subscriber

identity module (SIM) via URC.

SIM card removed.

Note: Another way to verify the SIM card connection is the "^SCKS"

URC enabled with AT^SCKS. For use after restart, its presentation

mode can be stored to the user profile with AT&W.

SIM card inserted.

SIM PIN1 not required - SIM card unlocked. TC65 automatically regis-

ters to the GSM network without requesting SIM PIN1.

SIM PIN1 required - SIM card locked. SIM PIN1 must be entered to

enable TC65 to register to the GSM network.

Personalization info ready - CHV (Card Holder Verification) data have

been verified (if required).

SIM initialization completed - ME has finished reading SIM data.

Note: Another way to notify the user when SIM data are accessible is

the "^SSIM READY" URC enabled with AT^SSET. For use after restart,

its presentation mode can be stored to the user profile with AT&W.

"band"

Currently selected frequency band or band combination.

1...14

Identical with <rbc> of AT^SCFG. The value indicates the band(s) cur-

rently available for network selection, depending on the network config-

uration either a single band or a dualband combination. The URC

appears whenever the status of the currently available band(s)

changes, for example after using the AT^SCFG command to change

the "Radio/Band" parameters <rba> or <rbp>. Please see AT^SCFG

for further detail about the feature "Radio/Band" selection.

(num)

Integer type value in the range stated above for the corresponding <indDescr>.

Notes specific to the EONS feature:

If the indicator is "eons", the <indValue> is a type associated to the operator name according to GSM 22.101

[27]. This type depends on the source of the operator name.

Priority of types associated to the operator names is defined as follows (the type listed first has the highest pri-

ority). If a type cannot be indicated the next one will be used.

Not registered.

EF-OPL and EF-PNN (alphanumeric format, can contain up to 24 characters.)

Operator Name String in long and short format according to Common PCN

Handset Specification (CPHS) [28] (alphanumeric format, can contain up to 16

characters).

Name information received by the NITZ service long and short form (alphanu-

meric format, can contain up to 16 characters). The short form will be displayed

only if EF_OPShort from CPHS is available.

Any operator name stored internal to the ME (alphanumeric format, can con-

tain up to 16 characters).

Broadcast MCC-MNC (numeric format which consists of a 3-digit country code

plus a 2- or 3-digit network code).

The name information received by the NITZ service (type 3) will be saved in the non-volatile RAM. It replaces

the operator name of the registered PLMN (type 4) or its numeric form (type 5) stored in the ME. However, when

after restart the ME registers to another PLMN that is not equal to the saved NITZ name information, the NITZ

name information must be invalidated.

If the type is 2, 4 or 5, AT+COPS with the appropriate <mode> displays the same operator name.

Page 87 of 567

3.3 AT^SIND

<mode>^(num)

Indicator is deregistered, i.e. no such indicator event report (URC) will be

issued. <mode>=0 is power-up and factory default of indicators defined by

AT^SIND only.

Indicator is registered.

• Indicator event reports are controlled via AT+CMER.

• All indicators can be registered or deregistered via AT^SIND, but different

default settings apply: Power-up and factory default of the indicators sup-

ported by AT+CIND is <mode>=1, while, as stated above, indicators defined

by AT^SIND only are set to <mode>=0.

Query the registration status and the current value of a single indicator type.

<adnEntry>^(num)

ADN phonebook record number on the SIM.

<adnNumber>^(str)

Phone number, for further details see AT+CPBR.

<adnType>^(num)

Address type, for further details see AT+CPBR.

145

Dialing string <adnNumber> includes international access code character '+'.

209

Dialing string <adnNumber> contains printable non-alphabetic non-digit char-

acters saved with the number string.

129

otherwise

<adnText>^(str)

Text assigned to a phone number. For further details see AT+CPBR.

If delivered by the network: Number of new voice messages sent as part of the Voice Message Waiting Indicator.

Refer to <indDescr>.

Operator in format which depends on the type associated to the operator name. Refer to <indValue>.

<servProvider>^(str)

Service Provider Name according to the status settings (SIM Service No. 17) in the SIM Service Table (SST) of

the SIM.

Universal Time delivered as part of the "nitz" Indicator. Refer to <indDescr>.

Time Zone delivered as part of the "nitz" Indicator. Refer to <indDescr>.

Adjustment for Daylight Saving Time as part of the "nitz" Indicator. Refer to <indDescr>.

Page 88 of 567

3.4

AT+CEER Extended Error Report

AT+CEER returns an extended error report regarding the reason of the last

• call release

• failure to set up a call (both mobile originated or terminated)

• failure to modify a call by using Supplementary Services

• failed attempt to activate, register, query, deactivate or deregister a Supplementary Service

• unsuccessful GPRS attach or unsuccessful PDP context activation

• GPRS detach or PDP context deactivation

The release cause report is presented in numeric format. Default output in case of a none-error-situation is

+CEER: 0,0,0. A description associated with each number can be found in the tables given in the following sub-

clauses and the relevant GSM specifications.

The first parameter <locationID> serves to locate the other two parameters. Depending on the failure or

release cause either <reason> or <ssRelease> are applicable, i.e. if <reason> ≠ 0, then <ssRelease> = 0.

Vice versa, if <reason> = 0, then <ssRelease> may be ≠ 0.

In addition to AT+CEER, the command ATS18 can be used to check especially the status of fax and data calls.

Syntax

Test Command

AT+CEER=?

Response(s)

ERROR

+CME ERROR

Exec Command

AT+CEER

Response(s)

+CEER: <locationID>, <reason>, <ssRelease>

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Parameter Description

<locationID>^(num)

Location ID as number code. Location IDs are listed in Section 3.4.1, Cause Location ID for the extended error

report. Each ID is related with another table that contains a list of <reason>s or <ssRelease>s.

<reason>^(num)

Reason for last call release as number code. The number codes are listed in several tables, sorted by different

categories in the following subclauses. The tables can be found proceeding from the Location ID given in Sec-

tion 3.4.1, Cause Location ID for the extended error report.

<ssRelease>^(num)

Release cause for last Supplementary Service call (listed in Section 3.4.9, GSM Release cause for Supplemen-

tary Service Call)

Page 90 of 567

Examples

EXAMPLE 1

ATD"01751223344";

A mobile originated call is rejected by the remote party.

NO CARRIER

Call setup is terminated with NO CARRIER.

AT+CEER

To check the cause, the caller enters AT+CEER.

+CEER: 8,21,0

The Location ID 8 in Section 3.4.1 points to Section 3.4.7, where 21 =

"Call rejected". 0 = "No error" refers to parameter <ssRelease> that is

not applicable.

EXAMPLE 2

The user attempts to activate call barring, but uses a wrong password.

AT+clck=oi,1,"0000",3

+CME ERROR: incorrect password

AT+CEER

+CEER: 35,0,38

The Location ID 35 in Section 3.4.1 points to Section 3.4.9, where 38 =

"NegativePWCheck" may mean that a wrong password was tried for the

first time. 0 = "No error" refers to parameter <reason> that is not appli-

cable.

3.4.1

Cause Location ID for the extended error report

Description

No error (default)

SIEMENS L2 cause

GSM cause for L3 Radio Resource Sublayer (GSM 04.08 annex F)

SIEMENS cause for L3 Radio Resource Sublayer

GSM cause for L3 Mobility Management (GSM 04.08 annex G)

SIEMENS cause for L3 Mobility Management

GSM cause for L3 Mobility Management via MMR-SAP (GSM 04.08 annex G)

GSM cause for L3 Call Control (GSM 04.08 10.5.4.11 and annex H)

SIEMENS cause for L3 Call Control

GSM cause for L3 SMS CP Entity

SIEMENS cause for L3 SMS CP Entity

GSM cause for L3 SMS RL Entity

GSM cause for L3 SMS TL Entity

SIEMENS cause for L3 SMS TL Entity

GSM cause for L3 Call-related Supplementary Services

SIEMENS cause for L3 Call-related Supplementary Services

SIEMENS cause for Supplementary Services Manager

Network cause for Supplementary Services (GSM 04.08 10.5.4.11 and annex H)

Supplementary Services network error (GSM 04.80 3.6.6)

GSM cause for GPRS Mobility Management (GSM 04.08 annex G.6)

SIEMENS cause for GPRS Mobility Management

GSM cause for Session Management (GSM 04.08 annex I)

127

SIEMENS cause for protocol module or other local cause

128

Supplementary Services general problem (GSM 04.80 3.6.7)

Page 91 of 567

Description

129

Supplementary Services invoke problem (GSM 04.80 3.6.7)

130

Supplementary Services result problem (GSM 04.80 3.6.7)

131

Supplementary Services error problem (GSM 04.80 3.6.7)

241

SIEMENS cause for GPRS API

243

SIEMENS cause for PPP/IP-Stack

3.4.2

SIEMENS L2 cause

Number

Description

249

L2 Error

3.4.3

GSM release cause for L3 Radio Resource (RR)

Number

Description

Normal event

Abnormal release, unspecified

Abnormal release, channel unacceptable

Abnormal release, timer expired

Abnormal release, no activity on the radio path

Pre-emptive release

Handover impossible, timing advance out of range

Channel mode unacceptable

Frequency not implemented

Call already cleared

Semantically incorrect message

Invalid mandatory information

Message type non-existent or not implemented

Message type not compatible with protocol state

100

Conditional information element error

101

No cell allocation available

111

Protocol error unspecified

3.4.4

SIEMENS release cause for L3 Radio Resource (RR)

Number

Description

Racchs not answered

Racchs rejected

Access class of the SIM is barred by the network provider

SABM failure

Radio link counter expiry or PerformAbnormalRelease

Page 92 of 567

Number

Description

Confirm ABORT of the MM

Respond to DEACT REQ

Loss of coverage

Reestablishment not possible

T3122_STILL_RUNNING

CELL_SELECTION_IN_PROGRESS

RESPONDING_TO_PAGING

LOCATION_AREA_CODE_HAS_CHANGED

CIRCUIT_SWITCHED_NOT_AVAILABLE

3.4.5

GSM release cause for Mobility Management (MM) or Session

Management (SM)

Number

Description

Causes related to MS identification

IMSI unknown in HLR

Illegal MS

IMSI unknown in VLR

IMEI not accepted

Illegal ME

Cause related to subscription options

PLMN not allowed

Location Area not allowed

Roaming not allowed in this location area

Causes related to PLMN specific network failures and congestion

Network failure

Congestion

Causes related to nature of request

PDP context is deactivated because of a LLC or SNDCP failure

Service option not supported

Requested service option not subscribed

Service option temporarily out of order

Call cannot be identified

Causes related to invalid messages

Semantically incorrect message

Invalid mandatory information

Message type non-existent or not implemented

Message not compatible with protocol state

Information element non-existent or not implemented

100

Conditional information element error

101

Messages not compatible with protocol state

Page 93 of 567

Number

Description

111

Protocol error, unspecified

Causes related to GPRS

GPRS services not allowed

GPRS services not allowed in combination with non-GPRS services

MS identity cannot be identified by the network

Implicitly detached

GPRS services not allowed in current PLMN

MSC temporarily unreachable

3.4.6

SIEMENS release cause for L3 Mobility Management (MM)

Number

Description

No SIM available

No MM connection

Authentification failure

MM performs detach

Registration failed and will be re-attempted in a short term

CM connection establishment failed

Registration failed and will be re-attempted in a long term

RR connection is released

MS tries to register

SPLMN is not available

An MTC is in progress

A PLMN scan is in progress

The MM is detached, the MS is in MS class C GPRS only

The maximum numbers of CM connections is exceeded

The MM is not registered

The MM state is incompatible

3.4.7

GSM release cause for L3 Call Control (CC)

Number

Description

Normal class

Unassigned (unallocated) number

No route to destination

Channel unacceptable

Operator determined barring

Normal call clearing

User busy

No user responding

Page 94 of 567

Number

Description

User alerting, no answer

Call rejected

Number changed

Pre-emption

Non-selected user clearing

Destination out of order

Invalid number format (incomplete number)

Facility rejected

Response to STATUS ENQUIRY

Normal, unspecified

Resource unavailable class

No circuit/channel available

Network out of order

Temporary failure

Switching equipment congestion

Access information discarded

Requested circuit/channel not available

Resource unavailable, unspecified

Service or option not available class

Quality of service unavailable

Requested facility not subscribed

Incoming calls barred within the CUG

Bearer capability not authorized

Bearer capability not presently available

Service or option not available, unspecified

Service or option not implemented

Bearer service not implemented

ACM equal or greater than ACMmax

Requested facility not implemented

Only restricted digital information bearer capability is available

service or option not implemented, unspecified

Invalid message (e.g. parameter out of range) class

Invalid transaction identifier value

User not member of CUG

Incompatible destination

Invalid transit network selection

Semantically incorrect message

Protocol error (e.g. unknown message) class

Invalid mandatory information

Message type non-existant or not implemented

Message type not comaptible with protocol state

Information element non-existent or not implemented

Page 95 of 567

Number

Description

100

Conditional information element error

101

Message not compatible with protocol

102

Recovery on timer expiry

111

Protocol error, unspecified

Interworking class

127

Interworking, unspecified

3.4.8

SIEMENS release cause for L3 Call Control (CC)

Number

Description

Service not available

Hold procedure not available

Temporary no service, previous procedure not yet finished

Mobile received a release (complete) message during a modify procedure (modify reject)

Number not included in FDN list

Notifications

300

Called party barred incoming call

3.4.9

GSM Release cause for Supplementary Service Call

Number

Description

No error (default)

UnknownSubscriber

IllegalSubscriber

BearerServiceNotProvisioned

TeleserviceNotProvisioned

IllegalEquipment

CallBarred

CUGReject

IllegalSSOperation

SSErrorStatus

SSNotAvailable

SSSubscriptionViolation

SSIncompatibility

FacilityNotSupported

AbsentSubscriber

ShortTermDenial

LongTermDenial

SystemFailure

DataMissing

Page 96 of 567

Number

Description

UnexpectedDataValue

PWRegistrationFailure

NegativePWCheck

NumberOfPWAttemptsViolation

UnknownAlphabet

USSDBusy

126

MaxNumsOfMPTYCallsExceeded

127

ResourcesNotAvailable

General Problem Codes

300

Unrecognized Component

301

Mistyped Component

302

Badly Structured Component

Invoke Problem Codes

303

Duplicate Invoke ID

304

Unrecognized Operation

305

Mistyped Parameter

306

Resource Limitation

307

Initiating Release

308

Unrecognized Linked ID

309

Linked Response Unexpected

310

Unexpected Linked Operation

Return Result Problem Codes

311

Unrecognize Invoke ID

312

Return Result Unexpected

313

Mistyped Parameter

Return Error Problem Codes

314

Unrecognized Invoke ID

315

Return Error Unexpected

316

Unrecognized Error

317

Unexpected Error

318

Mistyped Parameter

3.4.10

GSM release cause for Session Management (SM)

Number

Description

102

Recovery on timer expiry

Page 97 of 567

3.5 ATS18

3.5

ATS18

Extended call release report

ATS18 controls the presentation of extended call release reports for circuit switched fax and data calls. Extended

call release reports related to voice calls are controlled via AT+CEER.

The call release report is presented in numeric format and shows as follows:

+CAUSE: <locationID>:<reason>

If enabled the message will be reported every time a fax or data call is released or fails to be established.

Syntax

Read Command

ATS18?

Response(s)

<n>

Write Command

ATS18=<n>

Response(s)

ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

V.250

Parameter Description

<n>^{(num)(&W)(&V)}

An odd number enables the presentation of the extended call release report. Any even number disables this

feature.

0^(&F)...255

<locationID>^(num)

Location ID as number code, see also <locationID> of AT+CEER.

Location IDs are listed in Section 3.4.1, Cause Location ID for the extended error report. Each ID is related to

another table that contains a list of <reason>s.

<reason>^(num)

Reason for last call release as number code (see also <reason> of AT+CEER).

<reason> numbers and the associated descriptions are listed in several tables, sorted by different categories

at AT+CEER. The tables can be found proceeding from the Location IDs listed in Section 3.4.1, Cause Location

ID for the extended error report.

Page 99 of 567

4. Serial Interface Control Commands

Serial Interface Control Commands

The AT Commands described in this chapter allow the external application to determine various settings related

to the TC65's serial interface.

4.1

AT\Q Flow control

Syntax

Exec Command

AT\Q[<n>]

Response(s)

If RTS/CTS flow control is not supported by interface and <n> is 2 or 3:

ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

SIEMENS

Parameter Description

<n>^{(num)(&W)(&V)}

[0]^(&F)

Disable flow control

XON/XOFF software flow control

Only CTS by DCE (TA)

RTS/CTS hardware flow control

Recommended for the following procedures: incoming or outgoing data calls,

fax calls, MUX mode.

Often, the initialization routine of Fax programs includes enabling RTS/CTS

handshake, eliminating the need to issue AT\Q3 once again.

Notes

• When using XON/XOFF flow control (AT\Q1) in online mode, +++ should not be used while the data trans-

mission is paused with XOFF. Before entering the command mode with +++ the paused transmission should

be resumed using the XON character.

• For compatibility reasons, the AT\Q command can be used in Multiplex mode, though the settings will not

take effect. However, be aware that whenever you use the AT\Q write command in Multiplex mode and then

save the current configuration to the user profile with AT&W, the changed AT\Q setting will become active after

restart.

• With AT+IFC, flow control can be set separately for each data direction, while AT\Q applies to both directions.

The two commands influence each other, i.e. settings made with AT\Q apply to AT+IFC and, vice versa,

AT+IFC changes the AT\Q setting.

Page 103 of 567

4.2 AT&C

4.2

AT&C Set Data Carrier Detect (DCD) Line mode

The AT&C command determines how the state of the DCD line (circuit 109) reflects the TC65's internal activity.

Syntax

Exec Command

AT&C[<value>]

Response(s)

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

V.250 , SIEMENS

Parameter Description

<value>^{(num)(&W)(&V)}

[0]

DCD line shall always be on.

1^(&F)

DCD line shall be on only when data carrier signal is present.

DCD line shall be on when one or more Internet services defined on the related

serial channel are in state "Connecting" or "Up" as described below. For details

on the various service states refer to AT^SISI, parameter <srvState> or

AT^SISO, parameter <srvState>.

• SOCKET, HTTP, SMTP, POP3: DCD shall be on when

<srvState>="Connnecting" or "Up"

• FTP: DCD shall be on when data channel is connected, i.e.

<srvState>="Up"

Page 104 of 567

4.6 AT+ICF

4.6

AT+ICF Serial Interface Character Framing

The command AT+ICF controls the serial interface character framing format and parity used for receiving and

transmitting.

The following settings are supported:

•

7 bits, even parity, 1 stop bit (AT+ICF=5,1)

•

7 bits, odd parity, 1 stop bit (AT+ICF=5,0)

•

8 bits, even parity, 1 stop bit (AT+ICF=2,1)

•

8 bits, no parity, 1 stop bit (AT+ICF=3)

•

8 bits, odd parity, 1 stop bit (AT+ICF=2,0)

•

8 bits, no parity, 2 stop bits (AT+ICF=1)

Syntax

Test Command

AT+ICF=?

Response(s)

+ICF: (list of supported <format>s), (list of supported <parity>s)

Read Command

AT+ICF?

Response(s)

+ICF: <format>[, <parity>]

Write Command

AT+ICF=[<format>[, <parity>]]

Response(s)

ERROR

Reference(s)

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

V.250

Parameter Description

<format>^{(num)(&W)(&V)}

Specifies the character format used for receiving and transmitting.

8 data 0 parity 2 stop

8 data 1 parity 1 stop

3^(D)

8 data 0 parity 1 stop

7 data 1 parity 1 stop

<parity>^{(num)(&W)(&V)}

Specifies the method of calculating the parity bit, if a parity bit is supported by <format>.

If <format> does not support parity, this parameter has to be omitted.

odd

even

Page 108 of 567

4.6 AT+ICF

Notes

• If AT+ICF modes 7E1 or 7O1 are set, the parity bit will by default not be transmitted over the air. If the remote

party expects the parity bit to be transmitted, additional settings are required via AT^STPB.

• When using a bit rate of 300 bps there must be a delay of 500ms before entering the next command. At bit

rates of 1200 bps the delay must be 300ms. For higher bit rates use of the default delay is sufficient.

• TC65's autobaud feature detects the bit rate currently used by the TE. However, this detection suffers some

limitations described in Section 4.9.1, Autobauding. If autobauding is enabled, the AT+ICF read command

does not show the current character framing, but the character framing that will be used when autobauding

is disabled.

• For compatibility reasons, the command can be used in Multiplex mode, though the settings will not take

effect. Please note that changes made on multiplex channel 1 will be saved with AT&W and will become active

when restarting the ME after AT^SMSO.

• To start the multiplexer it is necessary to set the character framing to 8 bits, no parity and 1 stop bit.

• If a <format> is selected without parity (e.g. <format>=3) and you try to activate a format with parity (e.g.

<format>=2), you need to explixitly set the parameter <parity> (e.g. AT+ICF=2,1). Otherwise you will get

'+CME ERROR: invalid index'. This is because for <format>=3, the parameter <parity> is set to the inter-

nal value 'no parity' which is not supported by <format>=2. (Remember that if an optional parameter is omit-

ted for which no default is stated in this specification, the value of the parameter remains unchanged).

Page 109 of 567

4.7 AT+IFC

4.7

AT+IFC Set Flow Control separately for data directions

The command AT+IFC can be used to set or query the data flow control separately for each data direction. In

contrast to this, flow control settings made with AT\Q are valid in both data directions.

Syntax

Test Command

AT+IFC=?

Response(s)

+IFC: (list of supported <TEflowcontrol>s), (list of supported <TAflowcontrol>s)

Read Command

AT+IFC?

Response(s)

+IFC: <TEflowcontrol>, <TAflowcontrol>

Write Command

AT+IFC=<TEflowcontrol>, <TAflowcontrol>

Response(s)

ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3

Charge

Last

V.250

Parameter Description

<TEflowcontrol>^(num)(&W)

Specifies the method used by the TE when receiving data from the TA.

[0]^(&F)

none

XON/XOFF, terminate flow control in the Cellular Engine

RTS line

XON/XOFF, evaluate flow control in the Cellular Engine and pass it through

(over the air) to the opposite TE

<TAflowcontrol>^(num)(&W)

Specifies the method used by the TA when receiving data from the TE.

[0]^(&F)

none

XON/XOFF

CTS line

Page 110 of 567

4.8 AT+ILRR

4.8

AT+ILRR Set TE-TA local rate reporting

The command AT+ILRR controls whether or not the intermediate result code "+ILRR" is transmitted from the TA

to the TE while a connection is being set up. The result code indicates the local rate. It is issued before the final

result code of the connection, e.g. CONNECT, is transmitted to the TE.

Syntax

Test Command

AT+ILRR=?

Response(s)

+ILRR: (list of supported <value>s)

Read Command

AT+ILRR?

Response(s)

+ILRR: <value>

Write Command

AT+ILRR=<value>

Response(s)

ERROR

+CME ERROR

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

V.250

Intermediate Result Code

+ILRR: <rate>

Indicates local port rate setting upon connection setup.

Parameter Description

<value>^{(num)(&W)(&V)}

0^(&F)

Disables reporting of local port rate

Enables reporting of local port rate

<rate>^(num)

Port rate setting upon connection setup (bps)

Autobauding (see Section 4.9.1, Autobauding). Not supported on ASC1. Not

usable with Java.

300

600

1200

2400

4800

9600

Page 112 of 567

4.9 AT+IPR

4.9

AT+IPR Set fixed local rate

The command AT+IPR can be used to set or query the TE-TA interface bit rate.

Syntax

Test Command

AT+IPR=?

Response(s)

+IPR: (list of supported auto-detectable <rate>s) , (list of supported fixed-only <rate>s)

Read Command

AT+IPR?

Response(s)

+IPR: <rate>

Write Command

AT+IPR=<rate>

Response(s)

ERROR

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3

Charge

Last

V.250

Command Description

The test command returns the values of the supported automatically detectable bit rates and the values of the

supported fixed bit rates.

The read command returns the current bit rate of the interface.

The write command specifies the bit rate to be used for the interface. When you set a fixed-rate, make sure that

both TE (DTE) and TA (DCE) are configured to the same rate.

The setting is stored in the non-volatile memory and will be used whenever the engine is powered up again. How-

ever, in case of autobaud mode (AT+IPR=0) the detected TA bit rate will not be saved and, therefore, needs to

be resynchronized after restarting the GSM engine (see Section 4.9.1, Autobauding).

Parameter Description

<rate>^(num)(&V)

bit rate per second (bps)

Activates autobauding. Not supported on ASC1. Not usable with Java. See

Section 4.9.1, Autobauding for further details.

300

600

1200

2400

4800

9600

14400

Page 114 of 567

4.9 AT+IPR

19200

28800

38400

57600

115200

230400

460800

Notes

• Delivery value for <rate> is autobauding enabled (AT+IPR=0) on ASC0 and 115200bps on ASC1. It will not

be restored with AT&F.

• The current setting of AT+IPR will be preserved when you download firmware (i.e. a firmware update does

not restore the factory setting) or in the event of power failure.

• Generally, AT+IPR should be used as a standalone command. If nethertheless combinations with other com-

mands on the same command line cannot be avoided, there are several constraints to be considered:

- Avoid combinations with the AT commands listed in Section 1.4.2, Combining AT commands on the same

command line.

- Take into account, that a pause of 100ms is required between the response to the last command (e.g. OK)

and the next command.

- 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 with the new bit rate and thus, not properly transmitted. The following commands

will be correctly sent at the new bit rate.

• In order to account for greater amounts of data it is recommended to choose a minimum bit rate of 2400 bps.

If the ME shall be operated in Multiplex mode we suggest a minimum bit rate of 4800bps.

• In Multiplex mode, the write command AT+IPR=<rate> will not change the bit rate currently used, but the

new bit rate will be stored and becomes active, when the module is restarted.

• A selected bit rate takes effect after the write commands returns OK.

• If Java is running, the firmware will ignore any settings made with AT+IPR. Responses to the read, write or

test command will be invalid or deliver "ERROR". See also "TC65 Java User's Guide" [4], Section "Configur-

ing serial interface".

4.9.1

Autobauding

To take advantage of autobaud mode specific attention must be paid to the following requirements:

• Synchronization between TE and TA:

Ensure that TE and TA are correctly synchronized and the bit rate used by the TE is detected by the TA. To

allow the bit rate to be synchronized simply use an "AT" or "at" string. This is necessary 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.

• Restrictions on autobauding operation:

- If you switch to autobaud mode using AT+IPR=0, then autobauding is not directly active as soon as the

AT+IPR command ends. Instead the old bitrate is still active. The autobaud mode is activated with the next

restart of the module. This is indicated by any following AT+IPR read command which still returns the old

baudrate until the next restart.

- The serial interface shall be used with 8 data bits, no parity and 1 stop bit (factory setting), e.g. 2 stop bits

are not supported for autobaud mode.

- The command A/ cannot be used.

- Only the first "AT" or "at" after restart of the module can be detected (neither "At" nor "aT"). This means

that all the AT commands have to use the same bit rate.

Page 115 of 567

4.9 AT+IPR

- The second serial interface ASC1 does not support autobauding.

- If autobauding is enabled you cannot activate multiplex mode, see AT+CMUX.

- Autobauding cannot be used if the ME operates with Java.

- URCs that may be issued before the ME detects a new bit rate (by receiving the first AT character) will be

sent at the previously detected bit rate or, after ME restart, at 57600 bps.

- When autobauding is switched on:

+ only data length, parity and baud rate are automatically detected

+ if using 1 stop bit, AT+ICF=1 should not be used, because it uses 2 stop bits

+ if using 2 stop bits, no combination of AT+ICF should be used, which uses 1 stop bit

•

Autobauding and bit rate after restart:

The most recently detected bit rate is stored when the ME is powered down (with AT^SMSO). Therefore, each

time the module is restarted the correct bit rate must be found as described above. Unless the bit rate is deter-

mined, the following constraints apply:

- An incoming CSD call or a network initiated GPRS request cannot be accepted. This must be taken into

account when autobauding and autoanswer mode (ATS0 ≠ 0) are enabled at the same time, escpecially

if SIM PIN 1 authentication is done automatically and the setting ATS0 ≠ 0 is stored to the user profile with

AT&W.

- Until the bit rate is found, URCs generated after restart will be output at 57600 bps. This applies only to

user defined URCs, such as "+CREG", "CCWA", "^SCKS" etc. The URCs "^SYSSTART", "^SYSSTART

CHARGE-ONLY MODE" and "^SYSSTART AIRPLANE MODE" will not be indicated when autobauding is

enabled.

Note: To avoid any problems caused by undetermined bit rates in the direction from TA to TE we strongly

recommend to configure a fixed bit rate rather than autobauding.

•

Autobauding and multiplex mode:

If autobauding is active you cannot switch to multiplex mode (see AT+CMUX).

Page 116 of 567

4.10 AT+CMUX

4.10

AT+CMUX Enter multiplex mode

All information provided in this section applies to the ASC0 interface only. The second interface ASC1 has no

support of Multiplex mode.

Multiplex mode according to the ETSI TS 101 669 and GSM 07.10 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. For example, you can send or receive data or make a call on the first

channel, while the other two channels are free to control the module with AT commands.

The TC65 module incorporates an internal multiplexer and thus integrates all the functions needed to implement

full-featured multiplex solutions. For the application on top, customers have the flexibility to create their own mul-

tiplex programs conforming to the multiplexer protocol. To help system integrators save the time and expense of

designing multiplexer applications, SIEMENS AG offers WinMUX2k, a ready-to-use multiplex driver for Windows

2000 and Windows XP. Another approach is to develop customized solutions based on the sources of the

WinMux2k driver.

Refer to [7] which provides a detailed description of the multiplex architecture and step-by-step instructions of

how to install and configure the multiplex mode. The WinMUX2k driver and its source files can be supplied on

request. Please contact your local distributor to obtain the latest installation software and user's guide.

Syntax

Test Command

AT+CMUX=?

Response(s)

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

Read Command

AT+CMUX?

Response(s)

+CMUX: <mode>

ERROR

+CME ERROR: <err>

Write Command

AT+CMUX=<mode>

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07, GSM 07.10

Parameter Description

<mode>^(num)

Multiplexer transparency mechanism

Basic option

<subset>^(num)

Subparameters defined in GSM07.07 are adjusted for control and logical channels as follows

UIH frames used only (control channel)

Page 117 of 567

4.10 AT+CMUX

Notes

• 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.

• There is a timeout of five seconds, if the multiplexer protocol is enabled and no multiplexer control channel is

established. The GSM engine returns to AT command mode.

• The parameter maximum frame size (N1) of AT+CMUX in GSM 07.10 is fixed to 98 bytes and cannot be

changed. All other parameters are not available.

• The Multiplex feature is not relevant for Java applications. The mode cannot be started if the ME is Java con-

trolled.

If Java autostart is enabled with AT^SCFG, it is not possible to activate Multiplex mode on ASC0 or USB.

• Multiplexer mode requires character framing to be set to 8 bits, no parity and 1 stop bit. The setting can be

made using (AT+ICF=3).

4.10.1

Restrictions on Multiplex mode

When the serial interface ASC0 is in multiplex mode, data and fax calls can only be set up on logical channel 1.

Due to this restriction, AT commands have a different behavior on channels 2+3 compared to channel 1. Several

commands are not available, others return different responses. This section summarizes the concerned com-

mands. For general rules and restrictions to be considered in Multiplex mode please refer to [7].

Table 4.1: Availability of AT Commands on Virtual Channels

Command

Behavior on channel 1

Behavior on channel 2+3

+++

not usable, but see note ²⁾

AT+CBST

as described

not usable

AT+CRLP

as described

not usable

AT+CG... (GPRS commands)

as described

see note ³⁾

AT+F... (Fax commands)

as described

not usable

AT&S

as described

not usable

ATA

as described

no Data Calls

ATD

as described

no Data Calls

ATDI

as described

not usable

ATL

as described

not usable

ATM

as described

not usable

ATO

as described

not usable

ATS6 ¹⁾

as described

not usable

ATS7 ¹⁾

as described

not usable

ATS8 ¹⁾

as described

not usable

ATS10 ¹⁾

as described

not usable

ATS18 ¹⁾

as described

not usable

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 ATS0). The other registers are read-only and for internal use only!

2) The applicability of the +++ escape sequence depends on the customer's external application based on the Mulitplexer

Protocol. Recommendations for implementing an appropriate modem status command (MSC) are provided in [7], Section

"Escape Sequence".

3) PDP contexts can be defined on any channel, but are visible and usable only on the channel on which they are defined

(thus it is not possible to define a context on channel 2 and activate it on channel 3). GPRS connections can be estab-

Page 118 of 567

4.10 AT+CMUX

lished on two channels at a time.

Table 4.2: Summary of AT commands with Different Behavior in Multiplex Mode

Command

Description

AT\Q

It is recommended to use hardware flow control (AT\Q3). XON/XOFF flow control

(AT\Q1) is not supported in Multiplex mode.

See note regarding AT\Qn settings stored with AT&W if Multiplex mode is active.

AT&V

Different default configurations on channels 1, 2 and 3.

AT&W

Different user profiles can be stored on each channel.

AT+IPR

Before you start Multiplex mode, it is recommended to set the ME to 57600 bps

(minimum should be 4800 bps). For GPRS we suggest to use 115200 bps or

230400 bps.

In Multiplex mode, the write command AT+IPR=<rate> will not change the bit rate

currently used, but the new bit rate will be stored and becomes active, when the

module is restarted.

AT+IPR=0

Multiplex mode cannot be activated while autobauding is enabled.

AT+CALA

On each channel an individual <text> message can be stored. but only one time

setting applies to all channels. This means an alarm <time> set on one of the

channels overwrites the time setting on all remaining channels. Therefore, the total

number of alarm events returned by the read command AT+CALA? will always be

<n>=0, no matter whether individual text messages are stored.

When the alarm is timed out and executed the ME sends the URC only on the

channel where the most recent alarm setting was made. The alarm time will be

reset to "00/01/01,00:00:00" on all channels.

AT+CMEE

Presentation mode can be separately configured for each channel.

AT+CNMA

If Multiplex mode is activated the +CNMI parameter will be set to zero on all chan-

nels, 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 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 chan-

nels.

AT+CFUN

If the ME is in Multiplexer mode, it is not recommended to activate SLEEP mode

with AT+CFUN=<fun>. The best approach to properly control SLEEP mode in this

case is to issue the PSC messages described in [7], Section "Power saving control

(PSC)".

AT+CPMS

Parameter <mem3> will be the same on all instances, but the settings of <mem1>

and <mem2> may vary on each instance.

AT^SSDA

If one instance is set to <da>=1 and <mt>=1, then all other instances must be con-

figured for <mt>=0.

Page 119 of 567

4.10 AT+CMUX

4.10.2

Second serial interface ASC1

The second serial interface ASC1 is intended as an auxiliary interface for applications which need multiple par-

allel access to the module (e.g. to query status information during a data call), but cannot use the GSM 07.10

multiplexing protocol. Therefore this interface offers limited functionality only.

• No DTR, DSR, DCD, RING signals. These hardware lines do not exist. As a result, AT commands controlling

the behavior of these lines (AT&D, AT&C, AT&S) are not allowed and return ERROR.

• No presentation of ^SYSSTART URCs on ASC1. After restart or reset of the ME, either check that the URC

has been sent on ASC0 or wait approximately 3 seconds before entering the first AT command on ASC1.

• No Autobauding. The hardware is not capable of automatically detecting the baudrate on this interface, so

the AT command which selects autobauding (AT+IPR=0) is not allowed and returns ERROR.

• No CSD calls, so all related AT commands cannot be used and return ERROR.

• No fax calls, so all AT+F commands cannot be used and return ERROR.

• No GSM 07.10 Multiplexer. If issued on the second interface AT+CMUX=0 returns ERROR.

ASC1 is disabled when the multiplexer is enabled on the first serial interface ASC0. Yet, both ASC1 and the mul-

tiplexer channel 2 are using the same parameters, and thus, the same user defined profile (if any). As a result,

a user profile stored on multiplexer channel 2 takes effect on ASC1 after closing the multiplexer and starting up

ASC1. Likewise, a user profile stored on ASC1 will be loaded on multiplexer channel 2.

This may be a problem when ASC1 is not connected, but flow control (for example AT\Q1 or AT\Q3) is stored to

the user profile on the multiplexer channel 2. In this case, flow control takes effect on ASC1, when the multiplexer

is switched off. If then for example a large amount of URCs is generated, their transmission might be stopped

due to the flow control. To avoid this problem we recommend that you do not activate flow control on multiplexer

channel 2 when you set up a user profile with AT&W.

Page 120 of 567

4.11 AT^STPB

4.11

AT^STPB Transmit Parity Bit (for 7E1 and 7O1 only)

This command is intended only for use with 7E1 and 7O1. In addition to the 7E1 or 7O1 settings made with

AT+ICF the command AT^STPB specifies whether or not to transmit the parity bit over the air.

Syntax

Test Command

AT^STPB=?

Response(s)

^STPB: (list of supported <n>s)

Read Command

AT^STPB?

Response(s)

^STPB: <n>

Write Command

AT^STPB=<n>

Response(s)

ERROR

+CME ERROR: unknown

Reference(s)

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

SIEMENS

Command Description

The test command returns the supported values of the parameter <n>.

The read command returns the current value of the parameter <n>.

The write command can be used to control the handling of the parity bit. If command fails, "+CME ERROR:

unknown" will be returned.

Parameter Description

<n>^(num)(&W)

0^(&F)

The parity bit will not be transmitted over the air and will be replaced with 0.

This mode is the default setting if 7E1 or 7O1 is activated with AT+ICF.

In a data connection 8 bits will be transmitted, including the parity bit, i.e. the

parity bit will be properly transmitted over the air. The setting shall be used if

problems are encountered when TC65 is running in the default 7E1 or 7O1

mode enabled with AT+ICF. In this case, AT^STPB=1 shall be set in addition

to the 7E1 or 7O1 settings selected with AT+ICF.

Note

• Command is usable if multiplexer is enabled but setting is ignored.

Page 121 of 567

5. Security Commands

Security Commands

The AT Commands described in this chapter allow the external application to determine various security related

settings.

5.1

AT+CPIN PIN Authentication

AT+CPIN controls network authentication of the TC65.

The read command returns an alphanumeric string indicating whether or not network authentication is required.

The write command allows the TC65 to store the entered password. This may be for example the SIM PIN1 to

PIN if the client has taken precautions for preventing damage in the event of loss or theft etc.

If no PIN1 request is pending (for example if PIN1 authentication has been done and the same PIN1 is entered

again) TC65 responds "+CME ERROR: operation not allowed"; no further action is required.

Each time a password is entered with AT+CPIN the module starts reading data from the SIM. The duration of

reading varies with the SIM card. This may cause a delay of several seconds before all commands which need

access to SIM data are effective. See Section 23.1, Restricted access to SIM data after SIM PIN authentication

for further detail.

Syntax

Test Command

AT+CPIN=?

Response(s)

Read Command

AT+CPIN?

Response(s)

+CPIN: <code>

ERROR

+CME ERROR: <err>

Write Command

AT+CPIN=<pin>[, <new pin>]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Page 122 of 567

5.1 AT+CPIN

Parameter Description

<pin>^(str)

Password (string type), usually SIM PIN1.

If the requested password was a PUK, such as SIM PUK1 or PH-FSIM PUK or another password, then <pin>

must be followed by <new pin>.

<new pin>^(text)

If the requested code was a PUK: specify a new password or restore the former disabled password. See Section

5.1.1, What to do if PIN or password authentication fails? for more information about when you may need to

enter the PUK.

<code>^(text)

SIM PIN authentication

READY

PIN has already been entered. No further entry needed.

SIM PIN

ME is waiting for SIM PIN1.

SIM PUK

ME is waiting for SIM PUK1 if PIN1 was disabled after three failed attempts to

enter PIN1.

SIM PIN2

ME is waiting for PIN2. This is only applicable when an attempt to access a

PIN2 related feature was acknowledged with +CME ERROR: 17 ("SIM PIN2

required"), for example when the client attempts to edit the FD phonebook). In

this case the read command AT+CPIN? also prompts for SIM PIN2. Normally,

the AT+CPIN2 command is intended for SIM PIN2.

SIM PUK2

ME is waiting for PUK2 to unblock a disabled PIN2. As above, this is only nec-

essary when the preceding command was acknowledged with +CME ERROR:

18 ("SIM PUK2 required") and only if the read command AT+CPIN? also

prompts for SIM PUK2. Normally, the AT+CPIN2 command is intended for SIM

PUK2.

Phone security locks set by client or factory

PH-SIM PIN

ME is waiting for phone-to-SIM card password if "PS" lock is active and the cli-

ent inserts other SIM card than the one used for the lock. ("PS" lock is also

referred to as phone or antitheft lock).

PH-SIM PUK

ME is waiting for Master Phone Code, if the above "PS" lock password was

incorrectly entered three times.

PH-FSIM PIN

ME is waiting for phone-to-very-first-SIM card. 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).

PH-FSIM PUK

ME is waiting for phone-to-very-first-SIM card unblocking password to be

given. Necessary when "PF" lock is active and other than first SIM card is

inserted.

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 un-blocking password

Page 123 of 567

5.1 AT+CPIN

Notes

• 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

be due to missing network coverage, denied network access with currently used SIM card, no valid roaming

agreement between home network and currently available operators etc.

TC65 offers various options to verify the present status of network registration: For example, the AT+COPS

command indicates the currently used network. With AT+CREG you can also check the current status and acti-

vate 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).

•

<pin> and <new pin> can also be entered in quotation marks (e.g. "1234").

• To check the number of remaining attempts to enter the passwords use the AT^SPIC command.

• See AT+CPWD and AT^SPWD for information on passwords.

• See AT+CLCK and AT^SLCK for information on lock types.

5.1.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). +CME ERROR: 12 will

prompt the client to unblock the SIM card by entering 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 oper-

able (the device will respond with: +CME ERROR: 770, which stands for: SIM invalid - network reject). In such

a case, the card needs to be replaced. PIN1 consists of 4 to 8 digits, PUK1 is an 8-digit code only.

To unblock a disabled PIN1 you have two options:

• You can enter AT+CPIN=PUK1,new PIN1.

• 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 AT+CPIN2. The handling of PIN2 varies with the pro-

vider. 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 per-

manently block the additional features subject to PIN2 authentification, but usually has no effect on PIN1. PIN2

consists of 4 digits, PUK2 is an 8-digit code only.

To unblock a disabled PIN2 you have two options:

• You can enter AT+CPIN2=PUK2,new PIN2.

• You can use the ATD command followed by the GSM code **052*PUK2*newPIN2*newPIN2#;.

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 man-

ufacturer or provider. When needed, contact Siemens AG and request the Master Phone Code of the specific

module.

There are two ways to enter the Master Phone code:

• You can enter AT+CPIN=Master Phone Code

• You can use the ATD command followed by the GSM code *#0003*Master Phone Code#;.

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 the ATD option, 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.

Page 124 of 567

5.1 AT+CPIN

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

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

above).

Call barring:

Supported modes are "AO", "OI", "OX", "AI", "IR", "AB", "AG", "AC". If the call barring password is entered incor-

rectly three times, the client will need to contact the service provider to obtain a new one.

Related sections:

"+CME ERROR: <err>" values are specified at Section 2.12.1, CME/CMS Error Code Overview. For further

instructions and examples see AT+CLCK, AT^SLCK, AT+CPWD and AT^SPWD.

For a complete list of Star-Hash codes please refer Section 23.2, Star-Hash (*#) Network Commands.

Page 125 of 567

5.2 AT+CPIN2

5.2

AT+CPIN2

PIN2 Authentication

AT+CPIN2 controls network authentication of the TC65.

The read command returns an alphanumeric string indicating whether or not network authentication is required.

The write command allows the TC65 to store the entered password. This may be for example the SIM PIN2 to

benefit from the features listed below, or the SIM PUK2 to replace a disabled PIN2 with a new one. Note that

PIN2 can only be entered if PIN1 authentication was done.

If the TC65 is requesting SIM PUK2, use <pin> to enter the PUK2, followed by <new pin> to specify the new

PIN2.

Syntax

Test Command

AT+CPIN2=?

Response(s)

Read Command

AT+CPIN2?

Response(s)

+CPIN2: <code>

ERROR

+CME ERROR: <err>

Write Command

AT+CPIN2=<pin>[, <new pin>]

Response(s)

ERROR

+CME ERROR: <err>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07

Parameter Description

<pin>^(str)

Password (string type), usually SIM PIN2 or, if requested, SIM PUK2.

<new pin>^(str)

If the requested code was SIM PUK2: new password (PIN2).

See Section 5.1.1, What to do if PIN or password authentication fails? for more information about when you may

need to enter the PUK.

<code>^(text)

READY

ME is not pending for any password.

SIM PIN2

ME is waiting for SIM PIN2.

This <code> is returned only when PIN2 authentication has not yet been done

or has failed ("+CME ERROR:17").

SIM PUK2

ME is waiting for SIM PUK2.

This <code> is returned only when PIN2 authentication has failed and ME is

pending for SIM PUK2 (i.e. "+CME ERROR:18").

Page 126 of 567

5.2 AT+CPIN2

Note

• Functions accessible only after PIN2 authentication:

AT+CACM: Accumulated call meter (ACM) reset or query

AT+CAMM: Accumulated call meter maximum (ACMmax) set or query

AT+CLCK: Facility lock to "FD" (Fixed dialing phonebook)

AT^SLCK: Facility lock to "FD" (Fixed dialing phonebook)

AT+CPWD: Change "P2"password

AT^SPWD: Change "P2"password

AT+CPUC: Price per unit and currency table

AT+CPIN2: Enter SIM PIN2 or SIM PUK2 if requested.

For example, SIM PIN2 will be needed when you attempt to edit the "FD" phonebook and ME returns "+CME

Error 17" or "+CPIN: SIM PIN2".

Once the required <pin> has been entered correctly, PIN2 authentication code changes to READY. After

300s, a repetition of the authentication process is required (PIN2 authentication code changes from READY

to SIM PIN2).

Examples

EXAMPLE 1

Change PIN2

AT+CPWD="P2","0000","8888"

(where "0000" = old PIN2 and "8888" = new PIN2)

EXAMPLE 2

Unblock a disabled PIN2

AT+CPIN2?

+CPIN2: SIM PUK2

PIN2 has been disabled, PUK2 must be entered

to define a new PIN2

AT+CPIN2=12345678,8888

where "12345678" is the PUK2, and "8888" the new

PIN2.

EXAMPLE 3

Write into "FD" phonebook

AT+CPBS="FD"

AT+CPBW=2,"+493012345678",145,"Charly"

+CME ERROR 17

access denied due to missing PIN2 authentication

AT+CPIN2=8888

AT+CPBW=2,"+493012345678",145,"Charly"

Page 127 of 567

5.3 AT^SPIC

5.3

AT^SPIC Display PIN counter

The AT^SPIC command can be used to find out whether the ME is waiting for a password and, if so, how many

attempts are left to enter the password.

The execute command returns the number of attempts still available for entering the currently required password,

for example the PIN, PUK, PH-SIM PUK etc.

The read command AT^SPIC? indicates which password the number of attempts stated by the execute com-

mand actually refers to. Also, the write command may be used to query the counter for a specific password: It

indicates the number of attempts still available for entering the password identified by <facility>, for example

the PIN, PIN2, PH-SIM PIN etc.

To check whether or not you need to enter a password use the read commands AT+CPIN?, AT+CPIN2? and

AT^SPIC?. If the response to AT+CPIN? is "READY" the counter of the execute command AT^SPIC relates to

PIN2. See last example. If the responses to AT+CPIN? and AT+CPIN2? both read "READY", no password is

currently required, and the referrer of the execute command AT^SPIC is explicitly undefined.

Syntax

Test Command

AT^SPIC=?

Response(s)

Read Command

AT^SPIC?

Response(s)

^SPIC: <code>

Exec Command

AT^SPIC

Response(s)

^SPIC: <counter>

Write Command

AT^SPIC=<facility>

Response(s)

^SPIC: <counter>

Reference(s)

ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

SIEMENS

Parameter Description

<counter>^(num)

Number of attempts left to enter the currently required password. This number will be counted down after each

failure.

Page 128 of 567

5.3 AT^SPIC

<facility>^(str)

Password for which the corresponding PIN counter is to be displayed.

"SC"

SIM PIN or SIM PUK. If the SIM PIN has been deactivated after three failed

attempts, the counter for SIM PUK will be returned instead.

"PS"

"Phone code" or "device code" (cf. AT+CLCK and AT+CPWD). If incorrectly

entered three times, the Master Phone Code is required to lift the lock and the

number of remaining attempts for the master phonecode will be returned.

"P2"

SIM PIN2 or SIM PUK2. If the SIM PIN2 has been deactivated after three failed

attempts, the counter for SIM PUK2 will be returned instead.

"PN"

Network Personalisation

<code>^(text)

Identification of the currently required password.

SIM PIN

ME is waiting for SIM PIN1.

SIM PUK

ME is waiting for SIM PUK1 if PIN1 was disabled after three failed attempts to

enter PIN1.

SIM PIN2

ME is waiting for PIN2, when the attempt to access PIN2 requiring features was

acknowledged with +CME ERROR:17 (e.g. if the user attempts to edit the FD

phonebook).

SIM PUK2

ME is waiting for PUK2 to unblock a disabled PIN2. Necessary if preceding

command was acknowledged with +CME ERROR:18.

PH-SIM PIN

ME is waiting for phone-to-SIM card password if ''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).

PH-SIM PUK

ME is waiting for Master Phone Code, if the above ''PS'' lock password was

incorrectly entered three times.

PH-NET PUK

ME is waiting for network personalisation unblocking password

Notes

• Whenever the required password changes, <counter> changes to reflect that change. Please refer to the

examples below.

• For passwords associated to the phone lock (''PS'' lock set by user or factory) or other factory set locks, such

as ''PF'', ''PN'', ''PU'', ''PP'', ''PC'' the number of attempts is subject to a timing algorithm explained in

AT+CPIN. If these passwords are incorrectly entered the counter first returns 3, 2 and 1 remaining attempt(s),

but then gives the total number of attempts which amounts to 63 (see example below).

• See also Chapters AT+CLCK, AT+CPIN, AT+CPIN2, AT+CPWD, AT^SLCK for further information on locks and

passwords.

Examples

EXAMPLE 1

The user fails to provide a correct SIM PIN three times. The counter decreases each time. After the counter

reaches zero, the SIM PUK is required. After each failure to enter a correct SIM PUK, the counter decreases.

at+cpin?

+CPIN: SIM PIN

Currently required password is PIN1.

at^spic

^SPIC: 3

3 attempts left.

at+cpin=9999

+CME ERROR: incorrect password

Page 129 of 567

5.3 AT^SPIC

at^spic

^SPIC: 2

2 attempts left.

at+cpin=9999

+CME ERROR: incorrect password

at^spic

^SPIC: 1

1 attempt left.

at+cpin=9999

+CME ERROR: incorrect password

at+cpin?

+CPIN: SIM PUK

Now required password is PUK 1.

at^spic

^SPIC: 10

10 attempts left for PUK 1.

at+cpin=01234567,1234

+CME ERROR: incorrect password

at^spic

^SPIC: 9

9 attempts left for PUK 1.

EXAMPLE 2

Though a mobile is locked to a specific SIM card (phone lock), the user attempts to operate it with another

SIM card. The user correctly enters the SIM PIN of the SIM card currently inserted, but then fails to give the

''PS'' lock password (PH-SIM PUK):

at+cpin=9999

at+cpin?

+CPIN: PH-SIM PIN

ME is waiting for the phone lock password.

at^spic

^SPIC: 3

3 attempts left.

at+cpin=4711

+CME ERROR: incorrect password

at^spic?

^SPIC: 2

2 attempts left.

at+cpin=4712

+CME ERROR: incorrect password

at^spic

^SPIC: 1

1 attempt left.

at^spic?

^SPIC: PH-SIM PIN

Displayed counter refers to phone lock password.

at+cpin=4713

+CME ERROR: incorrect password

at^spic

^SPIC: 63

at^spic?

^SPIC: PH-SIM PUK

Displayed counter refers to master phone code.

Page 130 of 567

5.3 AT^SPIC

at+cpin=4714

+CME ERROR: incorrect password

at^spic

^SPIC: 63

EXAMPLE 3

This example shows that after successful SIM PIN1 authentication the counter of the AT^SPIC execute and

read command refers to SIM PIN2, i.e. it does not reflect the status of SIM PIN1. This may be a problem if

the user enters a wrong PIN1 and is not aware that the number of attempts left to enter SIM PIN1 is counted

down.

+CREG: 0

at+cpin=1234

+CREG: 2

+CREG: 1

The mobile ist properly registered to the network.

at+cpin?

+CPIN: READY

The AT+CPIN? read command confirms that SIM

PIN1 authentication was successful.

at^spic

^SPIC: 3

As SIM PIN1 authentication was successful, the

counter relates to SIM PIN2 and correctly indicates

that the user has 3 attempts to enter SIM PIN2.

AT^SPIC?

Likewise, the read command notifies that the ME is

waiting for SIM PIN2.

^SPIC: SIM PIN2

at+clck="SC",0,456789

First attempt to enter a wrong SIM PIN1.

CME ERROR: incorrect password

at^spic

^SPIC: 3

SIM PIN1 authentication is still valid, and the counter

relates to SIM PIN2.

at+clck="SC",0,456789

Second attempt to enter a wrong SIM PIN1.

CME ERROR: incorrect password

at^spic

^SPIC: 3

SIM PIN1 authentication is still valid, and the counter

relates to SIM PIN2.

at+clck="SC",0,456789

Third attempt to enter a wrong SIM PIN1.

CME ERROR: incorrect password

+CREG: 0

SIM PIN1 authentication is no longer valid.

at^spic

^SPIC: 10

This time, after the SIM PIN1 code has been dis-

abled, the counter indicates the status of SIM PIN1

and notifies that 10 attempts are left to enter the SIM

PUK.

To avoid conflicts we recommend to use the AT^SPIC read and write commands rather than the execute com-

mand only. The read command clearly states the currently required password, and the write command may

be used to get the counter for a specific <facility>, in this case for example "P2".

Page 131 of 567

5.4 AT+CLCK

5.4

AT+CLCK Facility lock

AT+CLCK can be used to lock, unlock or interrogate a network or ME <facility>. The command can be

aborted when network facilities are being set or interrogated.

Syntax

Test Command

AT+CLCK=?

Response(s)

+CLCK:list of supported <facility>s

Write Command

AT+CLCK=<facility>, <mode>[, <password>][, <class>]

Response(s)

if <mode> is not equal 2 and command successful:

if <mode>= 2 and command successful:

+CLCK: <status>[, <class>]

[+CLCK: <status>[, <class>]]

[+CLCK: ...]

If error is related to ME functionality

+CME ERROR

Reference(s)

PIN ASC0

ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

GSM 07.07, GSM 02.04, GSM 02.88,

GSM 03.88, GSM 04.88

Parameter Description

<facility>^(str)

Phone security locks set by client or factory

Primarily intended for the client to take safety precautions, "SC", "PS" and "FD" can be configured individually.

"PS" may also be factory set.

Parameter <class> is not applicable to security locks.

See examples below for further details.

"SC"

SIM (lock SIM cards). SIM requests password upon ME power-up and when

this lock command is issued.

<password>: SIM PIN1.

"PS"

Phone locked to SIM card. ME requests password when other than current SIM

card is inserted.

"PS" lock is frequently referred to as "phone lock", or "device lock". Accord-

ingly, 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. This is an 8-digit

device code associated to the IMEI number of the mobile which can only by

obtained from the manufacturer of the module. 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.

Page 132 of 567

5.4 AT+CLCK

<password>: User defined password. It is needed before the first use of

<facility> "PS" and, therefore, must first be specified with AT+CPWD or

AT^SPWD, if it has not been predefined by factory settings. If set by factory (e.g.

for a prepaid mobile), the password is supplied by the provider or operator.

"FD"

SIM fixed dialling memory: If the mobile is locked to "FD", only the phone num-

bers stored to the "FD" memory can be dialled. (Capacity of FD phonebook

depending on the SIM card).

<password>: SIM PIN 2.

If a lock on the SIM fixed dialing memory is active, the following applies:

•

Outgoing voice, data or fax calls can be made only to numbers stored in

''FD'' phonebook.

Result code depends on the type of the call:

for voice calls, indication is ''+CME Error 257: Call barred''.

for data and fax calls, indication is ''NO CARRIER''.

•

Access to defined Supplementary Services such as Call barring, Call wait-

ing, Call forwarding, Call hold and Multiparty is possible only if the exact cor-

responding public MMI *# code for the desired service is stored in the fixed

dialing number phone book, and used with ATD.

AT commands for supplementary service control are barred while "FD" lock

is active.

Indication is ''+CME Error 257: Call barred''.

•

Access to Unstructured Supplementary Services (''USSD'') is possible only

if the exact desired USSD string is stored in the fixed dialling number phone

book, and used with ATD.

AT commands for USSD are barred while "FD" lock is active.

Indication is ''+CME Error 257: Call barred''.

•

SMS can be sent only to phone numbers which are stored in the ''fixed dial-

ling numbers'' phonebook ''FD''.

Also a valid Service Center Address (international format) must be present

in ''FD'' to allow sending SMS at all.

Indication is ''+CMS Error 302: operation not allowed''.

•

GPRS commands can be used only if the ''fixed dialling numbers'' phone-

book ''FD'' contains an entry with phone number ''*99#''. This single entry

enables all GPRS commands, including AT commands and modem com-

patibility commands like ''ATD*99***1#'' or ''ATD*98***1#''.

Indication is ''+CME Error 257: Call barred''.

Factory defined SIM locks:

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.

Parameter <class> is not applicable to SIM locks.

<password> and instructions for unlocking must be obtained from the network provider.

"PF"

lock Phone to the very First SIM card

"PN"

Network Personalisation

"PU"

Network subset Personalisation

"PP"

Service Provider Personalisation

"PC"

Corporate Personalisation

Page 133 of 567

5.4 AT+CLCK

Supplementary Service Call Barring:

Supplementary Service "Call Barring" allows to specify conditions under which calls will be disallowed by the

network.

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 pack-

age.

When you attempt to set a <facility> or <class> which is not provisioned, not yet subscribed to, or not sup-

ported by the module, the setting will not take effect regardless of the response returned. The responses in these

cases vary with the network (for example "OK", "+CME ERROR: Operation not allowed", "+CME ERROR: Oper-

ation not supported" etc.). To make sure check the extended error response with AT+CEER and the lock status

with <mode>=2.

<password>: Network password supplied from the provider or operator. Usually there is one password which

applies to all call barring options. For details contact your provider.

"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)

<mode>^(num)

unlock

lock

query status

<status>^(num)

lock is inactive

lock is active

<password>^(str)

Password string used to lock and to unlock a <facility>. Length and authority for passwords depend on the

<facility> in question and are therefore listed in the section on parameter <facility>. Passwords can be

modified with AT+CPWD or AT^SPWD.

<class>^(num)

Integer or sum of integers each representing a class of information, i.e. a bearer service, telecommunication ser-

vice or bearer service group as defined in "GSM 02.04".

voice

class 2 ("data") comprises all those individual data classes between 16 and

128, that are supported both by the network and the MS. This means, a setting

made for class 2 applies to all individual data classes (if supported). In addition,

you can assign a different setting to a specific class. For example, you can acti-

vate Call Forwarding for all data classes, but deactivate it for data class 64,

"dedicated packet access".

fax

SMS

data circuit sync

data circuit async

Page 134 of 567

5.4 AT+CLCK

dedicated packet access

128

dedicated PAD access

1...[7]...255

combination of some of the above classes.

For example, the default setting 7 represents the sum of the integers 1, 2 and

4 (voice, data and fax).

The value 255 covers all classes.

If parameter "class" is omitted, the default value 7 is used.

Notes

• The AT+CLCK command offers the full range of <class> parameters according to the GSM specifications.

However, when you attempt to use a service option which is not provisioned or not yet subscribed to, the set-

ting 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 extended error response with AT+CEER and the lock status with

<mode>=2.

• The command has been implemented with the full set of <class> parameters according to GSM 07.07. For

actual applicability of a desired Call barring service to a specific service or service group (a specific <class>

value) please consult table A.1 of GSM 02.04.

• If an outgoing Fax or Data Call is rejected due to an active ''call barring'' supplementary service, the call will

be terminated with result code NO CARRIER.

Under the same conditions, an outgoing Voice call will be terminated with result code NO DIALTONE.

• If an invalid <password> is entered several times in succession, a delay incremented after each failed

attempt will increase the time to wait before the input of the <password> is accepted. To avoid blocking the

serial interface the running AT+CLCK command is aborted after a short timeout and returns CME ERROR 100

("unknown"). If then the AT+CLCK command is issued once again execution is denied with CME ERROR 256

("Operation temporary not allowed"). For details regarding the delay see Section 5.1.1, What to do if PIN or

password authentication fails?.

• If the user tries to set a lock although it is already active or, the other way round, tries to unlock an inactive

lock, the response will be OK, but the <password> will not be checked or verified.

• In the airplane mode the write command version for the network related <facility> (AO, OI, OX, AI, IR,

AB, AG and AC) is not supported. For remaining facilities the command is fully functional then.

Examples

EXAMPLE 1

Lock SIM card (<facility>= "SC")

AT+CLCK="SC",1,"9999"

The "SC" parameter enables or disables the SIM PIN authentication

(PIN 1) when you power up the GSM engine

SIM card locked. 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.

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

Query the status of SIM card lock.

+CLCK: 1

SIM card is locked. SIM PIN1 must be entered to enable ME to register

to the GSM network.

Page 135 of 567

5.4 AT+CLCK

EXAMPLE 2

Phone lock (<facility>="PS")

AT+CPIN?

Make sure that PIN1 authentication is valid.

To lock the ME to the currently inserted SIM card, first specify a password for <facility> "PS":

AT+CPWD="PS",,"1234"

If "PS" lock has not been set before: enter new password.

Optionally, if "PS" password was defined before, change existing password:

AT+CPWD="PS","1234","3333" To replace existing "PS" password: Enter old and new password.

Then, activate the Phone Lock:

AT+CLCK="PS",1,"3333"

Locks the mobile to the current SIM card.

To operate the mobile with the SIM card for which "PS" lock was activated:

AT+CPIN?

+CPIN: SIM PIN

AT+CPIN="9999"

No additional password is required for operation (SIM recognized by

mobile).

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?

+CPIN: SIM PIN

AT+CPIN="1111"

PIN authentication accepted.

AT+CPIN?

+CPIN: PH-SIM PIN

"PS" lock password is required.

AT+CPIN="3333"

"PS" Lock password has been accepted. ME is fully operational now.

To deactivate the Phone Lock:

AT+CLCK="PS",0,"3333"

Phone Lock password has to be provided again.

Now the mobile can be used with any SIM card, without the need of the

phone lock password.

Page 136 of 567

5.5 AT^SLCK

5.5

AT^SLCK Facility lock

AT^SLCK provides the "Facility lock" function as defined for the GSM 07.07 command AT+CLCK. The command

can be used to lock, unlock or interrogate a network or ME <facility>.

AT^SLCK is, in every respect, identical with AT+CLCK, except that the command syntax and response prefix is

"^SLCK" instead of "+CLCK". For further details please refer to AT+CLCK.

The command can be aborted when network facilities are being set or interrogated.

Syntax

Test Command

AT^SLCK=?

Response(s)

^SLCK:list of supported <facility>s

Write Command

AT^SLCK=<facility>, <mode>[, <password>][, <class>]

Response(s)

if <mode> is not equal 2 and command successful:

if <mode>= 2 and command successful:

^SLCK: <status>, <class>

[^SLCK: <status>, <class>]

[^SLCK: ...]

If error is related to ME functionality

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2

MUX3

Charge

Last

SIEMENS, GSM 07.07, GSM 02.04,

GSM 02.88, GSM 03.88, GSM 04.88

Note

• In the airplane mode the write command version for the network related <facility> (AO, OI, OX, AI, IR,

AB, AG and AC) is not supported. For remaining facilities the command is fully functional then.

Page 137 of 567

5.6 AT+CPWD

5.6

AT+CPWD Change Password

AT+CPWD allows to define a new password for a password protected <facility> lock function. Each password

is a string of digits, the length of which varies with the associated <facility>. The test command returns a list

of pairs which represent the available facilities and the maximum length of the associated password. See AT

commands AT+CLCK and AT^SLCK for more information on the various lock features.

Specifically the command can be used to

• change PIN1 or PIN2,

• change the password supplied from your provider for the "call barring" supplementary service,

• set individual phone security passwords,

• enter the unblocking key (Master Phone Code) to restore a disabled "PS" password.

To delete a password use the following syntax: at+cpwd=<facility>,<old password>

Syntax

Test Command

AT+CPWD=?

Response(s)

+CPWD:list of supported (<facility>, <password length>)

Write Command

AT+CPWD=<facility>, <old password>[, <new password>]

Response(s)

New password has been registered for the facility lock function.

If parameter <old password> was not correct:

+CME ERROR 16 (+CME ERROR: incorrect password)

If the password for the selected <facility> has been invalidated due to too many failed attempts:

+CME ERROR ...

If error is related to ME functionality:

+CME ERROR

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Parameter Description

<facility>^(str)

Phone security locks set by client or factory:

Primarily intended for the client to take safety precautions, passwords "SC" (SIM PIN) and "P2" (SIM PIN2) are

usually predefined, but can be configured individually. The password for lock facility "PS" may also be factoryset.

"SC"

SIM PIN. SIM requests password upon ME power-up and when this lock com-

mand is issued.

If incorrectly entered three times, the SIM PUK is required to perform authen-

tication. Input of the SIM PUK password is possible only with AT command

AT+CPIN or ATD. For further details please refer to Section 5.1.1, What to do

if PIN or password authentication fails?.

<password length>: 4 to 8 digits.

"PS"

Phone locked to SIM card. ME requests password when other than current SIM

card is inserted.

"PS" lock is frequently referred to as "phone lock", or "device lock". Accord-

ingly, the password may be called "phone code" or "device code". The "PS"

Page 138 of 567

5.6 AT+CPWD

password is not associated with the PUK of the SIM card. It must be defined

before the first use of <facility> "PS" with AT+CLCK.

<password length>: 4 digits.

If incorrectly entered three times, the Master Phone Code is required to lift the

lock. This Unblocking procedure is performed with AT+CPWD using the follow-

ing parameters: <facility>="PS", <old password>= Master Phone Code

(to be obtained from the module manufacturer), and <new password>= the

new phone code ("PS" password for lock facility), if desired.

Mind that successful PIN authentication is a prerequisite for use of AT com-

mand AT+CPWD. If Pin authentication has not been completed, input of the

Master Phone code password is possible only with AT command AT+CPIN or

ATD. For further detail please refer to Section 5.1.1, What to do if PIN or pass-

word authentication fails?.

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 with

AT+CLCK.

"P2"

SIM PIN 2, e.g. required for authentication with facility lock "FD" (cf. AT+CLCK).

If incorrectly entered three times, the SIM PUK 2 is required to perform authen-

tication. Input of the SIM PUK 2 password is possible only with AT command

AT+CPIN2 or ATD. For further detail please refer to Section 5.1.1, What to do

if PIN or password authentication fails?.

<password length>: 4 to 8 digits.

Factory defined SIM locks:

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.

"PF"

Lock Phone to the very First SIM card

"PN"

Network Personalisation

"PU"

Network subset Personalisation

"PP"

Service Provider Personalisation

"PC"

Corporate Personalisation

Supplementary Service Call Barring:

Supplementary Service "Call Barring" allows to specify conditions under which calls will be disallowed by the

network.

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 pack-

age.

<password length>: The Network Password needs to be supplied from the network provider or network oper-

ator. Usually there is one 4 digit password which applies to all call barring options. For details contact your pro-

vider.

"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

Page 139 of 567

5.6 AT+CPWD

"AG"

All outGoing barring services

"AC"

All inComing barring services

<password length>^(num)

4...8

Length of password. The range of permitted length for a password depends on

the associated <facility>. It is available from the test command response,

or in the description of parameter <facility>.

<old password>^(str)

Password specified for the facility.

Parameter <old password> can be ignored if no old password was allocated to the facility.

Take into account that a password may have already been set by factory, or that the service is subject to a pass-

word issued by the provider. See notes above or contact provider.

<new password>^(str)

New password. Mandatory, if <old password> was an unblocking key (such as the Master Phone Code).

Notes

• When changing PIN2 (<facility>="P2") it is recommended to check the new state of PIN2 by using the

AT+CPIN2 command.

• In the airplane mode the write command version for the network related <facility> (AO, OI, OX, AI, IR,

AB, AG and AC) is not supported. For remaining facilities the command is fully functional then.

Examples

EXAMPLE 1

To change PIN2

AT+CPWD="P2","0000","8888"

(where "0000" = old PIN2 and "8888" = new PIN2)

PIN2 Password has been changed to "8888"

EXAMPLE 2

To set password used to enable or disable barring of all outgoing calls:

AT+CPWD="AO","0000","3333"

Requests the network to change the password for

supplementary service "call barring".

Usually this request will affect all barring services,

even though the request is issued for Supplementary

Service BAOC ("Barring of all outgoing calls") only.

Refer to the respective network provider for detail.

EXAMPLE 3

Handling of the "PS" lock password

AT+CMEE=2

Enable text output of CME Error information

AT+CPWD="PS","1111","2222"

(where "1111" = old password and "2222" = new

password)

Password for facility "PS" is now "2222"

AT+CPWD="PS","1111","2222"

Repeat command to provoke error "incorrect pass-

word"

+CME ERROR: incorrect password

("1111" is no longer the correct password)

Page 140 of 567

5.7 AT^SPWD

5.7

AT^SPWD Change Password

The AT^SPWD command comprises all functions of the AT+CPWD command. Apart from the different prefixes

"^SPWD" and "+CPWD", the major difference is that the <facility> list of AT^SPWD includes the additional

"CM" password dedicated to the Customer SIM Lock. Set with the command AT^SCSL, this type of lock allows

the application manufacturer to lock a mobile to specific operators.

The Customer SIM Lock feature is designed to be configurable during the production of the mobile application.

Therefore, to program the "CM" password, the AT^SPWD write command can be used no matter whether the SIM

is inserted or PIN authentication has been done. Opposite to that, passwords for all other facilities can only be

edited if the SIM is present and PIN authentication completed.

IMPORTANT: Please note that, even though there is no need for a factory set Customer SIM Lock, you are

strongly advised to specify at least a "CM" password, avoiding that end users ever have a chance to activate this

lock type.

Each password is a string of digits the length of which varies with the associated facility. The test command

returns a list of pairs which represent the available facilities and the maximum length of the associated password.

See also AT commands AT+CLCK and AT^SLCK as well as AT^SCSL for more detail on the various lock features.

Syntax

Test Command

AT^SPWD=?

Response(s)

^SPWD:list of supported ( <facility>, <password length>)

Write Command

AT^SPWD=<facility>[, <old password>][, <new password>]

Response(s)

New password has been registered for the facility lock function.

If parameter <old password> was not correct:

+CME ERROR 16 (+CME ERROR: incorrect password)

If the password for the selected <facility> has been invalidated due to too many failed attempts:

+CME ERROR ...

In case of trying to set a "CM" password although another type of factory set SIM lock is already active:

+CME ERROR: Operation not supported.

If error is related to ME functionality:

+CME ERROR

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

Page 142 of 567

5.7 AT^SPWD

Parameter Description

<facility>^(str)

"CM"

Password used as Customer Mastercode for Customer SIM Lock.

Defining the "CM" password allows the application manufacturer to set a Cus-

tomer SIM Lock by activating a Network Personalization ("PN") with the

AT^SCSL command. The "CM" password is mandatory for each operation with

AT^SCSL.

<password length> of "CM": 8 digits.

To delete the "CM" password use the following syntax: AT^SPWD=<facil-

ity>,<old password>. Please note that this action will delete all personali-

sation data programmed by the manufacturer with AT^SCSL (including the

operator list).

A description of all other passwords commonly supported by AT+CPWD and AT^SPWD can be found in Section

5.6, AT+CPWD. The "CM" password cannot be edited with AT+CPWD.

Notes

• When changing the PIN2 (<facility>="P2") it is recommended to check the new state of PIN2 using the

AT+CPIN2 command.

• In the airplane mode the write command version for the network related <facility> (AO, OI, OX, AI, IR,

AB, AG and AC) is not supported. For remaining facilities the command is fully functional then.

Examples

EXAMPLE 1

To specify the "CM" password required as Customer Mastercode for the Customer SIM Lock:

AT^SPWD="CM"

Check if the Customer Mastercode was already set.

ERROR

No, it was not.

AT^SPWD="CM", ,"12345678"

Specify a new Customer Mastercode (where <old

password> is omitted and

<new

pass-

word>"12345678" = new Customer Mastercode)

The Customer Mastercode has been set to

"12345678".

AT^SPWD="CM"

Checking again.

Yes, it is active now.

EXAMPLE 2

To change the Customer Mastercode:

AT^SPWD="CM","12345678","44444444"

(where "12345678" = old Customer Mastercode, and

"44444444" = new Customer Mastercode).

The Customer Mastercode has been changed from

"12345678" to "44444444".

EXAMPLE 3

To delete the Customer Mastercode:

AT^SPWD="CM","44444444"

Delete the Customer Mastercode by omitting <new

password> and entering only the <old pass-

word> "44444444".

The Customer Mastercode as well as all personali-

sation data programmed by the manufacturer with

AT^SCSL were deleted.

Page 143 of 567

5.8 AT^SCSL

5.8

AT^SCSL Customer SIM Lock

AT^SCSL is a Siemens defined command especially designed to manage the Customer SIM Lock feature. This

feature allows application manufacturers to lock a mobile to specific operators by activating a Network Person-

alization ("PN"). If the lock is enabled the mobile will accept only SIM cards from the given operators.

The Customer SIM Lock is protected by two different passwords:

•

<password> = Network Personalisation password "CM" defined with AT^SPWD and necessary for program-

ming the Customer SIM Lock with AT^SCSL.

•

<PUK> = Lock/Unlock Code defined with AT^SCSL and used to set the Customer SIM Lock with AT^SCSL.

Also used to deactivate a given lock or activate a new one via AT+CLCK or AT^SLCK. The PUK may be pro-

visioned to the end user.

The AT^SCSL write command serves to configure a Customer SIM Lock and to query the current settings.

Syntax

Test Command

AT^SCSL=?

Response(s)

Write Command

AT^SCSL=<facility>, <action>, <password>[, <PUK>, <data>]

Response(s)

ERROR

CME ERROR

If <action>= 2 and command successful:

^SCSL: <data>[:<data>:<data>: ...]

If <action>= 2 and operator list is empty:

^SCSL:

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2

MUX3

Charge

Last

Siemens

Parameter Description

<facility>^(str)

"PN"

Network Personalisation (= Customer SIM Lock)

<action>^(num)

Set or remove a Customer SIM Lock, or list the locks currently activated.

Remove the given Customer SIM Lock from ME.

Required parameters: <facility>="PN", <action>=0, <password>.

Removing the Customer SIM Lock deletes both the <PUK> and all <data>, i.e.

the entire list of operators.

Write Customer SIM Lock data to the ME and activate the lock.

Required parameters:

<facility>="PN",

<action>=1,

<password>,

<PUK>, <data>.

Retrieve the list of operators the ME is currently locked to.

Required parameters: <facility>="PN", <action>=2, <password>.

Page 144 of 567

5.8 AT^SCSL

<password>^(str)

Password for programming the Customer SIM Lock.

8-digit "CM" password for the facility "PN" that needs to be created with AT^SPWD (see note below for further

details). This password is mandatory for each operation performed with AT^SCSL.

<PUK>^(str)

PUK created and required when entering the Customer SIM Lock data with AT^SCSL, i.e. if <action>=1. Also

used to deactivate a given "PN" lock or to activate a new "PN" lock for another SIM card via AT+CLCK or

AT^SLCK.

The length of the <PUK> is also 8 digits.

Each time the AT^SCSL write command is issued with parameter <action>=1 you are free to use the same

<PUK> or to set a new one. In any case, a new <PUK> overwrites the previous one.

<data>^(str)

Data of the allowed network operators.

Each operator code consists of the "Mobile Country Code" MCC and the "Mobile Network Code" MNC, both sep-

arated by a dot, e.g. MCC1.MNC1. If more than one operator is entered on the same line, then a colon must be

set between each operator code, e.g. MCC1.MNC1:MCC2.MNC2:MCC3.MNC3. For example, for the three

operators T-Mobile D, Vodafone D2 and E-Plus you would enter the following data: 262.01:262.02:262.03

Note that each time the AT^SCSL write command is executed using the parameter <action>=1 the existing

operator codes will not be overwritten, but all new data will be added to the list. This applies no matter whether

the same operator code is already listed, i.e. entering the same operator again causes double entries.

The maximum number of entries in the operator list is 50.

Notes

•

All parameters of AT^SCSL as well as the "CM" password of AT^SPWD can be used no matter whether or not

the SIM card is inserted or PIN authentication has been done. This allows the application manufacturer to set

the "CM" password and activate the Customer SIM Lock during the production process.

•

The Customer SIM Lock takes effect after the AT^SCSL write command was successfully executed with

parameter <action>=1. Then, after the reboot, the mobile will accept only SIM cards from the supported

operators.

•

To remove the Customer SIM Lock use the write command AT^SCSL with <action>=0 and <password>:

AT^SCSL="PN",0,password. This will delete both the <PUK> and the list of operators. The mobile will accept

any SIM card.

•

Another way to operate the mobile with other SIM cards is to deactivate the Customer SIM Lock using the

command AT+CLCK="PN",0,PUK. This will delete the list of operators specified with the Customer SIM Lock,

but the <PUK> created for the Customer SIM Lock remains valid. The mobile will accept any SIM card.

•

If the Customer SIM Lock is deactivated and, therefore, operable with any SIM card, the end user may use

the <PUK> to set a new SIM lock. To do so, it is necessary to enter the command AT+CLCK="PN",1,PUK first,

then insert a different SIM card and finally restart the mobile. When restarted, the mobile will read out and

accept the list of operators of the currently inserted SIM card. As a result, a new Customer SIM Lock takes

effect for the operator(s) listed on this SIM card.

•

If the Customer SIM Lock is active, but the end user inserts an unsupported SIM card and enters PIN1 the

mobile returns OK, although access to SIM related commands (such as dialing out, access to phonebooks,

SMS etc.) will be denied. If then the read command AT+CPIN is executed the mobile will request the PH-NET

PUK. In this case, you have two options: Use the AT+CPIN command to enter the correct <PUK> of the Cus-

tomer SIM Lock. After this, the mobile can be operated with the new SIM card. As an alternative, re-insert the

correct SIM card associated with the Customer SIM Lock and deactivate the lock via AT+CLCK="PN",0,PUK.

•

If an invalid <password> or <PUK> is entered several times in succession, a delay incremented after each

failed attempt will increase the time to wait before the next input is accepted. The delay follows the same tim-

ing algorithm specified for the PH-SIM PUK (Master Phone Code). For details regarding the delay see Section

5.1.1, What to do if PIN or password authentication fails?.

Page 145 of 567

5.8 AT^SCSL

Examples

EXAMPLE 1

Prerequisite for using the AT^SCSL command is a valid "CM" password created with AT^SPWD. Therefore,

first check the "CM" password. A more detailed example can be found in Section 5.7, AT^SPWD.

AT^SPWD="CM",,

Check that the "CM" password was already set.

Yes, the "CM" password is valid.

EXAMPLE 2

To check, configure and remove a "PN" lock (= Customer SIM Lock):

AT^SCSL="PN",2,44444444

Check the current status of the Customer SIM Lock.

^SCSL:

44444444 is the "CM" password created with

AT^SPWD.

Operator list is still empty, Customer SIM Lock has

not yet been set.

AT^SCSL="PN",1,44444444,12345678,262.01:2

Set a "PN" Lock, where 44444444 = "CM" password,

62.02

12345678 = PH-NET PUK, 262.01 = MCC/MNC of

German operator T-Mobile D and 262.02 = MCC/

MNC of Vodafone D2.

AT^SCSL="PN",2,44444444

Check again.

^SCSL: 262.01:262.02

The mobile is locked to the two network operators T-

Mobile D and Vodafone D2.

AT^SCSL="PN",1,44444444,12345678,262.03

Add another operator (262.03 = MCC/MNC of Ger-

man network operator E-Plus).

AT^SCSL="PN",1,44444444,11223344,262.04

Add another operator. In this case, a new PH-NET-

PUK was used. Keep in mind that the new password

overwrites the old one.

AT^SCSL="PN",0,44444444

Remove the Customer SIM Lock. Keep in mind that

this action deletes the entire list of network operators

contained in <data>. As a result, the mobile will

accept any SIM card.

EXAMPLE 3

If the Customer SIM Lock is active, but the user inserts a different SIM card not supported by the list of oper-

ators defined in <data> the <PUK> must be at hand:

AT^SCSL="PN",2,44444444

For the purpose of this example, we check the cur-

^SCSL: 262.01:262.02

rent status of the Customer SIM Lock.

The mobile lis locked to the German operators T-

Molile D and Vodafone D2.

AT+CPIN=1111

PIN1 is accepted and the mobile is operable, except

for SIM related AT commands.

AT+CMGF=1

AT command that does not require SIM authentica-

tion.

AT+CPBS?

Attempt to use a phonebook command.

+CME ERROR: network personalisation PUK

Access to phonebook fails because of lack of SIM

required

data.

AT+CPIN?

Check status of PIN authentication.

+CPIN: PH-NET PUK

The mobile is waiting for the PH-NET-PUK.

Page 146 of 567

6.6 AT+CGMR

6.6

AT+CGMR Request revision identification of software status

AT+CGMR delivers a product firmware version identification. Command is identical with AT+GMR.

Syntax

Test Command

AT+CGMR=?

Response(s)

Exec Command

AT+CGMR

Response(s)

REVISION <xx.yy>

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Parameter Description

<xx.yy>^(str)

Version xx and variant yy of software release.

6.7

AT+GMR Request revision identification of software status

AT+GMR delivers a product firmware version identification. Command is identical with AT+CGMR.

Syntax

Test Command

AT+GMR=?

Response(s)

Exec Command

AT+GMR

Response(s)

REVISION <xx.yy>

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

V.250

Parameter Description

<xx.yy>^(text)

Version xx and variant yy of software release.

Page 151 of 567

6.8 AT+CGSN

6.8

AT+CGSN Request International Mobile Equipment Identity

(IMEI)

AT+CGSN delivers the International Mobile Equipment Identity (IMEI). Command is identical with: AT+GSN.

Syntax

Test Command

AT+CGSN=?

Response(s)

Exec Command

AT+CGSN

Response(s)

<sn>

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

GSM 07.07

Parameter Description

<sn>^(str)

International Mobile Equipment Identity (IMEI) used to identify a GSM mobile equipment to the GSM network

6.9

AT+GSN Request International Mobile Equipment Identity (IMEI)

AT+GSN delivers the International Mobile Equipment Identity (IMEI). Command is identical with AT+CGSN

Syntax

Test Command

AT+GSN=?

Response(s)

Exec Command

AT+GSN

Response(s)

<sn>

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

V.250

Parameter Description

<sn>^(str)

International Mobile Equipment Identity (IMEI) used to identify a GSM mobile equipment to the GSM network.

Page 152 of 567

7. Call related Commands

Call related Commands

The AT Commands described in this chapter are related to Mobile Originated (MOC, i.e. outgoing) Calls and

Mobile Terminated (MTC, i.e. incoming) Calls.

7.1

Call Status Information

For Circuit switched calls, including voice, fax and data calls, call status information is available with URC

"+CIEV: call" (configurable via AT commands AT+CIND and AT+CMER) or - in more detail - from the list of current

calls. This list can be displayed on request via at commands AT+CLCC and AT^SLCC. It can also be issued by

the ME in the form of an unsolicited result code "^SLCC" if configured with AT^SLCC and AT+CMER.

URC "+CIEV: call" and URC "^SLCC" can be configured using AT command AT^SCFG. An overview of the pos-

sible configurations and their consequences for the availability of call status information will be given here.

Generally speaking, the call status values recognized by the ME are as follows:

• active

• held

• dialing (MOC)

• alerting (MOC)

• incoming (MTC)

• waiting (MTC)

• terminating: The call is not active anymore, but inband information is still available.

• dropped: The call has been suspended by the network, but may be resumed later.

The values "terminating" and "dropped" are not standardized for AT command AT+CLCC, and therefore only

available for command AT^SLCC. A call in any of these two states will not appear in the list of current calls as

displayed with AT+CLCC.

A call that is not recognized by the ME is considered to be in "unknown" state.

Some networks may schedule a traffic channel for a call that is not yet in the "active" state. This is reflected in

parameter <traffic channel assigned> of AT command AT^SLCC and the corresponding URC.

Depending on the value of AT^SCFG setting <succ>, Indicator "+CIEV" will be issued (if configured with

AT+CIND and AT+CMER)

• when a state transition ends in state "active" or in state "unknown"

(if AT^SCFG setting <succ>=''restricted'').

• when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of

active calls, or when a traffic channel is established

(if AT^SCFG setting <succ>=''verbose'').

The indicator value for indicator "+CIEV: call" will be "1" if at least one call is in states "held" or "active", and "0"

otherwise.

Depending on the value of AT^SCFG setting <sucs>, Indicator "^SLCC" will be issued (if configured with write

command AT^SLCC and AT+CMER)

• when a state transition ends in state "active" or in state "unknown" (if AT^SCFG setting <sucs>="restricted")

• when any state transition (including transitions beginning or ending in state "unknown") occurs in the list of

active calls, or when a voice channel is established (if AT^SCFG setting <sucs>="verbose").

Due to compatibility considerations, the powerup default for AT^SCFG setting <succ> is "restricted", offering

compatibility to the standard behaviour of indicator "+CIEV: call", while the default for setting <sucs> is "ver-

bose".

In order to see the URCs, event reporting for both indicators must be explicitely configured with the appropriate

AT commands.

Page 154 of 567

7.2 ATA

7.2

ATA Answer a call

Syntax

Exec Command

ATA

Response(s)

In case of data call, if successfully connected (TA switches to data mode):

CONNECT <text>

In case of voice call, if successfully connected:

When TA returns to command mode after call release:

If no connection:

NO CARRIER

Reference(s)

PIN ASC0 ASC1

USB

MUX1

MUX2

MUX3

Charge

Last

V.250

Command Description

TA causes remote station to go off-hook (e.g. answer call).

Parameter Description

<text>^(str)

Connection status

<text> output only if ATX parameter setting with value greater 0.

Notes

• Any additional commands on the same command line are ignored.

• The command may be aborted generally by receiving a character during execution. It can't be aborted in

some connection setup states, such as handshaking.

• If AT+FCLASS setting is 1 or 2, all incoming calls will be answered as fax calls, when ATA is issued on multi-

plexer channel 1 resp. ASC0. For calls explicitly signalled as voice or data calls, this procedure will fail with

result code "NO CARRIER", but the call in question will continue to ring.

It is possible to change the setting for AT+FCLASS to 0 while the call is ringing, and accept the call normally

afterwards with ATA.

• The ATA command may be used also to accept a network request for a PDP context activation (see ATA).

• See also ATX for <text>.

• If an incoming call is no longer available (already disconnected/hanged up)a "NO CARRIER" result code will

be given.

Page 155 of 567

7.3 ATD

7.3

ATD Mobile originated call to specified number

Syntax

Exec Command

ATD<n>[<mgsm>][;]

Response(s)

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 (TA switches to online data mode):

CONNECT <text>

When TA returns to command mode after call release:

If successfully connected and voice call:

Reference(s)

PIN ASC0 ASC1

USB MUX1 MUX2 MUX3 Charge

Last

V.250

Command Description

This command can be used to set up outgoing voice, data or fax calls. It also serves to control Supplementary

Services. The termination character ";" is mandatory to set up voice calls or to send *# codes for Supplementary

Services. It must not be used for data and fax calls.

Additional notes on the responses returned after dialing with ATD:

• For voice calls, you have the choice of two different response modes that can be selected with AT^SM20:

AT^SM20=1 (factory default) causes the ME to respond once the call setup is completed either successfully

("OK") or unsuccessfully ("NO CARRIER", "NO DIAL TONE", "BUSY").

AT^SM20=0 causes the ME to return "OK" immediately after dialing was completed (i.e. before call setup ter-

minates successfully or unsuccessfully).

• For data connections, call setup always terminates when the call has been established (indicated by the result

code "CONNECT <text>), or when it fails (indicated by "NO CARRIER"). The settings of AT^SM20 do not

apply.

Different call release indications:

• Upon termination, an outgoing fax or data call may show a different result code than a voice call would show

under identical conditions. In order to track down the actual reason for call termination, AT+CEER or ATS18

should be used for all applicable connections.

Using ATD during an active call:

• When a user originates a second voice call whil there is already an active voice call, the first call will automat-

ically put on hold. The second call attempt is acknowledged with "OK" immediately after dialing with ATD has

completed, without relation to a successful call setup. In case of failure, the additional result codes "NO CAR-

RIER", "NO DIAL TONE", "NO CARRIER" will be presented afterwards (see example below).

Parameter Description

<n>^(text)

String of dialing digits and optional V.250 modifiers: 0-9, *, #, +, A, B, C

The following V.250 modifiers are ignored: ,(comma), T, P, !, W ,@

Page 156 of 567

7.3 ATD

<mgsm>^(str)

String of GSM modifiers:

Activates CLIR (disables presentation of own phone number to called party)

Deactivates CLIR (enables presentation of own phone number to called party)

Activate Closed User Group explicit invocation for this call only.

g Deactivate Closed User Group explicit invocation for this call only.

Notes

•

The command may be aborted generally when receiving a character during execution. It cannot be aborted

in some connection setup states, such as handshaking.

•

Parameter "I" 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.

•

Siemens TC65 Terminal. Manual (Version: 02.000) - part 2