odxtools

What it is and what it does

odxtools is a Python library for working with ODX (Open Diagnostic data eXchange), an XML-based standard for describing the diagnostic capabilities of automotive electronic control units. It reads ODX/PDX files and provides a programmatic interface to encode diagnostic requests and decode responses, bridging the gap between the machine-readable ODX specification and Python code that interacts with vehicle ECUs over CAN, DoIP, or other automotive buses.

The package is designed for automotive developers, diagnostics engineers, and researchers who need to prototype diagnostic functionality, implement workshop servicing tools, or analyze diagnostic sessions. It handles the low-level details of message encoding/decoding according to the ODX specification, so you can work with diagnostic services at a higher level—calling methods like `ecu.services.session_start()` and receiving structured parameter dictionaries from decoded responses. It includes both a Python API and command-line tools for inspection and debugging of ODX databases.

Use it for:

• Prototype development: interact with vehicle ECU diagnostic services directly from Python by encoding/decoding CAN messages according to ODX specifications.
• End-of-production quality control: automate initial setup and self-diagnosis routines for newly manufactured vehicles.
• Workshop servicing: implement diagnostic test schedules and manufacturer-specific diagnostic routines for after-sales support.
• Diagnostic session analysis: parse and decode third-party diagnostic logs to understand what services were called and what parameters were exchanged.
• Code generation: use ODX metadata to generate diagnostic glue code for lower-level languages like C++ or Rust.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

odxtools parses and processes ODX (Open Diagnostic data eXchange) files to encode and decode diagnostic messages for automotive electronic control units, supporting CAN and other bus protocols.

Yes. odxtools is actively maintained, has no known vulnerabilities, installs with low friction, and is MIT-licensed. It fills a specific niche in automotive diagnostics—if you work with ODX files or need to encode/decode UDS diagnostic messages for vehicle ECUs, this is the right tool. If your work does not involve automotive diagnostics or ODX, it is not relevant.

Install

odxtools on PyPI

pip install odxtools

uv add odxtools

poetry add odxtools

Installing odxtools

Before you install

Low friction: pure Python wheel with no compiled dependencies. Active maintenance—last commit 2026-08-12, released 2026-07-29. Supports Python 3.10 through 3.14.

License in practice

MIT license (permissive). You can use, modify, and distribute odxtools freely in commercial and private projects with minimal restrictions.

Quickstart

import odxtools

db = odxtools.load_pdx_file("somersault.pdx")
ecu = db.ecus.somersault_lazy
raw_request = ecu.services.session_start()
print(f"Request: {raw_request.hex()}")

Requires Python 3.10 or later. ODX/PDX files must be available to load.

Verify before relying

• Whether the package's command-line tools (list, browse, snoop, find, decode, compare) are production-ready or aspirational.
• Performance characteristics when processing large or complex ODX databases.
• Whether non-strict mode is suitable for production use or intended only for development/debugging.

Package facts

Evidence: odxtools-11.4.2-py3-none-any.whl

Keywords: can, can bus, DoIP, odx, pdx, obd, uds, automotive, diagnostics

Tags

More Software Development packages