ETSI TS 101 476-2002 Digital Cellular Telecommunications System (Phase 2+) GSM API for SIM Toolkit Stage 2 (3GPP TS 03 19 Version 8 5 0 Release 1999)《数字蜂窝通信系统(第2+阶段) SIM工具包的GSM API.pdf

1、- c PLEASE NOTE This document is normally accompanied by a disk/dish wnen purchased in hardcopy. The dislddisks contain information which would be of no value as a hardcopy document. If you require a copy of the diskldisb, please use the contact information below for your request. When submitting yo

2、ur request, please have the following irzfonnation vuiizble: Your company name/account number Originating orsanisacion Document number USMCanada Enformation Handling Services E-mail Te!: 800-U$-3352 Outside USAiCanada Except the United I(ingdom) Information Handling Services E-mai Te!: i 1-303-790

3、-0600 Technic3 Tz!: (O Fax: (O United Kingdom Indexes Ltd 344) 404409, Custoinet Support 34.1) 40442 I, Ccistoiner Suppori In formation Handing Senices and Teclinicai Indexer - Cortitiziad to Service Excellence ETSI TS 1 O1 476 V8.5.0 (2002-09) Technical Specificafion Digital cellular telecommunicat

4、ions system (Phase 2+); GSM API for SIM toolkit stage 2 (3GPP TS 03.19 version 8.5.0 Release 1999) 3GPP TS 03.19 version 8.5.0 Release 1999 1 ETSI TS 101 476 V8.5.0 (2002-09) Reference RTS/TSGT-030319850 Keywords GSM ETSI 650 Route des Lucioles F-O6921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92

5、94 42 O0 Fax: +33 4 93 65 47 16 Siret No 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-prfecture de Grasse (06) No 7803/88 Important notice Individual copies of the present document can be downloaded from: http:lwmv.etsi .arq The present document may be made available

6、 in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a spec

7、ific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at ha p:/pa rta I. etsi I a rgltbistat uslstatus .as p If you fi

8、nd errors in the present document, send your comment to: Cori vriaht Notifica tion No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. O European Telecommunications Standards Institute 2002. All rights

9、 reserved. DECTTM, PLUGTESTSTMand UMTSTMare Trade Marks of ETSI registered for the benefit of its Members. TIPHONTM and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of t

10、he 3GPP Organizational Partners. ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 2 ETSI TS 101 476 V8.5.0 (2002-09) Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, i

11、s publicly available for ETSI members and non-members, and can be found in ETSI SR O00 314: “Intellectual Property Rights (7PRs); Essential, orpotentially Essential, IPRs notlJied to ETSI in respect ofETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the

12、ETSI Web server (5). Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR O00 3 14 (or the updates on the ETSI Web server) which are, or may be, or may become, es

13、sential to the present document. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be inter

14、preted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under www.etsi.ornkey . ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 3 ETSI TS 101 476 V8.5.0 (2002-09) Contents Intellectual Property Rights . .2 Foreword

15、 . 4 Foreword . 2 1 2 3 3.1 3.2 4 4.1 4.2 5 5.1 5.2 5.3 5.4 6 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 7 7.1 7.2 Scope 5 References . .5 Definitions and abbreviations. . .6 Definitions 6 Abbreviations . 6 GSM Java Card Architecture . 7 Java Card Selection Mechanism 8 Description .7 GSM Framework . .8 8 Overv

16、iew . 8 GSM file data access 9 Access control . . 9 GSM low Level API . SIM Toolkit Framework . 9 Overview . 9 Applet Triggering . 10 Registration 13 Proactive command handling . Envelope response handling . Handler availability 14 SIM Toolkit Framework behavio ur Usage of ViewHandler and EditHandle

17、r . . . 14 14 16 17 17 . 17 . 17 Annex A (normative): Java Card SIM API . 18 Annex B (normative): Annex C (normative): Java Card SIM API identifiers . 19 SIM API package version management . 20 Annex D (informative): Toolkit applet example 21 Annex E (informative): Change history . 24 History . .25

18、ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 4 ETSI TS 101 476 V8.5.0 (2002-09) Foreword This Technical Specification has been produced by the 3d Generation Partnership Project (3GPP) based on work originally done by the Special Mobile Group (SMG) in ETSI. The present document details the stage 1 a

19、spects (overall service description) for the support of a Subscriber Identity Module Application Programming Interface (SIM API). The contents of the present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modiSl the contents of the

20、 present document, it will be re-released by the TSG with an identiSling change of release date and an increase in version number as follows: Version 8.x.y where: 8 indicates GSM Phase 2+ Release 1999 x the second digit is incremented for changes of substance, i.e. technical enhancements, correction

21、s, updates, etc. y the third digit is incremented when editorial only changes have been incorporated in the specification; ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 5 ETSI TS 101 476 V8.5.0 (2002-09) 1 Scope The present document defines the stage two description of the Subscriber Identity Module

22、 Application Programming Interface (SIM API) internal to the SIM. This stage two describes the functional capabilities and the information flow for the SIM API implemented on the Java Card 2.1 API specification 6. The present document includes information applicable to network operators, service pro

23、viders and SIM, server and database manufacturers. 2 Re fe re nces The following documents contain provisions which, through reference in this text, constitute provisions of the present document. References are either specific (identified by date of publication, edition number, version number, etc.)

24、 or non-specific. For a specific reference, subsequent revisions do not apply. For a non-specific reference, the latest version applies. A non-specific reference to an ETS shall also be taken to refer to later versions published as an EN with the same number. For this Release 1999 document, referenc

25、es to GSM documents are for Release 1999 versions (version 8.x.y). il 21 3GPP TR 21.905: “Abbreviations and acronyms“ 3GPP TS 1 1.1 1 : “Specification of the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface“. 31 3GPP TS 11.14: “Specification of the SIM Application Toolkit for the S

26、ubscriber Identity Module - Mobile Equipment (SIM - ME) interface“. 41 51 3GPP TS 03.48: “Security Mechanisms for the SIM application toolkit; Stage 2“. ISO/IEC 7816-3 (1997) Identification cards - Integrated circuit(s) cards with contacts, Part 3: Electronic signals and transmission protocols“. 3GP

27、P TS 02.19: “Subscriber Identity Module Application Programming Interface (SIM API); Service description; Stage 1“. 61 71 SI 91 SUN Java Card Specification “Java Card 2.1 API Specification“. SUN Java Card Specification “Java Card 2.1 Runtime Environment Specification“. SUN Java Card Specification “J

28、ava Card 2.1 VM Architecture Specification“. SUN Java Card Specifications can be downloaded at ETSI TS 101 220 “Integrated Circuit Cards (ICC); ETSI numbering system for telecommunication; Application providers (AID)“. lo1 ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 6 ETSI TS 101 476 V8.5.0 (2002-

29、09) 3 3.1 Definitions and abbreviations De fi nit ions For the purposes of the present document, the following terms and definitions apply: Applet : An Applet is an application built up using a number of classes which will run under the control of the Java Card virtual machine. Applets designed for

30、smart cards are sometimes referred to as Cardlets. Bytecode : Machine independent code generated by a Java compiler and executed by the Java interpreter. Class : The Class is a type that defines the implementation of a particular kind of object. A Class definition defines instance and class variable

31、s and methods. Framework : A framework defines a set of Application Programming Interface (API) classes for developing applications and for providing system services to those applications. GSM applet : The GSM application conforming to TS 1 1.11, It might be a Java Card applet or native application.

32、 Java : An object oriented programming language developed by Sun Microsystems designed to be platform independent. Method : A Method is a piece of executable code that can be invoked, possibly passing it certain values as arguments. Every Method definition belongs to some class. Object : The princip

33、al building block of object oriented programs. Each object is a programming unit consisting of data (variables) and functionality (methods) Package : A group of classes. Packages are declared when writing a Java Card program Toolkit applet : Applet loaded onto the SIM card seen by the Mobile as bein

34、g part of the SIM Toolkit application and containing only the code necessary to run the application. These applets might be downloaded over the radio interface. Virtual Machine : The part of the Run-time environment responsible for interpreting the bytecode. 3.2 Abbreviations For the purposes of the

35、 present document, the following abbreviations apply, in addition to those listed in TR21.905 i: AC AID APDU API CAD FFS IFD JCRE JVM ME MS SIM SE SMS-CB SMS-PP USSD VM Application Code Application Identifier Application Protocol Data Unit Application Programming Interface Card Acceptance Device For

36、 Further Study Interface Device Java CardTM Run Time Environment Java Virtual Machine Mobile Equipment Mobile Station Subscriber Identity Module Sending Entity Short Message Service Cell Broadcast Short Message Service Point to Point Unstructured Supplementary Services Data Virtual Machine ETSI 3GPP

37、 TS 03.19 version 8.5.0 Release 1999 7 ETSI TS 101 476 V8.5.0 (2002-09) 4 Description The present document describes an API for the GSM SIM. This API allows application programmers access to the functions and data described in TS 1 1.11 2 and TS 1 1.14 3, such that SIM based services can be develope

38、d and loaded onto SIMS, quickly and, if necessarily, remotely, after the card has been issued. This API is an extension to the Java Card 2.1 API 7 based on the Java Card 2.1 Runtime Environment SI. 4.1 GSM Java Card Architecture The over all architecture of the SIM Toolkit API based on Java Card 2.1

39、 is: File System Registry Handler II I J CRE rn rn rn rn rn shareable interface Figure 1: GSM Java Card Architecture SIM Toolkit Framework this is the GSM Java Card runtime environment, it is composed of the JCRE, the Toolkit Registry, the Toolkit Handler and the File System. JCRE: this is specified

40、 in Java Card 2.1 Runtime Environment Specification SI and is able to select any specific applet and transmit to it the process of its APDU. Toolkit Registry: this is handling all the registration information of the toolkit applets, and their link to the JCRE registry. Toolkit Handler: this is handl

41、ing the availability of the system handler and the toolkit protocol (i.e. toolkit applet suspension). File System: this contains the card issuer file system, and handles the file access control and the applet file context. It is a JCRE owned object implementing the shareable interface sim.access.SIM

42、View. Applets: these derive from javacard.framework.applet and provide the entry points : process, select, deselect, install as defied in the Java Card 2.1 Runtime Environment Specification SI. Toolkit applets: these derive from javacard.framework.applet, so provide the same entry points, and implem

43、ent the shareable interface sim. toolkit. Toolkitlnterface so that these applets can be triggered by an invocation of their processToolkit method. These applets AID is defined in TS 101 220 lo. ETSI 3GPP TS 03.19 version 8.5.0 Release 1999 8 ETSI TS 101 476 V8.5.0 (2002-09) GSM Applet: this is the d

44、efault applet as defined in Java Card 2.1 Runtime Environment Specification SI, it behaves as regular applet e.g. when another applet is selected via the SELECT AID APDU its deselect method is invoked. Its AID is defined in TS 101 220 lo. This applet handles the TS 11.112 APDUs, CHV1/2, the GSM auth

45、entication algorithm and the subscriber file access control according to TS 11.11 2. Loader applet: this is handling the installation and uninstallation of the applets as specified in the applet loading specification TS 03.48 4. Shareable interface: this is defined in the Java Card 2.1 specification

46、s. 4.2 Java Card Selection Mechanism The Java Card selection mechanism is defined in the Java Card Runtime Environment Specification SI. 5 GSM Framework 5.1 Overview The GSM Framework consists of the GSM applet and the JCRE File System Object. The GSM Framework is based on two packages: The GSM low

47、level package FFS; The sim.access package, which allows applets to access the GSM files. - - 5.2 GSM file data access The following methods shall be offered by the API to card applets, to allow access to the GSM data: select status readBinary readRecord uydateBinary up dateReCord seek increase rehab

48、ilitate invalidate Select a file without changing the current file of any other applet or of the subscriber session. At the invocation of theyrocessToolkit method of a toolkit applet, the current file is the MF. The toolkit applet file context remains unchanged during the whole execution of the yroc

49、essToolkit method, the current record may be altered if the current file is a cyclic file and the content of the current file may be altered. This method returns the selected file information; Read the file status information of the current DF; Read data bytes of the transparent EF currently selected by the applet; Read data bytes of the linear fixed or cyclic EF currently selected by the applet without changing the current record pointer of any other applet / subscriber. This method allows reading p