Cell Lock

Regis MADEC

IP
Connectivity:

V3.01

* refer to software compatibility matrix section for more detail

9
Modems:
M1206B
M1306B
Hardware
Quik (CDMA):
Q2358C
Q2438F
Compatibility
9
Quik (GSM):
Q2400A
Q2403A

9
9

M2106B
Q2438R
Q2406A

This APN (Application Note) is provided to Wavecom distributors

and clients to aid more rapid development of embedded
applications using the Wavecom port folio of cellular solutions. To
request a new application note, contact your regional Wavecom
Product Marketing Manager.

2 APPLICATION DESCRIPTION
The OAT environment is used in this APN to create an application
whereby we can 'lock' the module to a specific BTS only. This is for
applications such as WLL.
Cell & Sector locking is required by carriers to further protect the
business model whereby lower call tariffs are offered to WLL
customers in comparison with traditional PLMN mobile phone
users. In effect, the WLL TE (Terminal Equipment) has to be
artificially made "non-mobile" so that advantage of the low tariff
cannot be taken by moving the TE to another location.

3 FEATURES SUPPORTED

The TE can be restricted from making calls when it is moved

outside of its original installed geography

The Cell ID information on which calls are allowed must be

provided to the OpenAT application. Two solutions are
possible:
o
The OpenAT application is in cooperative
mode so it can receive the cell ID information
through a custom AT command. This case is
described here
o
The OpenAT application is in stand-alone
mode so it should receive the cells ID through
a SMS or GPRS transfer or data call transfer.

Two Wavecom AT commands are used, i.e. AT+CCELL and

AT+CCED. The AT command AT+CCELL cannot be used
alone as the same BCCH Freq can be reused in other
locations. So both AT commands, AT+CCELL and AT+CCED
shall be combined, i.e. AT+CCELL to lock on a specific BCCH
FREQ and AT+CCED to check the MCC, MNC and LAC.

4 RESOURCE USEAGE
Flash Memory

RAM

Compiler
Used:

n.a.

GCC
ADS

Private

Reference Hardware

No

Reference Software

Yes

9
9

Q2406B

Q2501B

<MNC>
<LAC>

1 INTRODUCTION

Public

Mobile Network Code

Location Area Code

This AT commands allowed the carrier installation engineer to

enter manually the Cell-ID parameters

6 STANDARD AT COMMANDS
List other AT commands that are required to be used for this
application.
AT Command
AT+CCED=1,1
Parameters
As given

Values
(n/a)

Description
This command enables to
receive the main cell
parameters periodically

If the syntax is correct, the string answer is as below:

+CCED: <MCC>,<MNC>,<LAC>,<CI>,<BSIC),<Bcch
Lev>,,,,<RxQual>,,,<IdleSub>

freq>,<Rx

More details can be found in document

P_AT_Commands_Interface_Guide_for_xxx.pdf
AT Command
AT+CCELL=<Bcch freq>
Parameters
Values
<Bcch freq>
(n/a)

Description
This command allows
manual cell selection mode
activation (on a given cell),
or deactivation.

If the syntax is correct, the immediate string answer is OK.

When the protocol stack has executed the command, an indication
status is sent :
+ CCELL : <Bcch freq>, <crt>, followed by OK.
<crt> :
0 if cell was successfully camped on
1 if the protocol stack is not in a state that enables such a
command
2 if the requested cell is not known (synchronized)

MIPS
4 if the cell is camped on but provides only emergency calls
service

5 CUSTOM AT COMMANDS
The following AT commands are included in the OAT application:
AT Command
AT+CELLID=<Bcch freq>, <MCC>, <MNC>, <LAC>
Parameters
Values
Parameters
<Bcch freq>
(n/a)
Arfcn of the Bcch to camp
on (0 to stop manual cell
selection)
<MCC>
Mobile Country Code

NOT E

Open
AT:

Confidentiality

ADVANCED

APPLICATION

6.50a

INTERMEDIATE

NOT E

Firmware:

APPLICATION

Software
Compatibility*

BASIC

5 Cell doesn't belong to a band supported by module. In this case

the request is ignored and the previous state is unchanged.
Once in camp mode, AT+CCELL strings indicate the coming in and
out of coverage of the selected cell. If the selected cell is lost, a
"AT+CCELL = <Bcch freq>, 3" indication is sent. The loss of the
cell does not trigger a change of mode. When the selected cell is
lost, the protocol stack keeps making power measurements on the
selected frequency until it successfully synchronizes on it. Then a
new AT+CCELL will indicate that coverage is recovered. The only
way to stop camp mode is to use AT+CCELL=0.

2005
All rights reserved
Page: 1 / 3
This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la proprit exclusive de WAVECOM. Il ne peut tre communiqu ou divulgu des tiers sans son autorisation pralable.

NOT E

APN Content Level

APPLICATION

Author:

WA_ENG_GEN_APN_011_003
Date:
01st August. 2005

Cell Lock
1.

<Bcch freq>
0 Stop manual cell mode
1 to 124Bcch freq to camp on (GSM mode)
512 to 885Bcch freq to camp on (DCS mode)

The handler function for the AT+CELLID command should

save in Flash the cell ID parameters through the API
adl_flhWrite() function.

2.

The handler function for the +CCED should monitor the

values MNC, MCC, LAC for the main cell and save them

3.

Before making a call, the OpenAT application should compare

the values MNC, MCC, LAC received from the network and
the values MNC, MCC, LAC on which the cell lock should be
applied. If there are no common values and if the cell camp is
not successful, then the call shall not be done.

8 EXAMPLES

Application to GSM
GSM to application

AT+CCELL=24
OK

Select a cell
Immediate answer

GSM to application

+CCELL:24,0

Camp
successful

GSM to application

+CCELL:24,3

Cell is lost

No reference hardware is necessary with this application note.

Application to GSM
GSM to application

AT+CCELL=85
OK

Select a new cell

Immediate answer

10 PACKAGE DELIVERABLES

GSM to application

+CCELL:85,5

Cell is out of band

(so current status
is previous one,
i.e. 24,3

+CCELL:24,0

Previous cell found

again

Application to GSM
GSM to application

AT+CCELL=35
OK

Select a new cell

Immediate answer

GSM to application

+CCELL:35,0

Camp
successful

is

9 REFERENCE HARDWARE

This application note is delivered as a single compressed zip

archive as follows:
Filename
WA_ENG_GEN_APN
_011_003.pdf

10.1 DOCUMENTATION
This application note.

10.2 SOFTWARE
List all of the files that will be included in the zip file.
Filename
(n/a)

7 NOTES
FOR
PROGRAMMING

OPEN

AT

2.

3.

4.

5.

The command AT+CCED mentioned in

STANDARD AT COMMANDS should
(adl_atCmdCreate())

Description
(n/a)

10.3 HARDWARE
List all of the files that will be included in the zip file.

Initialization
1.

Description
This application note
NOT E

GSM to application

(n/a)

APPLICATION

is

Filename
(n/a)
the
be

section
issued.

The command AT+CELLID mentioned in the section

CUSTOM AT COMMANDS should be managed.
(adl_atCmdSubscribe()). Inside the callback function, the
command AT+CCELL mentioned in the section STANDARD
AT COMMANDS should be issued. (adl_atCmdCreate())
To process cell environment events, the unsolicited
responses associated with the cell environment information
(beginning
with
+CCED:)
must
be
subscribed.
(adl_unSoSubscribe())
To process cell environment events, the unsolicited
responses associated with the cell environment information
(beginning
with
+CCELL:)
must
be
subscribed.
(adl_unSoSubscribe())
To process all events related to call, the Call Service should
be subscribed. (adl_callSubscribe())

Description
(n/a)

11 SOFTWARE COMPATIBILITY MATRIX

List all current software configurations and compatibility with this
application note.
Core
6.50a

Open AT
V3.01

IP
(n/a)

Compatibility
Yes

12 SUPPORT
For direct clients: contact your Wavecom FAE
For distributor clients: contact your distributor FAE
For distributors: contact your Wavecom FAE

13 DOCUMENT HISTORY
Level
001

Date
22/03/2005

History
Creation

002

17/05/2005

Update

003

01/08/2005

Update

Author
Madec
Regis
Madec
Regis
Madec
Regis

Operation

2005
All rights reserved
Page: 2 / 3
This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la proprit exclusive de WAVECOM. Il ne peut tre communiqu ou divulgu des tiers sans son autorisation pralable.

NOT E

Examples :

APPLICATION

The immediate string answer is OK if the syntax is correct and the

parameters match the values hereabove.

APPLICATION

AT+CCELL=<Bcch freq>

NOT E

WA_ENG_GEN_APN_011_003

Cell Lock
WA_ENG_GEN_APN_011_003

14 LEGAL NOTICE
LICENCE RIGHTS
Wavecom Asia Pacific Ltd hereby grant licence to users of their Open AT (TM) development environment to use the source code in
this electronic file for the sole use of developing GSM, GSM/GPRS or GSM/GPRS/GPS cellular applications compatible with
Wavecom products. The source code may be modified by any Open AT (TM) developer providing the application is not intended to be
malicious or detrimental to cellular operators or consumers of the application in any way. The licence also grants permission to copy
and distribute this source code so long as this licence header is maintained in all source code files. You hereby undertake to use the
Software for your interim development purposes only and under no circumstances shall you use the Software for commercial
purposes. For the avoidance of doubt, the Software may not be sold for a fee on diskette or CD-ROM, either alone or as part of a
collection with other products without prior written consent from Wavecom.

INTELLECTUAL PROPERTY
For the avoidance of doubt, no right, title or interest in any intellectual property right in respect of the Software shall pass to you. Any
and all intellectual property rights in respect of the Software and Documentation shall at all times remain the sole and exclusive
property of Wavecom. The licence grant shall not include Intellectual Property not wholly owned by Wavecom and the customer shall
exercise due diligence to ensure that the use of the information in this document does not infringe any patents in the country of origin.

APPLICATION

NOT E

APPLICATION

NOT E

<END OF AN>

APPLICATION

LIMIT OF LIABILITY
In no event shall Wavecom be liable for any loss or damages whatsoever or howsoever caused arising directly or indirectly in
connection with this licence, the Software, its use or otherwise irrespective of whether Wavecom has had advance notice of the
possibility of such damages or not by your use of the Software. Notwithstanding the generality of the foregoing, Wavecom expressly
excludes liability for indirect, special, incidental or consequential loss or damage which may arise in respect of the Software or its use,
or in respect of other equipment or property, or for loss of profit, business, revenue, goodwill or anticipated savings.

NOT E

DISCLAIMER OF WARRANTY
This Software is provided free of charge on an 'as is' basis. No warranty whether expressed or implied is given by Wavecom in relation
to the Software of the uses to which it may be put by you, the user, or its performance or merchantability, fitness or suitability for any
particular purpose or conditions; and/or that the use of the Software and all documentation relating thereto (the Documentation) by
the Licensee will not infringe any third party copyright or other intellectual property rights. Wavecom shall furthermore be under no
obligation to provide support of any nature for the Software and the Documentation.

2005
All rights reserved
Page: 3 / 3
This document is the sole and exclusive property of WAVECOM. Not to be distributed or divulged without prior written agreement.
Ce document est la proprit exclusive de WAVECOM. Il ne peut tre communiqu ou divulgu des tiers sans son autorisation pralable.