TLV: Add DGI encoding of "GP Scripting Language Annex B"
The DGI encoding is specified in Annex B of the
"GlobalPlatform Systems Scripting Language Specification v1.1.0"
which is an "archived" specification that is no longer published
by GlobalPlatform, despite it being referenced from the GlobalPlatform
Card Specification v2.3, which is the basis of the GSMA eSIM
specifications.
For some reason it was the belief of the specification authors that
yet another format of TLV encoding is needed, in addition to the BER-TLV
and COMPREHENSION-TLV used by the very same specifications.
The encoding of the tag is not really specified anywhere, but I've only
seen 16-bit examples. The encoding of the length is specified and
implemented here accordingly.
Change-Id: Ie29ab7eb39f3165f3d695fcc1f02051338095697
diff --git a/pySim/tlv.py b/pySim/tlv.py
index 826f02f..31051aa 100644
--- a/pySim/tlv.py
+++ b/pySim/tlv.py
@@ -24,6 +24,7 @@
from pySim.utils import bertlv_encode_len, bertlv_parse_len, bertlv_encode_tag, bertlv_parse_tag
from pySim.utils import comprehensiontlv_encode_tag, comprehensiontlv_parse_tag
from pySim.utils import bertlv_parse_tag_raw, comprehensiontlv_parse_tag_raw
+from pySim.utils import dgi_parse_tag_raw, dgi_parse_len, dgi_encode_tag, dgi_encode_len
from pySim.construct import build_construct, parse_construct, LV, HexAdapter, BcdAdapter, BitsRFU, GsmStringAdapter
from pySim.exceptions import *
@@ -302,6 +303,27 @@
return bertlv_encode_len(len(val))
+class DGI_TLV_IE(TLV_IE):
+ """TLV_IE formated as GlobalPlatform Systems Scripting Language Specification v1.1.0 Annex B."""
+
+ def __init__(self, **kwargs):
+ super().__init__(**kwargs)
+
+ @classmethod
+ def _parse_tag_raw(cls, do: bytes) -> Tuple[int, bytes]:
+ return dgi_parse_tag_raw(do)
+
+ @classmethod
+ def _parse_len(cls, do: bytes) -> Tuple[int, bytes]:
+ return dgi_parse_len(do)
+
+ def _encode_tag(self) -> bytes:
+ return dgi_encode_tag(self._compute_tag())
+
+ def _encode_len(self, val: bytes) -> bytes:
+ return dgi_encode_len(len(val))
+
+
class TLV_IE_Collection(metaclass=TlvCollectionMeta):
# we specify the metaclass so any downstream subclasses will automatically use it
"""A TLV_IE_Collection consists of multiple TLV_IE classes identified by their tags.