56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# 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/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
|