/[pcsclite]/tags/ccid/ccid-1.4.5/README
ViewVC logotype

Diff of /tags/ccid/ccid-1.4.5/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 2516 by rousseau, Thu May 10 08:03:44 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    - HP USB Smart Card Keyboard [44]
90    - HP USB Smartcard Reader
91    - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
92      reader anymore)
93    - id3 Semiconductors CL1356T [48] (it should be the same firmware as the
94      CL1356D)
95    - OmniKey CardMan 1021
96    - OmniKey CardMan 3021 [49]
97    - OmniKey CardMan 3621 [43]
98    - OmniKey CardMan 3821 [37]
99    - OmniKey CardMan 4321 [55]
100    - OmniKey CardMan 5121 [33]
101    - OmniKey CardMan 5125 [51]
102    - OmniKey CardMan 6121 [36]
103    - O2Micro Oz7762
104  - SCM Micro SCR 331-DI NTTCom [23]  - SCM Micro SCR 331-DI NTTCom [23]
105  - SCM Micro SCR 3310-NTTCOM [28]  - SCM Micro SCR 3310-NTTCOM [28]
106    - SCM Micro SCR 3320 [32]
107  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
108    - SCM Micro SDI 010 [39]
109    - SCM SCR 3340 ExpressCard54 [34]
110  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
111    - Sitecom USB simcard reader MD-010
112    - Winbond Electronics (for OEM only) [40]
113    
114    
115  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
116  =============================================  =============================================
117    
118  - C3PO LTC31 [8]  - ActivCard USB reader 2.0 [10]
119        The reader do timeout when a special USB frame is sent from the
120        reader. If the frame size if a multiple of wMaxPacketSize the
121        communication is stopped.
122    - C3PO LTC31 (old model, USB product id 0x0003) [8]
123      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
124      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
125  - RSA SecureID SID800 [24]  - iDream (THRC2002-2) [47]
126      The USB layer is completely broken. The reader is sometimes not even      PPS fails with a Cryptoflex card
127      seen on the USB bus (same problem under Windows). Maybe newer      powerup fails with a Setcos card
128      devices will work?      does work with the belgium eID (the reader is sold for this
129        application)
130    - Kobil mIDentity [22]
131        Time requests are not managed correctly and make the firmware fails.
132        This is not a problem unless you use a time-consuming APDU like RSA
133        key generation.
134        A new firmware will correct the bug.
135    
136    
137  Supported operating systems:  Supported operating systems:
# Line 94  Debug informations: Line 146  Debug informations:
146  ===================  ===================
147    
148  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
149  its debug to stdout (pcscd --foreground) then the CCID will also send  its debug to stderr (pcscd --foreground) then the CCID will also send
150  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)
151  then the CCID will also send its debug to syslog.  then the CCID will also send its debug to syslog.
152    
153  You can change the debug level using the Info.plist configuraion file.  You can change the debug level using the Info.plist configuration file.
154  The Info.plist is installed, by default, in  The Info.plist is installed, by default, in
155  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
156    
# Line 106  The debug level is set in the ifdLogLeve Line 158  The debug level is set in the ifdLogLeve
158  combinaison of 4 different levels.  combinaison of 4 different levels.
159  - 1: critical: important error messages  - 1: critical: important error messages
160  - 2: info:     informative messages like what reader was detected  - 2: info:     informative messages like what reader was detected
161  - 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  
162                 reader                 reader
163    - 8: periodic: periodic info when pcscd test if a card is present (every
164                   1/10 of a second)
165    
166  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
167  critical and info levels.  critical and info levels.
# Line 153  Inc., 59 Temple Place, Suite 330, Boston Line 205  Inc., 59 Temple Place, Suite 330, Boston
205  History:  History:
206  ========  ========
207    
208    1.2.1 - 27 January 2007, Ludovic Rousseau
209        - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
210          readers
211        - INSTALL: document how to use --enable-udev on FreeBSD
212        - move the O2Micro Oz7762 from the unsupported to the supported list
213          since patches to support it are applied by default
214          (O2MICRO_OZ776_PATCH)
215    
216    
217    1.2.0 - 19 January 2007, Ludovic Rousseau
218        - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
219          SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
220          SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
221        - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
222          Teo by Xiring, HP USB Smartcard Reader
223        - use --enable-twinserial to build the serial reader driver
224        - use --enable-udev to configure for a use with Linux udev hotplug
225          mechanism. This will allow pcscd to avoid polling the USB bus
226          every 1 second
227        - some minor bugs removed
228    
229    
230    1.1.0 - 11 August 2006, Ludovic Rousseau
231        - support Extended APDU (up to 64KB) for readers in TPDU mode (many
232          readers) or Extended APDU mode (very rare). This only works for
233          T=1 cards.
234        - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
235          USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
236          id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
237        - support the contactless interface of the SCR331-DI-NTTCOM
238        - add support of FreeBSD
239        - increase the USB timeout used for PIN verify/modify to not timeout
240          before the reader
241        - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
242          be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
243          page 2. The applications using this feature shall be updated (to
244          respect the PCSC specification).
245        - use ./configure --enable-twinserial to compile and install the the
246          driver for the GemPC Twin serial
247        - some minor bugs removed
248    
249    
250    1.0.1 - 22 April 2006, Ludovic Rousseau
251        - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
252          Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
253          KB USB, OmniKey CardMan 3621
254        - support Solaris (Solaris uses a different libusb)
255        - better documentation for ./configure arguments
256        - improve support of Cherry XX44 keyboard for PIN verify and change
257          (circumvent firmware bugs)
258        - do not use LTPBundleFindValueWithKey() from pcscd since this
259          function has been removed from pcscd API
260        - use -fvisibility=hidden is available to limit the number of
261          exported symbols
262    
263    
264    1.0.0 - 3 March 2006, Ludovic Rousseau
265        - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
266          SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
267          Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
268          Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
269          CardMan 5121
270        - greatly improve support of PIN PAD readers. We now support TPDU
271          readers with T=1 cards
272        - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
273          Supported languages are: de, en, es, fr, it
274        - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
275          reader and is not CCID compatible
276        - allow to select the Power On voltage using Info.plist instead of
277          recompiling the source code
278        - correct bugs in the support of multi-slots readers
279        - if the card is faster than the reader (TA1=97 for example) we try
280          to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
281          instead of the default speed of TA1=11
282        - the src/parse tool do not use the driver anymore. No need to
283          update the Info.plist file first.
284        - some minor bugs removed
285    
286    
287  0.9.4 - 27 November 2005, Ludovic Rousseau  0.9.4 - 27 November 2005, Ludovic Rousseau
288      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
289        Verisign Secure Token and VeriSign Secure Storage Token, GemPC        Verisign Secure Token and VeriSign Secure Storage Token, GemPC
# Line 203  History: Line 334  History:
334      - T=1 TPDU code:      - T=1 TPDU code:
335        . the work on T=1 TPDU code was possible thanks to Gemplus        . the work on T=1 TPDU code was possible thanks to Gemplus
336          validation team who helped me test, debug and bring the code to          validation team who helped me test, debug and bring the code to
337          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
338          the Gemplus readers department          the Gemplus readers department
339        . error code was not checked correctly        . error code was not checked correctly
340        . avoid a (nearly) infinite loop when resynch are needed.        . avoid a (nearly) infinite loop when resynch are needed.
# Line 313  History: Line 444  History:
444      - move LTC31 reader from unsupported to supported reader list. It      - move LTC31 reader from unsupported to supported reader list. It
445        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
446        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.
447        Thanks to Josep Moné s Teixidor for pointing the problem.        Thanks to Josep Moné s Teixidor for pointing the problem.
448      - src/commands.c: comment out the automatic GET RESPONSE part. I      - src/commands.c: comment out the automatic GET RESPONSE part. I
449        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?
450    
# Line 324  History: Line 455  History:
455      - add --enable-libusb=PATH option is your libusb is not installed in      - add --enable-libusb=PATH option is your libusb is not installed in
456        /usr or /usr/local        /usr or /usr/local
457      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
458        Ville Skyttä for the patch.        Ville Skyttä for the patch.
459      - 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
460        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
461        EMV cards        EMV cards
# Line 354  History: Line 485  History:
485      - First public release      - First public release
486    
487    
488  Bibliography:  References:
489  =============  ===========
490    
491  [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
492  [2] http://www.gemplus.com/products/gempc433/  [2] http://www.gemplus.com/products/gempc433/
493  [3] http://www.gemplus.com/products/gempckey/  [3] http://www.gemplus.com/products/gempckey/
494  [4] http://www.gemplus.com/products/gempctwin/  [4] http://www.gemplus.com/products/gempctwin/
495  [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
496  [6] http://www.scmmicro.com/security/SCR331.html  [6] http://www.scmmicro.com/security/SCR331.html
497  [7] http://www.scmmicro.com/security/SCR335.html  [7] http://www.scmmicro.com/security/SCR335.html
498  [8] http://www.c3po.es/ltc31.html  [8] http://www.c3po.es/ltc31.html
# Line 372  Bibliography: Line 503  Bibliography:
503  [13] http://www.c3po.es/ltc32.html  [13] http://www.c3po.es/ltc32.html
504  [14] http://www.c3po.es/tltc2usb.html  [14] http://www.c3po.es/tltc2usb.html
505  [15] http://www.scmmicro.com/security/SCR333.html  [15] http://www.scmmicro.com/security/SCR333.html
506  [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
507  [17] http://www.scmmicro.com/support/pcs_product_drivers.html  [17] http://www.scmmicro.com/support/pcs_product_drivers.html
508  [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
509  [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 516  Bibliography:
516  [26] http://www.cryptoidentity.eutron.com/eng/home.asp  [26] http://www.cryptoidentity.eutron.com/eng/home.asp
517  [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
518  [28] http://www.ntt.com/jpki/scr3310.html  [28] http://www.ntt.com/jpki/scr3310.html
519    [29] http://www.asedrive.com/product.asp?pid=1
520    [30] http://www.scmmicro.com/security/SCR3310.html
521    [31] http://scmmicro.com/security/SCR3311.html
522    [31] http://scmmicro.com/security/SCR3320.html
523    [32] http://www.smartepad.com.br/
524    [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37
525    [34] http://www.scmmicro.com/security/SCR3340.html
526    [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
527    [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29
528    [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33
529    [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
530    [39] http://www.scmmicro.com/security/SDI_010.html
531    [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
532    [41] http://www.gemplus.com/products/gempc_card/
533    [42] http://www.asedrive.com/product.asp?pid=2
534    [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31
535    [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
536    [45] http://www.id3semiconductors.com/produits/cl1356D.htm
537    [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
538    [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
539    [48] http://www.id3semiconductors.com/produits/cl1356T.htm
540    [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48
541    [50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf
542    [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39
543    [52] http://www.teobyxiring.com/
544    [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html
545    [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html
546    [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50
547    
548  $Id$  $Id$
549    

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

  ViewVC Help
Powered by ViewVC 1.1.5