ETSI TS 131 213-2016 Universal Mobile Telecommunications System (UMTS) LTE Test specification for (U)SIM Application Programming Interface (API) for Java Card (V13 0 0 3GPP TS 31 2.pdf

1、 ETSI TS 1Universal Mobile TelTest spApplication Programm(3GPP TS 31.2floppy3TECHNICAL SPECIFICATION131 213 V13.0.0 (2016elecommunications System (LTE; specification for (U)SIM; mming Interface (API) for Java.213 version 13.0.0 Release 1316-02) (UMTS); va Card 13) ETSI ETSI TS 131 213 V13.0.0 (2016-

2、02)13GPP TS 31.213 version 13.0.0 Release 13Reference RTS/TSGC-0631213vd00 Keywords LTE,UMTS 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 enregistre la Sous-Prfect

3、ure 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 electronic and/or print versions of the present document shall not be m

4、odified 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) version kept on a specific network drive within ETSI Secretariat

5、. 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 http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your

6、 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 photocopying and microfilm except as authorized by written permission of ET

7、SI. 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 Institute 2016. All rights reserved. DECTTM, PLUGTESTSTM, UMTSTMand the ETSI logo

8、 are Trade Marks of ETSI registered for the benefit of its Members. 3GPPTM and LTE are Trade Marks of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. GSM and the GSM logo are Trade Marks registered and owned by the GSM Association. ETSI ETSI TS 131 213 V13.0.0

9、 (2016-02)23GPP TS 31.213 version 13.0.0 Release 13Intellectual 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 and non-members, and can

10、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 (https:/ipr.etsi.org/). Pursuant to the ETSI

11、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, essential to the present document. Foreword T

12、his 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 interpreted as being references to the correspon

13、ding 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“, “should“, “should not“, “may“, “need not“, “will“, “will not“, “can“ and “cannot“

14、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. ETSI ETSI TS 131 213 V13.0.0 (2016-02)33GPP TS 31.213 version 13.0.0 Release 13

15、Contents Intellectual Property Rights 2g3Foreword . 2g3Modal verbs terminology 2g3Foreword . 6g31 Scope 7g32 References 7g33 Definitions, symbols and abbreviations . 8g33.1 Definitions 8g33.2 Abbreviations . 8g34 Test environment 9g34.1 Applicability . 9g34.2 Test environment description . 9g34.3 Te

16、sts format 10g34.3.1 Test area reference 10g34.3.1.1 Conformance requirements . 10g34.3.1.2 Test area files 11g34.3.1.3 Test procedure . 11g34.3.1.4 Test coverage 11g34.4 Initial conditions . 11g34.5 Package name . 11g34.6 AID coding . 12g34.7 Test equipment . 13g34.7.1 Test tool 13g34.7.2 Interface

17、s and classes use . 13g34.7.3 Util package 13g34.7.4 Java Software Development kit version 13g35 Test plan . 13g35.1 Package uicc.usim.access package . 13g35.1.1 Interface SIMConstants 13g35.1.2 Interface USIMConstants . 14g35.2 Package uicc.usim.toolkit package . 14g35.2.1 Interface ToolkitConstant

18、s 14g35.2.2 Interface USATEnvelopeHandler . 14g35.2.2.1 Method getSecuredDataLength . 14g35.2.2.2 Method getSecuredDataOffset 18g35.2.2.3 Method getShortMessageLength . 21g35.2.2.4 Method getShortMessageOffset 24g35.2.2.5 Method getTPUDLOffset 28g35.2.2.6 Method getUserDataLength 30g35.2.2.7 Method

19、getItemIdentifier 33g35.2.2.8 Method getChannelIdentifier 34g35.2.2.9 Method getChannelStatus . 37g35.2.2.10 Method getSize . 39g35.2.2.11 Method getTag 40g35.2.2.12 Method compareValue 41g35.2.2.13 Method copy . 43g35.2.2.14 Method copyValue 45g35.2.2.15 Method findAndCompareValue(byte tag, byte co

20、mpareBuffer, short compareOffset) 48g35.2.2.16 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, byte compareBuffer, short compareOffset, short compareLength) . 50g35.2.2.17 Method findAndCopyValue(byte tag, byte dstBuffer, short dstOffset) 53g3ETSI ETSI TS 131 213 V13.0.0 (20

21、16-02)43GPP TS 31.213 version 13.0.0 Release 135.2.2.18 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, byte dstBuffer, short dstOffset, short dstLength) 55g35.2.2.19 Method findTLV . 58g35.2.2.20 Method getCapacity 60g35.2.2.21 Method getLength . 61g35.2.2.22 Method getValueBy

22、te . 62g35.2.2.23 Method getValueLength 63g35.2.2.24 Method getValueShort 64g35.2.3 Interface USATTerminalProfile . 65g35.2.4 Class USATEnvelopeHandlerSystem . 65g35.2.4.1 Method getTheHandler . 65g35.2.5 Interface ToolkitRegistry 66g35.2.5.1 Method clearEvent 66g35.2.5.2 Method isEventSet 68g35.2.5

23、.3 Method setEvent . 69g35.2.5.4 Method setEventList . 71g35.3 (U)SAT Framework . 75g35.3.1 Minimum handler availability. 75g35.3.1.1 ProactiveHandler . 75g35.3.1.2 ProactiveResponseHandler . 80g35.3.1.3 EnvelopeHandler . 90g35.3.1.4 EnvelopeResponseHandler . 93g35.3.1.5 USATEnvelopeHandler 102g35.3

24、.1.6 Applet triggering with ongoing proactive session . 105g35.3.2 Handler integrity . 110g35.3.2.1 ProactiveResponseHandler . 110g35.3.2.2 EnvelopeHandler . 111g35.3.2.3 USATEnvelopeHandler 122g35.3.3 Exception handling . 139g35.3.3.1 General Behaviour 139g35.3.3.2 Interaction with Multiple Trigger

25、ing . 141g35.3.4 Applet triggering. 142g35.3.4.1 EVENT_FORMATTED_SMS_PP_ENV . 142g35.3.4.2 EVENT_UNFORMATTED_SMS_PP_ENV . 144g35.3.4.3 EVENT_FORMATTED_SMS_PP_UPD . 146g35.3.4.4 EVENT_UNFORMATTED_SMS_PP_UPD . 148g35.3.4.5 EVENT_FORMATTED_SMS_CB 151g35.3.4.6 EVENT_UNFORMATTED_SMS_CB 152g35.3.4.7 EVENT

26、_FORMATTED_USSD . 153g35.3.4.8 EVENT_UNFORMATTED_USSD . 155g35.3.5 Envelope response posting 156g35.3.5.1 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 156g35.3.6 Toolkit installation 158g35.3.6.1 Minimum security level 158g35.3.6.2 TAR. 159g35.3.6.3 Access domain 162g35.3.7 Other parts transferred to (U)SA

27、T framework from API 163g35.3.7.1 A handler is a temporary JCRE Entry Point object . 163g35.3.8 Framework security management . 164g35.3.8.1 Input data 165g35.3.8.2 Output data 172g35.3.9 Concatenated SMS 173g35.3.9.1 Concatenation processing 173g35.3.9.2 Test area files 174g35.3.9.3 Test coverage 1

28、74g35.3.9.4 Test procedure . 174g35.3.10 Cell Broadcast Service 176g35.3.10.1 Multiple message reassembling 176g35.3.10.2 Test area files 176g35.3.10.3 Test coverage 176g35.3.11 Concatenated USSD . 177g35.3.11.1 Concatenation processing 177g3ETSI ETSI TS 131 213 V13.0.0 (2016-02)53GPP TS 31.213 vers

29、ion 13.0.0 Release 135.3.11.2 Test area files 178g35.3.11.3 Test coverage 178g35.3.11.4 Test procedure . 178g3Annex A (normative): Class, methods and USATFramework tests acronyms. 180g3A.1 Toolkit part . 180g3A.1.1 USATEnvelopeHandler interface . 180g3A.1.2 USATEnvelopeHandlerSystem method . 180g3A.

30、1. 3 ToolkitRegistry methods 181g3A.2 Acronyms for USATFramework tests 181g3A.2.1 Minimum handler availability 181g3A.2.2 Handler integrity 181g3A.2.3 Applet triggering 181g3A.2.4 Exception handling . 181g3A.2.5 Envelope response posting . 182g3A.2.6 Toolkit installation . 182g3A.2.7 Other parts tra

31、nsferred from API to CAT RE . 182g3A.2.8 Framework security 182g3A.2.9 Concatenated SMS . 182g3A.2.10 Cell Broadcast Service . 182g3Annex B (normative): Global prepersonalization . 183g3Annex C (normative): Test file description 184g3Annex D (normative): uicc.usim.test.util package, (U)SIM interface

32、s and testing script example . 185g3Annex E (normative): Test Area files . 186g3Annex F (informative): Change history . 187g3History 188g3ETSI ETSI TS 131 213 V13.0.0 (2016-02)63GPP TS 31.213 version 13.0.0 Release 13Foreword This Technical Specification has been produced by the 3rdGeneration Partne

33、rship Project (3GPP). The contents of the present document are 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 incre

34、ase in version number as follows: Version x.y.z where: x the 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 enhancement

35、s, corrections, updates, etc. z the third digit is incremented when editorial only changes have been incorporated in the document. ETSI ETSI TS 131 213 V13.0.0 (2016-02)73GPP TS 31.213 version 13.0.0 Release 131 Scope The present document covers the minimum characteristics considered necessary in or

36、der to provide compliance to TS 31.130 2. The present document describes the technical characteristics and methods of test for testing the (U)SIM API for Java CardTM(TS 31.130 2) implemented in the (U)SIM. It specifies the following parts: - test applicability; - test environment description; - test

37、s format; - test area reference; - conformance requirements; - test suite files; - test procedure; - test coverage; and - a description of the associated testing tools that shall be used. 2 References The following documents contain provisions which, through reference in this text, constitute provis

38、ions 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 revisions do not apply. For a non-specific reference, the latest version applies. In the case of a reference to

39、 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 ETSI TS 101 220: “Integrated Circuit Cards (ICC); ETSI numbering system for telecommunication; Application providers (AID)“. 2

40、 3GPP TS 31 130 Release 6: “(U)SIM API for Java Card“ 3 Void. 4 3GPP TS 31.102: “Characteristics of the USIM Application“. 5 3GPP TS 51.011 Release 4: “Specification of the Subscriber Identity Module- Mobile Equipment (SIM ME) interface“. 6 3GPP TS 23.041: “Technical realization of Cell Broadcast Se

41、rvice (CBS)“. 7 Void. 8 3GPP TS 31.111: “USIM Application Toolkit (USAT)“. 9 Void. 10 3GPP TS 31.115: “Secured packet structure for the (U)SIM Toolkit applications“. 11 3GPP TS 23.040: “Technical realization of the Short Message Service (SMS)“. ETSI ETSI TS 131 213 V13.0.0 (2016-02)83GPP TS 31.213 v

42、ersion 13.0.0 Release 1312 Sun Microsystems Java Card Specification: “Java Card 2.2.1 Application Programming Interface“. 13 Sun Microsystems Java Card Specification: “Java Card 2.2.1 Runtime Environment (JCRE) Specification“. 14 Sun Microsystems Java Card Specification: “Java Card 2.2.1 Virtual Mac

43、hine Specification“. SUN Java Card Specifications can be downloaded at http:/ 15 ETSI TS 102 268 V6.1.0: “Test specification for UICC Application Programming Interface for Java Card (TM) “. 16 3GPP TR 21.905: “Vocabulary for 3GPP Specifications“. 3 Definitions, symbols and abbreviations 3.1 Definiti

44、ons For the purposes of the present document, the terms and definitions given in TR 21.905 16 and the following apply. A term defined in the present document takes precedence over the definition of the same term, if any, in TR 21.905 16. applet installation parameters: values for applet installation

45、 parameters Conformance Requirement Reference (CRR): description of the expected card behaviour according to TS 31.130 2 expected state: state in which the (U)SIM is supposed to be after the execution of the test procedure applied on the relevant initial conditions security parameters: minimum secur

46、ity requirements defined for the applet installation process test area: set of Test Cases applicable to a specific part (class method, CAT RE behaviour, etc) of the TS 31.130 2. test case: elementary test that checks for compliance with one or more Conformance Requirement References test procedure:

47、sequence of actions/commands to perform all the test cases defined in a test area test source file: java file containing methods that will load and install test applet in the card, execute and verify the test results, and restore the Default Initial Conditions on the (U)SIM (when possible). test too

48、lkit applet: applet designed to test a specific functionality of the USIM API (TS 31.130 2) 3.2 Abbreviations For the purposes of the present document, the abbreviations given in TR 21.905 16 and the following apply. An abbreviation defined in the present document takes precedence over the definitio

49、n of the same abbreviation, if any, in TR 21.905 16. AID Application IDentifier APDU Application Protocol Data Unit API Application Programming Interface CAT RE Card Application Toolkit Runtime Environment CRR Conformance requirements Reference CRRC Conformance requirement Reference Context Error CRRN Conformance requirement Reference Normal CRRP Conformance requirement Reference Parameter Error FFS For Further Study ETSI ETSI TS 131 213 V13.0.0 (2016-02)93GPP TS 31.213 v