ETSI TS 101 955-2004 Digital cellular telecommunications system (Phase 2+) Test specification for Subscriber Interace Module (SIM) Application Programme Interface (API) for Java ca.pdf

1、 ETSI TS 101 955 V8.3.0 (2004-12)Technical Specification Digital cellular telecommunications system (Phase 2+);Test specification for Subscriber Interface Module (SIM)Application Programme Interface (API) for Java card(3GPP TS 11.13 version 8.3.0 Release 1999)GLOBAL SYSTEM FOR MOBILE COMMUNICATIONSR

2、floppy3 ETSI ETSI TS 101 955 V8.3.0 (2004-12) 1 3GPP TS 11.13 version 8.3.0 Release 1999 Reference RTS/TSGT-031113v830 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

3、 non lucratif enregistre 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 d

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

5、e 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 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: htt

6、p:/portal.etsi.org/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

7、, PLUGTESTSTM and UMTSTM 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 Organiza

8、tional Partners. ETSI ETSI TS 101 955 V8.3.0 (2004-12) 2 3GPP TS 11.13 version 8.3.0 Release 1999 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 avail

9、able for ETSI members 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 serve

10、r (http:/webapp.etsi.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,

11、 or may become, essential 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. The

12、se should be interpreted 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 101 955 V8.3.0 (2004-12) 3 3GPP TS 11.13 version 8.3.0 Release 1999 Contents

13、Intellectual Property Rights2 Foreword.2 Foreword.9 1 Scope 10 2 References 10 3 Definitions and abbreviations.11 3.1 Definitions11 3.2 Abbreviations .11 4 Test Environment .12 4.1 Applicability.12 4.2 Test environment description .12 4.3 Tests format13 4.3.1 Test Area Reference13 4.3.1.1 Conformanc

14、e requirements .14 4.3.1.2 Test Area files .14 4.3.1.3 Test Procedure.15 4.3.1.4 Test Coverage .15 4.4 Initial Conditions15 4.5 Package name.15 4.6 AID Coding16 4.6.1 Specific Test Applet Name for API 16 4.6.2 Specific Test Applet Name for Framework 17 4.7 Test Equipment 17 4.7.1 APDU tool 17 4.7.2

15、Util package 18 4.7.3 Applet installation parameters .18 4.7.3.1 Security parameters.18 4.7.3.2 Loading components .18 4.8 Testing methodology18 4.8.1 Test interfaces and facilities18 5 Test plan .18 6 API Test Plan .19 6.1 Package sim.access:19 6.1.1 Interface SIMView .19 6.1.1.1 Constants.19 6.1.1

16、.2 Method select(short fid, byte fci, short fciOffset, short fciLength) 19 6.1.1.3 Method select (short fid) .23 6.1.1.4 Method status 26 6.1.1.5 Method readBinary28 6.1.1.6 Method updateBinary30 6.1.1.7 Method readRecord.33 6.1.1.8 Method updateRecord .39 6.1.1.9 Method seek 45 6.1.1.10 Method incr

17、ease 49 6.1.1.11 Method invalidate .52 6.1.1.12 Method rehabilitate .53 6.1.2 Class SIMSystem55 6.1.2.1 Method getTheSIMView 55 6.1.3 Class SIMViewException.56 6.1.3.1 Method throwIt .56 6.1.3.2 Constructor57 6.1.3.3 Reason Codes58 ETSI ETSI TS 101 955 V8.3.0 (2004-12) 4 3GPP TS 11.13 version 8.3.0

18、Release 1999 6.2 Package sim.toolkit 58 6.2.1 Interface ToolkitConstants58 6.2.1.1 Constants.58 6.2.2 Interface ToolkitInterface .59 6.2.2.1 Method processToolkit59 6.2.3 Class EditHandler .60 6.2.4 Class EnvelopeHandler.60 6.2.4.1 Method getEnvelopeTag .60 6.2.4.2 Method getItemIdentifier 61 6.2.4.

19、3 Method getSecuredDataLength.63 6.2.4.4 Method getSecuredDataOffset 65 6.2.4.5 Method getTheHandler .67 6.2.4.6 Method getTPUDLOffset68 6.2.4.7 Method getLength .70 6.2.4.8 Method copy .71 6.2.4.9 Method findTLV .73 6.2.4.10 Method getValueLength74 6.2.4.11 Method getValueByte .75 6.2.4.12 Method c

20、opyValue76 6.2.4.13 Method compareValue 79 6.2.4.14 Method findAndCopyValue(byte tag, byte dstBuffer, short dstOffset)81 6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength)83 6.2.4.16 Method findAndCompareValue(byte tag, by

21、te compareBuffer, short compareOffset)86 6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength).88 6.2.5 Class EnvelopeResponseHandler91 6.2.5.1 Method getTheHandler .91 6.2.5.2 Method post.92 6.2.5.3 Method pos

22、tAsBERTLV.94 6.2.5.4 Method getLength .96 6.2.5.5 Method copy .97 6.2.5.6 Method findTLV .98 6.2.5.7 Method getValueLength100 6.2.5.8 Method getValueByte .101 6.2.5.9 Method copyValue103 6.2.5.10 Method compareValue 105 6.2.5.11 Method findAndCopyValue(byte tag, byte dstBuffer, short valueOffset)108

23、 6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength)110 6.2.5.13 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset)113 6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOff

24、set, byte compareBuffer, short compareOffset, short compareLength).116 6.2.5.15 Method appendArray 119 6.2.5.16 Method appendTLV(byte tag, byte value) 121 6.2.5.17 Method appendTLV(byte tag, byte value1, byte value2)123 6.2.5.18 Method appendTLV(byte tag, byte value, short valueoffset, short valuele

25、ngth).124 6.2.5.19 Method appendTLV(byte tag, byte value1, byte value2, short value2offset, short value2length) 126 6.2.5.20 Method clear .129 6.2.6 Class MEProfile130 6.2.6.1 Method check (byte index)130 6.2.6.2 Method check (byte mask, short offset, short length).131 6.2.6.3 Method check (short in

26、dex).132 6.2.6.4 Method getValue (short indexMSB, short indexLSB) 133 6.2.6.5 Method copy (short startOffset, byte dstBuffer, short dstOffset, short dstLength) 134 6.2.7 Class ProactiveHandler.136 6.2.7.1 Method getTheHandler .136 6.2.7.2 Method init137 6.2.7.3 Method initDisplayText 139 6.2.7.4 Met

27、hod initGetInkey .142 6.2.7.5 Method initGetInput145 6.2.7.6 Method send148 ETSI ETSI TS 101 955 V8.3.0 (2004-12) 5 3GPP TS 11.13 version 8.3.0 Release 1999 6.2.7.7 Method getLength .151 6.2.7.8 Method copy .152 6.2.7.9 Method findTLV .153 6.2.7.10 Method getValueLength155 6.2.7.11 Method getValueBy

28、te .156 6.2.7.12 Method copyValue158 6.2.7.13 Method compareValue 160 6.2.7.14 Method findAndCopyValue(byte tag, byte dstBuffer, short valueOffset)163 6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength)165 6.2.7.16 Method fi

29、ndAndCompareValue(byte tag, byte compareBuffer, short compareOffset)168 6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength).171 6.2.7.18 Method appendArray 175 6.2.7.19 Method appendTLV(byte tag, byte value) 1

30、77 6.2.7.20 Method appendTLV(byte tag, byte value1, byte value2)178 6.2.7.21 Method appendTLV(byte tag, byte value, short valueoffset, short valuelength).180 6.2.7.22 Method appendTLV(byte tag, byte value1, byte value2, short value2offset, short value2length) 183 6.2.7.23 Method clear .185 6.2.8 Cla

31、ss ProactiveResponseHandler186 6.2.8.1 Method copyAdditionalInformation186 6.2.8.2 Method copyTextString 190 6.2.8.3 Method getAdditionalInformationLength .194 6.2.8.4 Method getGeneralResult196 6.2.8.5 Method getItemIdentifier 198 6.2.8.6 Method getTextStringCodingScheme .200 6.2.8.7 Method GetText

32、StringLength .202 6.2.8.8 Method getTheHandler .204 6.2.8.9 Method getLength .205 6.2.8.10 Method copy .206 6.2.8.11 Method findTLV .208 6.2.8.12 Method getValueLength210 6.2.8.13 Method getValueByte .211 6.2.8.14 Method copyValue213 6.2.8.15 Method compareValue 215 6.2.8.16 Method findAndCopyValue(

33、byte tag, byte dstBuffer, short valueOffset)218 6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength)220 6.2.8.18 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset)223 6.2.8.19 Method findAndCompareV

34、alue(byte tag, byte occurence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength).226 6.2.9 Class ToolkitRegistry .230 6.2.9.1 Method allocateTimer .230 6.2.9.2 Method changeMenuEntry231 6.2.9.3 Method clearEvent 238 6.2.9.4 Method disableMenuEntry240 6.2.9.5 Method ena

35、bleMenuEntry.242 6.2.9.6 Method getEntry .244 6.2.9.7 Method getPollInterval244 6.2.9.8 Method initMenuEntry246 6.2.9.9 Method isEventSet 251 6.2.9.10 Method releaseTimer 253 6.2.9.11 Method requestPollInterval.254 6.2.9.12 Method setEvent .256 6.2.9.13 Method setEventList .258 6.2.10 Class ViewHand

36、ler .262 6.2.11 Class ToolkitException.262 6.2.11.1 Exception Constants262 6.2.11.2 Constructor ToolkitException.263 6.2.11.3 Method throwIt .264 6.3 SIM Toolkit Framework.265 6.3.1 Minimum Handler Availability.265 ETSI ETSI TS 101 955 V8.3.0 (2004-12) 6 3GPP TS 11.13 version 8.3.0 Release 1999 6.3.

37、1.1 ProactiveHandler.265 6.3.1.2 ProactiveResponseHandler .271 6.3.1.3 EnvelopeHandler.285 6.3.1.4 EnvelopeResponseHandler .292 6.3.2 Handler Integrity.301 6.3.2.1 ProactiveHandler.301 6.3.2.2 ProactiveResponseHandler .303 6.3.2.3 EnvelopeHandler.305 6.3.3 Applet Triggering .324 6.3.3.1 EVENT_PROFIL

38、E_DOWNLOAD 324 6.3.3.2 EVENT_MENU_SELECTION 326 6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 328 6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV.330 6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV.331 6.3.3.6 EVENT_CALL_CONTROL_BY_SIM332 6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 334 6.3.3.8 EVENT_TIMER_EXPIRATION .336 6.3

39、.3.9 EVENT_UNFORMATTED_SMS_CB 338 6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL.339 6.3.3.11 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED.340 6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 342 6.3.3.13 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS343 6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 344 6.3.3.15 EVENT_EVENT_DOWNL

40、OAD_IDLE_SCREEN_AVAILABLE 346 6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS .348 6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE350 6.3.3.18 EVENT_STATUS_COMMAND .352 6.3.3.19 EVENT_FORMATTED_SMS_CB 354 6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION355 6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 357

41、 6.3.4 Proactive Command Sending by the STF.359 6.3.4.1 System Proactive Commands359 6.3.4.2 Interaction with GSM commands .360 6.3.5 Exception Handling 362 6.3.5.1 Hide Exceptions from the ME.362 6.3.5.2 Interaction with Multiple Triggering.362 6.3.6 Framework Security Management364 6.3.6.1 Input D

42、ata364 6.3.6.2 Output Data.367 6.3.7 Envelope Response Posting 368 6.3.7.1 EVENT_CALL_CONTROL_BY_SIM368 6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 370 6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE372 6.3.8 Toolkit Installation372 6.3.8.1 Timers Allocation .372 6.3.8.2 Item Identifier .374 6.3.8.3 Item Posi

43、tion .376 6.3.8.4 Maximum Text Length for a menu entry 378 6.3.8.5 Maximum number of menu entries .380 6.3.8.6 Access Domain .381 6.3.8.7 Priority Level 387 6.3.9 File System Context391 6.3.9.1 Initial Context .391 6.3.9.2 Context Preservation (current file)392 6.3.9.3 Context Preservation (current

44、record pointer).394 6.3.10 Other parts transferred to framework from API397 6.3.10.1 A handler is a temporary JCRE Entry Point object.397 6.3.10.2 Transaction398 6.3.10.3 Timer Id between Applets.399 Annex A (normative): Class and Methods AID numbering and acronyms400 ETSI ETSI TS 101 955 V8.3.0 (20

45、04-12) 7 3GPP TS 11.13 version 8.3.0 Release 1999 A.1 Sim.access 400 A.1.1 SIMView methods400 A.1.2 SIMSystem methods.400 A.1.3 SIMViewException methods400 A.2 Sim.toolkit401 A.2.1 ToolkitConstants 401 A.2.2 ToolkitInterface methods .401 A.2.3 EditHandler methods401 A.2.4 EnvelopeHandler methods401

46、A.2.5 EnvelopeResponseHandler methods 402 A.2.6 MEProfile methods.403 A.2.7 ProactiveHandler methods403 A.2.8 ProactiveResponseHandler methods 404 A.2.9 ToolkitRegistry methods 405 A.2.10 ViewHandler methods405 A.2.11 ToolkitException methods .405 Annex B (normative): Script file syntax and format d

47、escription 406 B.1 Syntax description406 B.2 Semantics .407 B.3 Example407 B.4 Style and formatting.408 Annex C (normative): Default Prepersonalization409 C.1 General Default Prepersonalization409 C.2 Sim.Access.SimView test default prepersonalization410 C.2.1 DFSIMTEST(SIM Test) .410 C.2.2 EFTNR(Tr

48、ansparent Never Read)410 C.2.3 EFTNU(Transparent Never Update) 410 C.2.4 EFTARU(Transparent Always Read and Update)410 C.2.5 EFCNR(Cyclic Never Read)411 C.2.6 EFCNU(Cyclic Never Update).411 C.2.7 EFCNIC(Cyclic Never Increase)411 C.2.8 EFCNIV(Cyclic Never Invalidate) .412 C.2.9 EFCNRH(Cyclic Never Re

49、habilitate) .412 C.2.10 EFCARU(Cyclic Always Read and Update) 412 C.2.11 EFLNR(Linear Fixed Never Read) 413 C.2.12 EFLNU(Linear Fixed Never Update).413 C.2.13 EFLARU(Linear Fixed Always Read and Update).413 C.2.14 EFCINA(Cyclic Increase Not Allowed) .414 C.2.15 EFTRAC(Transparent Read Access Condition CHV2)414 C.2.16 EFTIAC(Transparent Invalidate Access Condition CHV1) .414 C.2.17 EFCIAC(Cyclic Increase Access Condition CHV2) 415 C.2.18 EFCIAA(Cyclic Increase Access Condition ADM) .415 C.2.19 EFCNRI(Cyclic Never Rehabilitate I