Oberfläche¶

uv run obd-diag-gui

Oben Port und Baudrate wählen (die Liste zeigt gefundene Adapter, ein Pfad lässt sich auch eintippen) und „Verbinden & Scannen“ drücken. Das liest in einem Durchgang Fehlercodes, Readiness, Freeze Frame, FIN und die Zähler für den Gebrauchtwagen-Check, nur lesend. Rechts oben steht dann das Fahrzeug (Hersteller und FIN), darunter sechs Reiter. Unten stehen Adapter, Protokoll und Bordspannung (rot bei niedriger Spannung).

Die Oberfläche spricht Deutsch und Englisch: Optionen → Sprache / Language (Sprache). Die Bilder auf dieser Seite stammen aus dem Emulator (tools/docs_screenshots.py) und folgen dem hellen oder dunklen Design dieser Website.

Fehlercodes¶

Links die Codes, gruppiert nach gespeichert, ausstehend und permanent; rechts die Erklärung des gewählten Codes mit Ursachen und ihrer Wahrscheinlichkeit, Symptomen und Kostenrahmen aus dem Offline-Katalog (Fehlercodes lesen und löschen). Ein Etikett je Code nennt die Dringlichkeit, die Detailansicht ihre Begründung. Fehlt ein Code im Katalog, öffnet „Im Web suchen“ eine Websuche im Browser; mit „Fehlercodes online erklären“ steht dort zusätzlich eine ungeprüfte Kurzerklärung (Fehlercodes online erklären).

Readiness¶

„Alle Tests abgeschlossen“ (grün) oder „Nicht alle Tests abgeschlossen“ (gelb) mit den offenen Tests, Motorkontrollleuchte, Motorart und jeder Monitor als abgeschlossen, nicht abgeschlossen oder nicht unterstützt. Das ist bewusst keine AU-Bewertung (Sitzungen, Bericht und Mitschnitt).

Freeze Frame¶

Der auslösende Code und die Messwerte beim Speichern des Codes: Motorlast, Kühlmitteltemperatur, Drehzahl, Geschwindigkeit.

Fahrzeug¶

FIN, Hersteller, Land, Modelljahr und Prüfziffer (FIN-Dekodierung). „FIN online nachschlagen (NHTSA)“ (Menü Optionen oder hier) ist standardmäßig aus; eingeschaltet geht beim nächsten Scan nur die FIN an die US-Behörde NHTSA.

Gebrauchtwagen¶

Ob die Fehlercodes vor kurzem gelöscht wurden: Urteil (auffällig, unauffällig, nicht beurteilbar) mit den Befunden und darunter die Zähler seit dem letzten Löschen (Gebrauchtwagen-Check). Der Punkt am Reiter ist orange bei einem Befund.

Live-Daten¶

Werte auswählen (die vom Fahrzeug unterstützten erscheinen nach dem ersten Start), Intervall 0,5, 1 oder 2 s, auf Wunsch „Aufzeichnen (CSV)“, dann Start. Je Wert eine Kachel mit aktuellem Wert, kleinstem und größtem gesehenen Wert und einer Kurve der letzten 120 Werte. „Warnschwellen …“ stellt Grenzen je Wert ein; wird eine überschritten, färbt sich die Kachel rot. Solange Live-Daten laufen, sind Scan, Löschen und Export gesperrt, denn am Adapter läuft immer nur eine Aktion (Live-Daten).

Menüs und Schaltflächen¶

Aktion	Kürzel	Was passiert
Sitzung speichern	Strg+S	Diagnose als JSON ablegen, Pfad wird angezeigt
Sitzung öffnen …	Strg+O	gespeicherte Sitzung nur ansehen; Löschen geht dann nicht
Mit Sitzung vergleichen …	–	angezeigte Diagnose mit einer gespeicherten vergleichen (Sitzungen, Bericht und Mitschnitt)
Bericht als PDF …	Strg+P	PDF-Bericht im Hintergrund schreiben
CSV exportieren …	–	eine Zeile pro Fehlercode
Optionen → Einrichtung prüfen …	–	Adapter, Zugriffsrechte und Baudrate prüfen; öffnet sich beim ersten Start von selbst (Installation)
Optionen → Fehlercodes online erklären	–	Codes ohne Katalogtext bekommen eine ungeprüfte Kurzerklärung (Fehlercodes online erklären)
Optionen → Adapter prüfen …	–	Version, Befehlssatz, Spannung und UDS-Eignung des Adapters, ohne das Fahrzeug (Adapter und Anschluss)
Optionen → Adapter-Mitschnitt aufzeichnen	–	jede Aktion schreibt einen Mitschnitt (Sitzungen, Bericht und Mitschnitt)
Optionen → Design	–	wie das System, hell oder dunkel
Optionen → Sprache / Language	–	Deutsch oder English, gilt sofort (Sprache)
Fehlercodes löschen …	–	derzeit gesperrt (grau, der Tooltip nennt den Grund)

Einstellungen werden je Nutzer unter ~/.config/obd-diag/obd-diag.conf gespeichert. Jede Aktion öffnet den Port, arbeitet in einem Hintergrund-Thread und schließt ihn wieder; die Oberfläche bleibt dabei bedienbar.

Gegen den Emulator ausprobieren¶

Ganz ohne Werkzeug geht es mit dem Demo-Fahrzeug (Port „demo“, Ohne Auto ausprobieren). Der Emulator kann dagegen beliebige Fehlercodes melden:

uv run python tools/emulator.py   # zeigt das pty an, z. B. /dev/pts/5
uv run obd-diag-gui               # /dev/pts/5 ins Port-Feld eintragen, verbinden