OBD - uheine/journeypulse-legal GitHub Wiki

OBD-Adapter und Fahrzeugdaten

JourneyPulse kann über einen Bluetooth-OBD-Adapter Daten direkt aus dem Fahrzeug lesen: Geschwindigkeit, Motorwerte, Verbrauch und Fehlercodes. OBD ist optional; alle anderen Funktionen laufen auch ohne.

⚠️ Beta: Der Bereich heißt in der App OBD-Adapter (Beta). Die Adapterprofile und Fahrzeugvorschläge sind noch nicht an allen Fahrzeugen und Adaptern erprobt.

⚠️ Sicherheit: Adapter und App nur im Stand bedienen. Die Nutzung erfolgt auf eigene Gefahr; für Schäden am Fahrzeug oder gelöschte Diagnosedaten wird keine Haftung übernommen. Beim ersten Zugriff bestätigst du einen entsprechenden Haftungsausschluss (widerrufbar).

Unterstützte Adapter

Erwartet wird ein Adapter mit ELM327-kompatiblen Befehlen über Bluetooth Low Energy (BLE). Zur Wahl stehen die Profile:

  • Vgate AD10 (Nordic UART): erprobt
  • vLinker FS und vLinker MS: Profile vorhanden, noch nicht mit echter Hardware geprüft
  • Generischer ELM327-Klon

Klassische Bluetooth-Adapter (ohne BLE) funktionieren auf dem iPhone nicht.

Verbinden

  1. Berechtigung: Beim ersten Start fragt die App optional nach dem Bluetooth-Zugriff (Einführung). Wurde er verweigert, führt dich die Ansicht direkt in die Systemeinstellungen.
  2. Adapter einstecken, Zündung an.
  3. Einstellungen › OBD-Adapter (Beta) › Verbindung: nach dem Adapter suchen und Mit diesem Adapter verbinden wählen.
  4. Status: Die Statusleiste zeigt ein „OBD“-Symbol (verbindet, verbunden, getrennt). Langes Drücken trennt die Verbindung oder stellt sie her.

Optionen darunter:

  • Automatisch verbinden im Auto: sucht den zuletzt genutzten Adapter, sobald Autofahrt erkannt wird, die Navigation startet oder CarPlay verbindet, aber nur, solange das iPhone am Strom hängt.
  • Fehlercodes bei Fahrtbeginn prüfen und Fehlercodes im Hintergrund periodisch prüfen (alle 5 Minuten; bei neuen Fehlern erscheint ein Popup mit Löschoption).
  • Audio hat Vorrang: verhindert, dass Bluetooth-Musik durch Abfragen stottert.
  • Kaltstart-Warnung: Banner und Ansage, wenn der kalte Motor über der eingestellten Drehzahl läuft (Grenzwerte einstellbar).
  • Kraftstoffart und Tankkapazität: nötig für Verbrauchs-, CO2- und Reichweitenschätzung.

Schnelleinrichtung (Standard und Experte)

Unter Adapter & Protokoll gibt es zwei Modi:

  • Standard: Adapter und Protokoll werden automatisch erkannt.
  • Experte: Adapterprofil und Protokoll (z. B. Automatisch, Motor KWP2000 Fast-Init, Kombi & Komfort KWP1281-Sonde) manuell wählen. Die Änderung wirkt erst bei der nächsten Verbindung.

Die Fahrzeugtyp-Schnelleinrichtung fragt Marke, Modell und Baujahr ab und schlägt Profil und Protokoll vor. Hinterlegt sind derzeit nur wenige Fahrzeuge, darunter Audi A3 8L (1996–2003) und VW Golf IV (1997–2003) (K-Line, kein CAN) sowie allgemeine Vorschläge für ältere und neuere Fahrzeuge. Für beide gilt: automatisches Protokoll.

Angezeigte Werte

Einstellungen › OBD-Adapter › Live-Daten zeigt Kacheln für die Werte, die dein Fahrzeug tatsächlich unterstützt (die App fragt das beim Verbinden ab), u. a. Drehzahl, Geschwindigkeit, Kühlmittel-, Ansaug- und Außentemperatur, Motorlast, Drosselklappenstellung, Ansaugdruck, Luftmassenstrom, Kraftstoffdruck, Tankstand und Batteriespannung. Das Abfrageintervall ist einstellbar. Unter Fahrzeug-Info kannst du die Fahrgestellnummer (VIN) auslesen; nicht jedes Fahrzeug liefert sie.

Verbrauch: Die App schätzt Verbrauch und CO2 aus dem Luftmassenstrom. Aus deinen Tankungen lernt sie einen Korrekturfaktor. Autos ohne Tankstandsensor zeigen die Reichweite aus der Tankhistorie. Der Ø-Verbrauch erscheint auch im CarPlay-Overlay. Bei stark abweichendem OBD- und GPS-Tempo (z. B. Tunnel) wird eine Abweichung gemeldet.

Fehlercodes in Klartext und Protokoll

  • Im Tab Mehr unter Erkannte OBD-Fehler (oder unter Einstellungen › OBD-Adapter › Fehlercodes): zeigt gespeicherte, anstehende und permanente Codes mit Klartext und unverbindlichen Reparaturhinweisen, außerdem die Freeze-Frame-Momentaufnahme. Ein rot blinkendes OBD-Symbol weist auf aktive Fehler hin; das Fehlerbanner blendet sich nach 30 Sekunden aus.
  • Klartext liegt derzeit nur für eine kleine Auswahl gängiger Codes vor; sonst erscheint eine Kategorie-Beschreibung.
  • Verlauf (Fehlerprotokoll): Ereignisse wie „Neu aufgetreten“, „Erneut nach Löschung“, „Gelöscht“ oder „Nicht lesbar“ werden dauerhaft in einer Textdatei gespeichert, sichtbar in der Dateien-App unter JourneyPulse › Fehlerprotokoll. Du kannst sie teilen.

⚠️ Beta: Die Fehlercode-Auswertung wurde noch nicht umfassend im Fahrzeug erprobt. Bei Zweifeln hilft die Rohantwort im OBD-Log.

Fehlercodes nicht blind löschen

Fehlercodes löschen setzt auch Freeze-Frame-Daten und den Status der Motorkontrollleuchte zurück. Ist die Ursache nicht behoben, kehrt der Fehler zurück. Permanente Codes lassen sich nicht löschen; das Steuergerät entfernt sie selbst. Lass sicherheitsrelevante Fehler in einer Werkstatt prüfen. Die Reparaturhinweise ersetzen keine Werkstattdiagnose.

In Arbeit: weitere Steuergeräte

Der Zugriff auf weitere Steuergeräte älterer Fahrzeuge (K-Line) ist in Arbeit und noch nicht nutzbar.

Siehe auch: CarPlay, Energie und Akku, Einstellungen, FAQ, Bekannte Einschränkungen.