1. ct-solaris.zip Driver
2. readme.txt File Contents

readme.txt Driver File Contents (ct-solaris.zip)

===============================================================================

 KOBIL Systems GmbH

===============================================================================

 CT-API driver and PC/SC-Plugin
 - 32 Bit Version -
===============================================================================


 Version:
 -------- 

    2009.07.09


 Supported KOBIL Smart Card Terminals:
 -------------------------------------
 
  - KAAN Standard RS232
  - KAAN Standard Plus RS232
  - KAAN Twin RS232
  - SecOVID Reader RS232
  - SecOVID Reader Plus RS232
  - KAAN Professional RS232
  - B1 Professional RS232
  - CT-B1-S RS232
  - PCMCIA Reader B1
  - KOBIL KAAN Base RS232
  - KOBIL KAAN Advanced RS232


For testing only:
  - KOBIL KAAN Base USB						(beta status!)
  - KOBIL KAAN Advanced USB					(beta status!)
  - KOBIL KAAN SIM III  / mIDentity Light			(beta status!)
  - KOBIL SecOVID Reader III / EMV TriCAP Reader / KAAN TriB@nk	(beta status!)
  - KOBIL mIDentity L, XL, XXL (in composite device mode only,   beta status!)


 Supported Operating Systems:
 ----------------------------  

  - Solaris 9 or newer (on SPARC).

    Note that using the USB readers on Solaris 9 will only be possible if
    you manage to find a suitable libusb. For Solaris 10, the libusb
    delivered with the system (in /usr/sfw/lib) should be fine.


 Required Packages:
 ------------------

  For KOBIL KAAN Base USB, KOBIL KAAN Advanced USB, KOBIL KAAN SIM III,
  SecOVID Reader III, EMV TriCAP Reader, KAAN TriBank and KOBIL mIDentity
  two additional packages are required, namely:

  - LIBCCID 1.x
    (download from http://pcsclite.alioth.debian.org/ccid.html)
    please pay attention to notes about libusb versions there!

    Warning: Depending on the smart cards you want to use, you
    might need at least libccid-1.2.0, in particular, some SECCOS
    cards (used for home banking in germany) do not work with older
    versions.

    Many thanks to Ludovic Rousseau for his support

  - MUSCLE framework pcsc-lite-1.3.x, 1.4.x, or 1.5.x
    (download from http://alioth.debian.org/projects/pcsclite/ )


 Installation notes for readers using the MUSCLE framework:
 ----------------------------------------------------------

  - Follow the libccid installation instructions
    (including libusb and pcsclite).
  
  If you also want to use the CT-API interface:

  - copy libct.so from the driver CD to your executable 
    library dir (like /usr/lib or so)

  - edit ~/.CT_devices (or /etc/CT_devices) 
    and add the Port Index you want to use:

    Port1=PCSC;KAAN Advanced 00 00;3;0;KAAN Advanced USB over PCSC
    or
    Port1=PCSC;KAAN Base 00 00;3;0;KAAN Base USB over PCSC
    or
    Port1=PCSC;KAAN SIM III 00 00;3;0;KAAN SIM III over PCSC
    or
    Port1=PCSC;KOBIL mIDentity 00 00;3;0;KOBIL mIDentity over PCSC

    depending of your smart card reader type.

Note: The name string in the above lines (e.g. KAAN Advanced 00 00) must
      match whatever pcscd finds - it might e.g. include an additional
      serial number, depending on the exact version of pcsc-lite. To see
      what string you need to use, you can start pcscd in foreground mode,
      e.g. via /usr/sbin/pcscd -f
      Alternatively, you can use a couple of magic strings to specify
      - a substring the reader name should contain ([CNT="substring"]),
      - a serial number the reader should have ([SN="serial number" ],
      - or the index (starting with 1) of the reader in the list of
           readers given by PC/SC lite ([IDX="nr"]),
      for example:

	Port1=PCSC;[CNT="KAAN Advanced"];3;0;KAAN Advanced USB over PCSC
        or
	Port1=PCSC;[IDX="3"];3;0;Third reader found by PCSC

      If you start with a fresh .CT_devices (or if you reset DefaultPortType
        to 0), unknown port indices are handled as follows: For indices 1
        through 4, CT-API will try to open a serial reader at the given
        port, for indices 5 and higher, CT-API will try to open the PCSC
        reader with the index decreased by 4, i.e. if you start with a
        fresh .CT_devices, after attempting to open Ports 1 through 8, it
        will contain lines like those:

Port1=COM;/dev/ttyS0;1;0;serial reader at /dev/ttyS0: B1/Kaan Pro
Port2=COM;/dev/ttyS1;1;0;serial reader at /dev/ttyS1: unknown reader
Port3=COM;/dev/ttyS2;1;0;serial reader at /dev/ttyS2: B1/Kaan Pro
Port4=COM;/dev/ttyS3;1;0;serial reader at /dev/ttyS3: unknown reader
Port5=PCSC;[IDX="1"];3;0;reader via PCSC [IDX="1"]: transparent
Port6=PCSC;[IDX="2"];3;0;reader via PCSC [IDX="2"]: transparent
Port7=PCSC;[IDX="3"];3;0;reader via PCSC [IDX="3"]: transparent
Port8=PCSC;[IDX="4"];3;0;reader via PCSC [IDX="4"]: transparent


 Installation notes for readers NOT using the MUSCLE framework:
 --------------------------------------------------------------

Depending on your application you might want to use the MUSCLE framework
to connect to your reader. If you are using one of the readers which
always use the MUSCLE framework, this is obviously not a problem. For the
other readers, a so-called interface device handler (IFDH), i.e. a plugin
for the MUSCLE PC/SC lite framework, is provided by libkobil_ifd.so.
To use this handler, you may proceed as follows:

  - First, install libct.so and libkobil_ifd.so to a directory in your
    library search path.

  - If the PC/SC lite framework is not yet installed, install it,
    following the instructions of pcsclite (ccid and libusb are not
    strictly needed for those readers).

  - Last copy reader.conf to /etc and adapt it to your needs: 
    * enter the correct absolute path to libkobil_ifd.so
    * enter the correct "CHANNEL".


 Files included in this package:
 -------------------------------

  - readme.txt       this text file
  - libct.so         CT-API driver 
  - libkobil_ifd.so  PC/SC driver plugin (for MUSCLE PC/SC lite framework)
  - reader.conf      sample configuration file for PC/SC driver
  - cardping         sample program to send APDUs to terminal/cards
  - development.txt  some hints for software developers
  - ct_api.h         header file for developpers.
  - libct.a          static version of CT-API driver for developpers

===============================================================================