SCM Microsystems SCL01X User manual

SCM Microsystems
Reference Manual –version 2.0
SCL01X
Multiprotocol contactless stationary reader

Reference manual
SCL01X Multiprotocol Contactless Stationary
Reader
© SCM Microsystems
Oskar-Messter-Strasse, 13
85737 Ismaning
Germany
Phone [phone] •Fax [phone]

Document history
Date
Version
Description of change
26/10/2010
2.0
Initial version
Typo corrections
Add the Pass_through command description
Manual fro both SCL010 and SCL011 products
Contact information
http://www.scmmicro.com/products-services/smart-card-readers-terminals/contactless-dual-
interface-readers.html
For sales information, please email [e-mail]

Table of Contents
1. Legal information...................................................................................................................8
1.1. Disclaimers.....................................................................................................................8
1.2. FCC................................................................................................................................8
1.2.1. Section 15.21 Information to user........................................................................... 8
1.2.2. Section 15.105 (b)................................................................................................... 8
1.3. Licenses.........................................................................................................................8
1.4. Trademarks....................................................................................................................9
2. Introduction to the manual...................................................................................................10
2.1. Objective of the manual ...............................................................................................10
2.2. Target audience ...........................................................................................................10
2.3. Product version corresponding to the manual .............................................................10
2.4. Definition of various terms and acronyms....................................................................11
2.5. References...................................................................................................................12
2.6. Conventions .................................................................................................................13
3. General information about SCL01X ....................................................................................14
3.1. SCL01X key benefits....................................................................................................14
3.2. SCL01X key features ...................................................................................................14
3.3. SCL01X ordering information.......................................................................................15
3.4. SCL01X customization options....................................................................................15
3.5. Contactless communication principles and SCL01X usage recommendations...........16
3.5.1. Power supply.........................................................................................................16
3.5.2. Data exchange......................................................................................................16
3.5.3. Recommendations................................................................................................ 17
3.6. Applications..................................................................................................................18
3.6.1. General ................................................................................................................. 18
3.6.2. Applications provided by SCM Microsystems....................................................... 18
4. SCL01X characteristics.......................................................................................................19
4.1. SCL01X high level architecture....................................................................................19
4.1.1. Block diagram ....................................................................................................... 19
4.1.2. Software architecture............................................................................................ 19
4.2. Quick reference data....................................................................................................20
4.2.1. SCL01X dimensions .............................................................................................20
4.2.2. LED behavior ........................................................................................................ 20
4.2.3. Other data............................................................................................................. 21
5. Software modules................................................................................................................22
5.1. Installation....................................................................................................................22
5.2. Utilities..........................................................................................................................22
5.3. Driver............................................................................................................................22
5.3.1. SCL01X listing ...................................................................................................... 22
5.3.2. Supported operating systems...............................................................................22

5.3.3. PC/SC 2.0 compliant ATR ....................................................................................23
5.4. Firmware ......................................................................................................................28
5.4.1. CCID-like transport protocol.................................................................................. 28
5.4.2. Automatic PPS......................................................................................................29
6. Commands description........................................................................................................30
6.1. Generic APDU..............................................................................................................30
6.1.1. Get UID Command ...............................................................................................30
6.1.2. Escape command APDU......................................................................................32
6.2. Set of APDU for contactless storage user tokens........................................................33
6.2.1. STORAGE_CARD_CMDS_READ_BINARY........................................................ 33
6.2.2. STORAGE_CARD_CMDS_WRITE_BINARY ...................................................... 35
6.2.3. STORAGE_CARD_CMDS_LOAD_KEYS............................................................ 37
6.2.4. STORAGE_CARD_CMDS_AUTHENTICATE......................................................38
6.2.5. STORAGE_CARD_CMDS_VALUE_BLOCK ....................................................... 40
6.3. Set of APDU for ISO/IEC14443-4 user tokens ............................................................41
6.3.1. T=CL Command....................................................................................................41
6.3.2. T=CL user command ............................................................................................ 42
6.4. Set of APDU defined by SCM Microsystems...............................................................43
6.4.1. MIFARE DESFire Commands ..............................................................................43
6.4.2. Commands for communicating with NFC Forum Tags Type 1............................. 43
6.4.3. Commands for communicating with NFC Forum Tags Type 2............................. 52
6.4.4. Commands for communication with NFC Forum Tags Type 3............................. 52
6.4.5. Commands for communicating with NFC Forum Tags Type 4............................. 54
6.4.6. PASS_THROUGH command ...............................................................................54
Escape commands..................................................................................................................56
6.4.7. Sending escape commands to SCL01X...............................................................56
6.4.8. Escape command codes....................................................................................... 56
6.4.9. READER_GETCARDINFO................................................................................... 57
6.4.10. READER_LED_CONTROL_BY_FW.................................................................... 57
6.4.11. READER_LEDCONTROL .................................................................................... 57
6.4.12. READER_CNTLESS_GET_ATS_ATQB.............................................................. 58
6.4.13. READER_CNTLESS_GET_TYPE .......................................................................58
6.4.14. READER_CNTLESS_SET_TYPE........................................................................ 59
6.4.15. READER_CNTLESS_RF_SWITCH ..................................................................... 60
6.4.16. READER_CNTLESS_RAW_CFG ........................................................................60
6.4.17. READER_CNTLESS_RAW_XMIT .......................................................................61
6.4.18. READER_ CNTLESS_DISABLE_PPS.................................................................62
6.4.19. READER_CNTLESS_848KBPS........................................................................... 62
6.4.20. READER_CNTLESS_BAUDRATE.......................................................................63
6.4.21. READER_CNTLESS_FORCE_BAUDRATE_PCSC_REV2 ................................64
6.4.22. READER_GETPNPPARAMS............................................................................... 65
6.4.23. READER_GETSLOTINFO.................................................................................... 65
6.4.24. READER_GET_CARD_DETAILS ........................................................................ 66
6.4.25. READER_IS_SCL01x........................................................................................... 67
6.4.26. READER_SEND_ATTRIB_WITH_INF.................................................................68
7. Annexes...............................................................................................................................69
7.1. Annex A –Status words table......................................................................................69
7.2. Annex B –Sample code using escape commands through Escape IOCTL ...............70
7.3. Annex C –Mechanical drawings..................................................................................75
7.3.1. Top casing............................................................................................................. 75
7.3.2. Bottom casing ....................................................................................................... 76
7.3.3. Cradle.................................................................................................................... 77

7.3.4. Snap-on card holder .............................................................................................78

SCL01X REFERENCE MANUAL 8
1.Legal information
1.1. Disclaimers
The content published in this document is believed to be accurate. SCM Microsystems 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.
SCM Microsystems 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. SCM Microsystems 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
[e-mail].
1.2. FCC
1.2.1. Section 15.21 Information to user
Changes or modifications not expressly approved by the party responsible for compliance could
void the user's authority to operate the equipment
1.2.2. Section 15.105 (b)
Note: This equipment has been tested and found to comply with the limits for a Class B digital
device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable
protection against harmful interference in a residential installation. This equipment generates,
uses and can radiate radio frequency energy and, if not installed and used in accordance with
the instructions, may cause harmful interference to radio communications. However, there is no
guarantee that interference will not occur in a particular installation.
If this equipment does cause harmful interference to radio or television reception, which can be
determined by turning the equipment off and on, the user is encouraged to try to correct the
interference by one or more of the following measures:
--Reorient or relocate the receiving antenna.
--Increase the separation between the equipment and receiver.
--Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
--Consult the dealer or an experienced radio/TV technician for help.
1.3. 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.

SCL01X REFERENCE MANUAL 9
You MAY NOT copy or distribute parts of or the entire source code without prior
written consent from SCM Microsystems.
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 SCM Microsystems products, they are
provided for documentation purposes only. SCM Microsystems does not grant you any license
to its designs.
1.4. Trademarks
MIFARE is a registered trademark of NXP Semiconductors BV.
FeliCa is a registered trademark of Sony Corporation.
Jewel and Topaz are trademarks of Innovision Research and Technology Plc.
Windows is a trademark of Microsoft Corporation.

SCL01X REFERENCE MANUAL 10
2.Introduction to the manual
2.1. Objective of the manual
This manual provides an overview of the hardware and software features of the SCL01X
contactless reader, hereafter referred to as ―SCL01X‖.
This manual describes in details interfaces and supported commands available for developers
using SCL01X in their applications.
2.2. Target audience
This document describes the technical implementation of SCL01X.
The manual targets software developers. It assumes knowledge about 13.56 MHz contactless
technologies like ISO/IEC 14443 and commonly used engineering terms.
Should you have questions, you may send them to [e-mail] .
2.3. Product version corresponding to the manual
This manual is related to the version indicated below, and all further versions.
Item
Version
Hardware
4.4
Firmware
1.09
Windows
Driver
5.06
Linux
2.06
MAC
2.06

SCL01X REFERENCE MANUAL 11
2.4. Definition of various terms and acronyms
Term
Expansion
APDU
Application Protocol Data Unit
ATR
Answer to Reset, defined in ISO7816
ATS
Answer to select, defined in ISO/IEC 14443
Byte
Group of 8 bits
CCID
Chip Card Interface Device
CID
Card Identifier
CL
Contactless
DFU
Device Firmware Upgrade
DR
Divider receive: used to determine the baud rate between the reader to the card
DS
Divider send: used to determine the baud rate between the card to the reader
FeliCa™
Sony contactless technology standardized in ISO18092, technology underlying the
NFC Forum tag type 3
Jewel/Topaz
Innovision contactless technology, technology underlying the NFC Forum tag type
1
LED
Light emitting diode
MIFARE
The ISO14443 Type A with extensions for security (NXP)
NA
Not applicable
NAD
Node Address
NDEF
NFC Data Exchange Format: data structure defined by the NFC Forum for NFC
Forum tags.
NFC
Near Field Communication
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
P2P
Peer - to - Peer
PCD
Proximity Coupling Device
PC/SC
Personal Computer/Smart Card: software interface to communicate between a PC
and a smart card
PICC
Proximity Integrated Chip Card
PID
Product ID
Proximity
Distance coverage till ~10 cm.
PUPI
Pseudo unique PICC identifier
RFU
Reserved for future use
RF
Radio Frequency
STCIII
Smart card reader controller ASIC from SCM Microsystems
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

SCL01X REFERENCE MANUAL 12
2.5. References
Doc ref in
the manual
Description
Issuer
ISO/IEC
7816-4
Identification cards - Integrated circuit(s) cards
with contacts
Part 4: Interindustry commands for interchange
ISO/IEC 7816-4: 1995 (E)
ISO / IEC
ISO/IEC
14443-4
Identification cards —Contactless integrated
circuit(s) cards —Proximity cards
Part 4: Transmission protocol ISO/IEC 14443-
4:2001(E)
ISO / IEC
ISO/IEC
18092
Information technology —Telecommunications
and information exchange between systems —
Near Field Communication —Interface and
Protocol (NFCIP-1) ISO/IEC 18092:2004(E)
ISO / IEC
NFC Forum
tag type 1
NFCForum-TS-Type-1-Tag_1.0
NFC Forum
NFC Forum
tag type 2
NFCForum-TS-Type-2-Tag_1.0
NFC Forum
NFC Forum
tag type 3
NFCForum-TS-Type-3-Tag_1.0
NFC Forum
NFC Forum
tag type 4
NFCForum-TS-Type-4-Tag_1.0
NFC Forum
PC/SC
Interoperability Specification for ICCs and
Personal Computer Systems v2.01
PC/SC Workgroup
NFC
wrapper
User manual of the NFC wrapper. This manual
is part of SCM‘s Contactless SDK.
SCM Microsystems
CCID
Specification for Integrated Circuit(s) Cards
Interface Devices 1.1
USB-IF
USB
Universal Serial Bus Specification 2.0
USB-IF

SCL01X REFERENCE MANUAL 13
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 nibbleMost significant nibble
1 Byte = 8 bits = 2 nibbles
Bit number 0Bit 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

SCL01X REFERENCE MANUAL 14
3.General information about SCL01X
3.1. SCL01X key benefits
With its combination of a modern slim design and its state of the art multi-protocol feature set,
SCL01X is the perfect desktop reader choice to support various contactless applications such
as electronic ID, payment & public transportation schemes and to interact with NFC-enabled
devices.
As for all SCM Microsystems products, SCL01X is designed to offer best in class
interoperability with various formats of tokens: cards, dongles, watches or NFC mobile phones.
Its infield upgradeable firmware makes SCL01X a secure and future-proof investment providing
both flexibility and fast time to market for new applications as well as minimum risk linked to
contactless technology standards evolution.
As a latest generation product, SCL01X can be supported by SCM‘s middleware that resides
above the PC/SC API and offers better portability of applications and abstraction of smart card
related details that need to be handled by applications developed on top of the PC/SC API.
3.2. SCL01X key features
Multi-protocol 13.56MHz contactless reader:
oISO14443 type A & B,
oMIFARE,
oFeliCa™
oTopaz (NFC Forum tag type 1)
oNFC Peer-to-peer communication will be available through FW upgrade
PC/SC v2.0 compliant
In field upgradeable firmware
Unique serial number which enables that SCL01X can be plugged into any USB slot
on a PC without having to re-install the driver.

SCL01X REFERENCE MANUAL 15
3.3. SCL01X ordering information
Item
Part number
SCL01X
905205
Cradle
905106
Snap-on card holder
112302LF
Contactless SDK
905266

It is important to note that those accessories are incompatible with each other
–i.e. when the snap-on card holder is fitted on the SCL01X, the cradle cannot
be used anymore.
3.4. SCL01X customization options
Upon request, SCM can customize:
The color of the casing
The logo
The product label
The USB strings
Terms and conditions apply, please contact your local SCM representative or send an email to
[e-mail].

SCL01X REFERENCE MANUAL 16
3.5. Contactless communication principles and SCL01X
usage recommendations
SCL01X is a contactless reader1designed to
communicate with user tokens.
User tokens2are made of a contactless
integrated circuit card connected to an
antenna
User tokens can take several form factors:
Credit card sized smart card
Key fob
NFC mobile phone etc…
Communication between SCL01X and user tokens uses magnetic field inductive coupling.
The magnetic field is generated by SCL01X has a carrier frequency of 13.56MHz.
3.5.1. Power supply
When the user token is put in the magnetic field of the reader, its antenna couples with the
reader and an induction current appears in the antenna thus providing power to the integrated
circuit. The generated current is proportional to the magnetic flux going through the antenna of
the user token.
3.5.2. Data exchange
The carrier frequency of the magnetic field is used as a fundamental clock signal for the
communication between the reader and the card. It is also use as a fundamental clock input for
the integrated circuit microprocessor to function.
To send data to the user token the reader modulates the amplitude of the field. There are
several amplitude modulation and data encoding rules defined in ISO/IEC 14443 and ISO/IEC
18092. The reader should refer to those standards for further details.
To answer to the reader, the integrated circuit card of the user token modulates its way of
loading (impedance) the field generated by the reader. Here also further details can be found in
ISO/IEC 14443 and ISO/IEC 18092.
1In the ISO/IEC 14443 standard, the reader is called the proximity coupling device (PCD)
2In the ISO/IEC 14443 standard, the user token is called proximity integrated chip card (PICC)

SCL01X REFERENCE MANUAL 17
3.5.3. Recommendations
The communication between the reader and the user token is sensitive to the presence of
material or objects interfering with the magnetic field generated by the reader.
The presence of conductive materials like metal in the vicinity of the reader and the user token
can severally degrade the communication and even make it impossible. The magnetic field of
the reader generates Eddy or Foucault‘s currents in the conductive materials; the field is
literally absorbed by that kind of material.

It is recommended for proper communication to avoid putting SCL01X in close
proximity of conductive materials.
The presence of multiple user tokens in the field also interferes with the communication. When
several user tokens are in the field of the reader, load of the field increases which implies that
less energy is available for each of them and that the system is detuned. For this reason, SCM
Microsystems has implemented in its driver only 1 slot. This means that in the event several
user tokens are in the field of the SCL01X, only one will be active.

It is recommended to present only one user credential at a time in front of
SCL01X.
The communication between the reader and the user token is sensitive to the geometry of the
system {reader, user token}. Parameters like the geometry and specially the relative size of the
reader and user token antennas directly influence the inductive coupling and therefore the
communication.
SCL01X was primarily designed and optimized to function with user credentials of various
technologies having the size of a credit card.

It may happen that SCL01X is not capable of communicating with extremely
large or extremely small antennas.

In order to optimize the coupling between the reader and the user token, it is
recommended to put both antennas as parallel as possible

In order to optimize transaction speed between the reader and the card it is
recommended to place the user token as close as possible to the reader. This
will increase the amount of energy supplied to the user credential which will
then be able to use its microprocessor at higher speeds

SCL01X REFERENCE MANUAL 18
3.6. Applications
3.6.1. General
SCL01X is a transparent reader designed to interface a personal computer host supporting
PC/SC interface with 13.56MHz user tokens like public transport cards, contactless banking
cards, NFC forum tags, electronic identification documents –e.g. e-passports, e-ID cards,
driving licenses etc.
Those user tokens can have several form factors like credit cards, key fobs, NFC mobile
phones or USB dongles like SCT3511 that SCM Microsystems markets.
SCL01X 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.6.2. Applications provided by SCM Microsystems
SCM Microsystems does not provide payment or transport applications.
SCM Microsystems provides a few applications for development and evaluation purposes that
can function with SCL01X. They are available within
the software development kit. There are many tools
provided but the two main ones are:
The NFC forum tag reader/writer is a
standalone application that enables the
user to read and write NFC forum
compliant records into NFC forum
compatible tags. It is an easy to use tool to
configure rapidly NFC forum tag
demonstrations.
Smart card commander version 1.1
provides NFC forum record parsing
functionality of NDEF records in XML
format as well as scripting functionality
which can be very useful for developers to
develop and debug their applications

SCL01X REFERENCE MANUAL 19
4.SCL01X characteristics
4.1. SCL01X high level architecture
4.1.1. Block diagram
The link between SCL01X and the host to which it is connected is the USB interface providing
both the power and the communication channel.
Device controller
STC3 ASIC (SCM) with
embedded flash
NFC front-end
PN512 (NXP)
EMC filter +
Matching circuitry +
power amplifier
LED
text
text
text
Antenna
To host
SCL01X has a device controller which is SCM‘s STC3 ASIC. This ASIC has several interfaces
available. In SCL01X implementation 2 peripherals are connected to the device controller:
Status indicator LED
A NFC front-end that handles the RF communication
The ASIC embeds flash memory that is programmed during the manufacturing of SCL01X
devices. This flash contains the firmware developed by SCM Microsystems to handle all the RF
communication protocols and the PC/SC communication protocol with the host. The flash can
be upgraded once the device is deployed on the field, hence enabling firmware upgrades to
add and potentially patch features.
The NFC front-end ensures the coding/decoding/framing modulation/demodulation required for
the RF communication. It is controlled by the device controller through registers.
The matching circuitry provides the transmission and receiver paths adaptation for the antenna
to function properly.
4.1.2. Software architecture
Applications can interface with the driver
directly through the PC/SC interface or
through the SCM proprietary interface to the
NFC wrapper.
The NFC wrapper simplifies the usage of
the different NFC Forum tags with the
SCL01X and other SCM contactless
readers. It provides a unique API to
application developers, which enables them
to read and modify NDEF records without
further knowledge of the underlying
hardware and protocols. Detailed
information about the NFC wrapper can be
found in SCM‘s Contactless SDK.
The SCL01X driver implements PC/SC v2.0 API towards upper layers and uses SCM firmware
commands encapsulated in CCID-like protocol.
The SCL01X firmware handles all the contactless-related intelligence –i.e. ISO/IEC 14443,
ISO/IEC 18092 etc.
Application
NFC wrapper
Driver
Firmware
SCM API (for P2P and
extra services)
PC/SC v2.0 API (ADPU
from ISO/IEC 7816-4
and SCM proprietray)
CCID-like interface

SCL01X REFERENCE MANUAL 20
4.2. Quick reference data
4.2.1. SCL01X dimensions
Item
Characteristic
Value
SCL01
X
Weight
70 Grams
External
dimensions
L 110 mm W 65mm H 8mm
Cable length
1 Meter
Default color
Cool gray textured
Default logo
SCM logo
Default label
(SCL010
example)
Cradle
Weight
32 Grams
External
dimensions
L 83mm W 80mm H 40 mm
Default color
Cool gray
Snap-
on card
holder
Weight
7 Grams
External
dimensions
L 72mm W 65mm H 11.6 mm
Default color
Translucent black
Drawing with dimensions of the SCL01X and accessories can be found in annex.
4.2.2. LED behavior
The LED behavior of the SCL01X is given below.
SCL01X states
LED Indication (GREEN)
After plug-in (Driver is not installed or driver is
installed but either some files related to SCL01X
or OS, resource manager is deleted/ missing
where there is a situation the reader cannot work
OFF
Just after plug-in (with drivers already installed)
ON
Firmware upgrade running
ON
Just after DFU operation
ON
Suspend / hibernate state
OFF