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

Title   : README 
Hardware: ASEKey Smartcard Reader
Company : Athena Smartcard Solutions, http://www.athena-scs.com
Version : 3.7 
LICENSE : See file LICENSE

Required: gcc 2.7 or higher, Linux kernel 2.4 or higher

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

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

1) 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.


2) The ASEKey driver uses the libusb library to access USB devices. 
It can be downloaded from:

http://libusb.sourceforge.net/

You need to install this library and in particular its usb.h file which is 
needed in the driver's compilation under GNU/Linux.


 Installing the ASEKey driver:
===========================================

To complie this package from a Linux prompt use the following:
 # ./configure
 # make
 # make install

The driver installs itself to /usr/local/pcsc/drivers by default.
To change this edit the Makefile and the etc/reader.conf file.

This will create a shared library called libASEKey.so under the ifd-ASEKey
directory which is the library used to talk to the IFD Handler interface. 

To install this reader into the PCSC/Lite Architecture simply edit the 
etc/reader.conf file included in the package and set the LIBRARY_PATH 
to the location of the shared library.  
An example reader.conf that supports 2 readers is provided in the etc 
directory.  

Since the reader is a USB device, the CHANNELID is not an actual serial 
port number. Currently the driver supports up to 16 readers, and their 
CHANNELID should be set to the numbers 1..16.  

When finished, simply copy the reader.conf file to /etc on your system.

NOTE: If a /etc/reader.conf file already exists on your system, simply append the 
contents of the edited file to the end of the exisiting one.


 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).

- In order to use the USB ports your kernel needs to support usbdevfs.
You should have the following results:

$ grep usb /proc/devices 
180 usb
$ grep usb /proc/filesystems 
nodev   usbdevfs
nodev   usbfs

If it is not the case, you may have to recompile your kernel. More details
are available at: 

http://www.linux-usb.org/


- 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. 

If your system does not support usb, you may need to reinstall/reconfigure it.
More details can be found at: /usr/src/linux/Documentation/usb/proc_usb_info.txt
and at: http://linux-hotplug.sourceforge.net/


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

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


