# Shadytel SIM Tools

This is a version of the Shadytel Shadysim tools modified and enhanced
for the use with the
[sysmoUSIM-SJS1 sim cards](https://osmocom.org/projects/cellular-infrastructure/wiki/SysmoUSIM-SJS1)

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](https://osmocom.org/projects/cellular-infrastructure/wiki/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/sim-tools
	$ git clone https://git.osmocom.org/sim/hello-stk
	$ cd hello-stk
	$ make

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