Port DIAGNOSTICS - CAN 🛈¶

TechnicaBTS-Diagnose

Bietet Zugriff auf CAN-Rohdiagnosen auf der Grundlage von ISO-TP. Für symbolische Diagnose, die auf Diagnosebeschreibungsdateien (wie ODX oder CDD) basiert, ist Add-on ecu.test diagnostics erforderlich.

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Board-ID ❲DIP-Schalter❳	1		int	Per DIP-Schalter konfigurierte ID des Boards (entspricht letzer Stelle der IP-Adresse).
CAN-Controller	‚CAN1‘	[‚CAN1‘, ‚CAN2‘]	string
Bitrate	‚500KB‘	[‚100KB‘, ‚125KB‘, ‚250KB‘, ‚500KB‘, ‚1000KB‘]	string	Bitrate
Modus	Standard	[Standard, Extended, All]	string	Adressierungs-Modus (Standard = 11bit, Extended = 29bit)
Listen only	☐		bool	Kontroller läuft im passiven Modus. Automatisches ACK ist deaktiviert und das Senden von CAN-Frames ist nicht möglich.
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 🛈¶

AuthenticationConfiguration¶

Authentication (0x29) AuthenticationConfiguration: Authentication (0x29) authenticationConfiguration (0x08): Gibt die bereitgestellte Authentifizierungskonfiguration des Servers an.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - AuthenticationConfigurationResult - oder NegativeResponse

AuthenticationDeauthenticate¶

Authentication (0x29) DeAuthenticate: Authentication (0x29) deAuthenticate (0x00): Fordert an, den authentifizierten Zustand zu verlassen

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - AuthenticationDeauthenticateResult - oder NegativeResponse

AuthenticationProofOfOwnership¶

Authentication (0x29) ProofOfOwnership: Authentication (0x29) proofOfOwnership (0x03): Verifiziert den Proof of Ownership des Clients.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
EphemeralPublicKeyClient	ByteStream	Öffentlicher Schlüssel, der vom Client für die Diffie-Hellman-Schlüsselvereinbarung erzeugt wird. ByteStream
ProofOfOwnershipClient	ByteStream	Nachweis des Besitzes des privaten Schlüssels (Proof of Ownership) durch Signierung der Challenge. 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 - AuthenticationProofOfOwnershipResult - oder NegativeResponse

AuthenticationVerifyCertificateUnidirectional¶

Authentication (0x29) VerifyCertificateUnidirectional: Authentication (0x29) verifyCertificateUnidirectional (0x01): Initiiert die Authentifizierung durch Überprüfung des Zertifikats.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
CertificateClient	ByteStream	Das zu verifizierende Zertifikat. ByteStream
ChallengeClient	ByteStream	Die Challenge enthält fahrzeugherstellerspezifisch formatierte Client-Daten (welche meist zufällige Informationen enthalten) oder ist eine Zufallszahl. Dieser Parametersatz dient zur Übermittlung der Challenge an den Server. ByteStream
CommunicationConfiguration	int	Konfigurationsinformationen darüber, wie mit der Sicherheit bei der weiteren Diagnosekommunikation nach der Authentifizierung verfahren werden soll. ANMERKUNG 1 Diese Informationen sind mit dem Vorhandensein und dem Inhalt des Datenparameters sessionKeyInfo der Antwortnachricht verknüpft. Das Format dieses Parameters sowie die Erstellung des/der Sitzungsschlüssel(s) und die Berechnung des/der Beweiswerte(s) liegen im Ermessen des Fahrzeugherstellers.
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 - AuthenticationVerifyCertificateUnidirectionalResult - oder NegativeResponse

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“)

Parameter

Name	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

CallServiceFunctional¶

Führt einen Diagnose-Service funktional aus

Beispiel: Zum Aufruf des UDS-Dienstes Read Data by Identifier (SID=0x22, DID=0xACDC) lautet der Request: ByteStream(„22 AC DC“)

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	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				object	Liste von Diagnose-Ergebnissen (DiagResult oder NegativeResponse).

ClearDTCs¶

ClearDiagnosticInformation (0x14): Löscht Diagnoseinformationen im Speicher eines oder mehrerer Server.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Typ	Beschreibung
GroupOfDTC	0xFFFFFF	int	Nummer des löschenden DTC bzw. der zu löschenden DTC-Gruppe (default: 0xFFFFFF = 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

CloseSession¶

Schließt eine Diagnosesitzung.

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.

DiagnosticSessionControl¶

DiagnosticSessionControl (0x10). Aktiviert verschiedene Diagnosesessions im Server. Bitte beachten, dass ein Wechsel der Diagnosesession einen ECU-Reset zur Folge haben kann.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	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.
SessionType	int	Diagnostic Session, die gesendet werden soll. 1: DefaultSession, 2: ProgrammingSession, 3: ExtendedDiagnosticSession, 4: Safety SystemDiagnosticSession
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 - DiagnosticSessionControlResult - oder NegativeResponse

ECUReset¶

ECUReset (0x11): Fordert einen Server-Reset an.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	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.
Subfunction	int	Reset-Subfunction, die ausgeführt werden soll
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 - ECUResetResult - oder NegativeResponse

InputOutputControlByIdentifier¶

InputOutputControlByIdentifier (0x2F): Ersetzt einen Wert für ein Eingangssignal oder eine interne Serverfunktion und/oder erzwingt die Vorgabe eines Werts für einen Ausgang (Stellglied) eines elektronischen Systems.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
ControlEnableMaskRecord	ByteStream	Bitmaske für die bei shortTermAdjustment zu verändernden Parameter des DID. Laut ISO 14229-1 nur zu verwenden, wenn der DID aus mehr als einem Parameter besteht.
ControlStateRecord	ByteStream	Datensatz für Steuerung bei shortTermAdjustment
DataIdentifier	int	Bezeichner
InputOutputControlParameter	int	Art der Steuerung laut ISO 14229-1 Annex E.1: 0 = returnControlToECU, 1 = resetToDefault, 2 = freezeCurrentState, 3 = shortTermAdjustment
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 - InputOutputControlByIdentifierResult - oder NegativeResponse

OpenDiagSession¶

Öffnet eine UDS-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.

Parameter

Name	Standardwert	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.

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.

ReadDataByIdentifier¶

ReadDataByIdentifier (0x22): Fordert vom Server Data Record Values an, die durch einen oder mehrere DataIdentifiers identifiziert sind.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
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 - DataRecordDiagResult - oder NegativeResponse

ReadMemoryByAddress¶

ReadMemoryByAddress (0x23): Ermöglicht es dem Client, Speicherdaten vom Server anhand der angegebenen Startadresse und der Speichergröße, die gelesen werden soll, anzufordern.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
MemoryAddress	int	Speicheradresse
MemorySize	int	Länge der zu lesenden Daten
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 - MemoryDiagResult - oder NegativeResponse

ReportDTCByStatusMask¶

ReadDTCInformation (0x19) reportDTCByStatusMask (0x02): Dieser Parameter gibt an, dass der Server dem Client eine Liste von DTCs mit den zugehörigen Status übermittelt, die einer vom Client definierten Statusmaske entsprechen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCListDiagResult - oder NegativeResponse

ReportDTCFaultDetectionCounter¶

ReadDTCInformation (0x19) reportDTCFaultDetectionCounter (0x14): Dieser Parameter gibt an, dass der Server dem Client eine Liste aktueller „prefailed“-DTCs übermittelt, die entweder bereits als „pending“ oder „confirmed“ erkannt wurden oder noch nicht.

Der Zweck des DTCFaultDetectionCounter ist eine einfache Methode zur Identifikation eines zunehmenden oder intermittierenden Problems, das nicht über das statusOfDTC-Byte eines bestimmten DTC erkannt/ausgelesen werden kann. Die interne Implementierung des DTCFaultDetectionCounter ist fahrzeugherstellerspezifisch (z. B. Anzahl der Bytes, vorzeichenbehaftet vs. vorzeichenlos, etc.), jedoch muss der gemeldete Wert ein skalierter 1-Byte-vorzeichenbehafteter Wert sein, sodass +127 (7F16) ein Testergebnis „failed“ darstellt und jeder andere positive Wert ungleich Null ein Testergebnis „prefailed“. Jedoch dürfen DTCs mit einem DTCFaultDetectionCounter-Wert von +127 nicht gemäß der unten genannten Regel gemeldet werden. Der DTCFaultDetectionCounter wird um einen fahrzeugherstellerspezifischen Betrag inkrementiert, wenn die Testlogik ausgeführt wird und ein „fail“ für diesen Testlauf ergibt.

Ein gemeldeter DTCFaultDetectionCounter-Wert größer als 0 und kleiner als +127 (d. h. 0116 bis 7E16) zeigt an, dass die DTC-Enable-Kriterien erfüllt waren und ein nicht abgeschlossener Testlauf mindestens unter einer Bedingung oder einem Schwellwert „prefailed“ ist.

Es dürfen nur DTCs mit DTCFaultDetectionCounter-Werten größer 0 und kleiner +127 (7F16) gemeldet werden.

Der DTCFaultDetectionCounter wird um einen fahrzeugherstellerspezifischen Betrag dekrementiert, wenn die Testlogik ausgeführt wird und ein „pass“ ergibt. Wenn der DTCFaultDetectionCounter auf 0 oder darunter dekrementiert wird, darf der DTC nicht länger in der positiven Response-Nachricht gemeldet werden. Der Wert des DTCFaultDetectionCounter wird nicht zwischen Betriebszyklen erhalten.

Wird ein ClearDiagnosticInformation-Service-Request empfangen, wird der DTCFaultDetectionCounter-Wert für alle DTCs auf 0 zurückgesetzt. Weitere Reset-Bedingungen sind vom Fahrzeughersteller festzulegen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCFaultCounterDiagResult - oder NegativeResponse

ReportDTCSnapshotIdentification¶

ReadDTCInformation (0x19) reportDTCSnapshotIdentification (0x03): Dieser Parameter gibt an, dass der Server dem Client alle DTCSnapshot-Data-Record-Identifikationen [DTC-Nummer(n) und DTCSnapshot-Record-Nummer(n)] übermittelt.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCSnapshotIdentificationDiagResult - oder NegativeResponse

ReportDTCSnapshotRecordByDTCNumber¶

ReadDTCInformation (0x19) reportDTCSnapshotRecordByDTCNumber (0x04): Dieser Parameter gibt an, dass der Server dem Client die DTCSnapshot-Record(s) übermittelt, die mit einer vom Client definierten DTC Number und DTCSnapshot-Record Number verknüpft sind (FF16 für alle Records).

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
DoExtendedInterpretation	False	[False, True]	bool	True, wenn die Snapshot Daten in interpretierter Form zurückgegeben werden sollen, anderfalls False. Die Interpretation erfolgt durch zusätzliche ReadDataByIdentifier Aufrufe (0x22). Funktioniert nur bei fixer Länge von Data Identifier Werten. Default: False
DTCMaskRecord			object	DTC Identifier: 3-Byte-Wert, der DTCHighByte, DTCMiddleByte und DTCLowByte enthält, die zusammen die eindeutige Identifikationsnummer für den zu meldenden Diagnosefehlercode darstellen. Z. B. 0x123456 oder als SAE J2012 P-Code „P1234-56“
DTCSnapshotRecordNumber			int	DTC Snapshot Record Nummer: ein konkretes Auftreten des angegebenen DTC, für das DTC Snapshot Record Daten abgerufen werden sollen. Um alle aufgezeichneten Snapshots im Report darzustellen, muss 0xFF angegeben werden.
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 - DTCSnapshotRecordDiagResult - oder NegativeResponse

ReportDTCWithPermanentStatus¶

ReadDTCInformation (0x19) reportDTCWithPermanentStatus (0x15): Dieser Parameter gibt an, dass der Server dem Client eine Liste von DTCs mit dem Status „permanent DTC“ übermittelt.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportEmissionsOBDDTCByStatusMask¶

ReadDTCInformation (0x19) reportEmissionsOBDDTCByStatusMask (0x13): Dieser Parameter gibt an, dass der Server dem Client eine Liste emissionsbezogener OBD-DTCs mit den zugehörigen Status übermittelt, die einer vom Client definierten Statusmaske entsprechen. Die gemeldeten OBD-DTCs umfassen ausschließlich diejenigen, die zur Erfüllung emissionsbezogener gesetzlicher Anforderungen erforderlich sind.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCListDiagResult - oder NegativeResponse

ReportFirstConfirmedDTC¶

ReadDTCInformation (0x19) reportFirstConfirmedDTC (0x0C): Dieser Parameter gibt an, dass der Server dem Client den ersten vom Server erkannten bestätigten DTC seit dem letzten Löschen der Diagnoseinformationen übermittelt. Die über diesen SubFunction-Parameter gemeldete Information ist unabhängig vom Aging-Prozess bestätigter DTCs (z. B. wenn ein DTC altert, sodass sein Status zurückgesetzt werden darf, wird der erste bestätigte DTC-Eintrag weiterhin vom Server beibehalten, unabhängig von anderen DTCs, die danach bestätigt werden).

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportFirstTestFailedDTC¶

ReadDTCInformation (0x19) reportFirstTestFailedDTC (0x0B): Dieser Parameter gibt an, dass der Server dem Client den ersten vom Server erkannten fehlerhaften DTC seit dem letzten Löschen der Diagnoseinformationen übermittelt. Dabei ist zu beachten, dass die über diesen SubFunction-Parameter gemeldete Information unabhängig davon ist, ob der DTC bestätigt oder gealtert wurde.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportMirrorMemoryDTCByStatusMask¶

ReadDTCInformation (0x19) reportMirrorMemoryDTCByStatusMask (0x0F): Dieser Parameter gibt an, dass der Server dem Client eine Liste von DTCs aus dem DTC-Mirror-Memory mit den zugehörigen Status übermittelt, die einer vom Client definierten Statusmaske entsprechen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCListDiagResult - oder NegativeResponse

ReportMostRecentConfirmedDTC¶

ReadDTCInformation (0x19) reportMostRecentConfirmedDTC (0x0E): Dieser Parameter gibt an, dass der Server dem Client den zuletzt vom Server erkannten bestätigten DTC seit dem letzten Löschen der Diagnoseinformationen übermittelt. Die über diesen SubFunction-Parameter gemeldete Information ist unabhängig vom Aging-Prozess bestätigter DTCs (z. B. wenn ein DTC altert, sodass sein Status zurückgesetzt werden darf, wird der erste bestätigte DTC-Eintrag weiterhin vom Server beibehalten, vorausgesetzt, dass danach keine weiteren DTCs bestätigt werden).

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportMostRecentTestFailedDTC¶

ReadDTCInformation (0x19) reportMostRecentTestFailedDTC (0x0D): Dieser Parameter gibt an, dass der Server dem Client den zuletzt vom Server erkannten fehlerhaften DTC seit dem letzten Löschen der Diagnoseinformationen übermittelt.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportNumberOfDTCByStatusMask¶

ReadDTCInformation (0x19) reportNumberOfDTCByStatusMask (0x01): Dieser Parameter gibt an, dass der Server dem Client die Anzahl der DTCs übermittelt, die einer vom Client definierten Statusmaske entsprechen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCNumberDiagResult - oder NegativeResponse

ReportNumberOfEmissionsOBDDTCByStatusMask¶

ReadDTCInformation (0x19) reportNumberOfEmissionsOBDDTCByStatusMask (0x12): Dieser Parameter gibt an, dass der Server dem Client die Anzahl der emissionsbezogenen OBD-DTCs übermittelt, die einer vom Client definierten Statusmaske entsprechen. Die Anzahl der gemeldeten OBD-DTCs umfasst ausschließlich diejenigen, die zur Erfüllung emissionsbezogener gesetzlicher Anforderungen erforderlich sind.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCNumberDiagResult - oder NegativeResponse

ReportNumberOfMirrorMemoryDTCByStatusMask¶

ReadDTCInformation (0x19) reportNumberOfMirrorMemoryDTCByStatusMask (0x11): Dieser Parameter gibt an, dass der Server dem Client die Anzahl der DTCs aus dem Mirror-Memory übermittelt, die einer vom Client definierten Statusmaske entsprechen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - DTCNumberDiagResult - oder NegativeResponse

ReportSupportedDTCs¶

ReadDTCInformation (0x19) reportSupportedDTC (0x0A): Dieser Parameter gibt an, dass der Server dem Client eine Liste aller im Server unterstützten DTCs mit den zugehörigen Status übermittelt.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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 - DTCListDiagResult - oder NegativeResponse

ReportUserDefMemoryDTCByStatusMask¶

ReadDTCInformation (0x19) reportUserDefMemoryDTCByStatusMask (0x17): Dieser Parameter gibt an, dass der Server dem Client eine Liste von DTCs aus dem benutzerdefinierten DTC-Memory mit den zugehörigen Status übermittelt, die einer vom Client definierten Statusmaske entsprechen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Typ	Beschreibung
MemorySelection		int	Nutzerdefinierter Speicher: Nur DTCs, die in diesem Speicher liegen, werden angefragt.
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.
StatusMask	0xFF	int	Statusmaske: Nur DTCs, die mindestens eines der in der Maske angegebenen Status-gesetzt Bits haben, werden angefragt. (default: 0xFF = beliebiger Status)
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 - UserDTCListDiagResult - oder NegativeResponse

RequestDownload¶

RequestDownload (0x34): Wird verwendet, um einen Datentransfer vom Client zum Server (Download) zu initiieren.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Typ	Beschreibung
DataFormatIdentifier	00	ByteStream	Gibt die Kompressions- (high nibble) und Verschlüsselungsmethode (low nibble) an, welche auf den zu sendenden Daten angewendet worden. Der Wert 0 steht für keine Kompression oder Verschlüsselung. Alle anderen Werte sind herstellerspezifisch. ByteStream
MemoryAddress		ByteStream	Startadresse des Serverspeichers, ab welcher die Daten geschrieben werde sollen. ByteStream
MemorySize		ByteStream	Die Länge der Daten, welche mittels des TransferData Jobs versendet werden sollen. Falls die Daten komprimiert worden, kann sich die Länge herstellerspezifisch auf die komprimierten oder unkomprimierten Daten beziehen. 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 - RequestDownloadResult - 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.

Parameter

Name	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

RequestTransferExit¶

RequestTransferExit (0x37): Wird vom Client verwendet, um einen Datentransfer zwischen Client und Server (Upload oder Download) zu beenden.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
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

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.

RoutineControl¶

RoutineControl (0x31): Der RoutineControl-Service wird vom Client verwendet, um eine definierte Abfolge von Schritten auszuführen und relevante Ergebnisse zu erhalten.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
hasRoutineInfo		[False, True]	bool	optional
RoutineId			int	Id der Routine
RoutineOptionRecord			ByteStream	Routinenparameter (optional) 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.
Subfunction	1		int	Subfunction: Start (0x01), Stop (0x02), Request (0x03)
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 - RoutineDiagResult - oder NegativeResponse

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.

Parameter

Name	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.

Parameter

Name	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.

Parameter

Name	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

SetDiagTimeout¶

Setzt den Timeout für die Diagnosesession. Hinweis: Wenn Der Timeout während einer laufenden Diagnoseanforderung gesetzt wird, kann das Zeitverhalten unvorhersehbar sein.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DiagTimeout				int	Timeout(ms). Wenn dieser Wert auf „None“ gesetzt ist, wird die Timeout auf den Anfangswert beim Öffnen der Session zurückgesetzt.
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.

SetFlowControl¶

Setzt Parameter der Flusssteuerung und/oder sendet Flow-Control-Nachrichten mit Flow-Status „Wait“.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Hinweis: SetFlowControl kann durch die Jobs SetFlowControlWait und SetFlowControlCTS ersetzt werden

Parameter

Name	Standardwert	Typ	Beschreibung
BlockSize		int	Anzahl (0 - 255) der CAN-Botschaften (Consecutive Frames), die ohne zwischengeschaltete Flow Control Botschaft empfangen werden können - Integer Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControl“ beibehalten.
SeparationTime		int	Minimaler zeitlicher Abstand zwischen aufeinanderfolgenden Fragmenten 0x00..0x7F => 0..127ms, 0x80..0xf0 => reserviert, 0xf1..0xf9 => 100..900µs, 0xfa..0xff => reserviert - Integer Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControl“ beibehalten.
SessionId		object	Handle der Diagnosesession. Wird „None“ angegeben wird die Session aus der Testkonfiguration verwendet
WaitCount	0	int	Anzahl der Flow-Control-Nachrichten mit Flow-Status „Wait“, die vor den anschließenden „ContinueToSend“ gesendet werden. Bei 0 wird kein „Wait“ gesendet. Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControl“ beibehalten.
WaitTimeInterval	0.5	float	Zeit in Sekunden zwischen dem Senden zweier Flow-Control-Nachrichten mit Flow-Status „Wait“. Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControl“ beibehalten.

SetFlowControlCTS¶

Aktiviert das Senden einer Flow Control „ContinueToSend“-Nachricht als Antwort auf eine segmentierte Anfrage. Außerdem können den internen Parametern BlockSize und SeparationTime neue Werte zugewiesen werden.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

BlockSize

int

Anzahl (0 - 255) der CAN-Botschaften (Consecutive Frames), die ohne zwischengeschaltete Flow Control Botschaft empfangen werden können - Integer

Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControlCTS“ beibehalten.

SeparationTime

int

Minimaler zeitlicher Abstand zwischen aufeinanderfolgenden Fragmenten 0x00..0x7F => 0..127ms, 0x80..0xf0 => reserviert, 0xf1..0xf9 => 100..900µs, 0xfa..0xff => reserviert - Integer

Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControlCTS“ beibehalten.

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.

SetFlowControlWait¶

Wenn ausgeführt, werden eingehende, segmentierte Botschaften, immer mit einer Flow Control „Wait“ Nachricht beantwortet. Beachte: Dadurch können keine segmentierten Botschaften mehr empfangen werden. Um dieses Verhalten zurückzusetzen, muss der Job SetFlowControlCTS ausgeführt werden.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

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.
WaitTimeInterval		0		int	Wartezeitintervall in ms. Bei einem Wert von 0 werden die Flow Control „Wait“-Nachrichten nur einmal als Antwort auf eine segmentierte Anfrage gesendet. Ist der Wert größer als 0, werden Flow Control „Wait“-Nachrichten in regelmäßigen Abständen mit dem angegebenen Intervall gesendet.

SetTesterPresent¶

Ändert die in der Testkonfiguration angegebenen Parameter für zyklisch gesendete TesterPresent-Nachrichten.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	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

TransferData¶

TransferData (0x36): Wird vom Client verwendet, um Daten entweder vom Client zum Server (Download) oder vom Server zum Client (Upload) zu übertragen.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
BlockLength	int	Maximale Datenmenge, die innerhalb eines Blocks übertragen werden kann. Diese beinhaltet die Service ID und den Sequence Counter für jeden Block. – Integer
FlashData	ByteStream	Zu übertragende Daten. Der Job teilt die Daten automatisch auf der Grundlage des im Parameter „Blocklänge“ angegebenen Werts auf mehrere Blöcke auf. 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 - TransferDataResult

WriteDataByIdentifier¶

WriteDataByIdentifier (0x2E): Ermöglicht es dem Client, Informationen in den Server an einer internen Stelle zu schreiben, die durch den angegebenen Data Identifier spezifiziert ist.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
DataIdentifier	int	Bezeichner
DataRecord	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 - WriteDataByIdentifierResult - oder NegativeResponse

WriteMemoryByAddress¶

WriteMemoryByAddress (0x3D): Der WriteMemoryByAddress-Service ermöglicht es dem Client, Informationen in den Server an einer oder mehreren zusammenhängenden Speicherstellen zu schreiben.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
DataRecord	ByteStream	Daten, die geschrieben werden ByteStream
MemoryAddress	int	Startadresse, an die geschrieben wird
MemorySize	int	Anzahl der Bytes, die geschrieben werden
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 - WriteMemoryByAddressResult - oder NegativeResponse