pyxcp 0.21.10__cp312-cp312-win32.whl → 0.21.11__cp312-cp312-win32.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,4 +1,4 @@
-pyxcp/__init__.py,sha256=YidEMFV2A-qJiIqpKabLnA_QQP2V2gm0W4LIkFEj49s,747
+pyxcp/__init__.py,sha256=9gfgRYGNG-J_wgs9znuex29MD65S7FZgiY1xlm9Rfvc,747
 pyxcp/aml/EtasCANMonitoring.a2l,sha256=hEHpb3GpuFDvU6GpAiuV028mu7MUXtfE7wslPA0GlZg,1640
 pyxcp/aml/EtasCANMonitoring.aml,sha256=xl0DdyeiIaLW0mmmJNAyJS0CQdOLSxt9dxfgrdSlU8Y,2405
 pyxcp/aml/ifdata_CAN.a2l,sha256=mQFDM6y9qyxUORYR1L0m8fMJ7S1oGheuD8ouEeYxEnI,614
@@ -17,7 +17,7 @@ pyxcp/asam/types.py,sha256=3BhMH4jH-MNYNpN7W92fW1h4xONXG2tMsHMVzlHAzN0,2492
 pyxcp/asamkeydll.c,sha256=9G10yK-8NbF6DFvXZuCgdwHfmO8Hk54J_08RMLdDL3o,2979
 pyxcp/asamkeydll.sh,sha256=DC2NKUMwvi39OQgJ6514Chr4wc1LYbTmQHmMq9jAHHs,59
 pyxcp/checksum.py,sha256=FzUe4Aa7dgJhpL7P5SbxKke8o-ogsqTFWg8AxVNYba8,11560
-pyxcp/cmdline.py,sha256=fdp2aL80UIkAhiq3gkapTiMFUz3-4-UJGAZFM87tklw,2187
+pyxcp/cmdline.py,sha256=Zd6RlCvmXMhVhtAk0gh_sfhg-extva97EvIK2TFHXZw,2305
 pyxcp/config.py,sha256=G9d14Od9Ra9lmnWRqEfLpRszXivTPHD4kIG_a5tos1U,1480
 pyxcp/constants.py,sha256=sg3Rg0U_6VHM-ybCcuh0KG1NW4qmE1IihlnHZlLxcEY,1306
 pyxcp/cxx/asynchiofactory.hpp,sha256=ivnWJ_Qyzh20K7aj0EbVsrgLUKoJ8YmO1mYXX4h1rcg,434
@@ -69,10 +69,10 @@ pyxcp/examples/xcp_unlock.py,sha256=Hn83vubRbaZhJPzlMoH_u-OH7b46zVx2COriqZDzbj4,
 pyxcp/examples/xcp_user_supplied_driver.py,sha256=psU9rwGRcGI1IuLVb5sw2LVJc2QHSjjeEgbKwSU2R5Y,1101
 pyxcp/examples/xcphello.py,sha256=vRpY7uMEdV8CbIFmCjV_V56dRdbF2qH-tR5BHkaCu4g,2591
 pyxcp/examples/xcphello_recorder.py,sha256=RbnuMzk67zszp3t0PAEcpXzuZELHYq-3VovZlPgs_IQ,3407
-pyxcp/logger.py,sha256=-g6VIWsu7uyPilZHz41qWUTha1B1a0ZTGJwckMxaTjI,1991
+pyxcp/logger.py,sha256=5UIkx0vfztA9s5LSAR2nox6rDcxzkRxS_4Zq0_Yx_p4,1964
 pyxcp/master/__init__.py,sha256=sZOjpI4cZS_kuTXYGQ3R6FL96w0bNbWTtNzSZAtngUw,329
 pyxcp/master/errorhandler.py,sha256=eCO3RWqfv5CTV84HBw6i26NSmU0L6LGZzq5EsmgSu_s,13622
-pyxcp/master/master.py,sha256=AHuhU1uF3UnY_Trx-COakdMpScjpSx_u8LshVHt4xrE,72583
+pyxcp/master/master.py,sha256=rKXGhRfgomD3P34q16c2mQ-BoOU2t0gFmBRPVeQQZVA,74353
 pyxcp/recorder/__init__.py,sha256=hdIkTKrGePj8-7A5UpvNIaZnY44ayh4fP-0gfzm14a8,2260
 pyxcp/recorder/build_clang.cmd,sha256=JvFngSnb28XcBGXxC6MGrcOCGYfahOIvHpgRpqbA6HQ,175
 pyxcp/recorder/build_clang.sh,sha256=zmU3nZxaNH1pxGWMyQ-S541TuVqxS00p3iPR9NUP4Ec,181
@@ -95,7 +95,7 @@ pyxcp/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/scripts/pyxcp_probe_can_drivers.py,sha256=kh_Nnap3xo8bmPtY_rP6cf1GMXBGPE81lGzpO0uLISo,619
 pyxcp/scripts/xcp_fetch_a2l.py,sha256=EvFnmJoXyonKvMd9a8ydWCUUeybCDXaiuN0MmyJbXyw,932
 pyxcp/scripts/xcp_id_scanner.py,sha256=E_IlOC_6D6UFZcS0jcSJ1fYfRXPjD9OvCveanAy9IuE,495
-pyxcp/scripts/xcp_info.py,sha256=zktv7shrhKBNd3PuRjPGWe6m_wLnuLkRaygCRxqcnRU,2553
+pyxcp/scripts/xcp_info.py,sha256=3vnWfhiTaymHBI3qwATsjZgg8yXBn-OmkjHImjte420,3045
 pyxcp/tests/test_asam_types.py,sha256=XfEUZHV0h2PBzedF86GAQOILgH_CyUExZeIZog1r2ZE,587
 pyxcp/tests/test_can.py,sha256=svkmwHlnJB0VWoFkrV3qE8-v9UvajJ-Syy7AJq-epbU,5133
 pyxcp/tests/test_checksum.py,sha256=7Z3V_cfWuyL43Aq4ivkU3Df7UcD1ACxdVqXt7FOe01k,1806
@@ -135,13 +135,13 @@ pyxcp/transport/cxx_ext/tests/test_timestamp.cpp,sha256=6V_rZJR9rtQgIO-CFdFIWSx7
 pyxcp/transport/eth.py,sha256=PoCafj5BF1Ir0SLEvscZivXTEihGJPo7EAgYq5WHvok,7923
 pyxcp/transport/sxi.py,sha256=VVqiXD800GociBryMtXma9l2QspQpwECE1eNy4Cq4us,2583
 pyxcp/transport/usb_transport.py,sha256=hK4FTl1DM7xDoNjcBXoMeb-YZfk2SP3BihlbJM6mL2w,7888
-pyxcp/types.py,sha256=uV-f4XlG1IjqeIT8PGUnb5CwEBcX10JQ7aDt3gWJrwk,24950
+pyxcp/types.py,sha256=TVXsAs-Js1pp4JJME2pDojRNIq96wfG9tJ357RVBn7w,25060
 pyxcp/utils.py,sha256=b7zNSMLOYhgKBHXQSDbSfGYzhgXlje_xsJK0LztdNTk,1960
 pyxcp/vector/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/vector/map.py,sha256=5FPdKgvP5CKuas2R5PIsxUvip-bVp7kwrEcQAZjZcAw,2369
-rekorder.cp312-win32.pyd,sha256=K4Ldj2rjt3ydg5NG4NCcbZLrGTzLhodnU8Abf_myjns,141312
-pyxcp-0.21.10.dist-info/entry_points.txt,sha256=wL4Cgx0wIAbuEr93nPewLCL-6DCSunxxTkui-bibme8,219
-pyxcp-0.21.10.dist-info/WHEEL,sha256=4b0mtI0-qo1BufjhFYXXEqC6LZSbmC3VzWKotlxOTkM,93
-pyxcp-0.21.10.dist-info/METADATA,sha256=uK6eR-eJ54LMAbV0K5m0LVgj_jt6xAm3VQotEdsbG8c,3862
-pyxcp-0.21.10.dist-info/licenses/LICENSE,sha256=fTqV5eBpeAZO0_jit8j4Ref9ikBSlHJ8xwj5TLg7gFk,7817
-pyxcp-0.21.10.dist-info/RECORD,,
+rekorder.cp312-win32.pyd,sha256=Rqrrc4WGkLdCjzOBAvCtvJATU7mY8ID9A93XYq0eVQY,141312
+pyxcp-0.21.11.dist-info/entry_points.txt,sha256=wL4Cgx0wIAbuEr93nPewLCL-6DCSunxxTkui-bibme8,219
+pyxcp-0.21.11.dist-info/WHEEL,sha256=4b0mtI0-qo1BufjhFYXXEqC6LZSbmC3VzWKotlxOTkM,93
+pyxcp-0.21.11.dist-info/METADATA,sha256=GK1NxADBF_DgZU5tvGlwV6fW6LlbTiNn4g_89RjxONc,3862
+pyxcp-0.21.11.dist-info/licenses/LICENSE,sha256=fTqV5eBpeAZO0_jit8j4Ref9ikBSlHJ8xwj5TLg7gFk,7817
+pyxcp-0.21.11.dist-info/RECORD,,