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.8 - 14 December 2017, Ludovic Rousseau
- fix typo in log message
1.0.7 - 8 April 2012, Ludovic Rousseau
- add GemPC430/50-pcscd-ifd-gempc.rules udev file
- Use CFLAGS and LDFLAGS in Makefile (Debian bug #667931)
1.0.6 - 16 June 2010, Ludovic Rousseau
- fix an error in opening a serial port
Thanks to Joerg Hartenberger for the patch
- fix spelling error
1.0.5 - 12 April 2009, Ludovic Rousseau
- correctly manage LDFLAGS
Thanks to Arfrever Frehtes Taifersar Arahesis for the patch
- correct compilation warnings
1.0.4 - 15 October 2008, Ludovic Rousseau
- Allow the header to be read in several calls
Previously, if the header was not read in a single read() calls,
there was an error. This is an issue because some commands return
the two first bytes, then a small pause, then the rest of the
header ...
At least this happens on a gci410emv connected thru an usb adapter
... Now it works fine.
Patch from Sylvain Munaut
- Fix powerup sequence when switching to ISO mode
If somehow the reader/card was in EMV mode, we need to switch it
to ISO. This was done but the final attemp to powerup tried to
power it up in EMV mode ... most likely a typo.
Patch from Sylvain Munaut
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.42 2017/12/14 17:50:29 rousseau Exp $
vim:ts=20