update README to indicate Osmocom modifications of the tool

This commit is contained in:
Harald Welte 2017-03-17 22:39:52 +01:00
parent 85ebb9bc68
commit caa2a1752e
1 changed files with 32 additions and 3 deletions

View File

@ -1,5 +1,34 @@
# Shadytel SIM Tools # 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 ## Creating JavaCard STK Applets
Use the hello-stk example to get started. Use the hello-stk example to get started.
@ -10,7 +39,7 @@ Use the hello-stk example to get started.
$ git clone https://git.osmocom.org/sim/hello-stk $ git clone https://git.osmocom.org/sim/hello-stk
$ cd hello-stk $ cd hello-stk
$ make $ make
To install the applet onto a SIM card, first set the type of reader you are using. To install the applet onto a SIM card, first set the type of reader you are using.
# For PCSC readers: # For PCSC readers:
@ -19,8 +48,8 @@ To install the applet onto a SIM card, first set the type of reader you are usin
# For USB-serial readers: # For USB-serial readers:
$ export SHADYSIM_OPTIONS="--serialport /dev/ttyUSB0" $ export SHADYSIM_OPTIONS="--serialport /dev/ttyUSB0"
and follow instructions at https://osmocom.org/projects/cellular-infrastructure/wiki/Shadysimpy and follow instructions at <https://osmocom.org/projects/cellular-infrastructure/wiki/Shadysimpy>
The shadysim tool has lots of other options. The shadysim tool has lots of other options.
$ ./sim-tools/bin/shadysim --help $ ./sim-tools/bin/shadysim --help