Skip to content

openw3rk-DEVELOP/o3DIAG

Repository files navigation

o3DIAG – OBD-II Diagnostic Tool

! Version 3.2.1 for Debian is also available in the "linux-only" branch !


o3DIAG is a diagnostic application designed to work with OBD-II vehicles through an ELM327 adapter. It provides an easy way to connect, read vehicle data, and interpret diagnostic trouble codes (DTCs).

Web:
https://o3diag.openw3rk.de / https://openw3rk.de
o3DIAG Development Tool:
https://github.com/openw3rk-DEVELOP/o3DIAG_E-EE
For Feedback:
develop@openw3rk.de

Main Features

Connection Control

– Select communication port and baud rate.
– Connect or disconnect the adapter with a single click.
– Initialize the adapter automatically with the required AT commands.

Live Data Reading

– Read common engine parameters such as:
  • Engine RPM (PID 010C)
  • Vehicle Speed (PID 010D)
  • Coolant Temperature (PID 0105)
  • Engine Load (PID 0104)
– Raw responses are automatically converted into real-world values (e.g., RPM in revolutions per minute,
temperature in °C, speed in km/h).

Diagnostic Trouble Codes (DTCs)

– Read stored error codes from the engine control unit.
– Clear fault codes when required.
– Codes are translated into plain-text descriptions for easier understanding.

P-Code Translation

– The program can look up diagnostic codes (P0000–P0999 and beyond) from an integrated o3script-based list.
– Instead of showing just the raw code, the program displays the human-readable meaning of each fault.

User Interface

– Scrollable log window that shows all communication with the adapter.
– Each entry is timestamped for clarity (at Beta 1.5).
– Clear log function, with an automatic program banner shown again for orientation.
– Info/Warning section with program details and disclaimers.

Summary

With o3DIAG, users can quickly access essential vehicle information, monitor live sensor data, and interpret engine fault codes in a clear and user-friendly interface. It is a practical tool for basic diagnostics and understanding of OBD-II data.

Compile

Compiling o3DIAG is simple, using the following command (for Beta 2.5 or earlier):

pyinstaller --onefile --windowed --icon=o3DIAG_ico.ico --add-data "o3DIAG_logo.png;." --add-data "THE_PCODES_LIST.o3script;." o3DIAG_VERSION.py

Appropriate parameters such as "o3DIAG version" and the ".o3script" file for the P-codes list must be adjusted.


Logo

Copyright (c) openw3rk INVENT