obd-diag 0.2.0

Erstes veröffentlichtes Release. Es umfasst den Funktionsumfang v0.1 (nie einzeln
veröffentlicht) und die Live-Daten aus v0.2.

Am echten Auto geprüft

• Erster Test am 2026-10-09 an einem Mercedes A 180 d (W177) mit FORScan ELMconfig
  (USB, CH340), CAN 29 Bit/500 kBit/s, vier Steuergeräte: info, diagnose und live
  lesen richtig.
• Vier Befunde aus dem Test behoben (#7): Freeze Frame vom Steuergerät mit dem Code
  (vorher „unbekannter Code“), erstes ATZ mit ? wird einmal wiederholt, Bordspannung
  per PID 42 gegengeprüft, wenn der Adapter unter 11,8 V misst, bei Mercedes kein
  Modelljahr aus FIN-Stelle 10.
• UNABLE TO CONNECT (Zündung aus) ergibt eine klare Meldung mit Hinweis (#8).
• Zweiter Test am 2026-10-10 mit Motorstart während Live: Werte stimmen Byte für Byte.
  Bei Drosselung wegen niedriger Spannung wird die Spannung jetzt jede Runde gemessen,
  damit die Drosselung nach dem Anlassen gleich endet statt erst nach zehn Runden.
• Zweiter Test am 2026-10-10 bestätigt diese Korrekturen; Diagnose- und Live-Mitschnitte
  stimmen Byte für Byte mit J1979.
• Readiness hängt nicht mehr von der Reihenfolge ab, in der die Steuergeräte antworten.
  Vorher konnte ein Steuergerät ohne Abgasmonitore den Diesel als Ottomotor ausgeben und
  „Alle Tests abgeschlossen“ melden, obwohl der Abgassensor-Test offen war (#14).
  Widersprüchliche Freeze-Frame-Werte mehrerer Steuergeräte werden verworfen.
• Live-Daten: Nach dem Anlassen endet die Drosselung bei niedriger Spannung sofort,
  statt bis zu 50 s weiterzulaufen (#15).
• Die Mitschnitte beider Tests laufen als Regressionstest
  (tests/verification/test_real_car.py, FIN-Seriennummer geschwärzt).
• Zweiter Test am 2026-10-10 (Motor aus und im Stand laufend) bestätigt diese Korrekturen
  und deckt einen Fehler auf: Ohne Header kommen die Antworten der Steuergeräte bei jeder
  Anfrage anders sortiert, und die Motorart der Readiness kam vom zuerst antwortenden.
  Stand ein Steuergerät ohne Abgasmonitore vorn, wurde der Diesel als Ottomotor gelesen,
  der offene Test „Abgassensor“ fehlte und es hieß „Alle Tests abgeschlossen“. Jetzt
  entscheiden die Steuergeräte mit Abgasmonitoren, unabhängig von der Reihenfolge.
  Freeze-Frame-Werte, die mehrere Steuergeräte verschieden melden, werden verworfen statt
  zufällig gewählt.

Lesen

• Fehlercodes: gespeichert, ausstehend und permanent (Mode 03, 07, 0A) mit deutschem
  Klartext, Ursachen und Symptomen aus einem Offline-Katalog (OBDex, CC0, 9533 Codes).
• Ablehnungen der Steuergeräte werden nicht mehr als „keine Codes“ gelesen; nur
  7F <Mode> 11/12 heißt „Mode nicht unterstützt“. Auf 7F <Mode> 78 wird bis 5 s
  gewartet (#4).
• Readiness (Mode 01 PID 01, Otto und Diesel) mit Motorkontrollleuchte; Urteil „Alle
  Tests abgeschlossen“.
• Freeze Frame zum auslösenden Code (Mode 02).
• FIN (Mode 09 PID 02) mit Offline-Dekodierung (Hersteller, Land, Modelljahr ohne
  Gewähr), optional NHTSA vPIC (Opt-in).
• Fehlercodes ohne Katalogtext auf Wunsch online erklären (--online-codes, Option in
  der Oberfläche, standardmäßig aus; Quelle Wal33D/dtc-database, MIT). Es werden ganze
  Dateien geladen, Fehlercode und FIN gehen nie ins Netz (#11, ADR 0004).

Live-Daten (v0.2)

• 116 Werte aus 82 Mode-01-PIDs nach SAE J1979, darunter die Lambdasonden 1–8,
  Nachkat-Trimm und Drehmomentstufen; jede Formel ist gegen python-OBD verglichen.
• obd-diag live (--list, --pids, --interval, --duration, --record) und Reiter
  „Live-Daten“ mit Kacheln und Verlaufskurve; Aufzeichnung als CSV.
• Unter 11,8 V Bordspannung wird nur alle 5 s abgefragt.

Sicherheit

• Nur lesend: Freigabeliste in Elm327.command, jeder andere Befehl wird abgewiesen,
  bevor etwas gesendet wird. Jeder erlaubte Befehl ist mit Seite und Zitat aus dem
  ELM327-Datenblatt bzw. dem J1979-Service belegt und wird in allen Tests geprüft (#3).
• Mindestens 50 ms zwischen zwei Anfragen ans Fahrzeug, auch nach Fehlern (#6).
• Löschen (Mode 04) ist gesperrt (CLEAR_ENABLED = False). Der Ablauf mit
  Vorbedingungen (Motor aus bei allen Steuergeräten, Spannung), Sicherung und
  Kontroll-Scan ist fertig und getestet, wird aber erst nach einer bewussten Freigabe
  eingeschaltet.
• Abgezogener Adapter (auch zwischen zwei Befehlen) bricht mit Meldung ab, ohne halbe
  Sitzungen zu speichern.

Bedienung und Ausgabe

• Kommandozeile obd-diag mit info, scan, diagnose, vin, clear, live,
  ports, export; Adapter-Mitschnitt mit --trace.
• Oberfläche obd-diag-gui (PySide6/QML, Extra gui) mit Reitern Fehlercodes,
  Readiness, Freeze Frame, Fahrzeug, Live-Daten; helles und dunkles Design.
• Diagnosesitzungen als JSON, PDF-Bericht und CSV.

Dokumentation

• Website unter https://phprell.github.io/obd-diag/ (#5, #9, #12): Benutzen, wie das
  Tool mit dem ELM327 spricht (Befehlsreferenz mit Datenblatt-Seiten, PID-Formeln,
  Sicherheitskonzept, der Mitschnitt vom W177 Zeile für Zeile), Entwickeln.

Bekannte Einschränkungen

• Bisher an einem Fahrzeug geprüft (zwei Tests am Mercedes W177).
• Live-Daten nehmen ohne Header die erste gültige Antwort; antworten mehrere
  Steuergeräte auf dieselbe PID, kann der Wert zwischen ihnen wechseln (am W177
  höchstens 11 1/min).
• Nur über USB-Seriell bzw. /dev/rfcomm*; Bluetooth LE folgt später.
• Nur die genormte Abgasdiagnose (OBD-II), keine Steuergeräte wie Airbag oder ABS.
• PIDs mit Statusbyte (u. a. 70 Ladedruck, 7A–7C Partikelfilter) fehlen noch.