Main Page | Index

Axis Software User Manual


Creating the Configuration Files

There is only one main configuration file, the `reader.conf' file which is used by the PCSC daemon to know which Smart Card drivers to load and where to find those user-mode drivers.

The `reader.conf` file is shown below:

# Configuration file for pcsc-lite

FRIENDLYNAME     "BasicCard Reader"
DEVICENAME       GEN_SMART_RDR
LIBPATH         /usr/local/pcsc/drivers/libaxis-smart-card.so
CHANNELID        0x00000001

# End of file

For the moment the above file is all that is needed to talk to the Axis Smart Card reader after all the libraries and daemons are installed.

FRIENDLYNAME - Is a user friendly name of the reader that is served by this driver. This name is displayed to the user when necessary.

DEVICENAME - Is a driver specific value. If you do not know this value, GEN_SMART_RDR is a good choice.

LIBPATH - Is the full path to the shared library.

CHANNELID - Is the channel ID for serial port Smart Card readers. This number is used by the driver to decide where the driver is located in the Linux device tree. A channel ID of '0x00000001' shown as above means use '/dev/axis_0/smart_card as the device for smart card communications, so this user mode driver will communicate with the Smart Card via this device node.

Once all the libraries are compiled and installed correctly there is a system 5 initialisation script that can be used to start the smart card reader at boot time.

Putting it All Together

Once all this is done the Smart Card is inserted in to the Smart Card socket and the system powered up. If the pcscd daemon is not started at startup then start it now and the system will be ready to accept communications with the Smart Card. At which point executing the test program smart-fpga-auth will cause a Smart Card authentication to occur.

A successful demo FPGA authentication output from the above demo program would look as follows:

The FPGA autherntication procedure occured without error.

If there was an error while trying to perform a Smart Card / Heber Security Device authentication, the following out would be displayed:

ZCCriGetDefaultReader returned 1000008 - ZCBCI_ERROR_UNKNOWN
An error occured opening the smart card we're toast

This error was simulated by not starting the pcscd daemon and trying to perform an authentication request.


© HEBER LTD. 2005. This document and the information contained therein is the intellectual property of Heber Ltd. and must not be disclosed to a third party without consent. Copies may be made only if they are in full and unmodified. The information contained in this documentation is believed to be accurate and reliable. However, Heber Ltd. assumes no responsibility for its use, and reserves the right to revise the documentation without notice.
Document No: 80-17794, Issue 4r1    Release Date: 01.12.05     Email: support@heber.co.uk    www.heber.co.uk