4. Obtaining and Installing the Software

4.1 Obtaining the software

The main source of software is the MUSCLE web-site. The PC/SC lite middleware should be downloaded from http://www.linuxnet.com/middle.html and drivers from http://www.linuxnet.com/sourcedrivers.html.

Note: The GemPlus reader driver available from the above sites does not work well with the University Card. Instead, you should use the modified version available from http://www.srcf.ucam.org/~rjw57/sc.

4.2 Installing the software

PC/SC lite middleware

Download the pcsc-lite-x.x.x.tar.gz file to a convenient location. The x.x.x denotes the version number of the software. The latest version at the time of writing is 0.9.3.

Open a terminal and change to the directory the file was downloaded to. Enter the following commands:

  $ gunzip -c pcsc-lite-*.tar.gz | tar xv
  $ cd pcsc-lite-x.x.x     # Replace x.x.x with version
  $ ./configure --prefix=/usr/local/pcsc
  $ make
  $ su
  Password: (enter root password)
  # make install
  # exit
  $

The PC/SC lite software will then be installed to /usr/local/pcsc. Note: Under Solaris, you may have to modify the Makefile to add the following linker flags:

  -lsocket -lnsl -lrt

Reader drivers

Download the reader drivers and install as per instructed by files which came with the driver. If you have the GemPlus serial reader driver note that the GemPlus readers have problems understanding the Answer to Reset (ATR) response of the card. To use the card with GemPlus readers, you must download the correct driver from this site and perform the following steps.

Open a terminal and change to the directory you downloaded the libgemcore-hacked.tar.gz file to and enter the following commands:

  $ gunzip -c libcamgemcore-x.x.x.tar.gz | tar xv
  $ cd libcamgem*
  $ ./configure
  $ make
  $ su 
  Password: (enter root password)
  # make install
  # exit
  $

Then edit /etc/reader.conf to point to the libcamgemcore.so.0.0.0 file which has been created as per the next section.

Configuration

The main configuration file is /etc/reader.conf. This file should contain an entry for each driver of the following form:

  FRIENDLYNAME     "FooBar Inc. FB100 reader"
  DEVICENAME       FOOBAR_FB100
  LIBPATH          /usr/lib/libfoobar.so.1.0.0
  CHANNELID        0x0102F8

Where the fields have the following meanings:

• FRIENDLYNAME -- Any descriptive name for the reader.
• DEVICENAME -- Any shorter name.
• LIBPATH -- Full path to the driver library.
• CHENNELID -- The serial port the reader is connected to, taken from the following table:
  • 0x0103F8 -- COM1 or /dev/ttyS0
  • 0x0102F8 -- COM2 or /dev/ttyS1
  • 0x0103E8 -- COM3 or /dev/ttyS2
  • 0x0102E8 -- COM4 or /dev/ttyS3

Invocation

To launch the PC/SC middleware, you may need to set some environment variables. If you are using the Bash shell then the following commands should launch the PC/SC middleware:

  $ su
  Password: (enter root password)
  # export PATH=$PATH:/usr/local/pcsc/bin
  # export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/pcsc/lib
  # pcscd