canmatrix 1.2__tar.gz → 1.3.2__tar.gz

canmatrix-1.3.2/MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE
+recursive-include tests *.py

canmatrix-1.3.2/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: canmatrix
+Version: 1.3.2
+Summary: Automotive Communication Matrix
+Author-email: Eduard Bröcker <eduard@gmx.de>
+Maintainer: canmatrix contributors
+License: BSD-2-Clause
+Project-URL: homepage, https://github.com/ebroecker/canmatrix
+Project-URL: documentation, https://canmatrix.readthedocs.io
+Project-URL: repository, https://github.com/ebroecker/canmatrix
+Keywords: CAN,canbus,dbc,arxml,kcd,dbf,sym,fibex,eds,automotive
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: Software Development :: Embedded Systems :: Controller Area Network (CAN)
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs>=19.2.0
+Requires-Dist: click
+Requires-Dist: importlib-metadata; python_version < "3.8"
+Requires-Dist: typing; python_version < "3.5"
+Provides-Extra: arxml
+Requires-Dist: lxml; extra == "arxml"
+Provides-Extra: csv
+Provides-Extra: dbc
+Provides-Extra: dbf
+Provides-Extra: fibex
+Requires-Dist: lxml; extra == "fibex"
+Provides-Extra: json
+Provides-Extra: kcd
+Requires-Dist: lxml; extra == "kcd"
+Provides-Extra: ldf
+Requires-Dist: ldfparser; extra == "ldf"
+Provides-Extra: odx
+Requires-Dist: lxml; extra == "odx"
+Provides-Extra: scapy
+Provides-Extra: sym
+Provides-Extra: test
+Requires-Dist: pathlib2; python_version < "3.4" and extra == "test"
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: wireshark
+Provides-Extra: xls
+Requires-Dist: xlrd==1.2.0; extra == "xls"
+Requires-Dist: xlwt; extra == "xls"
+Provides-Extra: xlsx
+Requires-Dist: openpyxl; extra == "xlsx"
+Provides-Extra: yaml
+Requires-Dist: pyyaml; extra == "yaml"
+Provides-Extra: eds
+Requires-Dist: canopen; extra == "eds"
+Dynamic: license-file
+
+## Canmatrix is a python package to read and write several CAN (Controller Area Network) database formats.
+
+[![PyPI](https://img.shields.io/pypi/v/canmatrix.svg)](https://pypi.org/project/canmatrix/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/canmatrix.svg)](https://pypi.org/project/canmatrix/)
+[![Coverall](https://coveralls.io/repos/github/ebroecker/canmatrix/badge.svg?branch=development)](https://coveralls.io/github/ebroecker/canmatrix?branch=development)
+[![GitHub issues](https://img.shields.io/github/issues-raw/ebroecker/canmatrix.svg)](https://github.com/ebroecker/canmatrix/issues)
+
+
+## About
+
+***Canmatrix*** implements a "Python Can Matrix Object" which describes the can-communication and the needed objects (Boardunits, Frames, Signals, Values, ...)
+***Canmatrix*** also includes two **Tools** (canconvert and cancompare) for converting and comparing **CAN** databases.
+
+- Multiple formats automotive related communication matrix file parsing.
+- CAN message encoding and decoding.
+
+**Supported file formats for import:**
+
+    .dbc candb / Vector
+    .dbf Busmaster (open source!)
+    .kcd kayak (open source!)
+    .arxml autosar system description
+    .yaml structured export/import (same structure as json)
+    .xls(x) excel xls-import, works with .xls-file generated by this lib
+    .sym peak pcan can description
+    .xml (fibex or CANopen eds)
+    .ldf (lin bus) 
+    .odx (diagnostic file)
+    .eds
+
+**Supported file formats for export:**
+
+    .dbc
+    .dbf
+    .kcd
+    .xls(x)
+    .json Canard (open source!)
+    .arxml (very basic implementation)
+    .yaml structured export/import (same structure as json)
+    .sym
+    .xml (fibex)
+    .lua (wireshark script)
+    .scapy 
+
+Project Homepage: https://github.com/ebroecker/canmatrix
+
+Documentation: https://canmatrix.readthedocs.io
+
+
+## Installation
+
+https://canmatrix.readthedocs.io/en/latest/installation.html
+
+[Chinese Translation / 安装中文方法解释及注意事项](https://github.com/ebroecker/canmatrix/wiki/%E5%AE%89%E8%A3%85%E4%B8%AD%E6%96%87%E6%96%B9%E6%B3%95%E8%A7%A3%E9%87%8A%E5%8F%8A%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9)
+
+
+## Contributing
+
+Source Code, Documentation, Examples, Report issues and Any other contributions are **extremely appreciated**.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request

canmatrix-1.3.2/README.md

@@ -0,0 +1,65 @@
+## Canmatrix is a python package to read and write several CAN (Controller Area Network) database formats.
+
+[![PyPI](https://img.shields.io/pypi/v/canmatrix.svg)](https://pypi.org/project/canmatrix/)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/canmatrix.svg)](https://pypi.org/project/canmatrix/)
+[![Coverall](https://coveralls.io/repos/github/ebroecker/canmatrix/badge.svg?branch=development)](https://coveralls.io/github/ebroecker/canmatrix?branch=development)
+[![GitHub issues](https://img.shields.io/github/issues-raw/ebroecker/canmatrix.svg)](https://github.com/ebroecker/canmatrix/issues)
+
+
+## About
+
+***Canmatrix*** implements a "Python Can Matrix Object" which describes the can-communication and the needed objects (Boardunits, Frames, Signals, Values, ...)
+***Canmatrix*** also includes two **Tools** (canconvert and cancompare) for converting and comparing **CAN** databases.
+
+- Multiple formats automotive related communication matrix file parsing.
+- CAN message encoding and decoding.
+
+**Supported file formats for import:**
+
+    .dbc candb / Vector
+    .dbf Busmaster (open source!)
+    .kcd kayak (open source!)
+    .arxml autosar system description
+    .yaml structured export/import (same structure as json)
+    .xls(x) excel xls-import, works with .xls-file generated by this lib
+    .sym peak pcan can description
+    .xml (fibex or CANopen eds)
+    .ldf (lin bus) 
+    .odx (diagnostic file)
+    .eds
+
+**Supported file formats for export:**
+
+    .dbc
+    .dbf
+    .kcd
+    .xls(x)
+    .json Canard (open source!)
+    .arxml (very basic implementation)
+    .yaml structured export/import (same structure as json)
+    .sym
+    .xml (fibex)
+    .lua (wireshark script)
+    .scapy 
+
+Project Homepage: https://github.com/ebroecker/canmatrix
+
+Documentation: https://canmatrix.readthedocs.io
+
+
+## Installation
+
+https://canmatrix.readthedocs.io/en/latest/installation.html
+
+[Chinese Translation / 安装中文方法解释及注意事项](https://github.com/ebroecker/canmatrix/wiki/%E5%AE%89%E8%A3%85%E4%B8%AD%E6%96%87%E6%96%B9%E6%B3%95%E8%A7%A3%E9%87%8A%E5%8F%8A%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9)
+
+
+## Contributing
+
+Source Code, Documentation, Examples, Report issues and Any other contributions are **extremely appreciated**.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request

canmatrix-1.3.2/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["setuptools >= 40.8.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "canmatrix"
+description = "Automotive Communication Matrix"
+readme = "README.md"
+license = { text = "BSD-2-Clause" }
+dynamic = ["version"]
+authors = [{ name="Eduard Bröcker", email = "eduard@gmx.de" }]
+maintainers = [{ name = "canmatrix contributors" }]
+dependencies = [
+    "attrs>=19.2.0",
+    "click",
+    "importlib-metadata; python_version < '3.8'",
+    "typing; python_version < '3.5'",
+]
+requires-python = ">=3.8"
+keywords = [
+    "CAN",
+    "canbus",
+    "dbc",
+    "arxml",
+    "kcd",
+    "dbf",
+    "sym",
+    "fibex",
+    "eds",
+    "automotive",
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Manufacturing",
+    "Intended Audience :: Telecommunications Industry",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Embedded Systems :: Controller Area Network (CAN)",
+    "Topic :: System :: Networking",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+cancompare = "canmatrix.cli.compare:cli_compare"
+canconvert = "canmatrix.cli.convert:cli_convert"
+
+[project.urls]
+homepage = "https://github.com/ebroecker/canmatrix"
+documentation = "https://canmatrix.readthedocs.io"
+repository = "https://github.com/ebroecker/canmatrix"
+
+[project.optional-dependencies]
+arxml = ["lxml"]
+csv = []
+dbc = []
+dbf = []
+fibex = ["lxml"]
+json = []
+kcd = ["lxml"]
+ldf = ["ldfparser"]
+odx = ["lxml"]
+scapy = []
+sym = []
+test = ["pathlib2; python_version < '3.4'", "pytest"]
+wireshark = []
+xls = ["xlrd==1.2.0", "xlwt"]
+xlsx = ["openpyxl"]
+yaml = ["pyyaml"]
+eds = ["canopen"]
+
+[tool.setuptools.dynamic]
+version = {attr = "canmatrix.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+canmatrix = ["j1939.dbc", "py.typed"]

canmatrix-1.3.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

canmatrix-1.3.2/src/canmatrix/ArbitrationId.py

@@ -0,0 +1,255 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) 2013, Eduard Broecker
+# With contributions 2025, Gabriele Omodeo Vanone
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that
+# the following conditions are met:
+#
+#    Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+#    Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,   PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR  OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+import attr
+import warnings
+import typing
+from canmatrix.exceptions import ArbitrationIdOutOfRange, J1939NeedsExtendedIdentifier
+
+
+def _check_range(name, value, mask):  # type: (str, int, int) -> None
+    if value != value & mask:
+        raise ValueError(
+            "{name} {value} out of range (0-{maximum})".format(
+                name=name, value=value, maximum=mask)
+        )
+
+
+@attr.s
+class ArbitrationId(object):
+    standard_id_mask = ((1 << 11) - 1)
+    extended_id_mask = ((1 << 29) - 1)
+    compound_extended_mask = (1 << 31)
+
+    id = attr.ib(default=None)
+    extended = attr.ib(default=False)  # type: bool
+
+    def __attrs_post_init__(self):
+        if self.extended is None:
+            # Mimicking old behaviour for now -- remove in the future
+            self.extended = True
+            warnings.warn(
+                "Please set 'extended' attribute as a boolean instead of "
+                "None when creating an instance of ArbitrationId class",
+                DeprecationWarning
+            )
+        if self.extended:
+            mask = self.extended_id_mask
+        else:
+            mask = self.standard_id_mask
+
+        if self.id != self.id & mask:
+            raise ArbitrationIdOutOfRange('ID out of range')
+
+    @property
+    def j1939_pgn(self):
+        return self.pgn
+
+    @property
+    def pgn(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        # PGN is bits 8-25 of the 29-Bit Extended CAN-ID
+        # Made up of PDU-S (8-15), PDU-F (16-23), Data Page (24) & Extended Data Page (25)
+        # If PDU-F >= 240 the PDU-S is interpreted as Group Extension
+        # If PDU-F < 240 the PDU-S is interpreted as a Destination Address
+        _pgn = 0
+        if self.j1939_pdu_format == 2:
+            _pgn += self.j1939_ps
+        _pgn += self.j1939_pf << 8
+        _pgn += self.j1939_dp << 16
+        _pgn += self.j1939_edp << 17
+
+        return _pgn
+
+    @pgn.setter
+    def pgn(self, value):  # type: (int) -> None
+        self.extended = True
+        _pgn = value & 0x3FFFF
+        self.id &= 0xfc0000ff
+        self.id |= (_pgn << 8 & 0x3FFFF00)  # default pgn is None -> mypy reports error
+
+    @property
+    def j1939_tuple(self):  # type: () -> typing.Tuple[int, int, int]
+        """Get tuple (destination, PGN, source)
+
+        :rtype: tuple"""
+
+        return self.j1939_destination, self.pgn, self.j1939_source
+
+    @property
+    def j1939_destination(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        if self.j1939_pdu_format == 1:
+            destination = self.j1939_ps
+        else:
+            destination = None
+        return destination
+
+    @property
+    def j1939_source(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return self.id & 0xFF
+
+    @j1939_source.setter
+    def j1939_source(self, value):  # type: (int) -> None
+        self.extended = True
+        self.id = (self.id & 0xffffff00) | (value & 0xff)
+
+    @property
+    def j1939_ps(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return (self.id >> 8) & 0xFF
+
+    @property
+    def j1939_pf(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return (self.id >> 16) & 0xFF
+
+    @property
+    def j1939_pdu_format(self):
+        return 1 if (self.j1939_pf < 240) else 2
+
+    @property
+    def j1939_dp(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return (self.id >> 24) & 0x1
+
+    @property
+    def j1939_edp(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return (self.id >> 25) & 0x1
+
+    @property
+    def j1939_priority(self):
+        if not self.extended:
+            raise J1939NeedsExtendedIdentifier
+        return (self.id >> 26) & 0x7
+
+    @j1939_priority.setter
+    def j1939_priority(self, value):  # type: (int) -> None
+        self.extended = True
+        self.id = (self.id & 0x3ffffff) | ((value & 0x7) << 26)
+
+    @property
+    def j1939_str(self):  # type: () -> str
+        return "DA:0x{da:02X} PGN:0x{pgn:04X} SA:0x{sa:02X}".format(
+            da=self.j1939_destination, pgn=self.pgn, sa=self.j1939_source)
+
+
+    @classmethod
+    def from_compound_integer(cls, i):  # type: (typing.Any) -> ArbitrationId
+        return cls(
+            id=i & cls.extended_id_mask,
+            extended=(i & cls.compound_extended_mask) != 0,
+        )
+
+    @classmethod
+    def from_pgn(cls, pgn):  # type: (int) -> ArbitrationId
+        return cls(
+            id = (pgn << 8), extended = True
+        )
+
+    @classmethod
+    def from_j1939_fields(cls, pdu_format, pdu_specific, priority=0, edp=0, dp=0,
+                          source_address=0):
+        # type: (int, int, int, int, int, int) -> ArbitrationId
+        """Build an extended ArbitrationId from the individual J1939 bit fields.
+
+        :param pdu_format: PDU Format (PF), 8 bits (0-255)
+        :param pdu_specific: PDU Specific (PS), 8 bits (0-255) -- destination
+            address (PF < 240) or group extension (PF >= 240)
+        :param priority: message priority, 3 bits (0-7)
+        :param edp: Extended Data Page, 1 bit (0-1)
+        :param dp: Data Page, 1 bit (0-1)
+        :param source_address: source address (SA), 8 bits (0-255)
+        :rtype: ArbitrationId
+        """
+        _check_range("priority", priority, 0x7)
+        _check_range("edp", edp, 0x1)
+        _check_range("dp", dp, 0x1)
+        _check_range("pdu_format", pdu_format, 0xFF)
+        _check_range("pdu_specific", pdu_specific, 0xFF)
+        _check_range("source_address", source_address, 0xFF)
+        _id = (
+            (priority << 26)
+            | (edp << 25)
+            | (dp << 24)
+            | (pdu_format << 16)
+            | (pdu_specific << 8)
+            | source_address
+        )
+        return cls(id=_id, extended=True)
+
+    @classmethod
+    def from_pgn_fields(cls, pgn, priority=0, source_address=0, destination=None):
+        # type: (int, int, int, typing.Optional[int]) -> ArbitrationId
+        """Build an extended ArbitrationId from a PGN plus its surrounding fields.
+
+        :param pgn: Parameter Group Number, 18 bits (0-0x3FFFF)
+        :param priority: message priority, 3 bits (0-7)
+        :param source_address: source address (SA), 8 bits (0-255)
+        :param destination: destination address, 8 bits (0-255). Only valid for
+            PDU1 messages (PDU format < 240); raises ValueError otherwise.
+        :rtype: ArbitrationId
+        """
+        _check_range("pgn", pgn, 0x3FFFF)
+        _check_range("priority", priority, 0x7)
+        _check_range("source_address", source_address, 0xFF)
+        _id = (pgn << 8) | (priority << 26) | source_address
+        if destination is not None:
+            _check_range("destination", destination, 0xFF)
+            pdu_format = (_id >> 16) & 0xFF
+            if pdu_format >= 240:
+                raise ValueError(
+                    "destination is only valid for PDU1 messages "
+                    "(PDU format < 240)"
+                )
+            _id |= destination << 8
+        return cls(id=_id, extended=True)
+
+    def to_compound_integer(self):
+        if self.extended:
+            return self.id | self.compound_extended_mask
+        else:
+            return self.id
+
+    def __eq__(self, other):
+        return (
+            self.id == other.id
+            and (
+                self.extended is None
+                or other.extended is None
+                or self.extended == other.extended
+            )
+        )

canmatrix-1.3.2/src/canmatrix/AutosarE2EProperties.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) 2013, Eduard Broecker
+# With contributions 2025, Gabriele Omodeo Vanone
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that
+# the following conditions are met:
+#
+#    Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+#    Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,   PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR  OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+import typing
+import attr
+
+@attr.s(eq=False)
+class AutosarE2EProperties(object):
+    profile = attr.ib(default=None)  # type: str
+    data_id_mode = attr.ib(default=None)  # type: str
+    data_ids = attr.ib(default=None) # type: list[int]
+    data_length = attr.ib(default=None)  # type: int

canmatrix-1.3.2/src/canmatrix/AutosarSecOCProperties.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) 2013, Eduard Broecker
+# With contributions 2025, Gabriele Omodeo Vanone
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that
+# the following conditions are met:
+#
+#    Redistributions of source code must retain the above copyright notice,
+#    this list of conditions and the following disclaimer.
+#    Redistributions in binary form must reproduce the above copyright notice,
+#    this list of conditions and the following disclaimer in the documentation
+#    and/or other materials provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,   PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR  OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+import typing
+import attr
+
+@attr.s(eq=False)
+class AutosarSecOCProperties(object):
+    secured_i_pdu_name = attr.ib(default="unknown")  # type: str
+    authentic_i_pdu_name = attr.ib(default="unknown")  # type: str
+    auth_algorithm = attr.ib(default=None)  # type: str|None
+    authentic_pdu_length = attr.ib(default=0)  # type: int
+    secured_i_pdu_length = attr.ib(default=0)  # type: int
+    auth_tx_length = attr.ib(default=None)  # type: int|None
+    data_id = attr.ib(default=None)  # type: int|None
+    freshness_value_id = attr.ib(default=None)  # type: int|None
+    freshness_length = attr.ib(default=None)  # type: int|None
+    freshness_tx_length = attr.ib(default=None)  # type: int|None
+    use_as_cryptographic_i_pdu = attr.ib(default=False)  # type: bool
+    message_link_length = attr.ib(default=None)  # type: int|None
+    message_link_position = attr.ib(default=None)  # type: int|None
+    key_id = attr.ib(default=None)  # type: int|None