From caa2a1752e959c2de650aa75eea18b7dc004d4a6 Mon Sep 17 00:00:00 2001 From: Harald Welte Date: Fri, 17 Mar 2017 22:39:52 +0100 Subject: [PATCH] update README to indicate Osmocom modifications of the tool --- README.md | 35 ++++++++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 597ebd8..86f35ba 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,34 @@ # 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 + +## Mailing List + +Discussions related to sim-tools are happening on the +openbsc@lists.osmocom.org mailing list, please see + 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. @@ -10,7 +39,7 @@ Use the hello-stk example to get started. $ 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: @@ -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: $ export SHADYSIM_OPTIONS="--serialport /dev/ttyUSB0" -and follow instructions at https://osmocom.org/projects/cellular-infrastructure/wiki/Shadysimpy - +and follow instructions at + The shadysim tool has lots of other options. $ ./sim-tools/bin/shadysim --help