Hmm, don't know if you had to _buy_ anything, but I have the following setup:
- One GemPlus GemPC410
- One Bull SmarTLP3
and I had to install a myriad of packages to get it working, but I'm using
the OCF 1.2, GPK, PassThruCardService, and more... go get the following
packages:
http://www.gemplus.fr/developers/technologies/opencard/cardservices/gpk/download.html
http://www.gemplus.fr/developers/technologies/opencard/cardservices/service/download.html
http://www.gemplus.fr/developers/technologies/opencard/resources/Card_Drivers.htm
http://www.gemplus.fr/developers/technologies/opencard/cardterminals/download.html
http://java.sun.com/products/javacomm/index.html
and for reference:
http://www.gemplus.fr/developers/technologies/opencard/index.htm
I've also ripped something from Chris Muller's email to me when I was
getting started and attached it below =)
It took me a while to get everything running, so if there's any other help
you need don't hesitate to ask...
My opencard.properties:
----- Start file opencard.properties -----------
#OpenCard.trace = opencard:6 com.gemplus.opencard.service:6
com.gemplus.opencard.terminal:6 com.ibm.opencard.terminal:6
#OpenCard.trace = opencard:7 com.gemplus.opencard.service:7
com.gemplus.opencard.terminal:7 com.ibm.opencard.terminal:7
#OpenCard.trace = opencard:8 com.gemplus.opencard.service:8
com.gemplus.opencard.terminal:8 com.ibm.opencard.terminal:8
OpenCard.services =
com.gemplus.opencard.service.gpk.factory.GPKCardServiceFactory
#OpenCard.terminals =
com.gemplus.opencard.terminal.GemplusCardTerminalFactory|MyGCR|GCR410|COM2
OpenCard.terminals = com.ibm.opencard.terminal.pcsc10.Pcsc10CardTerminalFactory
---------- end file -----------------
note that I'm using the PCSC10 Passthrough card terminal factory for
everything, but since I'm using the Gemplus cards I'm using their card
service factory. This allows me access the smartcard through both the
Gemplus and Bull reader without issue. The lines beginning with a # are
commented out, but they are there for convenience so I can just uncomment
them when I need debugging information
I'm on a windows platform, and have also recompiled all of the OCF and GPK
because I was having some issues and I found that recompiling them resolved
these (?)... But in any case, that's all you need to get started.
-- Sean
A propos - Hey cool, you're in France too. Where do you come from / live /
work? I'm a "student" from Canada working here for a while... (You might
have been able to guess that I'm not a native from my english... :> )
Good luck...
At 03:57 PM 3/20/01 +0100, you wrote:
> I'm a student and I try to develop a project related to patient&doctor
>cards. My problem is that I have bought the GemXpresso 211 RAD v2.3 kit,
>and I have 2 cards but only one reader. But from a former project, I
>also have a PCSC reader bought from Bull with the CryptoKit.
> My question is: how can I use the second reader, because I understood
>that all the PCSC compatible readers can be used with OCF.
> In fact, I don't know what settings I have to make in the
>opencard.properties file.
>
>
>
>---
> > Visit the OpenCard web site at http://www.opencard.org/ for more
> > information on OpenCard---binaries, source code, documents.
> > This list is being archived at http://www.opencard.org/archive/opencard/
>
>! To unsubscribe from the [EMAIL PROTECTED] mailing list send an email
>! to
>! [EMAIL PROTECTED]
>! containing the word
>! unsubscribe
>! in the body.
========================================================================
========================================================================
STEPS IN INSTALLING OCF (e.g., under LINUX, SOLARIS, and WINDOWS)
========================================================================
========================================================================
The steps below are generic guidelines on how to install a running
OCF platform for any type of computer, however, the specified path
and idiosyncrasies correspond more to Unix platforms (e.g., Linux,
Solaris, AIX, etc.). If you wish to have install instructions
dedicated to the Windows platform, please see INSTALL-WINDOWS.
1. download and install Java
1.1 in http://java.sun.com/j2se/1.3/, select Java for your platform
and OS (between Solaris, Linux, and Windows) and download either a
JRE (for using only) or a SDK (for developing too). E.g., this gives:
=> /tmp/j2re-1_3_0-beta_refresh-linux.tar.gz
1.2 install Java in /usr/local/ or anywhere else you might choose:
$ cd /usr/local/
$ gzip -dc /tmp/j2re-1_3_0-beta_refresh-linux.tar.gz | tar xvf -
$ mv -i jre1.3 java
$ PATH=/usr/local/java/bin:$PATH ; export PATH
2. download and install Comm API
2.1 in http://java.sun.com/products/javacomm/, select a Java
Communications API implementation for your platform. E.g.:
=> /tmp/javax_comm-2_0_1-solsparc.tar.Z
2.2 Only for Linux, you also need to download RXTX in addition
to the Javax_comm implementation for Solaris (for the JAR
file). In http://www.rxtx.org/, select and download RXTX:
=> /tmp/rxtx-1.4-5.tar.gz
3. download and install OCF:
3.1 in http://www.opencard.org/index-downloads.shtml, select to
download "OpenCard Framework Base" Zip'ed
=> /tmp/BaseOCF.zip
3.2 install OCF 1.2 core and optional parts
$ cd /usr/local/
$ unzip /tmp/BaseOCF.zip
3.3 in http://www.opencard.org/index-downloads.shtml, select to
download "The OpenCard Framework Reference Implementaion V1.2" Zip'ed
=> /tmp/Reference_Impl.zip
3.4 install OCF 1.2 reference components and demos
$ cd /usr/local/
$ unzip /tmp/Reference_Impl.zip
3.5 install all OCF 1.2 JAR files in Java
$ cd /usr/local/OCF1.2/lib
$ cp -i base-core.jar base-opt.jar sb-demo.jar /usr/local/java/jre/lib/ext/
4. download and install Gemplus Components:
4.1 in
http://www.gemplus.fr/developers/technologies/opencard/cardterminals/download.html
select to download "gemplus-terminals-4.1.tar.gz"
=> /tmp/gemplus-terminals-4.1.tar.gz
4.2 in
http://www.gemplus.fr/developers/technologies/opencard/cardservices/service/download.html
select to download "gemplus-service-0.2.tar.gz"
=> /tmp/gemplus-service-0.2.tar.gz
4.3 in
http://www.gemplus.fr/developers/technologies/opencard/cardservices/gpk/download.html
select to download "gemplus-gpk-0.2.tar.gz"
=> /tmp/gemplus-gpk-0.2.tar.gz
4.4 install the Gemplus components in the centralized OCF zone
$ cd /usr/local/OCF1.2
$ gzip -dc /tmp/gemplus-terminals-4.1.tar.gz | tar xvf -
$ gzip -dc /tmp/gemplus-service-0.2.tar.gz | tar xvf -
$ gzip -dc /tmp/gemplus-gpk-0.2.tar.gz | tar xvf -
4.5 install all Gemplus JAR files in Java
$ cd /usr/local/OCF1.2/lib
$ cp -i gemplus-terminals-4.1.jar gemplus-service-0.2.jar
gemplus-gpk-0.2.jar /usr/local/java/jre/lib/ext/
4.6 check OCF and Gemplus components (CardTerminal at least):
$ cd /usr/local/OCF1.2/components/sb-demo/src/demos/samples/
$ emacs opencard.properties
------
OpenCard.services = opencard.opt.util.PassThruCardServiceFactory
OpenCard.terminals =
com.gemplus.opencard.terminal.GemplusCardTerminalFactory|mygcr|GCR410|COM1
------
$ java demos.samples.GetCardID
and insert a card. You should get the card ATR displayed.
4.7 optionally, install a gempluscardterminal.properties file, which
can be used for tuning Gemplus CardTerminal parameters.
$ cd /usr/local/java/jre/lib/
$ emacs gempluscardterminal.properties
------
# If you want to let OCF poll the reader status then add:
# polling = usespollinglist
# Or If you want to define a thread to poll the reader at sleeptime then add:
polling = usesthread
#
# Time used to stop the thread for a period of time (in mili-seconds):
sleeptime = 500
------
========================================================================
========================================================================
INSTALLATION TROUBLESHOOTING FAQ
========================================================================
========================================================================
Test command: $ java -verbose -version
o java: command not found
=> Check that Java is installed and in your PATH (java/bin or java/jre/bin)
Second Test command: $ java demos.samples.GetCardID
o Can't find class xxx
=> Check that all JAR files for OCF base, opt, and demos have been installed
(in java/jre/lib/ext). Check also that needed components have been
installed, e.g., gemplus-terminal, gemplus-service, or gemplus-gpk.
o property file not found
------------------------------------------------------------
start use case: get a card ID
OpenCardPropertyLoadingException:
property file not found
finished use case: get a card ID
------------------------------------------------------------
=> Check that there is at least one property file that exist and is
readable for your current account. In order to find where OCF is
looking for opencard.properties, run:
$ java demos.tools.findOCP
o CardTerminalException: null
------------------------------------------------------------
start use case: get a card ID
CardTerminalException:
null
finished use case: get a card ID
------------------------------------------------------------
=> There are two possible cause for this same message here: one
is a mis-installation of the Comm API's properties file, while
the other is a bad spelling for the actual serial port you
want to use, this name being most of the time dependant on the
platform/OS and sometimes too alas on the type of JDK...
Firstly, check that the Comm API layer has been installed,
i.e., comm.jar in jre/lib/ext, javax.comm.properties in jre/lib/,
and the .so or .dll file (as specified by javax.comm.properties)
in a location that can be found by the Operating System, e.g.,
in jre/lib/sparc or jre/lib/i386 (on Linux) or jre/bin (on Windows).
Note: with properties file but w/o DLL, Java gives a different
type of error but still with the "null" message, e.g., on Solaris:
Error loading SolarisSerial: java.lang.UnsatisfiedLinkError:
no SolarisSerialParallel in java.library.path
Caught java.lang.UnsatisfiedLinkError: readRegistrySerial while loading
driver com.sun.comm.SolarisDriver
CardTerminalException:
null
Secondly, if everything is working well at the Comm layer, check that
you have not misspelled the name of the serial port you intend to
use. These names are different on different platforms, e.g., on
Linux, Solaris, or Windows, you can have respectively /dev/ttyS0
(S1, etc.), /dev/term/a (/b, etc.), or COM0 (COM1, etc.). Also be
warned that the Comm API that comes with JDK1.3 for Linux *from IBM*
is using windows name on Linux :-( (e.g., COM0, COM1, etc.) so on
Linux you should also check which kind of JDK you are using!
A very convenient way of: 1) finding the available ports and their
names and 2) test that you can open them is actually to try to run
one of the demos of the Comm API:
$ cd commapi/samples/SerialDemo/
$ java SerialDemo
which will open a GUI with a menu containing all known ports (if
this menu is empty, Comm is not well installed!). Try to select
the one you want to use, Open, then Close the port.
o Can't open Communication port
------------------------------------------------------------
start use case: get a card ID
CardTerminalException:
Can't open Communication port
finished use case: get a card ID
------------------------------------------------------------
=> Check the name of serial port(s) that is (are) specified
in the properties file. For Windows it should be COM1,
COM2, etc. For Linux /dev/sttyS0, /dev/sttyS1, etc. and
for Solaris /dev/term/a, /dev/term/b, etc.
One good test is to run the javax.comm SerialDemo (see
paragraph above) to get all the listed ports in a menu
(auto-discovered by the Comm API driver).
o Invalid reader
------------------------------------------------------------
start use case: get a card ID
CardTerminalException:
Invalid reader!
finished use case: get a card ID
------------------------------------------------------------
=> You have this message when the specification of the reader
type in the properties file does not match the actual reader
type. First check that the reader type is the one specified.
Then, if it is the case try to reset the card reader (just
unplug it and plug it again) because sometimes, either the
Gemplus API or PC/SC can switch it to an OROS mode (for
legacy applications) that is not coherent with what is declared
in the properties file (GCR410, i.e., GemCore!).
There might be other troubleshooting entries added in the future:
this page is a work in progress! Do not hesitate to contribute
yourself!
Wed Sep 6 2000
[EMAIL PROTECTED]
========================================================================
========================================================================
STEPS IN INSTALLING OCF under WINDOWS
========================================================================
========================================================================
The steps below are dedicated to the Windows platform: Win9x or NT.
We have chosen to give examples using an installation location that
is C:\ocf, of course you can specify whatever folder name you wish.
0. Create C:\ocf\ folder for gathering all necessary software.
1. download and install Java
1.1 in http://java.sun.com/j2se/1.3/, select Java for the Windows
platform and download either a JRE (for using only) or a SDK
(for developing too). E.g., this gives:
=> C:\temp\j2re1_3_0-win.exe
1.2 install Java in C:\ocf\java\ or anywhere else you might choose:
o double-click on j2re1_3_0-win.exe
o select for install folder C:\ocf\java\
1.3 check by opening an MSDOS Command Prompt window and type:
> java -verbose -version
to test that Java is found and can be run.
From now on, if you have installed a "Java Runtime Environment" (JRE)
replace the 'C:\ocf\java\' paths below by the one you actually have,
e.g., 'C:\ocf\java\jre1.3\'. On the other hand, if you have chosen
to install a "Java Development Kit" (JDK), then replace the
'C:\ocf\java\' paths below by your 'jre' portion of the JDK,
e.g., 'C:\ocf\java\jdk1.3\jre\'.
So for instance, in the JDK case, when we say 'C:\ocf\java\lib\ext\',
you should read 'C:\ocf\java\jdk1.3\jre\lib\ext\'.
2. download and install Comm API
2.1 in http://java.sun.com/products/javacomm/, select a Java
Communications API implementation for Windows. E.g.:
=> C:\temp\javaxcomm20-win32.zip
2.2 install Comm API in C:\ocf\commapi\ :
o double-click on javaxcomm20-win32.zip
o extract all files in C:\ocf\
=> will create C:\ocf\commapi\
o in an MSDOS Command Prompt window, type:
> cd C:\ocf\commapi\
> copy comm.jar C:\ocf\java\lib\ext\
> copy javax.comm.properties C:\ocf\java\lib\
> copy win32com.dll C:\ocf\java\bin\
2.3 check by opening an MSDOS Command Prompt window and type:
> cd C:\ocf\commapi\samples\BlackBox\
> java -cp BlackBox.jar BlackBox
to test that Comm API is found and can find the ports.
Note: if PC/SC is running on your PC, you will have to shutdown
it otherwise, as it locks the ports, you will have an "port in use"
execption. To do it select "Start/Control Panel/Gemplus Smart Card Reader",
and remove the line corresponding to the port you want to use with OCF.
3. download and install OCF:
3.1 in http://www.opencard.org/index-downloads.shtml, select to
download "OpenCard Framework Base" Zip'ed
=> C:\temp\BaseOCF.zip
3.2 in http://www.opencard.org/index-downloads.shtml, select to
download "The OpenCard Framework Reference Implementaion V1.2" Zip'ed
=> C:\temp\Reference_Impl.zip
3.3 install OCF in C:\ocf\OCF1.2\ :
o double-click on BaseOCF.zip
o extract all files in C:\ocf\
=> will create C:\ocf\OCF1.2\
o double-click on Reference_Impl.zip
o extract all files in C:\ocf\
=> will create C:\ocf\OCF1.2\ (with different files!)
3.4 install all OCF 1.2 JAR files in Java
o in an MSDOS Command Prompt window, type:
> cd C:\ocf\OCF1.2\lib\
> del gemplus-terminals.jar (we are going to take the last version!)
> copy *.jar C:\ocf\java\lib\ext\
4. download and install Gemplus Components:
4.1 in
http://www.gemplus.fr/developers/technologies/opencard/cardterminals/download.html
select to download "gemplus-terminals-4.1.zip"
=> C:\temp\gemplus-terminals-4.1.zip
4.2 in
http://www.gemplus.fr/developers/technologies/opencard/cardservices/service/download.html
select to download "gemplus-service-0.2.zip"
=> C:\temp\gemplus-service-0.2.zip
4.3 in
http://www.gemplus.fr/developers/technologies/opencard/cardservices/gpk/download.html
select to download "gemplus-gpk-0.2.zip"
=> C:\temp\gemplus-gpk-0.2.zip
4.4 install the Gemplus components in the centralized OCF zone
o double-click on resp. gemplus-terminals-4.1.zip,
gemplus-service-0.2.zip, and gemplus-gpk-0.2.zip
o select for install folder C:\ocf\OCF1.2\
=> will create C:\ocf\OCF1.2\lib\.. and C:\ocf\OCF1.2\components\..
4.5 install all Gemplus JAR files in Java
o in an MSDOS Command Prompt window, type:
> cd C:\ocf\OCF1.2\lib\
> copy gemplus*.jar C:\ocf\java\lib\ext\
4.6 check OCF and Gemplus components (CardTerminal at least)
by opening an MSDOS Command Prompt window and type:
> cd C:\ocf\OCF1.2\components\sb-demo\src\demos\samples\
> notepad opencard.properties
------
OpenCard.services = opencard.opt.util.PassThruCardServiceFactory
OpenCard.terminals =
com.gemplus.opencard.terminal.GemplusCardTerminalFactory|mygcr|GCR410|COM1
------
> java demos.samples.GetCardID
and insert a card. You should get the card ATR displayed.
4.7 optionally, install a gempluscardterminal.properties file, which
can be used for tuning Gemplus CardTerminal parameters.
> cd C:\ocf\java\lib\
> notepad gempluscardterminal.properties
------
# If you want to let OCF poll the reader status then add:
# polling = usespollinglist
# Or If you want to define a thread to poll the reader at sleeptime then add:
polling = usesthread
#
# Time used to stop the thread for a period of time (in mili-seconds):
sleeptime = 500
------
See also INSTALL for a troubleshooting FAQ section.
Wed Jan 3 2001
[EMAIL PROTECTED]
---
> Visit the OpenCard web site at http://www.opencard.org/ for more
> information on OpenCard---binaries, source code, documents.
> This list is being archived at http://www.opencard.org/archive/opencard/
! To unsubscribe from the [EMAIL PROTECTED] mailing list send an email
! to
! [EMAIL PROTECTED]
! containing the word
! unsubscribe
! in the body.
