Metadata-Version: 2.3
Name: asamint
Version: 0.1.5
Summary: Integration package for ASAM related projects
License: GPLv2
Keywords: automotive,ecu,xcp,asam,autosar
Author: Christoph Schueler
Author-email: cpu12.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.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Requires-Dist: antlr4-python3-runtime (>=4.13.2,<5.0.0)
Requires-Dist: antlr4-tools (>=0.2.1,<0.3.0)
Requires-Dist: asammdf (>=8.0.1,<9.0.0)
Requires-Dist: babel (>=2.16.0,<3.0.0)
Requires-Dist: cmd2 (>=2.5.7,<3.0.0)
Requires-Dist: lxml (>=5.3.0,<6.0.0)
Requires-Dist: numexpr (>=2.10.2,<3.0.0)
Requires-Dist: objutils (>=0.6.0,<0.7.0)
Requires-Dist: pya2ldb (>=0.14.5,<0.15.0)
Requires-Dist: pyreadline (>=2.1,<3.0)
Requires-Dist: pyreadline3 (>=3.5.4,<4.0.0)
Requires-Dist: pyxcp (>=0.22.9,<0.23.0)
Requires-Dist: rich (>=13.9.2,<14.0.0)
Requires-Dist: sortedcontainers (>=2.4.0,<3.0.0)
Requires-Dist: traitlets (>=5.11.2,<6.0.0)
Project-URL: Homepage, https://github.com/christoph2/asamint
Project-URL: Repository, https://github.com/christoph2/asamint
Description-Content-Type: text/x-rst

========================
ASAM Integration Package
========================

.. image:: http://img.shields.io/badge/license-GPL-blue.svg
   :target: http://opensource.org/licenses/GPL-2.0

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black



**asamint** (ASAM integration package) integrates several automotive related opensource projects.

The projects in question projects are mainly following an mechanism-not-policy approach, but **asamint** aims to
add higher level APIs, that could be used to implement common measurement and calibration tasks.

To put it into another words, **asamint** will be a command-line MCS (measurement and calibration system).

The aggregated Python projects in alphabetical order:

======================================================   =============
Project / repository                                     pip/PyPI name
======================================================   =============
`asammdf <https://github.com/danielhrisca/asammdf>`_     asammdf
`objutils <https://github.com/christoph2/objutils>`_     objutils
`pya2ldb <https://github.com/christoph2/pya2l>`_         pya2ldb
`pyxcp <https://github.com/christoph2/pyxcp>`_           pyxcp
======================================================   =============



And yes, all listed projects are `Raspberry PI <https://raspberrypi.org>`_ tested :smile:

Installation
------------

clone / fork / download from `here. <https://github.com/christoph2/asamint>`_

Then run

.. code-block:: python

   python setup.py develop

Dependencies
~~~~~~~~~~~~
**asamint** currently doesn't specify dependencies on its own -- installing the above listed projects should be sufficient.

License
-------
**asamint** is released under `GPLv2 license terms <../LICENSE>`_.


Features
--------

 Note: At this stage, the project is highly experimental and hacky, so don't expect stable APIs and tons of features!

Functions are basically orchestrated using ASAM MCD-2MC (A2L) files.

Some examples include (not necessarily in a working condition yet):

* Create calibration data files (ASAM CDF) from XCP slaves or HEX files.

* Setup dynamic DAQs.

* High-level API to create MDF files.


Please refer to `examples <../asamint/examples>`_ directory.


Further Readings
----------------

`Here's <further_readings.rst>`_ a collection of some public accessible documents, if you want to dig deeper into the wonderworld of automotive measurement and calibration.


Miscellaneous
-------------

**asamint** includes some more or less useful `tools <../tools/README.rst>`_.

