/[pcsclite]/trunk/Drivers/ccid/README
ViewVC logotype

Diff of /trunk/Drivers/ccid/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 3232 by rousseau, Fri Dec 12 22:07:39 2008 UTC revision 4979 by rousseau, Fri Jun 4 13:29:42 2010 UTC
# Line 5  USB CCID IFD Handler Line 5  USB CCID IFD Handler
5  (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID  (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID
6  specifications from the USB working group.  specifications from the USB working group.
7    
8    [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
9    
10  Authors:  Authors:
11  ========  ========
# Line 19  Authors: Line 20  Authors:
20  Supported CCID readers:  Supported CCID readers:
21  =======================  =======================
22    
23  (in alphabetical order)  The list is available at http://pcsclite.alioth.debian.org/supported.html
 - ActivCard USB reader 3.0  
 - ActivCard Activkey Sim [66]  
 - Advanced Card Systems ACR 38U-CCID [16]  
   old versions of this reader have a bug: the reader do timeout when a  
   special USB frame is sent from the reader. If the frame size if a  
   multiple of wMaxPacketSize the communication is stopped.  
 - Alcor Micro AU9520 [46]  
   Firmware 1.01 is bogus. The time request sent by the card is not  
   forwarded by the reader to the host.  
 - Athena ASE IIIe USB V2 [29]  
 - Athena ASE IIIe KB USB [42]  
 - Blutronics Bludrive II CCID  
 - C3PO LTC31 (new model, USB product id 0x0006) [8]  
 - Cherry XX33 keyboard [?]  
 - Cherry XX44 keyboard (SmartBoard G83-6744) [18]  
 - Cherry SmartTerminal ST2000U [35]  
 - Cherry ST-1044U [27]  
 - Covadis Alya [63]  
 - Dell keyboard SK-3106 [?]  
 - Dell smart card reader keyboard [?]  
 - Eutron CryptoIdentity [26]  
 - Eutron Digipass 860 [59]  
 - Eutron SIM Pocket Combo [25]  
 - Eutron Smart Pocket [58]  
 - Gemalto GemPC 433 SL [2] (old name: GemPC 433 SL)  
 - Gemalto GemPC Card [41]  
 - Gemalto GemPC PinPad [67]  
 - Gemalto GemPC Twin [4]  
 - Gemalto GemCore POS Pro  
 - Gemalto GemCore SIM Pro  
 - Gemalto USB Shell Token V2 [3] (old name GemPC Key)  
 - Kobil KAAN Base [19]  
 - Kobil KAAN Advanced [20]  
 - Kobil KAAN SIM III [21]  
 - Kobil EMV TriCAP Reader [68]  
 - Kobil KAAN TriB@nk [69]  
 - Kobil SecOVID Reader III [70]  
 - Lexar Smart Enterprise Guardian [71]  
 - OmniKey CardMan 3121 [5]  
 - RSA SecureID SID800 [50]  
 - SCM Micro SCR 331 [6]  
   You shall upgrade the firmware [17] using version 5.18 or later.  
 - SCM Micro SCR 331-DI [11]  
   You shall upgrade the firmware [17] using version 6.22 or later.  
 - SCM Micro SCR 3310 [30]  
 - SCM Micro SCR 3311 [31]  
 - SCM Micro SCR 335 [7]  
   The firmware of this reader can't be upgraded so be sure to buy a  
   recent model with firmware 5.14 or later  
 - SCM Micro SCR 355  
 - SCM Micro SPR 532 [9]  
   You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a  
   firmware upgrade.  
 - SmartEpad (v 2.0) [32]  
   The firmware gives a very strange description of the reader (like a  
   dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.  
 - Verisign Secure Storage Token [24]  
 - Verisign Secure Token [?]  
 - Xiring Teo [52]  
 - Xiring Xi Sign PKI [76]  
24    
25    
26  Should work but untested by me:  Should work but untested by me:
# Line 89  I would like to get these readers to per Line 30  I would like to get these readers to per
30  move them in the supported list above. If you are one of the  move them in the supported list above. If you are one of the
31  manufacturers, please, contact me.  manufacturers, please, contact me.
32    
33  - Advanced Card Systems ACR122 [62]  The list is available at http://pcsclite.alioth.debian.org/shouldwork.html
 - Advanced Card Systems ACR122U PICC Interface  
 - Aladdin eToken PRO USB 72K Java [73]  
 - Axalto Reflex USB v3 [38]  
 - Atmel AT91SO [74]  
 - C3PO LTC32 [13]  
 - C3PO TLTC2USB  
 - C3PO KBR36  
 - Charismathics token  
 - Cherry SmartBoard, G83-6610 [61]  
 - Cherry SmartTerminal ST-1200USB  
 - Covadis Véga [64]  
 - Gemalto GemPC Express  
 - Gemalto Gem e-Seal Pro  
 - Fujitsu Siemens Computers SmartCard USB 2A [53]  
 - Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54]  
 - Gemalto PDT  
 - Giesecke & Devrient StarSign Card Token 350 (ICCD) [57]  
 - Giesecke & Devrient StarSign Card Token 550 (ICCD)  
 - HP USB Smart Card Keyboard [44]  
 - HP USB Smartcard Reader  
 - HP MFP Smart Card Reader  
 - id3 Semiconductors CL1356D [45] (tested by me but I don't have the  
   reader anymore)  
 - id3 Semiconductors CL1356T [48] (it should be the same firmware as the  
   CL1356D)  
 - id3 Semiconductors CL1356A HID  
 - iMONO 43 in 1 + Sim + Smart Card Reader  
 - KONA USB SmartCard  
 - Lenovo Integrated Smart Card Reader  
 - Lexar/Gemalto Smart Enterprise Guardian [60]  
 - MSI StarReader SMART [75]  
 - O2Micro Oz776 (0x7762 and 0x7772 versions)  
 - Oberthur ID-One Cosmo Card  
 - OmniKey CardMan 1021  
 - OmniKey CardMan 3021 [49]  
 - OmniKey CardMan 3621 [43]  
 - OmniKey CardMan 3821 [37]  
 - OmniKey CardMan 4321 [55]  
 - OmniKey CardMan 5121 [33]  
 - OmniKey CardMan 5125 [51]  
 - OmniKey CardMan 5321 [56]  
 - OmniKey CardMan 6121 [36]  
 - Philips JCOP41V221  
 - SafeNet IKey4000  
 - SchlumbergerSema Cyberflex Access e-gate ICCD  
 - SCM Micro SCR 331-DI NTTCom [23]  
 - SCM Micro SCR 3310-NTTCOM [28]  
 - SCM Micro SCR 3320 [31b]  
 - SCM Micro SCR 333 [15]  
 - SCM Micro SCR 3340 ExpressCard54 [34]  
 - SCM Micro SDI 010 [39]  
 - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  
 - Sitecom USB simcard reader MD-010  
 - SpringCard CrazyWriter  
 - SpringCard CSB6 Basic  
 - SpringCard CSB6 Secure  
 - SpringCard CSB6 Ultimate [72]  
 - SpringCard EasyFinger Standard  
 - SpringCard EasyFinger Ultimate  
 - SpringCard Prox'N'Roll  
 - Validy USB Token [65]  
 - Vasco DP905  
 - VMware Virtual USB CCID  
 - Winbond Electronics (for OEM only) [40]  
34    
35    
36  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
37  =============================================  =============================================
38    
39  - ActivCard USB reader 2.0 [10]  The list is available at http://pcsclite.alioth.debian.org/unsupported.html
     The reader do timeout when a special USB frame is sent from the  
     reader. If the frame size if a multiple of wMaxPacketSize the  
     communication is stopped.  
 - Broadcom Corp 5880 (found in Dell E6500 laptop)  
     No communication to the device ("Resource temporarily unavailable"  
     error)  
 - C3PO LTC31 (old model, USB product id 0x0003) [8]  
     The reader works fine with Linux kernel 2.4 but does not with Linux  
     kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)  
 - iDream (THRC2002-2) [47]  
     PPS fails with a Cryptoflex card  
     powerup fails with a Setcos card  
     does work with the belgium eID (the reader is sold for this  
     application)  
 - jNet Technology jToken s1  
     Reader does not respond at all  
 - Kobil mIDentity [22]  
     Time requests are not managed correctly and make the firmware fails.  
     This is not a problem unless you use a time-consuming APDU like RSA  
     key generation.  
     A new firmware will correct the bug.  
 - Reiner-SCT cyberJack pinpad(a)  
     Time requests are not managed and the driver may time out without  
     any response from the reader.  This is not a problem unless you use  
     a time-consuming APDU like RSA key generation.  
40    
41    
42  Supported operating systems:  Supported operating systems:
# Line 281  Inc., 51 Franklin Street, Fifth Floor, B Line 133  Inc., 51 Franklin Street, Fifth Floor, B
133  History:  History:
134  ========  ========
135    
136    1.3.13 - 4 June 2010, Ludovic Rousseau
137        - much faster warm start (up to 3.8 second gained)
138        - Add support of SCARD_ATTR_VENDOR_IFD_SERIAL_NO to get the serial
139          number of the USB device
140        - some minor bugs removed
141    
142    
143    1.3.12 - 8 May 2010, Ludovic Rousseau
144        - add support of Todos AGM2 CCID, Cherry SmartTerminal XX7X, Smart
145          SBV280, Ask CPL108, German Privacy Foundation Crypto Stick v1.2,
146          id3 CL1356T5, Covadis Auriga, GoldKey PIV Token, Vasco DIGIPASS
147          KEY 860, Vasco DIGIPASS KEY 200, Vasco DP855, Vasco DP865, Atmel
148          AT90SCR100, Atmel AT90SCR050, Atmel VaultIC420, Atmel VaultIC440,
149          Atmel VaultIC460, KOBIL Smart Token, KOBIL mIDentity 4smart, KOBIL
150          mIDentity 4smart AES, KOBIL mIDentity visual, KOBIL mIDentity
151          fullsize, KOBIL mIDentity 4smart fullsize AES, SCM SCR3500
152        - remove support of Smart SBV280 on manufacturer request. They use
153          libusb directly.
154        - remove support of SCM SDI 010 on manufacturer request since not
155          supported by my driver
156        - Enable the Broadcom 5880 reader. It should work after a firmware
157          upgrade.
158        - better support of Dell keyboard
159        - better support of multislot readers (like the GemCore SIM Pro)
160        - better support of SCM SCR3310
161        - better support of ICCD version A devices
162        - The Covadis Véga-Alpha reader is a GemPC pinpad inside. So we use
163          the same code to:
164          . load the strings for the display
165          . avoid limitation of the reader
166        - IFDHControl(): the (proprietary) get firmware version escape
167          command is allowed with a Gemalto reader
168          . the (proprietary) switch interface escape command is allowed on
169          the Gemalto GemProx DU
170          . return IFD_ERROR_NOT_SUPPORTED instead of
171          IFD_COMMUNICATION_ERROR if the dwControlCode value is not
172          supported
173          . return IFD_ERROR_INSUFFICIENT_BUFFER when appropriate
174        - IFDHGetCapabilities(): add support of SCARD_ATTR_ICC_PRESENCE and
175          SCARD_ATTR_ICC_INTERFACE_STATUS
176        - support FEATURE_GET_TLV_PROPERTIES
177        - add support of IOCTL_FEATURE_GET_TLV_PROPERTIES bMinPINSize &
178          bMaxPINSize for Gemalto Pinpad V1 & Covadis Véga-Alpha
179        - support extended APDU of up to 64kB with APDU readers.
180        - get the language selected during Mac OS X installation as language
181          to use for Covadis Véga-Alpha and Gemalto GemPC PinPad pinpad
182          readers
183        - FEATURE_MCT_READER_DIRECT is also supported by the Kobil mIDentity
184          visual
185        - better support of Sun Studio CC
186        - some minor bugs removed
187    
188    
189    1.3.11 - 28 July 2009, Ludovic Rousseau
190        - add support of Raritan D2CIM-DVUSB VM/CCID, Feitian SCR301,
191          Softforum XecureHSM, 2 Neowave Weneo tokens, Synnix STD200, Aktiv
192          Rutoken ECP, Alcor Micro SCR001, ATMEL AT91SC192192CT-USB,
193          Panasonic USB Smart Card Reader 7A-Smart, Gemalto GemProx DU and SU
194        - remove support of Reiner-SCT cyberJack pinpad(a) on request of
195          Reiner-SCT.  You should user the Reiner-SCT driver instead
196        - define CFBundleName to CCIDCLASSDRIVER so that non class drivers
197          have a higher priority. Used by pcsc-lite 1.5.5 and up.
198          Add a --disable-class configure option so that the Info.plist does
199          not define a Class driver. Default is class driver.
200        - do not power up a card with a voltage not supported by the reader
201        - add support of PIN_PROPERTIES_STRUCTURE structure and
202          FEATURE_IFD_PIN_PROPERTIES
203        - adds support of FEATURE_MCT_READERDIRECT. Only the Kobil TriB@nk
204          reader supports this feature for now. This is used for the Secoder
205          functionality in connected mode.
206        - add support of a composite device. No change needed with libhal.
207          use --enable-composite-as-multislot on Mac OS X since libhal is
208          not available on Mac OS X or with libusb on Linux
209        - some minor bugs removed
210    
211    
212    1.3.10 - 7 March 2009, Ludovic Rousseau
213        - add support for MSI StarReader SMART, Noname reader (from
214          Omnikey), Xiring Xi Sign PKI, Realtek 43 in 1 + Sim + Smart Card
215          Reader, Atmel AT98SC032CT, Aktiv Rutoken Magistra, TianYu CCID
216          SmartKey, Precise Biometrics 200 MC and 250 MC
217        - add a patch to support the bogus OpenPGP card (on board key
218          generation sometimes timed out)
219        - disable support of the contactless part of SDI010 and SCR331DI
220          (this code was reverse engineered and hard to maintain)
221        - some minor bugs removed
222    
223    
224  1.3.9 - 18 November 2008, Ludovic Rousseau  1.3.9 - 18 November 2008, Ludovic Rousseau
225      - add support for Aladdin eToken PRO USB 72K Java, Cherry      - add support for Aladdin eToken PRO USB 72K Java, Cherry
226        SmartTerminal ST-1200USB, Atmel AT91SO, SpringCard Prox'N'Roll,        SmartTerminal ST-1200USB, Atmel AT91SO, SpringCard Prox'N'Roll,
# Line 678  History: Line 618  History:
618      - First public release      - First public release
619    
620    
 References:  
 ===========  
   
 [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf  
 [2] http://www.gemalto.com/products/pc_usb_sl/  
 [3] http://www.gemalto.com/products/usb_shell_token_v2/  
 [4] http://www.gemalto.com/products/pctwin/  
 [5] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=21  
 [6] http://scmmicro.com/security/view_product_en.php?PID=3  
 [7] http://scmmicro.com/security/view_product_en.php?PID=11  
 [8] http://www.c3po.es/ltc31.html  
 [9] http://scmmicro.com/security/view_product_en.php?PID=13  
 [10] http://www.activcard.com/products/usb_reader.html  
 [11] http://www.scmmicro.com/security/SCR331-DI.html  
 [12] http://www.silitek.com/prod/getProduct.do?xml_id=4_2&menu_id=4_2_8&cid=1_8_5  
 [13] http://www.c3po.es/ltc32.html  
 [14] http://www.c3po.es/tltc2usb.html  
 [15] http://scmmicro.com/security/view_product_en.php?PID=10  
 [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers  
 [17] http://www.scmmicro.com/support/pcs_downloads.php  
 [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm  
 [19] http://www.kobil.com/e/products/smartcard/kaan-base.php  
 [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php  
 [21] http://www.kobil.com/d/products/smartcard/kaansim3.php  
 [22] http://www.kobil.com/e/products/index.php?s=midentity  
 [23] http://www.ntt.com/jpki/SCR331DI.html  
 [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/  
 [25] http://www.eutron.com/simpocket.asp  
 [26] http://www.cryptoidentity.eutron.com/eng/home.asp  
 [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm  
 [28] http://www.ntt.com/jpki/scr3310.html  
 [29] http://www.asedrive.com/product.asp?pid=1  
 [30] http://scmmicro.com/security/view_product_en.php?PID=4  
 [31] http://scmmicro.com/security/view_product_en.php?PID=5  
 [31b] http://scmmicro.com/security/view_product_en.php?PID=6  
 [32] http://www.smartepad.com.br/  
 [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37  
 [34] http://scmmicro.com/security/view_product_en.php?PID=7  
 [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm  
 [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29  
 [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33  
 [38] http://www.reflexreaders.com/Products/reflex_usbnew.html  
 [39] http://scmmicro.com/security/view_product_en.php?PID=19  
 [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm  
 [41] http://www.gemplus.com/products/gempc_card/  
 [42] http://www.asedrive.com/product.asp?pid=2  
 [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31  
 [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML  
 [45] http://www.id3semiconductors.com/produits/cl1356D.htm  
 [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21  
 [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1  
 [48] http://www.id3semiconductors.com/produits/cl1356T.htm  
 [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48  
 [50] http://www.rsa.com/products/securid/datasheets/SID800_DS_0507.pdf  
 [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39  
 [52] http://www.teobyxiring.com/  
 [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html  
 [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html  
 [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50  
 [56] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=41  
 [57] http://www.gi-de.com/portal/page?_pageid=42,126834&_dad=portal&_schema=PORTAL  
 [58] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=26&IDFamiglia=3  
 [59] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=62&IDFamiglia=39  
 [60] http://www.lexar.com/enterprise/ent_ppsd.html  
 [61] http://www.cherry.de/deutsch/produkte/chipkartentastaturen_g-6610.htm  
 [62] http://acs.com.hk/acr122.php  
 [63] http://covadis.ch/Alya.239.0.html  
 [64] http://covadis.ch/Vega.104.0.html  
 [65] http://www.validy.com/en/products/token/  
 [66] http://www.actividentity.com/products/activkey_usb_tokens__home.php  
 [67] http://www.gemalto.com/products/pc_pinpad/  
 [68] http://www.kobil.com/index.php?id=71&type=7&L  
 [69] http://www.kobil.com/index.php?id=555&type=7&L=0  
 [70] http://www.kobil.com/index.php?id=128&type=7&L=1%22  
 [71] http://www.lexar.com/enterprise/ent_ppsd.html  
 [72] http://www.springcard.com/products/csb6.html  
 [73] http://www.aladdin.com/etoken/devices/pro-usb.aspx  
 [74] http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3981  
 [75] http://global.msi.com.tw/index.php?func=proddesc&maincat_no=132&prod_no=1411  
 [76] http://www.xiring.com/pageLibre00012c0e.php  
   
621  $Id$  $Id$
622    
623   vim:ts=20   vim:ts=20
Legend:
Removed from v.3232  
changed lines
  Added in v.4979
  ViewVC Help
Powered by ViewVC 1.1.5