background image

 

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 

 

 

 

Summary of Contents for SCR3310 V2

Page 1: ...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 ...

Page 2: ...ardware 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 ...

Page 3: ... 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 be...

Page 4: ...NTACT_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 ...

Page 5: ... them for Should you notice any problems with this document please provide your feedback to support identiv com 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 a...

Page 6: ...nual 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 upd...

Page 7: ...r 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 ...

Page 8: ... numbering digit b7 b6 b5 b4 b3 b2 b1 b0 B4 B5 B6 B7 B8 B9 B10 B11 B0 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 11 Byte 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 ...

Page 9: ...tion 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 numbe...

Page 10: ...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 ...

Page 11: ... 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 Ide...

Page 12: ...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...

Page 13: ...age 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 ...

Page 14: ...s 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...

Page 15: ...eter 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 ...

Page 16: ...C 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 Windo...

Page 17: ...ntiv 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 com...

Page 18: ...ck 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...

Page 19: ...ROTOCOL_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 do...

Page 20: ...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 physic...

Page 21: ...e Escape command again The following Escape commands are supported by SCR3310 V2 Escape command Code CONTACT_SETMODE 0x01 CONTACT_GETMODE 0x02 CONTACT_GET_SET_POWERUPSEQUENCE 0x04 CONTACT_EMV_LOOPBACK 0x05 CONTACT_EMV_SINGLEMODE 0x06 CONTACT_APDU_TRANSFER 0x08 CONTACT_CONTROL_PPS 0x0F CONTACT_EXCHANGE_RAW 0x10 READER_GET_IFDTYPE 0x12 READER_LED_CONTROL 0x19 READER_LED_CONTROL_BY_FW 0xB2 READER_GET...

Page 22: ... of modes as interpreted by the firmware ISO mode uses APDU mode of data transfer and is used for normal operations This is the default mode of the reader on power up EMV mode also uses APDU mode of data transfer and is used for EMV test purposes This mode has more stringent checks for smart card detection and communication as per EMV4 2 spec Synchronous mode is used for communicating only with me...

Page 23: ...vation delay and then retry with the next enabled voltage class If power up succeeds at an operating voltage the firmware will continue card communication at that voltage If power up fails in all the enabled operating voltages then the firmware will report an error The default power up sequence would be A B C Input The first byte of the input buffer contains the Escape code The next byte contains ...

Page 24: ...rts with Class A voltage 5V 3V 1 8V order For retrieving current power up sequence 0xFF the output will be Example retrieve all the current settings DataIn 04 FE DataOut 01 0A 07 3 bytes 00 Starting with Class A 0A 10ms delay between resets 07 Class A B and C enabled 6 1 2 4 CONTACT_EMV_LOOPBACK This Escape command lets the host force the firmware to perform an EMV Loop back application The input ...

Page 25: ...NULL 6 1 2 6 CONTACT_APDU_TRANSFER This Escape command exchanges a short APDU with the smart card The user has to ensure that a card is inserted and powered before issuing this Escape command This Escape command mostly is used by the MCard API to access synchronous memory cards Input The input buffer contains the Escape code value followed by the short APDU to be sent to the card The output buffer...

Page 26: ...6 1 2 8 CONTACT_EXCHANGE_RAW This Escape command can be used to perform raw exchange of data with the card The user must ensure that a card is inserted and powered on before issuing this Escape command The Card is deactivated upon any reception error Input The input buffer for this command will contain the Escape code low byte of the length of data to be sent high byte of length of data to be sent...

Page 27: ...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 Input The first byte of the input buffer contains the Escape ...

Page 28: ...byte of the input buffer contains the Escape code The second byte specifies if LED control by the firmware should be disabled or enabled The output buffer is NULL Output No response is returned for set state For Get State 1 byte response is received Output buffer NULL or current state Byte0 Byte1 Value Description Escape code 0xB2 0 Enable LED Control by firmware 1 Disable LED Control by firmware ...

Page 29: ...efault value 1 byMajorVersion Major Version in BCD Based on current firmware version 1 byMinorVersion Minor Version in BCD 1 bySupportedModes Total no of supported modes in the reader 0x03 ISO EMV and MCard modes 2 wSupportedProtocols Protocols supported by the Reader Bit 0 T0 Bit 1 T1 0x0300 LSB first 2 winputDevice IO_DEV_NONE 0x00 IO_DEV_KEYPAD 0x01 IO_DEV_BIOMETRIC 0x02 0x0000 LSB first 1 byPe...

Page 30: ...t is 4 8MHz Input The first byte of the input buffer will contain the Escape code the next byte will contain the clock divisor value to set clock frequency or 0xFF to get clock frequency Output Set clock frequency None Get clock frequency One byte value indicating the current Clock divisor Output buffer NULL or current divisor Clock Divisor values DIVISOR VALUE SCCLK Frequency 12 4 MHz 10 4 8 MHz ...

Page 31: ...ly 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 Output For both Set and Get ETU the output will be the following DataIn 80 00 DataOut 00 00 01 40 4 bytes Byte0 Byte1 Byte2 Byte3 Byte4 Byte5 Value Description Wait time Escape code 0x80 0x01 SET ETU BIT31 BIT24 BIT23 BIT16 BIT15 BIT8 BIT7 BIT0 0x00 ...

Page 32: ...ape code followed by an 8 bit GET SET identifier an 8 bit Wait time identifier and a 32 bit Wait time value BWT must be specified in units of 1 25ms and CWT in units of ETU Output For both Get Set Wait time the output will be the following DataIn 81 00 01 DataOut 00 00 03 5D 4 bytes Byte0 Byte1 Byte2 Byte3 Byte4 Byte5 Byte6 Value Description Value Description Wait time in ETU Escape code 0x81 0x01...

Page 33: ...ape code followed by an 8 bit GET SET identifier an 8 bit guard time identifier and a 32 bit guard time value in ETU Output For Get Set guard time the output will be the Character Block Guard Time value DataIn 82 00 01 DataOut 00 00 00 18 4 bytes Byte0 Byte1 Byte2 Byte3 Byte4 Byte5 Byte6 Value Description Value Description Guard time in ETU Escape code 0x82 0x01 SET Guard time 0x00 CGT BIT31 BIT24...

Page 34: ...ds 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 Output Write delay No response byte Read delay value A byte value specifying the current delay applied during memory card Write in milliseconds DataIn 85 00 DataOut 00 1 byte Byte0 Byte1 Value Description Escape code 0x85 0x01 Delay in milliseconds for memory c...

Page 35: ... emit an ATR that is not ISO IEC 7816 compliant the card reader may fail to power up the card In these cases disabling ATR validation will let you work with the card regardless of ISO conformity of the ATR By default ATR validation is enabled Input The first byte of the input buffer will contain the Escape code the next byte will contain the control byte Output Output buffer NULL Byte0 Byte 1 Valu...

Page 36: ...1 A Status words table SW1 SW2 Description 0x90 0x00 NO ERROR 0x67 0x00 LENGTH INCORRECT 0x6D 0x00 INVALID INSTRUCTION BYTE 0x6E 0x00 CLASS NOT SUPPORTED 0x6F 0x00 UNKNOWN COMMAND 0x63 0x00 NO INFORMATION GIVEN 0x65 0x81 MEMORY FAILURE 0x68 0x00 CLASS BYTE INCORRECT 0x6A 0x81 FUNCTION NOT SUPPORTED 0x6B 0x00 WRONG PARAMETER P1 P2 ...

Page 37: ...ET_SET_POWERUPSEQUENCE 0x04 define CONTACT_EMV_LOOPBACK 0x05 define CONTACT_EMV_SINGLEMODE 0x06 define CONTACT_APDU_TRANSFER 0x08 define CONTACT_CONTROL_PPS 0x0F define CONTACT_EXCHANGE_RAW 0x10 define READER_GETIFDTYPE 0x12 define READER_LED_CONTROL 0x19 define READER_LED_CONTROL_BY_FW 0xB2 define READER_GETINFO_EXTENDED 0x1E define CONTACT_GET_SET_CLK_FREQUENCY 0x1F define CONTACT_GET_SET_ETU 0x...

Page 38: ...rInfo byMajorVersion 0xF0 4 strReaderInfo byMajorVersion 0x0F printf minor version t t d d n strReaderInfo byMinorVersion 0xF0 4 strReaderInfo byMinorVersion 0x0F printf modes t t t d n strReaderInfo bySupportedModes printf protocols t t 04x n strReaderInfo wSupportedProtocols printf input device t t 04x n strReaderInfo winputDevice printf personality t t d n strReaderInfo byPersonality printf max...

Page 39: ...Reference Manual for SCR3310 v2 Contact Desktop Reader Document Version 1 1 Last revised on 2018 07 19 Page 39 of 40 7 3 Annex C Mechanical drawings 7 3 1 Top Casing ...

Page 40: ...Reference Manual for SCR3310 v2 Contact Desktop Reader Document Version 1 1 Last revised on 2018 07 19 Page 40 of 40 7 3 2 Bottom Casing ...

Reviews: