Identiv SCR3310 V2 Reference Manual

Contact desktop reader
Table of Contents

Advertisement

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

Advertisement

Table of Contents
loading

Summary of Contents for Identiv SCR3310 V2

  • Page 1 Reference Manual for SCR3310 V2 Contact Desktop Reader For Part #: 905331 Document Version: 1.1, Last Revised On: 2018-07-19 Document Version 1.1 Last revised on 2018-07-19 Page 1 of 40...
  • Page 2 Reference Manual for SCR3310 v2 Contact Desktop Reader 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.
  • Page 3: Table Of Contents

    Reference Manual for SCR3310 v2 Contact Desktop Reader Table of Contents LEGAL INFORMATION ........................5 1.1: Disclaimers ........................5 1.2: Licenses ......................... 5 1.3: Trademarks ........................5 INTRODUCTION TO THE MANUAL ....................6 2.1: Objective of the manual ....................6 2.2:...
  • Page 4 Reference Manual for SCR3310 v2 Contact Desktop Reader 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 COMMANDS DESCRIPTION ......................20 6.1: Escape commands for the SCR3310 V2 ................20 6.1.1:...
  • Page 5: 1: Legal Information

    Identiv reserves the right to change the content of 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.
  • Page 6: 2: Introduction To The Manual

    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.
  • Page 7: Definition Of Various Terms And Acronyms

    Reference Manual for SCR3310 v2 Contact Desktop Reader 2.4: Definition of various terms and acronyms Term Expansion APDU Application Protocol Data Unit Answer to Reset, defined in ISO/IEC 7816 Byte Group of 8 bits CCID Chip Card Interface Device Card Identifier...
  • Page 8: Conventions

    Reference Manual for SCR3310 v2 Contact Desktop Reader 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. Bit number 5 Bit number 0...
  • Page 9: 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 &...
  • Page 10: Applications

    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.
  • Page 11: 4: Scr3310 V2 Characteristics

    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. ISO7816 contact smart card interface...
  • Page 12: 2: Software Architecture

    SCR3310 V2 Reader 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.
  • Page 13: Quick Reference Data

    1.5 meter long with USB type A connector Default color black and grey SCR3310 V2 Default label Drawing with dimensions of the SCR3310 V2 can be found in annex. Document Version 1.1 Last revised on 2018-07-19 Page 13 of 40...
  • Page 14: 2: Led Behavior

    Reference Manual for SCR3310 v2 Contact Desktop Reader 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 Reader powered, card in but not powered...
  • Page 15: 3: Card Interface

    Reference Manual for SCR3310 v2 Contact Desktop Reader 4.2.3.3: Card interface Parameter Value/Description Smart card operating up to 16MHz frequency Maximum supported 600Kbps card baud-rate Class A, B and C asynchronous smart cards (T=0, T=1) Cards supported Synchronous smart cards (2wire, 3wire, I²C)
  • Page 16: 5: Software Modules

    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.
  • Page 17: 2: Supported Operating Systems

    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: •...
  • Page 18: 2: Ccid Messages Supported

    Reference Manual for SCR3310 v2 Contact Desktop Reader 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 •...
  • Page 19 Reference Manual for SCR3310 v2 Contact Desktop Reader 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 a hardware short circuit condition is detected, during application of power to the card or if any other internal hardware error is detected.
  • Page 20: 6: Commands Description

    • 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’.
  • Page 21: 2: Escape Command Codes

    Escape commands can be used by an application to configure SCR3310 V2 to function in a mode that is not its default configured mode or to get specific information. To put the SCR3310 V2 back into its default mode, it either has to be unplugged and plugged again or the application can send the same Escape command again.
  • Page 22: Contact_Setmode

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.1: CONTACT_SETMODE This Escape command sets the current mode of the reader. Applications may call this function, to set the desired mode. Typically, this call is used to switch between the ISO/IEC 7816, EMV and memory card operations.
  • Page 23: Contact_Get_Set_Power_Up_Sequence

    Reference Manual for SCR3310 v2 Contact Desktop Reader Following table gives the value of modes as interpreted by reader firmware Mode Value Remarks 0x00 ISO/IEC 7816 mode 0x01 Synchronous 0x02 memory card mode (synchronous) 6.1.2.3: CONTACT_GET_SET_POWER_UP_SEQUENCE This Escape command is used by the application/driver to get/set the following parameters: •...
  • Page 24: Contact_Emv_Loopback

    Reference Manual for SCR3310 v2 Contact Desktop Reader Output: For retrieving all settings (0xFE), the output will be the following: Byte0 Description Byte1 Byte2 Value Starts with Class C voltage. Bit Map of all Voltage 0x00 (1.8V – 3V – 5V order)
  • Page 25: Contact_Emv_Singlemode

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.5: CONTACT_EMV_SINGLEMODE This Escape command lets the host perform a one-shot EMV Loop-back application as specified in the EMV Level 1 Testing Requirements document. The input buffer is Byte0 Escape code(0x06) The output buffer is...
  • Page 26: Contact_Control_Pps

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.7: CONTACT_CONTROL_PPS This Escape command enables or disables the PPS done by the firmware/device for smart cards. This setting will take effect from the next card connect and remains effective till it is changed again or the next Reader power on.
  • Page 27: 9: Reader_Get_Ifdtype

    Description 0x16 0x51 USB PID of Identiv SCR3310 v2 USB Smart Card Reader 6.1.2.10: READER_LED_CONTROL This Escape command may be used to toggle the LED state. LED control by firmware should be disabled using the Escape command READER_LED_CONTROL_BY_FW to see proper LED change while using this IOCTL else the LED state will be overwritten by the FW LED behavior.
  • Page 28: 11: Reader_Led_Control_By_Fw

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.11: READER_LED_CONTROL_BY_FW This command is used to enable/disable LED control by firmware. Default setting is: LED is controlled by firmware. Input: The first byte of the input buffer contains the Escape code. The second byte specifies if LED control by the firmware should be disabled or enabled.
  • Page 29: 12: Reader_Get_Info_Extended

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.12: READER_GET_INFO_EXTENDED This Escape command may be used to retrieve extended information about the reader and supported features. Input: The first byte of the input buffer contains the Escape code. Byte0 Escape code(0x1E)
  • Page 30: 13: Contact_Get_Set_Clk_Frequency

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.13: CONTACT_GET_SET_CLK_FREQUENCY In case when an application wants to get or set the smart card clock frequency, this Escape command is used to instruct the reader to change the clock or to get the current Clock divisor used.
  • Page 31: 14: Contact_Get_Set_Etu

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.14: CONTACT_GET_SET_ETU This Escape command is be used by the HOST to get/set the current ETU for smart cards. Once set, the new ETU value will take effect immediately. Input: The input buffer contains the Escape followed by an 8 bit GET/SET identifier. For SET ETU, a DWORD specifying the value to be set is following.
  • Page 32: 15: Contact_Get_Set_Waittime

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.15: CONTACT_GET_SET_WAITTIME This Escape command is used to get/set the Character/Block Waiting Time for smart cards. The wait time is specified in terms of ETU. Once set, the new Wait time will take effect from the next card communication.
  • Page 33: 16: Contact_Get_Set_Guardtime

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.16: CONTACT_GET_SET_GUARDTIME This Escape command is used to get/set the Character/Block Guard Time of the reader. The guard time is specified in terms of ETU. Once set, the new Guard time will take effect immediately.
  • Page 34: 17: Contact_Get_Set_Mcard_Timeout

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.17: CONTACT_GET_SET_MCARD_TIMEOUT This Escape command is used to get or set the delay which is applied after a Write operation to memory cards. The delay is specified in milliseconds. Input: The first byte of the input buffer will contain the Escape code; the next byte will contain the memory card write delay in seconds.
  • Page 35: 18: Contact_Control_Atr_Validation

    Reference Manual for SCR3310 v2 Contact Desktop Reader 6.1.2.18: CONTACT_CONTROL_ATR_VALIDATION This Escape command is used to enable or disable the ATR validation by the firmware in ISO/IEC 7816 mode. In case the card would emit an ATR that is not ISO/IEC 7816 compliant, the card reader may fail to power up the card.
  • Page 36: 7: Annexes

    Reference Manual for SCR3310 v2 Contact Desktop Reader 7: Annexes 7.1: A – Status words table Description 0x90 0x00 NO ERROR 0x67 0x00 LENGTH INCORRECT 0x6D 0x00 INVALID INSTRUCTION BYTE 0x6E 0x00 CLASS NOT SUPPORTED 0x6F 0x00 UNKNOWN COMMAND 0x63...
  • Page 37: Annex B - Sample Code Using Escape Commands Through Escape Ioctl

    Reference Manual for SCR3310 v2 Contact Desktop Reader 7.2: Annex B – Sample code using Escape commands through Escape IOCTL File Name : SCR3310 V2 Escape.h #ifndef _SCR3310V2_ESCAPE_H_ #define _SCR3310V2_ESCAPE_H_ #ifdef __cplusplus extern "C" { #endif # pragma pack (1) typedef struct BYTE byMajorVersion;...
  • Page 38 Reference Manual for SCR3310 v2 Contact Desktop Reader DWORD BytesRead, ActiveProtocol; ULONG ret; char *ReaderName[] = {"Identiv SCR3310 V2 Smart Card Reader 0", NULL}; /*************************************************************************************** *****************/ ContextHandle = -1; ret = SCardEstablishContext(SCARD_SCOPE_USER, NULL, NULL, &ContextHandle); if (ret == SCARD_S_SUCCESS) ret = SCardConnect( ContextHandle,...
  • Page 39: Annex C - Mechanical Drawings

    Reference Manual for SCR3310 v2 Contact Desktop Reader 7.3: Annex C – Mechanical drawings 7.3.1: Top Casing Document Version 1.1 Last revised on 2018-07-19 Page 39 of 40...
  • Page 40: 2: Bottom Casing

    Reference Manual for SCR3310 v2 Contact Desktop Reader 7.3.2: Bottom Casing Document Version 1.1 Last revised on 2018-07-19 Page 40 of 40...

Table of Contents