CLOUD 2700 R Reference manual
Contents
1. 5 6 1 2 CCID messages supported ss 21 5 6 1 3 Error GOdGS iate me tee niue 21 6 Commands description eni ico Utd ten io die ipt das 23 6 1 Escape commands for the CLOUD 2700 Rs 23 6 1 1 Sending Escape commands to CLOUD 2700 23 6 1 2 Escape command codes 24 6 1 2 1 READER SETMOBDBE 45 veneto oett en piu 25 6 1 2 2 READER GET MODE sv b andes Den MM 25 6 1 2 3 CONTACT GET SET POWER UP 26 6 1 2 4 CONTACT 77 27 6 1 2 5 CONTACT 7 28 6 1 2 6 CONTACT APDU 5 28 6 1 2 7 29 6 1 2 8 CONTACT EXCHANGE 29 6 1 2 9 READER GET IEDTYPE e Ed 30 6 1 2 10 READER LED 43 1 0 100060000 0 000000000000000 30 6 1 2 11 READER LED CONTROL BY FW teet 31 6 1 2 12 READER GET INFO 32 6 1 2 13 CONTACT GET SET FREQUENCY 33 6 1 2 14 CONTACT GET SET 34 6 1 2 15 CONTACT GET SET WA TTIME a aee 35 6 1 2 16 CONTACT GET SET GUARDTIME ire 36 6 1 2 17 CONTACT GET SET MCARD T2. Output Output buffer NULL CLOUD 2700 R REFERENCE MANUAL 31 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 The output buffer is NULL Byte0 Byte1 Value Description Escape 0 Enable LED Control by firmware de 0xB2 PUS 1 Disable LED Control by firmware Get State FF 0 LED control by firmware enabled 1 LED control by firmware disabled Output No response is returned for set state For Get State 1 byte response is received Output buffer NULL or current state CLOUD 2700 R REFERENCE MANUAL 32 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 Escape code 0x1E Output The firmware returns data as per structure SCARD READER GETINFO PARAMS EX mentioned below This Escape command is used to get the firmware version reader capabilities and Unicode serial number of the reader Field Size in Bytes Field Name Field Description Default value byMajorVersion Major Version in BCD Based on current firmware version 1 byMinorVersio
3. ret printf major version NtNt d dWMn strReaderInfo byMajorVersion amp OxF0 4 strReaderInfo byMajorVersion amp Ox0F printf minor version NtNt d dWMn strReaderInfo byMinorVersion amp OxF0 4 strReaderInfo byMinorVersion amp Ox0F 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 slots t t d n strReaderInfo byMaxSlots printf serial no length t d n strReaderInfo bySerialNoLength printf serial no t t for i 0 i lt strReaderInfo bySerialNoLength i printf c strReaderInfo abySerialNumber i else printf SCardControl failed 08X n ret else printf SCardConnect failed 08X n ret ret SCardReleaseContext ContextHandle else printf n SCardEstablishContext failed with 81X ret printf npress any key to close the test tool n getch 42 CLOUD 2700 R REFERENCE MANUAL Annex C Mechanical drawings 7 3 Top Casing 7 3 1 g f 4L Sar ae IE 1 surface CLOUD 2700 R REFERENCE MANUAL 43 7 3 2 Bottom Casing Ir LJ 0007 9 32044ns CLOUD 2700 R
4. 12 3 4 CLOUD 2700 R customization options ssssssssseseseneeeneeneen nennen 12 eut ett am vt etel a e eed 13 General im eget ect HE apt tu de Li diete E 13 3 4 8 Applications provided by 13 4 CLOUD 2700 R characteristics iii 14 4 1 CLOUD 2700 R high level architecture eene 14 11 Blockdiagt am u eed etie te t eode 14 4 1 2 Software architecture sr 15 4 2 Quick reference data sienne 16 4 2 1 CLOUD 2700 R dimensions 16 42 2 E DE o p t KA ON e ert t e aliia eet une 17 42 3 Other Calta ient e fecti ie ie e Tati reg oet esta 17 4 2 3 1 Generali eds ada epica St ete nes dm et thid cata tie ath 17 4 2 3 2 Dci 17 4 2 3 3 Gard interface ecdesiae ae eae 18 5 Software modules is sete lant teo dotes 19 5 1 He pete rds 19 b 2r oco teo te oot adu ettet E 19 5 32 etim mene e adv ete ta Or ai Beetle rk ed ERE ac ease 19 534 CLOUD 2700 R listing eter et mee ee ee e a es 19 5 3 2 Supported operating systems ss 20 ti nn 20 HEN erInd Mr 20 SUEDE EN ULL I INI EE 21 5 6 1 CCID transport protocol 21 5 6 1 1 CCID class requests 21
5. REFERENCE MANUAL 44 7 3 3 Stand plate CLOUD 2700 R REFERENCE MANUAL 45 7 3 4 Stand socket
6. let you work with the card regardless of ISO conformity of By default ATR validation is en Input the ATR abled The first byte of the input buffer will contain the Escape code the next byte will contain the control byte Byte1 Value Escape code 0x88 0x00 Description Enable ATR validation 0x01 Disable ATR validation Output Output buffer NULL CLOUD 2700 R REFERENCE MANUAL 39 7 Annexes 7 1 A Status words table NO INFORMATION GIVEN CLASS BYTE INCORRECT FUNCTION NOT SUPPORTED WRONG PARAMETER P1 P2 CLOUD 2700 R REFERENCE MANUAL 7 2 Annex Sample code using Escape commands through Escape IOCTL File Name CLOUD 2700 R Escape h ifndef CLOUD 2700 R ESCAPE H define CLOUD 2700 R ESCAPE H ifdef cplusplus extern C endif pragma pack 1 typedef struct BYTE byMajorVersion BYTE byMinorVersion BYTE bySupportedModes WORD wSupportedProtocols WORD winputDevice BYTE byPersonality BYTE byMaxSlots BYTE bySerialNoLength BYTE abySerialNumber 28 ReaderInfoExtended pragma pack define IOCTL CCID ESCAPE SCARD CTL CODE OxDAC define READER SET MODE 0x01 define READER GET MODE 0x02 define CONTACT GET SET POWERUPSEQUENCE 0x04 define CONTACT EMV LOOPBACK 0x05 define CONTACT EMV SINGLEMODE 0x06 define CONTACT APDU TRANSFER 0x08 define CONTACT CONTROL PPS OxOF define CO
7. 0 Escape code 0x06 The output buffer is Output buffer 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 Byte1 onwards Escape code 0x08 Short APDU to be sent to card The output buffer contains the response APDU Output buffer Response APDU CLOUD 2700 R REFERENCE MANUAL 29 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 Default mode is PPS enabled Input The first byte of input buffer contains the Escape code and the following byte if 1 disables the PPS and if 0 enables the PPS Byte0 Byte1 Escape code 0x0F PPS control byte 1 DISABLES PPS 0 ENABLES PPS The output buffer is Output buffer NULL 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 recept
8. 16 EMV and memory card operations Upon power on the reader will reset to the default ISO IEC 7816 mode Input The first byte of the input buffer contains the Escape code value and the second one will contain the value for the desired mode of operation The output buffer field will be NULL Escape code 0x01 Mode Following table gives the value of modes as interpreted by the firmware Mode Value Remarks ISO 0x00 ISO IEC 7816 mode EMV 0x01 EMV Synchronous 0x02 memory card mode Synchronous 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 memory cards Any other value sent as mode is invalid The output buffer is Output buffer NULL 6 1 2 2 READER_GETMODE This Escape command may be used to retrieve the current mode of the reader The input buffer is Escape code 0x02 Output Current active reader mode will be returned as a BYTE value CLOUD 2700 R REFERENCE MANUAL 26 Following table gives the value of modes as interpreted by reader firmware Mode Value Remarks ISO 0x00 ISO IEC 7816 mode EMV 0x01 EMV Synchronous 0x02 memory card mode synchrono
9. 4 Interindustry commands for interchange ISO IEC 7816 4 2005 E Personal Computer Systems v2 01 CCID Specification for Integrated Circuit s Cards USB IF Interface Devices 1 1 Universal Serial Bus Specification 2 0 USB IF CLOUD 2700 R REFERENCE MANUAL 10 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 Y Bit number 0 Y b7 b6 b5 b4 b3 b2 b1 bo lt 4 Most significant nibble j lt Least significant nibble 1 Byte 8 bits 2 nibbles Byte number 11 AEE String of 12 bytes Byte number 2 Example 163 decimal number is represented e in hexadecimal as 0xA3 in binary as 1010001 1 b The least significant nibble of is 0x3 in hexadecimal 0011 b in binary The most significant nibble of xA3 is OxA in hexadecimal 1010 b in binary CLOUD 2700 R REFERENCE MANUAL 11 3 General information about CLOUD 2700 R 3 1 CLOUD 2700 R key benefits With its combination of a modern slim design and its state of the art feature set CLOUD 2700 R is the perfect desktop reader choice for environments where smart card support is required Such environments may be corporates or authorities where use applications like network log in
10. 816 contact protocol and the PC SC communication protocol with the host CLOUD 2700 R REFERENCE MANUAL 15 4 1 2 Software architecture Applications can interface with the driver directly through the PC SC interface PC SC Layer Driver Contact Smart Card Reader LS FIRMWARE __T 0 T 1 oh En Ae LAYER CCID API CLOUD 2700 R Reader The CLOUD 2700 R leverages a PC SC CCID driver that is freely available for all supported operating systems Windows MacOSX and Linux With current Windows versions starting with Windows Vista and MacOSX 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 If there is none the driver may always be downloaded from the webpage of the maintainer Ludovic Rousseau https alioth debian org frs group id 30105 CLOUD 2700 R REFERENCE MANUAL 16 4 2 Quick reference data 4 2 1 CLOUD 2700 R dimensions Characteristic Weight 509 Weight 204g with Standing Base Kit External dimensions External dimensions 70x63x62 mm with Standing Base Kit Cable length 1 5 meter long with USB type A connector Default color color white and cool grey R1 6 3x Lg 29 20 CLOUD 2700 R
11. GT 5 time 0x01 BGT Output For Get Set guard time the output will be the Character Block Guard Time value Byte1 Byte2 Byte3 Character Guard time in ETU BIT31 BIT24 BIT23 BIT16 BIT15 BIT8 BIT7 BITO DataIn 82 00 01 DataOut 00 00 00 18 4 bytes CLOUD 2700 R REFERENCE MANUAL 37 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 Byte0 Byte1 Value Description Escape 0x01 Delay in milliseconds for memory card Write code 0x85 Any value other than Read the current applied delay for memory card 1 Write Output Write delay No response byte Read delay value A byte value specifying the current delay applied during memory card Write in milliseconds 0 me DataIn 85 00 DataOut 00 1 byte CLOUD 2700 R REFERENCE MANUAL 38 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 In these cases disabling ATR validation will
12. ID IDENTIVE Identive Infrastructure Reference Manual version 1 03 10 IDENTIVE revolutionary card core Identive CLOUD 2 00 R Smart Card Reader Reference manual Identive CLOUD 2700 R Smart Card Reader Identive GmbH Oskar Messter Strasse 13 85737 Ismaning Germany Phone 49 89 9595 5000 Fax 49 89 9595 5555 Document history Date Version Description of change Contact information www identive group com en products and solutions identification products desktop readers terminals contact desktop readers For sales information please email sales identive infrastructure com Table of Contents 14 Eegal information rettet doce dp a ded dee ep eed eve Gee 6 Bis Bisclaimers ie Lex ei EUN e 6 1 22 ICONS OS ii iere rae tet t ite ert tet 6 1 3 zBPrademarks 5 te ete m de tie tuf ere dert uet 6 2 Introduction to the manual enne entente nnns 7 2 1 Objective of the manual iii 7 22 nti sitne elei i e 7 2 3 Product version corresponding to the 7 2 4 Definition of various terms and acronyms nennen 8 2 5 References edt nC ala etate se t e qe iu 9 2 62 CONVENTIONS xai LN END cipe UE 10 3 General information about CLOUD 2700 11 3 1 CLOUD 2700 R key benefits is 11 3 2 CLOUD 2700 R key features iii 11 3 3 CLOUD 2700 R ordering information
13. IMEOUT iii 37 6 1 2 18 CONTACT CONTROL VALIDATION ire 38 NESCIRE 39 Lil AS Status words table aan ea cae ce Pe cet eee een dl ig Pe Pu de ee d eaa 39 7 22 Annex Sample code using Escape commands through Escape IOCTL 40 7 3 Annex C Mechanical 42 eet e et b tts 42 7 3 2 Bottom Casing semet aee t E Rn teh ien dite da rots 43 72390 Stand plate cett e en tei re Etats 44 taw lt deri dia eer et Pr 45 CLOUD 2700 R REFERENCE MANUAL 1 Legal information 1 1 Disclaimers The content published in this document is believed to be accurate Identive does not however provide any representation or warranty regarding the accuracy or completeness of its content and regarding the consequences of the use of information contained herein If this document has the status Draft its content is still under internal review and yet to be formally validated Identive reserves the right to change the content of this document without prior notice The content of this document supersedes the content of previous versions of the same document The document may contain application descriptions and or source code examples which are for illustrative purposes only Identi
14. Identive CLOUD 2700 Default label gt ZZS5V400mA CansdalCES 003 Ciscz B _ USTED 17 a Made in Singapore by Identve Y Drawing with dimensions of the CLOUD 2700 R can be found in Item CLOUD 2700 R REFERENCE MANUAL 17 4 2 2 LED behavior CLOUD 2700 R is equipped with a green LED Its behavior is described in the table below CLOUD 2700 R states LED Indication Reader powered card out OFF Reader powered card in but not powered OFF Card powered ON Blinking 500ms Re ON 500ms OFF Blinking 100ms error condition ON 100ms OFF 4 2 3 Other data 4 2 3 1 General Parameter Value Description Clock of the device 48 MHz controller PC SC 2 0 Operating temperature range 0 to 50 C Operating humidity Up to 95 RH non condensing range VCCI Certifications WEEE RoHS2 REACH WHQL EMV L1 Listed in GSA APL 4 2 3 2 USB Parameter Value Description Low bus powered CLOUD 2700 R draws power from USB bus Voltage 5V Max Current 6mA current consumed by an inserted card Suspend current 500uA DC characteristics PID CLOUD 2700 R REFERENCE MANUAL 18 4 2 3 3 Card interface Parameter Value Description Smart card operating up to 16MHz frequency Maximum supported owes card baud rate Cards supported Class A B and C asynchronous smart cards T 0 T 1 Sy
15. NTACT EXCHANGE RAW 0x10 define READER GETIFDTYPE 0x12 define READER LED CONTROL 0x19 define READER LED CONTROL BY FW OxB2 define READER GETINFO EXTENDED Ox1E define CONTACT GET SET CLK FREQUENCY OxlF define CONTACT GET SET ETU 0x80 define CONTACT GET SET WAITTIME 0x81 define CONTACT GET SET GUARDTIME 0x82 define CONTACT GET SET MCARD TIMEOUT 0x85 define CONTACT CONTROL ATR VALIDATION 0x88 ifdef _ cplusplus endif endif File Name CLOUD 2700 R Escape c include lt windows h gt include lt winbase h gt include lt stdio h gt include lt conio h gt include winscard h include winerror h include CLOUD 2700R Escape h VOID main VOID SCARDCONTEXT ContextHandle SCARDHANDLE CardHandle ReaderInfoExtended strReaderInfo CLOUD 2700 R REFERENCE MANUAL 41 BYTE InByte i DWORD BytesRead ActiveProtocol ULONG ret char ReaderName Identive CLOUD 2700 R Smart Card Reader 0 NULL BKK KR RRR KK A A RR A KR RK ke ke e e ContextHandle 1 ret SCardEstablishContext SCARD SCOPE USER NULL NULL amp ContextHandle if ret SCARD S SUCCESS ret SCardConnect ContextHandle ReaderName 0 SCARD SHARE DIRECT SCARD PROTOCOL UNDEFINED amp CardHandle amp ActiveProtocol if ret SCARD S SUCCESS InByte Ox1E ret SCardControl CardHandle IOCTL CCID ESCAPE amp InByte 1 amp strReaderInfo sizeof strReaderInfo amp BytesRead if SCARD S SUCCESS
16. Windows authentication amp Single Sign On are implemented As for all Identive products CLOUD 2700 R is designed to offer best in class interoperability 3 2 CLOUD 2700 R key features e ISO IEC 7816 compliant smart card reader e PC SC v2 0 compliant e Unique serial number which enables that CLOUD 2700 R can be plugged into USB slot on a PC without having to re install the driver CLOUD 2700 R REFERENCE MANUAL 12 3 3 CLOUD 2700 R ordering information Part number CLOUD 2700 R 905369 Standing Base Kit 905418 CLOUD 2700 R with pre assembled 905369 1912 standing base kit 3 4 CLOUD 2700 R customization options Upon request and based on a minimum order quantity Identive can customize e The color of the casing e The logo e The product label e The USB strings Terms and conditions apply please contact your local Identive representative or send an email to sales identive infrastructure com CLOUD 2700 R REFERENCE MANUAL 13 Applications 3 4 1 General CLOUD 2700 R is a transparent reader designed to interface 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 USB link Smartcard contacts PC SC interface 1507816 L Token Host CLOUD 2700 R Application logic User personal data for given set of application
17. YSTEM CurrentControlSet Enum USB VID_ O4E6 amp PID 58 10 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 CLOUD 2700 R REFERENCE MANUAL 24 6 1 2 Escape command codes Escape commands can be used by an application to configure CLOUD 2700 R to function in a mode that is not its default configured mode or to get specific information To put the CLOUD 2700 R back into its default mode it either has to be unplugged and plugged again or the application can send the same Escape command again The following Escape commands are supported by CLOUD 2700 R Escape command Code CONTACT APDU TRANSFER CONTACT CONTROL ATR VALIDATION CLOUD 2700 R REFERENCE MANUAL 25 6 1 2 1 READER 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 78
18. al describes in details interfaces and supported commands available for developers using CLOUD 2700 R in their applications 2 2 Target audience This document describes the technical implementation of CLOUD 2700 R The manual targets software developers It assumes knowledge about ISO IEC 7816 and commonly used engineering terms Should you have questions you may send them to support identive group com 2 3 Product version corresponding to the manual Item Version CLOUD 2700 R REFERENCE MANUAL 8 2 4 Definition of various terms and acronyms EINE Group of 4 bits 1 digit of the hexadecimal representation of a byte Example is represented in binary as 1010001 1 b The least significant nibble is Ox3 or 0011 b and the most significant nibble is OxA or 1010 b PC SC Personal Computer Smart Card software interface to communicate between a PC and a smart card gt s xyz b Binary notation of a number x y z e 0 1 The byte value YY is represented in hexadecimal CLOUD 2700 R REFERENCE MANUAL 9 2 5 References Doc ref in Description Issuer the manual ISO IEC Identification cards Integrated circuit ISO IEC 7816 3 cards Part 3 Cards with contacts Electrical interface and transmission protocols ISO IEC Identification cards Integrated circuit s cards ISO IEC 7816 4 with contacts Part
19. allation Starting with Windows Vista the OS does have the driver preinstalled so no additional driver installation is necessary MacOSX systems do have the PC SC CCID driver preinstalled On Linux systems the distribution specific installation mechanism should be used CLOUD 2700 R REFERENCE MANUAL 20 5 4 5 3 2 Supported operating systems Windows 2003 Server 32 amp 64 bit Windows XP 32 amp 64 bit Windows Vista 32 amp 64 bit Windows Server 2008 32 amp 64 bit Windows 7 Windows 8 MacOS X Linux 32 amp 64 bit 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 Identive 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 24 085 AT24C16SC AT24C32SC AT24C64SC AT24C128SC AT24C256SC AT24C512SC AT88SC153 885 1608 ST14C02 CLOUD 2700 R REFERENCE MANUAL 21 5 6 Firmware 5 6 1 CCID transport protocol CLOUD 2700 R 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 c
20. eves all the above values OxFF Retrieves the current Power up sequence CLOUD 2700 R REFERENCE MANUAL Output For retrieving all settings OxFE the output will be the following Byte0 Byte 1 Byte2 Value Description BitO Class A Biti Starts with Class C voltage Time delay between Bit Map of all Voltage 1 8V 3V 5V order resets in milliseconds Classes 0x00 Starts with Class A voltage Bio _ 5V 3V 1 8V order Class B Bit2 Class C For retrieving current power up sequence OxFF the output will be Byte0 Value Description Starts with Class C voltage 1 8V 3V 5V order 0x00 Starts with Class A voltage 5V 3V 1 8V order 0x01 Example retrieve all the current settings DataIn 04 FE DataOut 01 OA 07 3 bytes 00 Starting with Class A OA 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 buffer is 0 Escape code 0x05 The output buffer is Output buffer NULL CLOUD 2700 R REFERENCE MANUAL 28 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 Byte
21. ion 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 low byte of the length of expected data high byte of length of expected data and the command Byte1 Byte 5 onwards Escape LSB of send MSB of send LSB of expected MSB of Raw data to code 0x10 length length length expected the card length Output Output buffer Response APDU CLOUD 2700 R REFERENCE MANUAL 30 6 1 2 9 READER GET IFDTYPE This Escape command is used to get the current IFD type from the reader Input The first byte of the input buffer contains the Escape code 0 Escape code 0x12 Output The reader returns the PID of the firmware which can be used to identify the reader PID value Description 0 1 0x10 0x58 USB PID of Identive CLOUD 2700 R 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 code followed by LED number always set to 0 just one LED and then the desired LED state Byte0 Byte 1 Byte2 Escape code 0x19 LED number 0 GREEN LED state 0 OFF 1 ON
22. lass requests supported Abort 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 PC to GetSlotStatus PC to 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 TOAPDU 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 PROTOCOL NOT SUPPORTED BAD ATR TS BAD ATR TCK ICC_MUTE CMD_ABORTED Command not supported CLOUD 2700 R REFERENCE MANUAL 22 The following sub sections discuss when and why these error codes are returned 5 6 1 3 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 5 6 1 3 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 5 6 1 3 8 PROTOCOL NOT SUPPORTED This error code is returned if the card is signaling to use a protocol
23. n Minor Version in BCD Total no of supported modes in the 1 bySupportedModes Teader 0x03 ISO EMV and MCard modes Protocols supported by the Reader Bit 0 TO 2 wSupportedProtocols Bit 1 T1 0x0300 LSB first DEV NONE 0x00 2 winputDevice lO DEV KEYPAD 0x01 IO BIOMETRIC 0x02 0x0000 LSB first 1 byPersonality Reader Personality Not Used 0x00 1 byMaxSlots Maximum number of slots 0x01 Single slot device 1 bySerialNoLength Serial number length 0x1C 28 abySerialNumber Unicode serial number Reader serial number MSB first 28 DataIn 1E DataOut 01 00 03 03 00 00 00 00 O1 1 35 00 33 00 36 00 39 00 31 00 33 00 30 00 31 00 32 00 30 00 30 00 30 00 36 00 32 00 38 bytes CLOUD 2700 R REFERENCE MANUAL 33 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 Once set the change in frequency will take effect immediately Default divisor value is 10 that 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 OxFF to get clock frequency Description Escape Clock The value to be Set in the smart card CLK divisor code 0x1F divisor register OxFF Get current Clock diviso
24. nchronous smart cards 2wire 3wire ISO IEC 7816 Y es compliant EMV 4 2 compliant Yes CT API compliant Number of slots Single smart card slot Ejection mechanism CLOUD 2700 R REFERENCE MANUAL 19 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 e A tool called PC SC Diag capable of providing basic information about the reader and a card through PC SC stack Operating systems supported by the tools e Windows 2003 Server 32 amp 64 bit e Windows XP 32 amp 64 bit e Windows Vista 32 amp 64 bit e Windows Server 2008 32 amp 64 bit e Windows 7 e MacOS X e Linux 5 3 Driver 5 3 1 CLOUD 2700 R listing CLOUD 2700 R is listed by PC SC applications as e Identive CLOUD 2700 R Smart Card Reader CLOUD 2700 R 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 has got to be loaded from Windows Update The Hardware Wizard has got be allowed to load the driver from the internet for that purpose if it is not already present on the system first time inst
25. other than T 0 or T 1 in its ATR 5 6 1 3 4 BAD ATR TS This error code is returned if the initial character of the ATR contains invalid data 5 6 1 3 5 BAD ATR TCK This error code is returned if the check character of the ATR contains is invalid 5 6 1 3 6 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 messages 5 6 1 3 7 CMD ABORTED This error code is returned if the command issued has been aborted by the control pipe 5 6 1 3 8 Command not supported This error would be returned if the command would not be supported by the reader CLOUD 2700 R REFERENCE MANUAL 23 6 Commands description 6 1 Escape commands for the CLOUD 2700 R 6 1 1 Sending Escape commands to CLOUD 2700 R A developer can use the following method to send Escape commands to CLOUD 2700 R e SCardControl method defined in PC SC In Windows in order to be able to send Escape commands to the CLOUD 2700 R 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 MACHINENSYSTEMNCurrentControlSetNEnumNUSBVWID OA4E6 amp PID 58 10 Device Instance xxxx Device Parameters For Windows 7 and Windows 8 that would be HKEY LOCAL MACHINE S
26. r value 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 8 6 MHz 7 6 8 MHz 6 8 MHz 5 9 6 MHz 4 12 MHz 3 16 MHz DataIn 1F FF DataOut OA 1 byte CLOUD 2700 R REFERENCE MANUAL 34 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 Byte1 Byte3 Byte4 Value Description Wait time Escape Ox01 SET ETU BIT31 BIT23 BIT15 BIT7 code 0x80 BIT24 BIT16 BIT8 BITO 0x00 GET ETU Output For both Set and Get ETU the output will be the following 0 Byte1 Byte2 Byte3 ETU value BIT31 BIT24 BIT23 BIT16 BIT15 BIT8 BIT7 BITO DataIn 80 00 DataOut 00 00 01 40 4 bytes CLOUD 2700 R REFERENCE MANUAL 35 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 comm
27. s Application logic Interface device CLOUD 2700 R 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 4 2 Applications provided by Identive Identive provides a few applications for development and evaluation purposes that can function with CLOUD 2700 R There are some tools provided here is one of them e 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 Identive does not provide PKI or CAC applications CLOUD 2700 R REFERENCE MANUAL 14 4 CLOUD 2700 R characteristics 4 1 CLOUD 2700 R high level architecture 4 1 1 Block diagram The link between CLOUD 2700 R and the host to which it is connected is the USB interface providing both the power and the communication channel 1507816 contact smart card interface Device controller Mask ROM controller I LED To host The CLOUD 2700 R device controller has several interfaces available In the CLOUD 2700 R implementation 2 peripherals are connected to the device controller e LED for reader status indication e A smart card interface The Controller contains the firmware developed by Identive to handle all the ISO IEC 7
28. unication Input The input buffer contains the Escape 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 Byte0 Byte1 Byte3 Byte4 Byte5 Byte6 Description Value Description Wait time in ETU Escape 0x01 SET Wait 0x00 CWT BIT31 BIT23 BIT15 BIT7 code 0x81 time BIT24 BIT16 BIT8 BITO Ox01 BWT 0x00 GET Wait 0x00 CWT z time 0x01 BWT Output For both Get Set Wait time the output will be the following Byte1 Byte2 Byte3 Wait time in ETU BIT31 BIT24 BIT23 BIT16 BIT15 BIT8 BIT7 BITO DataIn 81 00 01 DataOut 00 00 03 5D 4 bytes CLOUD 2700 R REFERENCE MANUAL 36 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 Input The input buffer contains the Escape code followed by an 8 bit GET SET identifier an 8 bit guard time identifier and a 32 bit guard time value in ETU Byte0 Byte1 Byte2 Byte3 Byte4 Byte5 Byte6 Value Description Value Description Guard time in ETU Escape 0x01 SET Guard 0x00 CGT BIT31 BIT23 BIT15 BIT7 code 0x82 time BIT24 BIT16 BIT8 BITO 0x01 BGT 0x00 GET Guard 0x00 C
29. us 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 e Smart card Power on sequence e Delay between successive Activation retries e Enable Disable any Voltage Class As soon as card insertion is detected and power on message is received from the host the firmware will start activation with the configured voltage sequence If the activation fails it will wait for the configured activation 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 the function to be performed Third byte contains the parameter for the function Byte0 Byte1 Byte2 Value Description Starts with Class C voltage 1 8V 3V 5V order Escape 0x00 Starts with Class A voltage 0x01 5V 3V 1 8V order 0x08 Time delay between resets Delay value in milliseconds 0x09 Enable Disable a Voltage Bit Map of all Voltage Classes RSS Bito Class A Bit1 Class B Bit2 Class C Set bit to enable the Voltage class Clear bit to disable the Voltage class OxFE Retri
30. ve gives no representation or warranty that such descriptions or examples are suitable for the application that the reader may want to use them for Should you notice problems with the provided documentation please provide your feedback to support identive group com 1 2 Licenses If the document contains source code examples they are provided for illustrative purposes only and subject to the following restrictions e 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 e You MAY NOT copy or distribute parts of or the entire source code without prior written consent from Identive e 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 thereof to any license obligations of such Open Source Software If the document contains technical drawings related to Identive products they are provided for documentation purposes only Identive does not grant you any license to its designs 1 3 Trademarks Windows is a trademark of Microsoft Corporation CLOUD 2700 R REFERENCE 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 CLOUD 2700 R smart card reader This manu
Download Pdf Manuals
Related Search