ETSI TS 103 115 V9.4.0 (2015-04)

ETSI TS 103 115 V9.4.0 (2015-04)






TECHNICAL SPECIFICATION
Smart Cards;
Test specification for UICC Application Programming
Interface for Java Card™ for Contactless Applications;
Test Environment and Annexes
(Release 9)

�

---------------------- Page: 1 ----------------------
Release 9 2 ETSI TS 103 115 V9.4.0 (2015-04)



Reference
RTS/SCP-00HCI_API_TESTv940
Keywords
API, NFC, Smart Card, testing
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 enregistrée à la
Sous-Préfecture 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 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) 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
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:
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 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 Institute 2015.
All rights reserved.

TM TM TM
DECT , PLUGTESTS , UMTS and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members.
TM
3GPP 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

---------------------- Page: 2 ----------------------
Release 9 3 ETSI TS 103 115 V9.4.0 (2015-04)
Contents
Intellectual Property Rights . 7
Foreword . 7
Modal verbs terminology . 7
1 Scope . 8
2 References . 8
2.1 Normative references . 8
2.2 Informative references . 9
3 Definitions, symbols and abbreviations . 9
3.1 Definitions . 9
3.2 Symbols . 9
3.3 Abbreviations . 10
3.4 Formats . 10
3.4.1 Format of the table of optional features . 10
3.4.2 Format of the applicability table . 11
3.4.3 Status and Notations . 11
4 Applicability . 12
4.1 Table of optional features . 12
4.2 Applicability table . 12
4.3 Information provided by the device supplier . 15
4.4 Execution requirements . 15
5 Test environment . 16
5.1 Test environment description . 16
5.2 Tests format . 16
5.2.1 Test area reference . 16
5.2.1.1 Conformance requirements . 17
5.2.1.2 Test suite files . 17
5.2.1.3 Initial conditions . 17
5.2.1.4 Test procedure . 17
5.3 Initial conditions . 18
5.4 Package name . 18
5.5 AID coding . 18
5.6 Test equipment . 19
5.6.1 Test tool . 19
5.6.2 Java Software Development Kit . 20
6 Test cases . 20
6.1 Package uicc.hci.framework . 20
6.1.1 Class HCIDevice . 20
6.1.1.1 Method getHCIService . 20
6.1.1.1.1 Conformance requirements . 20
6.1.1.1.2 Test suite files . 20
6.1.1.1.3 Initial conditions . 20
6.1.1.1.4 Test procedure . 21
6.1.1.2 Method getPowerMode . 22
6.1.1.2.1 Conformance requirements . 22
6.1.1.2.2 Test suite files . 22
6.1.1.2.3 Initial conditions . 22
6.1.1.2.4 Test procedure . 23
6.1.1.3 Method isHCIServiceAvailable . 23
6.1.1.3.1 Conformance requirements . 23
6.1.1.3.2 Test suite files . 24
6.1.1.3.3 Initial conditions . 24
6.1.1.3.4 Test procedure . 24
6.1.2 Interface HCIService . 26
6.1.2.1 Method register . 26
ETSI

---------------------- Page: 3 ----------------------
Release 9 4 ETSI TS 103 115 V9.4.0 (2015-04)
6.1.2.1.1 Conformance requirements . 26
6.1.2.1.2 Test suite files . 26
6.1.2.1.3 Initial conditions . 26
6.1.2.1.4 Test procedure . 27
6.1.2.2 Method deregister . 28
6.1.2.2.1 Conformance requirements . 28
6.1.2.2.2 Test Suite Files . 28
6.1.2.2.3 Initial conditions . 28
6.1.2.2.4 Test procedure . 28
6.1.2.3 Method activateEvent. 29
6.1.2.3.1 Conformance requirements . 29
6.1.2.3.2 Test Suite Files . 30
6.1.2.3.3 Initial conditions . 30
6.1.2.3.4 Test procedure . 31
6.1.2.4 Method deactivateEvent . 33
6.1.2.4.1 Conformance requirements . 33
6.1.2.4.2 Test suite files . 34
6.1.2.4.3 Initial conditions . 34
6.1.2.4.4 Test procedure . 35
6.1.2.5 Method requestCallbackNotification . 38
6.1.2.5.1 Conformance requirements . 38
6.1.2.5.2 Test Suite Files . 38
6.1.2.5.3 Initial conditions . 38
6.1.2.5.4 Test procedure . 38
6.1.2.6 Method getEventNotificationStatus . 39
6.1.2.6.1 Conformance requirements . 39
6.1.2.6.2 Test Suite Files . 39
6.1.2.6.3 Initial conditions . 39
6.1.2.6.4 Test procedure . 40
6.1.3 Interface HCIMessage . 43
6.1.3.1 Method isHeading . 43
6.1.3.1.1 Conformance requirements . 43
6.1.3.1.2 Test Suite Files . 43
6.1.3.1.3 Initial conditions . 43
6.1.3.1.4 Test procedure . 44
6.1.3.2 Method isComplete . 44
6.1.3.2.1 Conformance requirements . 44
6.1.3.2.2 Test suite files . 44
6.1.3.2.3 Initial condition . 44
6.1.3.2.4 Test procedure . 44
6.1.3.3 Method getType . 45
6.1.3.3.1 Conformance requirements . 45
6.1.3.3.2 Test Suite Files . 45
6.1.3.3.3 Initial condition . 45
6.1.3.3.4 Test procedure . 46
6.1.3.4 Method getInstruction . 46
6.1.3.4.1 Conformance requirements . 46
6.1.3.4.2 Test Suite Files . 46
6.1.3.4.3 initial condition . 46
6.1.3.4.4 Test procedure . 47
6.1.3.5 Method getReceiveOffset . 47
6.1.3.5.1 Conformance requirements . 47
6.1.3.6 Method getReceiveLength . 47
6.1.3.6.1 Conformance requirements . 47
6.1.3.6.2 Test Suite Files . 48
6.1.3.6.3 Initial condition . 48
6.1.3.6.4 Test procedure . 48
6.1.3.7 Method getReceiveBuffer . 48
6.1.3.7.1 Conformance requirements . 48
6.1.3.7.2 Test suite files . 49
6.1.3.7.3 Initial condition . 49
6.1.3.7.4 Test procedure . 49
ETSI

---------------------- Page: 4 ----------------------
Release 9 5 ETSI TS 103 115 V9.4.0 (2015-04)
6.1.4 Class HCIException . 49
6.1.4.1 Method throwIt . 49
6.1.4.1.1 Conformance requirements . 49
6.1.4.1.2 Test suite files . 49
6.1.4.1.3 Initial conditions . 49
6.1.4.1.4 Test procedure . 50
6.1.5 Interface HCIListener . 50
6.1.5.1 Method onCallback . 50
6.1.5.1.1 Conformance requirements . 50
6.1.5.1.2 Test Suite Files . 51
6.1.5.1.3 Initial conditions . 51
6.1.5.1.4 Test procedure . 52
6.2 Package uicc.hci.services . 53
6.2.1 Package CardEmulation Service . 53
6.2.1.1 Interface CardEmulationMessage . 53
6.2.1.1.1 Method prepareAndSendGetParameterCommand . 53
6.2.1.1.2 Method prepareAndSendSendDataEvent . 56
6.2.1.1.2.3 Initial conditions . 57
6.2.1.1.3 Method selectingMessage. 58
6.2.1.1.3.3 Initial conditions . 58
6.2.1.2 Interface CardEmulationService . 59
6.2.1.2.1 Method getCardRFType . 59
6.2.1.2.2 Test Suite Files . 59
6.2.1.2.3 Initial conditions . 59
6.2.1.3 Interface CardEmulationListener . 60
6.2.1.3.1 Method onCallback . 60
6.2.2 Package Connectivity Service. 63
6.2.2.1 Interface ConnectivityService . 63
6.2.2.1.1 Method prepareAndSendConnectivityEvent . 63
6.2.2.1.2 Method prepareAndSendTransactionEvent(byte[] aid, short aidOffset, short aidLen,
byte[] parameters, short parametersOffset, short parametersLen) . 67
6.2.2.1.3 Method prepareAndSendTransactionEvent (byte[] parameters, short parametersOffset, short
parametersLen) . 71
6.2.3 Package Reader Service . 74
6.2.3.1 Interface ReaderMessage . 74
6.2.3.1.1 Method restartReaderModeProcedure . 74
6.2.3.1.2 Method prepareAndSendWriteXchgDataCommand . 77
6.2.3.1.3 Method prepareAndSendGetParameterCommand . 82
6.2.3.2 Interface ReaderListener . 86
6.2.3.2.1 Method onCallback . 86
Annex A (normative): Class, methods and tests acronyms . 89
A.1 HCI framework . . 89
A.1.1 Class HCIDevice . 89
A.1.2 Interface HCIService . 89
A.1.3 Interface HCIMessage . 89
A.1.4 Interface HCIListener . 89
A.1.5 Class HCIException . 89
A.2 HCI Services . 90
A.2.1 Package cardemulation . 90
A.2.1.1 Interface CardEmulationListener . 90
A.2.1.2 Interface CardEmulationMessage . 90
A.2.1.3 Interface CardEmulationService . 90
A.2.2 Package connectivity . 90
A.2.2.1 Interface ConnectivityListener . 90
A.2.2.2 Interface ConnectivityMessage . 90
A.2.2.3 Interface ConnectivityService . 90
A.2.3 Readermode . 90
A.2.3.1 Interfac
...