VW: ODIS¶

Herstellerinformationen

Kategorien

Plattform

Ports¶

Eigenschaften 🛈¶

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.

ActuatorDiagnosticsStart¶

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

ActuatorDiagnosticsStop¶

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

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.

BasicSettingCheck¶

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

BasicSettingStart¶

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

BasicSettingStop¶

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

CheckFlashProgramming¶

Prüft, ob die ECU prinzipiell flashbar 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

CheckVciState¶

Gibt den Status der VCI zurück.

CloseConnection¶

Beendet die Verbindung zur ECU und wechselt zum CLOSE_CONNECTION_BEHAVIOUR.

ConfigureSetting¶

Konfiguriert eine Einstellung des VCI-Testers.

ConnectToEcu¶

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

ConnectToEcuAndOpenConnection¶

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

CreateProtocolVDSBZD¶

Erzeugt VDS/BZD Dokumentation.

DataSetDownload¶

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

DisableTransportMode¶

Reaktivierung eines Fahrzeugs aus dem Transportmodus.

DiscardProtocol¶

Verwirft das Protokoll.

EnableTransportMode¶

Aktivierung des Transportmode eines Fahrzeugs, um den Energieverbrauch zu minimieren.

Dies geschieht, wenn ein längerer Stillstand z.B. bei Lagerung oder Transport bevorsteht. Als Voraussetzung ist keine Verbindung zum Steuergerät notwendig.

ExecuteMacro¶

Führt ein Macro aus.

FlashProgramming¶

Flashen mit einem Updatecontainer.

GetFlashSessions¶

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

GetProjectEcuAddressList¶

Gibt die Steuergeräteadressen des Fahrzeugprojektes zurück.

GetSFDLinkNames¶

Liefert eine Liste aller erreichbaren Steuergeräte, welche SFD unterstützen.

GetShortNamesOfAccessModes¶

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

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.

GetShortNamesOfAdaptationChannels¶

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

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.

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.

GetShortNamesOfCodingValues¶

Liest die Kodierungsnamen vom aktiven Steuergerät.

GetShortNamesOfDiagnosticSessions¶

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

GetShortNamesOfIdentificationDatas¶

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

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.

GetShortNamesOfMeasurements¶

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

GetShortNamesOfMeasurementsForBasicSettings¶

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

GetShortNamesOfStartParametersForActuator¶

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

GetShortNamesOfStartParametersForBasicSettings¶

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

GetShortNamesOfSubSystems¶

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

GetT15State¶

Gibt den Status der Klemme 15 zurück.

GetT30State¶

Gibt den Status der Klemme 30 zurück.

InitProtocol¶

Initialisiert das Protokoll.

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

ReadAdaptation¶

Liefert die Istwerte eines Anpassungskkanals als Liste.

KWP: Listenlänge = 1.

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

ReadAllEventMemories¶

Liest Ereignisspeicher aller Steuergeräte aus

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.

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.

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.

ReadEventMemory¶

Liest Ereignisspeicher des Steuergerätes aus

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.

ReadGatewayComponentList¶

Liest die Gatewaytabelle.

ReadIdentification¶

Identifikation des Steuergerätes

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.

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.

ReadMultilinkIdentification¶

Liest die Identifikationsdaten des angegebenen Steuergeräts mit den aktuellen Multilink-Einstellungen. Wenn das Flag readExtendedIdent aktiviert ist, wird die erweiterte Identifikation gelesen. Anderenfalls wird nur die Standardidentifikation ermittelt. Wenn das Flag readSubSystems aktiviert ist, werden zusätzlich auch die Subsysteme gelesen. Achtung! Nur UDS-Steuergeräte werden unterstützt. Das Ergebniselement eines KWP-Steuergeräts enthält eine Fehlermeldung. Nach der Ausführung werden alle Verbindungen geschlossen.

ResetAllEventMemoriesSequential¶

Löscht Ereignisspeicher aller Steuergeräte

ResetEventMemories¶

Löscht Ereignisspeicher aller Steuergeräte.

ResetEventMemory¶

Löscht Ereignisspeicher des Steuergerätes

SaveProtocol¶

Speichert das Protokoll.

SearchDoIPVCIs¶

Sucht nach verfügbaren DoIP-VCIs. Falls der Parameter für die IP-Adresse (ip) None oder ein Leerstring ist, wird mit einem Broadcast gesucht. Ansonsten wird die Suche über die angegebeneIP-Adresse ausgeführt.

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

SecurityAccessSFDAllEcuLock¶

Führt einen SecurityAccess-Sperrvorgang auf allen unterstüzten Steuergeröten aus. Auf allen Steuergeräte wird vor der Ausführung die extented-Diagnosesitzung über einen funktionalen Diagnose-Aufruf hergestellt.

SecurityAccessSFDAllOnline¶

Führt einen SecurityAccess-Freischaltvorgang mit Hilfe eines SFD-Online-Tokens auf allen unterstüzten Steuergeröten aus. Der SFD-Online-Tokens wird vom SFD-Backend angefragt.

SecurityAccessSFDCheckStatus¶

Liest den SecurityAccess-Freischaltstatus aus.

SecurityAccessSFDEcuLock¶

Führt einen SecurityAccess-Sperrvorgang aus.

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

SecurityAccessSFDOnline¶

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

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.

SecurityAccessSFDSetTBTToken¶

Setzt einen neuen TBT-Token für den nächsten SecurityAccess-Zugriff über die Methode „OnlineAccessMethod.TBT_TOKEN“. Jeder Token ist nur für einen Zugriff gültig und wird danach verworfen.

SendRawService¶

Sendet Rohdiagnose-Daten (HEX).

SendRawServiceFunctional¶

Funktionales Senden von Rohdiagnose-Daten (PDU) als Bytestream.

SetCanFDVehicleProject¶

Setzt und lädt ein CAN-FD-Fahrzeugprojekt für das Diagnoseinterface. Ein Fahrzeugprojekt zu laden, ist Voraussetzung für die Verbindung zum Steuergerät.

SetDoIPActivationLine¶

Aktiviert oder deaktiviert die DoIP-ActivationLine, wenn ein VCI ausgewählt ist, welches DoIP unterstützt.

SetDoIPVehicleProject¶

Setzt und lädt ein DoIP-Fahrzeugprojekt für das Diagnoseinterface. Ein Fahrzeugprojekt zu laden, ist Voraussetzung für die Verbindung zum Steuergerät.

SetVehicleProject¶

Setzt und lädt das Fahrzeugprojekt für das Diagnoseinterface. Ein Fahrzeugprojekt zu laden, ist Voraussetzung für die Verbindung zum Steuergerät.

StartProtocol¶

Startet das Protokoll.

StopProtocol¶

Stoppt das Protokoll.

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

UnloadProject¶

Entlädt das Fahrzeugprojekt.

UnlockConnection¶

Hebt die Sperre der Verbindung zur angegebenen ECU auf.

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.

WriteByteCoding¶

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

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.