This page describes how to download, and install the Apduio CardTerminal component that allows to communicate with a process running the Sun's JavaCard simulator (found in the Java Card 2.1.2 Development Kit. See also the Apduio CardTerminal Home-Page for a complete on-line documentation set about this component. This is a first alpha version and is provided AS-IS. See the Important Note section below.

IMPORTANT NOTE: The presented Java software code is an alpha-version for developers and IS PROVIDED AS-IS by Gemplus and potentially many other contributors (see the RCS log files). Thus this code is provided to you without any warranty of any kind! Please see the LICENSE file for more details. Therefore, this code has not been tested by many people yet; it may contain bugs or even semantic misbehaviour; and it has not been reviewed as a supported Gemplus product. Comments, problem reports, or even submissions of source code enhancements or patches are highly welcome.

Distribution
		or

Two distribution files are available: one in "tar.gz" format, and one in "zip" format. Select the one corresponding to your platform and/or available unpacking tools, e.g.,

• if you are under Unix, download: "apduio-terminal-0.1.tar.gz"

• if you are under Windows, download: "apduio-terminal-0.1.zip"

Note that the "tar.gz" file is significantly smaller (30% smaller), so if you have the right WINZIP plugin for "tar.gz" files, it is advised to choose this one.

This sections explains how to install the Apduio CardTerminal. For other types of CardTerminals, see their related "Download Page". Note that if you are not using the CardTable platform, there are some prerequisites before being able to use OpenCard components. See the prerequisites page for more details.

For installing Gemplus Apduio CardTerminals component:

1. first, download "apduio-terminal-0.1.zip" or "apduio-terminal-0.1.tar.gz" (see above),

2. unpack the distribution in the directory containing OCF, this should provide new files and directories among which: "lib/apduio-terminal-0.1.jar",

3. insert "lib/apduio-terminal-0.1.jar" into your CLASSPATH environment variable (JDK 1.x) or copy this JAR file into your jre/lib/ext/ directory (JDK 1.2 or 1.3).

4. develop your own CardServices and Smart Card enabled applications that requests and make use of CardTerminals (see the OpenCard Programmer's Guide for more details).

5. configure your "opencard.properties" in order to use the ApduIOCardTerminalFactory factory.

   Example: Using a JavaCard simulator running on localhost, type in your "opencard.properties" file (on one line):

   
   OpenCard.services = opencard.opt.util.
      PassThruCardServiceFactory
   
   OpenCard.terminals = com.gemplus.opencard.terminal.apduio.
      ApduIOCardTerminalFactory|mySim|Socket|localhost:9025
   
   

More detailed User's information on the CardTerminals component (e.g., new features, complete User's Guide, etc.) and Developer's informartion (e.g., pointers to Javadocs and sources) is given in the Apduio CardTerminal Home-Page.