***************************************************************

Title   : README 
Hardware: ASE III USB Smartcard Reader
Company : Athena Smartcard Solutions, http://www.athena-scs.com
Version : 1.0
LICENSE : See file LICENSE

Required: gcc 2.7 or higher, Linux kernel 2.4.x with USB support

***************************************************************


 What you need:
================

Get the latest version of PCSC Lite by David Corcoran.
You can get the latest version of PCSC Lite from:

http://www.linuxnet.com/middle.html

Follow the instructions and install it on your computer.


 Installing the ASE III USB driver:
====================================

To complie this package from a Linux prompt edit the Makefile and 
determine if the compiler and linker flags are appropriate for your
system. When finished type:
 # make

This will create a kernel module called AseIIIReader.o and a shared
library called ifd-AseUSB (under ifd-AseUSB.bundle/Contents/Linux) which is
the library used to talk to the IFD Handler interface.  

You must be root to install all the files to their locations.
To run the installation script simply type:
 # sh install

NOTE: Under some versions of Linux the following modifications are required 
in case the driver's compilation fails:

- Add "-D_LOOSE_KERNEL_NAMES" flag to CFLAGS in the Makefile.
- Add the "#undef _LOOSE_KERNEL_NAMES" line on the first line in both Ase.h and ifdhandler.c


 Starting and testing:
=======================

To start the pcsc daemon you'll need root privileges.

 # /usr/local/pcsc/bin/pcscd

You should be able to communicate with the reader by now.

There is a small test program called "testpcsc" that comes with the 
pcsc-lite package. Refer to the pcsc-lite's README for compilation instructions.
This program tries to connect to the selected reader and to get the ATR.


 Notes:
========

- To see the driver's debug messages, add -DASE_DEBUG to CFLAGS 
in the Makefile. Recompile and rerun the installation script. Note that
the messages are written to the system log (usually: /var/log/messages).

- The driver is mapped by default into major:minor 180:224 up to 180:239.
If these minor numbers collide with another driver on your machine,
you may replace them. This should be done in two places: in the INSTALL 
script (the minor variable) and in the AseIIIReader.c (the READER_BASE_MNR define).
You'll need to recompile and reinstall the driver after the changes.

- The installation script assumes you are using the bash shell.

- If the reader fails to function, check if your system supports usb. 
To do so, check if /proc/bus/usb/ exists, and if yes "cd" into this directory. 
Run the command "cat devices" and check if the reader appears. 
Then try "cat drivers" - the following line should appear:
  
 224-239: ASE III USB Smart Card Reader
  
If not, try to re-boot the system. (If your system does not support usb, you may need 
to reinstall/reconfigure it.)
 
Run the command "lsmod" and see if the AseIIIReader is present. Also, if
the driver has been successfully installed, then after rebooting its registration
and startup messages should appear in the system log file.
  

 Questions:
============

For questions, please email at: support@athena-scs.com


