How nada-ben-ali/odxtools works
odxtools is a Python library and CLI for loading automotive ECU diagnostic descriptions in ODX/PDX form, exposing their services, and encoding or decoding diagnostic messages. The main workflow is load a database, resolve its diagnostic layers and services, then encode requests or decode requests and responses. Separate CLI capabilities support listing, browsing, finding, snooping, and comparing data. The graph reflects README workflows and source-index references; several CLI and domain subsystems are represented by their exact tree paths but were not sampled in source, so their internal wiring is omitted.
Main entry points: diaglayer.py Diagnostic layers · diagservice.py Diagnostic services · database.py ODX database · parameter.py Parameters
Components 24
Database loading
- File loader
odxtools/loadfile.py - ODX database
odxtools/database.py - ODX references
odxtools/odxlink.py
ODX diagnostic model
- Diagnostic layers
odxtools/diaglayers/diaglayer.py - Diagnostic services
odxtools/diagservice.py - Diagnostic communications
odxtools/diagcomm.py - Requests
odxtools/request.py - Responses
odxtools/response.py - ECU jobs
odxtools/singleecujob.py - Diagnostic state charts
odxtools/statechart.py
Message encoding
- Parameters
odxtools/parameters/parameter.py - Encode state
odxtools/encodestate.py - Decode state
odxtools/decodestate.py - Value conversions
odxtools/compumethods/compumethod.py - Validation errors
odxtools/exceptions.py
CLI exploration
- CLI dispatcher
odxtools/cli/main.py - Browse database
odxtools/cli/browse.py - Compare databases
odxtools/cli/compare.py - List services
odxtools/cli/list.py - Find services
odxtools/cli/find.py - Snoop traffic
odxtools/cli/snoop.py - Decode messages
odxtools/cli/decode.py
Other components
- Python user
- CLI user
Connections 25
- Python user → File loader: loads file
README.md - File loader → ODX database: builds database
- ODX database → Diagnostic layers: contains layers
odxtools/database.py - Diagnostic layers → ODX references: resolves references
odxtools/diaglayers/diaglayer.py - Diagnostic layers → Diagnostic services: provides services
odxtools/diaglayers/diaglayer.py - Diagnostic services → Requests: uses request
odxtools/diagservice.py - Diagnostic services → Responses: resolves responses
odxtools/diagservice.py - Diagnostic layers → Diagnostic communications: collects communications
odxtools/diaglayers/diaglayer.py - Python user → Diagnostic services: encodes request
README.md - Diagnostic services → Parameters: encodes parameters
odxtools/diagservice.py - Parameters → Encode state: updates state
odxtools/parameters/parameter.py - Parameters → Decode state: decodes values
odxtools/parameters/parameter.py - Parameters → Value conversions: converts values
- Python user → Diagnostic layers: decodes message
README.md - Python user → Responses: decodes response
README.md - CLI user → CLI dispatcher: runs commands
README.md - CLI dispatcher → Browse database: dispatches browse
- CLI dispatcher → Compare databases: dispatches compare
odxtools/cli/main.py - CLI user → List services: lists services
README.md - CLI user → Find services: finds services
README.md - CLI user → Snoop traffic: snoops traffic
README.md - CLI user → Decode messages: decodes messages
README.md - CLI dispatcher → ODX database: loads database
odxtools/cli/main.py - Browse database → ODX database: browses contents
odxtools/cli/browse.py - Compare databases → ODX database: compares contents
odxtools/cli/compare.py