aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHarald Welte <laforge@osmocom.org>2021-04-21 11:51:25 +0200
committerHarald Welte <laforge@osmocom.org>2021-05-04 13:24:07 +0200
commit917d98c1a5cbff72820c45e8c6ccb4ac425fd369 (patch)
tree6413e971bc1105807644acdc68a45866acd9cf35 /docs
parentfc4833ec20c4acbd15657048d53df92608cee6ef (diff)
BER-TLV EF support (command, filesystem, shell)
This adds support for a new EF file type: BER-TLV files. They are different from transparent and linear fixed EFs in that they neither operate on a byte stream nor fixed-sized records, but on BER-TLV encoded objects. One can specify a tag value, and the card will return the entire TLV for that tag. As indicated in the spec, the magic tag value 0x5C (92) will return a list of tags existing in the file. Change-Id: Ibfcce757dcd477fd0d6857f64fbb4346d6d62e63
Diffstat (limited to 'docs')
-rw-r--r--docs/shell.rst37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/shell.rst b/docs/shell.rst
index 4cdf9e0..5170999 100644
--- a/docs/shell.rst
+++ b/docs/shell.rst
@@ -334,6 +334,43 @@ to the SIM card.
This allows for easy interactive modification of file contents.
+
+BER-TLV EF commands
+-------------------
+
+BER-TLV EFs are files that contain BER-TLV structured data. Every file can contain any number
+of variable-length IEs (DOs). The tag within a BER-TLV EF must be unique within the file.
+
+The commands below become enabled only when your currently selected file is of *BER-TLV EF* type.
+
+retrieve_tags
+~~~~~~~~~~~~~
+
+Retrieve a list of all tags present in the currently selected file.
+
+
+retrieve_data
+~~~~~~~~~~~~~
+.. argparse::
+ :module: pySim.filesystem
+ :func: BerTlvEF.ShellCommands.retrieve_data_parser
+
+
+set_data
+~~~~~~~~
+.. argparse::
+ :module: pySim.filesystem
+ :func: BerTlvEF.ShellCommands.set_data_parser
+
+
+del_data
+~~~~~~~~
+.. argparse::
+ :module: pySim.filesystem
+ :func: BerTlvEF.ShellCommands.del_data_parser
+
+
+
USIM commands
-------------