/[pcsclite]/trunk/Drivers/ccid/README
ViewVC logotype

Contents of /trunk/Drivers/ccid/README

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2693 - (hide annotations) (download)
Fri Nov 16 14:43:59 2007 UTC (5 years, 6 months ago) by rousseau
File size: 26682 byte(s)
update Reiner-SCT bug: only case 1 APDU do not work
1 rousseau 269 USB CCID IFD Handler
2     ====================
3    
4     This package provides the source code for a generic USB CCID
5     (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID
6 rousseau 273 specifications from the USB working group.
7 rousseau 269
8    
9 rousseau 697 Authors:
10     ========
11 rousseau 269
12     - Ludovic Rousseau <ludovic.rousseau@free.fr>
13 rousseau 1015 - Carlos Prados for the PPS and ATR parsing code (taken from his
14     towitoto driver) in towitoko/ directory.
15     - Olaf Kirch for the T=1 TPDU code (from the OpenCT package) in openct/
16     directory. I (Ludovic Rousseau) greatly improved this code.
17 rousseau 269
18    
19     Supported CCID readers:
20     =======================
21    
22 rousseau 273 (in alphabetical order)
23 rousseau 1876 - ActivCard USB reader 3.0
24 rousseau 1778 - Advanced Card Systems ACR 38U-CCID [16]
25 rousseau 1321 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 rousseau 2101 - Alcor Micro AU9520 [46]
29 rousseau 2155 Firmware 1.01 is bogus. The time request sent by the card is not
30     forwarded by the reader to the host.
31 rousseau 1776 - Athena ASE IIIe USB V2 [29]
32 rousseau 2000 - Athena ASE IIIe KB USB [42]
33 rousseau 2038 - C3PO LTC31 (new model, USB product id 0x0006) [8]
34 rousseau 969 - Cherry XX33 keyboard [?]
35 rousseau 1622 - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
36 rousseau 1883 - Cherry SmartTerminal ST2000U [35]
37 rousseau 1626 - Cherry ST-1044U [27]
38 rousseau 969 - Dell keyboard SK-3106 [?]
39     - Dell smart card reader keyboard [?]
40 rousseau 2674 - Eutron Digipass 860 [59]
41 rousseau 1546 - Eutron SIM Pocket Combo [25]
42     - Eutron CryptoIdentity [26]
43 rousseau 2671 - Eutron Smart Pocket [58]
44 rousseau 273 - Gemplus GemPC 433 SL [2]
45 rousseau 1969 - Gemplus GemPC Card [41]
46 rousseau 273 - Gemplus GemPC Key [3]
47 rousseau 1815 - Gemplus GemPC PinPad
48 rousseau 273 - Gemplus GemPC Twin [4]
49 rousseau 1815 - Gemplus GemCore POS Pro
50     - Gemplus GemCore SIM Pro
51 rousseau 1326 - Kobil KAAN Base [19]
52     - Kobil KAAN Advanced [20]
53 rousseau 1393 - Kobil KAAN SIM III [21]
54 rousseau 273 - OmniKey CardMan 3121 [5]
55 rousseau 2172 - RSA SecureID SID800 [50]
56 rousseau 1314 - SCM Micro SCR 331 [6]
57     You shall upgrade the firmware [17] using version 5.18 or later.
58     - SCM Micro SCR 331-DI [11]
59     You shall upgrade the firmware [17] using version 6.22 or later.
60     - SCM Micro SCR 335 [7]
61     The firmware of this reader can't be upgraded so be sure to buy a
62     recent model with firmware 5.14 or later
63 rousseau 1787 - SCM Micro SCR 355
64 rousseau 1788 - SCM Micro SCR 3310 [30]
65 rousseau 1820 - SCM Micro SCR 3311 [31]
66 rousseau 1314 - SCM Micro SPR 532 [9]
67     You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
68     firmware upgrade.
69 rousseau 1833 - SmartEpad (v 2.0) [32]
70     The firmware gives a very strange description of the reader (like a
71     dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
72 rousseau 1521 - Verisign Secure Storage Token [24]
73 rousseau 1523 - Verisign Secure Token [?]
74 rousseau 2222 - Xiring Teo [52]
75 rousseau 606
76    
77     Should work but untested by me:
78     ===============================
79    
80     I would like to get these readers to perform test and validation and
81     move them in the supported list above. If you are one of the
82     manufacturers, please, contact me.
83    
84 rousseau 1945 - Axalto Reflex USB v3 [38]
85 rousseau 709 - C3PO LTC32 [13]
86 rousseau 2224 - C3PO TLTC2USB
87     - C3PO KBR36
88 rousseau 2683 - Charismathics token
89 rousseau 1863 - Gemplus GemPC Express
90 rousseau 2484 - Fujitsu Siemens Computers SmartCard USB 2A [53]
91     - Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54]
92 rousseau 2610 - Giesecke & Devrient StarSign Card Token 350 (ICCD) [57]
93     - Giesecke & Devrient StarSign Card Token 550 (ICCD)
94 rousseau 2037 - HP USB Smart Card Keyboard [44]
95 rousseau 2298 - HP USB Smartcard Reader
96 rousseau 2100 - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
97     reader anymore)
98 rousseau 2133 - id3 Semiconductors CL1356T [48] (it should be the same firmware as the
99     CL1356D)
100 rousseau 2669 - Kobil EMV CAP - SecOVID Reader III
101 rousseau 2656 - Lenovo Integrated Smart Card Reader
102 rousseau 2278 - OmniKey CardMan 1021
103 rousseau 2163 - OmniKey CardMan 3021 [49]
104 rousseau 2016 - OmniKey CardMan 3621 [43]
105 rousseau 1909 - OmniKey CardMan 3821 [37]
106 rousseau 2509 - OmniKey CardMan 4321 [55]
107 rousseau 2162 - OmniKey CardMan 5121 [33]
108 rousseau 2174 - OmniKey CardMan 5125 [51]
109 rousseau 2607 - OmniKey CardMan 5321 [56]
110 rousseau 1909 - OmniKey CardMan 6121 [36]
111 rousseau 2604 - O2Micro Oz776 (0x7762 and 0x7772 versions)
112 rousseau 2579 - Philips JCOP41V221
113 rousseau 2617 - SafeNet IKey4000
114 rousseau 1508 - SCM Micro SCR 331-DI NTTCom [23]
115 rousseau 1730 - SCM Micro SCR 3310-NTTCOM [28]
116 rousseau 1789 - SCM Micro SCR 3320 [32]
117 rousseau 709 - SCM Micro SCR 333 [15]
118 rousseau 1951 - SCM Micro SDI 010 [39]
119 rousseau 1864 - SCM SCR 3340 ExpressCard54 [34]
120 rousseau 2521 - SchlumbergerSema Cyberflex Access e-gate ICCD
121 rousseau 709 - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
122 rousseau 2516 - Sitecom USB simcard reader MD-010
123 rousseau 1968 - Winbond Electronics (for OEM only) [40]
124 rousseau 269
125    
126 rousseau 969 Unsupported or partly supported CCID readers:
127     =============================================
128 rousseau 269
129 rousseau 1876 - ActivCard USB reader 2.0 [10]
130     The reader do timeout when a special USB frame is sent from the
131     reader. If the frame size if a multiple of wMaxPacketSize the
132     communication is stopped.
133 rousseau 2038 - C3PO LTC31 (old model, USB product id 0x0003) [8]
134 rousseau 1165 The reader works fine with Linux kernel 2.4 but does not with Linux
135     kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
136 rousseau 2131 - iDream (THRC2002-2) [47]
137     PPS fails with a Cryptoflex card
138     powerup fails with a Setcos card
139     does work with the belgium eID (the reader is sold for this
140     application)
141 rousseau 2441 - Kobil mIDentity [22]
142     Time requests are not managed correctly and make the firmware fails.
143     This is not a problem unless you use a time-consuming APDU like RSA
144     key generation.
145     A new firmware will correct the bug.
146 rousseau 2689 - Reiner-SCT cyberJack pinpad(a)
147 rousseau 2693 case 1 APDU do not work
148 rousseau 269
149 rousseau 1165
150 rousseau 321 Supported operating systems:
151     ============================
152    
153     - GNU/Linux (libusb 0.1.7)
154     - MacOS X/Darwin (libusb 0.1.8beta, CVS snapshot. See "Known problems")
155     to libusb)
156    
157    
158 rousseau 862 Debug informations:
159     ===================
160    
161     The driver uses the debug function provided by pcscd. So if pcscd sends
162 rousseau 1905 its debug to stderr (pcscd --foreground) then the CCID will also send
163     its debug to stderr. If pcscd sends its debug to syslog (by default)
164 rousseau 862 then the CCID will also send its debug to syslog.
165    
166 rousseau 1905 You can change the debug level using the Info.plist configuration file.
167 rousseau 862 The Info.plist is installed, by default, in
168     /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
169    
170     The debug level is set in the ifdLogLevel field. It is a binary OR
171     combinaison of 4 different levels.
172     - 1: critical: important error messages
173     - 2: info: informative messages like what reader was detected
174 rousseau 1905 - 4: comm: a dump of all the bytes exchanged between the host and the
175     reader
176     - 8: periodic: periodic info when pcscd test if a card is present (every
177 rousseau 862 1/10 of a second)
178    
179     By default the debug level is set to 3 (1 + 2) and correspond to the
180     critical and info levels.
181    
182     You have to restart the driver so it read the configuration file again
183     and use the new debug level value. To restart the driver you just need
184     to unplug all your CCID readers so the the driver is unloaded and then
185     replug your readers. You can also restart pcscd.
186    
187    
188 rousseau 321 Known problems:
189     ===============
190    
191 rousseau 1165 MacOSX libusb
192 rousseau 969 """""""""""""
193     There is a bug in libusb that crash the libusb library when you
194     unplug a reader and replug it in another USB socket. So if you
195     unplug a reader replug it in the same USB socket.
196    
197     see http://sourceforge.net/tracker/index.php?func=detail&aid=886778&group_id=1674&atid=101674
198    
199    
200 rousseau 273 Licence:
201     ========
202    
203 rousseau 1399 This library is free software; you can redistribute it and/or modify it
204     under the terms of the GNU Lesser General Public License as published by
205     the Free Software Foundation; either version 2.1 of the License, or (at
206     your option) any later version.
207 rousseau 269
208 rousseau 1399 This library is distributed in the hope that it will be useful, but
209 rousseau 269 WITHOUT ANY WARRANTY; without even the implied warranty of
210 rousseau 1399 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
211 rousseau 269 General Public License for more details.
212    
213 rousseau 1399 You should have received a copy of the GNU Lesser General Public License
214     along with this library; if not, write to the Free Software Foundation,
215     Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
216 rousseau 269
217    
218     History:
219     ========
220    
221 rousseau 2692 1.3.1 - 16 November 2007, Ludovic Rousseau
222     - add support for "Philips Semiconductors JCOP41V221" ICCD card,
223     O2Micro oz776 (ProductID 0x7772), CardMan5321, Giesecke & Devrient
224     StarSign Card Token 350 and 550, SafeNet IKey4000, Eutron
225     CryptoIdentity, Eutron Smart Pocket, Eutron Digipass 860, Lenovo
226     Integrated Smart Card Reader, "Kobil EMV CAP - SecOVID Reader III,
227     Charismathics token, Reiner-SCT cyberJack pinpad(a)
228     - improve support of Mac OS X and *BSD
229     - some minor bugs removed
230    
231    
232 rousseau 2522 1.3.0 - 10 May 2007, Ludovic Rousseau
233     - add support of ICCD version A and B
234     - add support for (new) KOBIL mIDentity, SchlumbergerSema Cyberflex
235     Access e-gate ICCD, Fujitsu Siemens Computers SmartCard USB 2A and
236     SmartCard Keyboard USB 2A readers, OmniKey CardMan 4321
237     - contrib/RSA_SecurID/RSA_SecurID_getpasswd: tool to get the on time
238     password also displayed on the token screen
239     - contrib/Kobil_mIDentity_switch: tool to activate the CCID reader
240     of the Kobil mIDentity. The tool should be started automatically
241     by the udev rule on Linux
242     - GemPC pinpad: localisation of the string "PIN blocked", add
243 rousseau 2526 Portuguese(pt), Dutch(nl) and Turkish(tr) localisations
244 rousseau 2522 - some minor bugs removed
245    
246 rousseau 2363 1.2.1 - 27 January 2007, Ludovic Rousseau
247     - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
248     readers
249     - INSTALL: document how to use --enable-udev on FreeBSD
250     - move the O2Micro Oz7762 from the unsupported to the supported list
251     since patches to support it are applied by default
252     (O2MICRO_OZ776_PATCH)
253    
254    
255 rousseau 2351 1.2.0 - 19 January 2007, Ludovic Rousseau
256 rousseau 2345 - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
257     SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
258     SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
259     - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
260     Teo by Xiring, HP USB Smartcard Reader
261     - use --enable-twinserial to build the serial reader driver
262     - use --enable-udev to configure for a use with Linux udev hotplug
263     mechanism. This will allow pcscd to avoid polling the USB bus
264     every 1 second
265     - some minor bugs removed
266    
267    
268 rousseau 2135 1.1.0 - 11 August 2006, Ludovic Rousseau
269     - support Extended APDU (up to 64KB) for readers in TPDU mode (many
270     readers) or Extended APDU mode (very rare). This only works for
271     T=1 cards.
272     - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
273     USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
274     id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
275     - support the contactless interface of the SCR331-DI-NTTCOM
276     - add support of FreeBSD
277     - increase the USB timeout used for PIN verify/modify to not timeout
278     before the reader
279     - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
280     be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
281     page 2. The applications using this feature shall be updated (to
282     respect the PCSC specification).
283     - use ./configure --enable-twinserial to compile and install the the
284     driver for the GemPC Twin serial
285     - some minor bugs removed
286    
287    
288 rousseau 2020 1.0.1 - 22 April 2006, Ludovic Rousseau
289     - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
290     Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
291     KB USB, OmniKey CardMan 3621
292     - support Solaris (Solaris uses a different libusb)
293     - better documentation for ./configure arguments
294     - improve support of Cherry XX44 keyboard for PIN verify and change
295     (circumvent firmware bugs)
296     - do not use LTPBundleFindValueWithKey() from pcscd since this
297     function has been removed from pcscd API
298     - use -fvisibility=hidden is available to limit the number of
299     exported symbols
300    
301    
302 rousseau 1911 1.0.0 - 3 March 2006, Ludovic Rousseau
303     - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
304     SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
305     Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
306     Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
307 rousseau 2162 CardMan 5121
308 rousseau 1911 - greatly improve support of PIN PAD readers. We now support TPDU
309     readers with T=1 cards
310     - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
311     Supported languages are: de, en, es, fr, it
312     - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
313     reader and is not CCID compatible
314     - allow to select the Power On voltage using Info.plist instead of
315     recompiling the source code
316     - correct bugs in the support of multi-slots readers
317     - if the card is faster than the reader (TA1=97 for example) we try
318     to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
319     instead of the default speed of TA1=11
320     - the src/parse tool do not use the driver anymore. No need to
321     update the Info.plist file first.
322     - some minor bugs removed
323    
324    
325 rousseau 1761 0.9.4 - 27 November 2005, Ludovic Rousseau
326     - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
327     Verisign Secure Token and VeriSign Secure Storage Token, GemPC
328     Card (PCMCIA), SCM SCR331-DI NTTCom, SCM Micro SCR 3310-NTTCom,
329     Cherry ST-1044U, Cherry SmartTerminal ST-2XXX
330     - add support of PC/SC v2 part 10 CM_IOCTL_GET_FEATURE_REQUEST add
331     support of FEATURE_VERIFY_PIN_DIRECT and FEATURE_MODIFY_PIN_DIRECT
332     remove support of IOCTL_SMARTCARD_VENDOR_VERIFY_PIN (now
333     obsoleted). A sample code is available in examples/scardcontrol.c
334     - we need pcsc-lite 1.2.9-beta9 since some structures used for PIN
335     pad readers are defined by pcsc-lite
336     - some (bogus) cards require an extra EGT but the ATR does not say
337     so. We try to detect the bogus cards and set TC1=2
338     - IFDHSetProtocolParameters(): only use a data rate supported by the
339     reader in the PPS negociation, otherwise we stay at the default
340     speed.
341     - calculate and store the read timeout according to the card ATR
342     instead of using a fixed value of 60 seconds
343     - increase the read timeout if the card sends and WTX request
344     - improve support of GemPC Twin and GemPC Card (serial protocol)
345     - reset the device on close only if DRIVER_OPTION_RESET_ON_CLOSE is
346     set. The problem was that a device reset also disconnects the
347     keyboard on a keyboard + reader device.
348     - use color logs
349     - some minor bugs removed
350    
351    
352 rousseau 1400 0.9.3 - 14 March 2005, Ludovic Rousseau
353     - change the licence from GNU GPL to GNU Lesser GPL (LGPL)
354     - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,
355     Kobil KAAN SIM III, Kobil KAAN mIDentity, SCM Micro SCR 331,
356     SCM Micro SCR 331-DI, SCM Micro SCR 335, SCM Micro SCR 3310,
357     SCM Micro SCR 532, Cherry XX44 readers
358     - improve communication speed with readers featuring "Automatic PPS
359     made by the CCID"
360     - switch the Cherry xx33 reader in ISO mode if power up in EMV mode
361     fails.
362     - add support of character level readers. Thanks to O2Micro for the
363     patch
364     - add support for the O2Micro OZ776S reader but the reader firmware
365     is still bogus
366     - check firmware version to avoid firmwares with bugs. You can still
367     use a bogus firmware by setting DRIVER_OPTION_USE_BOGUS_FIRMWARE
368     in Info.plist
369     - some minor bugs removed
370    
371 rousseau 1186 0.9.2 - 15 August 2004, Ludovic Rousseau
372     - T=1 TPDU code:
373     . the work on T=1 TPDU code was possible thanks to Gemplus
374     validation team who helped me test, debug and bring the code to
375 rousseau 2131 an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and
376 rousseau 1186 the Gemplus readers department
377     . error code was not checked correctly
378     . avoid a (nearly) infinite loop when resynch are needed.
379     . correctly initialise an internal value to allow more than one
380     reader to work
381     - multi-slots readers
382     . add support for multi-slots readers. The only one I have is a
383     SCM Micro SCR 331-DI with a contact and a contactless interface.
384     The contactless interface may or may not work for you since the
385     reader uses proprietary (undocumented) commands.
386     - GemPC Twin serial reader
387     . perform a command (get the reader firmware) to be sure a GemPC
388     Twin (serial or pcmcia) reader is connected
389     . use a dynamic timeout when reading the serial port.
390     The first timeout used when detecting the reader is 2 seconds to
391     not wait too long if no reader is connected. Later timeouts are
392     set to 1 minute to allow long time APDU.
393     - use `pkg-config libpcsclite --cflags` to locate the pcsc-lite
394     header files
395     - use `pkg-config --print-errors --atleast-version=1.2.9-beta5 libpcsclite`
396     to test the pcsc-lite version
397     - code improvements thanks to the splint tool (http://www.splint.org/)
398    
399 rousseau 1018 0.9.1 - 1 July 2004, Ludovic Rousseau
400     - I forgot to define IFD_PARITY_ERROR in a .h file
401    
402 rousseau 1015 0.9.0 - 1 July 2004, Ludovic Rousseau
403     - The T=1 TPDU automata from Carlos Prados' Towitoko driver is very
404     limited and do not support error management mechanisms.
405     I then used the T=1 TPDU automata from OpenCT (OpenSC project).
406     This automata is much more powerful but still lacks a lot of error
407     management code.
408     I then added all the needed code to reach the quality level
409     requested by the EMV standard.
410     - add support for new readers:
411     . Advanced Card Systems ACR 38
412     . Cherry XX33
413     . Dell keyboard SK-3106
414     . Dell smart card reader keyboard
415     . SCR 333
416     - add support of multi procotol cards (T=0 and T=1)
417     - the debug level is now dynamic and set in the Info.plist file (no
418     need to recompile the driver any more)
419     - add support for the libusb naming scheme: usb:%04x/%04x:libusb:%s
420     - INSTALL: add a "configuring the driver for the serial reader
421     (GemPC Twin)" part
422     - use `pkg-config libpcsclite --variable=usbdropdir` so you do not
423     have to use --enable-usbdropdir=DIR or --enable-ccidtwindir=DIR
424     even if pcscd does not use the default /usr/local/pcsc/drivers
425     - add support of IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and
426     IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in IFDHControl()
427     - read ifdDriverOptions from Info.plist to limit the use of
428     IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE (idea from Peter Williams)
429     - provide an example of use of SCardControl()
430     IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and
431     IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in example/
432     - add a --enable-pcsclite option (default to yes) so that the driver
433     can be compiled for a different framework (one needing
434     tokenparser.l like Solaris)
435     - Reset action is power off and power on, not just power on
436     - use the include files from pcsc-lite
437     - add a mechanism to allow power on at 1.8V, 3V and then 5V as
438     specified by ISO 7816. We still use 5V for now to avoid problems
439     with non ISO compliant cards
440    
441 rousseau 703 0.4.1 - 14 February 2004, Ludovic Rousseau
442     - distribute missing files readers/supported_readers.txt and
443     src/create_Info_plist.pl
444     'make install' failed because of this.
445    
446 rousseau 697 0.4.0 - 13 February 2004, Ludovic Rousseau
447     - support of T=1 with TPDU readers. A lot of the T=1 code comes from
448     Carlos Prados towitoko driver.
449     My code is GNU GPL, his code is GNU LGPL so the global driver is
450     GNU GPL
451     - PPS negotiation if the reader does not do it automatically
452     - add support for the Silitek SK-3105 keyboard. It's a USB device
453     with multiple interfaces
454     - use the create_Info_plist.pl script to generate the installed
455     Info.plist from an Info.plist template and a list of supported
456     readers. The Info.plist was too "complex" to maintain by hand
457     since it now contains 11 entries
458     - add support of IFDHCreateChannelByName to avoid wrong reader
459     enumeration. This is not complete if you have multiple _identical_
460     readers. You need to use a > 1.2.0 pcsc-lite version (not yet
461     released at that time)
462     - build but do not install the serial ccidtwin driver by default
463     since it is useless on computers without a serial port or without
464     this reader for example.
465     - read and write timeouts are not symmetric. write timout can be
466     shorter since the reader and card is not supposed to do anything
467     before receiving (write) a command
468     - do not try to find usb.h and other libusb files if
469     --disable-libusb is used. Needed if you only want to build the
470     serial driver. Thanks to Niki Waibel for the patch
471     - add a --enable-ccidtwindir argument to ./configure to specify the
472     serial GemPC Twin installation directory
473     - debug and code improvements and simplifications
474    
475 rousseau 552 0.3.2 - 4 November 2003, Ludovic Rousseau
476     - src/commands.c: correct a stupid bug that occurs with an APDU with
477     2 bytes response.
478     - Info.plist: add SPR 532 in list of supported readers
479     - parse.c: do not exit if the InterfaceClass is 0xFF (proprietary).
480     It is the case with old readers manufactured before the final
481     release of the CCID specs.
482     - move LTC31 reader from unsupported to supported reader list. It
483     was my f ault since in used odd INS byte in my test applet and odd
484     INS bytes are forbidden by ISO 7816-4 ch. 5.4.2 Instruction byte.
485 rousseau 2131 Thanks to Josep Moné s Teixidor for pointing the problem.
486 rousseau 552 - src/commands.c: comment out the automatic GET RESPONSE part. I
487     don't think it should be in the driver. Maybe in pcscd instead?
488    
489 rousseau 467 0.3.1 - 23 September 2003, Ludovic Rouseau
490     - add --enable-multi-thread (enabled by default) for thread safe
491     support an APDU multiplexing. You will need pcsc-lite-1.2.0-rc3 or
492     above to use this feature.
493     - add --enable-libusb=PATH option is your libusb is not installed in
494     /usr or /usr/local
495     - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
496 rousseau 2131 Ville Skyttä for the patch.
497 rousseau 467 - src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU
498     mode since it also swicth in EMV mode and may not work with non
499     EMV cards
500     - src/ccid_serial.c: complete reimplementation of the Twin serial
501     protocol using a finite state automata (code much simpler)
502    
503 rousseau 423 0.3.0 - 10 September 2003, Ludovic Rousseau
504     - support of GemPC Twin connected to a serial port. Thanks to Niki
505     W. Waibel for a working prototype.
506     - support of auto voltage at power up if the reader support it
507     instead of forcing a 5V in all cases.
508     - support of APDU mode instead of just TPDU if the reader support
509     it. Thanks to Jean-Luc Giraud for the idea and inspiration I got
510     from his "concurrent" driver.
511 rousseau 425 - support of "time request" from the card.
512 rousseau 423 - parse: new indentation for more readability of supported features.
513     - switch the GemPC Key and GemPC Twin in APDU mode since they
514     support it but do not announce it in the dwFeatures.
515     - new build process using autoconf/automake.
516    
517 rousseau 342 0.2.0 - 26 August 2003, Ludovic Rousseau
518     - Works under MacOS X
519     - Info.plist: use an <array></array> for the alias enumeration
520     - Makefile rework for *BSD and MacOS X
521    
522 rousseau 273 0.1.0 - 13 August 2003, Ludovic Rousseau
523     - First public release
524 rousseau 269
525    
526 rousseau 1789 References:
527     ===========
528 rousseau 269
529     [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
530 rousseau 273 [2] http://www.gemplus.com/products/gempc433/
531     [3] http://www.gemplus.com/products/gempckey/
532 rousseau 269 [4] http://www.gemplus.com/products/gempctwin/
533 rousseau 2173 [5] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=21
534 rousseau 273 [6] http://www.scmmicro.com/security/SCR331.html
535     [7] http://www.scmmicro.com/security/SCR335.html
536 rousseau 709 [8] http://www.c3po.es/ltc31.html
537 rousseau 553 [9] http://www.scmmicro.com/security/SPR532.html
538 rousseau 606 [10] http://www.activcard.com/products/usb_reader.html
539 rousseau 666 [11] http://www.scmmicro.com/security/SCR331-DI.html
540 rousseau 677 [12] http://www.silitek.com/prod/getProduct.do?xml_id=4_2&menu_id=4_2_8&cid=1_8_5
541 rousseau 709 [13] http://www.c3po.es/ltc32.html
542     [14] http://www.c3po.es/tltc2usb.html
543     [15] http://www.scmmicro.com/security/SCR333.html
544 rousseau 1778 [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers
545 rousseau 1314 [17] http://www.scmmicro.com/support/pcs_product_drivers.html
546 rousseau 1317 [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm
547 rousseau 1326 [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
548     [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php
549 rousseau 1394 [21] http://www.kobil.com/d/products/smartcard/kaansim3.php
550     [22] http://www.kobil.com/e/products/index.php?s=midentity
551 rousseau 1508 [23] http://www.ntt.com/jpki/SCR331DI.html
552 rousseau 1521 [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/
553 rousseau 1546 [25] http://www.eutron.com/simpocket.asp
554     [26] http://www.cryptoidentity.eutron.com/eng/home.asp
555 rousseau 1626 [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm
556 rousseau 1730 [28] http://www.ntt.com/jpki/scr3310.html
557 rousseau 1776 [29] http://www.asedrive.com/product.asp?pid=1
558 rousseau 1788 [30] http://www.scmmicro.com/security/SCR3310.html
559 rousseau 1789 [31] http://scmmicro.com/security/SCR3311.html
560     [31] http://scmmicro.com/security/SCR3320.html
561 rousseau 1833 [32] http://www.smartepad.com.br/
562 rousseau 2173 [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37
563 rousseau 1864 [34] http://www.scmmicro.com/security/SCR3340.html
564 rousseau 1883 [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
565 rousseau 2163 [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29
566     [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33
567 rousseau 1945 [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
568 rousseau 1951 [39] http://www.scmmicro.com/security/SDI_010.html
569 rousseau 1968 [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
570 rousseau 1969 [41] http://www.gemplus.com/products/gempc_card/
571 rousseau 2000 [42] http://www.asedrive.com/product.asp?pid=2
572 rousseau 2173 [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31
573 rousseau 2037 [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
574 rousseau 2100 [45] http://www.id3semiconductors.com/produits/cl1356D.htm
575 rousseau 2101 [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
576 rousseau 2131 [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
577 rousseau 2133 [48] http://www.id3semiconductors.com/produits/cl1356T.htm
578 rousseau 2163 [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48
579 rousseau 2172 [50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf
580 rousseau 2174 [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39
581 rousseau 2222 [52] http://www.teobyxiring.com/
582 rousseau 2484 [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html
583     [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html
584 rousseau 2509 [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50
585 rousseau 2607 [56] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=41
586 rousseau 2610 [57] http://www.gi-de.com/portal/page?_pageid=42,126834&_dad=portal&_schema=PORTAL
587 rousseau 2671 [58] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=26&IDFamiglia=3
588 rousseau 2674 [59] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=62&IDFamiglia=39
589 rousseau 269
590     $Id$
591    
592     vim:ts=20

Properties

Name Value
svn:eol-style native
svn:keywords Author Date Id Revision

  ViewVC Help
Powered by ViewVC 1.1.5