CTAPI4OCF Driver Version 1.0
for Linux and Windows 9x/NT/2000

© 2000 CardContact Software & System Consulting

 

CardContact Software & System Consulting takes no warranty for the use of this program.
It is provided „as is“ and you may use it at your own risk!!

 

This driver implements a CTAPI driver for the OpenCard Framework. It´s purpose is to make the CTAPI-interface available for applications using the OpenCard Framework. It can be used as an alternative to PC/SC.

Requirements:

Support/Troubleshooting

If you have any problems with this package feel free to contact us at info@cardcontact.de.

Installation

There is a fully functional version of this driver already included in this package. You do not need to recompile it yourself (but you can).
All you have to do is add the „ctapi4ocf.jar“ to your CLASSPATH or extract CTAPI4OCF to a directory that is included in your CLASSPATH.



BUILDING

Linux:

Extract the all files using "jar -xzf ctapi4ocf.jar" . This will create the needed directory structure.
Change your directory to "/de/cardcontact/opencard/terminal/ctapi4ocf" and type "make". If the compiler completes add the home directory of the CTAPICardTerminal to your CLASSPATH. This makes the CTAPI classes available for the java environment. Then either copy the supplied opencard.properties to the directory of your application or edit your existing file accordingly.

Windows:

Extract the all files using the Java JAR tool or any other program that can handle JAR-files.
This will create the needed directory structure.
Change your directory to "/de/cardcontact/opencard/terminal/ctapi4ocf" and type "make -f makefile.w32". If the compiler completes add the home directory of the CTAPICardTerminal to your CLASSPATH. This makes the CTAPI classes available for the java environment. Then either copy the supplied opencard.properties to the directory of your application or edit your existing file accordingly.


Testing:

A small test file has been included, which is created automatically. This program was tested and developed with ORGA´s ECO 5000 card reader
Connect your card reader to your PC, insert a card and type "java de.cardcontact.opencard.terminal.ctapi4ocf.CTAPICardTerminal". Make sure that the "opencard.properties" file is correctly configured. The program will start the OpenCard Framework, reset the card, display the ATR and issue a SELECT MF command (which should response with 6xxx or 9xxx). Finally the EJECT ICC command is sent to the card terminal and the OpenCard Framework is shut down.

If the test program was successful, the CTAPI4OCF interface was set up correctly. You can now use the CTAPI interface with the OCF classes. See the OCF documentation and examples for further information.