Port DIAGNOSTICS_JOBS - OBD 🛈¶
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
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. |
Jobs 🛈¶
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.