rule2sor 0.1.0__tar.gz

rule2sor-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.DS_Store
+.venv/
+dist/
+*.egg-info/

rule2sor-0.1.0/.vscode/launch.json

@@ -0,0 +1,29 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug rule2sor (inner.json)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "rule2sor.cli",
+            "python": "${workspaceFolder}/.venv/bin/python",
+            "args": [
+                "${workspaceFolder}/../oscore/inner.json"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "Debug rule2sor (active file)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "rule2sor.cli",
+            "python": "${workspaceFolder}/.venv/bin/python",
+            "args": [
+                "${file}"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal"
+        }
+    ]
+}

rule2sor-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Laurent Toutain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rule2sor-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: rule2sor
+Version: 0.1.0
+Summary: Convert OpenSCHC JSON rule files into CORECONF/CBOR .sor files
+Project-URL: Homepage, https://github.com/ltn22/rule2sor
+Author-email: Laurent Toutain <laurent.toutain@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Requires-Dist: cbor-diag
+Requires-Dist: cbor2
+Requires-Dist: pycoreconf>=0.3
+Description-Content-Type: text/markdown
+
+# rule2sor
+
+Convert [OpenSCHC](https://github.com/ltn22/openschc) JSON rule files into
+`.sor` files (the Set of Rules serialized in CORECONF/CBOR, following the
+ietf-schc YANG data model).
+
+## Usage with uvx
+
+    uvx --from git+https://github.com/ltn22/rule2sor rule2sor <rule-file.json>
+
+Or after installation (`pip install git+https://github.com/ltn22/rule2sor`):
+
+    rule2sor <rule-file.json> [-s <sid-file>] [-o <output.sor>] [-q]
+
+By default the output file has the same name as the input with the `.sor`
+extension, and the SID file is the bundled `ietf-schc@2026-05-07.sid`.
+With `-q` only the final message is printed.
+
+If you pass a `.sor` file instead of a JSON file, `rule2sor` will read and print
+its contents (CBOR hex, CBOR diagnostic notation, and decoded RESTCONF JSON)
+directly to the standard output:
+
+    rule2sor <file.sor> [-s <sid-file>]
+
+Example:
+
+    rule2sor atmos41.json
+    # -> atmos41.sor
+
+    rule2sor atmos41.sor
+    # displays the content of atmos41.sor
+
+## What it does
+
+This is an extraction of the minimal code from OpenSCHC:
+
+- `gen_rulemanager.py` — trimmed `RuleManager` keeping:
+  - `Add()`: loads a JSON rule file, checks rule integrity (RuleID overlaps,
+    valid FID/MO/CDA, one of compression/fragmentation/no-compression per
+    rule) and fills in missing defaults (FL, FP, DI);
+  - `Print()`: displays the rules as ASCII tables;
+  - `add_sid_file()` / `to_coreconf()`: serializes the Set of Rules in
+    CORECONF/CBOR using the SID values.
+- `gen_parameters.py` — constants, `YANG_ID` mapping (simplified to a direct
+  name-to-YANG-identifier mapping) and `adapt_value()`.
+- `ietf-schc@2026-05-07.sid` — default SID file.
+
+## JSON rule format
+
+See the long docstring at the top of `rule2sor/gen_rulemanager.py`, which
+documents the OpenSCHC JSON rule data model (compression and fragmentation).

rule2sor-0.1.0/README.md

@@ -0,0 +1,51 @@
+# rule2sor
+
+Convert [OpenSCHC](https://github.com/ltn22/openschc) JSON rule files into
+`.sor` files (the Set of Rules serialized in CORECONF/CBOR, following the
+ietf-schc YANG data model).
+
+## Usage with uvx
+
+    uvx --from git+https://github.com/ltn22/rule2sor rule2sor <rule-file.json>
+
+Or after installation (`pip install git+https://github.com/ltn22/rule2sor`):
+
+    rule2sor <rule-file.json> [-s <sid-file>] [-o <output.sor>] [-q]
+
+By default the output file has the same name as the input with the `.sor`
+extension, and the SID file is the bundled `ietf-schc@2026-05-07.sid`.
+With `-q` only the final message is printed.
+
+If you pass a `.sor` file instead of a JSON file, `rule2sor` will read and print
+its contents (CBOR hex, CBOR diagnostic notation, and decoded RESTCONF JSON)
+directly to the standard output:
+
+    rule2sor <file.sor> [-s <sid-file>]
+
+Example:
+
+    rule2sor atmos41.json
+    # -> atmos41.sor
+
+    rule2sor atmos41.sor
+    # displays the content of atmos41.sor
+
+## What it does
+
+This is an extraction of the minimal code from OpenSCHC:
+
+- `gen_rulemanager.py` — trimmed `RuleManager` keeping:
+  - `Add()`: loads a JSON rule file, checks rule integrity (RuleID overlaps,
+    valid FID/MO/CDA, one of compression/fragmentation/no-compression per
+    rule) and fills in missing defaults (FL, FP, DI);
+  - `Print()`: displays the rules as ASCII tables;
+  - `add_sid_file()` / `to_coreconf()`: serializes the Set of Rules in
+    CORECONF/CBOR using the SID values.
+- `gen_parameters.py` — constants, `YANG_ID` mapping (simplified to a direct
+  name-to-YANG-identifier mapping) and `adapt_value()`.
+- `ietf-schc@2026-05-07.sid` — default SID file.
+
+## JSON rule format
+
+See the long docstring at the top of `rule2sor/gen_rulemanager.py`, which
+documents the OpenSCHC JSON rule data model (compression and fragmentation).

rule2sor-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rule2sor"
+version = "0.1.0"
+description = "Convert OpenSCHC JSON rule files into CORECONF/CBOR .sor files"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Laurent Toutain", email = "laurent.toutain@gmail.com" }]
+dependencies = ["cbor2", "cbor-diag", "pycoreconf>=0.3"]
+
+[project.urls]
+Homepage = "https://github.com/ltn22/rule2sor"
+
+[project.scripts]
+rule2sor = "rule2sor.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["rule2sor"]

rule2sor-0.1.0/rule2sor/__init__.py

@@ -0,0 +1,3 @@
+from .gen_rulemanager import RuleManager
+
+__all__ = ["RuleManager"]

rule2sor-0.1.0/rule2sor/cli.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""
+rule2sor: convert an OpenSCHC JSON rule file into a .sor file
+(CORECONF/CBOR representation of the Set of Rules).
+
+Usage:
+    rule2sor <rule-file.json> [-s <sid-file>] [-o <output.sor>] [-q]
+
+The rules are validated and completed by RuleManager.Add(), then
+serialized with RuleManager.to_coreconf().
+"""
+
+import argparse
+import binascii
+import json
+import os
+import sys
+
+from cbor_diag import cbor2diag
+from pycoreconf import CORECONFModel
+
+from .gen_rulemanager import RuleManager
+
+DEFAULT_SID_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+                                "ietf-schc@2026-05-07.sid")
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Convert OpenSCHC JSON rules to a CORECONF/CBOR .sor file, or display a .sor file")
+    parser.add_argument("rule_file", help="JSON file describing the set of rules, or .sor file to display")
+    parser.add_argument("-s", "--sid", default=DEFAULT_SID_FILE,
+                        help="SID file (default: %(default)s)")
+    parser.add_argument("-o", "--output",
+                        help="output .sor file (default: rule file with .sor extension)")
+    parser.add_argument("-q", "--quiet", action="store_true",
+                        help="do not print the rules nor the CBOR dump")
+    args = parser.parse_args()
+
+    if args.rule_file.endswith(".sor"):
+        if not os.path.exists(args.rule_file):
+            print(f"Error: file not found: {args.rule_file}", file=sys.stderr)
+            sys.exit(1)
+        with open(args.rule_file, "rb") as f:
+            ycbor = f.read()
+        print("CBOR (hex):", binascii.hexlify(ycbor).decode())
+        print("\nCBOR diagnostic notation:")
+        print(cbor2diag(ycbor))
+        print("\nRESTCONF JSON:")
+        model = CORECONFModel([args.sid])
+        print(json.dumps(model.decode(ycbor, as_rfc7951=True), indent=2))
+        return
+
+    output = args.output
+    if output is None:
+        base, _ = os.path.splitext(args.rule_file)
+        output = base + ".sor"
+
+    rm = RuleManager()
+    rm.Add(file=args.rule_file, device="test:device1")
+    rm.add_sid_file(args.sid)
+
+    if not args.quiet:
+        rm.Print()
+
+    ycbor = rm.to_coreconf()
+    if not args.quiet:
+        print(binascii.hexlify(ycbor))
+        print("\nCBOR diagnostic notation:")
+        print(cbor2diag(ycbor))
+        print("\nRESTCONF JSON:")
+        model = CORECONFModel([args.sid])
+        print(json.dumps(model.decode(ycbor, as_rfc7951=True), indent=2))
+
+    with open(output, "wb") as f:
+        f.write(ycbor)
+
+    print("{} written ({} bytes)".format(output, len(ycbor)))
+
+if __name__ == "__main__":
+    sys.exit(main())

rule2sor-0.1.0/rule2sor/gen_parameters.py

@@ -0,0 +1,318 @@
+T_RULEID = "RuleID"
+T_RULEIDVALUE = "RuleIDValue"
+T_RULEIDLENGTH = "RuleIDLength"
+T_DEVICEID = "DeviceID"
+
+T_FID = "FID"
+T_FL = "FL"
+T_FP = "FP"
+T_DI = "DI"
+T_TV = "TV"
+T_TV_IND = "TV.IND"
+T_MO = "MO"
+T_MO_VAL = "MO.VAL"
+T_CDA = "CDA"
+T_SB = "SB"
+
+T_PROTO_IPV6 = "IPV6"
+# IPv6 header fields
+T_IPV6_VER = "IPV6.VER"
+T_IPV6_TC = "IPV6.TC"
+T_IPV6_FL = "IPV6.FL"
+T_IPV6_LEN = "IPV6.LEN"
+T_IPV6_NXT = "IPV6.NXT"
+T_IPV6_HOP_LMT = "IPV6.HOP_LMT"
+T_IPV6_DEV_PREFIX = "IPV6.DEV_PREFIX"
+T_IPV6_DEV_IID = "IPV6.DEV_IID"
+T_IPV6_APP_PREFIX = "IPV6.APP_PREFIX"
+T_IPV6_APP_IID = "IPV6.APP_IID"
+
+T_IPV4_VER = "IPV4.VER"
+
+T_PROTO_ICMPV6 = "ICMPV6"
+# ICMPv6 header fields
+T_ICMPV6_TYPE = "ICMPV6.TYPE"
+T_ICMPV6_CODE = "ICMPV6.CODE"
+T_ICMPV6_CKSUM = "ICMPV6.CKSUM"
+T_ICMPV6_IDENT = "ICMPV6.IDENT"
+T_ICMPV6_SEQNO = "ICMPV6.SEQNO"
+T_ICMPV6_UNUSED = "ICMPV6.UNUSED"
+T_ICMPV6_PAYLOAD = "ICMPV6.PAYLOAD"
+# ICMPv6 types
+T_ICMPV6_TYPE_ECHO_REQUEST = "ICMPV6.TYPE.ECHO.REQUEST"
+T_ICMPV6_TYPE_ECHO_REPLY = "ICMPV6.TYPE.ECHO.REPLY"
+
+T_PROTO_UDP = "UDP"
+# UDP fields
+T_UDP_DEV_PORT = "UDP.DEV_PORT"
+T_UDP_APP_PORT = "UDP.APP_PORT"
+T_UDP_LEN = "UDP.LEN"
+T_UDP_CKSUM = "UDP.CKSUM"
+
+
+
+T_PROTO_COAP = "COAP"
+# CoAP fields
+T_COAP_VERSION = "COAP.VER"
+T_COAP_TYPE = "COAP.TYPE"
+T_COAP_TKL = "COAP.TKL"
+T_COAP_CODE = "COAP.CODE"
+T_COAP_MID = "COAP.MID"
+T_COAP_TOKEN = "COAP.TOKEN"
+# CoAP options string (written exactly as in standards)
+T_COAP_OPT_IF_MATCH =  "COAP.IF-MATCH"
+T_COAP_OPT_URI_HOST = "COAP.URI-HOST"
+T_COAP_OPT_ETAG = "COAP.ETAG"
+T_COAP_OPT_IF_NONE_MATCH =  "COAP.IF-NONE-MATCH"
+T_COAP_OPT_OBS =  "COAP.OBSERVE"
+T_COAP_OPT_URI_PORT =  "COAP.URI-PORT"
+T_COAP_OPT_LOC_PATH = "COAP.LOCATION-PATH"
+T_COAP_OPT_URI_PATH =  "COAP.URI-PATH"
+T_COAP_OPT_CONT_FORMAT =  "COAP.CONTENT-FORMAT"
+T_COAP_OPT_MAX_AGE =  "COAP.MAX-AGE"
+T_COAP_OPT_URI_QUERY =  "COAP.URI-QUERY"
+T_COAP_OPT_ACCEPT =  "COAP.ACCEPT"
+T_COAP_OPT_LOC_QUERY =  "COAP.LOCATION-QUERY"
+T_COAP_OPT_BLOCK2 =  "COAP.BLOCK2"
+T_COAP_OPT_BLOCK1 =  "COAP.BLOCK1"
+T_COAP_OPT_SIZE2 =  "COAP.SIZE2"
+T_COAP_OPT_PROXY_URI =  "COAP.PROXY-URI"
+T_COAP_OPT_PROXY_SCHEME =  "COAP.PROXY-SCHEME"
+T_COAP_OPT_SIZE1 =  "COAP.SIZE1"
+T_COAP_OPT_NO_RESP = "COAP.NO-RESPONSE"
+
+T_OSCORE_FLAGS = "COAP.OSCORE_FLAGS"
+T_OSCORE_FLAGS_FLAGS = "COAP.OSCORE_FLAGS_FLAGS"
+T_OSCORE_FLAGS_N = "COAP.OSCORE_FLAGS_N"
+T_OSCORE_KID = "COAP.OSCORE_KID"
+T_OSCORE_KIDCTX = "COAP.OSCORE_KID_CTX"
+T_OSCORE_PIV = "COAP.OSCORE_PIV"
+T_COAP_OPT_END = "COAP.End"
+
+T_UNUSED = "UNUSED"
+T_PAYLOAD = "PAYLOAD"
+
+T_FUNCTION_VAR = "var"
+T_FUNCTION_TKL = "tkl"
+
+T_FUNCTION_VAR = "var"
+T_FUNCTION_VARBIT = "var_bit"
+T_FUNCTION_TKL = "tkl"
+
+
+T_DIR_UP = "UP"
+T_DIR_DW = "DW"
+T_DIR_BI = "BI"
+
+T_MO_EQUAL = "EQUAL"
+T_MO_IGNORE = "IGNORE"
+T_MO_MSB = "MSB"
+T_MO_MMAP = "MATCH-MAPPING"
+T_MO_MATCH_REV_RULE = "REV-RULE-MATCH"
+
+T_CDA_NOT_SENT = "NOT-SENT"
+T_CDA_VAL_SENT = "VALUE-SENT"
+T_CDA_MAP_SENT = "MAPPING-SENT"
+T_CDA_LSB = "LSB"
+T_CDA_COMP_LEN = "COMPUTE-LENGTH"
+T_CDA_COMP_CKSUM = "COMPUTE-CHECKSUM"
+T_CDA_DEVIID = "DEVIID"
+T_CDA_APPIID = "APPIID"
+T_CDA_LORA_DEVIID = "COMPUTE-DEVIID"
+T_CDA_REV_COMPRESS = "REV-COMPRESSED-SENT"
+
+T_ALGO = "ALGO"
+T_ALGO_DIRECT = "DIRECT"
+T_ALGO_COAP_OPT = "COAP_OPTION"
+
+T_META = "META"
+T_UP_RULES = "UP_RULES"
+T_DW_RULES = "DW_RULES"
+T_LAST_USED = "LAST_USED"
+
+T_ACTION = "Action"
+
+T_COMP = "Compression"
+T_NO_COMP = "NoCompression"
+T_FRAG = "Fragmentation"
+T_FRAG_MODE = "FRMode"
+T_FRAG_NO_ACK = "NoAck"              #YANG  no-ack
+T_FRAG_ACK_ALWAYS = "AckAlways"
+T_FRAG_ACK_ON_ERROR = "AckOnError"
+T_FRAG_DIRECTION = "FRDirection"     #YANG direction
+T_FRAG_PROF = "FRModeProfile"
+T_FRAG_DTAG_SIZE = "dtagSize"        #YANG dtag-size
+T_FRAG_W_SIZE = "WSize"              #YANG w-size
+T_FRAG_FCN = "FCNSize"               #YANG fcn-size
+T_FRAG_WINDOW_SIZE = "windowSize"    #YANG window-size
+T_MAX_INTER_FRAME = "MaxInterFrame"  #YANG max-interleaved-frames
+T_FRAG_ACK_BEHAVIOR = "ackBehavior"  #YANG ack-behavior
+T_FRAG_AFTER_ALL1 = "afterAll1"
+T_FRAG_AFTER_ALL0 = "afterAll0"
+T_FRAG_AFTER_ANY = "afterAny"
+T_FRAG_TILE = "tileSize"             #YANG tile-size
+T_FRAG_MIC = "MICALgorithm"          #YANG rcs-algorithm
+T_MAX_PACKET_SIZE = "MaxPcktSize"    #YANG maximum-packet-size
+T_MAX_INTER_FRAME = "MaxInterFrame"  #YANG max-interleaved-frames
+T_FRAG_MAX_RETRY = "maxRetry"        #YANG max-ack-requests
+T_FRAG_TIMEOUT  = "timeout"          #YANG retransmission-timer
+T_FRAG_L2WORDSIZE = "L2WordSize"     #YANG l2-word-size
+T_FRAG_LAST_TILE_IN_ALL1 = "lastTileInAll1" #YANG tile-in-all-1
+T_FRAG_RFC8724 = "RCS_CRC32"
+
+T_POSITION_CORE = "core"
+T_POSITION_DEVICE = "device"
+
+T_INDEXES = "Indexes"
+T_CMD_INDIRECT = "INDIRECT"
+
+T_O_DELTA = "COAP.O-DELTA"
+T_O_LENGTH = "COAP.O-LENGTH"
+T_O_VALUE = "COAP.O-VALUE"
+
+
+YANG_ID = {
+    "module": "ietf-schc",
+    T_CDA_APPIID: "cda-appiid",
+    T_CDA_COMP_CKSUM: "cda-compute",
+    T_CDA_COMP_LEN: "cda-compute",
+    T_CDA_DEVIID: "cda-deviid",
+    T_CDA_LSB: "cda-lsb",
+    T_CDA_MAP_SENT: "cda-mapping-sent",
+    T_CDA_NOT_SENT: "cda-not-sent",
+    T_CDA_VAL_SENT: "cda-value-sent",
+    T_DIR_BI: "di-bidirectional",
+    T_DIR_DW: "di-down",
+    T_DIR_UP: "di-up",
+    T_COAP_CODE: "fid-coap-code",
+    T_COAP_MID: "fid-coap-mid",
+    T_OSCORE_FLAGS: "fid-coap-option-oscore-flags",
+    T_OSCORE_FLAGS_FLAGS: "fid-coap-option-oscore-flags-flags",
+    T_OSCORE_FLAGS_N: "fid-coap-option-oscore-flags-n",
+    T_OSCORE_KID: "fid-coap-option-oscore-kid",
+    T_OSCORE_KIDCTX: "fid-coap-option-oscore-kidctx",
+    T_OSCORE_PIV: "fid-coap-option-oscore-piv",
+    T_COAP_TKL: "fid-coap-tkl",
+    T_COAP_TOKEN: "fid-coap-token",
+    T_COAP_TYPE: "fid-coap-type",
+    T_COAP_VERSION: "fid-coap-version",
+    T_IPV6_APP_IID: "fid-ipv6-appiid",
+    T_IPV6_APP_PREFIX: "fid-ipv6-appprefix",
+    T_IPV6_DEV_IID: "fid-ipv6-deviid",
+    T_IPV6_DEV_PREFIX: "fid-ipv6-devprefix",
+    T_IPV6_FL: "fid-ipv6-flowlabel",
+    T_IPV6_HOP_LMT: "fid-ipv6-hoplimit",
+    T_IPV6_NXT: "fid-ipv6-nextheader",
+    T_IPV6_LEN: "fid-ipv6-payload-length",
+    T_IPV6_TC: "fid-ipv6-trafficclass",
+    T_IPV6_VER: "fid-ipv6-version",
+    T_IPV4_VER: "fid-ipv6-version",
+    T_UDP_APP_PORT: "fid-udp-app-port",
+    T_UDP_CKSUM: "fid-udp-checksum",
+    T_UDP_DEV_PORT: "fid-udp-dev-port",
+    T_UDP_LEN: "fid-udp-length",
+    T_FUNCTION_TKL: "fl-token-length",
+    T_FUNCTION_VAR: "fl-variable",
+    T_FUNCTION_VARBIT: "fl-variable-bit",
+    T_FRAG_ACK_ALWAYS: "fragmentation-mode-ack-always",
+    T_FRAG_ACK_ON_ERROR: "fragmentation-mode-ack-on-error",
+    T_FRAG_NO_ACK: "fragmentation-mode-no-ack",
+    T_MO_EQUAL: "mo-equal",
+    T_MO_IGNORE: "mo-ignore",
+    T_MO_MMAP: "mo-match-mapping",
+    T_MO_MSB: "mo-msb",
+    T_FRAG_RFC8724: "rcs-crc32",
+    # from OAM 
+    T_ICMPV6_CODE: "fid-icmpv6-code",
+    T_ICMPV6_TYPE: "fid-icmpv6-type",
+    T_ICMPV6_IDENT: "fid-icmpv6-identifier",
+    T_ICMPV6_SEQNO: "fid-icmpv6-sequence",
+    T_ICMPV6_CKSUM: "fid-icmpv6-checksum",
+    T_ICMPV6_PAYLOAD: "fid-icmpv6-payload",
+    # for quentin extension
+    T_O_DELTA: "fid-coap-delta-types",
+    T_O_LENGTH: "fid-coap-length",
+    T_O_VALUE: "fid-coap-value",
+
+    T_UNUSED: "fid-unused",
+    T_PAYLOAD: "fid-payload",
+}
+
+COAP_OPTION_NUMBERS = {
+    T_COAP_OPT_IF_MATCH: 1,
+    T_COAP_OPT_URI_HOST: 3,
+    T_COAP_OPT_ETAG: 4,
+    T_COAP_OPT_IF_NONE_MATCH: 5,
+    T_COAP_OPT_OBS: 6,
+    T_COAP_OPT_URI_PORT: 7,
+    T_COAP_OPT_LOC_PATH: 8,
+    T_COAP_OPT_URI_PATH: 11,
+    T_COAP_OPT_CONT_FORMAT: 12,
+    T_COAP_OPT_MAX_AGE: 14,
+    T_COAP_OPT_URI_QUERY: 15,
+    T_COAP_OPT_ACCEPT: 17,
+    T_COAP_OPT_LOC_QUERY: 20,
+    T_COAP_OPT_BLOCK2: 23,
+    T_COAP_OPT_BLOCK1: 27,
+    T_COAP_OPT_SIZE2: 28,
+    T_COAP_OPT_PROXY_URI: 35,
+    T_COAP_OPT_PROXY_SCHEME: 39,
+    T_COAP_OPT_SIZE1: 60,
+    T_COAP_OPT_NO_RESP: 258,
+}
+
+import ipaddress
+
+def adapt_value(value, length=None, FID=None): 
+    """transform any value of any type in the smallest bytearray.
+    FID allows to convert properly the string to IPv6 address."""
+
+    if type(value) is list:
+        result = []
+        for e in value:
+            result.append(adapt_value(e, length, FID))
+
+        return value
+    
+    if type(value) is int:
+
+        if FID in [T_IPV6_APP_IID, T_IPV6_APP_PREFIX, T_IPV6_DEV_IID, T_IPV6_DEV_PREFIX] and length != None:
+            return value.to_bytes(length//8, byteorder='big')
+        
+        size = 0
+        v = value
+        while v != 0:
+            v = v >> 8
+            size += 1
+
+        if size == 0: # when value == 0 store 0
+            size=1 
+
+        return value.to_bytes (size, byteorder='big')
+    if type(value) is str:
+        if FID in [T_IPV6_APP_IID, T_IPV6_APP_PREFIX, T_IPV6_DEV_IID, T_IPV6_DEV_PREFIX]:
+            # string has to be converted as IPv6 addresses
+
+            slash_pos = value.find("/") 
+            if slash_pos != -1:
+                # a prefix is given, remove / to be compatible with ip_address
+                value = value[:slash_pos]
+
+            addr = ipaddress.ip_address(value)
+            if addr.version != 6: # expect an IPv6 address
+                raise ValueError ("only IPv6 is supported, can not support {}".format(addr.version))
+
+            if FID in [T_IPV6_DEV_PREFIX, T_IPV6_APP_PREFIX]: #prefix top 8
+                return addr.packed[:8]
+            elif FID in [T_IPV6_DEV_IID, T_IPV6_APP_IID]: #IID bottom 8
+                return addr.packed[8:]
+            else:
+                raise ValueError ("{} Fid not found".format(FID))   
+        else: # a regular string
+            return value.encode()              
+    elif type(value) is bytes:
+        return value
+    elif value == None:
+        return None
+    else:
+        raise ValueError("Unknown type", type(value))