ETSI TS 151 013-2017 Digital cellular telecommunications system (Phase 2+) (GSM) Test specification for Subscriber Identity Module (SIM) Application Programming Interface (API) for.pdf

1、 ETSI TS 151 013 V14.0.0 (2017-04) Digital cellular telecommunications system (Phase 2+) (GSM); Test specification for Subscriber Identity Module (SIM) Application Programming Interface (API) for Java Card (3GPP TS 51.013 version 14.0.0 Release 14) G L O B AL SYST E M F O R M O B IL E CO M M U NICAT

2、 IO NSR TECHNICAL SPECIFICATION ETSI ETSI TS 151 013 V14.0.0 (2017-04) 1 3GPP TS 51.013 version 14.0.0 Release 14 Reference RTS/TSGC-0651013ve00 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 -

3、 NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice The present document can be downloaded from: http:/www.etsi.org/standards-search The present document may be made available in electronic versions and/or in print. The content of any electr

4、onic and/or print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any existing or perceived difference in contents between such versions and/or in print, the only prevailing document is the print of the Portable Document Format (PDF)

5、 version kept on a specific 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 https:/portal.etsi.org/TB/ETSIDelivera

6、bleStatus.aspx If you find errors in the present document, please send your comment to one of the following services: https:/portal.etsi.org/People/CommiteeSupportStaff.aspx Copyright Notification No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including

7、photocopying and microfilm except as authorized by written permission of ETSI. The content of the PDF version shall not be modified without the written authorization of ETSI. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Instit

8、ute 2017. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTM and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM and LTE a re Trade Marks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Ma

9、rks registered and owned by the GSM Association. ETSI ETSI TS 151 013 V14.0.0 (2017-04) 2 3GPP TS 51.013 version 14.0.0 Release 14 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essentia

10、l IPRs, if any, is publicly available 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 ar

11、e available on the ETSI Web server (https:/ipr.etsi.org/). 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) wh

12、ich are, or may be, 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

13、GSM identities. These 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. Modal verbs terminology In the present document “shall“, “shall not“, “s

14、hould“, “should not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“ are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of provisions). “must“ and “must not“ are NOT allowed in ETSI deliverables except when used in direct citation.

15、 ETSI ETSI TS 151 013 V14.0.0 (2017-04) 3 3GPP TS 51.013 version 14.0.0 Release 14 Contents Intellectual Property Rights 2 Foreword. 2 Modal verbs terminology . 2 Foreword. 9 1 Scope 10 2 References 10 3 Definitions and abbreviations . 11 3.1 Definitions . 11 3.2 Abbreviations . 11 4 Test Environmen

16、t . 12 4.1 Applicability 12 4.2 Test environment description . 12 4.3 Tests format . 13 4.3.1 Test Area Reference . 13 4.3.1.1 Conformance 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 Conditions . 15 4.5 Package name 15 4.6 AID Coding

17、 . 16 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 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 methodology . 18 4.8.

18、1 Test interfaces and facilities . 18 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.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 25 6

19、.1.1.5 Method readBinary . 27 6.1.1.6 Method updateBinary . 30 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 increase 49 6.1.1.11 Method invalidate . 52 6.1.1.12 Method rehabilitate . 53 6.1.2 Class SIMSystem . 55 6.1.2.1 Method getTheSIMView 55

20、6.1.3 Class SIMViewException 56 6.1.3.1 Method throwIt . 56 ETSI ETSI TS 151 013 V14.0.0 (2017-04) 4 3GPP TS 51.013 version 14.0.0 Release 14 6.1.3.2 Constructor . 57 6.1.3.3 Reason Codes . 58 6.2 Package sim.toolkit 58 6.2.1 Interface ToolkitConstants . 58 6.2.1.1 Constants 58 6.2.2 Interface Toolk

21、itInterface . 59 6.2.2.1 Method processToolkit . 59 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.3 Method getSecuredDataLength 62 6.2.4.4 Method getSecuredDataOffset 66 6.2.4.5 Method getTheHandler . 69 6.2.4

22、.6 Method getTPUDLOffset . 70 6.2.4.7 Method getLength 72 6.2.4.8 Method copy . 73 6.2.4.9 Method findTLV 75 6.2.4.10 Method getValueLength . 76 6.2.4.11 Method getValueByte . 77 6.2.4.12 Method copyValue . 79 6.2.4.13 Method compareValue . 81 6.2.4.14 Method findAndCopyValue(byte tag, byte dstBuffe

23、r, short dstOffset) . 84 6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength) . 86 6.2.4.16 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset) . 89 6.2.4.17 Method findAndCompareValue(byte tag, byt

24、e occurrence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength) 91 6.2.4.18 Method getCapacity 95 6.2.4.19 Method getUserDataLength . 96 6.2.4.20 Method getChannelIdentifier 98 6.2.5 Class EnvelopeResponseHandler . 100 6.2.5.1 Method getTheHandler . 100 6.2.5.2 Method

25、post 101 6.2.5.3 Method postAsBERTLV 103 6.2.5.4 Method getLength 104 6.2.5.5 Method copy . 105 6.2.5.6 Method findTLV 107 6.2.5.7 Method getValueLength . 109 6.2.5.8 Method getValueByte . 110 6.2.5.9 Method copyValue . 111 6.2.5.10 Method compareValue . 114 6.2.5.11 Method findAndCopyValue(byte tag

26、, byte dstBuffer, short valueOffset) . 116 6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength) . 119 6.2.5.13 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset) . 122 6.2.5.14 Method findAndCompar

27、eValue(byte tag, byte occurrence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength) 124 6.2.5.15 Method appendArray 128 6.2.5.16 Method appendTLV(byte tag, byte value) 130 6.2.5.17 Method appendTLV(byte tag, byte value1, byte value2) . 131 6.2.5.18 Method appendTLV(byt

28、e tag, byte value, short valueoffset, short valuelength) 133 6.2.5.19 Method appendTLV(byte tag, byte value1, byte value2, short value2offset, short value2length) 135 6.2.5.20 Method clear . 138 6.2.5.21 Method getCapacity 139 6.2.6 Class MEProfile . 140 6.2.6.1 Method check (byte index) . 140 6.2.6

29、.2 Method check (byte mask, short offset, short length) 141 6.2.6.3 Method check (short index) 142 6.2.6.4 Method getValue (short indexMSB, short indexLSB) . 143 6.2.6.5 Method copy (short startOffset, byte dstBuffer, short dstOffset, short dstLength) 144 6.2.7 Class ProactiveHandler 146 ETSI ETSI T

30、S 151 013 V14.0.0 (2017-04) 5 3GPP TS 51.013 version 14.0.0 Release 14 6.2.7.1 Method getTheHandler . 146 6.2.7.2 Method init . 147 6.2.7.3 Method initDisplayText 149 6.2.7.4 Method initGetInkey. 152 6.2.7.5 Method initGetInput . 155 6.2.7.6 Method send . 158 6.2.7.7 Method getLength 161 6.2.7.8 Met

31、hod copy . 162 6.2.7.9 Method findTLV 163 6.2.7.10 Method getValueLength . 165 6.2.7.11 Method getValueByte . 166 6.2.7.12 Method copyValue . 167 6.2.7.13 Method compareValue . 170 6.2.7.14 Method findAndCopyValue(byte tag, byte dstBuffer, short valueOffset) . 173 6.2.7.15 Method findAndCopyValue(by

32、te tag, byte occurence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength) . 175 6.2.7.16 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset) . 178 6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte compareBuffer, short c

33、ompareOffset, short compareLength) 181 6.2.7.18 Method appendArray 184 6.2.7.19 Method appendTLV(byte tag, byte value) 186 6.2.7.20 Method appendTLV(byte tag, byte value1, byte value2) . 188 6.2.7.21 Method appendTLV(byte tag, byte value, short valueoffset, short valuelength) . 189 6.2.7.22 Method a

34、ppendTLV(byte tag, byte value1, byte value2, short value2offset, short value2length) . 192 6.2.7.23 Method clear . 194 6.2.7.24 Method getCapacity 195 6.2.7.25 Method initCloseChannel . 196 6.2.8 Class ProactiveResponseHandler . 198 6.2.8.1 Method copyAdditionalInformation . 198 6.2.8.2 Method copyT

35、extString 201 6.2.8.3 Method getAdditionalInformationLength. 205 6.2.8.4 Method getGeneralResult . 207 6.2.8.5 Method getItemIdentifier 209 6.2.8.6 Method getTextStringCodingScheme 211 6.2.8.7 Method GetTextStringLength . 213 6.2.8.8 Method getTheHandler . 215 6.2.8.9 Method getLength 216 6.2.8.10 M

36、ethod copy . 217 6.2.8.11 Method findTLV 219 6.2.8.12 Method getValueLength . 221 6.2.8.13 Method getValueByte . 222 6.2.8.14 Method copyValue . 223 6.2.8.15 Method compareValue . 226 6.2.8.16 Method findAndCopyValue(byte tag, byte dstBuffer, short valueOffset) . 228 6.2.8.17 Method findAndCopyValue

37、(byte tag, byte occurence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength) . 231 6.2.8.18 Method findAndCompareValue(byte tag, byte compareBuffer, short compareOffset) . 234 6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, byte compareBuffer, shor

38、t compareOffset, short compareLength) 236 6.2.8.20 Method getCapacity 240 6.2.8.21 Method getChannelIdentifier 241 6.2.8.22 Method copyChannelData 244 6.2.9 Class ToolkitRegistry . 248 6.2.9.1 Method allocateTimer. 248 6.2.9.2 Method changeMenuEntry . 249 6.2.9.3 Method clearEvent 256 6.2.9.4 Method

39、 disableMenuEntry . 258 6.2.9.5 Method enableMenuEntry 259 6.2.9.6 Method getEntry . 261 6.2.9.7 Method getPollInterval . 262 6.2.9.8 Method initMenuEntry . 264 6.2.9.9 Method isEventSet 269 ETSI ETSI TS 151 013 V14.0.0 (2017-04) 6 3GPP TS 51.013 version 14.0.0 Release 14 6.2.9.10 Method releaseTime

40、r 271 6.2.9.11 Method requestPollInterval 272 6.2.9.12 Method setEvent . 274 6.2.9.13 Method setEventList . 278 6.2.10 Class ViewHandler . 283 6.2.11 Class ToolkitException 283 6.2.11.1 Exception Constants . 283 6.2.11.2 Constructor ToolkitException 283 6.2.11.3 Method throwIt . 284 6.3 SIM Toolkit

41、Framework 285 6.3.1 Minimum Handler Availability 285 6.3.1.1 ProactiveHandler 285 6.3.1.2 ProactiveResponseHandler . 293 6.3.1.3 EnvelopeHandler 305 6.3.1.4 EnvelopeResponseHandler . 312 6.3.2 Handler Integrity 329 6.3.2.1 ProactiveHandler 329 6.3.2.2 ProactiveResponseHandler . 331 6.3.2.3 EnvelopeH

42、andler 333 6.3.2.4 EnvelopeResponseHandler . 357 6.3.3 Applet Triggering . 358 6.3.3.1 EVENT_PROFILE_DOWNLOAD . 358 6.3.3.2 EVENT_MENU_SELECTION 359 6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 361 6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV 365 6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV 366 6.3.3.6 EVENT_CALL_CONTRO

43、L_BY_SIM . 368 6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 370 6.3.3.8 EVENT_TIMER_EXPIRATION . 371 6.3.3.9 EVENT_UNFORMATTED_SMS_CB 373 6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL 374 6.3.3.11 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 375 6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 377 6.3.3.13 EVENT_EVE

44、NT_DOWNLOAD_LOCATION_STATUS . 378 6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 379 6.3.3.15 EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 381 6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS . 382 6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE . 384 6.3.3.18 EVENT_STATUS_COMMAND . 385 6.3.3.19 EVENT_FORMATTED_SMS

45、_CB . 387 6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION . 389 6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 390 6.3.3.22 EVENT_FIRST_COMMAND_AFTER_SELECT 392 6.3.3.23 EVENT_EVENT_DOWNLOAD_DATA_AVAILABLE . 394 6.3.3.24 EVENT_EVENT_DOWNLOAD_CHANNEL_STATUS . 396 6.3.3.25 EVENT_FORMATTED_SMS_PP_U

46、PD 399 6.3.3.26 EVENT_UNFORMATTED_SMS_PP_UPD . 401 6.3.4 Proactive Command Sending by the STF 403 6.3.4.1 System Proactive Commands . 403 6.3.4.2 Interaction with GSM commands . 404 6.3.4.3 Proactive Command Control 406 6.3.5 Exception Handling 408 6.3.5.1 Hide Exceptions from the ME 408 6.3.5.2 Int

47、eraction with Multiple Triggering 409 6.3.6 Framework Security Management . 410 6.3.6.1 Input Data . 411 6.3.6.2 Output Data 416 6.3.7 Envelope Response Posting . 417 6.3.7.1 EVENT_CALL_CONTROL_BY_SIM . 417 6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 420 6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE . 422 6

48、.3.7.4 EVENT_FORMATTED_SMS_PP_ENV 422 ETSI ETSI TS 151 013 V14.0.0 (2017-04) 7 3GPP TS 51.013 version 14.0.0 Release 14 6.3.8 Toolkit Installation . 425 6.3.8.1 Timers Allocation . 425 6.3.8.2 Item Identifier . 427 6.3.8.3 Item Position . 429 6.3.8.4 Maximum Text Length for a menu entry 430 6.3.8.5

49、Maximum number of menu entries . 432 6.3.8.6 Access Domain . 433 6.3.8.7 Priority Level 439 6.3.8.8 Channel Allocation . 443 6.3.8.9 Minimum Security Level 445 6.3.9 File System Context . 446 6.3.9.1 Initial Context . 446 6.3.9.2 Context Preservation (current file) . 447 6.3.9.3 Context Preservation (current record pointer) 449 6.3.10 Other parts transferred to framework from API . 452 6.3.10.1 A handler is a temporary JCRE Entry Point object 452 6.3.10.2 Transaction . 453 6.3.10.3 Timer Id between Applets 454 6.3.11 Concate