| 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 |