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
- 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.
- Adapter einstecken, Zündung an.
- Einstellungen › OBD-Adapter (Beta) › Verbindung: nach dem Adapter suchen und Mit diesem Adapter verbinden wählen.
- 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.