| Harald Welte | 94e8735 | 2021-04-02 13:38:00 +0200 | [diff] [blame] | 1 | Legacy tools |
| 2 | ============ |
| Harald Welte | 9ae33c8 | 2021-04-04 15:49:06 +0200 | [diff] [blame] | 3 | |
| 4 | *legacy tools* are the classic ``pySim-prog`` and ``pySim-read`` programs that |
| 5 | existed long before ``pySim-shell``. |
| 6 | |
| 7 | pySim-prog |
| 8 | ---------- |
| 9 | |
| 10 | ``pySim-prog`` was the first part of the pySim software suite. It started as |
| 11 | a tool to write ICCID, IMSI, MSISDN and Ki to very simplistic SIM cards, and |
| 12 | was later extended to a variety of other cards. As the number of features supported |
| 13 | became no longer bearable to express with command-line arguments, `pySim-shell` was |
| 14 | created. |
| 15 | |
| 16 | Basic use cases can still use `pySim-prog`. |
| 17 | |
| 18 | Program customizable SIMs |
| 19 | ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 20 | Two modes are possible: |
| 21 | |
| 22 | - one where you specify every parameter manually : |
| 23 | |
| 24 | ``./pySim-prog.py -n 26C3 -c 49 -x 262 -y 42 -i <IMSI> -s <ICCID>`` |
| 25 | |
| 26 | |
| 27 | - one where they are generated from some minimal set : |
| 28 | |
| 29 | ``./pySim-prog.py -n 26C3 -c 49 -x 262 -y 42 -z <random_string_of_choice> -j <card_num>`` |
| 30 | |
| 31 | With <random_string_of_choice> and <card_num>, the soft will generate |
| 32 | 'predictable' IMSI and ICCID, so make sure you choose them so as not to |
| 33 | conflict with anyone. (for eg. your name as <random_string_of_choice> and |
| 34 | 0 1 2 ... for <card num>). |
| 35 | |
| 36 | You also need to enter some parameters to select the device : |
| 37 | -t TYPE : type of card (supersim, magicsim, fakemagicsim or try 'auto') |
| 38 | -d DEV : Serial port device (default /dev/ttyUSB0) |
| 39 | -b BAUD : Baudrate (default 9600) |
| 40 | |
| 41 | |
| 42 | pySim-read |
| 43 | ---------- |
| 44 | |
| 45 | ``pySim-read`` allows you to read some data from a SIM card. It will only some files |
| 46 | of the card, and will only read files accessible to a normal user (without any special authentication) |
| 47 | |
| 48 | Specifically, pySim-read will dump the following: |
| 49 | |
| 50 | * MF |
| 51 | |
| 52 | * EF.ICCID |
| 53 | |
| 54 | * DF.GSM |
| 55 | |
| 56 | * EF,IMSI |
| 57 | * EF.GID1 |
| 58 | * EF.GID2 |
| 59 | * EF.SMSP |
| 60 | * EF.SPN |
| 61 | * EF.PLMNsel |
| 62 | * EF.PLMNwAcT |
| 63 | * EF.OPLMNwAcT |
| 64 | * EF.HPLMNAcT |
| 65 | * EF.ACC |
| 66 | * EF.MSISDN |
| 67 | * EF.AD |
| 68 | * EF.SST |
| 69 | |
| 70 | * ADF.USIM |
| 71 | |
| 72 | * EF.EHPLMN |
| 73 | * EF.UST |
| 74 | * EF.ePDGId |
| 75 | * EF.ePDGSelection |
| 76 | |
| 77 | * ADF.ISIM |
| 78 | |
| 79 | * EF.PCSCF |
| 80 | * EF.DOMAIN |
| 81 | * EF.IMPI |
| 82 | * EF.IMPU |
| 83 | * EF.UICCIARI |
| 84 | * EF.IST |
| 85 | |
| 86 | |
| Harald Welte | 8fe1d20 | 2021-04-11 12:31:40 +0200 | [diff] [blame] | 87 | pySim-read usage |
| 88 | ~~~~~~~~~~~~~~~~ |
| Harald Welte | 9ae33c8 | 2021-04-04 15:49:06 +0200 | [diff] [blame] | 89 | |
| Harald Welte | 8fe1d20 | 2021-04-11 12:31:40 +0200 | [diff] [blame] | 90 | .. argparse:: |
| 91 | :module: pySim-read |
| 92 | :func: option_parser |