s

mobile

Customer SIM Lock

Siemens Cellular Engine Version: DocId: Supported products: 01 MC55_an_28_simlock_v01 MC55

Application Note

AN 28: Customer SIM Lock

mobile

Document Name: Version: Date: DocId: Status

Customer SIM Lock

01 August 31, 2004 MC55_an_28_simlock_v01 Confidential / Released

Supported products: MC55

General Notes Product is deemed accepted by recipient and is provided without interface to recipients products. The documentation and/or product are provided for testing, evaluation, integration and information purposes. The documentation and/or product are provided on an as is basis only and may contain deficiencies or inadequacies. The documentation and/or product are provided without warranty of any kind, express or implied. To the maximum extent permitted by applicable law, Siemens further disclaims all warranties, including without limitation any implied warranties of merchantability, completeness, fitness for a particular purpose and non-infringement of thirdparty rights. The entire risk arising out of the use or performance of the product and documentation remains with recipient. This product is not intended for use in life support appliances, devices or systems where a malfunction of the product can reasonably be expected to result in personal injury. Applications incorporating the described product must be designed to be in accordance with the technical specifications provided in these guidelines. Failure to comply with any of the required procedures can result in malfunctions or serious discrepancies in results. Furthermore, all safety instructions regarding the use of mobile technical systems, including GSM products, which also apply to cellular phones must be followed. Siemens or its suppliers shall, regardless of any legal theory upon which the claim is based, not be liable for any consequential, incidental, direct, indirect, punitive or other damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information or data, or other pecuniary loss) arising out the use of or inability to use the documentation and/or product, even if Siemens has been advised of the possibility of such damages. The foregoing limitations of liability shall not apply in case of mandatory liability, e.g. under the German Product Liability Act, in case of intent, gross negligence, injury of life, body or health, or breach of a condition which goes to the root of the contract. However, claims for damages arising from a breach of a condition, which goes to the root of the contract, shall be limited to the foreseeable damage, which is intrinsic to the contract, unless caused by intent or gross negligence or based on liability for injury of life, body or health. The above provision does not imply a change on the burden of proof to the detriment of the recipient. Subject to change without notice at any time. The interpretation of this general note shall be governed and construed according to German law without reference to any other substantive law. Copyright Transmittal, reproduction, dissemination and/or editing of this document as well as utilization of its contents and communication thereof to others without express authorization are prohibited. Offenders will be held liable for payment of damages. All rights created by patent grant or registration of a utility model or design patent are reserved. Copyright Siemens AG 2004

MC55_an_28_simlock_v01 Confidential / Released

Page 2 of 6

8/31/04

AN 28: Customer SIM Lock

Contents

mobile

Contents
1. Introduction.............................................................................................................................................. 4 1.1 AT^SCSL Customer SIM Lock ...................................................................................................... 4

MC55_an_28_simlock_v01 Confidential / Released

Page 3 of 6

8/31/04

AN 28: Customer SIM Lock

1. Introduction

mobile

1.

Introduction

The purpose of this Application Note is to describe the steps needed to configure a "Customer SIM lock". The feature is available exclusivley for MC55 modules as of Firmware Release 02.00 that are set to the following initial modes when shipped from Siemens: "Customer IMEI Mode" - International Mobile Equipment Identity (IMEI) numbers and software version number (SVN) are left blank to be factory set by the Siemens customer. "Customer SIM Lock Mode" - the modules are prepared for a SIM lock to be factory set by the Siemens customer. This gives manufacturers of the final GSM equipment the flexibility to implement their particular IMEI numbers and, at the same time, to program a SIM lock according to their preferences. IMPORTANT: Please note that, even though there is no need for a factory set "Customer SIM lock", you are strongly advised to specifiy at least a "PN" <password> with AT^SPWD, avoiding that end users ever have a chance to activate this lock type. See also the note below regarding AT^SPWD. The AT^SCSL command and the AT commands available for writing IMEI data and SVN are not part of the standard "MC55 AT Command Set" and therefore described in separate documents. A description of AT^SPWD can be found in the "MC55 AT Command Set". Related documents: "MC55 AT Command Set", as of MC55 Version 02.00 "Application Instructions 21: Implementing Customer IMEI"

1.1

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 Personalization ("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 "PN" required for programming the "Customer SIM lock" via AT^SCSL. <PUK> = Lock/Unlock Code to deactivate a given lock or activate a new one via AT+CLCK or AT^SLCK. The PUK may be provisioned to the end user.

Syntax
Test Command

AT^SCSL=?
Response(s)

OK
Write Command

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

Response(s)

OK ERROR CME ERROR If <action>= 2 and command successful: ^SCSL: <data>[:<data>:<data>: ...] If <action>= 2 and operator list is empty: ^SCSL:

MC55_an_28_simlock_v01 Confidential / Released

Page 4 of 6

8/31/04

AN 28: Customer SIM Lock

1.1 AT^SCSL

s
PIN ASC0 ASC1 MUX1 MUX2

mobile
MUX3

Reference(s)

Siemens

Command Description
The write command serves to configure a "Customer SIM lock" and to query the current settings.

Parameter Description
<facility>(str) PN <action>(num) Set or remove a "Customer SIM lock", or list the locks currently activated. 0 1 2 <password>(str) Password for programming the "Customer SIM lock". 8-digit password for the facility "PN" that needs to be created with AT^SPWD (see note below for further details). The "PN" password is mandatory for each operation performed with AT^SCSL. <PUK>(str) PUK 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 <PUK> needs to be created when configuring the "Customer SIM lock" with <action>=1. 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 separated 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 25. Remove the given SIM lock from ME. Program the given SIM lock data to ME. List all currently programmed SIM locks. Network Personalisation

Notes
The commands AT^SCSL and AT^SPWD can be used no matter whether or not the SIM card is inserted. This allows the application manufacturer to set the "PN" password and activate the "Customer SIM lock" during production. The test command of AT^SPWD returns all available facilities for the command. Yet, if the PIN is not given or the SIM card not inserted only the password of the facility "PN" can be changed with AT^SPWD. The "Customer SIM lock" takes effect after the AT^SCSL write command was successfully executed with parameter <action>=1. The mobile will then accept only SIM cards from the supported operators.

MC55_an_28_simlock_v01 Confidential / Released

Page 5 of 6

8/31/04

AN 28: Customer SIM Lock

1.1 AT^SCSL

mobile

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 "Customer 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 timing algorithm specified for the PH-SIM PUK (Master Phone Code). For details regarding the delay see MC55 AT Command Set, Subsection "What to do if PIN or password authentication fails?". After 16 failed attempts the MC55 module will be locked permanently.

MC55_an_28_simlock_v01 Confidential / Released

Page 6 of 6

8/31/04