sim-tools/README.md

Shadytel SIM Tools

This is a version of the Shadytel Shadysim tools modified and enhanced for the use with the sysmoUSIM-SJS1 sim cards

Contrary to the cards used by the original Shadtyel tools, the sysmoUSIM-SJS1 have OTA security enabled and require the use of KIC/KID to authenticate + encrypt the PDUs of the Remote Application Management (RAM).

GIT Repository

You can clone from the Osmocom sim-tools.git repository using

git clone git://git.osmocom.org/sim/sim-tools.git

There is a cgit interface at http://git.osmocom.org/sim/sim-tools/

Mailing List

Discussions related to sim-tools are happening on the openbsc@lists.osmocom.org mailing list, please see https://lists.osmocom.org/mailman/listinfo/openbsc for subscription options and the list archive.

Please observe the Osmocom Mailing List Rules when posting.

Creating JavaCard STK Applets

Use the hello-stk example to get started.

$ mkdir javacard
$ cd javacard
$ git clone https://git.osmocom.org/sim/hello-stk
$ cd hello-stk
$ git submodule update --init --recursive
$ ant

To install the applet onto a SIM card, first set the type of reader you are using.

# For PCSC readers:
$ export SHADYSIM_OPTIONS="--pcsc"

# For USB-serial readers:
$ export SHADYSIM_OPTIONS="--serialport /dev/ttyUSB0"

and follow instructions at https://osmocom.org/projects/cellular-infrastructure/wiki/Shadysimpy

The shadysim tool has lots of other options.

$ ./sim-tools/bin/shadysim --help