Live-Daten

Live-Daten fragen Runde für Runde aktuelle Messwerte ab (Mode 01) und zeigen sie an, auf Wunsch mit Aufzeichnung als CSV.

obd-diag live --port /dev/ttyUSB0 --list                      # unterstützte Werte
obd-diag live --port /dev/ttyUSB0                             # übliche Werte, Strg+C beendet
obd-diag live --port /dev/ttyUSB0 --pids rpm,speed,fuel_rail_pressure --interval 0.5
obd-diag live --port /dev/ttyUSB0 --duration 60 --record      # 60 s als CSV aufzeichnen

Zeit (s)  Motordrehzahl (1/min)  Geschwindigkeit (km/h)  Kühlmitteltemperatur (°C)  …  Spannung (V)
     0.0                   1726                      50                         86  …          14.1
     1.0                   1731                      51                         86  …          14.1

Warnung

Während der Fahrt nur durch Beifahrer bedienen.

Welche Werte

140 Werte aus 87 Mode-01-PIDs nach SAE J1979, darunter Drehzahl, Geschwindigkeit, Temperaturen, Last, Luftmasse, Saugrohr-, Rail- und Ladedruck, AdBlue, AGR, Kraftstofftrimm, Lambdasonden 1–8, Drehmoment, Tankfüllstand, Verbrauch und Kilometerstand. Die vollständige Liste mit Schlüssel, Formel und Wertebereich steht unter PID-Formeln.

  • Angefragt werden nur Werte, die das Fahrzeug als unterstützt meldet (0100, 0120 … über alle Steuergeräte). --list zeigt sie mit Schlüssel.

  • Ohne --pids: Drehzahl, Geschwindigkeit, Kühlmitteltemperatur, Last, Ansauglufttemperatur und Steuergerätespannung, soweit unterstützt.

  • Liefert eine PID mehrere Werte (Sondenspannung und Trimm), wird sie je Runde nur einmal abgefragt.

  • Die Sonden heißen 1–8 in PID-Reihenfolge. Welche Bank und Position das ist, legt das Fahrzeug fest (PID 13 oder 1D).

  • Nicht enthalten sind PIDs mit Statusbyte, deren Aufbau in freien Quellen nicht eindeutig ist, darunter Ladedruck (70) und Partikelfilter (7A–7C).

Ablauf einer Runde

  • Jeder gewählte Wert wird einmal gelesen. Ist einer nicht lesbar, steht „-“ (in der CSV eine leere Zelle), die Abfrage läuft weiter.

  • Die Bordspannung (ATRV) wird jede zehnte Runde gelesen. Zeigt der Adapter weniger als 11,8 V, wird mit der Steuergerätespannung (PID 42) gegengeprüft: viele Adapter messen hinter einer Schutzdiode einige Zehntel Volt zu wenig. Liegt auch sie darunter (oder fehlt sie), wird nur noch alle 5 s abgefragt, um die Batterie zu schonen. Solange gedrosselt ist, wird die Spannung jede Runde gemessen; reicht sie wieder (Motor angesprungen), geht es sofort im normalen Takt weiter.

  • Meldet der Adapter drei Runden lang bei jedem Wert einen Busfehler (z. B. Zündung aus), endet die Abfrage mit einer Fehlermeldung. NO DATA, ? und Ablehnungen zählen dabei nicht als Busfehler.

  • Gesendet werden nur 01xx und ATRV, dazu ATH1/ATH0 (Header an und aus), wenn sich mehrteilige Antworten mehrerer Steuergeräte vermischen.

Warnschwellen

Liegt ein Wert unter seiner unteren oder über seiner oberen Schwelle, steht er in der Tabelle mit !, Beginn und Ende der Warnung meldet ein Hinweis; in der Oberfläche wird die Kachel rot und eine Leiste nennt den Wert. Vorgaben (grobe Richtwerte, die im normalen Betrieb nicht anschlagen; was für das eigene Auto normal ist, steht in dessen Unterlagen):

Wert

Schlüssel

Warnung

Kühlmitteltemperatur

coolant_temp

über 115 °C

Motoröltemperatur

oil_temp

über 130 °C

Steuergerätespannung

control_voltage

unter 11,8 V, über 15,5 V

Bordspannung (ATRV)

voltage

unter 11,8 V, über 15,5 V

 
obd-diag live --alarm coolant_temp=:105 --alarm rpm=:4500   # obere Grenzen setzen
obd-diag live --alarm voltage=12,2: --alarm oil_temp=:       # untere Grenze; Warnung aus
obd-diag live --no-alarms --alarm speed=:130                 # nur diese eine Schwelle

--alarm SCHLÜSSEL=UNTEN:OBEN ersetzt die Vorgabe des Werts; eine leere Seite heißt keine Grenze, Komma oder Punkt sind als Dezimalzeichen erlaubt. In der Oberfläche stellt „Warnschwellen …“ sie je Wert ein; sie bleiben gespeichert und gelten ab dem nächsten Start. Geprüft werden nur die ohnehin gelesenen Werte, gesendet wird dafür nichts.

Aufzeichnung

--record schreibt eine CSV unter ~/.local/share/obd-diag/recordings/ (live-JJJJMMTT-HHMMSS.csv) oder in die angegebene Datei, die nicht überschrieben wird. Das Format folgt der Sprache (Sprache): UTF-8 mit BOM; auf Deutsch ; als Trennzeichen und Dezimalkomma, auf Englisch , und Dezimalpunkt. Erste Spalte Zeit (s), dann je Wert Name (Einheit), Bordspannung (V) und zuletzt Warnungen (überschrittene Schwellen dieser Runde als Text, mehrere durch | getrennt, sonst leer). Jede Zeile wird sofort geschrieben, ein Abbruch verliert also nichts.