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 |