Owner manual

ManualsBrandsMaxim Integrated ManualsHardware73S1217F CCID USB Linux Driver

Simplifying System Integration

73S1215F, 73S1217F

CCID USB Linux Driver

Installation Guide

April 27, 2009

Rev. 1.00

UG_12xxF_041

Summary of content (16 pages)

PAGE 1
Simplifying System IntegrationTM 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide April 27, 2009 Rev. 1.
PAGE 2
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 © 2009 Teridian Semiconductor Corporation. All rights reserved. Teridian Semiconductor Corporation is a registered trademark of Teridian Semiconductor Corporation. Simplifying System Integration is a trademark of Teridian Semiconductor Corporation. Microsoft is a registered trademark of Microsoft Corporation. Windows XP is a registered trademark of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds.
PAGE 3
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide Table of Contents 1 Introduction ......................................................................................................................................... 4 2 Components ........................................................................................................................................ 4 2.1 Basic USB Requirements ..................................................................................
PAGE 4
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 1 Introduction This document provides the installation procedures for the Linux® user space CCID device driver in support of the Teridian 12xx Smart Card Chip. This document assumes that this installation is as userid root. 2 Components This section lists the web sites and software components necessary to create an operational CCID environment. 2.1 2.1.
PAGE 5
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide The following software packages are required for a complete driver: pcsc-lite-1.4.0.tar.gz ccid-1.2.1-tar.gz libmusclecard-1.3.3.tar.gz HandlerTest-0.3.1.tar.gz Next, proceed to: http://ludovic.rousseau.free.fr/softwares/ The following software packages are also required: http://ludovic.rousseau.free.fr/softwares/pcsc-tools/index.html pcsc-tools-1.4.11.tar.gz http://ludovic.rousseau.free.fr/softwares/pcsc-perl/index.html pcsc-perl-1.
PAGE 6
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 pcsc-lite-1.4.0 ccid-1.2.1 libmusclecard-1.3.3 HandlerTest-0.3.1 pcsc-tools-1.4.8 pcsc-perl-1.4.
PAGE 7
UG_12xxF_041 3.3 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide Required Package Build Order The following order of package builds must be adhered to for proper operation of the resultant user space device driver. 1. 2. 3. 4. pcsc-lite-1.4.0 ccid-1.2.1 pcsc-perl-1.4.6 pcsc-tools-1.4.8 Installation will eventually result in creation of: /usr/local/pcsc/drivers The following packages are optional: libmusclecard-1.3.3 HandlerTest-0.3.1 3.
PAGE 8
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 #Teridian 0x1862:0x0000:TSC12xxF Save the changes. Now install the ccid-1.2.1 build output, as follows: make install This step will install the following file, containing your change: /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist Verify your change as follows: grep -n TSC12xxF /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist root@slack:/usr/local/src/CCID/ccid-1.2.
PAGE 9
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide To copy the new shared library, enter the following: cd /usr/local/pcsc/drivers/ifd-ccid.bundle/ cp -v Contents/Linux/libccid.so.1.2.1/usr/local/lib/ /sbin/ldconfig -v |grep ccid This sequence of commands installs the new shared library in a system recognized location and add it to the system search list. root@slack:/usr/local/src/CCID/pcsc-lite-1.4.0# cd /usr/local/pcsc/drivers/ifd-ccid.
PAGE 10
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide 3.4.4 UG_12xxF_041 pcsc-tools-1.4.8 Enter the following command sequence: cd /usr/local/src/CCID/ make make install This will build and install pcsc_scan in /usr/local/bin/. 3.4.5 CCID Driver Operation At this point, all four required packages have been built and installed. It is now time to activate the newly installed driver and test the smart card device.
PAGE 11
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide Apr 30 15:47:02 slack kernel: [492776.151366] usb 3-2: default language 0x0409 Apr 30 15:47:02 slack kernel: [492776.164344] usb 3-2: new device strings: Mfr=1, Product=2, SerialNumber=3 Apr 30 15:47:02 slack kernel: [492776.164415] usb 3-2: Product: TSC12xxF Apr 30 15:47:02 slack kernel: [492776.164447] usb 3-2: Manufacturer: Teridian Semiconductors Apr 30 15:47:02 slack kernel: [492776.
PAGE 12
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 Apr 30 15:47:03 slack pcscd: ifdhandler.c:271:IFDHGetCapabilities() lun: 0, tag: 0xFAE Apr 30 15:47:03 slack pcscd: ifdhandler.c:313:IFDHGetCapabilities() Reader supports 2 slots Apr 30 15:47:03 slack pcscd: ifdhandler.c:271:IFDHGetCapabilities() lun: 0, tag: 0xFAC Apr 30 15:47:03 slack pcscd: readerfactory.c:1108:RFInitializeReader() Attempting startup of TSC12xxF (123456788) 00 01 using /usr/local/pcsc/drivers/ifd-ccid.
PAGE 13
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide ATR: 3B EF 00 FF 81 31 86 45 49 42 4D 20 4D 46 43 34 30 30 30 30 38 33 31 43 ATR: 3B EF 00 FF 81 31 86 45 49 42 4D 20 4D 46 43 34 30 30 30 30 38 33 31 43 + TS = 3B --> Direct Convention + T0 = EF, Y(1): 1110, K: 15 (historical bytes) TB(1) = 00 --> VPP is not electrically connected TC(1) = FF --> Extra guard time: 255 (special value) TD(1) = 81 --> Y(i+1) = 1000, Protocol T = 1 ----TD(2) = 31 --> Y(i+1) = 0011, Protocol T = 1 ----TA(
PAGE 14
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 When pcsc_scan is started it asks pcscd the list of available smart card readers. The list is printed. A sequence number is printed before each reader. Example: PC/SC device scanner V 1.1.0 (c) 2001-2002, Ludovic Rousseau PC/SC lite version: 1.1.
PAGE 15
UG_12xxF_041 73S1215F, 73S1217F CCID USB Linux Driver Installation Guide 5 Related Documentation The following 73S12xxF documents are available from Teridian Semiconductor Corporation: 71S1215F Data Sheet 71S1217F Data Sheet 73S12xxF Smart Card Terminal Controller Family Software User’s Guide 73S12xxF Evaluation Board User’s Guide Teridian Flash Programming Tool 73S1215F, 73S1217F Boot Loader – DFU Class Firmware Application Note 73S1215F, 73S1217F Windows XP 32 USB CCID and DFU Drivers Installation Guide
PAGE 16
73S1215F, 73S1217F CCID USB Linux Driver Installation Guide UG_12xxF_041 Revision History Revision 1.00 16 Date 4/27/2009 Description First publication. Rev. 1.