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

Contents of /trunk/Drivers/ccid/README

Parent Directory Parent Directory | Revision Log Revision Log


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

Properties

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

  ViewVC Help
Powered by ViewVC 1.1.5