Port DIAGNOSTICS_JOBS - DEFAULT 🛈

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Verbindung zur ECU automatisch herstellen		☑		bool	Legt fest ob die Verbindung zur ECU automatisch hergestellt wird oder manuell über einen PortJob ausgelöst werden soll
ECU Adresse		0		int	Adresse des Steuergeräts

Jobs 🛈

ActuatorDiagnosticsInit

Initialisiert die Aktordiagnose mit den angegebenen Aktoren. Die Initialisierung muss aufgerufen werden um die Aktordiagnose zu starten.

Für UDS-Steuergeräte können Einstellungen und Messwerte konfiguriert werden, die durch eine Prüfoperation für jede Grundeinstellung gelesen werden.

Für KWP-Steuergeräte sind die Einstellungen auf ein Objekt limitiert und Messwerte werden ignoriert. Stellt sicher, dass die folgende Operation über die gleiche Diagnoseverbindung durchgeführt wird.

ODIS setzt voraus, dass die ECU-Verbindung mit ConnectToEcuAndOpenConnection hergestellt wurde.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
actuators		[]		object	Die zu initialisierenden Aktoren als Python-Dict. Struktur: {shortName1: { parameters: {param1:value1, param2:value2, …}, measurements: [mParam1,mParam2]}, shortName2: …}
measurements				object	Die Messwerte in einer Liste. Kann None sein.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ActuatorDiagnosticsStart

Startet die Aktordiagnose für die angegebenen Aktoren (UDS-Steuergeräte) oder den in actuatorDiagnosticsInit angegebenen Aktor (KWP-Steuergeräte).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
actuators				object	Liste mit Shortnames der zu startenden Aktoren.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Der Status des Startvorgangs.

ActuatorDiagnosticsStop

Stoppt die Aktordiagnose für die angegebenen Aktoren (UDS-Steuergeräte) oder den in actuatorDiagnosticsInit angegebenen Aktor (KWP-Steuergeräte).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
actuators				object	Liste mit Shortnames der zu startenden Aktoren.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Der Status des Stoppvorgangs.

BasicSetting2Init

Initialisiert die Grundeinstellungsdiagnose mit den angegebenen Einstellungen. Die Initialisierung muss aufgerufen werden, um die Grundeinstellungsdiagnose zu starten.

Für UDS-Steuergeräte kann eine Liste von Einstellungen und eine Liste von Messwerten angegeben werden. Diese werden für jede Grundeinstellung durch den Check-Aufruf gelesen. Die angegebenen Messwerte können für verschiedene Steuergeräte konfiguriert werden.

Für KWP-Steuergeräte darf die Liste der Einstellungen nur ein Element enthalten und die Liste der Messwerte wird ignoriert.

Stellt sicher, dass die folgenden Aufrufe über die gleiche Diagnoseverbindung laufen. Nachdem diese Funktion aufgerufen wurden, darf nicht zu einem anderen Steuergerät gewechselt werden. Für UDS-Steuergeräte wird dieser Zustand durch Aufruf von „basicSettingAbort“ verlassen.

ODIS setzt voraus, dass die ECU-Verbindung mit ConnectToEcuAndOpenConnection hergestellt wurde.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
basicSettings		{}		object	Die zu initialisierende Grundeinstellung als Python-Dict. Struktur: {shortName1: { parameters: {param1:value1, param2:value2, …}, measurements: [mParam1,mParam2]}, shortName2: …}
measurements		None		object	Die Messwerte in einer Liste. Kann None sein.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

BasicSettingCheck

Startet die Grundeinstellungsprüfung für die spezifizierten Einstellungen (UDS-Steuergeräte) oder die Einstellungen die in „basicSetting2Init“ konfiguriert wurden (KWP-Steuergeräte).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
basicSettings		[]		object	Liste mit Shortnames der zu prüfenden Grundeinstellungen.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Der Status des Startvorgangs.

BasicSettingStart

Startet die Grundeinstellungsdiagnose für die angegebenen Einstellungen. (UDS-Steuergeräte) oder die Einstellungen die in „basicSetting2Init“ konfiguriert wurden (KWP-Steuergeräte).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
basicSettings		[]		object	Liste mit Shortnames der zu startenden Grundeinstellungen.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Der Status des Startvorgangs.

BasicSettingStop

Stoppt die Grundeinstellungsdiagnose für die angegebenen Einstellungen. (UDS-Steuergeräte) oder die Einstellungen die in „basicSetting2Init“ konfiguriert wurden (KWP-Steuergeräte).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
basicSettings		[]		object	Liste mit Shortnames der zu startenden Grundeinstellungen.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Der Status des Stoppvorgangs.

CheckFlashProgramming

Prüft, ob die ECU prinzipiell flashbar ist.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result			[False, True]	bool	Liefert True, wenn die ECU prinzipiell fllashbar ist. Liefert auch True, wenn keine Information verfügbar ist.

CheckFlashProgrammingWithFlashContainer

Prüft, ob die ECU mit dem Inhalt des containerFileName und dem angegebenen sessionName flashbar ist.

UDS: Überprüfung anhand EXPECTED IDENTS (beinhaltet die Überprüfung von Teilenummer und Softwareversion.

KWP: Überprüfung von Teilenummer und SOftwareversion

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
containerFileName				string	Kompletter Dateipfad zum Flash-Container.
sessionName		‚None‘		string	Der Session-Name des Flashvorgangs. Der Parameter kann ‚None‘ sein.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result			[False, True]	bool	Liefert True, wenn die ECU mit dem Inhalt des containerFileName fllashbar ist.

CloseConnection

Beendet die Verbindung zur ECU und wechselt zum CLOSE_CONNECTION_BEHAVIOUR.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ConnectToEcu

Verbindet sich mit dem Steuergerät mit der angegebenen Adresse.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ConnectToEcuAndOpenConnection

Verbindet sich mit dem Steuergerät mit der angegebenen Adresse und und wechselt zum STAY_CONNECTED_BEHAVIOUR.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

DataSetDownload

Schreibt einen Datensatz mit XML-Inhalt in das aktuelle Steuergerät.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
xmlFilePath				string	Absoluter Pfad zur XML- oder ZIP-Datei, einschließlich Dateiname und Suffix.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Allgemeine Antwort. DiagException - Wenn ein Fehler während der Requestverarbeitung auftritt.

FlashProgramming

Flashen mit einem Updatecontainer.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
checkSessionWithEcu		None	[False, True]	bool	Überprüfung der EXPECTED IDENTS bei UDS bzw. Teilenummer und Softwareversion bei KWP. Kann None sein, dann wird als Defaultwert ‚True‘ genutzt.
containerFileName				string	Kompletter Dateipfad zum Flash-Container.
sessionName		‚None‘		string	Der Session-Name des Flashvorgangs. Der Parameter kann ‚None‘ sein.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream

GetFlashSessions

Gibt die Namen aller Flash Sessions zurück, die im aktuellen Flash-Container enthalten sind.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
checkSessionWithEcu		None	[False, True]	bool	[True/False] True: Überpüfung der Flashbarkeit anhand EXPECTED IDENTS (UDS) bzw. anhand Teilenummer und Softwareversion (KWP). Kann None sein, dann wir der Defaultwert ‚True‘ verwendet.
containerFileName				string	Kompletter Dateipfad zum Flash-Container.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

GetShortNamesOfAccessModes

Liefert die ODX-Shortname-Liste aller verfügbaren Zugriffsmodi für UDS-Steuergeräte. Bei KWP-Steuergeräten wird einen Exception geworfen.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

GetShortNamesOfActuators

Liefert die ODX-Shortnames aller verfügbaren Aktoren des ausgewählten Steuergeräts. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Liste mit den Shortnames aller Aktoren.

GetShortNamesOfAdaptationChannels

Liefert die ODX-Shortname-Liste aller verfügbaren Anpassungskanäle für UDS-Steuergeräte. Bei KWP-Steuergeräten wird einen Exception geworfen.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

GetShortNamesOfAdaptationValues

Liefert die ODX-Shortname-Liste aller möglichen Eingabewerte eines Anpassungskkanals für UDS-Steuergeräte. Bei KWP-Steuergeräten wird einen Exception geworfen.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
adaptationChannel				int	The adaptation channel from which the adaptation values shall be retrieved.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

GetShortNamesOfBasicSettings

Liefert die ODX-Shortnames aller verfügbaren Grundeinstellungen des ausgewählten Steuergeräts. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Liste mit den Shortnames aller Grundeinstellungen.

GetShortNamesOfCodingValues

Liest die Kodierungsnamen vom aktiven Steuergerät.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Die Shortnames der Ergebnisse.

GetShortNamesOfDiagnosticSessions

Liefert die ODX-Shortname-Liste aller verfügbaren Diagnosesessions für UDS-Steuergeräte. Bei KWP-Steuergeräten wird einen Exception geworfen.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

GetShortNamesOfIdentificationDatas

Liefert die ODX-Shortnames aller Identifikationsdaten des angegebenen Subsystems. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
subsystem				string	Name des Subsystems, für das die Werte ausgegeben werden. Wenn der Name des Subsystems leer ist, werden die Shortnames für die Master ECU zurückgegeben. - String

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object

GetShortNamesOfMeasurementGroups

Liefert die ODX-Shortname-Liste aller verfügbaren Messwertgruppen für das ausgewählte Steuergerät. Für KWP-Steuergeräte wirft diese Funktion eineException.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Die Messwertgruppen

GetShortNamesOfMeasurements

Liefert die ODX-Shortnames aller verfügbaren Messwerte der angegebenen Messwertgruppe. Für KWP-Steuergeräte wirft diese Funktion eine Exception.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
measurementGroup				string	Die Messwertgruppe, deren verfügbare ODX-Shortnames ermittelt werden sollen.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Die ODX-Shortnames aller verfügbaren Messwerte der angegebenen Messwertgruppe

GetShortNamesOfMeasurementsForBasicSettings

Liefert die ODX-Shortnames aller Messwerte für die Grundeinstellung. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Liste mit den Shortnames aller Messwerte der Grundeinstellungen.

GetShortNamesOfStartParametersForActuator

Liefert die ODX-Shortnames aller verfügbaren Parameter des angegebenen Aktors. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
actuatorName				int	Der Name des Aktors.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Liste mit den Shortnames aller Aktorparameter.

GetShortNamesOfStartParametersForBasicSettings

Liefert die ODX-Shortnames aller verfügbaren Parameter der angegebenen Grundeinstellung. Für ein KWP-Steuergerät wirft diese Funktion eine Exception.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
basicSettingName				int	Der Name der Grundeinstellung.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Liste mit den Shortnames aller Grundeinstellungsparameter.

GetShortNamesOfSubSystems

Gibt eine Liste der Subsystemnamen der aktiven ECU zurück.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

LockConnection

Sperrt die Verbindung zur angegebenen ECU.

Die Sperre garantiert, dass die Verbindung zur ECU offen bleibt während an anderen Verbindungen gearbeitet wird.

Funktionsaufrufe zu einer anderen ECU werfen eine Exception, wenn keine andere parallele Verbindung parallel geöffnet werden kann.

Falls keien Sperre gesetzt ist, kann die Verbindung jederzeit geschlossen werden, abhängig von der konfigurierten Anzahl an möglichen parallelen Verbindungen.

Um die Sperre zu setzen, ist es notwendig zuvor in das STAY_CONNECTED_BEHAVIOUR zu wechseln. Dafür bitte den Job ‚ConnectToEcuAndOpenConnection‘ nutzen.

Eine Sperre kann mit dem Job ‚UnlockConnection‘ wieder aufgehoben werden.

Folgende Jobs heben die Sperre außerdem auf: ‚CloseConnection‘, ‚SetVehicleProject‘

Außerdem heben einzelne multiple Funktionen die Sperre auf (z.B. ‚ReadAllEventMemories‘ oder ‚CreateProtocolBZD‘)

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadAdaptation

Liefert die Istwerte eines Anpassungskkanals als Liste.

KWP: Listenlänge = 1.

UDS: Listenlänge = n (entspricht den Werten aus ‚getShortNamesofAdaptionGroups‘.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
adaptationChannel				string	The adaptation channel from which the adaptation values shall be retrieved.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadCoding

Liest Kodierung der ausgewählten ECU aus.

UDS: Klartextcodierung und Binärcodierung wird gelesen.

KWP: Nur Binärcodierung.

UDS und KWP: Falls die ECU Slaves besitzt, wird jede Slavecodierung gelesen und zurückgegeben.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object

ReadDevEventMemory

Liest die Entwicklerereignisspeicher von der ausgewählten ECU einschließlich aller Umgebungsbedingungen. Bei UDS-Steuergeräten werden nur die Ereignisspeicher mit der angegebenen Statusmaske gelesen. Der Maskenparameter wirkt sich nicht auf KWP-Steuergeräte aus.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
dtcStatusMask		0xFF		int	Spezifiziert die Filter-Maske für den Status der zurückgegebenen Einträge. Default: 0xFF
memorySelections		[]		object	Auswahl der zu lesenden Speicher. Wenn leer, werden alle verfügbaren Speicher verwendet. Format: Liste von Strings.
readSnapshotRecord		False	[False, True]	bool	Gibt an, ob DTC-Snapshots gelesen werden sollen. Default: False

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadEEPROMSerial

Liest (seriell) die angegebene Nummer an Speicherbytes vom ECU-EEPROM, beginnend bei der startAddress.

Diese Methode wird nur von KWP1281-Steuergeräten unterstützt.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
numberOfMemoryCells				string	Anzahl der zu lesenden Speicherzellen.
startAddress				string	Startadresse

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream

ReadEventMemory

Liest Ereignisspeicher des Steuergerätes aus

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadEventMemoryWithMask

Liest die Ereignisspeicher der ausgewählten ECU einschließlich aller Umgebungsbedingungen. Bei UDS-Steuergeräten werden nur die Ereignisspeicher mit der angegebenen Statusmaske gelesen. Der Maskenparameter wirkt sich nicht auf KWP-Steuergeräte aus. Zusätzlich kann das Auslesen der Snapshot Records mit dem Parameter readSnapshotRecords aktiviert werden.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
dtcStatusMask		0xFF		int	Spezifiziert die Filter-Maske für den Status der zurückgegebenen Einträge. Default: 0xFF
readSnapshotRecords		False	[False, True]	bool	Gibt an, ob DTC-Snapshots gelesen werden sollen. Default: False

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadGatewayComponentList

Liest die Gatewaytabelle.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

ReadIdentification

Identifikation des Steuergerätes

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object

ReadIdentificationData

Liest einzelne Identifikationsdaten aus der aktuell ausgewählten Master-Steuereinheit aus und gibt sie zurück. Einzelne Identifikationsdaten können für UDS- und KWP2000 Service 22-Steuereinheiten gelesen werden und müssen durch einen Identifier ausgewählt werden. Für UDS-Steuergeräte muss einer der von getShortNamesOfIdentificationDatas zurückgegebenen Shortnames verwendet werden. Für KWP-Kontrolleinheiten muss ebenfalls ein UDS-Shortname verwendet werden, um die Identifikationsdaten anzugeben. Der Shortname wird auf einen geeigneten Data Identifier abgebildet. Eine Liste der zugeordneten Shortnames finden Sie in der Automatisierungsparameter-Mapping-Datei. Wenn ein angegebener Bezeichner nicht verfügbar ist oder nicht zugeordnet werden kann, gibt die Funktion ein Ergebnis mit einer entsprechenden Fehlermeldung als Wert zurück.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
identDataIdentifier		[]		object	Shortname der zu lesenden Identifikationsdaten. - String

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object

ReadMeasurement

Liest die Messwerte vom ausgwählten Steuergerät.

Liest alle Werte der angegebenen Messwertgruppe oder - falls angegeben - einen bestimmten Messwert aus dieser Gruppe.

Für KWP-Steuergeräte wird das Lesen von Blocknummer und -position unterstützt.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
measurementGroup				string	Der ODX-Shortname der Messwertgruppe oder die KWP-Blocknummer.
measurementParam		‚None‘		string	Der ODX-Shortname der Messung oder die KWP-Positionsnummer.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Dict mit Messwerten.

ResetEventMemory

Löscht Ereignisspeicher des Steuergerätes

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

SecurityAccess

Führt eine Sicherheitszugriffsoperation auf dem Steuergerät unter Verwendung des angegebenen Login-Codes und Zugriffsmodus durch.

KWP2000-Zugriffsmodi: automatic, level34, level56, coding2

KWP1281-Zugriffsmodi: automatic

UDS-Zugriffsmodi: Login, System Specific

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
accessMode				string	Der Zugriffsmodus.
loginCode				string	Der Login-Code.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

SecurityAccessSFDCheckStatus

Liest den SecurityAccess-Freischaltstatus aus.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	SecurityAccess-Freischaltstatus

SecurityAccessSFDEcuLock

Führt einen SecurityAccess-Sperrvorgang aus.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Das Ergebnis des SFD-Sperrvorgangs

SecurityAccessSFDOffline

Führt einen SecurityAccess-Freischaltvorgang mit Hilfe eines SFD-Offline-Tokens aus. Dafür wird keine Verbindung zum SFD-Backend benötigt. Ein SFD-Offline-Token muss für das spezifizierte Steuergerät, die gewählte Rolle und Dauer im SFD-Token-Verzeichnis liegen (siehe ODIS-Admin).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
duration			[‚SHORT‘, ‚LONG‘, ‚UNLIMITED‘]	string	Dauer für den SFD-Freischaltvorgang
role			[‚EPTI‘, ‚BASIC‘, ‚EXTENDED‘, ‚SUPERUSER‘, ‚PRODUCTION‘, ‚OTA‘]	string	Rolle für den SFD-Freischaltvorgang

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Das Ergebnis des SFD-Freischaltvorgangs

SecurityAccessSFDOnline

Führt einen SecurityAccess-Freischaltvorgang mit Hilfe eines SFD-Online-Tokens aus. Der SFD-Online-Token wird vom SFD-Backend angefragt.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
accessMethod			[‚PKI‘, ‚SoftPSE‘, ‚TBT_TOKEN‘]	string	Authentifizierungsmethode für das SFD-Backend
duration			[‚SHORT‘, ‚LONG‘, ‚UNLIMITED‘]	string	Dauer für den SFD-Freischaltvorgang
role			[‚EPTI‘, ‚BASIC‘, ‚EXTENDED‘, ‚SUPERUSER‘, ‚PRODUCTION‘, ‚OTA‘]	string	Rolle für den SFD-Freischaltvorgang

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Das Ergebnis des SFD-Freischaltvorgangs

SecurityAccessSFDReset

Führt einen SecurityAccess-Resetvorgang mit Hilfe eines SFD-Online-Tokens aus. Dieser Vorgang setzt das Steuergerät auf die initialen Schutzwerte zurück und darf nur von der Rolle SUPERUSER ausgeführt werden. Der SFD-Online-Token wird vom SFD-Backend angefragt.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
accessMethod			[‚PKI‘, ‚SoftPSE‘, ‚TBT_TOKEN‘]	string	Authentifizierungsmethode für das SFD-Backend
duration			[‚SHORT‘, ‚LONG‘, ‚UNLIMITED‘]	string	Dauer für den SFD-Freischaltvorgang
role			[‚EPTI‘, ‚BASIC‘, ‚EXTENDED‘, ‚SUPERUSER‘, ‚PRODUCTION‘, ‚OTA‘]	string	Rolle für den SFD-Freischaltvorgang

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Das Ergebnis des SFD-Resetvorgangs

SendRawService

Sendet Rohdiagnose-Daten (HEX).

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
requestPdu				ByteStream	Rohdiagnose-Daten (PDU) als Bytestream, Bsp.: ‚ByteStream(‚20:FF:FF:FF‘)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

SwitchSession

Für UDS-Steuergeräte wird der Shortname der Diagnosesitzung verwendet, um diejenige Sitzung zu identifizieren, zu der gewechselt werden soll.

Für KWP-Steuergeräte werden die folgenden Identifier verwendet:

00 VAS505x mode

83 End of line within volkswagen

84 End of line within control unit producer

85 Update programming

86 Developper mode

89 Standard selfdiagnostics

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
session				string	Diagnosesitzung zu der gewechselt werden soll.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

UnlockConnection

Hebt die Sperre der Verbindung zur angegebenen ECU auf.

Parametrierung

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

WriteAdaptation

Schreibt Anpassungskanal in die angegebenen Anpassungskanäle. Der Anpassungskanal und zu schreibende Werte müssen für UDS und KWP unterschiedlich angegeben werden.

Für UDS ist der Anpassungskanal einer der Kanäle von getShortNamesOfAdaptationChannels und die verfügbaren Werte des Kanals sind über getShortNamesOfAdaptationValues ermittelbar.

Die zu schreibenden Anpassungswerte werden dieser Funktion als Schlüssel-Wert-Dictionary übergeben. Der Schlüssel gibt den Shortname des Anpassungswerts an und der Wert ist der zu schreibende Anpassungswerte.

Für KWP wird die Kanalnummer als Zeichenfolge angegeben - d.h. von ‚1‘ bis ‚255‘.

Der zu schreibende Anpassungswert muss als einziger Eintrag im Schlüssel-Wert-Dictionary angegeben werden, wobei der Anpassungskanal als Schlüssel dient.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
adaptationChannel				string	Der Anpassungskanal in den die Anpassungswerte geschrieben werden sollen.
adaptationValues				object	Die zu schreibenden Anpassungswerte. Beispiel eines Schlüssel/Wert-Paares: {‚Param_ActiveStartStopFunct‘: ‚active‘}.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

WriteByteCoding

Schreibt Kodierungswerte für das gewählte (Sub-)System.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
codingValue				string	Kodierungswert, der geschrieben werden soll als String. Für KWP short coding muss der Wert ein Integer sein. Für KWP long coding und UDS binary coding: ByteStream / Byte Array .
systemName				string	(Sub-)Systemname. KWP Subsysteme setzen sich aus dem Präfix ‚subSys‘ und dem Index zusammen. Ist kein Subsystem vorhanden, dann ‚master‘ übergeben.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream

WriteTextCoding

Schreibt die Textkodierwerte für das angegebene System.

Die Funktion ist nur für UDS-Steuergeräte definiert.

Für den Systemnamen des Master-Steuergeräts kann die Konstante ‚master‘ oder der Shortname verwendet werden.

Für KWP-Steuergeräte wird eine Exception geworfen.

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
codingValues				object	Ein Dictionary mit Kodierwerten im Klartext als Schlüssel/Wert-Paare. Schlüssel = ShortNamesOfCodingValue Wert = Kodierwert
ecuReset			[False, True]	bool	Soll nach dem Schreiben ein Reset durchgeführt werden?
systemName				string	(Sub-)Systemname. KWP Subsysteme setzen sich aus dem Präfix ‚subSys‘ und dem Index zusammen. Ist kein Subsystem vorhanden, dann ‚master‘ übergeben.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string

2025-12-05