Port DIAGNOSTICS - KWP2000-CAN 🛈¶
TOSUN-HW-Zugriff auf KWP2000 über CAN. Bestandteil des Add-on ecu.test diagnostics
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Kanalnummer |
‚1‘ |
string |
Auswahl der Kanalnummer wenn mehrere Kanäle des gleichen Typs vorhanden sind. |
||
Bitrate |
‚500KB‘ |
[‚10KB‘, ‚20KB‘, ‚50KB‘, ‚83.333KB‘, ‚100KB‘, ‚125KB‘, ‚250KB‘, ‚500KB‘, ‚666.667KB‘, ‚800KB‘, ‚1000KB‘] |
string |
Bitrate |
|
Abschlusswiderstand aktivieren |
☐ |
bool |
Aktiviert den internen 120-Ohm-Abschlusswiderstand |
||
Modus |
Standard |
[Standard, Extended, All] |
string |
Adressierungs-Modus (Standard = 11bit, Extended = 29bit) |
|
Empfange Error-Frames |
☐ |
bool |
Empfange Error-Frames |
||
Sendebestätigung |
☐ |
bool |
Aktiviert das bestätigte Senden. Bus-Schreiben-Testschritte und Sende-Tooljobs blockieren so lange, bis die Nachricht erfolgreich auf den Bus übertragen wurde oder das Sendebestätigungs-Timeout abgelaufen ist. |
||
Timeout für Sendebestätigung |
1000 |
int |
Dauer in Millisekunden binnen der die Nachricht erfolgreich versendet worden sein muss. Anderenfalls wird ein Fehler erzeugt. (darf nicht größer als 64535ms sein). Wird nur bei aktivierter Sendebestätigung verwendet. |
Jobs 🛈¶
CallService¶
Führt einen Diagnose-Service aus.
Beispiel: Zum Aufruf des UDS-Dienstes Read Data by Identifier (SID=0x22, DID=0xACDC) lautet der Request: ByteStream(„22 AC DC“)
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Request |
ByteStream |
Zu sendender Diagnose-Request (ByteStream) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ClearDTCs¶
ClearDiagnosticInformation (0x14): Wird vom Client verwendet, um Diagnoseinformationen im Speicher des Servers zu löschen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
GroupOfDTC |
0xFF00 |
int |
Nummer der zu löschenden DTC-Gruppe (default: 0xFF00 = alle DTCs, optional) |
||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
CloseSession¶
Schließt eine Diagnosesitzung.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
ECUReset¶
ECUReset (0x11): Fordert den Server auf, einen ECU-Reset gemäß dem Inhalt des ResetMode-Parameterwerts durchzuführen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ResetMode |
int |
Modus des Resets (optional) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
InputOutputControlByCommonIdentifier¶
InputOutputControlByCommonIdentifier (0x2F): Wird vom Client verwendet, um einen Wert für ein Eingangssignal, eine interne ECU-Funktion und/oder einen Steuerausgang (Aktuator) von elektronischen Systemen zu setzen, auf die durch einen InputOutputCommonIdentifier des Servers referenziert wird.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ControlOption |
ByteStream |
Beschreibt wie der Server die Kontrolle über die In- und Outputs übernimmt - ByteStream (optional) |
|||
DataIdentifierHighByte |
int |
Bezeichnung des Datums (High Byte) |
|||
DataIdentifierLowByte |
int |
Bezeichnung des Datums (Low Byte) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
InputOutputControlByLocalIdentifier¶
InputOutputControlByLocalIdentifier (0x30): Wird vom Client verwendet, um einen Wert für ein Eingangssignal, eine interne ECU-Funktion und/oder eine Steuerung eines Ausgangs (Aktuator) eines elektronischen Systems zu setzen, auf das durch einen InputOutputLocalIdentifier des Servers referenziert wird.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ControlOption |
ByteStream |
Beschreibt wie der Server die Kontrolle über die In- und Outputs übernimmt - ByteStream (optional) |
|||
DataIdentifier |
int |
Bezeichner |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
OpenDiagSession¶
Öffnet eine KWP2000-Diagnosesitzung, welche ISO-TP verwendet. Falls bereits eine Session mit den angegebenen Parametern geöffnet ist, wird das Handle dieser Session zurückgegeben, anstatt eine neue zu öffnen.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
AddressByte |
ByteStream |
Netzwerk-Zieladresse bzw. Adress-Erweiterung (nur bei Extended- und Mixed-Adressierung relevant) - ByteStream der Länge 1 |
|||
AddressMode |
0 |
int |
Code des Adressierungsmodus - Integer (0: Standard Addressing | 1: Extended Addressing) |
||
BlockSize |
0 |
int |
Anzahl (0 - 255) der CAN-Botschaften (Consecutive Frames), die ohne zwischengeschaltete Flow Control Botschaft empfangen werden können - Integer |
||
DiagTimeoutCanIsoTp |
2000 |
int |
Timeout in Millisekunden für das Warten auf Antworten bei Diagnoseaufrufen über das ISO-TP-Protokoll - Integer |
||
FillByte |
ByteStream |
Byte zum Auffüllen von Nachrichten (optional) - ByteStream der Länge 1 |
|||
FlowControlAddressByte |
ByteStream |
Abweichende Netzwerk-Zieladresse bzw. Adress-Erweiterung für FlowControl (nur bei Extended- und Mixed-Adressierung relevant) - ByteStream der Länge 1 |
|||
FlowControlId |
int |
Message-ID für Flusskontroll-Botschaften (optional) - Hex (optional Integer) |
|||
IsExtended |
-1 |
int |
Extended CAN ID-Format verwenden? (1=ja / 29 Bit; 0=nein / 11 Bit; -1 = Einstellung aus TBC verwenden) |
||
IsExtendedFlowControlId |
-1 |
int |
Extended CAN ID-Format verwenden (für FlowControlId)? (1=ja / 29 Bit; 0=nein / 11 Bit; -1 = Gleiche Einstellung wie IsExtended verwenden) |
||
IsExtendedRequestId |
-1 |
int |
Extended CAN ID-Format verwenden (für RequestId)? (1=ja / 29 Bit; 0=nein / 11 Bit; -1 = Gleiche Einstellung wie IsExtended verwenden) |
||
IsExtendedResponseId |
-1 |
int |
Extended CAN ID-Format verwenden (für ResponseId)? (1=ja / 29 Bit; 0=nein / 11 Bit; -1 = Gleiche Einstellung wie IsExtended verwenden) |
||
RequestId |
int |
Message-ID für Steuergeräteanfragen - Hex (optional Integer) |
|||
ResponseId |
int |
Message-ID für Steuergeräteantworten - Hex (optional Integer) |
|||
SeparationTime |
0 |
int |
Minimaler zeitlicher Abstand zwischen aufeinanderfolgenden Fragmenten 0x00..0x7F => 0..127ms, 0x80..0xf0 => reserviert, 0xf1..0xf9 => 100..900µs, 0xfa..0xff => reserviert - Integer |
||
StartRequest |
ByteStream |
Diagnose-Request zur Sitzungeröffnung (optional) - ByteStream |
|||
StopRequest |
ByteStream |
Diagnose-Request zum Beenden einer Sitzung (optional) - ByteStream |
|||
TesterPresentCycleTime |
int |
Periodendauer (ms) für zyklische Tester-Vorhanden-Signalisierung (optional) - Integer |
|||
TesterPresentRequest |
ByteStream |
Diagnose-Request zur periodischen Tester-Vorhanden-Signalisierung (optional) - ByteStream |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SessionHandle |
int |
Handle der Diagnosesitzung |
OpenTcfDiagSession¶
Öffnet eine Diagnose-Sitzung, die in der TCF konfiguriert wurde.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SUT |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder None sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
ReadDataByCommonIdentifier¶
Fordert vom/von den Server(n) Data Records an, die durch einen gemeinsamen RecordCommonIdentifier identifiziert sind.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataIdentifierHighByte |
int |
Bezeichnung des Datums (High Byte) |
|||
DataIdentifierLowByte |
int |
Bezeichnung des Datums (Low Byte) |
|||
MaximumNumberOfResponsesToSend |
int |
Definiert die maximale Anzahl der Antworten (optional) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
|||
TransmissionMode |
int |
Bezeichnung des Transmission Modes (optional) 0x01 = single, 0x02 = slow, 0x03 = medium, 0x04 = fast, 0x05 = stop (stoppt das Versenden der Nachricht für 0x02-0x04) |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ReadDataByLocalIdentifier¶
ReadDataByLocalIdentifier (0x21): Fordert vom Server Data Records an, die durch einen RecordLocalIdentifier identifiziert sind.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataIdentifier |
int |
Bezeichner |
|||
MaximumNumberOfResponsesToSend |
int |
Definiert die maximale Anzahl der Antworten |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
|||
TransmissionMode |
int |
Bezeichnung des Transmission Modes 0x01 = single, 0x02 = slow, 0x03 = medium, 0x04 = fast, 0x05 = stop (stoppt das Versenden der Nachricht für 0x02-0x04) |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ReadDiagnosticTroubleCodes¶
ReadDiagnosticTroubleCodes (0x13): Wird vom Client verwendet, um DTCs aus dem Speicher des Servers auszulesen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
GroupOfDTC |
0xFF00 |
int |
Nummer der DTC-Gruppe (Default: 0xFF00 = alle DTCs) |
||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ReadDiagnosticTroubleCodesByStatus¶
ReadDiagnosticTroubleCodesByStatus (0x18): Wird vom Client verwendet, um DTCs anhand ihres Status aus dem Speicher des Servers auszulesen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
GroupOfDTC |
0xFF00 |
int |
Nummer der DTC-Gruppe (Default: 0xFF00 = alle DTCs) |
||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
StatusOfDTC |
0x00 |
int |
Status der DTCs |
||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ReadECUIdentification¶
ReadECUIdentification (0x1A): Fordert Identifikationsdaten vom Server an.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
IdentificationOption |
int |
Bezeichnung der Identifikationsdaten (optional) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
ReadStatusOfDiagnosticTroubleCodes¶
ReadStatusOfDiagnosticTroubleCodes (0x17): Wird vom Client verwendet, um DTCs mit ihrem zugehörigen Status aus dem Speicher des Servers auszulesen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
GroupOfDTC |
0xFF00 |
int |
Nummer der DTC-Gruppe (Default: 0xFF00 = alle DTCs) |
||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
RequestRoutineByLocalIdentifier¶
RequestRoutineResultsByLocalIdentifier (0x33): Wird vom Client verwendet, um Ergebnisse (z. B. Exit-Status-Informationen) anzufordern, die durch einen RoutineLocalIdentifier referenziert und von der Routine erzeugt wurden, die im Speicher des Servers ausgeführt wurde.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
RoutineId |
int |
Id der Routine |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
RequestSeed¶
SecurityAccess (0x27) requestSeed: Fordert ein Seed mit dem vom Fahrzeughersteller definierten Security-Level an.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Hinweis: Der Job wird nicht mehr unterstützt. Er kann durch den Jobs „SecurityAccessRequestSeed“ ersetzt werden.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataRecord |
ByteStream |
DataRecord: optional, um Daten in der Anfrage zu senden. ByteStream |
|||
SecurityLevel |
int |
Security level: ungerade Zahl zwischen 0x01 und 0x7D |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - SecurityAccessDiagResult - oder NegativeResponse |
RestartDefaultSession¶
Startet die in der Testkonfiguration eingerichtete Diagnosesitzung erneut.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Hinweis: Der Job wird nicht mehr unterstützt. Er kann durch die Kombination der Jobs ‚CloseSession‘ und ‚OpenTcfDiagSession‘ ersetzt werden.
SecurityAccessRequestSeed¶
SecurityAccess (0x27) requestSeed: Fordert ein Seed mit dem vom Fahrzeughersteller definierten Security-Level an. Zusätzlich kann eine Seed&Key-Bibliothek spezifiziert werden, um den zum erhaltenen Seed gehörenden Key zu berechnen.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Options |
object |
Option, die an die Seed&Key Library übergeben werden soll. Bei Angabe von None wird die Methode GenerateKeyEx(), bei Angabe einer Zeichenkette GenerateKeyExOpt() aufgerufen. Dies gilt auch im Falle einer leeren Zeichenkette. |
|||
SecurityAccessDataRecord |
ByteStream |
Zusätzliche Daten, die für die Ermittlung des Seeds übergeben werden sollen (optional). ByteStream |
|||
SecurityLevel |
int |
Security level, welches freigeschaltet werden soll, ungerade Zahl zwischen 0x01 und 0x7D |
|||
SeedAndKeyLibraryPath |
string |
Pfad zu einer Seed&Key Library, die für die Generierung des Keys aus dem Seed verwendet werden soll |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
|||
Variant |
string |
Die ECU-Variante, die an die Seed&Key Library übergeben werden soll (optional) |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - SecurityAccessDiagResult - oder NegativeResponse |
SecurityAccessSendKey¶
SecurityAccess (0x27) sendKey: Sendet einen Key mit dem vom Fahrzeughersteller definierten Security-Level.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SecurityKey |
ByteStream |
Key um das benötigte SecurityLevel freizuschalten. Wurde in SecurityAccessRequestSeed eine Seed&Key Library angegeben, dann ist der generierte Key im Rückgabewert des SecurityAccessRequestSeed Jobs enthalten. Wenn nicht, muss der Key vorher anhand des Seeds ermittelt werden. ByteStream |
|||
SecurityLevel |
int |
Security Level, welches freigeschaltet werden soll, gerade Zahl zwischen 0x02 und 0x7E (= SecurityLevel aus SecurityAccessRequestSeed + 1) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
SendKey¶
SecurityAccess (0x27) sendKey: Sendet einen Key mit dem vom Fahrzeughersteller definierten Security-Level.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Hinweis: Der Job wird nicht mehr unterstützt. Er kann durch den Jobs „SecurityAccessSendKey“ ersetzt werden.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SecurityKey |
ByteStream |
Aus dem Seed berechneter Key als ByteStream. ByteStream |
|||
SecurityLevel |
int |
Security level: gerade Zahl zwischen 0x02 und 0x7E (= SecurityLevel aus RequestSeed + 1) |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - SecurityAccessSuccessDiagResult - oder NegativeResponse |
SetTesterPresent¶
Ändert die in der Testkonfiguration angegebenen Parameter für zyklisch gesendete TesterPresent-Nachrichten.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
TesterPresentCycleTime |
int |
Periodendauer (ms) des zyklisch gesendeten Requests. Wird als Periodendauer 0 angegeben wird das zyklische Senden deaktiviert |
|||
TesterPresentRequest |
ByteStream() |
ByteStream |
Der Payload der zyklisch gesendeten Nachricht |
StartRoutineByLocalIdentifier¶
StartRoutineByLocalIdentifier (0x31): Wird vom Client verwendet, um eine Routine im Speicher des Servers zu starten.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
RoutineEntryOption |
int |
Routinenparameter als ByteStream (optional) |
|||
RoutineId |
int |
Id der Routine |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
StopRoutineByLocalIdentifier¶
StopRoutineByLocalIdentifier (0x32): Wird vom Client verwendet, um eine Routine im Speicher des Servers zu stoppen, die durch einen RoutineLocalIdentifier referenziert ist.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
RoutineExitOption |
int |
Routinenparameter als ByteStream (optional) |
|||
RoutineId |
int |
Id der Routine |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
WriteDataByCommonIdentifier¶
WriteDataByCommonIdentifier (0x2E): Wird vom Client verwendet, um RecordValues (Datenwerte) mit einem einzigen Request auf mehrere Server zu schreiben.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataIdentifierHighByte |
int |
Bezeichnung des Datums (High Byte) |
|||
DataIdentifierLowByte |
int |
Bezeichnung des Datums (Low Byte) |
|||
RecordValue |
ByteStream |
Datensatz der geschrieben werden soll - ByteStream |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |
WriteDataByLocalIdentifier¶
WriteDataByLocalIdentifier (0x3B): Wird vom Client verwendet, um RecordValues (Datenwerte) auf einen Server zu schreiben.
Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DataIdentifier |
int |
Bezeichner |
|||
RecordValue |
ByteStream |
Datensatz der geschrieben werden soll - ByteStream |
|||
SessionId |
object |
Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet. |
|||
Timeout |
int |
Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout |
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Return |
DiagResult |
Ergebnis des Diagnoseservice-Aufrufs - DiagResult - oder NegativeResponse |