pyxcp 0.21.10__cp311-cp311-macosx_10_9_x86_64.whl → 0.21.11__cp311-cp311-macosx_10_9_x86_64.whl

pyxcp/__init__.py

@@ -25,4 +25,4 @@ from .transport import SxI
 from .transport import Usb
 
 # if you update this manually, do not forget to update .bumpversion.cfg and pyproject.toml
-__version__ = "0.21.10"
+__version__ = "0.21.11"

pyxcp/cmdline.py

@@ -5,12 +5,14 @@ Parse (transport-layer specific) command line parameters
 and create a XCP master instance.
 """
 import argparse
+import logging
 
 from pyxcp.config import readConfiguration
 from pyxcp.master import Master
 from pyxcp.transport.can import registered_drivers
 from pyxcp.transport.can import try_to_install_system_supplied_drivers
 
+
 try_to_install_system_supplied_drivers()
 
 CAN_DRIVERS = registered_drivers()
@@ -51,6 +53,9 @@ class ArgumentParser:
 
     def run(self, policy=None):
         """"""
+        # Create a default logging context if run as command line
+        logging.basicConfig()
+
         self._args = self.parser.parse_args()
         args = self.args
         if args.conf is None:

pyxcp/logger.py

@@ -2,9 +2,6 @@
 # -*- coding: utf-8 -*-
 import logging
 
-logging.basicConfig()
-
-
 class Logger(object):
 
     LOGGER_BASE_NAME = "pyxcp"

pyxcp/master/master.py

@@ -8,17 +8,17 @@
 .. [1] XCP Specification, Part 2 - Protocol Layer Specification
 """
 import functools
-import logging
 import struct
 import traceback
 import warnings
 from time import sleep
+from typing import Any
 from typing import Callable
 from typing import Collection
 from typing import Dict
 from typing import List
 from typing import Optional
-from typing import Union
+from typing import Tuple
 
 from pyxcp import checksum
 from pyxcp import types
@@ -33,6 +33,7 @@ from pyxcp.constants import makeWordPacker
 from pyxcp.constants import makeWordUnpacker
 from pyxcp.constants import PackerType
 from pyxcp.constants import UnpackerType
+from pyxcp.logger import Logger
 from pyxcp.master.errorhandler import disable_error_handling
 from pyxcp.master.errorhandler import wrapped
 from pyxcp.transport.base import createTransport
@@ -92,8 +93,7 @@ class Master:
         self.ctr = 0
         self.succeeded = True
         self.config = Configuration(self.PARAMETER_MAP or {}, config or {})
-        self.logger = logging.getLogger("pyXCP")
-        self.logger.setLevel(self.config.get("LOGLEVEL"))
+        self.logger = Logger("master.Master", level=self.config.get("LOGLEVEL"))
         disable_error_handling(self.config.get("DISABLE_ERROR_HANDLING"))
 
         self.transport = createTransport(transportName, config, policy)
@@ -124,6 +124,7 @@ class Master:
         self.disconnect_response_optional = self.config.get("DISCONNECT_RESPONSE_OPTIONAL")
         self.slaveProperties = SlaveProperties()
         self.slaveProperties.pgmProcessor = SlaveProperties()
+        self.slaveProperties.transport_layer = self.transport_name.upper()
 
     def __enter__(self):
         """Context manager entry part."""
@@ -1795,7 +1796,7 @@ class Master:
                 result = self.getSeed(types.XcpGetSeedMode.REMAINING, resource_value)
                 seed.extend(list(result.seed))
 
-            seed = seed[: length]  # maybe there are some padding bytes
+            seed = seed[:length]  # maybe there are some padding bytes
 
             result, key = getKey(
                 self.logger,
@@ -1810,7 +1811,7 @@ class Master:
                 offset = 0
                 while offset < total_length:
                     data = key[offset : offset + MAX_PAYLOAD]
-                    self.unlock(total_length-offset, data)
+                    self.unlock(total_length - offset, data)
                     offset += len(data)
             else:
                 raise SeedNKeyError("SeedAndKey DLL returned: {}".format(SeedNKeyResult(result).name))
@@ -1903,6 +1904,47 @@ class Master:
                 result[name] = response
         return result
 
+    def try_command(self, cmd: Callable, *args, **kws) -> Tuple[types.TryCommandResult, Any]:
+        """Call master functions and handle XCP errors more gracefuly.
+
+        Parameter
+        ---------
+        cmd: Callable
+        args: list
+            variable length arguments to `cmd`.
+        kws: dict
+            keyword arguments to `cmd`.
+
+            `extra_msg`: str
+                Additional info to log message (not passed to `cmd`).
+
+        Returns
+        -------
+
+        Note
+        ----
+        Mainly used for plug-and-play applications, e.g. `id_scanner` may confronted with `ERR_OUT_OF_RANGE` errors, which
+        is normal for this kind of applications -- or to test for optional commands.
+        Use carefuly not to hide serious error causes.
+        """
+        try:
+            extra_msg: Optional[str] = kws.get("extra_msg")
+            if extra_msg:
+                kws.pop("extra_msg")
+            res = cmd(*args, **kws)
+        except SystemExit as e:
+            if e.error_code == types.XcpError.ERR_CMD_UNKNOWN:
+                # This is a rather common use-case, so let the user know that there is some functionality missing.
+                if extra_msg:
+                    self.logger.warning(f"Optional command {cmd.__name__!r} not implemented -- {extra_msg!r}")
+                else:
+                    self.logger.warning(f"Optional command {cmd.__name__!r} not implemented.")
+            return (types.TryCommandResult.XCP_ERROR, e)
+        except Exception as e:
+            return (types.TryCommandResult.OTHER_ERROR, e)
+        else:
+            return (types.TryCommandResult.OK, res)
+
 
 def ticks_to_seconds(ticks, resolution):
     """Convert DAQ timestamp/tick value to seconds.

pyxcp/scripts/xcp_info.py

@@ -1,74 +1,89 @@
 #!/usr/bin/env python
-# -*- coding: utf-8 -*-
-"""Very basic hello-world example.
+"""XCP info/exploration tool.
 """
 from pprint import pprint
 
 from pyxcp.cmdline import ArgumentParser
+from pyxcp.types import TryCommandResult
 
-daq_info = False
 
+ap = ArgumentParser(description="XCP info/exploration tool.")
 
-def callout(master, args):
-    global daq_info
-    if args.daq_info:
-        daq_info = True
-
-
-ap = ArgumentParser(description="pyXCP hello world.", callout=callout)
-ap.parser.add_argument(
-    "-d",
-    "--daq-info",
-    dest="daq_info",
-    help="Display DAQ-info",
-    default=False,
-    action="store_true",
-)
 with ap.run() as x:
     x.connect()
     if x.slaveProperties.optionalCommMode:
-        x.getCommModeInfo()
-    identifier = x.identifier(0x01)
+        x.try_command(x.getCommModeInfo, extra_msg="availability signaled by CONNECT, this may be a slave configuration error.")
     print("\nSlave Properties:")
     print("=================")
-    print(f"ID: '{identifier}'")
     pprint(x.slaveProperties)
+
+    # 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}")
-    if daq_info:
-        dqp = x.getDaqProcessorInfo()
-        print("\nDAQ Processor Info:")
-        print("===================")
-        print(dqp)
-        print("\nDAQ Events:")
-        print("===========")
-        for idx in range(dqp.maxEventChannel):
-            evt = x.getDaqEventInfo(idx)
-            length = evt.eventChannelNameLength
-            name = x.pull(length).decode("utf-8")
-            dq = "DAQ" if evt.daqEventProperties.daq else ""
-            st = "STIM" if evt.daqEventProperties.stim else ""
-            dq_st = dq + " " + st
-            print(f'    [{idx:04}] "{name:s}"')
-            print(f"        dir:            {dq_st}")
-            print(f"        packed:         {evt.daqEventProperties.packed}")
-            PFX_CONS = "CONSISTENCY_"
-            print(f"        consistency:    {evt.daqEventProperties.consistency.strip(PFX_CONS)}")
-            print(f"        max. DAQ lists: {evt.maxDaqList}")
-            PFX_TU = "EVENT_CHANNEL_TIME_UNIT_"
-            print(f"        unit:           {evt.eventChannelTimeUnit.strip(PFX_TU)}")
-            print(f"        cycle:          {evt.eventChannelTimeCycle or 'SPORADIC'}")
-            print(f"        priority        {evt.eventChannelPriority}")
+    x.cond_unlock()
+    print("\nDAQ Info:")
+    print("=========")
+    daq_info = x.getDaqInfo()
+    pprint(daq_info)
 
-        dqr = x.getDaqResolutionInfo()
-        print("\nDAQ Resolution Info:")
-        print("====================")
-        print(dqr)
-        for idx in range(dqp.maxDaq):
-            print(f"\nDAQ List Info #{idx}")
-            print("=================")
-            print(f"{x.getDaqListInfo(idx)}")
+    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")
+    print("\nPAG Info:")
+    print("=========")
+    if x.slaveProperties.supportsCalpag:
+        status, pag = x.try_command(x.getPagProcessorInfo)
+        if status == TryCommandResult.OK:
+            print(pag)
+            # for idx in range(pag.maxSegments):
+            #     x.getSegmentInfo(0x01, idx, 0, 0)
+    else:
+        print("*** PAGING IS NOT SUPPORTED.")
+
+    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("OK, CAN!!!")
+        for idx in range(num_predefined):
+            status, daq_id = x.try_command(x.getDaqId, idx)
+            if status != TryCommandResult.OK:
+                break
+            print(f"DAQ-ID #{idx}", daq_id)
     x.disconnect()
+
+    print("\nDone.")

pyxcp/types.py

@@ -942,3 +942,11 @@ class FrameCategory(enum.IntEnum):
     SERV = 5
     DAQ = 6
     STIM = 7
+
+
+class TryCommandResult(enum.IntEnum):
+    """ """
+
+    OK = 0
+    XCP_ERROR = 1
+    OTHER_ERROR = 2

{pyxcp-0.21.10.dist-info → pyxcp-0.21.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyxcp
-Version: 0.21.10
+Version: 0.21.11
 Summary: Universal Calibration Protocol for Python
 Keywords: automotive,ecu,xcp,asam,autosar
 Author: Christoph Schueler

{pyxcp-0.21.10.dist-info → pyxcp-0.21.11.dist-info}/RECORD

@@ -1,19 +1,19 @@
 rekorder.cpython-311-darwin.so,sha256=a3gjMYuwCetqmLwvGrQXEYbhxZxY-jVt-7FBm8u7DGQ,319360
-pyxcp-0.21.10.dist-info/RECORD,,
-pyxcp-0.21.10.dist-info/WHEEL,sha256=1LO1kSN6mor21iujzR1Z_Aa0UwxX6-6CmfsIBq_uQlM,106
-pyxcp-0.21.10.dist-info/entry_points.txt,sha256=wL4Cgx0wIAbuEr93nPewLCL-6DCSunxxTkui-bibme8,219
-pyxcp-0.21.10.dist-info/METADATA,sha256=uK6eR-eJ54LMAbV0K5m0LVgj_jt6xAm3VQotEdsbG8c,3862
-pyxcp-0.21.10.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
+pyxcp-0.21.11.dist-info/RECORD,,
+pyxcp-0.21.11.dist-info/WHEEL,sha256=1LO1kSN6mor21iujzR1Z_Aa0UwxX6-6CmfsIBq_uQlM,106
+pyxcp-0.21.11.dist-info/entry_points.txt,sha256=wL4Cgx0wIAbuEr93nPewLCL-6DCSunxxTkui-bibme8,219
+pyxcp-0.21.11.dist-info/METADATA,sha256=GK1NxADBF_DgZU5tvGlwV6fW6LlbTiNn4g_89RjxONc,3862
+pyxcp-0.21.11.dist-info/licenses/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
 pyxcp/dllif.py,sha256=o7t_M_n6XwE63ng97DV8t8BJkGmFHtj7Esdhi7qH4DQ,3023
 pyxcp/checksum.py,sha256=nsEosSKtU1b8L14sm9HyxvUNUMc07hnCR6oK_bH6-Ew,10837
 pyxcp/asamkeydll.sh,sha256=iema12sub6qNE0xAuzwGtx0FmkdaaOKoXalhrtWVaa8,57
 pyxcp/config.py,sha256=dJ5WfX4Stlz2bvUA-mO-ez6jruFi27C9r7TDj1Vkc4g,1423
 pyxcp/asamkeydll.c,sha256=PnfD6UbMWz3cszGpJDHBrSPizjlg8RrV_nrCqC9xPOw,2862
 pyxcp/constants.py,sha256=Ifs1cxpRoctEU0BKAo5yDXqBtTWpTNIKzcV8YbrgNCA,1258
-pyxcp/cmdline.py,sha256=IvI946DR7CoCDutAaIrFTdTlCBSQ-ib_qlxBLWIK4dc,2117
-pyxcp/__init__.py,sha256=lQ5Ezf6-a5DuagwXCgG3ewVEz-3i8DH1jhRNlxlTEgM,719
-pyxcp/types.py,sha256=fwAH5XAOPAiHo4EW2JgR9P1GdNTTPGzDrPLGeNeWhjI,24006
-pyxcp/logger.py,sha256=Zl9TolTcbvUjpRs8Chx8rK8TGHiHAq9-TC3fWQRnxgY,1924
+pyxcp/cmdline.py,sha256=XgxKYidBwhLHrliT-MuYbiIzSKYaPI755DBRIJgkGv4,2230
+pyxcp/__init__.py,sha256=THlUNKH747uy5DigkJkNSetYXMNCrJIy9n0g7MkWlSk,719
+pyxcp/types.py,sha256=Ac5tTo5j6-Tv3y17BXQFEqk8rSyjaGQj8ENfaFZ8OcA,24108
+pyxcp/logger.py,sha256=oSqczYMO9G38D0ZglOGJuZ-HbCaISDciX7M6Ip3aT8Q,1900
 pyxcp/timing.py,sha256=dK89nGWV1sUVCd5FVkNCTDjoyuP8qK4Ggo9GgFGe_s0,1670
 pyxcp/utils.py,sha256=qN2b8fYzLzFhHbG449fuB9wx_BMPXFFFvoKgtrdCMeY,1889
 pyxcp/errormatrix.py,sha256=A90h09mD_MKoMa7hMELlyGrMUZyQpO9ihbKrlJOoMvg,44479
@@ -100,7 +100,7 @@ pyxcp/aml/XCPonUSB.aml,sha256=1xNuM0fsDQi712hkzhBPveJcx1m318tC28bZEfnKpXU,4846
 pyxcp/aml/ifdata_SxI.a2l,sha256=ElFw9n43E4wSNVVvOiuq9TDv_zsAwSVSh4SnW8P7pCo,304
 pyxcp/aml/XCPonFlx.aml,sha256=z58FMu6ZF4hVun8WBCuxvDrq6FZ_gj3tZM15G7E8Uvw,4647
 pyxcp/master/__init__.py,sha256=14ZrFHp9wc_lizE47yl0Yr-NZ3PT2PEFPWWAaXvna34,319
-pyxcp/master/master.py,sha256=MK1_NgSG6Zb3ZLzNiZhYI7N85IXhAGOIERHX4zCzPwE,70635
+pyxcp/master/master.py,sha256=0-9oOgYRWrTAWRbrfpuJoZZ0tqKq1KfyirrEkcvk1AA,72363
 pyxcp/master/errorhandler.py,sha256=rVtCpvkxWLZtAYpjvs3SygQuLGp4lyIIxzFcYjAhsCo,13219
 pyxcp/examples/xcp_read_benchmark.py,sha256=8nlFK7ZssAuwp2nyPdI8s5MDVObP4PKRZJ--hRouNDU,839
 pyxcp/examples/conf_eth.toml,sha256=zONw4kMsNH-uQYd8V3AlNH21sAlJ9wY7RY0DuSGJiiA,109
@@ -123,7 +123,7 @@ pyxcp/examples/xcp_policy.py,sha256=iQ1Pz5UzJHz5jEHaEIG49jSmkvW5BJVW3PiUXbHlLmM,
 pyxcp/scripts/xcp_id_scanner.py,sha256=-Z7l7uGosaJC1Po4Odml92fX3GAQjPJRW3ASFt81J-Q,472
 pyxcp/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/scripts/xcp_fetch_a2l.py,sha256=rOhT0K5ERsobOeJyo8rlCV6ZGSFtgRJO0WzHrl-y87g,897
-pyxcp/scripts/xcp_info.py,sha256=COrBR1Wxncw5qQd05HVpbVUODIdbPZ7-_5ZOyitvg0E,2479
+pyxcp/scripts/xcp_info.py,sha256=GB8sz1bD1FZPO-aKr6q3EK9J1ng_z2T9ZjbB4Jczq9s,2956
 pyxcp/scripts/pyxcp_probe_can_drivers.py,sha256=r_Mc6VwGNziwyOYCHoXNcmzD8LeNgG17g7lfDS8Mohw,597
 pyxcp/recorder/build_gcc_arm.sh,sha256=spqHf6D8Jd4NACYG65SNjb-BLMntELwBDO4PpHUiyYc,238
 pyxcp/recorder/recorder.rst,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0