pyxcp 0.25.4__cp313-cp313-win_amd64.whl

pyxcp/scripts/xcp_info.py

@@ -0,0 +1,159 @@
+#!/usr/bin/env python
+
+"""XCP info/exploration tool."""
+
+import argparse
+from pprint import pprint
+
+from pyxcp.cmdline import ArgumentParser
+from pyxcp.types import TryCommandResult
+
+
+def getPagInfo(x):
+    result = {}
+    if x.slaveProperties.supportsCalpag:
+        status, pag = x.try_command(x.getPagProcessorInfo)
+        if status == TryCommandResult.OK:
+            result["maxSegments"] = pag.maxSegments
+            result["pagProperties"] = {}
+            result["pagProperties"]["freezeSupported"] = pag.pagProperties.freezeSupported
+            result["segments"] = []
+            for i in range(pag.maxSegments):
+                segment = {}
+                status, std_info = x.try_command(x.getSegmentInfo, 0x01, i, 0, 0)
+                if status == TryCommandResult.OK:
+                    segment["maxPages"] = std_info.maxPages
+                    segment["addressExtension"] = std_info.addressExtension
+                    segment["maxMapping"] = std_info.maxMapping
+                    segment["compressionMethod"] = std_info.compressionMethod
+                    segment["encryptionMethod"] = std_info.encryptionMethod
+
+                    status, seg_address = x.try_command(x.getSegmentInfo, 0x00, i, 0, 0)
+                    status, seg_length = x.try_command(x.getSegmentInfo, 0x00, i, 1, 0)
+
+                    segment["address"] = seg_address.basicInfo
+                    segment["length"] = seg_length.basicInfo
+
+                    result["segments"].append(segment)
+
+                    status, pgi = x.try_command(x.getPageInfo, i, 0)
+                    # print("PAGE:", pgi)
+                    # for j in range(si.maxPages):
+                    #    pgi = x.getPageInfo(i, j)
+                    #    print(pgi)
+                else:
+                    break
+    return result
+
+
+def main():
+    parser = argparse.ArgumentParser(description="XCP info/exploration tool.")
+    parser.add_argument("--no-daq", action="store_true", help="Do not query DAQ information.")
+    parser.add_argument("--no-pag", action="store_true", help="Do not query PAG information.")
+    parser.add_argument("--no-pgm", action="store_true", help="Do not query PGM information.")
+    parser.add_argument("--no-ids", action="store_true", help="Do not scan implemented IDs.")
+    ap = ArgumentParser(parser)
+
+    with ap.run() as x:
+        x.connect()
+        if x.slaveProperties.optionalCommMode:
+            x.try_command(x.getCommModeInfo, extra_msg="availability signaled by CONNECT, this may be a slave configuration error.")
+        print("\nSlave Properties:")
+        print("=================")
+        pprint(x.slaveProperties)
+
+        if not ap.args.no_ids:
+            result = x.id_scanner()
+            print("\n")
+            print("Implemented IDs:")
+            print("================")
+            for key, value in result.items():
+                print(f"{key}: {value}", end="\n\n")
+
+        cps = x.getCurrentProtectionStatus()
+        print("\nProtection Status")
+        print("=================")
+        for k, v in cps.items():
+            print(f"    {k:6s}: {v}")
+        x.cond_unlock()
+
+        if not ap.args.no_daq:
+            print("\nDAQ Info:")
+            print("=========")
+            if x.slaveProperties.supportsDaq:
+                daq_info = x.getDaqInfo()
+                pprint(daq_info)
+
+                daq_pro = daq_info["processor"]
+                daq_properties = daq_pro["properties"]
+                if x.slaveProperties.transport_layer == "CAN":
+                    print("")
+                    if daq_properties["pidOffSupported"]:
+                        print("*** pidOffSupported -- i.e. one CAN-ID per DAQ-list.")
+                    else:
+                        print("*** NO support for PID_OFF")
+                num_predefined = daq_pro["minDaq"]
+                print("\nPredefined DAQ-Lists")
+                print("====================")
+                if num_predefined > 0:
+                    print(f"There are {num_predefined} predefined DAQ-lists")
+                    for idx in range(num_predefined):
+                        print(f"DAQ-List #{idx}\n____________\n")
+                        status, dm = x.try_command(x.getDaqListMode, idx)
+                        if status == TryCommandResult.OK:
+                            print(dm)
+                        status, di = x.try_command(x.getDaqListInfo, idx)
+                        if status == TryCommandResult.OK:
+                            print(di)
+                else:
+                    print("*** NO Predefined DAQ-Lists")
+            else:
+                print("*** DAQ IS NOT SUPPORTED .")
+
+        if not ap.args.no_pag:
+            print("\nPAG Info:")
+            print("=========")
+            if x.slaveProperties.supportsCalpag:
+                pgi = getPagInfo(x)
+                pprint(pgi)
+            else:
+                print("*** PAGING IS NOT SUPPORTED.")
+
+        if not ap.args.no_pgm:
+            print("\nPGM Info:")
+            print("=========")
+            if x.slaveProperties.supportsPgm:
+                status, pgm = x.try_command(x.getPgmProcessorInfo)
+                if status == TryCommandResult.OK:
+                    print(pgm)
+            else:
+                print("*** FLASH PROGRAMMING IS NOT SUPPORTED.")
+
+        if x.slaveProperties.transport_layer == "CAN":
+            print("\nTransport-Layer CAN:")
+            print("====================")
+            status, res = x.try_command(x.getSlaveID, 0)
+            if status == TryCommandResult.OK:
+                print("CAN identifier for CMD/STIM:\n", res)
+            else:
+                pass
+                # print("*** GET_SLAVE_ID() IS NOT SUPPORTED.")  # no response from bc address ???
+
+            print("\nPer DAQ-list Identifier")
+            print("-----------------------")
+            daq_id = 0
+            while True:
+                status, res = x.try_command(x.getDaqId, daq_id)
+                if status == TryCommandResult.OK:
+                    print(f"DAQ-list #{daq_id}:", res)
+                    daq_id += 1
+                else:
+                    break
+            if daq_id == 0:
+                print("N/A")
+        x.disconnect()
+        print("\nDone.")
+
+
+if __name__ == "__main__":
+    main()

pyxcp/scripts/xcp_profile.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+"""Create / convert pyxcp profiles (configurations)."""
+
+import sys
+
+from pyxcp.cmdline import ArgumentParser
+
+
+def main():
+    if len(sys.argv) == 1:
+        sys.argv.append("profile")
+    elif len(sys.argv) >= 2 and sys.argv[1] != "profile":
+        sys.argv.insert(1, "profile")
+
+    ap = ArgumentParser(description="Create / convert pyxcp profiles (configurations).")
+
+    try:
+        with ap.run() as x:  # noqa: F841
+            pass
+    except FileNotFoundError as e:
+        print(f"Error: {e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

pyxcp/scripts/xmraw_converter.py

@@ -0,0 +1,31 @@
+import argparse
+
+from pyxcp.recorder.converter import convert_xmraw
+
+
+parser = argparse.ArgumentParser(description="Convert .xmraw files.")
+
+parser.add_argument(
+    "target_type",
+    help="target file type",
+    choices=[
+        "arrow",
+        "csv",
+        "excel",
+        "hdf5",
+        "mdf",
+        "sqlite3",
+    ],
+)
+
+
+def main():
+    parser.add_argument("xmraw_file", help=".xmraw file")
+    parser.add_argument("-t", "--taget-file-name", dest="target_file_name", help="target file name")
+    args = parser.parse_args()
+
+    convert_xmraw(args.target_type, args.xmraw_file, args.target_file_name)
+
+
+if __name__ == "__main__":
+    main()

pyxcp/tests/test_asam_types.py

@@ -0,0 +1,24 @@
+import pytest
+
+from pyxcp.asam import types
+
+
+def testEncodeUint32_0():
+    assert types.A_Uint32("<").encode(3415750566) == b"\xa67\x98\xcb"
+
+
+def testDecodeUint32_0():
+    assert types.A_Uint32("<").decode((0xA6, 0x37, 0x98, 0xCB)) == 3415750566
+
+
+def testLittleEndian():
+    assert isinstance(types.AsamBaseType(types.INTEL), types.AsamBaseType)
+
+
+def testBigEndian():
+    assert isinstance(types.AsamBaseType(types.MOTOROLA), types.AsamBaseType)
+
+
+def testInvalidByteOrderRaisesTypeError():
+    with pytest.raises(ValueError):
+        types.AsamBaseType("#")

pyxcp/tests/test_binpacking.py

@@ -0,0 +1,186 @@
+import pytest
+
+from pyxcp.daq_stim.optimize import McObject, make_continuous_blocks
+from pyxcp.daq_stim.optimize.binpacking import Bin, first_fit_decreasing
+
+
+#  McObject(name="", address=section.address, ext=section.ext, length=section.length, components=[section])
+# McObject(name: str, address: int, ext: int, length: int, data_type: str = '', components: list[pyxcp.cpp_ext.cpp_ext.McObject] = [])
+@pytest.fixture
+def blocks():
+    return [
+        McObject(name="", address=0x000E10BA, ext=0, length=2),
+        McObject(name="", address=0x000E10BE, ext=0, length=2),
+        McObject(name="", address=0x000E41F4, ext=0, length=4),
+        McObject(name="", address=0x000E51FC, ext=0, length=4),
+        McObject(name="", address=0x00125288, ext=0, length=4),
+        McObject(name="", address=0x00125294, ext=0, length=4),
+        McObject(name="", address=0x001252A1, ext=0, length=1),
+        McObject(name="", address=0x001252A4, ext=0, length=4),
+        McObject(name="", address=0x00125438, ext=0, length=3),
+        McObject(name="", address=0x0012543C, ext=0, length=1),
+    ]
+
+
+def test_pack_to_single_bin(blocks):
+    BIN_SIZE = 253
+    bins = first_fit_decreasing(items=blocks, bin_size=BIN_SIZE)
+
+    assert len(bins) == 1
+    bin0 = bins[0]
+    assert bin0.residual_capacity == BIN_SIZE - 29
+    assert bin0.entries == [
+        McObject(name="", address=0x000E41F4, ext=0, length=4),
+        McObject(name="", address=0x000E51FC, ext=0, length=4),
+        McObject(name="", address=0x00125288, ext=0, length=4),
+        McObject(name="", address=0x00125294, ext=0, length=4),
+        McObject(name="", address=0x001252A4, ext=0, length=4),
+        McObject(name="", address=0x00125438, ext=0, length=3),
+        McObject(name="", address=0x000E10BA, ext=0, length=2),
+        McObject(name="", address=0x000E10BE, ext=0, length=2),
+        McObject(name="", address=0x001252A1, ext=0, length=1),
+        McObject(name="", address=0x0012543C, ext=0, length=1),
+    ]
+
+
+def test_pack_empty_block_set():
+    BIN_SIZE = 253
+    bins = first_fit_decreasing(items=[], bin_size=BIN_SIZE)
+    assert bins == [Bin(size=BIN_SIZE)]
+
+
+def test_pack_to_multiple_bins1(blocks):
+    BIN_SIZE = 6
+    bins = first_fit_decreasing(items=blocks, bin_size=BIN_SIZE)
+    assert len(bins) == 6
+    bin0, bin1, bin2, bin3, bin4, bin5 = bins
+    assert bin0.residual_capacity == 0
+    assert bin0.entries == [
+        McObject(name="", address=0x000E41F4, ext=0, length=4),
+        McObject(name="", address=0x000E10BA, ext=0, length=2),
+    ]
+    assert bin1.residual_capacity == 0
+    assert bin1.entries == [
+        McObject(name="", address=0x000E51FC, ext=0, length=4),
+        McObject(name="", address=0x000E10BE, ext=0, length=2),
+    ]
+    assert bin2.residual_capacity == 0
+    assert bin2.entries == [
+        McObject(name="", address=0x00125288, ext=0, length=4),
+        McObject(name="", address=0x001252A1, ext=0, length=1),
+        McObject(name="", address=0x0012543C, ext=0, length=1),
+    ]
+    assert bin3.residual_capacity == 2
+    assert bin3.entries == [McObject(name="", address=0x00125294, ext=0, length=4)]
+    assert bin4.residual_capacity == 2
+    assert bin4.entries == [McObject(name="", address=0x001252A4, ext=0, length=4)]
+    assert bin5.residual_capacity == 3
+    assert bin5.entries == [McObject(name="", address=0x00125438, ext=0, length=3)]
+
+
+def test_binpacking_raises(blocks):
+    BIN_SIZE = 7
+    with pytest.raises(ValueError):
+        first_fit_decreasing(items=[McObject(name="", address=0x1000, ext=0, length=32)], bin_size=BIN_SIZE)
+
+
+def test_binpacking_works(blocks):
+    BIN_SIZE = 7
+    first_fit_decreasing(items=[McObject(name="", address=0x1000, ext=0, length=7)], bin_size=BIN_SIZE)
+
+
+def test_make_continuous_blocks1():
+    BLOCKS = [
+        McObject(name="", address=0x000E0002, ext=0, length=2),
+        McObject(name="", address=0x000E0008, ext=23, length=4),
+        McObject(name="", address=0x000E0004, ext=0, length=4),
+        McObject(name="", address=0x000E000C, ext=23, length=4),
+        McObject(name="", address=0x000E0000, ext=0, length=2),
+    ]
+    bins = make_continuous_blocks(chunks=BLOCKS)
+    assert bins == [
+        McObject(
+            name="",
+            address=917504,
+            ext=0,
+            length=8,
+            components=[
+                McObject(name="", address=917504, ext=0, length=2, components=[]),
+                McObject(name="", address=917506, ext=0, length=2, components=[]),
+                McObject(name="", address=917508, ext=0, length=4, components=[]),
+            ],
+        ),
+        McObject(
+            name="",
+            address=917512,
+            ext=23,
+            length=8,
+            components=[
+                McObject(name="", address=917512, ext=23, length=4, components=[]),
+                McObject(name="", address=917516, ext=23, length=4, components=[]),
+            ],
+        ),
+    ]
+
+
+def test_make_continuous_blocks2():
+    BLOCKS = [
+        McObject(name="", address=0x000E0002, ext=0, length=2),
+        McObject(name="", address=0x000E0008, ext=0, length=4),
+        McObject(name="", address=0x000E0004, ext=0, length=4),
+        McObject(name="", address=0x000E000C, ext=0, length=4),
+        McObject(name="", address=0x000E0000, ext=0, length=2),
+    ]
+    bins = make_continuous_blocks(chunks=BLOCKS)
+    assert bins == [
+        McObject(
+            name="",
+            address=917504,
+            ext=0,
+            length=16,
+            components=[
+                McObject(name="", address=917504, ext=0, length=2, components=[]),
+                McObject(name="", address=917506, ext=0, length=2, components=[]),
+                McObject(name="", address=917508, ext=0, length=4, components=[]),
+                McObject(name="", address=917512, ext=0, length=4, components=[]),
+                McObject(name="", address=917516, ext=0, length=4, components=[]),
+            ],
+        )
+    ]
+
+
+def test_make_continuous_blocks3():
+    BLOCKS = [
+        McObject(name="", address=0x000E0002, ext=0x01, length=2),
+        McObject(name="", address=0x000E0008, ext=0x03, length=4),
+        McObject(name="", address=0x000E0004, ext=0x02, length=4),
+        McObject(name="", address=0x000E000C, ext=0x04, length=4),
+        McObject(name="", address=0x000E0000, ext=0x00, length=2),
+    ]
+    bins = make_continuous_blocks(chunks=BLOCKS)
+    assert bins == [
+        McObject(
+            name="", address=917504, ext=0, length=2, components=[McObject(name="", address=917504, ext=0, length=2, components=[])]
+        ),
+        McObject(
+            name="", address=917506, ext=1, length=2, components=[McObject(name="", address=917506, ext=1, length=2, components=[])]
+        ),
+        McObject(
+            name="", address=917508, ext=2, length=4, components=[McObject(name="", address=917508, ext=2, length=4, components=[])]
+        ),
+        McObject(
+            name="", address=917512, ext=3, length=4, components=[McObject(name="", address=917512, ext=3, length=4, components=[])]
+        ),
+        McObject(
+            name="", address=917516, ext=4, length=4, components=[McObject(name="", address=917516, ext=4, length=4, components=[])]
+        ),
+    ]
+
+
+def test_mc_object_len_zero():
+    with pytest.raises(ValueError):
+        McObject(name="", address=0, ext=0, length=0)
+
+
+def test_mc_object_ok():
+    McObject(name="", address=0, ext=0, length=1)