README.md

   1 USB CCID IFD Handler
   2 ====================
   3
   4 This package provides the source code for a generic USB CCID (Chip/Smart
   5 Card Interface Devices) and ICCD (Integrated Circuit(s) Card Devices)
   6 driver. See the USB CCID [1] and ICCD [2] specifications from the USB
   7 working group.
   8
   9 * [1] https://www.usb.org/sites/default/files/DWG_Smart-Card_CCID_Rev110.pdf
  10 * [2] https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
  11
  12 Authors:
  13 ========
  14
  15 - Ludovic Rousseau <ludovic.rousseau@free.fr>
  16 - Carlos Prados for the PPS and ATR parsing code (taken from his
  17   towitoto driver) in towitoko/ directory.
  18 - Olaf Kirch for the T=1 TPDU code (from the OpenCT package) in openct/
  19   directory. I (Ludovic Rousseau) greatly improved this code.
  20
  21
  22 CCID and ICCD readers:
  23 ======================
  24
  25 A reader can be in one of these list:
  26 - supported
  27     See https://ccid.apdu.fr/ccid/supported.html
  28 - should work
  29     See https://ccid.apdu.fr/ccid/shouldwork.html
  30 - unsupported
  31     See https://ccid.apdu.fr/ccid/unsupported.html
  32 - disabled
  33     See https://ccid.apdu.fr/ccid/disabled.html
  34
  35
  36 Supported operating systems:
  37 ============================
  38
  39 - GNU/Linux (libusb 1.0)
  40 - MacOS X/Darwin (libusb 1.0)
  41
  42 See also https://ccid.apdu.fr/ for more information.
  43
  44
  45 Debug informations:
  46 ===================
  47
  48 The driver uses the debug function provided by pcscd. So if pcscd sends
  49 its debug to stdout (`pcscd --foreground`) then the CCID driver will also
  50 send its debug to stdout. If pcscd sends its debug to syslog (by
  51 default) then the CCID driver will also send its debug to syslog.
  52
  53 You can change the debug level using the `Info.plist` configuration file.
  54 The `Info.plist` file is installed, by default, in
  55 `/usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist`
  56 or set the environment variable `LIBCCID_ifdLogLevel`.
  57
  58 The debug level is set in the `ifdLogLevel` field. It is a binary OR
  59 combination of 4 different levels.
  60 - 1: critical: important error messages
  61 - 2: info:     informative messages like what reader was detected
  62 - 4: comm:     a dump of all the bytes exchanged between the host and the
  63                reader
  64 - 8: periodic: periodic info when pcscd test if a card is present (every
  65                1/10 of a second)
  66
  67 By default the debug level is set to 3 (1 + 2) and correspond to the
  68 critical and info levels.
  69
  70 You have to restart the driver so it reads the configuration file again
  71 and use the new debug level value.  To restart the driver you just need
  72 to unplug all your CCID readers so the driver is unloaded and then replug
  73 your readers. You can also restart pcscd.
  74
  75
  76 Voltage selection
  77 =================
  78
  79 You can change the voltage level using the `Info.plist` configuration
  80 file.  The `Info.plist` is installed, by default, in
  81 `/usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist`
  82
  83 The voltage level is set in the `ifdDriverOptions` field. It is a binary OR
  84 combination of 4 different levels.
  85
  86 -  0: power on the card at 5V (default value)
  87 - 16: power on the card at 3V and, if 3V fails then use 5V
  88 - 32: power on the card at 1.8V, then 3V and then 5V
  89 - 48: let the reader decide
  90
  91 By default the voltage level is set to 0 and corresponds to 5V.
  92
  93 You have to restart the driver so it reads the configuration file again
  94 and use the new voltage level value.  To restart the driver you just need
  95 to unplug all your CCID readers so the driver is unloaded and then replug
  96 your readers.  You can also restart pcscd.
  97
  98
  99 Licence:
 100 ========
 101
 102   This library is free software; you can redistribute it and/or modify it
 103 under the terms of the GNU Lesser General Public License as published by
 104 the Free Software Foundation; either version 2.1 of the License, or (at
 105 your option) any later version.
 106
 107   This library is distributed in the hope that it will be useful, but
 108 WITHOUT ANY WARRANTY; without even the implied warranty of
 109 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
 110 General Public License for more details.
 111
 112   You should have received a copy of the GNU Lesser General Public License
 113 along with this library; if not, write to the Free Software Foundation,
 114 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 115
 116
 117 History:
 118 ========
 119
 120 1.4.33 - 25 June 2020, Ludovic Rousseau
 121    - Add support of
 122      - Genesys Logic CCID Card Reader (idProduct: 0x0771)
 123      - Swissbit Secure USB PU-50n SE/PE
 124      - TOPPAN FORMS CO.,LTD TC63CUT021
 125    - add --enable-oslog argument for macOS
 126      use os_log(3) for macOS >= 10.12 (Sierra)
 127    - Update PCSC submodule to get Unicode support
 128    - Some minor improvements
 129
 130
 131 1.4.32 - 22 April 2020, Ludovic Rousseau
 132    - Add support of
 133      - AF Care One (idProduct: 0xAFC0)
 134      - AF Care One (idProduct: 0xAFC1)
 135      - AF Care Two (idProduct: 0xAFC2)
 136      - AF Care Two (idProduct: 0xAFC3)
 137      - Access IS ATR210
 138      - Access IS ATR220
 139      - Cherry GmbH CHERRY SECURE BOARD 1.0
 140      - Doctolib SR with idProduct: 0xAFD0
 141      - Doctolib SR with idProduct: 0xAFD1
 142      - Doctolib SR with idProduct: 0xAFD2
 143      - Doctolib SR with idProduct: 0xAFD3
 144      - F-Secure Foundry USB Armory Mk II
 145      - Gemalto RF CR5400
 146      - Ledger Nano X support
 147      - Purism, SPC Librem Key
 148      - SPECINFOSYSTEMS DIAMOND HSM
 149      - SPECINFOSYSTEMS DIAMOND PLUS token
 150      - SPECINFOSYSTEMS DIAMOND PRO token
 151      - SpringCard E518 (idProduct: 0x6112)
 152      - SpringCard E518 (idProduct: 0x611A)
 153      - SpringCard H518 (idProduct: 0x6122)
 154      - SpringCard H518 (idProduct: 0x612A)
 155      - SpringCard Puck
 156      - SpringCard Puck (dProduct: 0x613A)
 157      - SpringCard SpringCore (idProduct: 0x6012)
 158      - SpringCard SpringCore (idProduct: 0x601A)
 159      - Sysking MII136C
 160    - Add SCardGetAttrib(.., SCARD_ATTR_CHANNEL_ID, ..) for USB devices
 161    - Increase the timeout used to detect the Identiv uTrust 3700/3701 F readers
 162    - Fix PowerOn bug for ICCD type A & B devices
 163    - Fix "Bus Error" on SPARC64 CPU and Solaris C compiler
 164    - Cherry KC 1000 SC
 165      - Add support of min & max PIN size
 166      - Fix a bNumberMessage issue
 167    - Add support of min & max PIN size for the Omnikey 3821
 168    - Disable pinpad for Chicony HP Skylab USB Smartcard Keyboard
 169    - Some minor improvements
 170
 171
 172 1.4.31 - 10 August 2019, Ludovic Rousseau
 173    - Add support of
 174      - ACS ACR1252 Reader
 175      - Aladdin R.D. JaCartaReader
 176      - Alcor Link AK9563
 177      - AvestUA AvestKey
 178      - Avtor SecureToken (idProduct: 0x0020)
 179      - Bit4id TokenME EVO v2
 180      - Bit4id miniLector AIR EVO
 181      - Bit4id miniLector Blue
 182      - Broadcom Corp 58200 (idProduct: 0x5843)
 183      - Broadcom Corp 58200 (idProduct: 0x5844)
 184      - Broadcom Corp 58200 (idProduct: 0x5845)
 185      - Certgate GmbH ONEKEY ID 2 USB
 186      - HID Global Crescendo Key 0x0028
 187      - HID Global Crescendo Key 0x0029
 188      - HID Global Crescendo Key 0x002B
 189      - HID Global Crescendo Key 0x002D
 190      - Identiv SCR3500 C Contact Reader
 191      - InfoCert WirelessKey
 192      - NXP PN7462AU CCID
 193      - Route1 MobiKEY Fusion3
 194      - SPECINFOSYSTEMS DIAMOND token
 195    - MacOSX/configure: fix checking error for dynamic library libusb
 196    - Some minor improvements for debug
 197
 198
 199 1.4.30 - 19 September 2018, Ludovic Rousseau
 200    - The project moved to https://ccid.apdu.fr/
 201    - Add support of
 202      - ACS ACR33 ICC Reader
 203      - BIFIT ANGARA
 204      - Broadcom Corp 58200
 205      - Certgate GmbH AirID 2 USB
 206      - DC.Ltd DC4 5CCID READER
 207      - Genesys Logic CCID Card Reader
 208      - Genesys Logic Combo Card Reader
 209      - InfoThink IT-500U Reader
 210      - Spyrus Inc WorkSafe Pro (ProductID 0x3117)
 211    - Disabled readers
 212      - REINER SCT cyberJack RFID standard
 213    - Update reader names for
 214      - Fujitsu Keyboard KB100 SCR
 215      - Fujitsu Keyboard KB100 SCR eSIG
 216      - FujitsuTechnologySolutions GmbH Keyboard KB SCR2
 217      - Yubico YubiKey CCID
 218      - Yubico YubiKey FIDO+CCID
 219      - Yubico YubiKey OTP+CCID
 220      - Yubico YubiKey OTP+FIDO+CCID
 221    - Fix libusb config descriptor leak
 222    - Fix leaking an allocated bundle in case no matching reader was found
 223
 224
 225 1.4.29 - 21 February 2018, Ludovic Rousseau
 226    - Add support of
 227      - Access IS NFC Smart Module (With idProduct 0x0164)
 228      - Bit4id Digital-DNA Key
 229      - Bit4id Digital-DNA Key BT
 230      - Bluink Ltd. Bluink CCID
 231      - Chicony HP Skylab USB Smartcard Keyboard
 232      - HID Global OMNIKEY 5023 Smart Card Reader
 233      - HID Global OMNIKEY 5027CK CCID CONFIG IF
 234      - KeyXentic Inc. KX906 Smart Card Reader
 235      - Spyrus Inc Rosetta USB
 236      - Spyrus Inc WorkSafe Pro
 237      - Watchdata USB Key (idProduct: 0x0418)
 238    - The C3PO LTC31 v2 wrongly declares PIN support
 239    - Remove extra EGT patch because if has bad side effects
 240
 241
 242 1.4.28 - 11 October 2017, Ludovic Rousseau
 243    - Add support of
 244      - Athena IDProtect Flash
 245      - Elatec TWN4/B1.06/CPF3.05/S1SC1.32/P (Beta 3)
 246      - HID Global OMNIKEY 5122 Dual
 247      - HID Global OMNIKEY 5122 Smartcard Reader
 248      - IIT E.Key Crystal-1
 249      - KRONEGGER Micro Core Platform
 250      - KRONEGGER NFC blue Reader Platform
 251      - Ledger Nano S
 252      - REINER SCT cyberJack RFID standard
 253      - REINER SCT cyberJack one
 254      - SAFETRUST SABRE SCR
 255      - SafeNet eToken 5300
 256      - Unicept GmbH AirID USB Dongle
 257      - Watchdata USB Key
 258      - mCore SCard-Reader
 259    - Disabled readers
 260      - Jinmuyu Electronics Co., Ltd. MR800
 261    - Fix non-pinpad HID global devices
 262    - udev rules:
 263      - allow rule overwrite
 264      - Disable USB autosuspend on C3PO LTC31 v1 reader
 265    - Some minor improvements
 266
 267
 268 1.4.27 - 21 May 2017, Ludovic Rousseau
 269    - Add support of
 270      - ACS ACR1255U-J1
 271      - ACS CryptoMate (T2)
 272      - ANCUD CCID USB Reader & RNG
 273      - DUALi DE-620 Combi
 274      - FT CCID
 275      - FT CCID KB
 276      - FT U2F CCID KB
 277      - FT U2F CCID KBOARD
 278      - HID Global OMNIKEY 5422 Smartcard Reader
 279      - InfoThink IT-102MU Reader
 280      - Kapsch TrafficCom USB SAM reader
 281      - MK Technology KeyPass S1
 282      - Mulann PVT
 283      - Regula RFID Reader
 284      - Spyrus Inc PocketVault P-3X
 285      - Unicept GmbH AirID USB
 286    - Add Microchip SEC1210 UART support (when connected on a serial port)
 287    - Add Zero Length Packet (ZLP) support for Gemalto IDBridge CT30 and K30
 288       enable the patch using ./configure --enable-zlp
 289    - Add support of HID Omnikey 5422 as multi slot reader (for macOS)
 290    - Escape command: signals buffer overflow instead of silently
 291       truncating the buffer
 292    - Fix a bug with multi readers and pcscd uses hotplug_libusb (not the
 293       recommended configuration)
 294    - Some minor improvements
 295
 296
 297 1.4.26 - 7 January 2017, Ludovic Rousseau
 298    - Add support of
 299      - Bit4id Digital DNA Key
 300      - Bit4id tokenME FIPS v3
 301      - INGENICO Leo
 302      - appidkey GmbH ID60-USB
 303    - PowerOn: the default algorithm is now 5V then 1.8V then 3V then fail.
 304       It is still possible to change the initial voltage in the
 305       Info.plist file.  Now, in any case, all the values are tried
 306       before failing.
 307    - Negotiate maximum baud rate when bNumDataRatesSupported = 0
 308    - Some minor improvements
 309
 310
 311 1.4.25 - 30 September 2016, Ludovic Rousseau
 312    - Add support of
 313      - Aladdin R.D. JaCarta (idProduct: 0x0402)
 314      - Broadcom Corp 5880 (idProduct: 0x5832)
 315      - Broadcom Corp 5880 (idProduct: 0x5833)
 316      - Broadcom Corp 5880 (idProduct: 0x5834)
 317      - ESMART Token GOST X2 ET1020-A
 318      - Feitian VR504 VHBR Contactless & Contact Card Reader
 319      - Feitian bR500
 320      - Gemalto K50
 321      - appidkey GmbH ID100-USB  SC Reader
 322      - appidkey GmbH ID50 -USB
 323    - Remove suport of
 324      - Broadcom Corp 5880 (idProduct: 0x5800)
 325      - Broadcom Corp 5880 (idProduct: 0x5805)
 326      - KEBTechnology KONA USB SmartCard
 327    - macOS: Fix composite device enumeration
 328    - Fix crash with GemCore Pos Pro and GemCore Sim Pro
 329    - Some minor improvements
 330
 331
 332 1.4.24 - 22 May 2016, Ludovic Rousseau
 333    - Add support of
 334      - Generic USB Smart Card Reader
 335      - Giesecke & Devrient GmbH StarSign CUT S
 336      - HID AVIATOR Generic
 337    - better support of Elatec TWN4 SmartCard NFC
 338    - better support of SCM SCL011
 339    - betetr support of HID Aviator generic
 340    - fix SCARD_ATTR_VENDOR_IFD_SERIAL_NO attribute size
 341    - fix a race condition on card events with multiple readers
 342    - Some minor improvements
 343
 344
 345 1.4.23 - 20 April 2016, Ludovic Rousseau
 346    - Add support of
 347      - ACS ACR3901U ICC Reader
 348      - Alcor Micro AU9560
 349      - Cherry SmartTerminal XX44
 350      - HID Global OMNIKEY 3x21 Smart Card Reader
 351      - HID Global OMNIKEY 5022 Smart Card Reader
 352      - HID Global OMNIKEY 6121 Smart Card Reader
 353      - IonIDe Smartcard Reader reader
 354      - KACST HSID Reader
 355      - KACST HSID Reader Dual Storage
 356      - KACST HSID Reader Single Storage
 357    - Remove support of
 358      - VMware Virtual USB CCID
 359    - Do NOT add support of
 360      - DUALi DE-ABCM6
 361    - Fix a busy loop consuming 100% of CPU for some composite USB devices
 362       impacted readers: Yubico Yubikey NEO U2F+CCID and Broadcom BCM5880
 363    - Remove support of (unused) option DRIVER_OPTION_RESET_ON_CLOSE
 364    - log libusb error name instead of decimal value
 365    - Some minor improvements
 366
 367
 368 1.4.22 - 10 January 2016, Ludovic Rousseau
 369    - Add support of
 370      - Aktiv Rutoken PINPad 2
 371      - Aladdin R.D. JC-WebPass (JC600)
 372      - Aladdin R.D. JCR-770
 373      - Aladdin R.D. JaCarta
 374      - Aladdin R.D. JaCarta Flash
 375      - Aladdin R.D. JaCarta LT
 376      - Aladdin R.D. JaCarta U2F (JC602)
 377      - Athena ASEDrive IIIe Combo Bio PIV
 378      - Athena ASEDrive IIIe KB Bio PIV
 379      - GEMALTO CT1100
 380      - GEMALTO K1100
 381      - Hitachi, Ltd. Hitachi Biometric Reader
 382      - Hitachi, Ltd. Hitachi Portable Biometric Reader
 383      - Nitrokey Nitrokey Storage
 384      - THURSBY SOFTWARE TSS-PK1
 385      - Thursby Software Systems, Inc. TSS-PK7
 386      - Thursby Software Systems, Inc. TSS-PK8
 387    - Patch for Microchip SEC1110 reader on Mac OS X (card events notification)
 388    - Patch for Cherry KC 1000 SC (problem was with a T=1 card and case 2 APDU)
 389    - Fix support of FEATURE_MCT_READER_DIRECT for the Kobil mIDentity
 390       visual reader
 391    - Set timeout to 90 sec for PPDU (Pseudo APDU) commands. This change
 392       allows the use of a Secure Verify command sent as a PPDU through
 393       SCardTransmit().
 394    - Fix a crash when reader reader initialization failed
 395    - Fix initialization bug with Gemalto Pinpad reader on Mac OS X
 396    - Some minor bugs fixed
 397
 398
 399 1.4.21 - 21 October 2015, Ludovic Rousseau
 400    - Add support of
 401      - ACS ACR1252 Dual Reader
 402      - Chicony HP USB Smartcard CCID Keyboard JP
 403      - Chicony HP USB Smartcard CCID Keyboard KR
 404      - FT ePass2003Auto
 405      - Feitian bR301 BLE
 406      - Feitian iR301 (ProductID 0x0619)
 407      - Feitian iR301 (ProductID 0x061C)
 408      - Identiv @MAXX ID-1 Smart Card Reader
 409      - Identiv @MAXX Light2 token
 410      - Identiv CLOUD 2980 F Smart Card Reader
 411      - Identiv Identiv uTrust 4701 F Dual Interface Reader
 412      - Identiv SCR3500 A Contact Reader
 413      - Identiv SCR3500 B Contact Reader
 414      - Identiv SCR35xx USB Smart Card Reader
 415      - Identiv uTrust 2900 R Smart Card Reader
 416      - Identiv uTrust 2910 R Smart Card Reader
 417      - Identiv uTrust 2910 R Taglio SC Reader
 418      - Identiv uTrust 3512 SAM slot Token
 419      - Identiv uTrust 3522 embd SE RFID Token
 420      - Identiv uTrust 3700 F CL Reader
 421      - Identiv uTrust 3701 F CL Reader
 422      - Identive Identive CLOUD 4000 F DTC
 423      - Liteon HP SC Keyboard - Apollo (Liteon)
 424      - Liteon HP SC Keyboard - Apollo JP (Liteon)
 425      - Liteon HP SC Keyboard - Apollo KR (Liteon)
 426      - Nitrokey Nitrokey HSM
 427      - Nitrokey Nitrokey Pro
 428      - Nitrokey Nitrokey Start
 429      - Rocketek RT-SCR1
 430      - VASCO DIGIPASS 875
 431      - WatchCNPC USB CCID Key
 432    - Remove support of
 433      - Crypto Stick Crypto Stick v1.4 is an old version of Nitrokey Nitrokey Pro
 434      - Free Software Initiative of Japan Gnuk Token is an old version
 435         of Nitrokey Nitrokey Start
 436    - Add Feitain R502 dual interface (composite) reader on Mac OS X
 437    - display a human readable version of the error code returned by
 438       libusb
 439    - Mac OS X: wait until libusb/the reader is ready
 440    - some minor bugs fixed
 441
 442
 443 1.4.20 - 5 August 2015, Ludovic Rousseau
 444    - Add support of
 445      - ACS ACR1251 Dual Reader
 446      - Access IS NFC Smart Module
 447      - BIFIT iToken
 448      - BLUTRONICS BLUDRIVE II CCID (idProduct: 0x1079)
 449      - Generic MultiCard Device
 450      - NXP Pegoda 2 N
 451      - SafeNet eToken 5100
 452      - SafeNet eToken 7300
 453      - Yubico Yubikey 4 CCID
 454      - Yubico Yubikey 4 OTP+CCID
 455      - Yubico Yubikey 4 OTP+U2F+CCID
 456      - Yubico Yubikey 4 U2F+CCID
 457    - Depends on libusb version 1.0.9 instead of 1.0.8
 458    - The O2 Micro Oz776 reader only supports 9600 bps
 459    - Change installation directory for Mac OS X El Capitan 10.11
 460
 461
 462 1.4.19 - 13 May 2014, Ludovic Rousseau
 463    - Add support of
 464      - AK910 CKey (idProduct 0x0001)
 465      - AK910 CKey (idProduct 0x0011)
 466      - AK910 IDONE
 467      - Broadcom Corp 5880 (idProduct: 0x5804)
 468      - CASTLES EZCCID Smart Card Reader
 469      - Cherry KC 1000 SC
 470      - Cherry KC 1000 SC Z
 471      - Cherry KC 1000 SC/DI
 472      - Cherry KC 1000 SC/DI Z
 473      - Cherry TC 1300
 474      - Chicony USB Smart Card Keyboard
 475      - Elatec TWN4 SmartCard NFC
 476      - Feitian 502-CL
 477      - Feitian eJAVA Token
 478      - FujitsuTechnologySolutions GmbH Keyboard KB100 SCR
 479      - FujitsuTechnologySolutions GmbH Keyboard KB100 SCR eSIG
 480      - Hewlett-Packard HP lt4112 Gobi 4G Module
 481      - Identive SCT3522CC token
 482      - OMNIKEY AG 6121 USB mobile
 483      - PIVKey T800
 484      - REINER SCT tanJack Bluetooth
 485      - Watchdata USB Key
 486    - Add syslog(3) debug for Mac OS X Yosemite.
 487       Use: sudo syslog -c "com.apple.ifdreader PID" -d to change the logging level.
 488       See also "Change syslog logging level on Yosemite"
 489       http://ludovicrousseau.blogspot.com/2015/03/change-syslog-logging-level-on-yosemite.html
 490    - Remove ZLP patch for Gemalto IDBridge CT30 and K30. The patch was
 491       causing problems with the K50.  A new reader firmware (version F)
 492       solved the problem so the patch is no more needed.
 493    - Fix a memory leak in an error path
 494    - some minor bugs removed
 495
 496
 497 1.4.18 - 13 September 2014, Ludovic Rousseau
 498    - Add support of
 499      - Cherry Cherry TC 1100
 500      - Cherry Smart Card Reader USB
 501      - Cherry Smartcard Keyboard G87-1xx44
 502      - FujitsuTechnologySolutions GmbH Keyboard KB SCR2
 503      - Lenovo Lenovo USB Smartcard Keyboard
 504      - Yubico Yubikey NEO OTP+U2F+CCID
 505      - Yubico Yubikey NEO U2F+CCID
 506      - eID_R6 001 X8
 507    - fix support of Omnikey CardMan 3121
 508    - reduce memory consumed when configured with --enable-embedded
 509    - prepare the port to UEFI
 510
 511
 512 1.4.17 - 11 June 2014, Ludovic Rousseau
 513    - Add support of
 514      - Feitian R502
 515      - Free Software Initiative of Japan Gnuk Token
 516      - German Privacy Foundation Crypto Stick v2.0
 517      - HID Global veriCLASS Reader
 518      - HID OMNIKEY 5025-CL
 519      - Identive Technologies Multi-ISO HF Reader - USB
 520      - OMNIKEY 5421
 521      - OMNIKEY AG 3121 USB
 522      - udea MILKO V1.
 523    - Fix support of O2 Micro Oz776. The reader is limited to 9600 bps
 524    - some minor bugs removed
 525
 526
 527 1.4.16 - 23 March 2014, Ludovic Rousseau
 528    - Add support of
 529      - Crypto Stick Crypto Stick v1.4
 530      - Hewlett Packard USB Smartcard CCID Keyboard
 531      - IID AT90S064 CCID READER
 532      - INSIDE Secure VaultIC 405 Smart Object
 533      - INSIDE Secure VaultIC 441 Smart Object
 534      - Microchip SEC1110
 535      - Microchip SEC1210
 536      - Watchdata W5181
 537    - Add support of DRIVER_OPTION_DISABLE_PIN_RETRIES
 538       The Gemalto pinpad reader sends a VERIFY command with no PIN value
 539       in order to retreive the remaining retries from the card.  Some
 540       cards (like the OpenPGP card) do not support this.
 541       It is now possible to disable this behavior from the Gemalto
 542       Pinpad and Covadis Véga Alpha.
 543    - add support of WTX received before SW during Secure Pin Entry Verify
 544       The Swiss health care card sends a WTX request before returning
 545       the SW code. If the reader is in TPDU and the card is in T=1 the
 546       driver must manage the request itself.
 547
 548
 549 1.4.15 - 14 February 2014, Ludovic Rousseau
 550    - Add support of
 551      - DUALi DRAGON NFC READER
 552      - Feitian bR301
 553      - Gemalto CR30 reader in serial communication
 554      - Gemalto Ezio Shield Pro SC
 555      - IIT E.Key Almaz-1C
 556    - PIN_MODIFY_STRUCTURE & PIN_VERIFY_STRUCTURE: Fix calculation of
 557       the command length after pcsc-lite 1.8.9 (October 2013) changed
 558       the PCSC/reader.h header
 559    - Add specific PIN min (0) & max (25) sizes for SmartTerminal
 560       ST-2xxx
 561    - Do not get the data rates if bNumDataRatesSupported = 0
 562    - Support Gemalto features for pinpad readers MinimumPINSize,
 563       MaximumPINSize and bEntryValidationCondition are fetched from the
 564       reader firmware
 565    - disable (broken) pinpad for Fujitsu SmartCase KB SCR eSIG
 566    - examples/scardcontrol.c:
 567      - Parse codes returned by a pinpad (as SW1/SW2)
 568         Known codes for now are:
 569         0x9000: Success
 570         0x6400: Timeout
 571         0x6401: Cancelled by user
 572         0x6402: PIN mismatch
 573         0x6403: Too short or too long PIN
 574      - Retrieve min and max PIN sizes from the driver
 575      - Retrieve bEntryValidationCondition from the driver
 576    - be more strict for bInterfaceClass = 255 by also checking extra_length
 577    - some minor bugs removed
 578
 579
 580 1.4.14 - 25 November 2013, Ludovic Rousseau
 581    - Add support of
 582      - Gemalto GemCore SIM Pro firmware 2.0 (using USB)
 583    - report FEATURE_IFD_PIN_PROPERTIES only for pinpad readers
 584    - Generalize the management of (old) readers with bDeviceClass = 0xFF
 585    - some minor bugs removed
 586
 587
 588 1.4.13 - 9 October 2013, Ludovic Rousseau
 589    - Add support of
 590      - Access IS ePassport Reader
 591      - Planeta RC700-NFC CCID
 592    - Add support of Windows value for CM_IOCTL_GET_FEATURE_REQUEST
 593       Windows uses 0x313520 for SCARD_CTL_CODE(3400) pcsc-lite uses
 594       0x42000D48 for SCARD_CTL_CODE(3400)
 595       RDP aplications (like rdesktop) will convert SCardControl()
 596       commands from a Windows application (so using 0x313520) to
 597       pcsc-lite.
 598    - fix multi-slot support for card movement notification (introduced
 599       in 1.4.12)
 600    - Mac OS X: differentiate each libccid library by the dynamic linker
 601       using --prefix=/fake/$BUNDLE_ID
 602    - some minor bugs removed
 603
 604
 605 1.4.12 - 12 August 2013, Ludovic Rousseau
 606    - Add support of
 607      - HID OMNIKEY 5127 CK
 608      - HID OMNIKEY 5326 DFR
 609      - HID OMNIKEY 5427 CK
 610      - Ingenico WITEO USB Smart Card Reader (Base and Badge)
 611      - SecuTech SecuTech Token
 612    - Add support of card movement notifications for multi-slot readers
 613    - Check libusb is at least at version 1.0.8
 614    - Get the serialconfdir value from pcsc-lite pkg config instead of
 615       using $(DESTDIR)/$(sysconfdir)/reader.conf.d/
 616    - Disable class driver on Mac OS X
 617    - Update the bundle name template to include the vendor name
 618    - some minor bugs removed
 619
 620
 621 1.4.11 - 12 June 2013, Ludovic Rousseau
 622    - Add support of
 623        . Gemalto IDBridge CT30
 624        . Gemalto IDBridge K30
 625        . SCM Microsystems Inc. SCL010 Contactless Reader
 626        . SCM Microsystems Inc. SDI011 Contactless Reader
 627        . THRC reader
 628    - Better management of time extension requests
 629    - parse: better support of devices with bInterfaceClass = 0xFF
 630    - udev rule file: Remove setting group to pcscd, remove support of
 631       Linux kernel < 2.6.35 for auto power up management
 632    - some minor bugs removed
 633
 634
 635 1.4.10 - 16 April 2013, Ludovic Rousseau
 636    - Add support of
 637        . ACS APG8201 USB Reader with PID 0x8202
 638        . GIS Ltd SmartMouse USB
 639        . Gemalto IDBridge K3000
 640        . Identive CLOUD 2700 F Smart Card Reader
 641        . Identive CLOUD 2700 R Smart Card Reader
 642        . Identive CLOUD 4500 F Dual Interface Reader
 643        . Identive CLOUD 4510 F Contactless + SAM Reader
 644        . Identive CLOUD 4700 F Dual Interface Reader
 645        . Identive CLOUD 4710 F Contactless + SAM Reader
 646        . Inside Secure AT90SCR050
 647        . Inside Secure AT90SCR100
 648        . Inside Secure AT90SCR200
 649        . SCR3310-NTTCom USB SmartCard Reader
 650        . SafeTech SafeTouch
 651        . SpringCard H512 Series
 652        . SpringCard H663 Series
 653        . SpringCard NFC'Roll
 654        . Yubico Yubikey NEO CCID
 655        . Yubico Yubikey NEO OTP+CCID
 656    - Add support of time extension for Escape commands
 657
 658
 659 1.4.9 - 16 January 2013, Ludovic Rousseau
 660    - Add support of
 661        . Aktiv Rutoken PINPad In
 662        . Aktiv Rutoken PINPad Ex
 663        . REINER SCT cyberJack go
 664    - Info.plist: Correctly handle reader names containing &
 665
 666
 667 1.4.8 - 22 June 2012, Ludovic Rousseau
 668    - Add support of
 669        . SCR3310-NTTCom USB (was removed in version 1.4.6)
 670        . Inside Secure VaultIC 420 Smart Object
 671        . Inside Secure VaultIC 440 Smart Object
 672    - Wait up to 3 seconds for reader start up
 673    - Add support of new PC/SC V2 part 10 properties:
 674         . dwMaxAPDUDataSize
 675         . wIdVendor
 676         . wIdProduct
 677    - Use helper functions from libPCSCv2part10 to parse the PC/SC v2
 678       part 10 features
 679
 680
 681 1.4.7 - 22 June 2012, Ludovic Rousseau
 682    - Add support of
 683        . ACS ACR101 ICC Reader
 684        . ACS CryptoMate64
 685        . Alcor Micro AU9522
 686        . Bit4id CKey4
 687        . Bit4id cryptokey
 688        . Bit4id iAM
 689        . Bit4id miniLector
 690        . Bit4id miniLector-s
 691        . CCB eSafeLD
 692        . Gemalto Ezio Shield Branch
 693        . KOBIL Systems IDToken
 694        . NXP PR533
 695    - KOBIL Systems IDToken special cases:
 696        . Give more time (3 seconds instead of 2) to the reader to answer
 697        . Hack for the Kobil IDToken and Geman eID card. The German eID
 698          card is bogus and need to be powered off before a power on
 699        . Add Reader-Info-Commands special APDU/command
 700          - Manufacturer command
 701          - Product name command
 702          - Firmware version command
 703          - Driver version command
 704    - Use auto suspend for CCID devices only (Closes Alioth bug
 705       [#313445] "Do not activate USB suspend for composite devices:
 706       keyboard")
 707    - Fix some error management in the T=1 TPDU state machine
 708    - some minor bugs removed
 709    - some minor improvements added
 710
 711
 712 1.4.6 - 6 April 2012, Ludovic Rousseau
 713    - Add support of
 714        . Avtor SC Reader 371
 715        . Avtor SecureToken
 716        . DIGIPASS KEY 202
 717        . Fujitsu SmartCase KB SCR eSIG
 718        . Giesecke & Devrient StarSign CUT
 719        . Inside Secure VaultIC 460 Smart Object
 720        . Macally NFC CCID eNetPad reader
 721        . OmniKey 6321 USB
 722        . SCM SDI 011
 723        . Teridian TSC12xxF
 724        . Vasco DIGIPASS KEY 101
 725    - Remove support of readers without a USB CCID descriptor file
 726        . 0x08E6:0x34C1:Gemalto Ezio Shield Secure Channel
 727        . 0x08E6:0x34C4:Gemalto Ezio Generic
 728        . 0x04E6:0x511A:SCM SCR 3310 NTTCom
 729        . 0x0783:0x0008:C3PO LTC32 USBv2 with keyboard support
 730        . 0x0783:0x9002:C3PO TLTC2USB
 731        . 0x047B:0x020B:Silitek SK-3105
 732    - Disable SPE for HP USB CCID Smartcard Keyboard. The reader is
 733       bogus and unsafe.
 734    - Convert "&" in a reader name into "&amp;" to fix a problem on Mac
 735       OS X
 736    - Fix a problem with ICCD type A devices. We now wait for device ready
 737    - Secure PIN Verify and PIN Modify: set the minimum timeout to 90
 738       seconds
 739    - Add support of wIdVendor and wIdProduct properties
 740    - Add support of dwMaxAPDUDataSize
 741    - Add support of Gemalto firmware features
 742    - some minor bugs removed
 743
 744
 745 1.4.5 - 11 October 2011, Ludovic Rousseau
 746    - Add support of
 747      - Alcor Micro AU9540
 748      - BIFIT USB-Token iBank2key
 749      - BIFIT iBank2Key
 750      - Gemalto Ezio Shield PinPad reader
 751      - Gemalto SA .NET Dual
 752      - Precise Sense MC reader (with fingerprint)
 753      - SDS DOMINO-Key TWIN Pro
 754      - Ubisys 13.56MHz RFID (CCID)
 755    - Add support of bPPDUSupport and FEATURE_CCID_ESC_COMMAND
 756    - SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_VENDOR_IFD_VERSION are not
 757       the vendor name and version of the driver but of the IFD:
 758       InterFace Device i.e. the smart card reader.  We then return the
 759       USB iManufacturer string as SCARD_ATTR_VENDOR_NAME and USB
 760       bcdDevice as SCARD_ATTR_VENDOR_IFD_VERSION
 761    - reduce binary size bu removing unused features from simclist
 762    - Fix some warnings reported bu Coverity
 763
 764
 765 1.4.4 - 13 May 2011, Ludovic Rousseau
 766    - Add support of
 767      - Gemalto Ezio CB+
 768      - Gemalto Ezio Generic
 769      - Gemalto Ezio Shield
 770      - Gemalto Ezio Shield PinPad
 771      - Gemalto Ezio Shield Secure Channel
 772    - Activate USB automatic power suspend. The Linux kernel should
 773       power off the reader automatically if it is not used (pcscd is not
 774       running).
 775    - Add support of TLV Properties wLcdMaxCharacters and wLcdMaxLines.
 776       They just duplicate wLcdLayout
 777    - some minor bugs removed
 778
 779
 780 1.4.3 - 2 April 2011, Ludovic Rousseau
 781    - Add support of
 782      - Feitian ePass2003 readers
 783      - Neowave Weneo
 784      - SCM SCL011
 785      - Vasco DIGIPASS 920
 786    - use :libudev: instead of :libhal: naming scheme.
 787    - Do not install RSA_SecurID_getpasswd and Kobil_mIDentity_switch
 788       and the associated documentation.
 789    - the Secure Pin Entry of the HP USB Smart Card Keyboard is bogus so
 790       disable it
 791    - some minor bugs removed
 792
 793
 794 1.4.2 - 22 February 2011, Ludovic Rousseau
 795    - Add support of
 796      - ACS APG8201 PINhandy 1
 797      - Aktiv Rutoken lite readers
 798      - Feitian SCR310 reader (also known as 301v2)
 799      - Oberthur ID-ONE TOKEN SLIM v2
 800      - Vasco DIGIPASS KEY 200
 801      - Vasco DIGIPASS KEY 860
 802      - Xiring Leo v2
 803      - Xiring MyLeo
 804      - new Neowave Weneo token
 805    - Add back support of "bogus" Oz776, REINER SCT and BLUDRIVE II
 806    - Ease detection of OpenCT by pcsc-lite
 807    - disable use of interrupt card events for multi slots readers (the
 808       algorithm is bogus and can't be used)
 809    - fix minor problems detected by the clang tool
 810    - some minor bugs removed
 811
 812
 813 1.4.1 - 3 December 2010, Ludovic Rousseau
 814    - Add support of
 815      - Akasa AK-CR-03, BZH uKeyCI800-K18
 816      - Free Software Initiative of Japan Gnuk token readers
 817      - Gemalto Smart Guardian (SG CCID)
 818      - ReinerSCT cyberJack RFID basis
 819    - Remove O2 Micro Oz776 and Blutronics Bludrive II CCID since they
 820       are no more supported since version 1.4.0
 821    - SecurePINVerify() & SecurePINModify(): Accept big and little
 822       endian byte orders for multibytes fields. The application
 823       should not use HOST_TO_CCID_16() and HOST_TO_CCID_32() any more
 824       and just use the normal byte order of the architecture.
 825    - Need pcsc-lite 1.6.5 for TAG_IFD_POLLING_THREAD_WITH_TIMEOUT
 826    - Add --enable-embedded (default is no) to build libccid for an
 827       embedded system.  This will activate the NO_LOG option to disable
 828       logging and limit RAM and disk consumption.
 829    - Remove --enable-udev option since it is not used anymore with
 830       libhal. The udev rules file is now used to change the access
 831       rights of the device and not send a hotplug signal to pcscd.
 832       See http://ludovicrousseau.blogspot.com/2010/09/pcscd-auto-start.html
 833    - some minor bugs removed
 834
 835
 836 1.4.0 - 4 August 2010, Ludovic Rousseau
 837    - add support of
 838      - ACS AET65
 839      - Broadcom 5880
 840      - C3PO LTC36
 841      - Dectel CI692
 842      - Gemalto Hybrid Smartcard Reader
 843      - Kingtrust Multi-Reader
 844      - Tianyu Smart Card Reader
 845      - Todos CX00
 846    - Add support of the SCM SDI 010 again. At least the contact
 847       interface can be used.
 848    - Use libusb-1.0 instead of libusb-0.1
 849    - add support of TAG_IFD_STOP_POLLING_THREAD and use of the
 850       asynchronous libusb API to be able to stop a transfer.
 851    - Request pcsc-lite 1.6.2 minimum (instead of 1.6.0) to have
 852       TAG_IFD_STOP_POLLING_THREAD defined
 853    - The O2MICRO OZ776 patch (for OZ776, OZ776_7772, REINER_SCT and
 854       BLUDRIVEII_CCID) is no more supported with libusb-1.0
 855    - correctly get the IFSC from the ATR (ATR parsing was not always
 856       correct)
 857    - some minor bugs removed
 858
 859
 860 1.3.13 - 4 June 2010, Ludovic Rousseau
 861    - much faster warm start (up to 3.8 second gained)
 862    - Add support of SCARD_ATTR_VENDOR_IFD_SERIAL_NO to get the serial
 863       number of the USB device
 864    - some minor bugs removed
 865
 866
 867 1.3.12 - 8 May 2010, Ludovic Rousseau
 868    - add support of
 869      - Ask CPL108
 870      - Atmel AT90SCR050
 871      - Atmel AT90SCR100
 872      - Atmel VaultIC420
 873      - Atmel VaultIC440
 874      - Atmel VaultIC460
 875      - Cherry SmartTerminal XX7X
 876      - Covadis Auriga
 877      - German Privacy Foundation Crypto Stick v1.2
 878      - GoldKey PIV Token
 879      - KOBIL Smart Token
 880      - KOBIL mIDentity 4smart
 881      - KOBIL mIDentity 4smart AES
 882      - KOBIL mIDentity 4smart fullsize AES
 883      - KOBIL mIDentity fullsize
 884      - KOBIL mIDentity visual
 885      - SCM SCR3500
 886      - Smart SBV280
 887      - Todos AGM2 CCID
 888      - Vasco DIGIPASS KEY 200
 889      - Vasco DIGIPASS KEY 860
 890      - Vasco DP855
 891      - Vasco DP865
 892      - id3 CL1356T5
 893    - remove support of Smart SBV280 on manufacturer request. They use
 894       libusb directly.
 895    - remove support of SCM SDI 010 on manufacturer request since not
 896       supported by my driver
 897    - Enable the Broadcom 5880 reader. It should work after a firmware
 898       upgrade.
 899    - better support of Dell keyboard
 900    - better support of multislot readers (like the GemCore SIM Pro)
 901    - better support of SCM SCR3310
 902    - better support of ICCD version A devices
 903    - The Covadis Véga-Alpha reader is a GemPC pinpad inside. So we use
 904       the same code to:
 905      - load the strings for the display
 906      - avoid limitation of the reader
 907    - IFDHControl(): the (proprietary) get firmware version escape
 908       command is allowed with a Gemalto reader
 909      - the (proprietary) switch interface escape command is allowed on
 910       the Gemalto GemProx DU
 911      - return IFD_ERROR_NOT_SUPPORTED instead of
 912       IFD_COMMUNICATION_ERROR if the dwControlCode value is not
 913       supported
 914      - return IFD_ERROR_INSUFFICIENT_BUFFER when appropriate
 915    - IFDHGetCapabilities(): add support of SCARD_ATTR_ICC_PRESENCE and
 916       SCARD_ATTR_ICC_INTERFACE_STATUS
 917    - support FEATURE_GET_TLV_PROPERTIES
 918    - add support of IOCTL_FEATURE_GET_TLV_PROPERTIES bMinPINSize &
 919       bMaxPINSize for Gemalto Pinpad V1 & Covadis Véga-Alpha
 920    - support extended APDU of up to 64kB with APDU readers.
 921    - get the language selected during Mac OS X installation as language
 922       to use for Covadis Véga-Alpha and Gemalto GemPC PinPad pinpad
 923       readers
 924    - FEATURE_MCT_READER_DIRECT is also supported by the Kobil mIDentity
 925       visual
 926    - better support of Sun Studio CC
 927    - some minor bugs removed
 928
 929
 930 1.3.11 - 28 July 2009, Ludovic Rousseau
 931    - add support of
 932      - Raritan D2CIM-DVUSB VM/CCID
 933      - Feitian SCR301
 934      - Softforum XecureHSM
 935      - 2 Neowave Weneo tokens
 936      - Synnix STD200
 937      - Aktiv Rutoken ECP
 938      - Alcor Micro SCR001
 939      - ATMEL AT91SC192192CT-USB
 940      - Panasonic USB Smart Card Reader 7A-Smart
 941      - Gemalto GemProx DU and SU
 942    - remove support of Reiner-SCT cyberJack pinpad(a) on request of
 943       Reiner-SCT.  You should user the Reiner-SCT driver instead
 944    - define CFBundleName to CCIDCLASSDRIVER so that non class drivers
 945       have a higher priority. Used by pcsc-lite 1.5.5 and up.
 946       Add a --disable-class configure option so that the Info.plist does
 947       not define a Class driver. Default is class driver.
 948    - do not power up a card with a voltage not supported by the reader
 949    - add support of PIN_PROPERTIES_STRUCTURE structure and
 950       FEATURE_IFD_PIN_PROPERTIES
 951    - adds support of FEATURE_MCT_READERDIRECT. Only the Kobil TriB@nk
 952       reader supports this feature for now. This is used for the Secoder
 953       functionality in connected mode.
 954    - add support of a composite device. No change needed with libhal.
 955       use --enable-composite-as-multislot on Mac OS X since libhal is
 956       not available on Mac OS X or with libusb on Linux
 957    - some minor bugs removed
 958
 959
 960 1.3.10 - 7 March 2009, Ludovic Rousseau
 961    - add support for
 962      - Aktiv Rutoken Magistra
 963      - Atmel AT98SC032CT
 964      - MSI StarReader SMART
 965      - Noname reader (from Omnikey)
 966      - Precise Biometrics 200 MC and 250 MC
 967      - Realtek 43 in 1 + Sim + Smart Card Reader
 968      - TianYu CCID SmartKey
 969      - Xiring Xi Sign PKI
 970    - add a patch to support the bogus OpenPGP card (on board key
 971       generation sometimes timed out)
 972    - disable support of the contactless part of SDI010 and SCR331DI
 973       (this code was reverse engineered and hard to maintain)
 974    - some minor bugs removed
 975
 976
 977 1.3.9 - 18 November 2008, Ludovic Rousseau
 978    - add support for
 979      - ACS ACR122U PICC
 980      - Aladdin eToken PRO USB 72K Java
 981      - Atmel AT91SO
 982      - CSB6 Basic
 983      - CSB6 Secure
 984      - CSB6 Ultimate
 985      - Cherry SmartTerminal ST-1200USB
 986      - CrazyWriter
 987      - EasyFinger Standard
 988      - EasyFinger Ultimate
 989      - Gemalto PDT
 990      - HP MFP Smart Card Reader
 991      - KONA USB SmartCard
 992      - SpringCard Prox'N'Roll
 993      - VMware Virtual USB CCID
 994    - MacOSX/configure: do not overwrite PCSC_CFLAGS, PCSC_LIBS,
 995       LIBUSB_CFLAGS and LIBUSB_LIBS if already defined by the user
 996    - by default, link statically against libusb on Mac OS X
 997    - IFDHPowerICC(): use a very long timeout for PowerUp since the card
 998       can be very slow to send the full ATR (up to 30 seconds at 4 MHz)
 999    - SecurePINVerify(): correct a bug when using a Case 1 APDU and a
1000       SCM SPR532 reader
1001    - log the reader name instead of just the pcscd Lun
1002    - some minor bugs removed
1003
1004
1005 1.3.8 - 27 June 2008, Ludovic Rousseau
1006    - add support for
1007      - Oberthur ID-One Cosmo Card
1008    - do not include the release number in the Info.plist to avoid a
1009       diff of a configuration file when upgrading the package.
1010    - do not fail compilation if libusb is not available
1011    - do not crash if the reader firmware is bogus and does not support
1012       chaining for extended APDU.  This is the case for Kobil readers
1013    - some minor bugs removed
1014
1015
1016 1.3.7 - 8 June 2008, Ludovic Rousseau
1017    - add support for
1018      - ActivCard Activkey Sim
1019      - Pro-Active CSB6 Ultimate
1020      - id3 Semiconductors CL1356A HID
1021    - src/parse: do not try to parse devices with bInterfaceClass=0xFF
1022       by default (use command line argument -p for proprietary class)
1023    - configure.in: check if libusb-0.1 is emulated by libusb-compat +
1024       libusb-1.0 to use or not the USB interrupt feature
1025    - correct a bug in the serial communication (GemPC twin serial
1026       reader)
1027    - correct a pthread problem under Solaris
1028    - some minor bugs removed
1029
1030
1031 1.3.6 - 30 April 2008, Ludovic Rousseau
1032    - add support for
1033      - Covadis Alya
1034      - Covadis Véga
1035      - Precise Biometrics 250 MC
1036      - Validy TokenA sl vt
1037      - Vasco DP905
1038    - better support for the O2Micro OZ776, GemCore SIM Pro
1039    - the environment variable LIBCCID_ifdLogLevel overwrite the value
1040       of ifdLogLevel read from the Info.plist file
1041    - add support for DragonFly BSD
1042    - some minor bugs removed
1043
1044
1045 1.3.5 - 22 February 2008, Ludovic Rousseau
1046    - add support for Gemplus Gem e-Seal Pro, Cherry SmartBoard,
1047       G83-6610
1048    - use usb_interrupt_read() only if libusb > 0.1.12 or
1049       --enable-usb-interrupt is used. libusb <= 0.1.12 is bogus and will
1050       consume more CPU than needed.
1051    - contrib/Kobil_mIDentity_switch/Kobil_mIDentity_switch was broken
1052       on Linux since release 1.3.1
1053    - some minor bugs removed
1054
1055
1056 1.3.4 - 8 February 2008, Ludovic Rousseau
1057    - the serial driver could not be loaded because of the missing
1058       symbol InterruptRead
1059    - remove WAIT_FOR_SYSFS="bInterfaceProtocol" to do not delay udev
1060
1061
1062 1.3.3 - 6 February 2008, Ludovic Rousseau
1063    - add support for Lexar Smart Enterprise Guardian and Blutronics
1064       Bludrive II CCID
1065    - add support of TAG_IFD_POLLING_THREAD using IFDHPolling() to
1066       detect asynchronous card movements. With this feature pcscd will
1067       not poll the reader every 0.4 second for a card movement but will
1068       wait until the reader sends a USB interrupt signal
1069    - correct a bug with an ICCD-B device and a receive buffer smaller
1070       than 4 bytes
1071    - remove the sleep in the udev rule. It slows down the detection of
1072       any USB device
1073    - some minor bugs removed
1074
1075
1076 1.3.2 - 22 January 2008, Ludovic Rousseau
1077    - add support of Apple Mac OS X Leopard (10.5.1)
1078    - solve a hotplug problem on Ubuntu 7.10 (reader was not detected)
1079    - create a symlink from libccidtwin.so to libccidtwin.so.VERSION so
1080       that the /etc/reader.conf configuration file do not need to edited
1081       for each new driver version
1082    - make driver for the GemPC Serial compile again
1083    - some minor bugs removed
1084
1085
1086 1.3.1 - 16 November 2007, Ludovic Rousseau
1087    - add support for "Philips Semiconductors JCOP41V221" ICCD card,
1088       O2Micro oz776 (ProductID 0x7772), CardMan5321, Giesecke & Devrient
1089       StarSign Card Token 350 and 550, SafeNet IKey4000, Eutron
1090       CryptoIdentity, Eutron Smart Pocket, Eutron Digipass 860, Lenovo
1091       Integrated Smart Card Reader, "Kobil EMV CAP - SecOVID Reader III,
1092       Charismathics token, Reiner-SCT cyberJack pinpad(a)
1093    - improve support of Mac OS X and *BSD
1094    - some minor bugs removed
1095
1096
1097 1.3.0 - 10 May 2007, Ludovic Rousseau
1098    - add support of ICCD version A and B
1099    - add support for (new) KOBIL mIDentity, SchlumbergerSema Cyberflex
1100       Access e-gate ICCD, Fujitsu Siemens Computers SmartCard USB 2A and
1101       SmartCard Keyboard USB 2A readers, OmniKey CardMan 4321
1102    - contrib/RSA_SecurID/RSA_SecurID_getpasswd: tool to get the on time
1103       password also displayed on the token screen
1104    - contrib/Kobil_mIDentity_switch: tool to activate the CCID reader
1105       of the Kobil mIDentity. The tool should be started automatically
1106       by the udev rule on Linux
1107    - GemPC pinpad: localisation of the string "PIN blocked", add
1108       Portuguese(pt), Dutch(nl) and Turkish(tr) localisations
1109    - some minor bugs removed
1110
1111 1.2.1 - 27 January 2007, Ludovic Rousseau
1112    - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
1113       readers
1114    - INSTALL: document how to use --enable-udev on FreeBSD
1115    - move the O2Micro Oz7762 from the unsupported to the supported list
1116       since patches to support it are applied by default
1117       (O2MICRO_OZ776_PATCH)
1118
1119
1120 1.2.0 - 19 January 2007, Ludovic Rousseau
1121    - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
1122       SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
1123       SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
1124    - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
1125       Teo by Xiring, HP USB Smartcard Reader
1126    - use --enable-twinserial to build the serial reader driver
1127    - use --enable-udev to configure for a use with Linux udev hotplug
1128       mechanism. This will allow pcscd to avoid polling the USB bus
1129       every 1 second
1130    - some minor bugs removed
1131
1132
1133 1.1.0 - 11 August 2006, Ludovic Rousseau
1134    - support Extended APDU (up to 64KB) for readers in TPDU mode (many
1135       readers) or Extended APDU mode (very rare). This only works for
1136       T=1 cards.
1137    - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
1138       USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
1139       id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
1140    - support the contactless interface of the SCR331-DI-NTTCOM
1141    - add support of FreeBSD
1142    - increase the USB timeout used for PIN verify/modify to not timeout
1143       before the reader
1144    - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
1145       be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
1146       page 2. The applications using this feature shall be updated (to
1147       respect the PCSC specification).
1148    - use ./configure --enable-twinserial to compile and install the the
1149       driver for the GemPC Twin serial
1150    - some minor bugs removed
1151
1152
1153 1.0.1 - 22 April 2006, Ludovic Rousseau
1154    - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
1155       Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
1156       KB USB, OmniKey CardMan 3621
1157    - support Solaris (Solaris uses a different libusb)
1158    - better documentation for ./configure arguments
1159    - improve support of Cherry XX44 keyboard for PIN verify and change
1160       (circumvent firmware bugs)
1161    - do not use LTPBundleFindValueWithKey() from pcscd since this
1162       function has been removed from pcscd API
1163    - use -fvisibility=hidden is available to limit the number of
1164       exported symbols
1165
1166
1167 1.0.0 - 3 March 2006, Ludovic Rousseau
1168    - add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2,
1169       SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
1170       Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
1171       Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
1172       CardMan 5121
1173    - greatly improve support of PIN PAD readers. We now support TPDU
1174       readers with T=1 cards
1175    - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
1176       Supported languages are: de, en, es, fr, it
1177    - rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different
1178       reader and is not CCID compatible
1179    - allow to select the Power On voltage using Info.plist instead of
1180       recompiling the source code
1181    - correct bugs in the support of multi-slots readers
1182    - if the card is faster than the reader (TA1=97 for example) we try
1183       to use a not-so-bad speed (corresponding to TA1=96, 95 or 94)
1184       instead of the default speed of TA1=11
1185    - the src/parse tool do not use the driver anymore. No need to
1186       update the Info.plist file first.
1187    - some minor bugs removed
1188
1189
1190 0.9.4 - 27 November 2005, Ludovic Rousseau
1191    - add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity,
1192       Verisign Secure Token and VeriSign Secure Storage Token, GemPC
1193       Card (PCMCIA), SCM SCR331-DI NTTCom, SCM Micro SCR 3310-NTTCom,
1194       Cherry ST-1044U, Cherry SmartTerminal ST-2XXX
1195    - add support of PC/SC v2 part 10 CM_IOCTL_GET_FEATURE_REQUEST add
1196       support of FEATURE_VERIFY_PIN_DIRECT and FEATURE_MODIFY_PIN_DIRECT
1197       remove support of IOCTL_SMARTCARD_VENDOR_VERIFY_PIN (now
1198       obsoleted). A sample code is available in examples/scardcontrol.c
1199    - we need pcsc-lite 1.2.9-beta9 since some structures used for PIN
1200       pad readers are defined by pcsc-lite
1201    - some (bogus) cards require an extra EGT but the ATR does not say
1202       so. We try to detect the bogus cards and set TC1=2
1203    - IFDHSetProtocolParameters(): only use a data rate supported by the
1204       reader in the PPS negociation, otherwise we stay at the default
1205       speed.
1206    - calculate and store the read timeout according to the card ATR
1207       instead of using a fixed value of 60 seconds
1208    - increase the read timeout if the card sends and WTX request
1209    - improve support of GemPC Twin and GemPC Card (serial protocol)
1210    - reset the device on close only if DRIVER_OPTION_RESET_ON_CLOSE is
1211       set. The problem was that a device reset also disconnects the
1212       keyboard on a keyboard + reader device.
1213    - use color logs
1214    - some minor bugs removed
1215
1216
1217 0.9.3 - 14 March 2005, Ludovic Rousseau
1218    - change the licence from GNU GPL to GNU Lesser GPL (LGPL)
1219    - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,
1220       Kobil KAAN SIM III, Kobil KAAN mIDentity, SCM Micro SCR 331,
1221       SCM Micro SCR 331-DI, SCM Micro SCR 335, SCM Micro SCR 3310,
1222       SCM Micro SCR 532, Cherry XX44 readers
1223    - improve communication speed with readers featuring "Automatic PPS
1224       made by the CCID"
1225    - switch the Cherry xx33 reader in ISO mode if power up in EMV mode
1226       fails.
1227    - add support of character level readers. Thanks to O2Micro for the
1228       patch
1229    - add support for the O2Micro OZ776S reader but the reader firmware
1230       is still bogus
1231    - check firmware version to avoid firmwares with bugs. You can still
1232       use a bogus firmware by setting DRIVER_OPTION_USE_BOGUS_FIRMWARE
1233       in Info.plist
1234    - some minor bugs removed
1235
1236 0.9.2 - 15 August 2004, Ludovic Rousseau
1237    - T=1 TPDU code:
1238      - the work on T=1 TPDU code was possible thanks to Gemplus
1239         validation team who helped me test, debug and bring the code to
1240         an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and
1241         the Gemplus readers department
1242      - error code was not checked correctly
1243      - avoid a (nearly) infinite loop when resynch are needed.
1244      - correctly initialise an internal value to allow more than one
1245         reader to work
1246    - multi-slots readers
1247      - add support for multi-slots readers. The only one I have is a
1248         SCM Micro SCR 331-DI with a contact and a contactless interface.
1249         The contactless interface may or may not work for you since the
1250         reader uses proprietary (undocumented) commands.
1251    - GemPC Twin serial reader
1252      - perform a command (get the reader firmware) to be sure a GemPC
1253         Twin (serial or pcmcia) reader is connected
1254      - use a dynamic timeout when reading the serial port.
1255         The first timeout used when detecting the reader is 2 seconds to
1256         not wait too long if no reader is connected. Later timeouts are
1257         set to 1 minute to allow long time APDU.
1258    - use `pkg-config libpcsclite --cflags` to locate the pcsc-lite
1259       header files
1260    - use `pkg-config --print-errors --atleast-version=1.2.9-beta5 libpcsclite`
1261       to test the pcsc-lite version
1262    - code improvements thanks to the splint tool (http://www.splint.org/)
1263
1264 0.9.1 - 1 July 2004, Ludovic Rousseau
1265    - I forgot to define IFD_PARITY_ERROR in a .h file
1266
1267 0.9.0 - 1 July 2004, Ludovic Rousseau
1268    - The T=1 TPDU automata from Carlos Prados' Towitoko driver is very
1269       limited and do not support error management mechanisms.
1270       I then used the T=1 TPDU automata from OpenCT (OpenSC project).
1271       This automata is much more powerful but still lacks a lot of error
1272       management code.
1273       I then added all the needed code to reach the quality level
1274       requested by the EMV standard.
1275    - add support for new readers:
1276      - Advanced Card Systems ACR 38
1277      - Cherry XX33
1278      - Dell keyboard SK-3106
1279      - Dell smart card reader keyboard
1280      - SCR 333
1281    - add support of multi procotol cards (T=0 and T=1)
1282    - the debug level is now dynamic and set in the Info.plist file (no
1283       need to recompile the driver any more)
1284    - add support for the libusb naming scheme: usb:%04x/%04x:libusb:%s
1285    - INSTALL: add a "configuring the driver for the serial reader
1286       (GemPC Twin)" part
1287    - use `pkg-config libpcsclite --variable=usbdropdir` so you do not
1288       have to use --enable-usbdropdir=DIR or --enable-ccidtwindir=DIR
1289       even if pcscd does not use the default /usr/local/pcsc/drivers
1290    - add support of IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and
1291       IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in IFDHControl()
1292    - read ifdDriverOptions from Info.plist to limit the use of
1293       IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE (idea from Peter Williams)
1294    - provide an example of use of SCardControl()
1295       IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and
1296       IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in example/
1297    - add a --enable-pcsclite option (default to yes) so that the driver
1298       can be compiled for a different framework (one needing
1299       tokenparser.l like Solaris)
1300    - Reset action is power off and power on, not just power on
1301    - use the include files from pcsc-lite
1302    - add a mechanism to allow power on at 1.8V, 3V and then 5V as
1303       specified by ISO 7816. We still use 5V for now to avoid problems
1304       with non ISO compliant cards
1305
1306 0.4.1 - 14 February 2004, Ludovic Rousseau
1307    - distribute missing files readers/supported_readers.txt and
1308       src/create_Info_plist.pl
1309       'make install' failed because of this.
1310
1311 0.4.0 - 13 February 2004, Ludovic Rousseau
1312    - support of T=1 with TPDU readers. A lot of the T=1 code comes from
1313       Carlos Prados towitoko driver.
1314       My code is GNU GPL, his code is GNU LGPL so the global driver is
1315       GNU GPL
1316    - PPS negotiation if the reader does not do it automatically
1317    - add support for the Silitek SK-3105 keyboard. It's a USB device
1318       with multiple interfaces
1319    - use the create_Info_plist.pl script to generate the installed
1320       Info.plist from an Info.plist template and a list of supported
1321       readers. The Info.plist was too "complex" to maintain by hand
1322       since it now contains 11 entries
1323    - add support of IFDHCreateChannelByName to avoid wrong reader
1324       enumeration. This is not complete if you have multiple _identical_
1325       readers. You need to use a > 1.2.0 pcsc-lite version (not yet
1326       released at that time)
1327    - build but do not install the serial ccidtwin driver by default
1328       since it is useless on computers without a serial port or without
1329       this reader for example.
1330    - read and write timeouts are not symmetric. write timout can be
1331       shorter since the reader and card is not supposed to do anything
1332       before receiving (write) a command
1333    - do not try to find usb.h and other libusb files if
1334       --disable-libusb is used. Needed if you only want to build the
1335       serial driver.  Thanks to Niki Waibel for the patch
1336    - add a --enable-ccidtwindir argument to ./configure to specify the
1337       serial GemPC Twin installation directory
1338    - debug and code improvements and simplifications
1339
1340 0.3.2 - 4 November 2003, Ludovic Rousseau
1341    - src/commands.c: correct a stupid bug that occurs with an APDU with
1342       2 bytes response.
1343    - Info.plist: add SPR 532 in list of supported readers
1344    - parse.c: do not exit if the InterfaceClass is 0xFF (proprietary).
1345       It is the case with old readers manufactured before the final
1346       release of the CCID specs.
1347    - move LTC31 reader from unsupported to supported reader list. It
1348       was my f ault since in used odd INS byte in my test applet and odd
1349       INS bytes are forbidden by ISO 7816-4 ch. 5.4.2 Instruction byte.
1350       Thanks to Josep Moné s Teixidor for pointing the problem.
1351    - src/commands.c: comment out the automatic GET RESPONSE part. I
1352       don't think it should be in the driver. Maybe in pcscd instead?
1353
1354 0.3.1 - 23 September 2003, Ludovic Rouseau
1355    - add --enable-multi-thread (enabled by default) for thread safe
1356       support an APDU multiplexing. You will need pcsc-lite-1.2.0-rc3 or
1357       above to use this feature.
1358    - add --enable-libusb=PATH option is your libusb is not installed in
1359       /usr or /usr/local
1360    - honor DESTDIR in install rules (closes [ #300110 ]). Thanks to
1361       Ville Skyttä for the patch.
1362    - src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU
1363       mode since it also swicth in EMV mode and may not work with non
1364       EMV cards
1365    - src/ccid_serial.c: complete reimplementation of the Twin serial
1366       protocol using a finite state automata (code much simpler)
1367
1368 0.3.0 - 10 September 2003, Ludovic Rousseau
1369    - support of GemPC Twin connected to a serial port. Thanks to Niki
1370       W. Waibel for a working prototype.
1371    - support of auto voltage at power up if the reader support it
1372       instead of forcing a 5V in all cases.
1373    - support of APDU mode instead of just TPDU if the reader support
1374       it. Thanks to Jean-Luc Giraud for the idea and inspiration I got
1375       from his "concurrent" driver.
1376    - support of "time request" from the card.
1377    - parse: new indentation for more readability of supported features.
1378    - switch the GemPC Key and GemPC Twin in APDU mode since they
1379       support it but do not announce it in the dwFeatures.
1380    - new build process using autoconf/automake.
1381
1382 0.2.0 - 26 August 2003, Ludovic Rousseau
1383    - Works under MacOS X
1384    - Info.plist: use an <array></array> for the alias enumeration
1385    - Makefile rework for *BSD and MacOS X
1386
1387 0.1.0 - 13 August 2003, Ludovic Rousseau
1388    - First public release
1389
1390
1391  vim:ts=20