Metadata-Version: 2.1
Name: logging-dlt
Version: 1.0.0
Summary: A python logging adapter for diagnostic log and trace protocol.
Author-email: Patrick Menschel <menschel.p@posteo.de>
Project-URL: Homepage, https://gitlab.com/menschel/logging-dlt
Project-URL: Bug Tracker, https://gitlab.com/menschel/logging-dlt/issues
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: License :: Free for non-commercial use
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE

# logging-dlt

![coverage](https://gitlab.com/Menschel/logging-dlt/badges/master/coverage.svg)
![pipeline](https://gitlab.com/Menschel/logging-dlt/badges/master/pipeline.svg)

[Documentation](https://menschel.gitlab.io/logging-dlt/)

[DLT Autosar Specification](https://www.autosar.org/fileadmin/user_upload/standards/classic/4-3/AUTOSAR_SWS_DiagnosticLogAndTrace.pdf)

A python logging adapter for "diagnostic log and trace" protocol.

# Description

The goal of this project is to provide a way to route the proprietary dlt
protocol into the python logging framework. This is done by using a logging adapter
together with a dlt stream parser.


# DLT protocol
DLT (Diagnostic Log and Trace) is a proprietary logging protocol.
It is used in debugging automotive ECUs that run Autosar OS.

You should NOT use it if you have the choice!

It has many traps, inconsistencies and architecture dependencies.
In the field it does overflow its own stream buffer, corrupting data on the wire.
It causes endianess problems, e.g. use big endian even if it announced little endian
a few bytes before (
[Proof 1](https://github.com/COVESA/dlt-daemon/blob/master/src/shared/dlt_common.c#L1034),
[2](https://github.com/COVESA/dlt-daemon/blob/master/src/shared/dlt_common.c#L846)
) etc.

It is clear that it did not compete against any other logging mechanism or had any trial phase.
It was just forged into a standard that is enforced for the Autosar OS.


# License
This software is distributed under GPLv3 with some extension because GPLv3 did not manage to deny
criminal misuse by organizations.
This software is intended for usage by community and private individuals who are interested in car hacking.
It is explicitly denied that any company or organization monetizes on this software. Monetize does not only mean money,
it means gaining a competitive advantage of any kind by using this software.
The author explicitly denies the usage for people associated with military,
government agencies of any kind to whatever degree, same for car manufacturers and associates.
