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