Gemplus GemPC 410 and GemPC 430 IFD Handler
===========================================

This package provides the source code for the GemPC 410 (serial) and
GemPC 430 (usb) smart card familly readers PC/SC ifd handler.

Both readers use a GemCore chip and the same set of commands. Only the
low level transport layer is different.


See README.410 for GemPC410 specific comments.
See README.430 for GemPC430 specific comments.


Authors:
========

- David Corcoran for the original headers and empty ifdhandler.c file
- Jean-Luc Giraud for the main part of GemPC430/ and half of common/
- Ludovic Rousseau for the main part of GemPC410/ and half of common/


Supported readers:
==================

- GemPC 410
  . normal GemPC 410 (GemCore-R1.21-GM)
  . IBM 410p (v1.21)
  . GemPC 410-SL (GemCore-R1.21-GM)

- GemPC 412
  . GCR412 FirstUSA (GemCore-R1.21-GM)

- GemPC 413
  . EMV complient (GemCore-R1.32-GK)

- GemPC 415
  . VISA and American Express 415 (unkown)

- GemPC 430
  . normal GemPC 430 (GemUsb-R1.04-GM)

- GemPC 432
  . target.com (GemUsb-R1.04-WM)

- GemPC 435
  . American Express Blue Card reader (GemUsb-R1.04-A)

The number in () is the GemCore version as seen in the logs generated by
the driver. Like in "(GemPC430) OS string: GemUsb-R1.04-GM" or
"(GemPC410) OS string: GemCore-R1.21-I"


Unsupported GemCore based readers:
==================================

- GCR400
  Very old version of the GemPC410.

- GCR410
  Old version of the GemPC410. This reader uses a GemCore version 1.118
  or 1.10. With this firmware the case 4 commands (both input and output
  data) will not work.


Licences:
=========

The files in GemPC410/ are under GNU General Public Licence.

The files in GemPC430/ are under a BSD-like licence (except main.c which
is under GPL but is not needed to build the driver).

The files in common/ are under a double licence BSD-like and GNU General
Public Licence. except the files ifdhandler.c, ifdhandler.h and
pcscdefines.h which are originally written by David Corcoran and are
under the BSD-like licence.

That means that the GemPC 410 driver is under GNU General Public
Licence, and that the GemPC 430 driver is the BSD-like licence or the
GNU General Public Licence at your choice.


Supported pcsc-lite versions
============================

pcsc-lite 1.1.2beta4 and later
    You can get the latest pcsc-lite version from
    http://linuxnet.com/middle.html or from
    http://pcsclite.alioth.debian.org/

Get pcsc-lite higher than 1.2.0 if you want to use /etc/reader.conf
DEVICENAME fields managed by the new API IFDHCreateChannelByName()


History:
========

1.0.3 - 14 August 2007, Ludovic Rousseau
    - correct a big bug unnoticed for many years and declared on PowerPC
      with gcc 4.x (Debian bug #428323)
    - do not strip the library so we have debug symbols if needed.
      strip should be called by the package build process (if needed)

1.0.2 - 29 June 2007, Ludovic Rousseau
    - correctly handle empty response from the GemPC410 reader

1.0.1 - 9 February 2006, Ludovic Rousseau
    - remove a useless "POUET" debug message
    - allow compilation with pcsc-lite-1.2.9-beta10. The check script
      was buggy for beta > 9
    - fix some compilation warnings with gcc 4.0

1.0.0 - 17 June 2005, Ludovic Rousseau
    - use new pcscd log function with dynamic level
    - use `pkg-config libpcsclite --variable=usbdropdir` to know where
      to install the driver

0.9.3 - 8 August 2004, Ludovic Rousseau
    - maintainance release to make it compile using gcc-3.4

0.9.2 - 25 July 2004, Ludovic Rousseau
    - use the header files provided by pcsc-lite 1.2.9-beta
    - use pkg-config to know the where to find the pcsc-lite include
      files
    - minium pcsc-lite version is 1.2.9-beta5

0.9.1 - 27 February 2004, Ludovic Rousseau
    - add a compilation flag AUTOMATIC_PPS to activate automatic PPS
      negociation by the reader firmware. I received many bug reports
      with some cards. The card works until some APDU returns a
      "invalid procedure byte" error. By default the automatic PPS
      negociation is now NOT performed. Uncomment a line in
      GemPC4?0/Config.h to revert to the previous behavior and choose
      speed versus safety
    - GemPC430/libusb_wrap.c: use pcsc-lite new
      IFDHCreateChannelByName() scheme: usb:vendor/product
      In 0.9.0 the driver failed when used with a CVS version of
      pcsc-lite. Thanks to Dr Russel Winder for the bug report
    - common/GCCmds.h: the GemCore error message now contains the file,
      function and line number of the command with error and not of the
      error printing function
    - add two GemCore error code descriptions: 0x15 and 0xE4

0.9.0 - 22 January 2004, Ludovic Rousseau
    - add support of IFDHCreateChannelByName() (from pcsc-lite > 1.2.0)
    - GemPC430/libusb_wrap.c: reset the reader in case of timeout on
      write (reader freeze?). Thanks to Patrick Valsecchi for the patch.
    - use asymetric timeout for USB read and write. The reader/card may
      be busy when we read (long timeout) but should be OK when we write
      (short timeout)

0.8.2 - 22 Octobre 2003, Ludovic Rousseau
    - Remove support for multi slot. The code was never used and is now
      broken under revent pcsc-lite versions. The error under pcsc-lite is:
        readerfactory.c:1391 RFInitializeReader: Attempting startup of GemPC430 0 0.
        readerfactory.c:1133 RFBindFunctions: Loading IFD Handler 2.0
        ifdhandler.c:87 (GemPC43x) Entering IFDHCreateChannel (lun: 0)
        GCCmds.c:394 (GemPC43x) GCCmdSetMode
        GCCmds.c:319 (GemPC43x) GCCmdGetOSVersion
        GemPC430Utils.c:51 (GemPC43x) OS string: GemUsb-R1.04-GM 
        ifdhandler.c:158 (GemPC43x) entering IFDHGetCapabilities (lun: 0)
        ifdhandler.c:158 (GemPC43x) entering IFDHGetCapabilities (lun: 0)
        readerfactory.c:1391 RFInitializeReader: Attempting startup of GemPC430 0 1.
        readerfactory.c:925 RFLoadReader: Warning library pointer not NULL
        readerfactory.c:1133 RFBindFunctions: Loading IFD Handler 2.0
        ifdhandler.c:87 (GemPC43x) Entering IFDHCreateChannel (lun: 1)
        libusb_wrap.c:106 (GemPC43x) USB driver with lun 1 already in use
        GemPC430Utils.c:30 (GemPC43x) OpenUSB failed
        ifdhandler.c:102 (GemPC43x) OpenReader failed
        readerfactory.c:1428 RFInitializeReader: Open Port 200000 Failed
        readerfactory.c:423 RFAddReader: GemPC430 init failed.
        hotplug_libusb.c:344 Adding USB device: 002:002
        readerfactory.c:119 RFAddReader: Duplicate reader found.
        hotplug_libusb.c:344 Adding USB device: 002:002
        readerfactory.c:119 RFAddReader: Duplicate reader found.
        [...]
      The reader told pcsc-lite that it supported two slots and
      pcsc-lite wanted to start two readers (one for each slot).
    - add support for 7 new GemCore error codes
    - check: Explain how to tell check to look elsewhere than just /usr/
      and /usr/local/

0.8.1 - 2 Septembre 2003, Ludovic Rousseau
    - ./check: uses paths defined in the Makefiles (if libusb is not
      installed in /usr or /usr/local)
    - common/GCCmds.c: add support of GemCore "Parity error during
      exchange"
    - GemPC410/devfs/libgempc410.devfsd.conf: use $devpath instead of
      $devname otherwise we have /dev/pcsc/1 -> tts/0 instead of
      /dev/pcsc/1 -> /dev/tts/0
    - GemPC430/Info.plist: use new <array></array> style
    - common/ifdhandler.c: FDHGetCapabilities() add support of tag
      TAG_IFD_SLOTS_NUMBER. All the readers I have/know have only one
      slot so this does not bring any new real functionnality.
    - Makefiles: do not exit with failure if makedepend(1) does not
      exist
    - update build and distclean rules.

0.8.0 - 12 April 2003, Ludovic Rousseau
    - Add support for GemPC 413 reader. That reader uses GemCore 2000
      and is EMV complient (different powerup sequence).
    - Add support for driver aliasing for USB drivers. Allows to connect
      different readers like a 430 and a 432 at the same time. You will
      need pcsc-lite-1.1.2beta4 for that.
    - change USB timeout from 10 to 60 seconds.
    - check: do not use /usr/local/include by default since cpp will
      warning on some systems (recent RedHat systems).
    - optimize Makefile to limit restarting unnecessary check and building.
    - driver filename for USB is now versioned (ie libGemPC430.so.0.8.0).

0.7.4 - 20 November 2002, Ludovic Rousseau
    - add comment on how to compile the USB driver (install libusb, etc.)
    - add the ./check script (MacOS X is not concerned here).
      Many users add problems with a "undefined symbol: debug_msg" error
      when starting pcscd. It will now NOT be possible to compile the
      drivers unless the _minimum_ versions of libusb and pcsc-lite are
      installed.

0.7.3 - 18 October 2002, Ludovic Rousseau
    - The GemPC430 driver under Linux now support hotplug. With the
      previous versions the reader(s) needed to be plugged _before_
      pcscd is started.

0.7.2 - 15 October 2002, Ludovic Rousseau
    - very very small modification. The previous compilation problem was
      not corrected.

0.7.1 - 15 October 2002, Ludovic Rousseau
    - very small modification to ease or allow compilation on some
      platforms (all 11 Debian supported platforms except i386)

0.7.0 - 13 October 2002, Jean-Luc Giraud, Ludovic Rousseau
    - the drivers are now shipped with low level debug messages OFF
    - do not depend on makedepend(1) anymore. Use it if present only.
    - GemPC410:
      - retry the last command if GBP returns a wrong first byte (NAD).
        This will help some GemPC410 to work. Before pcscd had to be
        started a second time.
      - add support for GemCore Repeat requests
    - GemPC410/devfs/ contains configuration files for devfs Linux systems
    - README.430: add a note about /proc/bus/usb/ directory under Linux
    - usbserial_mosx.c:
      - better stability and multiple reader support
      - the productId is now read from the Info.plist. This allow to
        support readers like the 432 and 435 without recompiling the
        library
    - libusb_wrap.[c|h] new files to use libusb under Linux and other
      systems supported by libusb. The USB driver _should_ work under
      FreeBSD and OpenBSD but in fact does not.

0.6.5 - 16 August 2002, Ludovic Rousseau
    - update README with the new readers supported (412, 415, 432, 435)
    - we now use the debug facilities from pcscd. see "Supported
      pcsc-lite" section
    - GemPC410/gbpserial.c: the serial initialisation should work
    - GemPC430/usbserial_linux.c: support for 432 and 435 readers

0.6.4 - 21 May 2002, Ludovic Rousseau
    - common/GCCmds.c: perform a powerup without PPS managment if the
      powerup with PPS managment failed
    - */Makefile: correctly remove .dependencies files
    - change sys_errlist[errno] to strerror(errno) to be (more) ready
      for the Hurd

0.6.3 - 9 May 2002, Ludovic Rousseau
    - README.410: Add info on /dev/pcsc/ for OpenBSD and FreeBSD
    - Case1 APDUs are converted in ISO IN commands (with length=0)
      instead of ISO OUT commands
    - some code cleanup

0.6.2 - 01 Apr 2002, Ludovic Rousseau, Jean-Luc Giraud
    - Add support for TAG_IFD_SIMULTANEOUS_ACCESS in IFDHGetCapabilities
    - Restore automatic PPS management compatible with Cyberflex
    - GemPC430/usbserial_mosx.c: fixes for multi-reader support
    - GemPC410/gbpserial.c: complete reimplementation of serial port
      configuration

0.6.1 - 11 Mar 2002, Ludovic Rousseau
    - GemPC410/gbpserial.c:
      . modified again the port BAUDS setting during open().

0.6.0 - 7 Mar 2002, Ludovic Rousseau
    - GemPC410/gbpserial.c:
      . modified the port BAUDS setting during open().
      . Changed the timeout delay from 2 to 10 seconds
    - common/ifdhandler.c: IFDHTransmitToICC: now manages case 1 APDU
      (only CLA, INS, P1, P2) as an outgoing APDU (CLA, INS, P1, P2, 0)
    - add a debug level: PERIODIC for... periodic calls. Do not define
      DEBUG_LEVEL_PERIODIC in GemPC4?0/Config.h if you don't want to see
      periodic logs from GCCmdCardStatus(), IFDHSetCapabilities() and
      IFDHICCPresence()
    - add a note about support of the IBM-410p reader.

0.5.10 - 3 Mar 2002, Ludovic Rousseau, Jean-Luc Giraud
    - fix bug with some kind of Cyberflex Access cards:
      . disable PPS management
      . the reader stays at 9600 bauds in all cases
    - fix bug when more than 252 output bytes are expected and less than
      that are available (which is the case when the card sends an error)
    - modify install: rule to include release version number in
      filename, create symlinks, remove execution right on the .so lib
    - README.410: Add a script to create the /dev/pcsc/? links
    - GemPC430/GemPC430Utils.c, GemPC410/GemPC410Utils.c,
      common/GCCmds.c: guarantee that the os_string is \0 terminated
    - GemPC410/resetGemPC410.c, GemPC410/gbpserial.c: use
      cfgetospeed()/cfsetospeed() instead of accessing directly the
      termios structure
      . the driver now works under OpenBSD
    - common/ifdhandler.c: also log APDU results

0.5.9 - 30 Nov 2001, Jean-Luc Giraud
    - fix bug in GCUtils.c/gemcore_ISO_EXCHANGE_processing()
    - added ProjectBuilder folder for MacOS X

0.5.8 - 27 Nov 2001, Ludovic Rousseau
    - MANIFEST: do not contain non existing files
        include create_distrib.sh
    - create_distrib.sh: exit in case of error
        mkdir creates the parents directories if needed, 

0.5.7 - 27 Nov 2001, Ludovic Rousseau
    - GemPC430/usblinux.c: crashed with two readers and no root
      priviledges
    - GemPC410/main.c: test code now support ISO 7816 case 1, 2, 3 and 4
      using Jean-Luc ReaderTest Java applet (not included here)
    - common/GCUtils.c: add support for IFD_ICC_NOT_PRESENT GemCore
      error status
    - GemPC410/gbpserial.c: prepare to support multi serial readers
    - GemPC430/usbserial_mosx.c: prepare to support multi USB readers
    - GemPC410/gbpserial.c: use explain_gbp() to log a descriptive GBP
      level error message
    - MANIFEST: add README.410
    - GemPC410/GemPC410Utils.c: log "OS string" at CRITICAL level to
      always have it the logs
    - GemPC430/GemPC430Utils.c: log "OS string" at CRITICAL level to
      always have it the logs
    - common/ifdhandler.c: Add APDU logging
    - common/GCdebug.h: add DEBUG_COMM3() and DEBUG_CRITICAL3() which is
      typically used to log error messages like "blabla /foo/bar: file not
      found"

0.5.6 - 15 Nov 2001, Ludovic Rousseau
    - all: migrate the type return value from RESPONSECODE to ifd_t,
      status_t or gcore_t
    - GCCmds.c: migrate from low level GCSendCommand() use to higer
      level and simpler GCMakeCommand()
    - libGemPC410 now supports long commands

0.5.5 - 7 Nov 2001, Ludovic Rousseau
    include Jean-Luc modifications to add a new protocol layer
    patch GemPC410 to support this layer
    include patches from the Debian package

0.5.4 - 28 Oct 2001, Ludovic Rousseau
    first public release
    I clarified the licences

0.5.3 - 26 Oct 2001, Ludovic Rousseau
    GemPC 410 and GemPC 430 compiles and runs

0.5.2bis - 23 Oct 2001, Jean-Luc Giraud
    Jean-Luc starts to dispatch ifdhandler.c

0.5.2 - 22 Oct 2001, Ludovic Rousseau
    first release containing GemPC410/ GemPC430/ and common/

0.5 - 14 Oct 2001, Jean-Luc Giraud
    complete release containing the code for the GemPC 430

?.? - 25 Sep 2001, Jean-Luc Giraud
    release of ifdhandler.{c,h} and GemCore.h

$Id: README,v 1.36 2007-08-14 16:06:04 rousseau Exp $

 vim:ts=20