pyxcp 0.23.4__cp310-cp310-macosx_11_0_arm64.whl → 0.23.7__cp310-cp310-macosx_11_0_arm64.whl

pyxcp-0.23.7.dist-info/METADATA

@@ -0,0 +1,339 @@
+Metadata-Version: 2.3
+Name: pyxcp
+Version: 0.23.7
+Summary: Universal Calibration Protocol for Python
+License: LGPLv3
+Keywords: automotive,ecu,xcp,asam,autosar
+Author: Christoph Schueler
+Author-email: cpu.gems@googlemail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development
+Requires-Dist: bandit (>=1.7.8,<2.0.0)
+Requires-Dist: chardet (>=5.2.0,<6.0.0)
+Requires-Dist: construct (>=2.10.68,<3.0.0)
+Requires-Dist: line-profiler-pycharm (>=1.1.0,<2.0.0)
+Requires-Dist: mako (>=1.2.4,<2.0.0)
+Requires-Dist: pyserial (>=3.5,<4.0)
+Requires-Dist: python-can (>=4.2.2,<5.0.0)
+Requires-Dist: pytz (>=2025.2,<2026.0)
+Requires-Dist: pyusb (>=1.2.1,<2.0.0)
+Requires-Dist: rich (>=14.0.0,<15.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: tomlkit (>=0.13.3,<0.14.0)
+Requires-Dist: traitlets (<=5.11.2)
+Requires-Dist: uptime (>=3.0.1,<4.0.0)
+Project-URL: Homepage, https://github.com/christoph2/pyxcp
+Description-Content-Type: text/x-rst
+
+Readme
+======
+
+.. image:: pyxcp_social.jpg
+    :align: center
+
+Reliable Python tooling for the ASAM MCD-1 XCP protocol (measurement,
+calibration, flashing) with multiple transports (CAN, Ethernet, USB,
+Serial) and handy CLI utilities.
+
+|PyPI| |Python Versions| |License: LGPL v3+| |Code style: black|
+
+``pyXCP`` is a production-ready Python library for communicating with
+XCP-enabled devices, most commonly automotive ECUs. Use it to take
+measurements, adjust parameters (calibration), stream DAQ/STIM, and
+program devices during development.
+
+Highlights:
+
+- Transports: Ethernet (TCP/IP), CAN, USB, Serial (SxI)
+- Cross-platform: Windows, Linux, macOS
+- Rich CLI tools for common XCP tasks
+- Extensible architecture and layered design
+
+--------------
+
+Installation
+------------
+
+The easiest way is from PyPI:
+
+.. code:: shell
+
+   pip install pyxcp
+
+To install from the main branch:
+
+.. code:: shell
+
+   pip install git+https://github.com/christoph2/pyxcp.git
+
+Requirements
+~~~~~~~~~~~~
+
+- Python >= 3.10
+- Building from source requires a working C/C++ toolchain (native
+  extensions are used for performance). Wheels are provided for common
+  platforms and Python versions; if a wheel is not available, pip will
+  build from source.
+- An XCP slave device (or simulator)
+
+Quick start
+-----------
+
+The tutorial walks you through typical tasks end-to-end: see `tutorial <tutorial.rst>`_.
+
+Minimal example using the built-in argument parser and context manager:
+
+.. code:: python
+
+   from pyxcp.cmdline import ArgumentParser
+
+   ap = ArgumentParser(description="pyXCP hello world")
+
+   with ap.run() as x:
+       x.connect()
+       identifier = x.identifier(0x01)
+       print(f"ID: {identifier!r}")
+       print(x.slaveProperties)
+       x.disconnect()
+
+Configuration
+~~~~~~~~~~~~~
+
+``pyXCP`` supports a
+`traitlets <https://github.com/ipython/traitlets>`__\-based configuration system.
+
+- Recommended Python config example and generator: `tutorial <tutorial.rst>`__ and `configuration <configuration.rst>`__
+- Legacy TOML examples remain available for compatibility.
+
+Command‑line tools
+~~~~~~~~~~~~~~~~~~
+
+Installed entry points (see pyproject.toml):
+
+- xcp-info — print capabilities and properties
+- xcp-id-scanner — scan for slave identifiers
+- xcp-fetch-a2l — retrieve A2L from target (if supported)
+- xcp-profile — generate/convert config files
+- xcp-examples — launch assorted demos/examples
+- xmraw-converter — convert recorder .xmraw data
+- pyxcp-probe-can-drivers — list available CAN interfaces
+
+Run any tool with -h for options.
+
+Features
+--------
+
+- Multiple transport layers: Ethernet (TCP), CAN, USB, SxI (serial/UART)
+- Data Acquisition (DAQ) and Stimulation (STIM)
+- Calibration (read/write parameters)
+- Flashing/programming workflows
+- A2L (ASAM MCD‑2 MC) support
+- Recorder utilities and converters (see `recorder <recorder.rst>`__)
+- Extensible architecture for custom transports
+
+Documentation
+-------------
+
+- Getting started tutorial: `tutorial <tutorial.rst>`__
+- Configuration: `configuration <configuration.rst>`__
+- CAN driver setup and troubleshooting: `howto_can_driver <howto_can_driver.rst>`__
+- Recorder: `recorder <recorder.rst>`__
+- Troubleshooting: `troubleshooting <troubleshooting.rst>`__
+- Troubleshooting matrix (common errors, root causes, fixes):
+  `troubleshooting_matrix <troubleshooting_matrix.rst>`__
+
+To build the Sphinx documentation locally:
+
+1. Install doc requirements:
+	``pip install -r docs/requirements.txt``
+2. Build:
+	``sphinx-build -b html docs docs/_build/html``
+3. Open
+	``docs/_build/html/index.html``
+
+Compatibility
+-------------
+
+- Operating systems: Windows, Linux, macOS
+- Python: 3.10 - 3.14, CPython wheels where available
+- CAN backends: python-can compatible drivers (see `howto_can_driver <howto_can_driver.rst>`__)
+
+Contributing
+------------
+
+Contributions are welcome! Please: - Read `CODE_OF_CONDUCT <../CODE_OF_CONDUCT.md>`__ - Open an
+issue or discussion before large changes - Use
+`pre-commit <https://github.com/pre-commit/pre-commit>`__ to run linters
+and tests locally
+
+License
+-------
+
+GNU Lesser General Public License v3 or later (LGPLv3+). See LICENSE for
+details.
+
+References
+----------
+
+- ASAM MCD‑1 XCP standard:
+  https://www.asam.net/standards/detail/mcd-1-xcp/
+
+About ASAM MCD‑1 XCP
+--------------------
+
+XCP (Universal Measurement and Calibration Protocol) is an ASAM standard
+defining a vendor‑neutral protocol to access internal data of electronic
+control units (ECUs) for measurement, calibration (parameter tuning),
+and programming. XCP decouples the protocol from the physical transport,
+so the same command set can be carried over different buses such as CAN,
+FlexRay, Ethernet, USB, or Serial.
+
+- Roles: An XCP Master (this library) communicates with an XCP Slave
+  (your device/ECU or simulator).
+- Layered concept: XCP defines an application layer and transport
+  layers. ``pyXCP`` implements the application layer and multiple transport
+  bindings.
+- Use cases:
+
+  - Measurement: Read variables from the ECU in real‑time, including
+    high‑rate DAQ streaming.
+  - Calibration: Read/write parameters (calibration data) in RAM/flash.
+  - Programming: Download new program/data to flash (where the slave
+    supports it).
+
+For the authoritative description, see the ASAM page:
+https://www.asam.net/standards/detail/mcd-1-xcp/
+
+XCP in a nutshell
+-----------------
+
+- Connect/Session: The master establishes a connection, negotiates
+  capabilities/features, and optionally unlocks protected functions via
+  seed & key.
+- Addressing: Memory is accessed via absolute or segment‑relative
+  addresses. Addressing modes are described in the associated A2L file
+  (ASAM MCD‑2 MC), which maps symbolic names to addresses, data types,
+  and conversion rules.
+- Events: The slave exposes events (e.g., “1 ms task”, “Combustion
+  cycle”), which trigger DAQ sampling. The master assigns signals (ODTs)
+  to these events for time‑aligned acquisition.
+- DAQ/STIM: DAQ = Data Acquisition (slave → master), STIM = Stimulation
+  (master → slave). Both use event‑driven lists for deterministic
+  timing.
+- Timestamps: DAQ may carry timestamps from the slave for precise time
+  correlation.
+- Security: Access to sensitive commands (e.g., programming,
+  calibration) can be protected by a seed & key algorithm negotiated at
+  runtime.
+- Checksums: XCP defines checksum services useful for verifying memory
+  regions (e.g., after flashing).
+
+Relation to A2L (ASAM MCD‑2 MC)
+-------------------------------
+
+While XCP defines the protocol, the A2L file describes the measurement
+and calibration objects (characteristics, measurements), data types,
+conversion rules, and memory layout. In practice, you use ``pyXCP`` together
+with an A2L to: - Resolve symbolic names to addresses and data types. -
+Configure DAQ lists from human‑readable signal names. - Interpret raw
+values using the appropriate conversion methods.
+
+``pyXCP`` provides utilities to fetch A2L data when supported by the slave
+and to work with A2L‑described objects. See also
+`pya2ldb <https://github.com/christoph2/pya2l>`__!
+
+Transports and addressing
+-------------------------
+
+XCP is transport‑agnostic. ``pyXCP`` supports multiple transports and
+addressing schemes: - CAN (XCP on CAN): Robust and ubiquitous in
+vehicles; limited payload and bandwidth; suited for many calibration
+tasks and moderate DAQ rates. - Ethernet (XCP on TCP/UDP): High
+bandwidth with low latency; well suited for rich DAQ and programming
+workflows. - USB: High throughput for lab setups; requires device
+support. - Serial/SxI: Simple point‑to‑point links for embedded targets
+and simulators.
+
+The exact capabilities (e.g., max CTO/DTO, checksum types, timestamping)
+are negotiated at connect time and depend on the slave and transport.
+
+Supported features (overview)
+-----------------------------
+
+The scope of features depends on the connected slave. At the library
+level, ``pyXCP`` provides: - Session management: CONNECT/DISCONNECT,
+GET_STATUS/SLAVE_PROPERTIES, communication mode setup, error handling. -
+Memory access: Upload/short upload, Download/Download Next,
+verifications, optional paged memory where supported. - DAQ/STIM:
+Configuration of DAQ lists/ODTs, event assignment, data streaming,
+timestamp handling when available. - Programming helpers: Building
+blocks for program/erase/write flows (exact sequence per slave’s flash
+algorithm and A2L description). - Security/Seed & Key: Pluggable
+seed‑to‑key resolution including 32↔64‑bit bridge on Windows. -
+Utilities: Identifier scanning, A2L helpers, recorder and converters.
+
+Refer to `tutorial <tutorial.rst>`__ and `configuration <configuration.rst>`__ for feature usage,
+and xcp-info for a capability dump of your target.
+
+Compliance and versions
+-----------------------
+
+``pyXCP`` aims to be compatible with commonly used parts of ASAM MCD‑1 XCP.
+Specific optional features are enabled when a slave advertises them
+during CONNECT. Because implementations vary across vendors and ECU
+projects, always consult your A2L and use xcp-info to confirm negotiated
+options (e.g., checksum type, timestamp unit, max DTO size, address
+granularity).
+
+If you rely on a particular XCP feature/profile not mentioned here,
+please open an issue with details about your slave and A2L so we can
+clarify support and—if feasible—add coverage.
+
+Safety, performance, and limitations
+------------------------------------
+
+- Safety‑critical systems: XCP is a development and testing protocol. Do
+  not enable measurement/calibration on safety‑critical systems in the
+  field unless your system‑level safety case covers it.
+- Performance: Achievable DAQ rates depend on transport bandwidth, ECU
+  event rates, DTO sizes, and host processing. Ethernet typically yields
+  the highest throughput.
+- Latency/jitter: Event scheduling in the slave and OS scheduling on the
+  host can affect determinism. Use timestamps to correlate data
+  precisely.
+- Access control: Seed & key protects sensitive functions; your
+  organization’s policy should govern algorithm distribution and access.
+
+Further resources
+-----------------
+
+- ASAM MCD‑1 XCP standard (overview and membership):
+  https://www.asam.net/standards/detail/mcd-1-xcp/
+- ASAM MCD‑2 MC (A2L) for object descriptions:
+  https://www.asam.net/standards/detail/mcd-2-mc/
+- Introduction to DAQ/STIM concepts (ASAM publications and vendor docs)
+- Related: CCP (legacy predecessor to XCP), ASAM MDF for measurement
+  data storage
+
+.. |CI| image:: https://github.com/christoph2/pyxcp/workflows/Python%20application/badge.svg
+   :target: https://github.com/christoph2/pyxcp/actions
+.. |PyPI| image:: https://img.shields.io/pypi/v/pyxcp.svg
+   :target: https://pypi.org/project/pyxcp/
+.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/pyxcp.svg
+   :target: https://pypi.org/project/pyxcp/
+.. |License: LGPL v3+| image:: https://img.shields.io/badge/License-LGPL%20v3%2B-blue.svg
+   :target: https://www.gnu.org/licenses/lgpl-3.0
+.. |Code style: black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
+   :target: https://github.com/psf/black
+

{pyxcp-0.23.4.dist-info → pyxcp-0.23.7.dist-info}/RECORD

@@ -1,19 +1,24 @@
+pyxcp-0.23.7.dist-info/RECORD,,
+pyxcp-0.23.7.dist-info/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
+pyxcp-0.23.7.dist-info/WHEEL,sha256=LYpYYCEq2c6ymHhOSnJTe4ux3ULYSEUrqCKSUjEORwM,134
+pyxcp-0.23.7.dist-info/entry_points.txt,sha256=LkHsEwubm30s4oiyCy0cKj6k97ALvQ6KjAVdyEcqu7g,358
+pyxcp-0.23.7.dist-info/METADATA,sha256=t_ndqpGCZ0vWyXI2tRS73YMxpWAS1Co6OXGEAXy1IxY,12718
 pyxcp/dllif.py,sha256=m4e-_dgDLCD6COU5W2LdeYUlib_Xxyxbh977bbS-VAU,3344
 pyxcp/checksum.py,sha256=aveS0z4vthLXABEFhTqELqFNi7LM6ZzDzq7dD5Xe9oo,11167
 pyxcp/asamkeydll.sh,sha256=iema12sub6qNE0xAuzwGtx0FmkdaaOKoXalhrtWVaa8,57
 pyxcp/asamkeydll.c,sha256=l5RHYcEPY_Q07G-W5IjCq0xci8YfUR-3uYt84OOkOJI,2836
 pyxcp/constants.py,sha256=Yemk_Gi_m78EEU0v-sdGCAodb9dv_vqP969IU3izA2M,1113
-pyxcp/cmdline.py,sha256=EoN-_AJm0lz1egPzNcmIFO2Uqo4c0lBXSAB25Uc6N9Q,2441
-pyxcp/__init__.py,sha256=IyyaS5_zWWbL0LDLYQGbYeYSk5m5OF7PdDajHj8cq_E,527
+pyxcp/cmdline.py,sha256=OVSO-X6JV1Si2tKZ1ar2gYbiqCTlTaj5jY-z6N2Vk3Q,2453
+pyxcp/__init__.py,sha256=0Lens5crznGTlhKtnOVYewjfcuUNvEEjr3r5kDcYeno,527
 pyxcp/types.py,sha256=XJxJUh9bK5Urfia8IHVLJ-NFgQACYBd_n73L-AaeZts,25158
 pyxcp/timing.py,sha256=hzeQZ3P7ij_bfskoVMi10Iv5S4i_6TQYfnB8PXTX6c4,1645
-pyxcp/utils.py,sha256=Ax3TNT4OotRdJs_MVz83i7gTinpbOWwPnNVIL9WYTW4,3402
+pyxcp/utils.py,sha256=cHb5RUNim90U1U_a4axRmfa2n_xhFdjqHoRBEODoscs,3404
 pyxcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/errormatrix.py,sha256=cYcsJ11Qm39DPuaR4BJ9fMpS3Hkphd_ezIQOKjI-pQE,44586
 pyxcp/asam/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/asam/types.py,sha256=V4wSCGI1pXn0EsBemDyaHTBgY2wkV_BeLShnDIGGgDE,2310
 pyxcp/daq_stim/stim.cpp,sha256=sABgEfbQlt5kXbzAsndyhaDFWRWTJw3jJlNfanIVrRs,164
-pyxcp/daq_stim/__init__.py,sha256=Lm-FCoXyY6Y51571nAa4OA4LU50NqCYffj_cnryjir4,9299
+pyxcp/daq_stim/__init__.py,sha256=7Lly_Sn2SQljadGyY9pcDqTYNIkw8O_t7GVlCZDL2wQ,12171
 pyxcp/daq_stim/scheduler.cpp,sha256=2XW9PmxrJR8DfYMVszGwBX-KANVviwPcUNBvnjw5MlM,1443
 pyxcp/daq_stim/stim.hpp,sha256=1DwAhkY7XJN14aD2BxLJ4O1j4_a6RvpePIbAG1U8iOA,17904
 pyxcp/daq_stim/stim.cpython-310-darwin.so,sha256=pE7imb11QMYyQv8HTO54EmnJrS5GsocxWJJT5vCPHyw,237784
@@ -22,15 +27,15 @@ pyxcp/daq_stim/stim_wrapper.cpp,sha256=7iL1-4BPavo5bfrph20Fvicn6HxGEZQqYLvdxniJB
 pyxcp/daq_stim/optimize/__init__.py,sha256=joAKvAvlYQEi7VF2oVftn_ohgRO231wnc3e8fY231L4,2453
 pyxcp/daq_stim/optimize/binpacking.py,sha256=AZHABtAnzBVJ-MVUGLrxuAp_bAtv3C-gMxrXXXrgi-Y,1216
 pyxcp/transport/transport_wrapper.cpp,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pyxcp/transport/eth.py,sha256=V-jclzloRFz6LczPHmvS_RF1re_CcNQ7xsVBpgv2HNw,8492
+pyxcp/transport/eth.py,sha256=IXq_BB2LP5OguqUzNPZdnMxn0gUOf9gnIdiNGgel204,9771
 pyxcp/transport/sxi.py,sha256=gbFTOA-O0q0RwZUbRgN3hCdkoutxMt15TgVjVwdvWsY,4625
 pyxcp/transport/base_transport.hpp,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/transport/__init__.py,sha256=wIeYkGygucYdXEzymJcDvimnwZgqJY8KRv7Mk__aUSU,428
 pyxcp/transport/usb_transport.py,sha256=27c19S67BMq1Eup6ViX-SiYpEq93bMTwe031RsE4Xm0,8130
-pyxcp/transport/can.py,sha256=uFPG_Caf1BwIo2pKheZLs0VfPth1KoEPxuKtI2qt9as,18250
-pyxcp/transport/base.py,sha256=_jjoTGEIbzxR5rsBbSmxnlvoUI-Kr4VomWhH58z4RBk,17074
+pyxcp/transport/can.py,sha256=fE0k6GlBt913EVQh3Wpd781cikT5ht7Q8lAiU4En3tc,21283
+pyxcp/transport/base.py,sha256=pq8PwgGb8ex9WC_mDNBFs_qKRZZl8O2pzK1fAjZaIyk,22604
 pyxcp/config/legacy.py,sha256=Uhu_6bp_W8yGmZ2s3TFzf8-5mGwLdeTss56BMYWpsZY,5100
-pyxcp/config/__init__.py,sha256=z9bXNb2Hp-h2ZtASCyGk3JWP3OGoOL5Hmvazl-L_ANE,45258
+pyxcp/config/__init__.py,sha256=rG-HPWJMPbxs6fu4-TpV4Gbctg7Nz9Jmogm6FMPSqlY,48274
 pyxcp/tests/test_utils.py,sha256=gqv3bhhWfKKdKDkqnELqsOHCfpRRZwlReEy87Ya4Z2w,850
 pyxcp/tests/test_master.py,sha256=a_Q8Fa49y_3vnrp-VFZ-22cHWjq58RC2daF6EcfbhZc,69434
 pyxcp/tests/test_daq.py,sha256=mThMsweEwxzIFRQQ88BNz_60OQ-xmC5OamIxHx9VWis,5358
@@ -55,8 +60,8 @@ pyxcp/aml/XCPonUSB.aml,sha256=rPGduH-PE8-tBeELSm3vfkbf62uhlVP6gvJL0OvMclc,4847
 pyxcp/aml/ifdata_SxI.a2l,sha256=8rAB6HTTAuNlFSrkFpR7fUA702yN4rTTNkw-xspZNV0,303
 pyxcp/aml/XCPonFlx.aml,sha256=z58FMu6ZF4hVun8WBCuxvDrq6FZ_gj3tZM15G7E8Uvw,4647
 pyxcp/master/__init__.py,sha256=o3XB9GDwLiqh-KRFC9YTOd0EvxJXDpyrcVxebiwT934,309
-pyxcp/master/master.py,sha256=RHw-1OT_dxsAeyChqnimqNRWEDKGP__Mw822D-7lKsY,76388
-pyxcp/master/errorhandler.py,sha256=C3T0nvn3L5QCE1AD-7dJp-D16YxfcS2OZOb9SwXySuM,14917
+pyxcp/master/master.py,sha256=oft1aNYqmilFZ00ZI7aO5lPaxXg5-Act6ji23x3bc6U,76980
+pyxcp/master/errorhandler.py,sha256=7EftfxWYqRyXurJEZS8PAyXVHs_e4qV8uWsUOMuE2Ug,19402
 pyxcp/examples/xcp_read_benchmark.py,sha256=Hl0hrjV3FE-ivswvYOh0MsKiHnk03z7w8lQDYnvfeM8,918
 pyxcp/examples/conf_eth.toml,sha256=b6bKN-K07gMQHNj7yiyB-HKrkVtZREgPXS4ByQueBs4,190
 pyxcp/examples/xcphello_recorder.py,sha256=wL92d0dbPkjFzCT08JoRD9Mg2D6QbOpOzFDgSYdcNog,3302
@@ -68,7 +73,7 @@ pyxcp/examples/xcp_user_supplied_driver.py,sha256=Wyep2KhtcFC2GzZuJPj5ikSqWIWYsf
 pyxcp/examples/xcp_skel.py,sha256=F2g2C79jiYZl0cpRHfzWusfn1ZvodOS_r1Az6aknZL4,1110
 pyxcp/examples/xcp_unlock.py,sha256=vl2Zv7Z6EuBxI2ZxbGQK6-0tZBVqd72FZllsvIfuJ5w,652
 pyxcp/examples/xcphello.py,sha256=JK9U_QkFP0AwKlZK9lFB66GAqUDFRoXL3XMYO5EdRQQ,2550
-pyxcp/examples/run_daq.py,sha256=JObp9HtjJphwr5sVQ4Jj3Q5GZHGNCK12tYTfR-6qcr4,5461
+pyxcp/examples/run_daq.py,sha256=PMseqJBDnpRofvNQNl619qpJeAaKuzi3HzYuT5zvRN0,5468
 pyxcp/examples/conf_socket_can.toml,sha256=JB9zHHaya2mDXf0zPY7zEKiBDX2chzBBRxt7h3LxxDk,257
 pyxcp/examples/conf_sxi.toml,sha256=r81OD0mCLk_h7vrN5MBJk0HFbiWi3bQZtFgFVrW6qcM,118
 pyxcp/examples/conf_can.toml,sha256=oGkZYgmcpPsJ6YKGELm6DqF-hNvokJHCq99LAqxCyso,351
@@ -87,14 +92,14 @@ pyxcp/recorder/recorder.rst,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/recorder/mio.hpp,sha256=emP4qMXTxOe1wRSkB_U0hgOVz4aMUgG5dqcCvNNkAjs,61632
 pyxcp/recorder/build_gcc.cmd,sha256=A1xt8AS7VZxjJq21VzX8cOT7wl9ap_AIXBWbcIEddCw,237
 pyxcp/recorder/writer.hpp,sha256=rNjtRTtJes5z-BzKR2K56P_Kvc9MEVQgycu8J0wKf1g,11284
-pyxcp/recorder/rekorder.cpython-310-darwin.so,sha256=ibNGz9FIbkRqVm_uypRLTmMYDXk_slTGFX92NGJ_8zo,529952
+pyxcp/recorder/rekorder.cpython-310-darwin.so,sha256=r5_memGnoh681bRzU2tZqk1VRJSxXm1dQLwiktzwXCg,529936
 pyxcp/recorder/lz4hc.c,sha256=GhoLtpQF6ViHkhQ_TaLw9UCzSB_MO-fdflgjR_xFFfM,86829
 pyxcp/recorder/lz4.h,sha256=BkRLAtxukE15Z2yO0Pjrq-n6hw5W6jkGFR5f14MzpEU,45604
 pyxcp/recorder/rekorder.cpp,sha256=LtN3Ud_pigNZ70gJ5-tyFJZN-3PMDVwqbbH694--TxQ,1841
-pyxcp/recorder/wrap.cpp,sha256=S3frBevIrPE5m3kt_mXe9TDOwWPJFiVa7Rt9FGMCv2A,8909
+pyxcp/recorder/wrap.cpp,sha256=T4cwpmjhYbr75Q3plQpJTkNLyKE4lL0W7GC-8QSURJ8,8666
 pyxcp/recorder/build_clang.sh,sha256=TZHpQZbRE6M6vHf_ln5laO9tyREUbMu-HAw0VDGx5yw,179
 pyxcp/recorder/reader.hpp,sha256=rr9XZ_ciL6eF2_xEqyt9XYNqTIze9ytAsnf8uYukO9U,5201
-pyxcp/recorder/__init__.py,sha256=jeTmKvfjIenxHxt7zn6HMjnDpuPQU0d9SdnYK_t3gdE,2850
+pyxcp/recorder/__init__.py,sha256=HA8U6V85vbgZNWyNvJlY8l77YeTO0tHWl3t1v9DvjkQ,2846
 pyxcp/recorder/test_reko.py,sha256=sIM_BBY9sq1ZUTawoxmDzdtd5qHPT9w6eVYZoY4iFik,980
 pyxcp/recorder/build_clang.cmd,sha256=vIWwC1zF_WChakjfj8VaUCN6X8HwyqvGgFRdUub1TtE,174
 pyxcp/recorder/reco.py,sha256=SAO_XMKSBWHhdzxfkmV9ZoPvJjale4BGi8O9p5Sd_iE,8448
@@ -103,7 +108,7 @@ pyxcp/recorder/rekorder.hpp,sha256=sWvRch9bVt6mmgrFHp5mwWhap7HoFG4geeb7UqEIzio,7
 pyxcp/recorder/lz4hc.h,sha256=U_uN3Q2wIi3_dbEceJ16xHJZGotUiBTcnL6O5ARPi8M,20179
 pyxcp/recorder/lz4.c,sha256=k5b33lJ7yENd6cdWn7eZjlZUWoS088LYCMAjXAF3RTk,118145
 pyxcp/recorder/build_gcc.sh,sha256=uvMhL4faEJmhG_8rzSOxEBRRqrACC0kmZgaERN8GkUs,209
-pyxcp/recorder/unfolder.hpp,sha256=3gJKT2eMOZuT8o_M2NFLthdUIWd460vdwzlHaf-fQII,47998
+pyxcp/recorder/unfolder.hpp,sha256=jKvjQs8VSVfsYRkLguV97Csde_Xbt8G-tGkuKnbaSqY,48763
 pyxcp/recorder/converter/__init__.py,sha256=mqzH3jxGpFrtS2dHyfDLCYKeJycav3_-6z8svlI07eU,14452
 pyxcp/stim/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyxcp/vector/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -118,8 +123,3 @@ pyxcp/cpp_ext/helper.hpp,sha256=ONAsVupIqqmNDp8bgGWS0TfSYeCFkk3kwwZbbqsh0HQ,7813
 pyxcp/cpp_ext/bin.hpp,sha256=0CatarJ7jFewlg9EIxsDPxC4wnORHutx-1PLHpf9iqw,2457
 pyxcp/cpp_ext/daqlist.hpp,sha256=Q1Gejo8i1rP2PzyUh4UHJ2z-kG0WNnkbBj7N8DAdzaM,7071
 pyxcp/cpp_ext/cpp_ext.cpython-310-darwin.so,sha256=5sPtzwLXzXBbJ2zI2kGk0gF83xnDHvKbt0XasjPfe1c,321520
-pyxcp-0.23.4.dist-info/RECORD,,
-pyxcp-0.23.4.dist-info/LICENSE,sha256=46mU2C5kSwOnkqkw9XQAJlhBL2JAf1_uCD8lVcXyMRg,7652
-pyxcp-0.23.4.dist-info/WHEEL,sha256=LYpYYCEq2c6ymHhOSnJTe4ux3ULYSEUrqCKSUjEORwM,134
-pyxcp-0.23.4.dist-info/entry_points.txt,sha256=LkHsEwubm30s4oiyCy0cKj6k97ALvQ6KjAVdyEcqu7g,358
-pyxcp-0.23.4.dist-info/METADATA,sha256=hFSek7Gb_hDy_HhSaLoPqtKp1C8p44CMs9KFdKuge1g,11688

pyxcp-0.23.4.dist-info/METADATA

@@ -1,219 +0,0 @@
-Metadata-Version: 2.3
-Name: pyxcp
-Version: 0.23.4
-Summary: Universal Calibration Protocol for Python
-License: LGPLv3
-Keywords: automotive,ecu,xcp,asam,autosar
-Author: Christoph Schueler
-Author-email: cpu.gems@googlemail.com
-Requires-Python: >=3.10,<4.0
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Software Development
-Requires-Dist: bandit (>=1.7.8,<2.0.0)
-Requires-Dist: chardet (>=5.2.0,<6.0.0)
-Requires-Dist: construct (>=2.10.68,<3.0.0)
-Requires-Dist: line-profiler-pycharm (>=1.1.0,<2.0.0)
-Requires-Dist: mako (>=1.2.4,<2.0.0)
-Requires-Dist: pyserial (>=3.5,<4.0)
-Requires-Dist: python-can (>=4.2.2,<5.0.0)
-Requires-Dist: pytz (>=2025.2,<2026.0)
-Requires-Dist: pyusb (>=1.2.1,<2.0.0)
-Requires-Dist: rich (>=14.0.0,<15.0.0)
-Requires-Dist: toml (>=0.10.2,<0.11.0)
-Requires-Dist: tomlkit (>=0.13.3,<0.14.0)
-Requires-Dist: traitlets (<=5.11.2)
-Requires-Dist: uptime (>=3.0.1,<4.0.0)
-Project-URL: Homepage, https://github.com/christoph2/pyxcp
-Description-Content-Type: text/markdown
-
-# pyXCP
-
-Reliable Python tooling for the ASAM MCD‑1 XCP protocol (measurement, calibration, flashing) with multiple transports (CAN, Ethernet, USB, Serial) and handy CLI utilities.
-
-[![CI](https://github.com/christoph2/pyxcp/workflows/Python%20application/badge.svg)](https://github.com/christoph2/pyxcp/actions)
-[![PyPI](https://img.shields.io/pypi/v/pyxcp.svg)](https://pypi.org/project/pyxcp/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/pyxcp.svg)](https://pypi.org/project/pyxcp/)
-[![License: LGPL v3+](https://img.shields.io/badge/License-LGPL%20v3%2B-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)
-[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
-
-pyXCP is a production-ready Python library for communicating with XCP-enabled devices, most commonly automotive ECUs. Use it to take measurements, adjust parameters (calibration), stream DAQ/STIM, and program devices during development.
-
-Highlights:
-- Transports: Ethernet (TCP/IP), CAN, USB, Serial (SxI)
-- Cross‑platform: Windows, Linux, macOS
-- Rich CLI tools for common XCP tasks
-- Extensible architecture and layered design
-
----
-
-## Installation
-
-The easiest way is from PyPI:
-
-```shell
-pip install pyxcp
-```
-
-To install from the main branch:
-
-```shell
-pip install git+https://github.com/christoph2/pyxcp.git
-```
-
-
-### Requirements
-- Python >= 3.10
-- Building from source requires a working C/C++ toolchain (native extensions are used for performance). Wheels are provided for common platforms and Python versions; if a wheel is not available, pip will build from source.
-- An XCP slave device (or simulator)
-
-## Quick start
-
-The tutorial walks you through typical tasks end‑to‑end: see docs/tutorial.md.
-
-Minimal example using the built‑in argument parser and context manager:
-
-```python
-from pyxcp.cmdline import ArgumentParser
-
-ap = ArgumentParser(description="pyXCP hello world")
-
-with ap.run() as x:
-    x.connect()
-    identifier = x.identifier(0x01)
-    print(f"ID: {identifier!r}")
-    print(x.slaveProperties)
-    x.disconnect()
-```
-
-### Configuration
-pyXCP supports a [traitlets](https://github.com/ipython/traitlets)‑based configuration system.
-- Recommended Python config example and generator: docs/tutorial.md and docs/configuration.md
-- Legacy TOML examples remain available for compatibility.
-
-### Command‑line tools
-Installed entry points (see pyproject.toml):
-- xcp-info — print capabilities and properties
-- xcp-id-scanner — scan for slave identifiers
-- xcp-fetch-a2l — retrieve A2L from target (if supported)
-- xcp-profile — generate/convert config files
-- xcp-examples — launch assorted demos/examples
-- xmraw-converter — convert recorder .xmraw data
-- pyxcp-probe-can-drivers — list available CAN interfaces
-
-Run any tool with -h for options.
-
-## Features
-- Multiple transport layers: Ethernet (TCP), CAN, USB, SxI (serial/UART)
-- Data Acquisition (DAQ) and Stimulation (STIM)
-- Calibration (read/write parameters)
-- Flashing/programming workflows
-- A2L (ASAM MCD‑2 MC) support
-- Recorder utilities and converters (see docs/recorder.md)
-- Extensible architecture for custom transports
-
-## Documentation
-- Getting started tutorial: docs/tutorial.md
-- Configuration: docs/configuration.md
-- CAN driver setup and troubleshooting: docs/howto_can_driver.md
-- Recorder: docs/recorder.md
-
-To build the Sphinx documentation locally:
-1. Install doc requirements: `pip install -r docs/requirements.txt`
-2. Build: `sphinx-build -b html docs docs/_build/html`
-3. Open `docs/_build/html/index.html`
-
-## Compatibility
-- Operating systems: Windows, Linux, macOS
-- Python: 3.10 - 3.14, CPython wheels where available
-- CAN backends: python-can compatible drivers (see docs/howto_can_driver.md)
-
-## Contributing
-Contributions are welcome! Please:
-- Read CODE_OF_CONDUCT.md
-- Open an issue or discussion before large changes
-- Use [pre-commit](https://github.com/pre-commit/pre-commit) to run linters and tests locally
-
-## License
-GNU Lesser General Public License v3 or later (LGPLv3+). See LICENSE for details.
-
-## References
-- ASAM MCD‑1 XCP standard: https://www.asam.net/standards/detail/mcd-1-xcp/
-
-
-## About ASAM MCD‑1 XCP
-XCP (Universal Measurement and Calibration Protocol) is an ASAM standard defining a vendor‑neutral protocol to access internal data of electronic control units (ECUs) for measurement, calibration (parameter tuning), and programming. XCP decouples the protocol from the physical transport, so the same command set can be carried over different buses such as CAN, FlexRay, Ethernet, USB, or Serial.
-
-- Roles: An XCP Master (this library) communicates with an XCP Slave (your device/ECU or simulator).
-- Layered concept: XCP defines an application layer and transport layers. pyXCP implements the application layer and multiple transport bindings.
-- Use cases:
-  - Measurement: Read variables from the ECU in real‑time, including high‑rate DAQ streaming.
-  - Calibration: Read/write parameters (calibration data) in RAM/flash.
-  - Programming: Download new program/data to flash (where the slave supports it).
-
-For the authoritative description, see the ASAM page: https://www.asam.net/standards/detail/mcd-1-xcp/
-
-## XCP in a nutshell
-- Connect/Session: The master establishes a connection, negotiates capabilities/features, and optionally unlocks protected functions via seed & key.
-- Addressing: Memory is accessed via absolute or segment‑relative addresses. Addressing modes are described in the associated A2L file (ASAM MCD‑2 MC), which maps symbolic names to addresses, data types, and conversion rules.
-- Events: The slave exposes events (e.g., “1 ms task”, “Combustion cycle”), which trigger DAQ sampling. The master assigns signals (ODTs) to these events for time‑aligned acquisition.
-- DAQ/STIM: DAQ = Data Acquisition (slave → master), STIM = Stimulation (master → slave). Both use event‑driven lists for deterministic timing.
-- Timestamps: DAQ may carry timestamps from the slave for precise time correlation.
-- Security: Access to sensitive commands (e.g., programming, calibration) can be protected by a seed & key algorithm negotiated at runtime.
-- Checksums: XCP defines checksum services useful for verifying memory regions (e.g., after flashing).
-
-## Relation to A2L (ASAM MCD‑2 MC)
-While XCP defines the protocol, the A2L file describes the measurement and calibration objects (characteristics, measurements), data types, conversion rules, and memory layout. In practice, you use pyXCP together with an A2L to:
-- Resolve symbolic names to addresses and data types.
-- Configure DAQ lists from human‑readable signal names.
-- Interpret raw values using the appropriate conversion methods.
-
-pyXCP provides utilities to fetch A2L data when supported by the slave and to work with A2L‑described objects.
-See also [pya2ldb](https://github.com/christoph2/pya2l)!
-
-## Transports and addressing
-XCP is transport‑agnostic. pyXCP supports multiple transports and addressing schemes:
-- CAN (XCP on CAN): Robust and ubiquitous in vehicles; limited payload and bandwidth; suited for many calibration tasks and moderate DAQ rates.
-- Ethernet (XCP on TCP/UDP): High bandwidth with low latency; well suited for rich DAQ and programming workflows.
-- USB: High throughput for lab setups; requires device support.
-- Serial/SxI: Simple point‑to‑point links for embedded targets and simulators.
-
-The exact capabilities (e.g., max CTO/DTO, checksum types, timestamping) are negotiated at connect time and depend on the slave and transport.
-
-## Supported features (overview)
-The scope of features depends on the connected slave. At the library level, pyXCP provides:
-- Session management: CONNECT/DISCONNECT, GET_STATUS/SLAVE_PROPERTIES, communication mode setup, error handling.
-- Memory access: Upload/short upload, Download/Download Next, verifications, optional paged memory where supported.
-- DAQ/STIM: Configuration of DAQ lists/ODTs, event assignment, data streaming, timestamp handling when available.
-- Programming helpers: Building blocks for program/erase/write flows (exact sequence per slave’s flash algorithm and A2L description).
-- Security/Seed & Key: Pluggable seed‑to‑key resolution including 32↔64‑bit bridge on Windows.
-- Utilities: Identifier scanning, A2L helpers, recorder and converters.
-
-Refer to docs/tutorial.md and docs/configuration.md for feature usage, and xcp-info for a capability dump of your target.
-
-## Compliance and versions
-pyXCP aims to be compatible with commonly used parts of ASAM MCD‑1 XCP. Specific optional features are enabled when a slave advertises them during CONNECT. Because implementations vary across vendors and ECU projects, always consult your A2L and use xcp-info to confirm negotiated options (e.g., checksum type, timestamp unit, max DTO size, address granularity).
-
-If you rely on a particular XCP feature/profile not mentioned here, please open an issue with details about your slave and A2L so we can clarify support and—if feasible—add coverage.
-
-## Safety, performance, and limitations
-- Safety‑critical systems: XCP is a development and testing protocol. Do not enable measurement/calibration on safety‑critical systems in the field unless your system‑level safety case covers it.
-- Performance: Achievable DAQ rates depend on transport bandwidth, ECU event rates, DTO sizes, and host processing. Ethernet typically yields the highest throughput.
-- Latency/jitter: Event scheduling in the slave and OS scheduling on the host can affect determinism. Use timestamps to correlate data precisely.
-- Access control: Seed & key protects sensitive functions; your organization’s policy should govern algorithm distribution and access.
-
-## Further resources
-- ASAM MCD‑1 XCP standard (overview and membership): https://www.asam.net/standards/detail/mcd-1-xcp/
-- ASAM MCD‑2 MC (A2L) for object descriptions: https://www.asam.net/standards/detail/mcd-2-mc/
-- Introduction to DAQ/STIM concepts (ASAM publications and vendor docs)
-- Related: CCP (legacy predecessor to XCP), ASAM MDF for measurement data storage
-