CCID free software driver

This package provides the source code for a generic USB CCID (Chip/Smart Card Interface Devices) driver and ICCD (Integrated Circuit(s) Card Devices).

See the USB CCID and ICCD specifications from the USB working group.

Authors

The main author is Ludovic Rousseau <ludovic.rousseau@free.fr>.

I reused source code from other free software projects whose authors are:

Carlos Prados for the PPS and ATR parsing code (taken from his towitoto driver) in towitoko/ directory.
Olaf Kirch for the T=1 TPDU code (from the OpenCT package) in openct/ directory. I (Ludovic Rousseau) greatly improved this code.

Licence

  This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or (at
your option) any later version.

  This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
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

Source download

28 July 2009, ccid-1.3.11, README.

You can also access the Subversion developement version. You may need to use the Subversion version to support the latest added readers.

Main CCID/ICCD features supported

Exchange levels
- short APDU
- extended APDU (with some limitations)
- TPDU
- character
multi-slot readers
PC/SC v2 part 10 features:

secure PIN verify
modify PIN entry
ifd PIN properties
MCT reader direct

Data rates list
LCD display (Gemalto GemPC PIN PAD)
Extended APDU (for T=1 cards only and if your reader is in TPDU mode or extended APDU mode)
SCardGetAttrib() attributes
ICCD versions A and B

CCID features not yet supported

Manage suspend/resume (for example in a laptop)
Reader clock frequency change

Contact me if you want to see the support of the above not yet supported features and you have a budget.

Non CCID features that I do not plan to support

read/write on memory cards

In fact I may implement one of these features if you have a budget.

Sending usefull logs

If you have a problem and want to get support from me you shall include the following information:

Versions

CCID driver version
Operating system name and version
pcsc-lite version
smart card reader name
the output of the command "/usr/sbin/pcscd --version"

Log

Then you shall generate a complete log.

Kill the pcscd process

Start pcscd as root from the command line:

  # LIBCCID_ifdLogLevel=0x0007
  # export LIBCCID_ifdLogLevel
  # pcscd --foreground --debug --apdu

Stop pcscd (using Control-C) after the problem occured and send me the generated output

Mailing list

If you have general questions or bug reports you should use the MUSCLE mailing list: muscle@lists.musclecard.com.

First search the mailing list archives. Maybe your probem has already been reported and solved. If you have not found a solution then write to muscle@lists.musclecard.com with a description of your problem.

Compliant readers

To know if a smart card reader is CCID compliant and should be supported by this driver but is not listed bellow

Just get the source code of this driver and do:

  tar xzvf ccid-x.y.z.tar.gz
  cd ccid-x.y.z
  ./configure
  make
  sudo ./src/parse > output.txt

and send me the generated output.txt file.

CCID/ICCD readers

Supported readers
Should work readers
Unsupported readers

All the readers are also included in a big matrix.

Supported and unsupported operating systems

GNU/Linux

GNU/Linux using libusb 0.1.7 and later

Asynchronous card movement

To be able to use the asynchronous card movement notification (instead of active polling every 400ms) you need to use libusb > 0.1.12 (not yet available) or use this patch. See the discussion on the MUSCLE list.

Mac OS X

Leopard (10.5.6 and newer)

Apple now includes my CCID driver in Leopard 10.5.6. See the mail from Shawn Geddis to have a list of changes.

Leopard (10.5)

Mac OS X Leopard (10.5) is supported without patches. To build the driver you need to extract the archive and do:

  $ ./MacOSX/configure
  $ make
  $ sudo make install

NOTE: The execution of ./MacOSX/configure will fail if you have a space character in your current working directory pathname.

NOTE: Apple's version of pcsc-lite installed with Leopard has many bugs and problems. See LeopardBugs for a list of known bugs.

Tiger (10.4)

Mac OS X Tiger (10.4) uses an old pcsc-lite with some problems:

A missing call to IFDHSetProtocolParameters() so the reader is not configured correctly regarding to the card ATR.
A wrong API for SCardControl() so you can't use a pin pad reader or any other feature provided by SCardControl().
No way to generate a cold reset. Only a farm reset is possible. Uncomment the line #CFLAGS="$CFLAGS -DFAKE_CARD_CHANGED" in MacOSX/configure to fake a card movement after a reset to simulate a cold reset. Note that SCardReconnect() will then fail with SCARD_W_REMOVED_CARD.

You can use this (now unmaintained) patch.

Solaris

The driver should work on Solaris.

I can't test is myself so patches are welcome if needed.

You can find a PC/SC-lite package form SUN.

FreeBSD

This driver is known to NOT work on FreeBSD. I don't know why and patches are welcome.

Other operating systems

It may or may not work.

Available binaries

The drivers are also available as packages libccid and source or package.

 $Id: ccid.html 4692 2010-01-27 20:20:07Z rousseau $