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

Diff of /trunk/Drivers/ccid/README

Parent Directory | Revision Log | View Patch Patch

-revision 2131 by rousseau,
Thu Aug 10 22:31:08 2006 UTC
+revision 4979 by rousseau,
Fri Jun  4 13:29:42 2010 UTC
 Line 5 
 USB CCID IFD Handler
  (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID
  specifications from the USB working group.
+ [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
  Authors:
  ========
-Line 19 
 Authors:
+Line 20 
 Authors:
  Supported CCID readers:
  =======================
- (in alphabetical order)
+ The list is available at http://pcsclite.alioth.debian.org/supported.html
- - ActivCard USB reader 3.0
- - Advanced Card Systems ACR 38U-CCID [16]
-   old versions of this reader have a bug: the reader do timeout when a
-   special USB frame is sent from the reader. If the frame size if a
-   multiple of wMaxPacketSize the communication is stopped.
- - Alcor Micro AU9520 [46]
- - Athena ASE IIIe USB V2 [29]
- - Athena ASE IIIe KB USB [42]
- - C3PO LTC31 (new model, USB product id 0x0006) [8]
- - Cherry XX33 keyboard [?]
- - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
- - Cherry SmartTerminal ST2000U [35]
- - Cherry ST-1044U [27]
- - Dell keyboard SK-3106 [?]
- - Dell smart card reader keyboard [?]
- - Eutron SIM Pocket Combo [25]
- - Eutron CryptoIdentity [26]
- - Gemplus GemPC 433 SL [2]
- - Gemplus GemPC Card [41]
- - Gemplus GemPC Key [3]
- - Gemplus GemPC PinPad
- - Gemplus GemPC Twin [4]
- - Gemplus GemCore POS Pro
- - Gemplus GemCore SIM Pro
- - Kobil KAAN Base [19]
- - Kobil KAAN Advanced [20]
- - Kobil KAAN SIM III [21]
- - Kobil mIDentity [22]
- - OmniKey CardMan 3121 [5]
- - SCM Micro SCR 331 [6]
-   You shall upgrade the firmware [17] using version 5.18 or later.
- - SCM Micro SCR 331-DI [11]
-   You shall upgrade the firmware [17] using version 6.22 or later.
- - SCM Micro SCR 335 [7]
-   The firmware of this reader can't be upgraded so be sure to buy a
-   recent model with firmware 5.14 or later
- - SCM Micro SCR 355
- - SCM Micro SCR 3310 [30]
- - SCM Micro SCR 3311 [31]
- - SCM Micro SPR 532 [9]
-   You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
-   firmware upgrade.
- - SmartEpad (v 2.0) [32]
-   The firmware gives a very strange description of the reader (like a
-   dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.
- - Verisign Secure Storage Token [24]
- - Verisign Secure Token [?]
  Should work but untested by me:
-Line 76 
 I would like to get these readers to per
+Line 30 
 I would like to get these readers to per
  move them in the supported list above. If you are one of the
  manufacturers, please, contact me.
- - Axalto Reflex USB v3 [38]
+ The list is available at http://pcsclite.alioth.debian.org/shouldwork.html
- - C3PO LTC32 [13]
- - Gemplus GemPC Express
- - HP USB Smart Card Keyboard [44]
- - id3 Semiconductors CL1356D [45] (tested by me but I don't have the
-   reader anymore)
- - OmniKey CardMan 3021
- - OmniKey CardMan 3621 [43]
- - OmniKey CardMan 3821 [37]
- - OmniKey CardMan 5125 [33]
- - OmniKey CardMan 6121 [36]
- - SCM Micro SCR 331-DI NTTCom [23]
- - SCM Micro SCR 3310-NTTCOM [28]
- - SCM Micro SCR 3320 [32]
- - SCM Micro SCR 333 [15]
- - SCM Micro SDI 010 [39]
- - SCM SCR 3340 ExpressCard54 [34]
- - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
- - Winbond Electronics (for OEM only) [40]
  Unsupported or partly supported CCID readers:
  =============================================
- - ActivCard USB reader 2.0 [10]
+ The list is available at http://pcsclite.alioth.debian.org/unsupported.html
-     The reader do timeout when a special USB frame is sent from the
-     reader. If the frame size if a multiple of wMaxPacketSize the
-     communication is stopped.
- - C3PO LTC31 (old model, USB product id 0x0003) [8]
-     The reader works fine with Linux kernel 2.4 but does not with Linux
-     kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
- - iDream (THRC2002-2) [47]
-     PPS fails with a Cryptoflex card
-     powerup fails with a Setcos card
-     does work with the belgium eID (the reader is sold for this
-     application)
- - RSA SecureID SID800 [24]
-     The USB layer is completely broken. The reader is sometimes not even
-     seen on the USB bus (same problem under Windows). Maybe newer
-     devices will work?
  Supported operating systems:
-Line 156 
 to unplug all your CCID readers so the t
+Line 77 
 to unplug all your CCID readers so the t
  replug your readers. You can also restart pcscd.
+ Voltage selection
+ =================
+ You can change the voltage level using the Info.plist configuration file.  The
+ Info.plist is installed, by default, in
+ /usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
+ The voltage level is set in the ifdDriverOptions field. It is a binary OR
+ combinaison of 4 different levels.
+ -  0: power on the card at 5V (default value)
+ - 16: power on the card at 3V and then, if 3V fails then use 5V
+ - 32: power on the card at 1.8V, then 3V and then 5V
+ - 48: let the reader decide
+ By default the voltage level is set to 0  and correspond to 5V.
+ You have to restart the driver so it read the configuration file again
+ and use the new debug level value.  To restart the driver you just need
+ to unplug all your CCID readers so the the driver is unloaded and then
+ replug your readers.  You can also restart pcscd.
  Known problems:
  ===============
-Line 183 
 General Public License for more details.
+Line 127 
 General Public License for more details.
    You should have received a copy of the GNU Lesser General Public License
  along with this library; if not, write to the Free Software Foundation,
- Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
+ Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  History:
  ========
+.3.13 - 4 June 2010, Ludovic Rousseau
+     - much faster warm start (up to 3.8 second gained)
+     - Add support of SCARD_ATTR_VENDOR_IFD_SERIAL_NO to get the serial
+       number of the USB device
+     - some minor bugs removed
+.3.12 - 8 May 2010, Ludovic Rousseau
+     - add support of Todos AGM2 CCID, Cherry SmartTerminal XX7X, Smart
+       SBV280, Ask CPL108, German Privacy Foundation Crypto Stick v1.2,
+       id3 CL1356T5, Covadis Auriga, GoldKey PIV Token, Vasco DIGIPASS
+       KEY 860, Vasco DIGIPASS KEY 200, Vasco DP855, Vasco DP865, Atmel
+       AT90SCR100, Atmel AT90SCR050, Atmel VaultIC420, Atmel VaultIC440,
+       Atmel VaultIC460, KOBIL Smart Token, KOBIL mIDentity 4smart, KOBIL
+       mIDentity 4smart AES, KOBIL mIDentity visual, KOBIL mIDentity
+       fullsize, KOBIL mIDentity 4smart fullsize AES, SCM SCR3500
+     - remove support of Smart SBV280 on manufacturer request. They use
+       libusb directly.
+     - remove support of SCM SDI 010 on manufacturer request since not
+       supported by my driver
+     - Enable the Broadcom 5880 reader. It should work after a firmware
+       upgrade.
+     - better support of Dell keyboard
+     - better support of multislot readers (like the GemCore SIM Pro)
+     - better support of SCM SCR3310
+     - better support of ICCD version A devices
+     - The Covadis Véga-Alpha reader is a GemPC pinpad inside. So we use
+       the same code to:
+       . load the strings for the display
+       . avoid limitation of the reader
+     - IFDHControl(): the (proprietary) get firmware version escape
+       command is allowed with a Gemalto reader
+       . the (proprietary) switch interface escape command is allowed on
+       the Gemalto GemProx DU
+       . return IFD_ERROR_NOT_SUPPORTED instead of
+       IFD_COMMUNICATION_ERROR if the dwControlCode value is not
+       supported
+       . return IFD_ERROR_INSUFFICIENT_BUFFER when appropriate
+     - IFDHGetCapabilities(): add support of SCARD_ATTR_ICC_PRESENCE and
+       SCARD_ATTR_ICC_INTERFACE_STATUS
+     - support FEATURE_GET_TLV_PROPERTIES
+     - add support of IOCTL_FEATURE_GET_TLV_PROPERTIES bMinPINSize &
+       bMaxPINSize for Gemalto Pinpad V1 & Covadis Véga-Alpha
+     - support extended APDU of up to 64kB with APDU readers.
+     - get the language selected during Mac OS X installation as language
+       to use for Covadis Véga-Alpha and Gemalto GemPC PinPad pinpad
+       readers
+     - FEATURE_MCT_READER_DIRECT is also supported by the Kobil mIDentity
+       visual
+     - better support of Sun Studio CC
+     - some minor bugs removed
+.3.11 - 28 July 2009, Ludovic Rousseau
+     - add support of Raritan D2CIM-DVUSB VM/CCID, Feitian SCR301,
+       Softforum XecureHSM, 2 Neowave Weneo tokens, Synnix STD200, Aktiv
+       Rutoken ECP, Alcor Micro SCR001, ATMEL AT91SC192192CT-USB,
+       Panasonic USB Smart Card Reader 7A-Smart, Gemalto GemProx DU and SU
+     - remove support of Reiner-SCT cyberJack pinpad(a) on request of
+       Reiner-SCT.  You should user the Reiner-SCT driver instead
+     - define CFBundleName to CCIDCLASSDRIVER so that non class drivers
+       have a higher priority. Used by pcsc-lite 1.5.5 and up.
+       Add a --disable-class configure option so that the Info.plist does
+       not define a Class driver. Default is class driver.
+     - do not power up a card with a voltage not supported by the reader
+     - add support of PIN_PROPERTIES_STRUCTURE structure and
+       FEATURE_IFD_PIN_PROPERTIES
+     - adds support of FEATURE_MCT_READERDIRECT. Only the Kobil TriB@nk
+       reader supports this feature for now. This is used for the Secoder
+       functionality in connected mode.
+     - add support of a composite device. No change needed with libhal.
+       use --enable-composite-as-multislot on Mac OS X since libhal is
+       not available on Mac OS X or with libusb on Linux
+     - some minor bugs removed
+.3.10 - 7 March 2009, Ludovic Rousseau
+     - add support for MSI StarReader SMART, Noname reader (from
+       Omnikey), Xiring Xi Sign PKI, Realtek 43 in 1 + Sim + Smart Card
+       Reader, Atmel AT98SC032CT, Aktiv Rutoken Magistra, TianYu CCID
+       SmartKey, Precise Biometrics 200 MC and 250 MC
+     - add a patch to support the bogus OpenPGP card (on board key
+       generation sometimes timed out)
+     - disable support of the contactless part of SDI010 and SCR331DI
+       (this code was reverse engineered and hard to maintain)
+     - some minor bugs removed
+.3.9 - 18 November 2008, Ludovic Rousseau
+     - add support for Aladdin eToken PRO USB 72K Java, Cherry
+       SmartTerminal ST-1200USB, Atmel AT91SO, SpringCard Prox'N'Roll,
+       CSB6 Basic, EasyFinger Ultimate, CSB6 Ultimate, EasyFinger
+       Standard, CrazyWriter, CSB6 Secure, KONA USB SmartCard, HP MFP
+       Smart Card Reader, ACS ACR122U PICC, Gemalto PDT, VMware Virtual
+       USB CCID
+     - MacOSX/configure: do not overwrite PCSC_CFLAGS, PCSC_LIBS,
+       LIBUSB_CFLAGS and LIBUSB_LIBS if already defined by the user
+     - by default, link statically against libusb on Mac OS X
+     - IFDHPowerICC(): use a very long timeout for PowerUp since the card
+       can be very slow to send the full ATR (up to 30 seconds at 4 MHz)
+     - SecurePINVerify(): correct a bug when using a Case 1 APDU and a
+       SCM SPR532 reader
+     - log the reader name instead of just the pcscd Lun
+     - some minor bugs removed
+.3.8 - 27 June 2008, Ludovic Rousseau
+     - add support for Oberthur ID-One Cosmo Card
+     - do not include the release number in the Info.plist to avoid a
+       diff of a configuration file when upgrading the package.
+     - do not fail compilation if libusb is not available
+     - do not crash if the reader firmware is bogus and does not support
+       chaining for extended APDU.  This is the case for Kobil readers
+     - some minor bugs removed
+.3.7 - 8 June 2008, Ludovic Rousseau
+     - add support for ActivCard Activkey Sim, Pro-Active CSB6 Ultimate,
+       id3 Semiconductors CL1356A HID
+     - src/parse: do not try to parse devices with bInterfaceClass=0xFF
+       by default (use command line argument -p for proprietary class)
+     - configure.in: check if libusb-0.1 is emulated by libusb-compat +
+       libusb-1.0 to use or not the USB interrupt feature
+     - correct a bug in the serial communication (GemPC twin serial
+       reader)
+     - correct a pthread problem under Solaris
+     - some minor bugs removed
+.3.6 - 30 April 2008, Ludovic Rousseau
+     - add support for Covadis Alya, Covadis Véga, Precise Biometrics 250
+       MC, Vasco DP905, Validy TokenA sl vt
+     - better support for the O2Micro OZ776, GemCore SIM Pro
+     - the environment variable LIBCCID_ifdLogLevel overwrite the value
+       of ifdLogLevel read from the Info.plist file
+     - add support for DragonFly BSD
+     - some minor bugs removed
+.3.5 - 22 February 2008, Ludovic Rousseau
+     - add support for Gemplus Gem e-Seal Pro, Cherry SmartBoard,
+       G83-6610
+     - use usb_interrupt_read() only if libusb > 0.1.12 or
+       --enable-usb-interrupt is used. libusb <= 0.1.12 is bogus and will
+       consume more CPU than needed.
+     - contrib/Kobil_mIDentity_switch/Kobil_mIDentity_switch was broken
+       on Linux since release 1.3.1
+     - some minor bugs removed
+.3.4 - 8 February 2008, Ludovic Rousseau
+     - the serial driver could not be loaded because of the missing
+       symbol InterruptRead
+     - remove WAIT_FOR_SYSFS="bInterfaceProtocol" to do not delay udev
+.3.3 - 6 February 2008, Ludovic Rousseau
+     - add support for Lexar Smart Enterprise Guardian and Blutronics
+       Bludrive II CCID
+     - add support of TAG_IFD_POLLING_THREAD using IFDHPolling() to
+       detect asynchronous card movements. With this feature pcscd will
+       not poll the reader every 0.4 second for a card movement but will
+       wait until the reader sends a USB interrupt signal
+     - correct a bug with an ICCD-B device and a receive buffer smaller
+       than 4 bytes
+     - remove the sleep in the udev rule. It slows down the detection of
+       any USB device
+     - some minor bugs removed
+.3.2 - 22 January 2008, Ludovic Rousseau
+     - add support of Apple Mac OS X Leopard (10.5.1)
+     - solve a hotplug problem on Ubuntu 7.10 (reader was not detected)
+     - create a symlink from libccidtwin.so to libccidtwin.so.VERSION so
+       that the /etc/reader.conf configuration file do not need to edited
+       for each new driver version
+     - make driver for the GemPC Serial compile again
+     - some minor bugs removed
+.3.1 - 16 November 2007, Ludovic Rousseau
+     - add support for "Philips Semiconductors JCOP41V221" ICCD card,
+       O2Micro oz776 (ProductID 0x7772), CardMan5321, Giesecke & Devrient
+       StarSign Card Token 350 and 550, SafeNet IKey4000, Eutron
+       CryptoIdentity, Eutron Smart Pocket, Eutron Digipass 860, Lenovo
+       Integrated Smart Card Reader, "Kobil EMV CAP - SecOVID Reader III,
+       Charismathics token, Reiner-SCT cyberJack pinpad(a)
+     - improve support of Mac OS X and *BSD
+     - some minor bugs removed
+.3.0 - 10 May 2007, Ludovic Rousseau
+     - add support of ICCD version A and B
+     - add support for (new) KOBIL mIDentity, SchlumbergerSema Cyberflex
+       Access e-gate ICCD, Fujitsu Siemens Computers SmartCard USB 2A and
+       SmartCard Keyboard USB 2A readers, OmniKey CardMan 4321
+     - contrib/RSA_SecurID/RSA_SecurID_getpasswd: tool to get the on time
+       password also displayed on the token screen
+     - contrib/Kobil_mIDentity_switch: tool to activate the CCID reader
+       of the Kobil mIDentity. The tool should be started automatically
+       by the udev rule on Linux
+     - GemPC pinpad: localisation of the string "PIN blocked", add
+       Portuguese(pt), Dutch(nl) and Turkish(tr) localisations
+     - some minor bugs removed
+.2.1 - 27 January 2007, Ludovic Rousseau
+     - pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF)
+       readers
+     - INSTALL: document how to use --enable-udev on FreeBSD
+     - move the O2Micro Oz7762 from the unsupported to the supported list
+       since patches to support it are applied by default
+       (O2MICRO_OZ776_PATCH)
+.2.0 - 19 January 2007, Ludovic Rousseau
+     - add support for SCARD_ATTR_VENDOR_IFD_VERSION,
+       SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by
+       SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation
+     - add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32,
+       Teo by Xiring, HP USB Smartcard Reader
+     - use --enable-twinserial to build the serial reader driver
+     - use --enable-udev to configure for a use with Linux udev hotplug
+       mechanism. This will allow pcscd to avoid polling the USB bus
+       every 1 second
+     - some minor bugs removed
+.1.0 - 11 August 2006, Ludovic Rousseau
+     - support Extended APDU (up to 64KB) for readers in TPDU mode (many
+       readers) or Extended APDU mode (very rare). This only works for
+       T=1 cards.
+     - add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP
+       USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim,
+       id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520
+     - support the contactless interface of the SCR331-DI-NTTCOM
+     - add support of FreeBSD
+     - increase the USB timeout used for PIN verify/modify to not timeout
+       before the reader
+     - the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall
+       be encoded in big endian as documented in PCSC v2 part 10 ch 2.2
+       page 2. The applications using this feature shall be updated (to
+       respect the PCSC specification).
+     - use ./configure --enable-twinserial to compile and install the the
+       driver for the GemPC Twin serial
+     - some minor bugs removed
 .0.1 - 22 April 2006, Ludovic Rousseau
      - add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond
        Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe
-Line 208 
 History:
+Line 399 
 History:
        SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54,
        Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC
        Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey
-       CardMan 5125
+       CardMan 5121
      - greatly improve support of PIN PAD readers. We now support TPDU
        readers with T=1 cards
      - use l10n strings for the Gemplus GemPC PIN PAD (it has a screen).
-Line 427 
 History:
+Line 618 
 History:
      - First public release
- References:
- ===========
- [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
- [2] http://www.gemplus.com/products/gempc433/
- [3] http://www.gemplus.com/products/gempckey/
- [4] http://www.gemplus.com/products/gempctwin/
- [5] http://www.omnikey.com/index.php?id=40
- [6] http://www.scmmicro.com/security/SCR331.html
- [7] http://www.scmmicro.com/security/SCR335.html
- [8] http://www.c3po.es/ltc31.html
- [9] http://www.scmmicro.com/security/SPR532.html
- [10] http://www.activcard.com/products/usb_reader.html
- [11] http://www.scmmicro.com/security/SCR331-DI.html
- [12] http://www.silitek.com/prod/getProduct.do?xml_id=4_2&menu_id=4_2_8&cid=1_8_5
- [13] http://www.c3po.es/ltc32.html
- [14] http://www.c3po.es/tltc2usb.html
- [15] http://www.scmmicro.com/security/SCR333.html
- [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers
- [17] http://www.scmmicro.com/support/pcs_product_drivers.html
- [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm
- [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
- [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php
- [21] http://www.kobil.com/d/products/smartcard/kaansim3.php
- [22] http://www.kobil.com/e/products/index.php?s=midentity
- [23] http://www.ntt.com/jpki/SCR331DI.html
- [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/
- [25] http://www.eutron.com/simpocket.asp
- [26] http://www.cryptoidentity.eutron.com/eng/home.asp
- [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm
- [28] http://www.ntt.com/jpki/scr3310.html
- [29] http://www.asedrive.com/product.asp?pid=1
- [30] http://www.scmmicro.com/security/SCR3310.html
- [31] http://scmmicro.com/security/SCR3311.html
- [31] http://scmmicro.com/security/SCR3320.html
- [32] http://www.smartepad.com.br/
- [33] http://www.omnikey.com/index.php?id=121
- [34] http://www.scmmicro.com/security/SCR3340.html
- [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm
- [36] http://www.omnikey.com/index.php?id=21
- [37] http://www.omnikey.com/index.php?id=114
- [38] http://www.reflexreaders.com/Products/reflex_usbnew.html
- [39] http://www.scmmicro.com/security/SDI_010.html
- [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm
- [41] http://www.gemplus.com/products/gempc_card/
- [42] http://www.asedrive.com/product.asp?pid=2
- [43] http://www.omnikey.com/index.php?id=50
- [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML
- [45] http://www.id3semiconductors.com/produits/cl1356D.htm
- [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21
- [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1
  $Id$
   vim:ts=20

 Legend:



Removed from v.2131
 


changed lines


 
Added in v.4979
 Legend:



Removed from v.2131
 


changed lines


 
Added in v.4979
-Removed from v.2131
+Added in v.4979

	ViewVC Help
Powered by ViewVC 1.1.5