/[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 1314 by rousseau, Thu Jan 13 10:48:47 2005 UTC revision 1951 by rousseau, Tue Mar 21 08:50:03 2006 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]
25      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
27      multiple of wMaxPacketSize the communication is stopped.
28    - Athena ASE IIIe USB V2 [29]
29  - Cherry XX33 keyboard [?]  - Cherry XX33 keyboard [?]
30    - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
31    - Cherry SmartTerminal ST2000U [35]
32    - Cherry ST-1044U [27]
33  - Dell keyboard SK-3106 [?]  - Dell keyboard SK-3106 [?]
34  - Dell smart card reader keyboard [?]  - Dell smart card reader keyboard [?]
35    - Eutron SIM Pocket Combo [25]
36    - Eutron CryptoIdentity [26]
37  - Gemplus GemPC 433 SL [2]  - Gemplus GemPC 433 SL [2]
38  - Gemplus GemPC Key [3]  - Gemplus GemPC Key [3]
39    - Gemplus GemPC PinPad
40  - Gemplus GemPC Twin [4]  - Gemplus GemPC Twin [4]
41    - Gemplus GemCore POS Pro
42    - Gemplus GemCore SIM Pro
43    - Kobil KAAN Base [19]
44    - Kobil KAAN Advanced [20]
45    - Kobil KAAN SIM III [21]
46    - Kobil mIDentity [22]
47  - OmniKey CardMan 3121 [5]  - OmniKey CardMan 3121 [5]
48  - SCM Micro SCR 331 [6]  - SCM Micro SCR 331 [6]
49    You shall upgrade the firmware [17] using version 5.18 or later.    You shall upgrade the firmware [17] using version 5.18 or later.
# Line 34  Supported CCID readers: Line 52  Supported CCID readers:
52  - SCM Micro SCR 335 [7]  - SCM Micro SCR 335 [7]
53    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
54    recent model with firmware 5.14 or later    recent model with firmware 5.14 or later
55    - SCM Micro SCR 355
56    - SCM Micro SCR 3310 [30]
57    - SCM Micro SCR 3311 [31]
58  - SCM Micro SPR 532 [9]  - SCM Micro SPR 532 [9]
59    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a    You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
60    firmware upgrade.    firmware upgrade.
61    - SmartEpad (v 2.0) [32]
62      The firmware gives a very strange description of the reader (like a
63      dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
64    - Verisign Secure Storage Token [24]
65    - Verisign Secure Token [?]
66    
67    
68  Should work but untested by me:  Should work but untested by me:
# Line 46  I would like to get these readers to per Line 72  I would like to get these readers to per
72  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
73  manufacturers, please, contact me.  manufacturers, please, contact me.
74    
75  - ActivCard USB reader 2.0 [10]  - Axalto Reflex USB v3 [38]
76  - C3PO LTC32 [13]  - C3PO LTC32 [13]
77    - Gemplus GemPC Express
78    - OmniKey CardMan 3821 [37]
79    - OmniKey CardMan 5125 [33]
80    - OmniKey CardMan 6121 [36]
81    - SCM Micro SCR 331-DI NTTCom [23]
82    - SCM Micro SCR 3310-NTTCOM [28]
83    - SCM Micro SCR 3320 [32]
84  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
85    - SCM Micro SDI 010 [39]
86    - SCM SCR 3340 ExpressCard54 [34]
87  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
88    
89    
90  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
91  =============================================  =============================================
92    
93  - Advanced Card Systems ACR 38 [16]  - ActivCard USB reader 2.0 [10]
94      This reader do timeout when a special USB frame is sent from the      The reader do timeout when a special USB frame is sent from the
95      reader. If the frame size if a multiple of wMaxPacketSize the      reader. If the frame size if a multiple of wMaxPacketSize the
96      communication is stopped. You should contact the reader vendor to      communication is stopped.
     upgrade the firmware of the reader or replace the reader.  
   
97  - C3PO LTC31 [8]  - C3PO LTC31 [8]
98      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
99      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
100    - RSA SecureID SID800 [24]
101        The USB layer is completely broken. The reader is sometimes not even
102        seen on the USB bus (same problem under Windows). Maybe newer
103        devices will work?
104    
105    
106  Supported operating systems:  Supported operating systems:
# Line 78  Debug informations: Line 115  Debug informations:
115  ===================  ===================
116    
117  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
118  its debug to stdout (pcscd --foreground) then the CCID will also send  its debug to stderr (pcscd --foreground) then the CCID will also send
119  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)
120  then the CCID will also send its debug to syslog.  then the CCID will also send its debug to syslog.
121    
122  You can change the debug level using the Info.plist configuraion file.  You can change the debug level using the Info.plist configuration file.
123  The Info.plist is installed, by default, in  The Info.plist is installed, by default, in
124  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist  /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
125    
# Line 90  The debug level is set in the ifdLogLeve Line 127  The debug level is set in the ifdLogLeve
127  combinaison of 4 different levels.  combinaison of 4 different levels.
128  - 1: critical: important error messages  - 1: critical: important error messages
129  - 2: info:     informative messages like what reader was detected  - 2: info:     informative messages like what reader was detected
130  - 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  
131                 reader                 reader
132    - 8: periodic: periodic info when pcscd test if a card is present (every
133                   1/10 of a second)
134    
135  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
136  critical and info levels.  critical and info levels.
# Line 119  MacOSX libusb Line 156  MacOSX libusb
156  Licence:  Licence:
157  ========  ========
158    
159    This program is free software; you can redistribute it and/or modify    This library is free software; you can redistribute it and/or modify it
160  it under the terms of the GNU General Public License as published by the  under the terms of the GNU Lesser General Public License as published by
161  Free Software Foundation; either version 2 of the License, or (at your  the Free Software Foundation; either version 2.1 of the License, or (at
162  option) any later version.  your option) any later version.
163    
164    This program is distributed in the hope that it will be useful, but    This library is distributed in the hope that it will be useful, but
165  WITHOUT ANY WARRANTY; without even the implied warranty of  WITHOUT ANY WARRANTY; without even the implied warranty of
166  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
167  General Public License for more details.  General Public License for more details.
168    
169    You should have received a copy of the GNU General Public License    You should have received a copy of the GNU Lesser General Public License
170  along with this program; if not, write to the Free Software Foundation,  along with this library; if not, write to the Free Software Foundation,
171  Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA  Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
172    
173    
174  History:  History:
175  ========  ========
176    
177    1.0.0 - 3 March 2006, Ludovic Rousseau
178        - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
179          SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
180          Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
181          Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
182          CardMan 5125
183        - greatly improve support of PIN PAD readers. We now support TPDU
184          readers with T=1 cards
185        - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
186          Supported languages are: de, en, es, fr, it
187        - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
188          reader and is not CCID compatible
189        - allow to select the Power On voltage using Info.plist instead of
190          recompiling the source code
191        - correct bugs in the support of multi-slots readers
192        - if the card is faster than the reader (TA1=97 for example) we try
193          to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
194          instead of the default speed of TA1=11
195        - the src/parse tool do not use the driver anymore. No need to
196          update the Info.plist file first.
197        - some minor bugs removed
198    
199    
200    0.9.4 - 27 November 2005, Ludovic Rousseau
201        - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
202          Verisign Secure Token and VeriSign Secure Storage Token, GemPC
203          Card (PCMCIA), SCM SCR331-DI NTTCom, SCM Micro SCR 3310-NTTCom,
204          Cherry ST-1044U, Cherry SmartTerminal ST-2XXX
205        - add support of PC/SC v2 part 10 CM_IOCTL_GET_FEATURE_REQUEST add
206          support of FEATURE_VERIFY_PIN_DIRECT and FEATURE_MODIFY_PIN_DIRECT
207          remove support of IOCTL_SMARTCARD_VENDOR_VERIFY_PIN (now
208          obsoleted). A sample code is available in examples/scardcontrol.c
209        - we need pcsc-lite 1.2.9-beta9 since some structures used for PIN
210          pad readers are defined by pcsc-lite
211        - some (bogus) cards require an extra EGT but the ATR does not say
212          so. We try to detect the bogus cards and set TC1=2
213        - IFDHSetProtocolParameters(): only use a data rate supported by the
214          reader in the PPS negociation, otherwise we stay at the default
215          speed.
216        - calculate and store the read timeout according to the card ATR
217          instead of using a fixed value of 60 seconds
218        - increase the read timeout if the card sends and WTX request
219        - improve support of GemPC Twin and GemPC Card (serial protocol)
220        - reset the device on close only if DRIVER_OPTION_RESET_ON_CLOSE is
221          set. The problem was that a device reset also disconnects the
222          keyboard on a keyboard + reader device.
223        - use color logs
224        - some minor bugs removed
225    
226    
227    0.9.3 - 14 March 2005, Ludovic Rousseau
228        - change the licence from GNU GPL to GNU Lesser GPL (LGPL)
229        - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,
230          Kobil KAAN SIM III, Kobil KAAN mIDentity, SCM Micro SCR 331,
231          SCM Micro SCR 331-DI, SCM Micro SCR 335, SCM Micro SCR 3310,
232          SCM Micro SCR 532, Cherry XX44 readers
233        - improve communication speed with readers featuring "Automatic PPS
234          made by the CCID"
235        - switch the Cherry xx33 reader in ISO mode if power up in EMV mode
236          fails.
237        - add support of character level readers. Thanks to O2Micro for the
238          patch
239        - add support for the O2Micro OZ776S reader but the reader firmware
240          is still bogus
241        - check firmware version to avoid firmwares with bugs. You can still
242          use a bogus firmware by setting DRIVER_OPTION_USE_BOGUS_FIRMWARE
243          in Info.plist
244        - some minor bugs removed
245    
246  0.9.2 - 15 August 2004, Ludovic Rousseau  0.9.2 - 15 August 2004, Ludovic Rousseau
247      - T=1 TPDU code:      - T=1 TPDU code:
248        . the work on T=1 TPDU code was possible thanks to Gemplus        . the work on T=1 TPDU code was possible thanks to Gemplus
# Line 292  History: Line 398  History:
398      - First public release      - First public release
399    
400    
401  Bibliography:  References:
402  =============  ===========
403    
404  [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
405  [2] http://www.gemplus.com/products/gempc433/  [2] http://www.gemplus.com/products/gempc433/
406  [3] http://www.gemplus.com/products/gempckey/  [3] http://www.gemplus.com/products/gempckey/
407  [4] http://www.gemplus.com/products/gempctwin/  [4] http://www.gemplus.com/products/gempctwin/
408  [5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47  [5] http://www.omnikey.com/index.php?id=40
409  [6] http://www.scmmicro.com/security/SCR331.html  [6] http://www.scmmicro.com/security/SCR331.html
410  [7] http://www.scmmicro.com/security/SCR335.html  [7] http://www.scmmicro.com/security/SCR335.html
411  [8] http://www.c3po.es/ltc31.html  [8] http://www.c3po.es/ltc31.html
# Line 310  Bibliography: Line 416  Bibliography:
416  [13] http://www.c3po.es/ltc32.html  [13] http://www.c3po.es/ltc32.html
417  [14] http://www.c3po.es/tltc2usb.html  [14] http://www.c3po.es/tltc2usb.html
418  [15] http://www.scmmicro.com/security/SCR333.html  [15] http://www.scmmicro.com/security/SCR333.html
419  [16] http://www.acs.com.hk/products_readers_acr38.asp  [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers
420  [17] http://www.scmmicro.com/support/pcs_product_drivers.html  [17] http://www.scmmicro.com/support/pcs_product_drivers.html
421    [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm
422    [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
423    [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php
424    [21] http://www.kobil.com/d/products/smartcard/kaansim3.php
425    [22] http://www.kobil.com/e/products/index.php?s=midentity
426    [23] http://www.ntt.com/jpki/SCR331DI.html
427    [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/
428    [25] http://www.eutron.com/simpocket.asp
429    [26] http://www.cryptoidentity.eutron.com/eng/home.asp
430    [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm
431    [28] http://www.ntt.com/jpki/scr3310.html
432    [29] http://www.asedrive.com/product.asp?pid=1
433    [30] http://www.scmmicro.com/security/SCR3310.html
434    [31] http://scmmicro.com/security/SCR3311.html
435    [31] http://scmmicro.com/security/SCR3320.html
436    [32] http://www.smartepad.com.br/
437    [33] http://www.omnikey.com/index.php?id=121
438    [34] http://www.scmmicro.com/security/SCR3340.html
439    [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
440    [36] http://www.omnikey.com/index.php?id=21
441    [37] http://www.omnikey.com/index.php?id=114
442    [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
443    [39] http://www.scmmicro.com/security/SDI_010.html
444    
445  $Id$  $Id$
446    

Legend:
Removed from v.1314  
changed lines
  Added in v.1951

  ViewVC Help
Powered by ViewVC 1.1.5