Port DIAGNOSTICS_JOBS - OBD

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

OBD Adresse

string

OBD Steuergeräteadresse, z.B. 33

Wiederholungen bei Fehler

0

int

Anzahl der Versuche bei Fehlern während der Job-Ausführung.

Wartezeit vor Wiederholung

0

int

Zeit in Sekunden die vor einer Wiederholung aufgrund eines Fehlers der Job-Ausführung gewartet wird.

CheckOBDCommunication

Überprüft den Verbindungsaufbau zum Steuergerät.

ClearOBDFaultMemory

Löscht den Fehlerspeicher.

GetOBDCalibrationInfo

Liest die Fahrzeuginformationen (SAE J1979 Service/Mode 09) für die InfoTypes 02 (VIN), 04 (CALID), 06 (CVN) und 0A (ECUNAME) aus.

Zum Auslesen des InfoTyps 08 (IUMPR) kann der Job GetOBDIUMPR verwendet werden. Für alle anderen Service/Mode 09 InfoTypes kann der generischere Job GetOBDSingleVehicleInfoData verwendet werden. Um festzustellen, welche InfoTypes für Service/Mode 09 unterstützt werden, kann der Job GetOBDSupportedPIDs verwendet werden.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ciType

‚VIN‘

[‚VIN‘, ‚CALID‘, ‚CVN‘, ‚ECUNAME‘]

string

CiType

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält die Adresse des Steuergeräts unter dem Schlüssel „ECU“ und den Wert des ausgelesenen Infotype unter dem Schlüssel „CalibrationInfo“.

GetOBDCommunicationStatus

Liest OBD-Status des Steuergerätes aus.

GetOBDCurrentData

Liest die aktuellen Antriebsstrang-Diagnosedaten (SAE J1979 Service/Mode 01) gesamthaft aus.

Der Job GetOBDSingleCurrentData kann zum Auslesen der Daten für eine einzelne PID verwendet werden.

Weitere unterstützte Protokolle: J1939, WWH-OBD

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signalList

string

Liste der auszulesenden IDs, z.B. [‚01‘, ‚02‘]

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Adresse des Steuergeräts und unter dem Schlüssel „CurData“ eine Liste mit den ausgelesenen Powertrain-Diagnostic-Daten. Elemente dieser Liste sind Dictionaries mit den Schlüsseln „PID“, „Value“, „Unit“ und „Description“.

GetOBDFaultMemory

Liest die abgasrelevanten Diagnosefehlercodes im Zustand „confirmed“ (SAE J1979 Service/Mode 03), im Zustand „pending“ (SAE J1979 Service/Mode 07) und im Zustand „permanent“ (SAE J1979 Service/Mode 0A) aus.

Weitere unterstützte Protokolle: WWH-OBD

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Mode

‚confirmed‘

[‚confirmed‘, ‚pending‘, ‚permanent‘]

string

Mode für Fehlerspeicher

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Wörterbuch enthält unter dem Schlüssel „ECU“ die Steuergeräteadresse und unter dem Schlüssel „DTCs“ eine Liste der DTCs.

GetOBDFreezeFrameData

Liest die Freeze-Frame-Daten des Antriebsstrangs aus (SAE J1979 Service/Mode 02).

Um festzustellen, welche PIDs für Service/Mode 02 unterstützt werden, kann der Job GetOBDSupportedPIDs verwendet werden.

Weitere unterstützte Protokolle: J1939, WWH-OBD

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signal

string

PID, welche ausgelesen werden soll, z.B. 0A

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Adresse des Steuergeräts, unter dem Schlüssel „SAE“ den DTC, der die Speicherung der Freeze-Frame-Daten erforderlich machte, und unter dem Schlüssel „FreezeFrame“ eine Liste der Freeze-Frame-Daten. Wenn FreezeFrame-Daten gespeichert sind, enthält diese Liste für jeden FreezeFrame ein Dictionary mit den Schlüsseln „PID“, „Value“ und „Unit“, andernfalls ist die Liste leer.

GetOBDIUMPR

Liest die Fahrzeuginformationen (SAE Service/Mode 09) für den InfoType 08 (IUMPR) aus und gibt diese in einer interpretierten Form zurück.

Weitere unterstützte Protokolle: WWH-OBD

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Adresse des Steuergeräts und unter dem Schlüssel „UIMPR“ eine Liste aller ausgelesenen Performance-Tracking-Daten. Die Elemente dieser Liste sind wiederum Dictionaries mit den Schlüsseln „Name“, „Value“ und „Description“.

GetOBDReadiness

Liest den Readiness von WWH-OBD oder J1939 aus.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signals

object

Array mit den zu lesenden Werten (z.B. „DM05“ für J1939) - list[str]. Wenn dieser Parameter leer ist, werden die aktuell in DiagRA ausgewählte Readiness zurückgeliefert.

GetOBDSingleCurrentData

Liest die aktuellen Antriebsstrang-Diagnosedaten (SAE J1979 Service/Mode 01) für eine einzelne PID aus.

Mit dem Job GetOBDCurrentData können die Daten für alle PIDs insgesamt ausgelesen werden.

Weitere unterstützte Protokolle: J1939, WWH-OBD

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signal

string

PID, welche ausgelesen werden soll, z.B. 0A

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Adresse des Steuergeräts und unter dem Schlüssel „CurData“ eine einelementige Liste mit den ausgelesenen Powertrain-Diagnostic-Daten. Element dieser Liste ist ein Dictionary mit den Schlüsseln „PID“, „Value“, „Unit“ und „Description“.

GetOBDSingleTestResult

Liest On-Board-Monitoring-Testergebnisse für bestimmte überwachte Systeme (SAE J1979 Service/Mode 06) für eine einzelne Monitor Id (MID) aus.

Mit dem Job GetOBDTestResults können die Daten für alle MIDs insgesamt ausgelesen werden.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signal

string

MID, welche ausgelesen werden soll, z.B. 01

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Steuergeräteadresse und unter dem Schlüssel „TestResult“ die Testergebnisse. Das Testergebnis ist eine Liste von Dictionaries, wobei jedes Dictionary ein einzelnes Testergebnis mit den Schlüsseln „MID“, „TestID“, „UnitID“, „Value“, „ValueMin“, „ValueMax“, „ValueUnit“ und „Description“ darstellt.

GetOBDSingleVehicleInfoData

Liest die Fahrzeuginformationen (SAE J1979 service/mode 09) aus.

Um den InfoType 08 (IUMPR) in einer interpretierten Form zu erhalten, kann der Job GetOBDIUMPR verwendet werden. Für die InfoTypes 02 (VIN), 04 (CALID), 06 (CVN) und 0A (ECUNAME) ist auch der Job GetOBDCalibrationInfo verfügbar.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signal

string

InfoType, welcher in Mode 09 gelesen wird. Wenn der Parameter leer ist, werden aktuell ausgewählte Werte zurück geliefert. Hier darf auch Support PID (00, 20, …) sein.

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Wörterbuch enthält unter dem Schlüssel „Ecu“ die Steuergeräteadresse, unter dem Schlüssel „CurData“ die angeforderten Fahrzeuginformationen und unter dem Schlüssel „CurDataText“ eine textuelle Darstellung der Fahrzeuginformationen. Der Wert von „CurData“ ist eine Liste mit Dictionaries, wobei jedes Dictionary eine Fahrzeuginformation mit den Schlüsseln „Name“, „Value“, „ValueUnit“ und „Description“ darstellt.

GetOBDSupportedPIDs

Gibt Informationen über die unterstützten PIDs eines Modes zurück.

Weitere unterstützte Protokolle: WWH-OBD

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

modeNo

‚1‘

[‚1‘, ‚2‘, ‚3‘, ‚4‘, ‚5‘, ‚6‘, ‚7‘, ‚8‘, ‚9‘]

string

Service/Mode für den die unterstützten PIDs ermittelt werden sollen

modulName

string

Modulname für ECU Name, z.B. ‚E8‘

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary steht für eine unterstützte PID. Es enthält die PID-Nummer unter dem Schlüssel „PID“ und ihre Beschreibung unter dem Schlüssel „Value“.

GetOBDTestResults

Liest On-Board-Monitoring-Testergebnisse für bestimmte überwachte Systeme (SAE J1979 Service/Mode 06) für mehrere Monitor-IDs aus.

Mit dem Job GetOBDSingleTestResult können die Daten für eine einzelne Monitor Id (MID) ausgelesen werden.

Weitere unterstützte Protokolle: J1939

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signalList

string

Liste der auszulesenden IDs, z.B. [‚01‘, ‚02‘]

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Dictionaries. Jedes Dictionary enthält unter dem Schlüssel „ECU“ die Steuergeräteadresse und unter dem Schlüssel „TestResult“ die Testergebnisse. Das Testergebnis ist eine Liste von Dictionaries, wobei jedes Dictionary ein einzelnes Testergebnis mit den Schlüsseln „MID“, „TestID“, „UnitID“, „Value“, „ValueMin“, „ValueMax“, „ValueUnit“ und „Description“ darstellt.

GetOBDTracking

Liefert Engine Run Time Tracking für WWH-OBD oder J1939 zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signals

object

Array mit den gewünschten Werten - list[str]. Wenn der Parameter leer ist, werden aktuell ausgewählte Werte zurückgeliefert.

GetOBDVehicleInfo

Liest Fahrzeuginformationen mittels WWH-OBD oder J1939 aus.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signals

object

Array mit den zu lesenden Identifiern. - list[str].

GetWWHOBDFaultMemory

Diese Funktion dient dem Auslesen des Fehlerspeichers unter ISO 27145. Signals ist eine Liste mit den ShortNames der gewünschten Fehlerarten, wie sie in DiagRA D auf der Seite J1939/ISO27145 unter Fehlercodes gefunden werden können.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

signals

[]

object

Array mit den zu lesenden Daten - list[str]

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Fehlern aus den Steuergeräten.

SendOBDHexServiceT

Sendet einen OBD Hex Service und gibt die Antwort der ECUs zurück, wird nur für J1979 unterstützt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

sendData

object

SendData als ByteStream, Hex-String oder Byte-Liste. Besteht aus Service Nummer (SID) und Parameter(n).

StartOBDCommunication

Manueller Start der Kommunikation mit dem Steuergerät.

StopOBDCommunication

Manueller Stopp der Kommunikation mit dem Steuergerät.