This is merely a historical archive of years 2008-2021, before the migration to mailman3.
A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.
laforge gerrit-no-reply at lists.osmocom.orglaforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/23607 ) Change subject: docs: Documentation for classic pySim-{prog,read} tools ...................................................................... docs: Documentation for classic pySim-{prog,read} tools Particularly the documentation for pySim-prog is far from being complete, but it's a start. Change-Id: Ic1932e62a5d7cf33e0dd74cb071cfa7f27c6e497 --- M docs/legacy.rst 1 file changed, 99 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/07/23607/1 diff --git a/docs/legacy.rst b/docs/legacy.rst index 492be46..dad83d8 100644 --- a/docs/legacy.rst +++ b/docs/legacy.rst @@ -1,2 +1,101 @@ Legacy tools ============ + +*legacy tools* are the classic ``pySim-prog`` and ``pySim-read`` programs that +existed long before ``pySim-shell``. + +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) + +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 + + +:: + + Usage: pySim-read.py [options] + + Options: + -h, --help show this help message and exit + -d DEV, --device=DEV Serial Device for SIM access [default: /dev/ttyUSB0] + -b BAUD, --baud=BAUD Baudrate used for SIM access [default: 9600] + -p PCSC, --pcsc-device=PCSC + Which PC/SC reader number for SIM access + --modem-device=DEV Serial port of modem for Generic SIM Access (3GPP TS + 27.007) + --modem-baud=BAUD Baudrate used for modem's port [default: 115200] + --osmocon=PATH Socket path for Calypso (e.g. Motorola C1XX) based + reader (via OsmocomBB) -- To view, visit https://gerrit.osmocom.org/c/pysim/+/23607 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: Ic1932e62a5d7cf33e0dd74cb071cfa7f27c6e497 Gerrit-Change-Number: 23607 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge at osmocom.org> Gerrit-MessageType: newchange -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20210404/5a51fcf6/attachment.htm>