aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 69144bb3042988c1bcd4c94ebcb8df310ca8086c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# 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