/[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 1523 by rousseau, Fri May 20 10:35:11 2005 UTC revision 2131 by rousseau, Thu Aug 10 22:31:08 2006 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    - Athena ASE IIIe USB V2 [29]
30    - Athena ASE IIIe KB USB [42]
31    - C3PO LTC31 (new model, USB product id 0x0006) [8]
32  - Cherry XX33 keyboard [?]  - Cherry XX33 keyboard [?]
33    - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
34    - Cherry SmartTerminal ST2000U [35]
35    - Cherry ST-1044U [27]
36  - Dell keyboard SK-3106 [?]  - Dell keyboard SK-3106 [?]
37  - Dell smart card reader keyboard [?]  - Dell smart card reader keyboard [?]
38    - Eutron SIM Pocket Combo [25]
39    - Eutron CryptoIdentity [26]
40  - Gemplus GemPC 433 SL [2]  - Gemplus GemPC 433 SL [2]
41    - Gemplus GemPC Card [41]
42  - Gemplus GemPC Key [3]  - Gemplus GemPC Key [3]
43    - Gemplus GemPC PinPad
44  - Gemplus GemPC Twin [4]  - Gemplus GemPC Twin [4]
45    - Gemplus GemCore POS Pro
46    - Gemplus GemCore SIM Pro
47  - Kobil KAAN Base [19]  - Kobil KAAN Base [19]
48  - Kobil KAAN Advanced [20]  - Kobil KAAN Advanced [20]
49  - Kobil KAAN SIM III [21]  - Kobil KAAN SIM III [21]
# Line 42  Supported CCID readers: Line 56  Supported CCID readers:
56  - SCM Micro SCR 335 [7]  - SCM Micro SCR 335 [7]
57    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
58    recent model with firmware 5.14 or later    recent model with firmware 5.14 or later
59  - SCM Micro SCR 3310  - SCM Micro SCR 355
60    - SCM Micro SCR 3310 [30]
61    - SCM Micro SCR 3311 [31]
62  - SCM Micro SPR 532 [9]  - SCM Micro SPR 532 [9]
63    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
64    firmware upgrade.    firmware upgrade.
65    - SmartEpad (v 2.0) [32]
66      The firmware gives a very strange description of the reader (like a
67      dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
68  - Verisign Secure Storage Token [24]  - Verisign Secure Storage Token [24]
69  - Verisign Secure Token [?]  - Verisign Secure Token [?]
70    
# Line 57  I would like to get these readers to per Line 76  I would like to get these readers to per
76  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
77  manufacturers, please, contact me.  manufacturers, please, contact me.
78    
79  - Cherry XX44 keyboard (SmartBoard G83-6744) [18]  - Axalto Reflex USB v3 [38]
 - ActivCard USB reader 2.0 [10]  
80  - C3PO LTC32 [13]  - C3PO LTC32 [13]
81    - Gemplus GemPC Express
82    - HP USB Smart Card Keyboard [44]
83    - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
84      reader anymore)
85    - OmniKey CardMan 3021
86    - OmniKey CardMan 3621 [43]
87    - OmniKey CardMan 3821 [37]
88    - OmniKey CardMan 5125 [33]
89    - OmniKey CardMan 6121 [36]
90  - SCM Micro SCR 331-DI NTTCom [23]  - SCM Micro SCR 331-DI NTTCom [23]
91    - SCM Micro SCR 3310-NTTCOM [28]
92    - SCM Micro SCR 3320 [32]
93  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
94    - SCM Micro SDI 010 [39]
95    - SCM SCR 3340 ExpressCard54 [34]
96  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
97    - Winbond Electronics (for OEM only) [40]
98    
99    
100  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
101  =============================================  =============================================
102    
103  - C3PO LTC31 [8]  - ActivCard USB reader 2.0 [10]
104        The reader do timeout when a special USB frame is sent from the
105        reader. If the frame size if a multiple of wMaxPacketSize the
106        communication is stopped.
107    - C3PO LTC31 (old model, USB product id 0x0003) [8]
108      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
109      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
110    - iDream (THRC2002-2) [47]
111        PPS fails with a Cryptoflex card
112        powerup fails with a Setcos card
113        does work with the belgium eID (the reader is sold for this
114        application)
115  - RSA SecureID SID800 [24]  - RSA SecureID SID800 [24]
116      The USB layer is completely broken. The reader is sometimes not even      The USB layer is completely broken. The reader is sometimes not even
117      seen on the USB bus (same problem under Windows). Maybe newer      seen on the USB bus (same problem under Windows). Maybe newer
# Line 89  Debug informations: Line 130  Debug informations:
130  ===================  ===================
131    
132  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
133  its debug to stdout (pcscd --foreground) then the CCID will also send  its debug to stderr (pcscd --foreground) then the CCID will also send
134  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)
135  then the CCID will also send its debug to syslog.  then the CCID will also send its debug to syslog.
136    
137  You can change the debug level using the Info.plist configuraion file.  You can change the debug level using the Info.plist configuration file.
138  The Info.plist is installed, by default, in  The Info.plist is installed, by default, in
139  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
140    
# Line 101  The debug level is set in the ifdLogLeve Line 142  The debug level is set in the ifdLogLeve
142  combinaison of 4 different levels.  combinaison of 4 different levels.
143  - 1: critical: important error messages  - 1: critical: important error messages
144  - 2: info:     informative messages like what reader was detected  - 2: info:     informative messages like what reader was detected
145  - 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  
146                 reader                 reader
147    - 8: periodic: periodic info when pcscd test if a card is present (every
148                   1/10 of a second)
149    
150  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
151  critical and info levels.  critical and info levels.
# Line 148  Inc., 59 Temple Place, Suite 330, Boston Line 189  Inc., 59 Temple Place, Suite 330, Boston
189  History:  History:
190  ========  ========
191    
192    1.0.1 - 22 April 2006, Ludovic Rousseau
193        - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
194          Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
195          KB USB, OmniKey CardMan 3621
196        - support Solaris (Solaris uses a different libusb)
197        - better documentation for ./configure arguments
198        - improve support of Cherry XX44 keyboard for PIN verify and change
199          (circumvent firmware bugs)
200        - do not use LTPBundleFindValueWithKey() from pcscd since this
201          function has been removed from pcscd API
202        - use -fvisibility=hidden is available to limit the number of
203          exported symbols
204    
205    
206    1.0.0 - 3 March 2006, Ludovic Rousseau
207        - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
208          SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
209          Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
210          Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
211          CardMan 5125
212        - greatly improve support of PIN PAD readers. We now support TPDU
213          readers with T=1 cards
214        - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
215          Supported languages are: de, en, es, fr, it
216        - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
217          reader and is not CCID compatible
218        - allow to select the Power On voltage using Info.plist instead of
219          recompiling the source code
220        - correct bugs in the support of multi-slots readers
221        - if the card is faster than the reader (TA1=97 for example) we try
222          to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
223          instead of the default speed of TA1=11
224        - the src/parse tool do not use the driver anymore. No need to
225          update the Info.plist file first.
226        - some minor bugs removed
227    
228    
229    0.9.4 - 27 November 2005, Ludovic Rousseau
230        - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
231          Verisign Secure Token and VeriSign Secure Storage Token, GemPC
232          Card (PCMCIA), SCM SCR331-DI NTTCom, SCM Micro SCR 3310-NTTCom,
233          Cherry ST-1044U, Cherry SmartTerminal ST-2XXX
234        - add support of PC/SC v2 part 10 CM_IOCTL_GET_FEATURE_REQUEST add
235          support of FEATURE_VERIFY_PIN_DIRECT and FEATURE_MODIFY_PIN_DIRECT
236          remove support of IOCTL_SMARTCARD_VENDOR_VERIFY_PIN (now
237          obsoleted). A sample code is available in examples/scardcontrol.c
238        - we need pcsc-lite 1.2.9-beta9 since some structures used for PIN
239          pad readers are defined by pcsc-lite
240        - some (bogus) cards require an extra EGT but the ATR does not say
241          so. We try to detect the bogus cards and set TC1=2
242        - IFDHSetProtocolParameters(): only use a data rate supported by the
243          reader in the PPS negociation, otherwise we stay at the default
244          speed.
245        - calculate and store the read timeout according to the card ATR
246          instead of using a fixed value of 60 seconds
247        - increase the read timeout if the card sends and WTX request
248        - improve support of GemPC Twin and GemPC Card (serial protocol)
249        - reset the device on close only if DRIVER_OPTION_RESET_ON_CLOSE is
250          set. The problem was that a device reset also disconnects the
251          keyboard on a keyboard + reader device.
252        - use color logs
253        - some minor bugs removed
254    
255    
256  0.9.3 - 14 March 2005, Ludovic Rousseau  0.9.3 - 14 March 2005, Ludovic Rousseau
257      - change the licence from GNU GPL to GNU Lesser GPL (LGPL)      - change the licence from GNU GPL to GNU Lesser GPL (LGPL)
258      - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,      - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,
# Line 171  History: Line 276  History:
276      - T=1 TPDU code:      - T=1 TPDU code:
277        . the work on T=1 TPDU code was possible thanks to Gemplus        . the work on T=1 TPDU code was possible thanks to Gemplus
278          validation team who helped me test, debug and bring the code to          validation team who helped me test, debug and bring the code to
279          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
280          the Gemplus readers department          the Gemplus readers department
281        . error code was not checked correctly        . error code was not checked correctly
282        . avoid a (nearly) infinite loop when resynch are needed.        . avoid a (nearly) infinite loop when resynch are needed.
# Line 281  History: Line 386  History:
386      - move LTC31 reader from unsupported to supported reader list. It      - move LTC31 reader from unsupported to supported reader list. It
387        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
388        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.
389        Thanks to Josep Moné s Teixidor for pointing the problem.        Thanks to Josep Moné s Teixidor for pointing the problem.
390      - src/commands.c: comment out the automatic GET RESPONSE part. I      - src/commands.c: comment out the automatic GET RESPONSE part. I
391        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?
392    
# Line 292  History: Line 397  History:
397      - add --enable-libusb=PATH option is your libusb is not installed in      - add --enable-libusb=PATH option is your libusb is not installed in
398        /usr or /usr/local        /usr or /usr/local
399      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
400        Ville Skyttä for the patch.        Ville Skyttä for the patch.
401      - 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
402        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
403        EMV cards        EMV cards
# Line 322  History: Line 427  History:
427      - First public release      - First public release
428    
429    
430  Bibliography:  References:
431  =============  ===========
432    
433  [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
434  [2] http://www.gemplus.com/products/gempc433/  [2] http://www.gemplus.com/products/gempc433/
435  [3] http://www.gemplus.com/products/gempckey/  [3] http://www.gemplus.com/products/gempckey/
436  [4] http://www.gemplus.com/products/gempctwin/  [4] http://www.gemplus.com/products/gempctwin/
437  [5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47  [5] http://www.omnikey.com/index.php?id=40
438  [6] http://www.scmmicro.com/security/SCR331.html  [6] http://www.scmmicro.com/security/SCR331.html
439  [7] http://www.scmmicro.com/security/SCR335.html  [7] http://www.scmmicro.com/security/SCR335.html
440  [8] http://www.c3po.es/ltc31.html  [8] http://www.c3po.es/ltc31.html
# Line 340  Bibliography: Line 445  Bibliography:
445  [13] http://www.c3po.es/ltc32.html  [13] http://www.c3po.es/ltc32.html
446  [14] http://www.c3po.es/tltc2usb.html  [14] http://www.c3po.es/tltc2usb.html
447  [15] http://www.scmmicro.com/security/SCR333.html  [15] http://www.scmmicro.com/security/SCR333.html
448  [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
449  [17] http://www.scmmicro.com/support/pcs_product_drivers.html  [17] http://www.scmmicro.com/support/pcs_product_drivers.html
450  [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
451  [19] http://www.kobil.com/e/products/smartcard/kaan-base.php  [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
# Line 349  Bibliography: Line 454  Bibliography:
454  [22] http://www.kobil.com/e/products/index.php?s=midentity  [22] http://www.kobil.com/e/products/index.php?s=midentity
455  [23] http://www.ntt.com/jpki/SCR331DI.html  [23] http://www.ntt.com/jpki/SCR331DI.html
456  [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/  [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/
457    [25] http://www.eutron.com/simpocket.asp
458    [26] http://www.cryptoidentity.eutron.com/eng/home.asp
459    [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm
460    [28] http://www.ntt.com/jpki/scr3310.html
461    [29] http://www.asedrive.com/product.asp?pid=1
462    [30] http://www.scmmicro.com/security/SCR3310.html
463    [31] http://scmmicro.com/security/SCR3311.html
464    [31] http://scmmicro.com/security/SCR3320.html
465    [32] http://www.smartepad.com.br/
466    [33] http://www.omnikey.com/index.php?id=121
467    [34] http://www.scmmicro.com/security/SCR3340.html
468    [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
469    [36] http://www.omnikey.com/index.php?id=21
470    [37] http://www.omnikey.com/index.php?id=114
471    [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
472    [39] http://www.scmmicro.com/security/SDI_010.html
473    [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
474    [41] http://www.gemplus.com/products/gempc_card/
475    [42] http://www.asedrive.com/product.asp?pid=2
476    [43] http://www.omnikey.com/index.php?id=50
477    [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
478    [45] http://www.id3semiconductors.com/produits/cl1356D.htm
479    [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
480    [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
481    
482  $Id$  $Id$
483    

Legend:
Removed from v.1523  
changed lines
  Added in v.2131

  ViewVC Help
Powered by ViewVC 1.1.5