/[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 1833 by rousseau, Tue Jan 24 16:37:23 2006 UTC revision 2807 by rousseau, Fri Feb 8 09:32:35 2008 UTC
# Line 20  Supported CCID readers: Line 20  Supported CCID readers:
20  =======================  =======================
21    
22  (in alphabetical order)  (in alphabetical order)
23    - ActivCard USB reader 3.0
24  - Advanced Card Systems ACR 38U-CCID [16]  - 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]  - Athena ASE IIIe USB V2 [29]
32    - Athena ASE IIIe KB USB [42]
33    - Blutronics Bludrive II CCID
34    - C3PO LTC31 (new model, USB product id 0x0006) [8]
35  - Cherry XX33 keyboard [?]  - Cherry XX33 keyboard [?]
36  - Cherry XX44 keyboard (SmartBoard G83-6744) [18]  - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
37  - Cherry SmartTerminal ST2XXX  - Cherry SmartTerminal ST2000U [35]
38  - Cherry ST-1044U [27]  - Cherry ST-1044U [27]
39  - Dell keyboard SK-3106 [?]  - Dell keyboard SK-3106 [?]
40  - Dell smart card reader keyboard [?]  - Dell smart card reader keyboard [?]
41    - Eutron Digipass 860 [59]
42  - Eutron SIM Pocket Combo [25]  - Eutron SIM Pocket Combo [25]
43  - Eutron CryptoIdentity [26]  - Eutron CryptoIdentity [26]
44    - Eutron Smart Pocket [58]
45  - Gemplus GemPC 433 SL [2]  - Gemplus GemPC 433 SL [2]
46    - Gemplus GemPC Card [41]
47  - Gemplus GemPC Key [3]  - Gemplus GemPC Key [3]
48  - Gemplus GemPC PinPad  - Gemplus GemPC PinPad
49  - Gemplus GemPC Twin [4]  - Gemplus GemPC Twin [4]
# Line 42  Supported CCID readers: Line 52  Supported CCID readers:
52  - Kobil KAAN Base [19]  - Kobil KAAN Base [19]
53  - Kobil KAAN Advanced [20]  - Kobil KAAN Advanced [20]
54  - Kobil KAAN SIM III [21]  - Kobil KAAN SIM III [21]
 - Kobil mIDentity [22]  
55  - OmniKey CardMan 3121 [5]  - OmniKey CardMan 3121 [5]
56    - RSA SecureID SID800 [50]
57  - SCM Micro SCR 331 [6]  - SCM Micro SCR 331 [6]
58    You shall upgrade the firmware [17] using version 5.18 or later.    You shall upgrade the firmware [17] using version 5.18 or later.
59  - SCM Micro SCR 331-DI [11]  - SCM Micro SCR 331-DI [11]
# Line 62  Supported CCID readers: Line 72  Supported CCID readers:
72    dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.    dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
73  - Verisign Secure Storage Token [24]  - Verisign Secure Storage Token [24]
74  - Verisign Secure Token [?]  - Verisign Secure Token [?]
75    - Xiring Teo [52]
76    
77    
78  Should work but untested by me:  Should work but untested by me:
# Line 71  I would like to get these readers to per Line 82  I would like to get these readers to per
82  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
83  manufacturers, please, contact me.  manufacturers, please, contact me.
84    
85  - ActivCard USB reader 2.0 [10]  - Axalto Reflex USB v3 [38]
86  - C3PO LTC32 [13]  - C3PO LTC32 [13]
87    - C3PO TLTC2USB
88    - C3PO KBR36
89    - Charismathics token
90    - Gemplus GemPC Express
91    - Fujitsu Siemens Computers SmartCard USB 2A [53]
92    - Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54]
93    - Giesecke & Devrient StarSign Card Token 350 (ICCD) [57]
94    - Giesecke & Devrient StarSign Card Token 550 (ICCD)
95    - HP USB Smart Card Keyboard [44]
96    - HP USB Smartcard Reader
97    - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
98      reader anymore)
99    - id3 Semiconductors CL1356T [48] (it should be the same firmware as the
100      CL1356D)
101    - Kobil EMV CAP - SecOVID Reader III
102    - Lenovo Integrated Smart Card Reader
103    - Lexar/Gemalto Smart Enterprise Guardian [60]
104    - OmniKey CardMan 1021
105    - OmniKey CardMan 3021 [49]
106    - OmniKey CardMan 3621 [43]
107    - OmniKey CardMan 3821 [37]
108    - OmniKey CardMan 4321 [55]
109    - OmniKey CardMan 5121 [33]
110    - OmniKey CardMan 5125 [51]
111    - OmniKey CardMan 5321 [56]
112    - OmniKey CardMan 6121 [36]
113    - O2Micro Oz776 (0x7762 and 0x7772 versions)
114    - Philips JCOP41V221
115    - SafeNet IKey4000
116  - SCM Micro SCR 331-DI NTTCom [23]  - SCM Micro SCR 331-DI NTTCom [23]
117  - SCM Micro SCR 3310-NTTCOM [28]  - SCM Micro SCR 3310-NTTCOM [28]
118  - SCM Micro SCR 3320 [32]  - SCM Micro SCR 3320 [32]
119  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
120    - SCM Micro SDI 010 [39]
121    - SCM SCR 3340 ExpressCard54 [34]
122    - SchlumbergerSema Cyberflex Access e-gate ICCD
123  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
124    - Sitecom USB simcard reader MD-010
125    - Winbond Electronics (for OEM only) [40]
126    
127    
128  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
129  =============================================  =============================================
130    
131  - C3PO LTC31 [8]  - ActivCard USB reader 2.0 [10]
132        The reader do timeout when a special USB frame is sent from the
133        reader. If the frame size if a multiple of wMaxPacketSize the
134        communication is stopped.
135    - C3PO LTC31 (old model, USB product id 0x0003) [8]
136      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
137      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
138  - RSA SecureID SID800 [24]  - iDream (THRC2002-2) [47]
139      The USB layer is completely broken. The reader is sometimes not even      PPS fails with a Cryptoflex card
140      seen on the USB bus (same problem under Windows). Maybe newer      powerup fails with a Setcos card
141      devices will work?      does work with the belgium eID (the reader is sold for this
142        application)
143    - Kobil mIDentity [22]
144        Time requests are not managed correctly and make the firmware fails.
145        This is not a problem unless you use a time-consuming APDU like RSA
146        key generation.
147        A new firmware will correct the bug.
148    - Reiner-SCT cyberJack pinpad(a)
149        Time requests are not managed and the driver may time out without
150        any response from the reader.  This is not a problem unless you use
151        a time-consuming APDU like RSA key generation.
152    
153    
154  Supported operating systems:  Supported operating systems:
# Line 104  Debug informations: Line 163  Debug informations:
163  ===================  ===================
164    
165  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
166  its debug to stdout (pcscd --foreground) then the CCID will also send  its debug to stderr (pcscd --foreground) then the CCID will also send
167  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)
168  then the CCID will also send its debug to syslog.  then the CCID will also send its debug to syslog.
169    
170  You can change the debug level using the Info.plist configuraion file.  You can change the debug level using the Info.plist configuration file.
171  The Info.plist is installed, by default, in  The Info.plist is installed, by default, in
172  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
173    
# Line 116  The debug level is set in the ifdLogLeve Line 175  The debug level is set in the ifdLogLeve
175  combinaison of 4 different levels.  combinaison of 4 different levels.
176  - 1: critical: important error messages  - 1: critical: important error messages
177  - 2: info:     informative messages like what reader was detected  - 2: info:     informative messages like what reader was detected
178  - 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  
179                 reader                 reader
180    - 8: periodic: periodic info when pcscd test if a card is present (every
181                   1/10 of a second)
182    
183  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
184  critical and info levels.  critical and info levels.
# Line 163  Inc., 59 Temple Place, Suite 330, Boston Line 222  Inc., 59 Temple Place, Suite 330, Boston
222  History:  History:
223  ========  ========
224    
225    1.3.3 - 6 February 2008, Ludovic Rousseau
226        - add support for Lexar Smart Enterprise Guardian and Blutronics
227          Bludrive II CCID
228        - add support of TAG_IFD_POLLING_THREAD using IFDHPolling() to
229          detect asynchronous card movements. With this feature pcscd will
230          not poll the reader every 0.4 second for a card movement but will
231          wait until the reader sends a USB interrupt signal
232        - correct a bug with an ICCD-B device and a receive buffer smaller
233          than 4 bytes
234        - remove the sleep in the udev rule. It slows down the detection of
235          any USB device
236        - some minor bugs removed
237    
238    
239    1.3.2 - 22 January 2008, Ludovic Rousseau
240        - add support of Apple Mac OS X Leopard (10.5.1)
241        - solve a hotplug problem on Ubuntu 7.10 (reader was not detected)
242        - create a symlink from libccidtwin.so to libccidtwin.so.VERSION so
243          that the /etc/reader.conf configuration file do not need to edited
244          for each new driver version
245        - make driver for the GemPC Serial compile again
246        - some minor bugs removed
247    
248    
249    1.3.1 - 16 November 2007, Ludovic Rousseau
250        - add support for "Philips Semiconductors JCOP41V221" ICCD card,
251          O2Micro oz776 (ProductID 0x7772), CardMan5321, Giesecke & Devrient
252          StarSign Card Token 350 and 550, SafeNet IKey4000, Eutron
253          CryptoIdentity, Eutron Smart Pocket, Eutron Digipass 860, Lenovo
254          Integrated Smart Card Reader, "Kobil EMV CAP - SecOVID Reader III,
255          Charismathics token, Reiner-SCT cyberJack pinpad(a)
256        - improve support of Mac OS X and *BSD
257        - some minor bugs removed
258    
259    
260    1.3.0 - 10 May 2007, Ludovic Rousseau
261        - add support of ICCD version A and B
262        - add support for (new) KOBIL mIDentity, SchlumbergerSema Cyberflex
263          Access e-gate ICCD, Fujitsu Siemens Computers SmartCard USB 2A and
264          SmartCard Keyboard USB 2A readers, OmniKey CardMan 4321
265        - contrib/RSA_SecurID/RSA_SecurID_getpasswd: tool to get the on time
266          password also displayed on the token screen
267        - contrib/Kobil_mIDentity_switch: tool to activate the CCID reader
268          of the Kobil mIDentity. The tool should be started automatically
269          by the udev rule on Linux
270        - GemPC pinpad: localisation of the string "PIN blocked", add
271          Portuguese(pt), Dutch(nl) and Turkish(tr) localisations
272        - some minor bugs removed
273    
274    1.2.1 - 27 January 2007, Ludovic Rousseau
275        - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
276          readers
277        - INSTALL: document how to use --enable-udev on FreeBSD
278        - move the O2Micro Oz7762 from the unsupported to the supported list
279          since patches to support it are applied by default
280          (O2MICRO_OZ776_PATCH)
281    
282    
283    1.2.0 - 19 January 2007, Ludovic Rousseau
284        - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
285          SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
286          SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
287        - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
288          Teo by Xiring, HP USB Smartcard Reader
289        - use --enable-twinserial to build the serial reader driver
290        - use --enable-udev to configure for a use with Linux udev hotplug
291          mechanism. This will allow pcscd to avoid polling the USB bus
292          every 1 second
293        - some minor bugs removed
294    
295    
296    1.1.0 - 11 August 2006, Ludovic Rousseau
297        - support Extended APDU (up to 64KB) for readers in TPDU mode (many
298          readers) or Extended APDU mode (very rare). This only works for
299          T=1 cards.
300        - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
301          USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
302          id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
303        - support the contactless interface of the SCR331-DI-NTTCOM
304        - add support of FreeBSD
305        - increase the USB timeout used for PIN verify/modify to not timeout
306          before the reader
307        - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
308          be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
309          page 2. The applications using this feature shall be updated (to
310          respect the PCSC specification).
311        - use ./configure --enable-twinserial to compile and install the the
312          driver for the GemPC Twin serial
313        - some minor bugs removed
314    
315    
316    1.0.1 - 22 April 2006, Ludovic Rousseau
317        - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
318          Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
319          KB USB, OmniKey CardMan 3621
320        - support Solaris (Solaris uses a different libusb)
321        - better documentation for ./configure arguments
322        - improve support of Cherry XX44 keyboard for PIN verify and change
323          (circumvent firmware bugs)
324        - do not use LTPBundleFindValueWithKey() from pcscd since this
325          function has been removed from pcscd API
326        - use -fvisibility=hidden is available to limit the number of
327          exported symbols
328    
329    
330    1.0.0 - 3 March 2006, Ludovic Rousseau
331        - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
332          SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
333          Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
334          Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
335          CardMan 5121
336        - greatly improve support of PIN PAD readers. We now support TPDU
337          readers with T=1 cards
338        - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
339          Supported languages are: de, en, es, fr, it
340        - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
341          reader and is not CCID compatible
342        - allow to select the Power On voltage using Info.plist instead of
343          recompiling the source code
344        - correct bugs in the support of multi-slots readers
345        - if the card is faster than the reader (TA1=97 for example) we try
346          to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
347          instead of the default speed of TA1=11
348        - the src/parse tool do not use the driver anymore. No need to
349          update the Info.plist file first.
350        - some minor bugs removed
351    
352    
353  0.9.4 - 27 November 2005, Ludovic Rousseau  0.9.4 - 27 November 2005, Ludovic Rousseau
354      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,      - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
355        Verisign Secure Token and VeriSign Secure Storage Token, GemPC        Verisign Secure Token and VeriSign Secure Storage Token, GemPC
# Line 213  History: Line 400  History:
400      - T=1 TPDU code:      - T=1 TPDU code:
401        . the work on T=1 TPDU code was possible thanks to Gemplus        . the work on T=1 TPDU code was possible thanks to Gemplus
402          validation team who helped me test, debug and bring the code to          validation team who helped me test, debug and bring the code to
403          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
404          the Gemplus readers department          the Gemplus readers department
405        . error code was not checked correctly        . error code was not checked correctly
406        . avoid a (nearly) infinite loop when resynch are needed.        . avoid a (nearly) infinite loop when resynch are needed.
# Line 323  History: Line 510  History:
510      - move LTC31 reader from unsupported to supported reader list. It      - move LTC31 reader from unsupported to supported reader list. It
511        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
512        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.
513        Thanks to Josep Moné s Teixidor for pointing the problem.        Thanks to Josep Moné s Teixidor for pointing the problem.
514      - src/commands.c: comment out the automatic GET RESPONSE part. I      - src/commands.c: comment out the automatic GET RESPONSE part. I
515        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?
516    
# Line 334  History: Line 521  History:
521      - add --enable-libusb=PATH option is your libusb is not installed in      - add --enable-libusb=PATH option is your libusb is not installed in
522        /usr or /usr/local        /usr or /usr/local
523      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to      - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
524        Ville Skyttä for the patch.        Ville Skyttä for the patch.
525      - 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
526        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
527        EMV cards        EMV cards
# Line 371  References: Line 558  References:
558  [2] http://www.gemplus.com/products/gempc433/  [2] http://www.gemplus.com/products/gempc433/
559  [3] http://www.gemplus.com/products/gempckey/  [3] http://www.gemplus.com/products/gempckey/
560  [4] http://www.gemplus.com/products/gempctwin/  [4] http://www.gemplus.com/products/gempctwin/
561  [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
562  [6] http://www.scmmicro.com/security/SCR331.html  [6] http://www.scmmicro.com/security/SCR331.html
563  [7] http://www.scmmicro.com/security/SCR335.html  [7] http://www.scmmicro.com/security/SCR335.html
564  [8] http://www.c3po.es/ltc31.html  [8] http://www.c3po.es/ltc31.html
# Line 400  References: Line 587  References:
587  [31] http://scmmicro.com/security/SCR3311.html  [31] http://scmmicro.com/security/SCR3311.html
588  [31] http://scmmicro.com/security/SCR3320.html  [31] http://scmmicro.com/security/SCR3320.html
589  [32] http://www.smartepad.com.br/  [32] http://www.smartepad.com.br/
590    [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37
591    [34] http://www.scmmicro.com/security/SCR3340.html
592    [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
593    [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29
594    [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33
595    [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
596    [39] http://www.scmmicro.com/security/SDI_010.html
597    [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
598    [41] http://www.gemplus.com/products/gempc_card/
599    [42] http://www.asedrive.com/product.asp?pid=2
600    [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31
601    [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
602    [45] http://www.id3semiconductors.com/produits/cl1356D.htm
603    [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
604    [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
605    [48] http://www.id3semiconductors.com/produits/cl1356T.htm
606    [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48
607    [50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf
608    [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39
609    [52] http://www.teobyxiring.com/
610    [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html
611    [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html
612    [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50
613    [56] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=41
614    [57] http://www.gi-de.com/portal/page?_pageid=42,126834&_dad=portal&_schema=PORTAL
615    [58] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=26&IDFamiglia=3
616    [59] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=62&IDFamiglia=39
617    [60] http://www.lexar.com/enterprise/ent_ppsd.html
618    
619  $Id$  $Id$
620    

Legend:
Removed from v.1833  
changed lines
  Added in v.2807

  ViewVC Help
Powered by ViewVC 1.1.5