/[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 1761 by rousseau, Sun Nov 27 19:44:29 2005 UTC revision 2610 by rousseau, Fri Aug 3 20:12:08 2007 UTC
# Line 20  Supported CCID readers: Line 20  Supported CCID readers:
20  =======================  =======================
21    
22  (in alphabetical order)  (in alphabetical order)
23  - Advanced Card Systems ACR 38 [16]  - ActivCard USB reader 3.0
24    - Advanced Card Systems ACR 38U-CCID [16]
25    old versions of this reader have a bug: the reader do timeout when a    old versions of this reader have a bug: the reader do timeout when a
26    special USB frame is sent from the reader. If the frame size if a    special USB frame is sent from the reader. If the frame size if a
27    multiple of wMaxPacketSize the communication is stopped.    multiple of wMaxPacketSize the communication is stopped.
28    - Alcor Micro AU9520 [46]
29      Firmware 1.01 is bogus. The time request sent by the card is not
30      forwarded by the reader to the host.
31    - Athena ASE IIIe USB V2 [29]
32    - Athena ASE IIIe KB USB [42]
33    - C3PO LTC31 (new model, USB product id 0x0006) [8]
34  - Cherry XX33 keyboard [?]  - Cherry XX33 keyboard [?]
35  - Cherry XX44 keyboard (SmartBoard G83-6744) [18]  - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
36  - Cherry SmartTerminal ST2XXX  - Cherry SmartTerminal ST2000U [35]
37  - Cherry ST-1044U [27]  - Cherry ST-1044U [27]
38  - Dell keyboard SK-3106 [?]  - Dell keyboard SK-3106 [?]
39  - Dell smart card reader keyboard [?]  - Dell smart card reader keyboard [?]
40  - Eutron SIM Pocket Combo [25]  - Eutron SIM Pocket Combo [25]
41  - Eutron CryptoIdentity [26]  - Eutron CryptoIdentity [26]
42  - Gemplus GemPC 433 SL [2]  - Gemplus GemPC 433 SL [2]
43    - Gemplus GemPC Card [41]
44  - Gemplus GemPC Key [3]  - Gemplus GemPC Key [3]
45    - Gemplus GemPC PinPad
46  - Gemplus GemPC Twin [4]  - Gemplus GemPC Twin [4]
47    - Gemplus GemCore POS Pro
48    - Gemplus GemCore SIM Pro
49  - Kobil KAAN Base [19]  - Kobil KAAN Base [19]
50  - Kobil KAAN Advanced [20]  - Kobil KAAN Advanced [20]
51  - Kobil KAAN SIM III [21]  - Kobil KAAN SIM III [21]
 - Kobil mIDentity [22]  
52  - OmniKey CardMan 3121 [5]  - OmniKey CardMan 3121 [5]
53    - RSA SecureID SID800 [50]
54  - SCM Micro SCR 331 [6]  - SCM Micro SCR 331 [6]
55    You shall upgrade the firmware [17] using version 5.18 or later.    You shall upgrade the firmware [17] using version 5.18 or later.
56  - SCM Micro SCR 331-DI [11]  - SCM Micro SCR 331-DI [11]
# Line 47  Supported CCID readers: Line 58  Supported CCID readers:
58  - SCM Micro SCR 335 [7]  - SCM Micro SCR 335 [7]
59    The firmware of this reader can't be upgraded so be sure to buy a    The firmware of this reader can't be upgraded so be sure to buy a
60    recent model with firmware 5.14 or later    recent model with firmware 5.14 or later
61  - SCM Micro SCR 3310  - SCM Micro SCR 355
62    - SCM Micro SCR 3310 [30]
63    - SCM Micro SCR 3311 [31]
64  - SCM Micro SPR 532 [9]  - SCM Micro SPR 532 [9]
65    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
66    firmware upgrade.    firmware upgrade.
67    - SmartEpad (v 2.0) [32]
68      The firmware gives a very strange description of the reader (like a
69      dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
70  - Verisign Secure Storage Token [24]  - Verisign Secure Storage Token [24]
71  - Verisign Secure Token [?]  - Verisign Secure Token [?]
72    - Xiring Teo [52]
73    
74    
75  Should work but untested by me:  Should work but untested by me:
# Line 62  I would like to get these readers to per Line 79  I would like to get these readers to per
79  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
80  manufacturers, please, contact me.  manufacturers, please, contact me.
81    
82  - ActivCard USB reader 2.0 [10]  - Axalto Reflex USB v3 [38]
83  - C3PO LTC32 [13]  - C3PO LTC32 [13]
84    - C3PO TLTC2USB
85    - C3PO KBR36
86    - Gemplus GemPC Express
87    - Fujitsu Siemens Computers SmartCard USB 2A [53]
88    - Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54]
89    - Giesecke & Devrient StarSign Card Token 350 (ICCD) [57]
90    - Giesecke & Devrient StarSign Card Token 550 (ICCD)
91    - HP USB Smart Card Keyboard [44]
92    - HP USB Smartcard Reader
93    - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
94      reader anymore)
95    - id3 Semiconductors CL1356T [48] (it should be the same firmware as the
96      CL1356D)
97    - OmniKey CardMan 1021
98    - OmniKey CardMan 3021 [49]
99    - OmniKey CardMan 3621 [43]
100    - OmniKey CardMan 3821 [37]
101    - OmniKey CardMan 4321 [55]
102    - OmniKey CardMan 5121 [33]
103    - OmniKey CardMan 5125 [51]
104    - OmniKey CardMan 5321 [56]
105    - OmniKey CardMan 6121 [36]
106    - O2Micro Oz776 (0x7762 and 0x7772 versions)
107    - Philips JCOP41V221
108  - SCM Micro SCR 331-DI NTTCom [23]  - SCM Micro SCR 331-DI NTTCom [23]
109  - SCM Micro SCR 3310-NTTCOM [28]  - SCM Micro SCR 3310-NTTCOM [28]
110    - SCM Micro SCR 3320 [32]
111  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
112    - SCM Micro SDI 010 [39]
113    - SCM SCR 3340 ExpressCard54 [34]
114    - SchlumbergerSema Cyberflex Access e-gate ICCD
115  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
116    - Sitecom USB simcard reader MD-010
117    - Winbond Electronics (for OEM only) [40]
118    
119    
120  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
121  =============================================  =============================================
122    
123  - C3PO LTC31 [8]  - ActivCard USB reader 2.0 [10]
124        The reader do timeout when a special USB frame is sent from the
125        reader. If the frame size if a multiple of wMaxPacketSize the
126        communication is stopped.
127    - C3PO LTC31 (old model, USB product id 0x0003) [8]
128      The reader works fine with Linux kernel 2.4 but does not with Linux      The reader works fine with Linux kernel 2.4 but does not with Linux
129      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
130  - RSA SecureID SID800 [24]  - iDream (THRC2002-2) [47]
131      The USB layer is completely broken. The reader is sometimes not even      PPS fails with a Cryptoflex card
132      seen on the USB bus (same problem under Windows). Maybe newer      powerup fails with a Setcos card
133      devices will work?      does work with the belgium eID (the reader is sold for this
134        application)
135    - Kobil mIDentity [22]
136        Time requests are not managed correctly and make the firmware fails.
137        This is not a problem unless you use a time-consuming APDU like RSA
138        key generation.
139        A new firmware will correct the bug.
140    
141    
142  Supported operating systems:  Supported operating systems:
# Line 94  Debug informations: Line 151  Debug informations:
151  ===================  ===================
152    
153  The driver uses the debug function provided by pcscd. So if pcscd sends  The driver uses the debug function provided by pcscd. So if pcscd sends
154  its debug to stdout (pcscd --foreground) then the CCID will also send  its debug to stderr (pcscd --foreground) then the CCID will also send
155  its debug to stdout. If pcscd sends its debug to syslog (by default)  its debug to stderr. If pcscd sends its debug to syslog (by default)
156  then the CCID will also send its debug to syslog.  then the CCID will also send its debug to syslog.
157    
158  You can change the debug level using the Info.plist configuraion file.  You can change the debug level using the Info.plist configuration file.
159  The Info.plist is installed, by default, in  The Info.plist is installed, by default, in
160  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
161    
# Line 106  The debug level is set in the ifdLogLeve Line 163  The debug level is set in the ifdLogLeve
163  combinaison of 4 different levels.  combinaison of 4 different levels.
164  - 1: critical: important error messages  - 1: critical: important error messages
165  - 2: info:     informative messages like what reader was detected  - 2: info:     informative messages like what reader was detected
166  - 4: periodic: periodic info when pcscd test if a card is present (every  - 4: comm:     a dump of all the bytes exchanged between the host and the
                1/10 of a second)  
 - 8: comm:     a dump of all the bytes exchanged between the host and the  
167                 reader                 reader
168    - 8: periodic: periodic info when pcscd test if a card is present (every
169                   1/10 of a second)
170    
171  By default the debug level is set to 3 (1 + 2) and correspond to the  By default the debug level is set to 3 (1 + 2) and correspond to the
172  critical and info levels.  critical and info levels.
# Line 153  Inc., 59 Temple Place, Suite 330, Boston Line 210  Inc., 59 Temple Place, Suite 330, Boston
210  History:  History:
211  ========  ========
212    
213    1.3.0 - 10 May 2007, Ludovic Rousseau
214        - add support of ICCD version A and B
215        - add support for (new) KOBIL mIDentity, SchlumbergerSema Cyberflex
216          Access e-gate ICCD, Fujitsu Siemens Computers SmartCard USB 2A and
217          SmartCard Keyboard USB 2A readers, OmniKey CardMan 4321
218        - contrib/RSA_SecurID/RSA_SecurID_getpasswd: tool to get the on time
219          password also displayed on the token screen
220        - contrib/Kobil_mIDentity_switch: tool to activate the CCID reader
221          of the Kobil mIDentity. The tool should be started automatically
222          by the udev rule on Linux
223        - GemPC pinpad: localisation of the string "PIN blocked", add
224          Portuguese(pt), Dutch(nl) and Turkish(tr) localisations
225        - some minor bugs removed
226    
227    1.2.1 - 27 January 2007, Ludovic Rousseau
228        - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
229          readers
230        - INSTALL: document how to use --enable-udev on FreeBSD
231        - move the O2Micro Oz7762 from the unsupported to the supported list
232          since patches to support it are applied by default
233          (O2MICRO_OZ776_PATCH)
234    
235    
236    1.2.0 - 19 January 2007, Ludovic Rousseau
237        - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
238          SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
239          SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
240        - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
241          Teo by Xiring, HP USB Smartcard Reader
242        - use --enable-twinserial to build the serial reader driver
243        - use --enable-udev to configure for a use with Linux udev hotplug
244          mechanism. This will allow pcscd to avoid polling the USB bus
245          every 1 second
246        - some minor bugs removed
247    
248    
249    1.1.0 - 11 August 2006, Ludovic Rousseau
250        - support Extended APDU (up to 64KB) for readers in TPDU mode (many
251          readers) or Extended APDU mode (very rare). This only works for
252          T=1 cards.
253        - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
254          USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
255          id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
256        - support the contactless interface of the SCR331-DI-NTTCOM
257        - add support of FreeBSD
258        - increase the USB timeout used for PIN verify/modify to not timeout
259          before the reader
260        - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
261          be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
262          page 2. The applications using this feature shall be updated (to
263          respect the PCSC specification).
264        - use ./configure --enable-twinserial to compile and install the the
265          driver for the GemPC Twin serial
266        - some minor bugs removed
267    
268    
269    1.0.1 - 22 April 2006, Ludovic Rousseau
270        - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
271          Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
272          KB USB, OmniKey CardMan 3621
273        - support Solaris (Solaris uses a different libusb)
274        - better documentation for ./configure arguments
275        - improve support of Cherry XX44 keyboard for PIN verify and change
276          (circumvent firmware bugs)
277        - do not use LTPBundleFindValueWithKey() from pcscd since this
278          function has been removed from pcscd API
279        - use -fvisibility=hidden is available to limit the number of
280          exported symbols
281    
282    
283    1.0.0 - 3 March 2006, Ludovic Rousseau
284        - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
285          SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
286          Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
287          Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
288          CardMan 5121
289        - greatly improve support of PIN PAD readers. We now support TPDU
290          readers with T=1 cards
291        - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
292          Supported languages are: de, en, es, fr, it
293        - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
294          reader and is not CCID compatible
295        - allow to select the Power On voltage using Info.plist instead of
296          recompiling the source code
297        - correct bugs in the support of multi-slots readers
298        - if the card is faster than the reader (TA1=97 for example) we try
299          to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
300          instead of the default speed of TA1=11
301        - the src/parse tool do not use the driver anymore. No need to
302          update the Info.plist file first.
303        - some minor bugs removed
304    
305    
306  0.9.4 - 27 November 2005, Ludovic Rousseau  0.9.4 - 27 November 2005, Ludovic Rousseau
307      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
308        Verisign Secure Token and VeriSign Secure Storage Token, GemPC        Verisign Secure Token and VeriSign Secure Storage Token, GemPC
# Line 203  History: Line 353  History:
353      - T=1 TPDU code:      - T=1 TPDU code:
354        . the work on T=1 TPDU code was possible thanks to Gemplus        . the work on T=1 TPDU code was possible thanks to Gemplus
355          validation team who helped me test, debug and bring the code to          validation team who helped me test, debug and bring the code to
356          an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and          an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and
357          the Gemplus readers department          the Gemplus readers department
358        . error code was not checked correctly        . error code was not checked correctly
359        . avoid a (nearly) infinite loop when resynch are needed.        . avoid a (nearly) infinite loop when resynch are needed.
# Line 313  History: Line 463  History:
463      - move LTC31 reader from unsupported to supported reader list. It      - move LTC31 reader from unsupported to supported reader list. It
464        was my f ault since in used odd INS byte in my test applet and odd        was my f ault since in used odd INS byte in my test applet and odd
465        INS bytes are forbidden by ISO 7816-4 ch. 5.4.2 Instruction byte.        INS bytes are forbidden by ISO 7816-4 ch. 5.4.2 Instruction byte.
466        Thanks to Josep Moné s Teixidor for pointing the problem.        Thanks to Josep Moné s Teixidor for pointing the problem.
467      - src/commands.c: comment out the automatic GET RESPONSE part. I      - src/commands.c: comment out the automatic GET RESPONSE part. I
468        don't think it should be in the driver. Maybe in pcscd instead?        don't think it should be in the driver. Maybe in pcscd instead?
469    
# Line 324  History: Line 474  History:
474      - add --enable-libusb=PATH option is your libusb is not installed in      - add --enable-libusb=PATH option is your libusb is not installed in
475        /usr or /usr/local        /usr or /usr/local
476      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
477        Ville Skyttä for the patch.        Ville Skyttä for the patch.
478      - src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU      - src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU
479        mode since it also swicth in EMV mode and may not work with non        mode since it also swicth in EMV mode and may not work with non
480        EMV cards        EMV cards
# Line 354  History: Line 504  History:
504      - First public release      - First public release
505    
506    
507  Bibliography:  References:
508  =============  ===========
509    
510  [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf  [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
511  [2] http://www.gemplus.com/products/gempc433/  [2] http://www.gemplus.com/products/gempc433/
512  [3] http://www.gemplus.com/products/gempckey/  [3] http://www.gemplus.com/products/gempckey/
513  [4] http://www.gemplus.com/products/gempctwin/  [4] http://www.gemplus.com/products/gempctwin/
514  [5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47  [5] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=21
515  [6] http://www.scmmicro.com/security/SCR331.html  [6] http://www.scmmicro.com/security/SCR331.html
516  [7] http://www.scmmicro.com/security/SCR335.html  [7] http://www.scmmicro.com/security/SCR335.html
517  [8] http://www.c3po.es/ltc31.html  [8] http://www.c3po.es/ltc31.html
# Line 372  Bibliography: Line 522  Bibliography:
522  [13] http://www.c3po.es/ltc32.html  [13] http://www.c3po.es/ltc32.html
523  [14] http://www.c3po.es/tltc2usb.html  [14] http://www.c3po.es/tltc2usb.html
524  [15] http://www.scmmicro.com/security/SCR333.html  [15] http://www.scmmicro.com/security/SCR333.html
525  [16] http://www.acs.com.hk/Product_Readers.asp?productID=59&PCate=Products_PC_Linked_SmartCard_Readers  [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers
526  [17] http://www.scmmicro.com/support/pcs_product_drivers.html  [17] http://www.scmmicro.com/support/pcs_product_drivers.html
527  [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm  [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm
528  [19] http://www.kobil.com/e/products/smartcard/kaan-base.php  [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
# Line 385  Bibliography: Line 535  Bibliography:
535  [26] http://www.cryptoidentity.eutron.com/eng/home.asp  [26] http://www.cryptoidentity.eutron.com/eng/home.asp
536  [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm  [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm
537  [28] http://www.ntt.com/jpki/scr3310.html  [28] http://www.ntt.com/jpki/scr3310.html
538    [29] http://www.asedrive.com/product.asp?pid=1
539    [30] http://www.scmmicro.com/security/SCR3310.html
540    [31] http://scmmicro.com/security/SCR3311.html
541    [31] http://scmmicro.com/security/SCR3320.html
542    [32] http://www.smartepad.com.br/
543    [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37
544    [34] http://www.scmmicro.com/security/SCR3340.html
545    [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
546    [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29
547    [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33
548    [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
549    [39] http://www.scmmicro.com/security/SDI_010.html
550    [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
551    [41] http://www.gemplus.com/products/gempc_card/
552    [42] http://www.asedrive.com/product.asp?pid=2
553    [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31
554    [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
555    [45] http://www.id3semiconductors.com/produits/cl1356D.htm
556    [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
557    [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
558    [48] http://www.id3semiconductors.com/produits/cl1356T.htm
559    [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48
560    [50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf
561    [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39
562    [52] http://www.teobyxiring.com/
563    [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html
564    [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html
565    [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50
566    [56] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=41
567    [57] http://www.gi-de.com/portal/page?_pageid=42,126834&_dad=portal&_schema=PORTAL
568    
569  $Id$  $Id$
570    

Legend:
Removed from v.1761  
changed lines
  Added in v.2610

  ViewVC Help
Powered by ViewVC 1.1.5