Identiv SCR3310 V2 User manual

Document Version 1.1 Last revised on 2018-07-19 Page 1 of 40
Reference Manual for SCR3310 V2
Contact Desktop Reader
For Part #: 905331
Document Version: 1.1, Last Revised On: 2018-07-19

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 2 of 40
Abstract
This document contains in-depth information about the hardware and software features of the
SCR3310 V2 contact smart card reader.
Audience
This document is intended for system integrators and software developers.
Revision History
Rev.
Date
Description
1.0
2014-06-02
First published external version
1.1
2017-07-06
Minor modifications and company name change
Contact Information
For additional information, please visit http://www.identiv.com/.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 3 of 40
Table of Contents
1: LEGAL INFORMATION ......................................................................................................................5
1.1: Disclaimers..................................................................................................................... 5
1.2: Licenses ......................................................................................................................... 5
1.3: Trademarks .................................................................................................................... 5
2: INTRODUCTION TO THE MANUAL....................................................................................................6
2.1: Objective of the manual .................................................................................................. 6
2.2: Target audience .............................................................................................................. 6
2.3: Product version corresponding to the manual ................................................................... 6
2.4: Definition of various terms and acronyms ......................................................................... 7
2.5: References ..................................................................................................................... 7
2.6: Conventions ................................................................................................................... 8
3: GENERAL INFORMATION ABOUT SCR3310 V2..................................................................................9
3.1: SCR3310 V2 key benefits ................................................................................................. 9
3.2: SCR3310 V2 key features ................................................................................................. 9
3.3: SCR3310 V2 ordering information..................................................................................... 9
3.4: SCR3310 V2 customization options ................................................................................... 9
Applications........................................................................................................................... 10
3.4.1: General................................................................................................................. 10
3.4.2: Applications provided by Identiv ............................................................................. 10
4: SCR3310 V2 CHARACTERISTICS ......................................................................................................11
4.1: SCR3310 V2 high level architecture................................................................................. 11
4.1.1: Block diagram........................................................................................................ 11
4.1.2: Software architecture ............................................................................................ 12
4.2: Quick reference data ..................................................................................................... 13
4.2.1: SCR3310 V2 dimensions ......................................................................................... 13
4.2.2: LED behavior ......................................................................................................... 14
4.2.3: Other data ............................................................................................................ 14
4.2.3.1: General........................................................................................................................14
4.2.3.2: USB .............................................................................................................................14
4.2.3.3: Card interface ...............................................................................................................15
5: SOFTWARE MODULES....................................................................................................................16
5.1: Installation ................................................................................................................... 16
5.2: Utilities ........................................................................................................................ 16
5.3: Driver .......................................................................................................................... 16
5.3.1: SCR3310 V2 listing ................................................................................................. 16
5.3.2: Supported operating systems.................................................................................. 17
5.4: CT-API.......................................................................................................................... 17
5.5: MCard-API.................................................................................................................... 17
5.6: Firmware ..................................................................................................................... 17

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 4 of 40
5.6.1: CCID transport protocol.......................................................................................... 17
5.6.1.1: CCID class requests supported ........................................................................................17
5.6.1.2: CCID messages supported ..............................................................................................18
5.6.1.3: CCID Error Codes...........................................................................................................18
6: COMMANDS DESCRIPTION ............................................................................................................20
6.1: Escape commands for the SCR3310 V2............................................................................ 20
6.1.1: Sending Escape commands to SCR3310 V2 ............................................................... 20
6.1.2: Escape command codes ......................................................................................... 21
6.1.2.1: CONTACT_SETMODE .....................................................................................................22
6.1.2.2: CONTACT_GETMODE .....................................................................................................22
6.1.2.3: CONTACT_GET_SET_POWER_UP_SEQUENCE ....................................................................23
6.1.2.4: CONTACT_EMV_LOOPBACK............................................................................................24
6.1.2.5: CONTACT_EMV_SINGLEMODE ........................................................................................25
6.1.2.6: CONTACT_APDU_TRANSFER ...........................................................................................25
6.1.2.7: CONTACT_CONTROL_PPS ...............................................................................................26
6.1.2.8: CONTACT_EXCHANGE_RAW ...........................................................................................26
6.1.2.9: READER_GET_IFDTYPE ...................................................................................................27
6.1.2.10: READER_LED_CONTROL .............................................................................................27
6.1.2.11: READER_LED_CONTROL_BY_FW..................................................................................28
6.1.2.12: READER_GET_INFO_EXTENDED ...................................................................................29
6.1.2.13: CONTACT_GET_SET_CLK_FREQUENCY..........................................................................30
6.1.2.14: CONTACT_GET_SET_ETU ............................................................................................31
6.1.2.15: CONTACT_GET_SET_WAITTIME ...................................................................................32
6.1.2.16: CONTACT_GET_SET_GUARDTIME ................................................................................33
6.1.2.17: CONTACT_GET_SET_MCARD_TIMEOUT........................................................................34
6.1.2.18: CONTACT_CONTROL_ATR_VALIDATION .......................................................................35
7: ANNEXES .......................................................................................................................................36
7.1: A – Status words table ................................................................................................... 36
7.2: Annex B – Sample code using Escape commands through Escape IOCTL ............................. 37
7.3: Annex C – Mechanical drawings ..................................................................................... 39
7.3.1: Top Casing ............................................................................................................ 39
7.3.2: Bottom Casing ....................................................................................................... 40

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 5 of 40
1: Legal information
1.1: Disclaimers
The content published in this document is believed to be accurate. However, Identiv does not
provide any representation or warranty regarding the accuracy or completeness of its content, or
regarding the consequences of your use of the information contained herein.
Identiv reserves the right to changethe contentof this document without prior notice. The content
of this document supersedes the content of any previous versions of the same document. This
document may contain application descriptions and/or source code examples, which are for
illustrative purposes only. Identiv gives no representation or warranty that such descriptions or
examples are suitable for the application that you may want to use them for.
Should you notice any problems with this document, please provide your feedback to
[e-mail].
1.2: Licenses
If the document contains source code examples, they are provided for illustrative purposes only
and subject to the following restrictions:
•You MAY at your own risk use or modify the source code provided in the document in
applications you may develop. You MAY distribute those applications ONLY in form of
compiled applications.
•You MAY NOT copy or distribute parts of orthe entire source code without prior written
consent from Identiv.
•You MAY NOT combine or distribute the source code provided with Open Source
Software or with software developed using Open Source Software in a manner that
subjects the source code or any portion thereofto anylicense obligations of such Open
Source Software.
If the document contains technical drawings related to Identiv products, they are provided for
documentation purposes only. Identiv does not grant you any license to its designs.
1.3: Trademarks
Windows is a trademark of Microsoft Corporation.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 6 of 40
2: Introduction to the manual
2.1: Objective of the manual
This manual provides an overview of the hardware and software features of the SCR3310 V2
smart card reader.
This manual describes in details interfaces and supported commands available for developers
using SCR3310 V2 in their applications.
2.2: Target audience
This document describes the technical implementation of SCR3310 V2.
The manual targets software developers. It assumes knowledge about ISO/IEC 7816 and
commonly used engineering terms.
2.3: Product version corresponding to the manual
This document has been updated for the below Hardware and Firmware versions.
Item Version
Hardware 3.1
Firmware 6.01

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 7 of 40
2.4: Definition of various terms and acronyms
Term Expansion
APDU Application Protocol Data Unit
ATR Answer to Reset, defined in ISO/IEC 7816
Byte Group of 8 bits
CCID Chip Card Interface Device
CID Card Identifier
LED Light emitting diode
NA Not applicable
NAD Node Address
Nibble Group of 4 bits. 1 digit of the hexadecimal representation of a byte.
Example: 0xA3 is represented in binary as (10100011)b. The least significant
nibble is 0x3 or (0011)b and the most significant nibble is 0xA or (1010)b
PC/SC Personal Computer/Smart Card: software interface to communicate between a PC
and a smart card
PID Product ID
RFU Reserved for future use
USB Universal Serial Bus
VID Vendor ID
(xyz)b Binary notation of a number x, y, z ∈{0,1}
0xYY The byte value YY is represented in hexadecimal
2.5: References
Doc ref in
the manual Description Issuer
ISO/IEC
7816-3 Identification cards — Integrated circuit
cards — Part 3: Cards with contacts —
Electrical interface and transmission protocols
ISO / IEC
ISO/IEC
7816-4 Identification cards - Integrated circuit(s) cards with contacts
Part 4: Interindustry commands for interchange
ISO/IEC 7816-4: 2005 (E)
ISO / IEC
PC/SC Interoperability Specification for ICCs and
Personal Computer Systems v2.01 PC/SC Workgroup
CCID Specification for Integrated Circuit(s) Cards
Interface Devices 1.1 USB-IF
USB Universal Serial Bus Specification 2.0 USB-IF

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 8 of 40
2.6: Conventions
Bits are represented by lower case ‘b’ where followed by a numbering digit.
Bytes are represented by upper case ‘B’ where followed by a numbering digit.
b7 b6 b5 b4 b3 b2 b1 b0
B4 B5 B6 B7 B8 B9 B10 B11B0 B1 B2 B3
Least significant nibble
Most significant nibble
1 Byte = 8 bits = 2 nibbles
Bit number 0
Bit number 5
String of 12 bytes
Byte number 11Byte number 2
Example:
163 decimal number is represented
•in hexadecimal as 0xA3
•in binary as (10100011)b
The least significant nibble of 0xA3 is
•0x3 in hexadecimal
•(0011)b in binary
The most significant nibble of =xA3 is
•0xA in hexadecimal
•(1010)b in binary

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 9 of 40
3: General information about SCR3310 V2
3.1: SCR3310 V2 key benefits
With its combination of a modern slim design and its state of the art feature set, SCR3310 V2 is
the perfect desktop reader choice for environments where smart card support is required. Such
environments may be corporations or government authorities where use applications like
network log-in, Windows authentication & Single Sign-On are implemented.
As for all Identiv products, SCR3310 V2 is designed to offer best in class interoperability.
3.2: SCR3310 V2 key features
•ISO/IEC 7816 compliant smart card reader
•PC/SC v2.0 compliant
•Unique serial number which enables that SCR3310 V2 can be plugged into any USB
slot on a PC without having to re-install the driver.
3.3: SCR3310 V2 ordering information
Item Part number
SCR3310 V2 905331 (and derived
products)
3.4: SCR3310 V2 customization options
Upon request and based on a minimum order quantity, Identiv can customize:
•The color of the casing
•The logo
•The product label
•The USB strings
*Terms and conditions apply, please contact your local Identiv representative.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 10 of 40
3.5: Applications
3.5.1: General
SCR3310 V2 is a transparent reader designed to interface with a personal computer host
supporting PC/SC interface with smart cards according to ISO/IEC 7816 as well as synchronous
memory cards like CAC and PKI cards, banking cards and health insurance cards.
SCR3310
V2
Tokens
Application logic + User
personal data for given
set of applications
USB link
PC/SC interface Smartcard contacts
ISO7816
Host
Application logic
SCR3310 V2
Interface device
Network
`
SCR3310 V2 itself handles the communication protocol but not the application related to the
token. The application-specific logic has to be implemented by software developers on the host.
3.5.2: Applications provided by Identiv
Identiv provides a few applications for development and evaluation purposes that can function
with SCR3310 V2. There are some tools provided; here is one of them:
•Smart card commander version 1.3 provides capabilities to identify most commonly
used cards in the field and display the content of them as well as scripting functionality
which can be very useful for developers to develop and debug their applications.
Identiv does not provide PKI or CAC applications.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 11 of 40
4: SCR3310 V2 characteristics
4.1: SCR3310 V2 high level architecture
4.1.1: Block diagram
The link between SCR3310 V2 and the host to which it is connected is the USB interface
providing both the power and the communication channel.
Device controller
Mask ROM controller
LED
To host
ISO7816 contact
smart card interface
The SCR3310 V2 device controller has several interfaces available. In the SCR3310 V2
implementation 2 peripherals are connected to the device controller:
•LED for reader status indication
•A smart card interface
The micro-Controller contains the firmware developed by Identiv to handle all the ISO/IEC 7816
contact protocol and the PC/SC communication protocol with the host.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 12 of 40
4.1.2: Software architecture
Applications can interface with the driver directly through the PC/SC interface.
SCR3310 V2
Reader
ICC
FIRMWARE
LAYER
(CCID-API)
T= 0 / T= 1
Driver
- Contact Smart Card
Reader
PC/SC Layer
The SCR3310 V2 leverages a PC/SC CCID driver that is freely available for all supported
operating systems (Windows, macOS X and Linux).With current Windows versions (starting with
Windows Vista) and macOS X, this driver is already included in the basic installation.
With the diverse Linux derivatives, there may be distribution specific drivers that should get
installed using the install mechanism of the used distribution.
Please search the web for PC/SC-lite or go to https://support.identiv.com/ and navigate to the
downloads page for your reader.
Additionally, Identiv provides a proprietary driver for all the supported OSs.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 13 of 40
4.2: Quick reference data
4.2.1: SCR3310 V2 dimensions
Item Characteristic Value
SCR3310 V2
Weight 60g
External dimensions 66x69x15 mm
Cable length 1.5 meter long with USB type A connector
Default color black and grey
Default label
Drawing with dimensions of the SCR3310 V2 can be found in annex.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 14 of 40
4.2.2: LED behavior
SCR3310 V2 is equipped with a green LED. Its behavior is described in the table below.
SCR3310 V2 states LED Indication
Reader powered, card out OFF
Reader powered, card in but not powered OFF
Card powered ON
Card access Blinking (500ms ON/500ms OFF)
error condition Blinking (100ms ON/100ms OFF
4.2.3: Other data
4.2.3.1: General
Parameter Value/Description
Clock of the device controller 48 MHz
API PC/SC 2.0
Operating temperature range 0º to 50ºC
Operating humidity range Up to 95%RH non-condensing
Certifications
USB
CE
UL-60950
FCC
ICES-003
WEEE
RoHS2
REACH
WHQL
Listed in GSA APL
4.2.3.2: USB
Parameter Value/Description
DC characteristics
Low bus powered (SCR3310 V2 draws power from USB bus)
Voltage: 5V
Max. Current: 6mA + current consumed by an inserted card
Suspend current: 500uA
USB specification USB 2.0 FS device
USB Speed Full Speed Device (12Mbit/s)
Device Class CCID
PID 0x5116
VID 0x04E6

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 15 of 40
4.2.3.3: Card interface
Parameter Value/Description
Smart card operating
frequency up to 16MHz
Maximum supported
card baud-rate 600Kbps
Cards supported Class A, B and C asynchronous smart cards (T=0, T=1)
Synchronous smart cards (2wire, 3wire, I²C)
ISO/IEC 7816
compliant Yes
EMV 4.2 compliant Yes
CT-API compliant Yes
Number of slots Single smart card slot
Ejection mechanism Manual

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 16 of 40
5: Software modules
5.1: Installation
On Operating Systems with a PC/SC CCID driver preinstalled, no installation is necessary.
Where there’s no PC/SC CCID driver preinstalled (Linux systems) the driver has to be installed
using distribution specific measures or installed using the available source packages.
5.2: Utilities
The following utilities are available:
•A tool for testing the resource manager
•A tool called PC/SCDiag capable of providing basic information about the reader and
a card through PC/SC stack
Operating systems supported by the tools:
•Windows Server 2012 (32 & 64 bit)
•Windows 7, 8.1 and 10 (32 & 64 bit)
5.3: Driver
5.3.1: SCR3310 V2 listing
SCR3310 V2 is listed by PC/SC applications as
•Identiv SCR3310 V2
SCR3310 V2 uses the PC/SC CCID class driver readily available for all the supported operating
systems.
On Windows XP systems, this driver is not preinstalled and will not be loaded from Windows
Update. The Hardware Wizard will need to be allowed to load the driver from the internet if it is
not already present on the system (first time installation).
Starting with Windows Vista, the OS does have the driver preinstalled, so no additional driver
installation is necessary.
macOS X systems do have the PC/SC CCID driver preinstalled.
On Linux systems, the distribution specific installation mechanism should be used.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 17 of 40
5.3.2: Supported operating systems
•
Windows Server 2012 (32 & 64 bit)
•Windows 7, 8.1 and 10 (32 & 64 bit)
•MacOS X (10.12)
•Linux 3.x (32 & 64 bit)
5.4: CT-API
A CT-API interface that mostly is used in German banking applications and in conjunction with
health insurance cards, is available for the reader.
5.5: MCard-API
With this proprietary Identiv API, it is possible to access a vast majority of synchronous memory
cards.
Cards supported are:
•SLE4404
•SLE4428
•SLE4432
•SLE4436
•SLE6636
•SLE4442
•SLE5532
•SLE5536
•SLE5542
•AT24C01ASC
•AT24C02SC
•AT24C04SC
•AT24C08SC
•AT24C16SC
•AT24C32SC
•AT24C64SC
•AT24C128SC
•AT24C256SC
•AT24C512SC
•AT88SC153
•AT88SC1608
•ST14C02
5.6: Firmware
5.6.1: CCID transport protocol
SCR3310 V2 implements a transport protocol that is compliant with USB Device Class: Smart
Card CCID Specification for Integrated Circuit(s) Cards Interface Devices Revision 1.10.
This paragraph describes the CCID specification features that are implemented.
5.6.1.1: CCID class requests supported
•Abort

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 18 of 40
5.6.1.2: CCID messages supported
The following CCID messages are supported for the contact interface when received through
bulk-out endpoint.
•PC_to_RDR_IccPowerOn
•PC_to_RDR_IccPowerOff
•PC_to_RDR_GetSlotStatus
•PC_to_RDR_XfrBlock
•PC_to_RDR_GetParameters
•PC_to_RDR_SetParameters
•PC_to_RDR_Escape
•PC_to_RDR_Abort
•PC_to_RDR_NotifySlotChange
•PC_to_RDR_ResetParameters
•PC_to_RDR_T0APDU
•PC_to_RDR_SetDatarateAndClockFrequency
5.6.1.3: CCID Error Codes
Extensive error codes are reported on many conditions during all CCID responses. Most of the
error messages are reported by the CCID appropriately. Some of the main error codes for the
contact interface are:
•HW_ERROR
•XFR_PARITY_ERROR
•ICC_PROTOCOL_NOT_SUPPORTED
•BAD_ATR_TS
•BAD_ATR_TCK
•ICC_MUTE
•CMD_ABORTED
•Command not supported

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 19 of 40
The following sub-sections discuss when and why these error codes are returned:
1.1.1.1.1. HW_ERROR
This error code is returned when ahardware short circuit condition is detected, during application
of power to the card or if any other internal hardware error is detected.
1.1.1.1.2. XFR_PARITY_ERROR
This error code is returned when a parity error condition is detected. This error will be reported
in the response to a PC_to_RDR_XfrBlock message.
1.1.1.1.3. ICC_PROTOCOL_NOT_SUPPORTED
This error code is returned if the card is signaling to use a protocol other than T=0 or T=1 in its
ATR.
1.1.1.1.4. BAD_ATR_TS
This error code is returned if the initial character of the ATR contains invalid data.
1.1.1.1.5. BAD_ATR_TCK
This error code is returned if the check character of the ATR contains is invalid.
1.1.1.1.6. ICC_MUTE
This error code is returned when the card does not respond until the reader time out occurs.This
error will be reported in the response to PC_to_RDR_XfrBlock message and
PC_to_RDR_IccPowerOn messages.
1.1.1.1.7. CMD_ABORTED
This error code is returned if the command issued has been aborted by the control pipe.
1.1.1.1.8. Command not supported
This error would be returned, if the command would not be supported by the reader.

Reference Manual for SCR3310 v2 Contact Desktop Reader
Document Version 1.1 Last revised on 2018-07-19 Page 20 of 40
6: Commands description
6.1: Escape commands for the SCR3310 V2
6.1.1: Sending Escape commands to SCR3310 V2
A developer can use the following method to send Escape commands to SCR3310 V2
•SCardControl method defined in PC/SC API
In Windows, in order to be able to send Escape commands to the SCR3310 V2, the feature has
got to be enabled by setting a REG_DWORD value named ‘EscapeCommandEnable’ in the
registry to a value of ‘1’.
For Windows XP and Windows Vista, the key to hold the value would be
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_58
16\ Device-Instance-xxxx \Device Parameters
For Windows 7 and Windows 8, that would be
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\USB\VID_04E6&PID_58
16\Device-Instance-xxxx \Device Parameters\WUDFUsbccidDriver
Device-Instance-xxxx has got to be equal to the serial number of the reader used, so this
modification has got to be made for every physical reader intended to be used on the machine
in question. The reader has got to be plugged in at least once for the mentioned key to exist and
the driver has got to be restarted for this setting to take effect. (Unplug and re-plug the reader).
To be able to work with synchronous memory cards using our MCard API, the same setting will
have to be established.
See appendix B for some sample code sending Escape commands to the reader.