ETSI TS 143 019-2004 Digital cellular telecommunications system (Phase 2+) Subscriber Identity Module Application Programming Interface (SIM API) for Java Card Stage 2 (3GPP TS 43 .pdf

1、 ETSI TS 143 019 V6.0.0 (2004-12)Technical Specification Digital cellular telecommunications system (Phase 2+);Subscriber Identity Module Application ProgrammingInterface (SIM API) for Java Card;Stage 2(3GPP TS 43.019 version 6.0.0 Release 6)GLOBAL SYSTEM FOR MOBILE COMMUNICATIONSRfloppy3 ETSI ETSI

2、TS 143 019 V6.0.0 (2004-12) 1 3GPP TS 43.019 version 6.0.0 Release 6 Reference RTS/TSGT-0343019v600 Keywords GSM ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enreg

3、istre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in conten

4、ts 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 specific network drive within ETSI Secretariat. Users of the present document should be aware that the document

5、 may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/

6、chaircor/ETSI_support.asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2004. All rights reserved. DECTTM, PLUGTESTSTM and U

7、MTSTM are Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand 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 the 3GPP Organizational Partners. ET

8、SI ETSI TS 143 019 V6.0.0 (2004-12) 2 3GPP TS 43.019 version 6.0.0 Release 6 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, is publicly available for ETSI members

9、 and non-members, and can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.

10、org/IPR/home.asp). 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 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essen

11、tial 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 interpre

12、ted as being references to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi.org/key/queryform.asp . ETSI ETSI TS 143 019 V6.0.0 (2004-12) 3 3GPP TS 43.019 version 6.0.0 Release 6 Contents Intellectual Property R

13、ights2 Foreword.2 Foreword.4 1 Scope 5 2 References 5 3 Definitions and abbreviations.6 3.1 Definitions6 3.2 Abbreviations .6 4 Description .7 4.1 GSM Java Card Architecture7 4.2 Java Card Selection Mechanism.8 5 GSM Framework8 5.1 Overview 8 5.2 GSM file data access 8 5.3 Access control 9 5.4 GSM l

14、ow Level API.9 6 SIM Toolkit Framework.9 6.1 Overview 9 6.2 Applet Triggering.10 6.3 Registration 14 6.4 Proactive command handling .14 6.5 Envelope response handling.15 6.6 Handler availability 15 6.7 SIM Toolkit Framework behaviour17 6.8 Usage of ViewHandler and EditHandler 18 7 SIM toolkit applet

15、.18 7.1 Applet Loading.18 7.2 Object Sharing18 Annex A (normative): Java Card SIM API .19 Annex B (normative): Java Card SIM API identifiers.20 Annex C (normative): SIM API package version management.21 Annex D (informative): Toolkit applet example 23 Annex E (informative): Change history .24 Histor

16、y 25 ETSI ETSI TS 143 019 V6.0.0 (2004-12) 4 3GPP TS 43.019 version 6.0.0 Release 6 Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3GPP) based on work originally done by the Special Mobile Group (SMG) in ETSI. The contents of the present document ar

17、e subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows: Version x.y.z where: x the

18、first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG approved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third digit is incremente

19、d when editorial only changes have been incorporated in the document. ETSI ETSI TS 143 019 V6.0.0 (2004-12) 5 3GPP TS 43.019 version 6.0.0 Release 6 1 Scope The present document defines the stage two description of the Subscriber Identity Module Application Programming Interface (SIM API) internal t

20、o 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 providers and SIM, server and database manufacturers. 2 Re

21、ferences 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.) or non-specific. For a specific reference, subsequent rev

22、isions do not apply. For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document. 1 3GPP TR 21.905: “A

23、bbreviations and acronyms“. 2 3GPP TS 51.011: “Specification of the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface“. 3 3GPP TS 11.14: “Specification of the SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface“. 4 3GPP TS 23.048: “Secu

24、rity Mechanisms for the SIM application toolkit; Stage 2“. 5 ISO/IEC 7816-3 (1997) “ Identification cards - Integrated circuit(s) cards with contacts, Part 3: Electronic signals and transmission protocols“. 6 3GPP TS 42.019: “Subscriber Identity Module Application Programming Interface (SIM API); Se

25、rvice description; Stage 1“. 7 SUN Java Card Specification “Java Card 2.1 API Specification“. 8 SUN Java Card Specification “Java Card 2.1 Runtime Environment Specification“. 9 SUN Java Card Specification “Java Card 2.1 VM Architecture Specification“. SUN Java Card Specifications can be downloaded a

26、t http:/ 10 ETSI TS 101 220 “Integrated Circuit Cards (ICC); ETSI numbering system for telecommunication; Application providers (AID)“. 11 3GPP TS 23.040: “Technical realization of the Short Message Service (SMS)“ 12 ISO/IEC 7816-6 (1995): “Identification cards - Integrated circuit(s) cards with con

27、tacts, Part 6 Inter-industry data elements“. ETSI ETSI TS 143 019 V6.0.0 (2004-12) 6 3GPP TS 43.019 version 6.0.0 Release 6 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present document, the following terms and definitions apply: Applet : An Applet is an application built

28、up using a number of classes which will run under the control of the Java Card virtual machine. Applets designed for 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 t

29、hat defines the implementation of a particular kind of object. A Class definition defines instance and class variables and methods. Framework : A framework defines a set of Application Programming Interface (API) classes for developing applications and for providing system services to those applicat

30、ions. GSM applet : The GSM application conforming to TS 51.011. It might be a Java Card applet or native application. 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,

31、 possibly passing it certain values as arguments. Every Method definition belongs to some class. Object : The principal 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

32、declared when writing a Java Card program Toolkit applet : Applet loaded onto the SIM card seen by the Mobile as being 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

33、part of the Run-time environment responsible for interpreting the bytecode. 3.2 Abbreviations For the purposes of the present document, the following abbreviations apply, in addition to those listed in TR 21.905 1: AC Application Code AID Application IdentifierAPDU Application Protocol Data Unit API

34、 Application Programming Interface CAD Card Acceptance Device FFS For Further Study IFD Interface Device JCRE Java Card Run Time Environment JVM Java Virtual Machine ME Mobile Equipment MS Mobile Station SIM Subscriber Identity Module SE Sending Entity SMS-CB Short Message Service Cell Broadcast SMS

35、-PP Short Message Service Point to Point USSD Unstructured Supplementary Services Data VM Virtual Machine ETSI ETSI TS 143 019 V6.0.0 (2004-12) 7 3GPP TS 43.019 version 6.0.0 Release 6 4 Description The present document describes an API for the GSM SIM. This API allows application programmers access

36、 to the functions and data described in TS 51.011 2 and TS 11.14 3, such that SIM based services can be developed 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 Enviro

37、nment 8. 4.1 GSM Java Card Architecture The over all architecture of the SIM Toolkit API based on Java Card 2.1 is: Applets Applets ToolkitAppletsToolkitAppletsJCREFile SystemGSMAppletSIM Toolkit FrameworkToolkitRegistryToolkitHandlerToolkitAppletsApplets LoaderAppletshareable interfaceFigure 1: GSM

38、 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 in Java Card 2.1 Runtime Environment Specification 8 and is able to select any specific app

39、let 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 handling the availability of the system handler and the toolkit protocol (i.e. toolkit applet susp

40、ension). 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.SIMView. Applets: these derive from javacard.framework.applet and provide the entry points : pro

41、cess, select, deselect, install as defined in the Java Card 2.1 Runtime Environment Specification 8. Toolkit applets: these derive from javacard.framework.applet, so provide the same entry points, and implement the shareable interface sim.toolkit.ToolkitInterface so that these applets can be trigger

42、ed by an invocation of their processToolkit method. These applets AID is defined in TS 101 220 10. ETSI ETSI TS 143 019 V6.0.0 (2004-12) 8 3GPP TS 43.019 version 6.0.0 Release 6 GSM Applet: this is the default applet as defined in Java Card 2.1 Runtime Environment Specification 8, it behaves as regu

43、lar 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 10. This applet handles the TS 51.0112 APDUs, CHV1/2, the GSM authentication algorithm and the subscriber file access control according to TS 51.0112. Loader apple

44、t: this is handling the installation and uninstallation of the applets as specified in the applet loading specification TS 23.048 4. Shareable interface: this is defined in the Java Card 2.1 specifications. 4.2 Java Card Selection Mechanism The Java Card selection mechanism is defined in the Java Ca

45、rd Runtime Environment Specification 8. 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 level package FFS; - The sim.access package, which allows applets to access the GSM files. 5.2

46、GSM file data access The following methods shall be offered by the API to card applets, to allow access to the GSM data: select Select a file without changing the current file of any other applet or of the subscriber session. At the invocation of the processToolkit method of a toolkit applet, the cu

47、rrent file is the MF. The toolkit applet file context remains unchanged during the whole execution of the processToolkit 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 informatio

48、n; status Read the file status information of the current DF; readBinary Read data bytes of the transparent EF currently selected by the applet; readRecord Read data bytes of the linear fixed or cyclic EF currently selected by the applet without changing the current record pointer of any other apple

49、t / subscriber. This method allows reading part of a record; updateBinary Modify data bytes of the transparent EF currently selected by the applet. The toolkit applet shall send the corresponding refresh ; updateRecord Modify data bytes of the linear fixed or cyclic EF currently selected by the applet. The current record pointer of other applets / subscriber shall not be changed in case of linear fixed EF but the record pointer of a cyclic EF shall be changed for all other applet