Identive CLOUD 2700F Specification
CLOUD
2700 R
eader
Identive Infrastructure
Reference Manual – version 1.03
Identive
Smart Card R
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
Date
Version
Description of change
08/08/2012
1.01
Initial Version
10/01/2013
1.02
Minor rework
22/02/2013
1.03
Minor corrections
Document history
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
1. Legal information ................................................................................................................... 6
1.1. Disclaimers ..................................................................................................................... 6
1.2. Licenses ......................................................................................................................... 6
1.3. Trademarks .................................................................................................................... 6
2. Introduction to the manual ..................................................................................................... 7
2.1. Objective of the manual ................................................................................................. 7
2.2. Target audience ............................................................................................................. 7
2.3. Product version corresponding to the manual ............................................................... 7
2.4. Definition of various terms and acronyms ...................................................................... 8
2.5. References ..................................................................................................................... 9
2.6. Conventions ................................................................................................................. 10
3. General information about CLOUD 2700 R ........................................................................ 11
3.1. CLOUD 2700 R key benefits ........................................................................................ 11
3.2. CLOUD 2700 R key features ....................................................................................... 11
3.3. CLOUD 2700 R ordering information ........................................................................... 12
3.4. CLOUD 2700 R customization options ........................................................................ 12
Applications ............................................................................................................................. 13
3.4.1. General ................................................................................................................. 13
3.4.2. Applications provided by Identive ......................................................................... 13
4. CLOUD 2700 R characteristics ........................................................................................... 14
4.1. CLOUD 2700 R high level architecture ........................................................................ 14
4.1.1. Block diagram ....................................................................................................... 14
4.1.2. Software architecture ............................................................................................ 15
4.2. Quick reference data .................................................................................................... 16
4.2.1. CLOUD 2700 R dimensions .................................................................................. 16
4.2.2. LED behavior ........................................................................................................ 17
4.2.3. Other data ............................................................................................................. 17
4.2.3.1. General ...................................................................................................................... 17
4.2.3.2. USB ........................................................................................................................... 17
4.2.3.3. Card interface ........................................................................................................... 18
5. Software modules ................................................................................................................ 19
5.1. Installation .................................................................................................................... 19
5.2. Utilities .......................................................................................................................... 19
5.3. Driver ............................................................................................................................ 19
5.3.1. CLOUD 2700 R listing ........................................................................................... 19
5.3.2. Supported operating systems ............................................................................... 20
5.4. CT-API .......................................................................................................................... 20
5.5. MCard-API .................................................................................................................... 20
5.6. Firmware ...................................................................................................................... 21
5.6.1. CCID transport protocol ........................................................................................ 21
5.6.1.1. CCID class requests supported ................................................................................. 21
5.6.1.2. CCID messages supported ........................................................................................ 21
5.6.1.3. CCID Error Codes ...................................................................................................... 21
6. Commands description ........................................................................................................ 23
6.1. Escape commands for the CLOUD 2700 R ................................................................. 23
6.1.1. Sending Escape commands to CLOUD 2700 R ................................................... 23
6.1.2. Escape command codes ....................................................................................... 24
6.1.2.1. READER_SETMODE ................................................................................................ 25
6.1.2.2. READER_GETMODE ................................................................................................ 25
6.1.2.3. CONTACT_GET_SET_POWER_UP_SEQUENCE ................................................... 26
6.1.2.4. CONTACT_EMV_LOOPBACK .................................................................................. 27
6.1.2.5. CONTACT_EMV_SINGLEMODE .............................................................................. 28
6.1.2.6. CONTACT_APDU_TRANSFER ................................................................................ 28
6.1.2.7. CONTACT_CONTROL_PPS ..................................................................................... 29
6.1.2.8. CONTACT_EXCHANGE_RAW ................................................................................. 29
6.1.2.9. READER_GET_IFDTYPE ......................................................................................... 30
6.1.2.10. READER_LED_CONTROL........................................................................................ 30
6.1.2.11. READER_LED_CONTROL_BY_FW ......................................................................... 31
6.1.2.12. READER_GET_INFO_EXTENDED ........................................................................... 32
6.1.2.13. CONTACT_GET_SET_CLK_FREQUENCY .............................................................. 33
6.1.2.14. CONTACT_GET_SET_ETU ...................................................................................... 34
6.1.2.15. CONTACT_GET_SET_WAITTIME ............................................................................ 35
6.1.2.16. CONTACT_GET_SET_GUARDTIME ........................................................................ 36
6.1.2.17. CONTACT_GET_SET_MCARD_TIMEOUT .............................................................. 37
6.1.2.18. CONTACT_CONTROL_ATR_VALIDATION .............................................................. 38
7. Annexes ............................................................................................................................... 39
7.1. A – Status words table ................................................................................................. 39
7.2. Annex B – Sample code using Escape commands through Escape IOCTL ............... 40
7.3. Annex C – Mechanical drawings .................................................................................. 42
7.3.1. Top Casing ............................................................................................................ 42
7.3.2. Bottom Casing ...................................................................................................... 43
7.3.3. Stand plate ............................................................................................................ 44
7.3.4. Stand socket ......................................................................................................... 45
CLOUD 2700 R REFERENCE MANUAL 6
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. Identive 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:
x 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.
x You MAY NOT copy or distribute parts of or the entire source code without prior
written consent from Identive.
x 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 7
Item
Version
Hardware
0.3
Firmware
1.0
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 manual 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
CLOUD 2700 R REFERENCE MANUAL 8
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:
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.4. Definition of various terms and acronyms
0xA3 is represented in binary as (10100011)b. The least significant
CLOUD 2700 R REFERENCE MANUAL 9
Doc ref in
the manual
Description
Issuer
ISO/IEC
7816
Identification cards — Integrated circuit
cards
Electrical interface and transmission protocols
ISO / IEC
ISO/IEC
7816
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
2.5. References
-3
-4
— Part 3: Cards with contacts —
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 0Bit number 5
b7 b6 b5 b4 b3 b2 b1 b0
Least significant nibbleMost significant nibble
1 Byte = 8 bits = 2 nibbles
Byte number 11Byte number 2
B4 B5 B6 B7 B8 B9 B10 B11B0 B1 B2 B3
String of 12 bytes
Example:
163 decimal number is represented
x in hexadecimal as 0xA3
x in binary as (10100011)b
The least significant nibble of 0xA3 is
x 0x3 in hexadecimal
x (0011)b in binary
The most significant nibble of =xA3 is
x 0xA in hexadecimal
x (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,
Windows authentication & 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
x ISO/IEC 7816 compliant smart card reader
x PC/SC v2.0 compliant
x Unique serial number which enables that CLOUD 2700 R can be plugged into any
USB slot on a PC without having to re-install the driver.
CLOUD 2700 R REFERENCE MANUAL 12
Item
Part number
CLOUD
905369
Stand
905418
CLOUD 2700 R with
pre
standing base kit
905369
3.3. CLOUD 2700 R ordering information
2700 R
ing Base Kit
-assembled
-1912
3.4. CLOUD 2700 R customization options
Upon request and based on a minimum order quantity, Identive can customize:
x The color of the casing
x The logo
x The product label
x 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
PC/SC interface
Network
Smartcard contacts
ISO7816
`
2700 R
CLOUD
Host
Application logic
CLOUD 2700 R
Interface device
Application logic + User
personal data for given
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:
Tokens
set of applications
x 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.
ISO7816 contact
smart card interface
Device controller
To host
Mask ROM controller
LED
The CLOUD 2700 R device controller has several interfaces available. In the CLOUD 2700 R
implementation 2 peripherals are connected to the device controller:
x LED for reader status indication
x A smart card interface
The μController contains the firmware developed by Identive to handle all the ISO/IEC 7816
contact protocol and the PC/SC communication protocol with the host.
Loading...