This page describes how to download, and install the PC/SC CardTerminal component that acts as a wrapper around the PC/SC Resource Manager. It allows to acces potentially all Smart Card Readers that have a valid PC/SC driver for the given platform. E.g., concerning Gemplus readers, the following readers have PC/SC drivers: on Windows all PC-link readers: Serial (GemPC410), Parallel (GemPC-Touch 440), PCMCIA (GemPC400), USB (GemPC430), or contactless (GemEasy family), and on Linux and MacOS X: Serial (GemPC410), PCMCIA (GemPC400), USB (GemPC430). See also the PC/SC CardTerminal Home-Page for a complete on-line documentation set about this component. This is a first patched version from the official OCF 1.2 distribution and is provided AS-IS. See the Important Note section below.

IMPORTANT NOTE: The presented Java software code is a beta-version for developers and IS PROVIDED AS-IS by IBM, 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: "pcsc-wrapper-2.0.tar.gz"

• if you are under Windows, download: "pcsc-wrapper-2.0.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 PC/SC wrapper 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 Serial Readers CardTerminals component:

1. first, download "pcsc-wrapper-2.0.zip" or "pcsc-wrapper-2.0.tar.gz" (see above),

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

3. insert "lib/pcsc-wrapper-2.0.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. IMPORTANT:remove "lib/reference-terminals-windows.jar" from your CLASSPATH environment variable (JDK 1.x) or jre/lib/ext/ directory (JDK 1.2 or 1.3). This is necessary, because otherwise the Java Virtual Machine might load and use the previous version instead of the current one!

   Note that the .DLL file is unchanged, as are the .C/.H files, so you don't need to replace the one that came with the OCF 1.2 distribution.

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

6. configure your "opencard.properties" in order to use the Pcsc10CardTerminalFactory factory.

   Example 1: Using any reader declared for PC/SC (the list of available readers is automatically computed), type in your "opencard.properties" file (on one line):

   
   OpenCard.terminals = com.ibm.opencard.terminal.pcsc10.
      Pcsc10CardTerminalFactory
   
   

   Example 2: Specify SHARED or EXCLUSIVE options and/or specify a specific reader, type instead (on one line):

   
   OpenCard.terminals=com.ibm.opencard.terminal.pcsc10.
      Pcsc10CardTerminalFactory|my|GCR410|SHARED
   
   

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