User Manual
SCM Microsystems Reference Manual – version 1.3 SCL3711 Multiprotocol contactless mobile reader Reference manual SCL3711 Multiprotocol Contactless mobile Reader © SCM Microsystems Oskar-Messter-Strasse, 13 85737 Ismaning Germany Phone +49 89 9595 5000 • Fax +49 89 9595 5555 Table of Contents 1. Legal information ............................................................................................................... 5 1.1. Disclaimers..................................................................................................................... 5 1.2. Licenses ......................................................................................................................... 5 1.3. Trademarks .................................................................................................................... 5 2. Introduction to the manual ................................................................................................. 6 2.1. Objective of the manual ................................................................................................. 6 2.2. Target audience ............................................................................................................. 6 2.3. Product version corresponding to the manual ............................................................... 6 2.4. Definition of various terms and acronyms ...................................................................... 7 2.5. References ..................................................................................................................... 8 2.6. Conventions ................................................................................................................... 9 3. General information about SCL3711 ............................................................................... 10 3.1. SCL3711 key benefits .................................................................................................. 10 3.2. SCL3711 key features.................................................................................................. 10 3.3. SCL3711 ordering information ..................................................................................... 11 3.4. SCL3711 customization options................................................................................... 11 3.5. Contactless communication principles and SCL3711 usage recommendations ......... 12 3.5.1. Power supply......................................................................................................... 12 3.5.2. Data exchange ...................................................................................................... 12 3.5.3. Recommendations ................................................................................................ 13 3.6. Applications .................................................................................................................. 14 3.6.1. 3.6.2. 4. General ................................................................................................................. 14 Applications provided by SCM Microsystems....................................................... 14 SCL3711 characteristics .................................................................................................. 15 4.1. SCL3711 high level architecture .................................................................................. 15 4.1.1. Block diagram ....................................................................................................... 15 4.1.2. Software architecture ............................................................................................ 15 4.2. Quick reference data .................................................................................................... 16 4.2.1. 4.2.2. 4.2.3. 5. SCL3711 dimensions............................................................................................ 16 LED behavior ........................................................................................................ 16 Other data ............................................................................................................. 16 Software modules ............................................................................................................ 18 5.1. Installation .................................................................................................................... 18 5.2. Utilities .......................................................................................................................... 19 5.3. Driver ............................................................................................................................ 19 5.3.1. SCL3711 listing ..................................................................................................... 19 5.3.2. Supported operating systems ............................................................................... 19 5.3.3. PC/SC 2.0 compliant ATR .................................................................................... 20 5.4. Firmware ...................................................................................................................... 25 5.4.1. Transport protocol ................................................................................................. 25 5.4.2. Automatic PPS ...................................................................................................... 25 SCL3711 REFERENCE M ANUAL 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 support@scmmicro.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 applications ONLY in form of compiled applications. • 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.3. 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 registered trademark of Microsoft Corporation SCL3711 REFERENCE M ANUAL 2. Introduction to the manual 2.1. Objective of the manual This manual provides an overview of the hardware and software features of the SCL3711 multiprotocol mobile contactless reader, hereafter referred to as “SCL3711”. This manual describes in details interfaces and supported commands available for developers using SCL3711 in their applications. 2.2. Target audience This document describes the technical implementation of SCL3711. 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 support@scmmicro.com . 2.3. Product version corresponding to the manual Item Version Hardware 0.2 Firmware 2.7.0 Driver 1.02 SCL3711 REFERENCE M ANUAL 2.4. Definition of various terms and acronyms Term Expansion APDU ATR ATS Byte CCID CID CL CLA DFU FeliCa™ Application Protocol Data Unit Answer to Reset, defined in ISO7816 Answer to Select, defined in ISO14443 Group of 8 bits Chip Card Interface Device Card Identifier Contactless Class byte defined in ISO 7816 Device Firmware Upgrade Sony contactless technology standardized in ISO18092, technology underlying the NFC Forum tag type 3 Instruction byte defined in ISO7816 Innovision contactless technology, technology underlying the NFC Forum tag type Light emitting diode The ISO14443 Type A with extensions for security (NXP) Not applicable Node Address NFC Data Exchange Format: data structure defined by the NFC Forum for NFC Forum tags. Near Field Communication 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 Peer – to – Peer Proximity Coupling Device Personal Computer/Smart Card: software interface to communicate between a PC and a smart card Proximity Integrated Chip Card Product ID Protocol Parameter Selection Distance coverage till ~10 cm. Pseudo unique PICC identifier Reserved for future use Radio Frequency Smart card reader controller ASIC from SCM Microsystems Status word defined in ISO7816 Universal Serial Bus Vendor ID Binary notation of a number x, y, z ∈{0,1} The byte value YY is represented in hexadecimal INS Jewel/Topaz LED MIFARE NA NAD NDEF NFC Nibble P2P PCD PC/SC PICC PID PPS Proximity PUPI RFU RF STC3 SW1 SW2 USB VID (xyz)b 0xYY SCL3711 REFERENCE M ANUAL 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) Identification cards — Contactless integrated circuit(s) cards — Proximity cards Part 4: Transmission protocol ISO/IEC 144434:2001(E) Information technology — Telecommunications and information exchange between systems — Near Field Communication — Interface and Protocol (NFCIP-1) ISO/IEC 18092:2004(E) NFCForum-TS-Type-1-Tag_1.0 ISO / IEC NFC Forum NFCForum-TS-Type-2-Tag_1.0 NFC Forum NFCForum-TS-Type-3-Tag_1.0 NFC Forum NFCForum-TS-Type-4-Tag_1.0 NFC Forum Interoperability Specification for ICCs and Personal Computer Systems v2.01 User manual of the NFC wrapper. This manual is part of SCM’s Contactless SDK. Specification for Integrated Circuit(s) Cards Interface Devices 1.1 Universal Serial Bus Specification 2.0 PC/SC Workgroup ISO/IEC 14443-4 ISO/IEC 18092 NFC Forum tag type 1 NFC Forum tag type 2 NFC Forum tag type 3 NFC Forum tag type 4 PC/SC NFC wrapper CCID USB ISO / IEC ISO / IEC SCM Microsystems USB-IF USB-IF SCL3711 REFERENCE M ANUAL 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. Example: 163 in decimal 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 SCL3711 REFERENCE M ANUAL 10 3. General information about SCL3711 3.1. SCL3711 key benefits With its functional solid mechanical design that has no removable parts that you may loose, SCL3711 is perfect for mobile uses. While being slim, SCL3711 dimensions have been optimized to ensure best RF performance possible with such a form factor. The state of the art multi-protocol feature set of SCL3711 qualifies it to be used in a wide range of applications such as payment, loyalty and ID schemes, or to enable devices with NFC connectivity. As a latest generation product, SCL3711 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. SCL3711 key features • • Multi-protocol 13.56MHz contactless reader: ISO14443 type A & B, MIFARE, FeliCa™ NFC Peer-to-peer communication will be available through driver upgrade PC/SC v2.0 compliant SCL3711 REFERENCE M ANUAL 3.3. SCL3711 ordering information Item Part number SCL3711 905108 Contactless SDK 905124 3.4. 11 SCL3711 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 sales@scmmicro.com. SCL3711 REFERENCE M ANUAL 12 3.5. Contactless communication principles and SCL3711 usage recommendations SCL3711 is a contactless reader designed to communicate with user tokens. User tokens User tokens are made of a contactless integrated circuit card connected to an antenna Credit card sized smart card • Key fob • NFC mobile phone etc… 71 L3 • SC User tokens can take several form factors: Communication between SCL3711 and user tokens uses magnetic field inductive coupling. The magnetic field generated by SCL3711 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. In the ISO/IEC 14443 standard, the reader is called the proximity coupling device (PCD) In the ISO/IEC 14443 standard, the user token is called proximity integrated chip card (PICC) SCL3711 REFERENCE M ANUAL 13 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 SCL3711 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 the support for 1 slot only. It is recommended to present only one user credential at a time in front of SCL3711. 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. SCL3711 was primarily designed and optimized to function with user credentials of various technologies having the size of a credit card. It may happen that SCL3711 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 SCL3711 REFERENCE M ANUAL 3.6. 14 Applications 3.6.1. General SCL3711 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. SCL3711 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 SCL3711. 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 a module which for NFC forum tags that parses and presents in XML format the content of the tag. Smart card commander also contains powerful scripting functionality which can be very useful for developers to develop and debug their applications. SCL3711 REFERENCE M ANUAL 15 4. SCL3711 characteristics 4.1. SCL3711 high level architecture 4.1.1. Block diagram The link between SCL3711 and the host to which it is connected is the USB interface providing both the power and the communication channel. SCL3711 is based designed around an NFC controller which handles the USB communication to the host and the RF communication. This controller ensures the coding/decoding/framing modulation/demodulation required for the RF communication. 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 SCL3711 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. Application SCM API (for P2P and extra services) SCM’s NFC wrapper PC/SC v2.0 API (ADPU from ISO/IEC 7816-4 and SCM defined) Driver Firmware The SCL3711 driver implements PC/SC v2.0 API towards upper layers. SCL3711 REFERENCE M ANUAL 4.2. 16 Quick reference data 4.2.1. SCL3711 dimensions Item Characteristic Value Weight External dimensions(mm) Cable length Default color Default logo 10.2 Grams 65.4(L) x 24(W) x 10 (H) NA BLACK Textured Finish SCM logo SCL3711 Default label Drawing with dimensions of the SCL3711 and accessories can be found in annex. 4.2.2. LED behavior The LED behavior of the SCL3711 is given below. SCL3711 states LED Indication (GREEN) After plug-in (no driver loaded) Driver successfully loaded User token arriving in the field User token removed from the field Suspend/hibernate/shutdown state SCL3711 disabled OFF ON One blink ON, no specific visual indication OFF OFF 4.2.3. Other data Parameter Value/Description DC characteristics Low bus powered (SCL3711 draws power from USB bus) Voltage: 5V Max Current : 100mA Suspend current : 260uA Clock of the device controller RF carrier frequency Modulation Unloaded field strength USB specification Max 27.12MHz 13.56 MHz +/- 50 ppm 12 to 14 % 1.5 A/m to 2.2 A/m ( Un-modulated RF on reader casing) USB 2.0 FS Devise SCL3711 REFERENCE M ANUAL USB Speed Device Class PID VID API ID1 format tokens supported Maximum baud rate Multiple PICC in field Operating temperature range Operating humidity range Storage condition range Certifications 17 Full Speed Device (12Mbit/s) Vendor 0x5591 0x04E6 PC/SC 2.0 NFC forum tag type 1 through SCM-specific APDU NFC forum tag type 2 through PC/SC-defined APDUs NFC forum tag type 3 through SCM-specific APDU NFC forum tag type 4 through PC/SC APDUs ISO/IEC 14443-4 PICC type A and type B MIFARE, Non-Secure FeliCa™ 848 Kbps Not supportedUSB CE FCC VCCI WEEE RoHS WHQL UL Radio Frequency for Japan ** The FCC statement: "This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation” 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. 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. SCL3711 REFERENCE M ANUAL 18 5. Software modules 5.1. Installation No installer is available for installing the version of the driver this manual covers. To manually install the driver, please follow the following steps • Extract the content of the ZIP file SCM Microsystems has sent you • Plug-in the SCL3711 • Manually select the location where you extracted the driver to SCL3711 REFERENCE M ANUAL 19 5.2. Utilities 5.3. Driver NA The driver for Windows platforms is based on Microsoft WDF architecture. The driver package contains INF, SYS, CAT and the co-installer DLL required for the WDF architecture. 5.3.1. SCL3711 listing SCL3711 enumerates as SCL3711-NFC&RW After the driver is installed, SCL3711 appears in Windows resource manager as SCL3711 reader & NFC device: SCL3711 is listed by PC/SC applications as SCM Microsystems Inc. SCL3711 reader & NFC device N. Where N=0 if only one SCL3711 is connected but is incremented in case several SCL3711 are connected to the host. 5.3.2. Supported operating systems Operating systems supported by the driver: • Windows 2000 SP4 • Windows 2003 Server (32 & 64 bit) • Windows XP (32 & 64 bit) • Windows Vista (32 & 64 bit) • Windows Server 2008 (32 & 64 bit) • Linux (32 & 64 bit) • MACOSX SCL3711 REFERENCE M ANUAL 20 5.3.3. PC/SC 2.0 compliant ATR 5.3.3.1. Determining the technology of the user credential The ScardControl method of PC/SC (see http://msdn.microsoft.com/enus/library/aa379474(VS.85).aspx) should be used to send the 0x90 IOCTL to SCL3711 in order to determine what type of technology is the user token based on. The output buffer is a BYTE with the following meaning: Technology Value MIFARE1K 0x01 MIFARE4K 0x02 MIFARE Ultralight 0x03 ISO14443-4A 0x04 FeliCa 0x05 Topaz 0x06 ISO14443-4B 0x07 Once a user credential is selected the driver constructs an ATR from the fixed elements that identify the token. Depending on the user technology this ATR can be analyzed as described hereunder. SCL3711 REFERENCE M ANUAL 5.3.3.2. 21 ATR for type A memory user tokens The ATR of the user token is composed as described in the table below. In order to allow the application to identify the storage card properly, it’s Standard and Card name describing bytes must be interpreted according to the Part 3 Supplemental Document, maintained by PC/SC. Byte# Value Designation Description 0x3B Initial header 0x8n T0 n indicates the number of historical bytes in following ATR 0x80 TD1 Nibble8 indicates no TA2, TB2, TC2 Nibble 0 means T=0 0x01 TD2 Nibble8 indicates no TA3, TB3, TC3 Nibble 1 means T=1 4...3+n 0x80 0x4F Lentgh 4+n A status indicator may be present in an optional TLV data object Optional TLV data object Tag: Application identifier 1 byte RID Registered identifier on 5 bytes PIX Proprietary identifier extension on 3 bytes 0x00 0x00 0x00 0x00 4 RFU bytes 0x91 TCK XOR of all previous bytes Example of the ATR built for a MIFARE Classic 4K card: SCL3711 REFERENCE M ANUAL 5.3.3.3. 22 ATR for an NFC Forum tag type 1 user token (Topaz) Byte# Value Designation Description 0x3B Initial header 0x82 T0 TD1 present. 2 historical bytes in following ATR 0x80 TD1 Nibble8 indicates no TA2, TB2, TC2 and TD2 present Nibble 0 means T=0 0x01 TD2 Nibble8 indicates no TA3, TB3, TC3 Nibble 1 means T=1 0x02 Card Mode NFC TAG operating at Passive 106 baud rate 0x44 Card Type Card type is Topaz 0xXX TCK XOR of all previous bytes Example of the ATR built for a Topaz tag: SCL3711 REFERENCE M ANUAL 5.3.3.4. 23 ATR for a NFC Forum tag type 3 user token (FeliCa) Byte# Value Designation Description 0x3B Initial header 0x8C T0 TD1 present. following ATR 0x80 TD1 Nibble8 indicates no TA2, TB2, TC2 and TD2 present 12 historical bytes in Nibble 0 means T=0 0x01 TD2 Nibble8 indicates no TA3, TB3, TC3 Nibble 1 means T=1 0x04 Card Mode NFC TAG operating at Passive 212 baud rate 0x43 Card Type Card type is Felica 0xFD IFS Maximum frame size of felica card 7-14 ID Felica card Identifier – 8 bytes 15 0xXX Timeout Write Timeout indicated by card 16 0xXX TCK XOR of all previous bytes Example of the ATR built for a FeliCa user token: SCL3711 REFERENCE M ANUAL 5.3.3.5. 24 ATR for ISO/IEC 14443-4 user tokens The user token exposes its ATS or application information which is mapped to an ATR. The table describes how this mapping is done. Byte# Value Designation Description 0x3B Initial header 0x8n T0 n indicates the number of historical bytes in following ATR 0x80 TD1 Nibble8 indicates no TA2, TB2, TC2 Nibble 0 means T=0 0x01 TD2 Nibble8 indicates no TA3, TB3, TC3 Nibble 1 means T=1 4...3+n 4+n Historical bytes or application information TCK Type A: the historical bytes from the ATS (up to 15 bytes) Type B (8 bytes): • Byte 0 through 3: application data from ATQB, • Byte 4 through 6: protocol info byte from ATQB, • Byte 7: higest nibble is the MBLI (maximum buffer length index) from ATTRIB, lowest nibble is 0x0 XOR of all previous bytes Example of the ATR built for an ISO14443-4 user tokens: Type A Type B SCL3711 REFERENCE M ANUAL 5.4. 25 Firmware 5.4.1. Transport protocol SCL3711 implements a transport protocol which is proprietary to NXP Semiconductors. 5.4.2. Automatic PPS Automatic PPS implemented is implemented. SCL3711 will automatically switch the highest baud rate commonly supported by the SCL3711 and the user token The maximum speed supported by SCL3711 is 848Kbps by default. SCL3711 REFERENCE M ANUAL 26
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.3 Linearized : No Page Count : 26 Producer : PrimoPDF Create Date : 2009:05:28 18:13:13 Modify Date : 2009:05:28 18:13:13 Title : Microsoft Word - IND.SCL3711.MANUAL.VER1.3-Mani.doc Creator : PrimoPDF http://www.primopdf.com/ Author : NithiyananthamKEXIF Metadata provided by EXIF.tools