Port DIAGNOSTICS - DOIP 🛈¶

Port für Diagnose auf Basis des DoIP-Protokolls über ein VN56xx-Gerät. Bestandteil des Add-on ecu.test diagnostics

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
TLS		[ONLINE]	string	[Optional] Name des TLS-Ports, wenn die Verbindung mit TLS geschützt werden soll. Der TLS-Port muss dazu auf diesem Tool erstellt werden.
Port			string	Name des Ports im Netzwerk. In der Vector Hardware Config muss hierzu der Network-based mode aktiviert sein.
MAC-Adresse ❲Client❳	‚02:00:4C:4F:4F:50‘		string	String (Format: 02:00:4C:4F:4F:50), ‚default‘ wenn die Adapter-MAC-Adresse verwendet werden soll
IP-Version	IPv4	[IPv4, IPv6]	string	Auswahl der verwendeten IP Version
IP-Adresse ❲Client❳			string	IP-Adresse, die clientseitig verwendet werden soll. Sie muss sich im gleichen Subnetz befinden wie die IP-Adresse des Device under Test und darf nicht identisch sein mit der IP-Adresse eines anderen Teilnehmers.
Gateway-Adresse			string	IP Adresse, Leer wenn das Gateway nicht benötigt wird
Subnetzmaske / Präfixlänge	‚default‘		string	Für IPv4 Adressen kann eine Subnetzmaske oder eine Präfixlänge angeben werden (Format: ‚255.255.255.0‘ oder ‚24‘), ‚default‘ wenn die Standard-Subnetzmaske der Netzklasse zur angegebenen IP-Adresse (Client) verwendet werden soll. Bei der Verwendung von IPv6 werden lediglich Präfixlängen akzeptiert. ‚default‘ wird für IPv6 nicht unterstützt.
VLAN ID	0		int	ID mit welcher VLAN-Pakete getagged werden sollen. (0 -> VLAN wird nicht 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 DoIP 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	Gültige Werte	Typ	Beschreibung
activateRouting	False	[False, True]	bool	Gibt an, ob die DoIP-Entität Diagnose-Requests an ein internes Gerät weiterleiten soll
activationType	ByteStream(„00“)		ByteStream	Der Routingtyp im Falle einer Routingaktivierung (z.b. 0x00 -> default, 0x01 -> WWH-OBD, 0xE0 -> Central Security, weitere Werte können dem Standard entnommen werden)
diagTimeout	5000		int	Time-out (ms) nachdem das Diagnose-System das Warten auf eine Diagnose-Antwort abbricht (optional) - Muss größer sein als das Sendebestätigungstimeout
doIpVersion	2		int	Version des DoIP-Protokolls
eid	ByteStream(„“)		ByteStream	ID der DoIP-Entität zu dem eine Verbindung aufgebaut werden soll. Wenn angegeben, wird zum Verbindungsaufbau ein Vehicle-Identification-Request an diese ID gesendet. Wenn nicht, wird ein allgemeiner Vehicle-Identification-Request gesendet und eine Verbindung mit dem ersten antwortenden Steuergerät aufgebaut.
listenPort	0		int	Port auf dem Antworten der DoIP-Entität erwartet werden.
remotePort	13400		int	Zielport auf dem die DoIP-Entität Diagnose-Requests empfängt
retryDelay			int	Wartezeit in ms zwischen Wiederholungsversuchen. Bei None wird ca. 300 ms gewartet.
retryOnBusy	-1		int	Anzahl der Wiederholungsversuche bei Fehlermeldung (-1 entspricht unendlich)
sourceAddress	ByteStream(„“)		ByteStream	Die Diagnoseadresse von der aus Diagnosenachrichten verschickt werden
startRequest			ByteStream	Diagnose-Request zur Sitzungseröffnung
stopRequest			ByteStream	Diagnose-Request zum Beenden der Sitzung
targetAddress	ByteStream(„“)		ByteStream	Die Diagnoseadresse der DoIP-Entität(en). Falls angegeben wird kein Vehicle-Identification-Request gesendet und UDS-Requests werden direkt an diese Adresse verschickt.
targetIp			string	IP-Adresse der DoIP-Entität
testerPresentCycleTime			int	Periodendauer für Tester-Vorhanden-Signalisierung (in ms)
testerPresentRequest			ByteStream	Diagnose-Request zur periodischen Tester-Vorhanden-Signalisierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
SessionId				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

RecoverDiagnosticSessions¶

Fährt alle geöffneten Diagnosesitzungen des Ports herunter und öffnet sie anschließend neu. Jede Sitzung behält dabei ihre akutell konfigurierten Einstellungen.

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.

SetTargetAddress¶

Ändert die TargetAddresse der angegebenen DoIP session

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.
targetAddress		ByteStream(„“)		ByteStream	Die Diagnoseadresse der DoIP-Entität(en). Falls angegeben wird kein Vehicle-Identification-Request gesendet und UDS-Requests werden direkt an diese Adresse verschickt.

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