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.

Source download

The latest version is available at ccid. The latest README is at README.

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

svn checkout svn://anonscm.debian.org/pcsclite/trunk
cd Drivers/ccid
./bootstrap
./configure
make

Main CCID/ICCD features supported

• Exchange levels
  • short APDU
  • extended APDU (with some limitations and lack of support from PC/SC)
  • TPDU
  • character
• multi-slot readers
• composite CCID devices
• PC/SC v2 part 10 features:
  • GET_FEATURE_REQUEST
  • secure PIN verify (FEATURE_VERIFY_PIN_DIRECT)
  • modify PIN entry (FEATURE_MODIFY_PIN_DIRECT)
  • reader PIN properties (FEATURE_IFD_PIN_PROPERTIES)
  • Multifunctional Card Terminal reader direct (FEATURE_MCT_READER_DIRECT)
  • retrieve reader properties in TLV form (FEATURE_GET_TLV_PROPERTIES)
    • bMinPINSize and bMaxPINSize: How to know the PIN sizes supported by a pinpad reader?
    • bEntryValidationCondition
    • bPPDUSupport
    • sFirmwareID
    • bTimeOut2
    • wLcdMaxCharacters and wLcdMaxLines
    • wLcdLayout
  • send CCID escape commands (FEATURE_CCID_ESC_COMMAND)
• Data rates list
• Localize LCD display messages (Gemalto GemPC PIN PAD, Covadis Véga-Alpha)
• 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
• USB selective suspend

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
• pcsc-lite version
• smart card reader name
• the output of the command "/usr/sbin/pcscd --version"

Platform

• Operating system name and version
• Smart card middleware name and version
• Reader manufacturer name and reader model name
• Smart card name

Log

Then you shall generate a complete log.

• Kill any running pcscd process
• (re)start pcscd exactly as described bellow:

  sudo LIBCCID_ifdLogLevel=0x000F pcscd --foreground --debug --apdu | tee log.txt

• Stop pcscd (using Control-C) after the problem occured and send me the generated log.txt file

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 xjvf ccid-x.y.z.tar.bz2
cd ccid-x.y.z
./configure
make
sudo ./src/parse > output.txt

and send me (ludovic.rousseau@free.fr) the generated output.txt file.

If your reader is CCID compliant and you would like to add it to the list of readers I would also need:

• The URL of a web page describing the reader. Typically the web page of the reader description on the manufacturer web site.
• A picture of the reader. In general a picture is already available on the manufacturer web page described above.

CCID/ICCD readers

• Supported readers
• Should work readers
• Unsupported readers
• Disabled readers

All the readers are also included in a big matrix.

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

Supported and unsupported operating systems

GNU/Linux

GNU/Linux using libusb 1.0.x and later

Mac OS X

Apple includes my CCID driver (version 1.3.8, released in June 2008) since Leopard 10.5.6. See the mail from Shawn Geddis to have a list of changes.

Since the version 1.3.8 of the driver is now a bit old you may want to recompile a newer version of the driver yourself.

To see which readers are supported in version 1.3.8 go to this page and check the release column.

Apple updated the CCID driver in Lion (10.7) to version 1.3.11 (released in July 2009). See my blog entry Mac OS X Lion and smart cards status.

Snow Leopard (10.6.x) and Lion (10.7.x)

Mac OS X Snow Leopard (10.6) and Lion (10.7) are supported without patches. To build the driver you need to extract the archive and do:

./MacOSX/configure
make
sudo make install

Leopard (10.5)

Mac OS X Leopard (10.5) is supported with a simple patch. 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 warm 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 Oracle.

FreeBSD

The driver is available in the libccid package or this freshport.

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 6295 2012-05-15 06:49:10Z rousseau $

SEARCH:

Related searches:
reader version driver supported feature

gipoco.com is neither affiliated with the authors of this page or responsible
for its contents. This is a safe-cache copy of the original web site.

gipoco.com is neither affiliated with the authors of this page nor responsible for its contents. This is a safe-cache copy of the original web site.