Projects : Smart Cards : Cyberflex Access Starter Kit

Cyberflex Access Starter Kit and UNIX Smartcard Development Environment

Description

Cyberflex Access 16K from Schlumberger is a smartcard that complies with the Java Card 2.0 API.

This page includes various software that composes Cyberflex Access development environments on UNIX, i.e., Linux, Solaris, and OpenBSD.

This software is not for use with the Cyberflex Access 32K (and later) cards. These later cards are fully compliant with Java Card 2.1 and OP 2.0, and can not be used with our software. If you want to use the 32K cards, a good starting point is the MUSCLE web site.

The Cyberflex Access Starter Kit, the Cyberflex class files, mksolo, and the Cyberflex map file, XCard, are developed by Schlumberger, and are intellectual properties of Schlumberger. Schlumberger has allowed CITI to freely distribute them, with no direct support from them.

Direction

You can obtain Cyberflex Access cards from the Schlumberger Card Store.

A Cyberflex Access software development environment on UNIX consists of the following components:

• smartcard reader drivers
• Java compiler
• Cyberflex class files
• applet generator
• Cyberflex map file
• smartcard communication tool
• host side library
• documentation

There are some choices for each component. All of them can be downloaded from this homepage or from the links.

• Smartcard Reader Drivers
  

  A smartcard reader driver is required to access smartcards.

  • The Cyberflex Access Starter Kit for Linux by Schlumberger contains Linux binaries of drivers for the Reflex 60 reader and the Towitoko reader.
  • Drivers for the Todos Argos Mini reader (libtodos_ag.so) and the Towitoko reader (libtowitoko.so) can be downloaded here in binary form for i386 / Linux, Sparc / Solaris 2.6, and i386 / OpenBSD 2.7.
    * libtowitoko.so has not been tested on Linux or Solaris. *
• Java Compiler
  

  A Java compiler is necessary to compile an applet written in Java Card language, which is a subset of Java. JDK from Sun or Pizza from the University of South Australia can be used.

  • JDK from Sun (link)
    We have used JDK 1.2.2, 1.2, and 1.1 successfully on i386 / Linux 2 and Sparc / Solaris 2.
  • Pizza (link)
    This is a free Java compiler. It can be used to compile Java Card applets. We have used Pizza 0.39g successfully on OpenBSD 2.7.
  • Kaffe (link)
    This is a free Java Virtual Machine. We have used Kaffe 0.9.1 successfully on OpenBSD 2.7.
• Cyberflex Access Class Files
  The class files are necessary when compiling Java Card applets.
  • The Cyberflex Access Starter Kit for Linux contains the class files.
  • This tar file contains them, too.
• Applet Generator mksolo
  mksolo converts a compiled Java applet to a Cyberflex downloadable format.
  • The Cyberflex Access Starter Kit for Linux contains mksolo for Linux.
  • mksolo binaries can be downloaded here, too. i386 / Linux, Sparc / Solaris 2.6, and i386 / OpenBSD 2.7.

• Cyberflex Access map file
  The Cyberflex Access map file is necessary for mksolo.
  • The Cyberflex Access Starter Kit for Linux contains the map file.
  • This tar file contains it, too.
• Smartcard Communication Tool
  A smartcard communication tool is necessary for applet downloading, applet testing, file and key management, etc. You can either use pay, a text based tool, or XCard, a GUI based tool.
  
  • pay binaries can be downloaded here for i386 / Linux, Sparc / Solaris 2.6, and i386 / OpenBSD 2.7.
  • Our sc7816 homepage distributes the pay source code.
  • The Cyberflex Access Starter Kit for Linux contains XCard source and Linux binary.
• Host Side Library
  A host side library is necessary for writing applications on the host side that communicate with smartcards. You can either use the sc7816 library, which enables a UNIX flavored programming, or PC/SC-Lite.
  • Our sc7816 homepage distributes the sc7816 library.
  • MUSCLE Homepage by David Corcoran distributes PC/SC-Lite. (link)
  • The Cyberflex Access Starter Kit for Linux contains PC/SC-Lite source and Linux binary.
• Documentation
  
  • Cyberflex Access Programming Guide by Schlumberger is a must-have manual for Cyberflex Access programmers.
  • Smartcard Programming Tutorial by CITI is an introductory tutorial for smartcard developers.

Our Environments

There are several options in smartcard software development environments, depending on whether you like Windows or UNIX, GUI based systems or text based systems, etc. The followings are what we, who like UNIX and text based systems, tend to use.

• On Linux, we use:
  1. JDK 1.2.1 with the Cyberflex class files for compilation
  2. mksolo with the Cyberflex map file for downloadable applet generation
  3. pay with Todos IFD driver for loading applets and testing
  4. the sc7816 library for host side programming.

• On Solaris, we use:
  1. JDK 1.2.1 with the Cyberflex class files for compilation
  2. mksolo with the Cyberflex map file for downloadable applet generation
  3. pay with Todos IFD driver for loading applets and testing
  4. the sc7816 library for host side programming.

• On OpenBSD, we use:
  1. pizza 0.39g with the Cyberflex class files for compilation
  2. mksolo with the Cyberflex map file for downloadable applet generation
  3. pay with Todos IFD driver or Towitoko IFD driver for loading applets and testing
  4. the sc7816 library for host side programming.

Questions, comments, contributions, etc.

Send them to smartcards@umich.edu.