f422eb1886
This is important to produce the right command syntax when generating command line reference in the user manual. However, we shouldn't add this kludge to the individual programs, but only to the documentation using the :prog: syntax. Change-Id: I2ec7ab00c63d5d386f187e54755c71ffc2dce429
102 lines
2.4 KiB
ReStructuredText
102 lines
2.4 KiB
ReStructuredText
Legacy tools
|
|
============
|
|
|
|
*legacy tools* are the classic ``pySim-prog`` and ``pySim-read`` programs that
|
|
existed long before ``pySim-shell``.
|
|
|
|
These days, you should primarily use ``pySim-shell`` instead of these
|
|
legacy tools.
|
|
|
|
pySim-prog
|
|
----------
|
|
|
|
``pySim-prog`` was the first part of the pySim software suite. It started as
|
|
a tool to write ICCID, IMSI, MSISDN and Ki to very simplistic SIM cards, and
|
|
was later extended to a variety of other cards. As the number of features supported
|
|
became no longer bearable to express with command-line arguments, `pySim-shell` was
|
|
created.
|
|
|
|
Basic use cases can still use `pySim-prog`.
|
|
|
|
Program customizable SIMs
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Two modes are possible:
|
|
|
|
- one where you specify every parameter manually :
|
|
|
|
``./pySim-prog.py -n 26C3 -c 49 -x 262 -y 42 -i <IMSI> -s <ICCID>``
|
|
|
|
|
|
- one where they are generated from some minimal set :
|
|
|
|
``./pySim-prog.py -n 26C3 -c 49 -x 262 -y 42 -z <random_string_of_choice> -j <card_num>``
|
|
|
|
With <random_string_of_choice> and <card_num>, the soft will generate
|
|
'predictable' IMSI and ICCID, so make sure you choose them so as not to
|
|
conflict with anyone. (for eg. your name as <random_string_of_choice> and
|
|
0 1 2 ... for <card num>).
|
|
|
|
You also need to enter some parameters to select the device :
|
|
-t TYPE : type of card (supersim, magicsim, fakemagicsim or try 'auto')
|
|
-d DEV : Serial port device (default /dev/ttyUSB0)
|
|
-b BAUD : Baudrate (default 9600)
|
|
|
|
|
|
pySim-read
|
|
----------
|
|
|
|
``pySim-read`` allows you to read some data from a SIM card. It will only some files
|
|
of the card, and will only read files accessible to a normal user (without any special authentication)
|
|
|
|
These days, you should use the ``export`` command of ``pySim-shell``
|
|
instead. It performs a much more comprehensive export of all of the
|
|
[standard] files that can be found on the card. To get a human-readable
|
|
decode instead of the raw hex export, you can use ``export --json``.
|
|
|
|
Specifically, pySim-read will dump the following:
|
|
|
|
* MF
|
|
|
|
* EF.ICCID
|
|
|
|
* DF.GSM
|
|
|
|
* EF,IMSI
|
|
* EF.GID1
|
|
* EF.GID2
|
|
* EF.SMSP
|
|
* EF.SPN
|
|
* EF.PLMNsel
|
|
* EF.PLMNwAcT
|
|
* EF.OPLMNwAcT
|
|
* EF.HPLMNAcT
|
|
* EF.ACC
|
|
* EF.MSISDN
|
|
* EF.AD
|
|
* EF.SST
|
|
|
|
* ADF.USIM
|
|
|
|
* EF.EHPLMN
|
|
* EF.UST
|
|
* EF.ePDGId
|
|
* EF.ePDGSelection
|
|
|
|
* ADF.ISIM
|
|
|
|
* EF.PCSCF
|
|
* EF.DOMAIN
|
|
* EF.IMPI
|
|
* EF.IMPU
|
|
* EF.UICCIARI
|
|
* EF.IST
|
|
|
|
|
|
pySim-read usage
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. argparse::
|
|
:module: pySim-read
|
|
:func: option_parser
|
|
:prog: pySim-read.py
|