February 2022 - gerrit-log - lists.osmocom.org

Change in pysim[master]: add scripts/deactivate-ims.script to deactivate IMS related services

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/27239 ) Change subject: add scripts/deactivate-ims.script to deactivate IMS related services ...................................................................... add scripts/deactivate-ims.script to deactivate IMS related services Change-Id: I0cd93c8fa0024dd9d93647c565190abe94d3097e --- A scripts/deactivate-ims.script 1 file changed, 74 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/39/27239/1 diff --git a/scripts/deactivate-ims.script b/scripts/deactivate-ims.script new file mode 100644 index 0000000..e560d4b --- /dev/null +++ b/scripts/deactivate-ims.script @@ -0,0 +1,74 @@ +# script to be used with pySim-shell.py which is part of the Osmocom pysim package, +# found at https://osmocom.org/projects/pysim/wiki +set echo true + +# this script will deactivate all IMS related services and files. This can be used +# in case you do not wish to use any IMS services, or you do not wish to configure +# the IMS specific files on the USIM/ISIM cards. The card will then behave like a 3G USIM +# without any IMS capability, using the default fall-back mechanisms specified by 3GPP. + +# TODO: add your card-specific ADM pin at the end of the verify_adm line below +verify_adm + +# deactivate any IMS related services in EF.UST +select ADF.USIM +select EF.UST +ust_service_deactivate 93 +ust_service_deactivate 95 +ust_service_deactivate 104 +ust_service_deactivate 105 +ust_service_deactivate 106 +ust_service_deactivate 107 +ust_service_deactivate 108 +ust_service_deactivate 109 +ust_service_deactivate 110 +ust_service_deactivate 112 +ust_service_deactivate 114 +ust_service_deactivate 115 +ust_service_deactivate 118 +ust_service_deactivate 120 +ust_service_deactivate 131 +ust_service_deactivate 134 + +# deactivate all IMS related files in ADF.USIM +select ADF.USIM + +select EF.UICCIARI +deactivate_file + +select EF.ePDGId +deactivate_file + +select EF.ePDGSelection +deactivate_file + +select EF.ePDGIdEm +deactivate_file + +select EF.ePDGSelectionEm +deactivate_file + +select EF.FromPreferred +deactivate_file + +select EF.IMSConfigData +deactivate_file + +select EF.3GPPPSDATAOFF +deactivate_file + +select EF.3GPPPSDATAOFFservicelist +deactivate_file + +select EF.XCAPConfigData +deactivate_file + +select EF.MuDMiDConfigData +deactivate_file + +echo "Please make sure to manually disable the ISIM applet as described in the end of the script" +# you can currently only manually do this via GlobalPlatformPro or some other tool using +# java -jar ./gp.jar --key-enc KIC1 --key-mac KID1 --key-dek KIK1 --lock-applet A0000000871004FFFFFFFF8907090000 +# (substituting KIC1/KID1/KIK1 with the card-specific keys, of course) + +quit -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27239 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I0cd93c8fa0024dd9d93647c565190abe94d3097e Gerrit-Change-Number: 27239 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

3 years, 4 months

1
0
0 0

Change in pysim[master]: docs: Document missing 'status' command in 7816 section

by fixeria

Attention is currently required from: laforge. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/pysim/+/27236 ) Change subject: docs: Document missing 'status' command in 7816 section ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27236 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I9af85a36bc4f24c3a22b9b2a6b8e2abd86edfe4e Gerrit-Change-Number: 27236 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-CC: Jenkins Builder Gerrit-Attention: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Thu, 17 Feb 2022 11:50:43 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

3 years, 4 months

1
0
0 0

Change in pysim[master]: shell: Proper argparser (for help + manual) activate_file

by fixeria

Attention is currently required from: laforge. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/pysim/+/27235 ) Change subject: shell: Proper argparser (for help + manual) activate_file ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27235 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I5929ae3deff4d15b5db4a1d866576271c57a955f Gerrit-Change-Number: 27235 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Thu, 17 Feb 2022 11:50:23 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

3 years, 4 months

1
0
0 0

Change in pysim[master]: pySim-shell: export: Add FCP template to export

by fixeria

Attention is currently required from: laforge. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/pysim/+/27209 ) Change subject: pySim-shell: export: Add FCP template to export ...................................................................... Patch Set 1: Code-Review+1 -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27209 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I05f17bbebd7a9b3535204b821900851a5f66e88f Gerrit-Change-Number: 27209 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Thu, 17 Feb 2022 11:49:47 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

3 years, 4 months

1
0
0 0

Change in pysim[master]: docs/legcay.txt: Point to pySim-shell as replacement

by fixeria

Attention is currently required from: laforge. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/pysim/+/27208 ) Change subject: docs/legcay.txt: Point to pySim-shell as replacement ...................................................................... Patch Set 1: Code-Review+2 -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27208 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I9ca6b9d8c35e23be2ec8752107bb7d1e4f6f9bc1 Gerrit-Change-Number: 27208 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Attention: laforge <laforge(a)osmocom.org> Gerrit-Comment-Date: Thu, 17 Feb 2022 11:49:27 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

3 years, 4 months

1
0
0 0

Change in pysim[master]: pySim-shell: support TS 102 222 administrative commands

by fixeria

Attention is currently required from: laforge, herlesupreeth, dexter. fixeria has posted comments on this change. ( https://gerrit.osmocom.org/c/pysim/+/27126 ) Change subject: pySim-shell: support TS 102 222 administrative commands ...................................................................... Patch Set 6: Code-Review+1 -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27126 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I5b1ffb1334afa18d62beb642268066a30deb7ea6 Gerrit-Change-Number: 27126 Gerrit-PatchSet: 6 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-Reviewer: Jenkins Builder Gerrit-Reviewer: dexter <pmaier(a)sysmocom.de> Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de> Gerrit-Reviewer: herlesupreeth <herlesupreeth(a)gmail.com> Gerrit-Attention: laforge <laforge(a)osmocom.org> Gerrit-Attention: herlesupreeth <herlesupreeth(a)gmail.com> Gerrit-Attention: dexter <pmaier(a)sysmocom.de> Gerrit-Comment-Date: Thu, 17 Feb 2022 11:49:14 +0000 Gerrit-HasComments: No Gerrit-Has-Labels: Yes Gerrit-MessageType: comment

3 years, 4 months

1
0
0 0

Change in pysim[master]: Add scripts/deacivate-5g.script

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/27238 ) Change subject: Add scripts/deacivate-5g.script ...................................................................... Add scripts/deacivate-5g.script This script can be used to deactivate all 5G related services and files. Change-Id: I5dc3e9f0ae76a7ae57484e5a3369e11ff02c7eca --- A scripts/deactivate-5g.script 1 file changed, 69 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/38/27238/1 diff --git a/scripts/deactivate-5g.script b/scripts/deactivate-5g.script new file mode 100644 index 0000000..13206fa --- /dev/null +++ b/scripts/deactivate-5g.script @@ -0,0 +1,69 @@ +# script to be used with pySim-shell.py which is part of the Osmocom pysim package, +# found at https://osmocom.org/projects/pysim/wiki +set echo true + +# this script will deactivate all 5G related services and files. This can be used +# in case you do not wish to use any 5G services, or you do not wish to configure +# the 5G specific files on the USIM card. The card will then behave like a 3G USIM +# without any 5G capability, using the default fall-back mechanisms specified by 3GPP. + +# TODO: add your card-specific ADM pin at the end of the verify_adm line below +verify_adm + +# deactivate any 5G related services in EF.UST +select ADF.USIM +select EF.UST +ust_service_deactivate 122 +ust_service_deactivate 123 +ust_service_deactivate 124 +ust_service_deactivate 125 +ust_service_deactivate 127 +ust_service_deactivate 129 +ust_service_deactivate 130 +ust_service_deactivate 132 +ust_service_deactivate 133 +ust_service_deactivate 134 +ust_service_deactivate 135 + +# deactivate all files in EF.5GS +select ADF.USIM +select DF.5GS + +select EF.5GAUTHKEYS +deactivate_file + +select EF.5GS3GPPLOCI +deactivate_file + +select EF.5GSN3GPPNSC +deactivate_file + +select EF.5GSN3GPPLOCI +deactivate_file + +select EF.5GS3GPPNSC +deactivate_file + +# only exists on sysmoISIM-SJA2v2 +select EF.OPL5G +deactivate_file + +select EF.Routing_Indicator +deactivate_file + +select EF.SUCI_Calc_Info +deactivate_file + +select EF.SUPI_NAI +deactivate_file + +# only exists on sysmoISIM-SJA2v2 +select EF.TN3GPPSNN +deactivate_file + +select EF.UAC_AIC +deactivate_file + +# only exists on sysmoISIM-SJA2v2 +select EF.URSP +deactivate_file -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27238 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I5dc3e9f0ae76a7ae57484e5a3369e11ff02c7eca Gerrit-Change-Number: 27238 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

3 years, 4 months

1
0
0 0

Change in pysim[master]: shell: Proper argparser (for help + manual) activate_file

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/27235 ) Change subject: shell: Proper argparser (for help + manual) activate_file ...................................................................... shell: Proper argparser (for help + manual) activate_file Change-Id: I5929ae3deff4d15b5db4a1d866576271c57a955f --- M docs/shell.rst M pySim-shell.py 2 files changed, 11 insertions(+), 4 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/35/27235/1 diff --git a/docs/shell.rst b/docs/shell.rst index 58588a2..fcc171b 100644 --- a/docs/shell.rst +++ b/docs/shell.rst @@ -143,7 +143,12 @@ activate_file ~~~~~~~~~~~~~ -Activate the currently selected file. This used to be called REHABILITATE in TS 11.11. +Activate the specified file. This used to be called REHABILITATE in TS 11.11. +You need to specify the name or FID of the file to activate. + +.. argparse:: + :module: pySim-shell + :func: Iso7816Commands.activate_file_parser open_channel ~~~~~~~~~~~~ diff --git a/pySim-shell.py b/pySim-shell.py index ad76ba0..ec417c7 100755 --- a/pySim-shell.py +++ b/pySim-shell.py @@ -805,13 +805,15 @@ self._cmd.poutput("CHV enable successful") def do_deactivate_file(self, opts): - """Deactivate the current EF""" + """Deactivate the currently selected EF""" (data, sw) = self._cmd.card._scc.deactivate_file() + activate_file_parser = argparse.ArgumentParser() + activate_file_parser.add_argument('NAME', type=str, help='File name or FID of file to activate') + @cmd2.with_argparser(activate_file_parser) def do_activate_file(self, opts): """Activate the specified EF""" - path = opts.arg_list[0] - (data, sw) = self._cmd.rs.activate_file(path) + (data, sw) = self._cmd.rs.activate_file(opts.NAME) def complete_activate_file(self, text, line, begidx, endidx) -> List[str]: """Command Line tab completion for ACTIVATE FILE""" -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27235 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I5929ae3deff4d15b5db4a1d866576271c57a955f Gerrit-Change-Number: 27235 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

3 years, 4 months

1
0
0 0

Change in pysim[master]: docs: Document missing 'status' command in 7816 section

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/27236 ) Change subject: docs: Document missing 'status' command in 7816 section ...................................................................... docs: Document missing 'status' command in 7816 section Change-Id: I9af85a36bc4f24c3a22b9b2a6b8e2abd86edfe4e --- M docs/shell.rst 1 file changed, 35 insertions(+), 0 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/36/27236/1 diff --git a/docs/shell.rst b/docs/shell.rst index fcc171b..0f3139f 100644 --- a/docs/shell.rst +++ b/docs/shell.rst @@ -98,6 +98,41 @@ pySIM-shell (MF/ADF.USIM)> +status +~~~~~~ + +The ``status`` command [re-]obtains the File Control Template of the +currently-selected file and print its decoded output. + +Example: + +:: + + pySIM-shell (MF/ADF.ISIM)> status + { + "file_descriptor": { + "file_descriptor_byte": { + "shareable": true, + "file_type": "df", + "structure": "no_info_given" + }, + "record_len": null, + "num_of_rec": null + }, + "file_identifier": "ff01", + "df_name": "a0000000871004ffffffff8907090000", + "proprietary_information": { + "uicc_characteristics": "71", + "available_memory": 101640 + }, + "life_cycle_status_integer": "operational_activated", + "security_attrib_compact": "00", + "pin_status_template_do": { + "ps_do": "70", + "key_reference": 11 + } + } + change_chv ~~~~~~~~~~ -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27236 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: I9af85a36bc4f24c3a22b9b2a6b8e2abd86edfe4e Gerrit-Change-Number: 27236 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

3 years, 4 months

1
0
0 0

Change in pysim[master]: doc: Improve documentation in various places

by laforge

laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/pysim/+/27237 ) Change subject: doc: Improve documentation in various places ...................................................................... doc: Improve documentation in various places * don't duplicate information between .rst files and docstrings * if there's more than a trivial single-line documentation, put it as docstring into the python source and use ".. argparse" to pul it into the manual * add documentation for some commands for which it was missing * show one level deeper in the navigation table, listing the commands Change-Id: Ib88bb7d12faaac7d149ee1f6379bc128b83bbdd5 --- M docs/conf.py M docs/index.rst M docs/shell.rst M pySim-shell.py M pySim/ara_m.py M pySim/ts_31_102.py 6 files changed, 91 insertions(+), 28 deletions(-) git pull ssh://gerrit.osmocom.org:29418/pysim refs/changes/37/27237/1 diff --git a/docs/conf.py b/docs/conf.py index a96b87e..6fea583 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -18,7 +18,7 @@ # -- Project information ----------------------------------------------------- project = 'osmopysim-usermanual' -copyright = '2009-2021 by Sylvain Munaut, Harald Welte, Philipp Maier, Supreeth Herle' +copyright = '2009-2022 by Sylvain Munaut, Harald Welte, Philipp Maier, Supreeth Herle' author = 'Sylvain Munaut, Harald Welte, Philipp Maier, Supreeth Herle' diff --git a/docs/index.rst b/docs/index.rst index c647880..471802a 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -34,7 +34,7 @@ * the [legacy] :ref:`pySim-prog and pySim-read tools<Legacy tools>` .. toctree:: - :maxdepth: 2 + :maxdepth: 3 :caption: Contents: shell diff --git a/docs/shell.rst b/docs/shell.rst index 0f3139f..f24dc93 100644 --- a/docs/shell.rst +++ b/docs/shell.rst @@ -164,9 +164,6 @@ verify_chv ~~~~~~~~~~ -This command allows you to verify a CHV (PIN), which is how the specifications call -it if you authenticate yourself with the said CHV/PIN. - .. argparse:: :module: pySim-shell :func: Iso7816Commands.verify_chv_parser @@ -178,9 +175,6 @@ activate_file ~~~~~~~~~~~~~ -Activate the specified file. This used to be called REHABILITATE in TS 11.11. -You need to specify the name or FID of the file to activate. - .. argparse:: :module: pySim-shell :func: Iso7816Commands.activate_file_parser @@ -212,6 +206,7 @@ :func: Iso7816Commands.suspend_uicc_parser + pySim commands -------------- @@ -221,7 +216,6 @@ desc ~~~~ - Display human readable file description for the currently selected file. @@ -231,6 +225,17 @@ :module: pySim-shell :func: PySimCommands.dir_parser +Example: +:: + + pySIM-shell (MF)> dir + MF + 3f00 + .. ADF.USIM DF.SYSTEM EF.DIR EF.UMPC + ADF.ARA-M DF.EIRENE DF.TELECOM EF.ICCID MF + ADF.ISIM DF.GSM EF.ARR EF.PL + 14 files + export ~~~~~~ @@ -250,15 +255,27 @@ tree ~~~~ - Display a tree of the card filesystem. It is important to note that this displays a tree of files that might potentially exist (based on the card profile). In order to determine if a given file really exists on a given card, you have to try to select that file. +Example: +:: + + pySIM-shell (MF)> tree --help + EF.DIR 2f00 Application Directory + EF.ICCID 2fe2 ICC Identification + EF.PL 2f05 Preferred Languages + EF.ARR 2f06 Access Rule Reference + EF.UMPC 2f08 UICC Maximum Power Consumption + DF.TELECOM 7f10 None + EF.ADN 6f3a Abbreviated Dialing Numbers + ... + + verify_adm ~~~~~~~~~~ - Verify the ADM (Administrator) PIN specified as argument. This is typically needed in order to get write/update permissions to most of the files on SIM cards. @@ -286,8 +303,6 @@ :module: pySim-shell :func: PysimApp.bulk_script_parser -Run a script for bulk-provisioning of multiple cards. - echo ~~~~ @@ -296,6 +311,13 @@ :func: PysimApp.echo_parser +apdu +~~~~ +.. argparse:: + :module: pySim-shell + :func: PySimCommands.apdu_cmd_parser + + Linear Fixed EF commands ------------------------ @@ -484,6 +506,26 @@ :module: pySim.ts_31_102 :func: ADF_USIM.AddlShellCommands.authenticate_parser +terminal_profile +~~~~~~~~~~~~~~~~ +.. argparse:: + :module: pySim.ts_31_102 + :func: ADF_USIM.AddlShellCommands.term_prof_parser + +envelope +~~~~~~~~ +.. argparse:: + :module: pySim.ts_31_102 + :func: ADF_USIM.AddlShellCommands.envelope_parser + +envelope_sms +~~~~~~~~~~~~ +.. argparse:: + :module: pySim.ts_31_102 + :func: ADF_USIM.AddlShellCommands.envelope_sms_parser + + + ARA-M commands -------------- @@ -546,21 +588,14 @@ NOTE: Not supported in all ARA-M implementations. -.. argparse:: - :module: pySim.ara_m - :func: ADF_ARAM.AddlShellCommands.get_config_parser - aram_store_ref_ar_do ~~~~~~~~~~~~~~~~~~~~ -Store a [new] access rule on the ARA-M applet. - .. argparse:: :module: pySim.ara_m :func: ADF_ARAM.AddlShellCommands.store_ref_ar_do_parse For example, to store an Android UICC carrier privilege rule for the SHA1 hash of the certificate used to sign the CoIMS android app of Supreeth Herle (https://github.com/herlesupreeth/CoIMS_Wiki) you can use the following command: - :: pySIM-shell (MF/ADF.ARA-M)> aram_store_ref_ar_do --aid FFFFFFFFFFFF --device-app-id E46872F28B350B7E1F140DE535C2A8D5804F0BE3 --android-permissions 0000000000000001 --apdu-always diff --git a/pySim-shell.py b/pySim-shell.py index ec417c7..0753b10 100755 --- a/pySim-shell.py +++ b/pySim-shell.py @@ -683,7 +683,8 @@ def do_apdu(self, opts): """Send a raw APDU to the card, and print SW + Response. DANGEROUS: pySim-shell will not know any card state changes, and - not continue to work as expected if you e.g. select a different file.""" + not continue to work as expected if you e.g. select a different + file.""" data, sw = self._cmd.card._scc._tp.send_apdu(opts.APDU) self._cmd.poutput("SW: %s %s, RESP: %s" % (sw, self._cmd.rs.interpret_sw(sw), data)) @@ -739,7 +740,9 @@ @cmd2.with_argparser(verify_chv_parser) def do_verify_chv(self, opts): - """Verify (authenticate) using specified PIN code""" + """Verify (authenticate) using specified CHV (PIN) code, which is how the specifications + call it if you authenticate yourself using the specified PIN. There usually is at least PIN1 and + PIN2.""" pin = self.get_code(opts.pin_code) (data, sw) = self._cmd.card._scc.verify_chv(opts.pin_nr, h2b(pin)) self._cmd.poutput("CHV verification successful") @@ -812,7 +815,8 @@ activate_file_parser.add_argument('NAME', type=str, help='File name or FID of file to activate') @cmd2.with_argparser(activate_file_parser) def do_activate_file(self, opts): - """Activate the specified EF""" + """Activate the specified EF. This used to be called REHABILITATE in TS 11.11 for classic + SIM. You need to specify the name or FID of the file to activate.""" (data, sw) = self._cmd.rs.activate_file(opts.NAME) def complete_activate_file(self, text, line, begidx, endidx) -> List[str]: diff --git a/pySim/ara_m.py b/pySim/ara_m.py index 0928f8d..59f205c 100644 --- a/pySim/ara_m.py +++ b/pySim/ara_m.py @@ -311,7 +311,7 @@ self._cmd.poutput_json(res_do.to_dict()) def do_aram_get_config(self, opts): - """GET DATA [Config] on the ARA-M Applet""" + """Perform GET DATA [Config] on the ARA-M Applet: Tell it our version and retrieve its version.""" res_do = ADF_ARAM.get_config(self._cmd.card._scc._tp) if res_do: self._cmd.poutput_json(res_do.to_dict()) @@ -345,7 +345,7 @@ @cmd2.with_argparser(store_ref_ar_do_parse) def do_aram_store_ref_ar_do(self, opts): - """Perform STORE DATA [Command-Store-REF-AR-DO] to store a new access rule.""" + """Perform STORE DATA [Command-Store-REF-AR-DO] to store a (new) access rule.""" # REF ref_do_content = [] if opts.aid: diff --git a/pySim/ts_31_102.py b/pySim/ts_31_102.py index 3995dfa..c6bfa2d 100644 --- a/pySim/ts_31_102.py +++ b/pySim/ts_31_102.py @@ -1310,18 +1310,42 @@ (data, sw) = self._cmd.card._scc.authenticate(opts.rand, opts.autn) self._cmd.poutput_json(data) + term_prof_parser = argparse.ArgumentParser() + term_prof_parser.add_argument('PROFILE', help='Hexstring of encoded terminal profile') + + @cmd2.with_argparser(term_prof_parser) def do_terminal_profile(self, arg): - """Send a TERMINAL PROFILE command to the card.""" + """Send a TERMINAL PROFILE command to the card. + This is used to inform the card about which optional + features the terminal (modem/phone) supports, particularly + in the context of SIM Toolkit, Proactive SIM and OTA. You + must specify a hex-string with the encoded terminal profile + you want to send to the card.""" (data, sw) = self._cmd.card._scc.terminal_profile(arg) self._cmd.poutput('SW: %s, data: %s' % (sw, data)) + envelope_parser = argparse.ArgumentParser() + envelope_parser.add_argument('PAYLOAD', help='Hexstring of encoded payload to ENVELOPE') + + @cmd2.with_argparser(envelope_parser) def do_envelope(self, arg): - """Send an ENVELOPE command to the card.""" + """Send an ENVELOPE command to the card. This is how a + variety of information is communicated from the terminal + (modem/phone) to the card, particularly in the context of + SIM Toolkit, Proactive SIM and OTA.""" (data, sw) = self._cmd.card._scc.envelope(arg) self._cmd.poutput('SW: %s, data: %s' % (sw, data)) + envelope_sms_parser = argparse.ArgumentParser() + envelope_sms_parser.add_argument('TPDU', help='Hexstring of encoded SMS TPDU') + + @cmd2.with_argparser(envelope_sms_parser) def do_envelope_sms(self, arg): - """Send an ENVELOPE command to the card.""" + """Send an ENVELOPE(SMS-PP-Download) command to the card. + This emulates a terminal (modem/phone) having received a SMS + with a PID of 'SMS for the SIM card'. You can use this + command in the context of testing OTA related features + without a modem/phone or a cellular netwokr.""" tpdu_ie = SMS_TPDU() tpdu_ie.from_bytes(h2b(arg)) dev_ids = DeviceIdentities( -- To view, visit https://gerrit.osmocom.org/c/pysim/+/27237 To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings Gerrit-Project: pysim Gerrit-Branch: master Gerrit-Change-Id: Ib88bb7d12faaac7d149ee1f6379bc128b83bbdd5 Gerrit-Change-Number: 27237 Gerrit-PatchSet: 1 Gerrit-Owner: laforge <laforge(a)osmocom.org> Gerrit-MessageType: newchange

3 years, 4 months

1
0
0 0

2025

2024

2023

2022

gerrit-log February 2022