Löscht alle löschbaren Fehlerspeichereinträge im Steuergerät und aktualisiert die Liste der verbleibenden Fehlerspeichereinträge

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.ClearDtc().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Löschen, 'false' sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, wenn die Fehlerspeicher nicht gelöscht werden konnten.

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.CurrentVehicleContext.ClearDtcInAllEcus() für funktional adressiertes/sequentielles Löschen von Fehlerspeichereinträgen.

Isom.Context.Dtc.Clear() für logisch adressiertes Löschen von Fehlerspeichereinträgen.

Datum:

letzte Änderung am 19.07.2010

Erzeugt eine identische Kopie des Objekts.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Context.Ecu clone = ecu.Clone(); 

Rückgabe:

Isom.Context.Ecu
Das geklonte Objekt.

Datum:

letzte Änderung am 20.07.2010

Führt die Steuergerätedefaultcodierung des Steuergeräts im Komfortmodus aus.

Der Aufruf ist derzeit nur innerhalb einer Aktionsausführung "Code" zulässig.

   Isom.Base.Boolean DoCode(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Base.StringList parts = Isom.Base.StringList.CreateStringList(); 

     //Angabe der zu codierenden Teile 

     if(ecu.CodeWithDefaults().Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls die Codierung vollständig erfolgreich war, 'false' sonst.

Datum:

letzte Änderung am 19.07.2010

Erzeugt ein neues Steuergeräte-Fachobjekt mit der übergebenen Adresse.

Die daraus eindeutig ermittelbaren Datenfelder werden aus der ISOM-Fahrzeugbeschreibung gelesen; es findet keine Fahrzeugkommunikation statt. Das Fachobjekt wird nicht automatisch zur Ist- oder Soll-SG-Liste hinzugefügt, sondern es ist gewissermaßen "freistehend".

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 

Rückgabe:

Isom.Context.Ecu
Das neu erzeugte Steuergeräte-Objekt mit der übergebenen Adresse.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls keine ISOM-Fahrzeugbeschreibung geladen ist

Datum:

letzte Änderung am 19.07.2010

Erzeugt ein neues Steuergeräte-Fachobjekt mit dem übergebenen Gruppennamen.

Die daraus eindeutig ermittelbaren Datenfelder werden aus der ISOM-Fahrzeugbeschreibung gelesen; es findet keine Fahrzeugkommunikation statt. Das Fachobjekt wird nicht automatisch zur Ist- oder Soll-SG-Liste hinzugefügt, sondern es ist gewissermaßen "freistehend".

Veraltet:

Ist spezifisch für das Laufzeitsystem EDIABAS und wird seit Version 15 von Argonaut nur noch aus Kompatibilitätsgründen unterstützt; Aufruf sollte ersetzt werden durch Aufrufe von Isom.Context.Ecu.CreateNewByAddress() mit anschließendem Isom.Context.Ecu.SetProp("GroupName").

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByGroupName( "MOTOR" ); 

Rückgabe:

Isom.Context.Ecu
Das neu erzeugte Steuergeräte-Objekt mit dem übergebenen Gruppennamen.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls keine ISOM-Fahrzeugbeschreibung geladen ist

Datum:

letzte Änderung am 19.07.2010

Löscht sämtliche Information über Fehlerspeicher aus dem Datenobjekt.

Achtung:

Die Fehlerspeicher werden nicht im realen Steuergerät gelöscht. Dafür ist die Funktion Isom.Context.Ecu.ClearDtc() zu verwenden.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.DeleteAllDtc().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

errorID

Gibt den Identifikator des Fehlers an. Dies kann z.B. die Fehlernummer sein.

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Löschen, 'false' sonst.

Datum:

letzte Änderung am 19.07.2010

Löscht einen Fehlerspeichereintrag mit der übergebenen Fehler-ID aus dem Datenobjekt.

Achtung:

Der Fehlerspeichereintrag wird nicht im realen Steuergerät entfernt. Dafür ist die Funktion Isom.Context.Ecu.ClearDtc() zu verwenden.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.DeleteAllDtc().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

errorID

Gibt den Identifikator des Fehlers an. Dies kann z.B. die Fehlernummer sein.

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Löschen, 'false' sonst.

Datum:

letzte Änderung am 19.07.2010

Schreibt alle Identifikatoren der Softwarestände (Build-, Historical-,Current-) in das informationstragende Steuergerät im Fahrzeug.

Verbringt alle im ISOM-Objektmodell hinterlegten Integrationsstände in das vorgegebene Steuergerät.
Geschrieben werden:

1. die Ist-Version aus dem Ist-Kontext als aktuelle Version,
2. die Bau-Version aus dem Ist-Kontext als Bau-Version,
3. die Backup-Version aus dem Ist-Kontext als Backup-Version

Zu beachten:

Sollte nur für Steuergeräte aufgerufen werden, die im ISOM-Fahrzeugmodell als versionstragend modelliert sind und dadurch von der Fachfunktion Isom.Context.CurrentVehicleContext.GetSoftwareVersionEcus zurückgeliefert werden.

Diese Funktion ist nur dann erfolgreich ausführbar wenn die für das Fahrzeug konfigurierten Fachdienste eine Möglichkeit anbieten, Versionen SG-bezogen zu schreiben.

Achtung:

Nach fehlgeschlagenem Fachdienstaufruf (Rückgabewert Void) können alle Integrationsstände im ISOM-Phasenmodell (Fachobjekt Isom.Context.CurrentVehicleContext) zurückgesetzt (Void) sein.

  Isom.Context.CurrentVehicleContext currentContext = Isom.Context.CurrentVehicleContext.GetInstance(); 
  Isom.Context.EcuList versionEcus = currentContext.GetSoftwareVersionEcus(); 
  Isom.Context.Ecu master = versionEcus.At(0); // SoftwareVersionEcu mit höchster Priorität 
  currentContext.SetCurrentVersion("E060-06-09-520"); 
  master.DeployAllVersions(); 

Rückgabe:

Isom.Base.Boolean
'true' nach fachlich und technisch erfolgreichem Schreiben,
'false'bei fachlichem Fehlschlag des Schreibens (z.B. den Aufruf der Fachfunktion bevor Werte für die I-Stufen im ISOM-Objektmodell vorliegen)

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls ein technischer Fehler aufgetreten ist (z.B. Aufruf der Fachfunktion für Fahrzeuge, die keine Integrationsstände unterstützen)

Datum:

letzte Änderung am 30.03.2011 (Neueinführung mit BZ-11492)

Deaktiviert eine Funktion, die über den FSC identifiziert wird.

   Isom.Base.Boolean DoDeactivate(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Plan.ActivationCode fsc = action.GetActivationCode(); 
     if(ecu.DisableActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Parameter:

fsc

Freischaltcode

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Deaktivieren, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.Ecu.StoreActivationCode()

Isom.Context.Ecu.EnableActivationCode()

Isom.Context.Ecu.StoreAndEnableActivationCode()

Datum:

letzte Änderung am 05.01.2012

Schaltet eine Funktion mittels Freischaltcode (wenn notwendig) frei.

   Isom.Base.Boolean DoActivate(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Plan.ActivationCode fsc = action.GetActivationCode(); 
     if(ecu.StoreActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     if(ecu.EnableActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Parameter:

fsc

Freischaltcode

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Aktivieren, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.Ecu.StoreActivationCode()

Isom.Context.Ecu.StoreAndEnableActivationCode()

Isom.Context.Ecu.DisableActivationCode()

Datum:

letzte Änderung am 05.01.2012

Führt das Löschen von bestimmten Teilen des Steuergeräts im Expertenmodus aus.

Mit dieser Funktion ist es möglich, nur bestimmte Teile des Steuergerätes zu löschen. Die zu löschenden Teile können über den Parameter 'parts' als Isom.Context.LogicalUnitList mitgegeben werden. Der Fachdienst muss diese Funktionalität geeignet unterstützen. Der Aufruf ist derzeit nur innerhalb einer Aktionsausführung "EraseSoftwarePackage" zulässig, für die die Logistik die notwendigen Löschinformationen liefert.

Parameter:

parts

Beschreibung der zu löschenden Teile; darf nicht leer sein, sonst liefert die Funktion 'false' zurück.

Rückgabe:

Isom.Base.Boolean
'true', falls das Löschen erfolgreich war, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 08.08.2012

Führt die Flashprogrammierung des Steuergeräts im Komfortmodus aus.

Der Aufruf ist derzeit nur innerhalb einer Aktionsausführung "Flash" zulässig, für die die Logistik die notwendigen Flashinformationen liefert.

   Isom.Base.Boolean DoFlash(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     if(ecu.FlashComfort().Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls die Programmierung vollständig erfolgreich war, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Führt die Flashprogrammierung des Steuergeräts im Expertenmodus aus.

Damit ist es insbesondere auch möglich, ein Steuergerät auf einen alten Softwarezustand zu flashen. Der Aufruf ist derzeit nur innerhalb einer Aktionsausführung "Flash" zulässig, für die die Logistik die notwendigen Flashinformationen liefert.

   Isom.Base.Boolean DoFlash(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     if(ecu.FlashForced().Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls die Programmierung vollständig erfolgreich war, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Führt die Flashprogrammierung des Steuergeräts im Expertenmodus aus.

Mit dieser Funktion ist es möglich, nur bestimmte Teile des Steuergerätes zu programmieren. Die zu flashenden Teile können über den Parameter 'parts' als Isom.Base.StringList mitgegeben werden. Der Fachdienst muss diese Funktionalität geeignet unterstützen. Der Aufruf ist derzeit nur innerhalb einer Aktionsausführung "Flash" zulässig, für die die Logistik die notwendigen Flashinformationen liefert.

   Isom.Base.Boolean DoFlash(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Base.StringList parts = Isom.Base.StringList.CreateStringList(); 

     //Angabe der zu programmierenden Teile 

     if(ecu.FlashPartial(parts).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Parameter:

parts

Beschreibung der zu flashenden Teile; darf nicht leer sein, sonst liefert die Funktion 'false' zurück.

Rückgabe:

Isom.Base.Boolean
'true', falls die Programmierung erfolgreich war, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Liefert alle Freischaltcodes des Steuergeräts.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Plan.ActivationCodeList activationCodes = ecu.GetActivationCodes(); 

Rückgabe:

Isom.Plan.ActivationCodeList
Freischaltcodes des Steuergerätes.

Datum:

letzte Änderung am 19.07.2010

Liefert die Namen aller Eigenschaften dieses Steuergeräts.

Es werden die Eigenschaftsnamen sowohl für die technischen Eigenschaften (siehe Isom.Context.Ecu.GetProp()) als auch die Anzeigeeigenschaften (siehe Isom.Context.Ecu.GetDisplayProp()) zurückgeliefert.

Veraltet:

Wird seit Version 6.5.0.0 nur noch aus Kompatibilitätsgründen unterstützt. Der Abruf der Eigenschaftsnamen wird seitdem durch die Funktionen Isom.Context.Ecu.GetPropNames() und Isom.Context.Ecu.GetDisplayPropNames() bereitgestellt.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringList allPropNames = ecu.GetAllPropertyNames(); 

Rückgabe:

Isom.Base.StringList
Namen aller Eigenschaften dieses Steuergeräts

Siehe auch:

Isom.Context.Ecu.GetProp()

Isom.Context.Ecu.SetProp()

Isom.Context.Ecu.InvalidateProp()

Isom.Context.Ecu.GetPropNames()

Isom.Context.Ecu.GetDisplayPropNames()

Datum:

letzte Änderung am 19.07.2010

Ermittelt die Assoziation zu den im Steuergerät enthaltenen Teil-Steuergeräten.

(direkte Children-Beziehung).

  Isom.Context.Ecu parent = Isom.Context.Ecu.CreateNewByAddress("222"); 
  Isom.Context.EcuList children = parent.GetAssemblingChildren(); 

Rückgabe:

Isom.Context.EcuList
Liste der Teil-Steuergeräte.

Datum:

letzte Änderung am 19.07.2010

Fragt das Steuergerät (oder den Steuergeräteteil) ab, welches das Steuergerät laut ISOM-Aggregatmodellierung unmittelbar enthält.

Dieses wird typischerweise bei der Contextermittlung bestimmt. Die Aggregatmodellierung der Logistikdienste kann ggf. abweichen. Die ISOM-Aggregatmodellierung repräsentiert die Werkstattsicht.

  Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
  Isom.Context.Ecu parent = ecu.GetAssemblingParent(); 

Rückgabe:

Isom.Context.Ecu
Das Aggregat-Steuergerät, welches das aktuelle Steuergerät enthält.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Steuergerät nicht Teil eines Aggregat-Steuergeräts ist.

Datum:

letzte Änderung am 19.07.2010

Fragt den Basisvarianten-Namen des Steuergeräts ab.

Die Basisvariante benennt typischerweise die Funktion eines Steuergeräts an einer Verbauadresse. Die bei der Identifizierung systemtechnisch gesetzte Basisvariante entstammt typischerweise der ISOM-Fahrzeugbeschreibung.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String baseVariant = ecu.GetBaseVariant(); 

Rückgabe:

Isom.Base.String
Basisvarianten-Name (in Großschreibung).

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Basisvarianten-Name noch nicht ermittelt oder leer ist.

Siehe auch:

Isom.Context.Ecu.SetBaseVariant()

Datum:

letzte Änderung am 19.07.2010

Ermittelt die Liste der Codiernamen.

Die Codiernamen eines Steuergeräts sind Teil der ISOM-Fahrzeugbeschreibung.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringList codingNames = ecu.GetCodingNames(); 

Rückgabe:

Isom.Base.StringList
Liste der Codiernamen; leere Liste bei nicht codierbaren Steuergeräten.

Datum:

letzte Änderung am 19.07.2010

Fragt die Codierreihenfolge für dieses Steuergerät ab

Die Codierreihenfolge eines Steuergeräts ist Teil der ISOM-Fahrzeugbeschreibung.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.Number codingSequence = ecu.GetCodingSequence(); 

Rückgabe:

Isom.Base.Number
Codierreihenfolge.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Codierreihenfolge nicht ermittelt werden konnte.

Siehe auch:

Isom.Context.Ecu.SetCodingSequence()

Datum:

letzte Änderung am 19.07.2010

Liefert die durch die ISOM-Fahrzeugbeschreibung zugeordnete Liste der Namen aller Busse, an die das Steuergerät angeschlossen ist unter Beachtung der zum Zeitpunkt des Aufrufs gültigen Bustopologie.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringList busNames = ecu.GetConnectedBuses(); 
   while(busNames.HasNext()) 
   { 
     //.. 
   } 

Rückgabe:

Isom.Base.StringList
Liste der Namen aller Busse, an die das Steuergerät angeschlossen ist

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls diese Information nicht ermittelt werden konnte.

Datum:

letzte Änderung am 19.07.2010

Fragt den Diagnose-Namen des Steuergeräts ab.

Der Diagnose-Name wird auch als Variantenname des Steuergerätes bezeichnet.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String dn = ecu.GetDiagName(); 

Rückgabe:

Isom.Base.String
"Diagnose-Name" des Steuergeräts (in Großschreibung).

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Diagnose-Name noch nicht ermittelt oder leer ist.

Siehe auch:

Isom.Context.Ecu.SetDiagName()

Isom.Context.Ecu.GetPossibleVariants() liefert mögliche Variantennamen eines Steuergeräts.

Datum:

letzte Änderung am 19.07.2010

Fragt den optional in der ISOM-Fahrzeugbeschreibung gesetzten Anzeigenamen des Steuergerätes ab.

Wenn für eine Variante kein Anzeigename definiert ist, wird der Anzeigename der Basisvariante zurückgegeben. Wenn für eine Basisvariante kein Anzeigename definiert ist, wird der Name der Basisvariante zurückgegeben.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String displayName = ecu.GetDisplayName(); 

Rückgabe:

Isom.Base.String
Anzeigename des Steuergeräts laut ISOM-Fahrzeugbeschreibung.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls kein Anzeigename ermittelt werden konnte

Datum:

letzte Änderung am 19.07.2010

Ermittelt den Wert der vorgegebenen Anzeigeeigenschaft für das Steuergerät.

Die unterstützen Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String val = ecu.GetDisplayProp("DisplayProp1"); 

Parameter:

propName

Name der Anzeigeeigenschaft

Rückgabe:

Isom.Base.String
Wert der Anzeigeeigenschaft.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Wert ungesetzt oder gleich "" ist.

Siehe auch:

Isom.Context.Ecu.SetDisplayProp()

Datum:

letzte Änderung am 19.07.2010

Liefert die Namen aller Anzeige-Eigenschaften des Steuergeräts.

Es werden die Eigenschaftsnamen für die Anzeige-Eigenschaften (siehe Isom.Context.Ecu.GetDisplayProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Boolean DoFlash ( TherapyPlanAction action ) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Base.StringList displayPropertyNames = ecu.GetDisplayPropNames(); 
     displayPropertyNames.Reset(); 
     while(displayPropertyNames.HasNext()) 
     { 
       //Abfrage des Werts für den gelieferten Eigenschaftsnamen und z. B. Aufzeichnung ins Protokoll 
     } 

     //Aktionsausführung 

     return true; 
   } 

Rückgabe:

Isom.Base.StringList
Liste der Namen aller Anzeige-Eigenschaften des Steuergeräts.

Siehe auch:

Isom.Context.Ecu.GetDisplayProp()

Datum:

letzte Änderung am 09.09.2010

Liefert das Wörterbuch zu einem Fehlerspeichereintrag mit der übergebenen Fehler-ID.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringDictionary entry = ecu.GetDtc("1"); 

Parameter:

errorID

Gibt den Identifikator des Fehlers an. Dies kann z.B. die Fehlernummer sein.

Rückgabe:

Isom.Base.StringDictionary
Wörterbuch des Fehlerspeichereintrags.

Datum:

letzte Änderung am 19.07.2010

Liefert alle Fehler-IDs (Fehlernummern) des Steuergeräts.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringList errIdentifiers = ecu.GetDtcIdentifiers(); 

Rückgabe:

Isom.Base.StringList
Liste der Fehlerspeichereinträge in Dezimaldarstellung.

Datum:

letzte Änderung am 19.07.2010

Fragt die Steuergeräteadresse des Steuergeräts ab, auch als Verbauadresse bezeichnet.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String addr = ecu.GetEcuAddress(); //liefert "64" 

Rückgabe:

Isom.Base.String
Steuergeräteadresse.

Datum:

letzte Änderung am 19.07.2010

Fragt den mit der Annotation [EcuText(..)] gesetzten Anzeigenamen des Steuergeräts ab.

Als Schlüssel wird der Gruppenname des Steuergerätes verwendet.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String txt = ecu.GetEcuText(); 

Rückgabe:

Isom.Base.String
Mit Annotation [EcuText(..)] gesetzter Anzeigename des Steuergeräts.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls kein Anzeigename ermittelt werden konnte

Datum:

letzte Änderung am 19.07.2010

Ermittelt die Liste aller mit der Annotation [EditableEcuAction(..)] markierten Steuergeräte-bezogenen Aktionen.

Die nicht Steuergeräte-bezogenen Aktionen lassen sich über Isom.Plan.TherapyPlan.GetEditableActions() ermitteln.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Plan.TherapyPlanActionList list = ecu.GetEditableActions(); 
   while(list.HasNext()) 
   { 
     //.. 
   } 

Rückgabe:

Isom.Plan.TherapyPlanActionList
Liste aller Steuergeräte-bezogenen hinzufügbaren Aktionen.

Datum:

letzte Änderung am 19.07.2010

Ermittelt das Gateway eines Steuergeräts.

Veraltet:

Entfernt seit Argonaut Version 1.10. Diese Funktion ist nicht mehr Bestandteil der Fachklasse "Ecu".

Mit der Einführung von mehrfach erreichbaren Steuergeräten, die gleichzeitig an mehrere Busse angeschlossen sind, ist die Zuordnung eines Steuergeräts zu einem Gateway nicht mehr eindeutig. Eine eindeutige Zuordnung besteht nur noch zwischen einem Bus und seinem Gateway. Die Funktion 'GetGateway()' wurde daher aus der Fachklasse 'Ecu' entfernt. Stattdessen kann der Fachautor Aufrufe von 'Ecu.GetConnectedBuses()' und 'CurrentVehicleContext.GetGatewayByBus()' bzw. 'FutureVehicleContext.GetGatewayByBus()' kombinieren, um an die entsprechenden Informationen zu gelangen, wie das nachfolgende Beispiel zeigt.

Verwendungsbeispiel:

   // *** ohne Verwendung von 'GetGateway()' die Liste aller Gateways 
   //     eines Steuergeräts bestimmen *** 

   // Steuergerät, dessen Gateways bestimmt werden sollen 
   Ecu checkEcu = // ... 
   // Ist-Kontext holen 
   CurrentVehicleContext currentContext = CurrentVehicleContext.GetInstance(); 
   // Liste aller verbundenen Busse bestimmen 
   StringList connectedBuses = checkEcu.GetConnectedBuses(); 
   EcuList gatewayList = EcuList.CreateNew(); // Liste der Gateways anlegen 
   connectedBuses.Reset(); 
   while(connectedBuses.HasNext()) 
   { 
      String busName = connectedBuses.Next(); 
      Ecu gateway = currentContext.GetGatewayByBus(busName); 
      if(gateway.IsVoid()) 
      { 
          // Steuergerät "checkEcu" ist direkt an den Fahrzeugzugang 
          // angeschlossen 
          // ... 
      } 
      else 
      { 
          // Steuergerät des betrachteten Busses zu Liste hinzufügen 
          gatewayList.Insert(gateway); 
      } 
   } 
   // "gatewayList" enthält jetzt die Gateway-Steuergeräte der Busse, 
   // an denen "checkEcu" direkt angeschlossen ist 

Fragt den Namen der Diagnosegruppendatei des Steuergeräts ab.

Er wird typischerweise zur Adressierung von Steuergeräte-Basisvarianten in EDIABAS-Aufrufen verwendet.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String dg = ecu.GetGroupName(); 

Veraltet:

Ist spezifisch für das Laufzeitsystem EDIABAS und wird seit Version 15 von Argonaut nur noch aus Kompatibilitätsgründen unterstützt; Aufruf sollte ersetzt werden durch Aufruf von Isom.Context.Ecu.GetProp("GroupName").

Rückgabe:

Isom.Base.String
Name der Diagnosegruppendatei (in Großschreibung).

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Diagnose-Gruppendatei noch nicht ermittelt oder leer ist.

Siehe auch:

Isom.Context.Ecu.SetGroupName()

Datum:

letzte Änderung am 19.07.2010

Liefert die Liste der logischen Einheiten eines Steuergeräts

Es wird eine flache Kopie geliefert, d.h. Änderungen der Liste wirken nicht auf die Liste logischer Einheiten des Steuergeräts. Änderungen an logischen Einheiten in der Liste wirken dagegen auf die logischen Einheiten des Steuergeräts.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   //Prüfung auf vorhandenen logische Einheiten 
   Isom.Context.LogicalUnitList logicalUnitsFromEcu = ecu.GetLogicalUnits(); 

Rückgabe:

Liste der logischen Einheiten des Steuergeräts Die Liste kann leer sein, aber nicht das Void-Objekt

Gibt das logische Fahrzeug zurück, in dem das Steuergerät enthalten ist.

Rückgabe:

Isom.Context.LogicalVehicle
logische Fahrzeug des Steuergeräts entsprechend ISOM-Fahrzeugbeschreibung.

Seit:

Eingeführt mit BZ-12385/BZ-12497/WA-588-5637 (Mischbordnetze).

Datum:

letzte Änderung am 23. 08 .2011

Fragt den Bestelltyp dieses Steuergerätes ab.

Der Bestelltyp wird in der ISOM-Fahrzeugbeschreibung für die Variante des Steuergeräts angegeben. Dementsprechend liegt diese Information erst vor, wenn die Variante bestimmt wurde.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String orderType = ecu.GetOrderType(); 
   if(orderType.IsVoid().Not()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.String
Bestelltyp als Zeichenkette.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Wert nicht ermittelbar ist.

Datum:

letzte Änderung am 19.07.2010

Fragt alle möglichen Teil-Steuergeräte ab, die das Steuergerät laut ISOM-Fahrzeugbeschreibung enthalten kann.

(direkte Children-Beziehung).

  Isom.Context.Ecu parent = Isom.Context.Ecu.CreateNewByAddress("222"); 
  Isom.Context.EcuList children = parent.GetPossibleAssemblingChildren(); 

Rückgabe:

Isom.Context.EcuList
Mögliche Teil-Steuergeräte dieses Steuergeräts; eine leere Liste, wenn dieses Steuergerät kein Aggregat ist.

Datum:

letzte Änderung am 19.07.2010

Fragt alle möglichen zusammengesetzten SG ab, die das aktuelle SG laut ISOM-Fahrzeugbeschreibung enthalten können (direkte Parent-Beziehung).

  Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
  Isom.Context.EcuList parents = ecu.GetPossibleAssemblingParents(); 

Rückgabe:

Isom.Context.EcuList
Liste von Aggregat-Steuergeräten, die die das aktuelle SG laut ISOM-Fahrzeugbeschreibung enthalten können.

Datum:

letzte Änderung am 19.07.2010

Liefert die durch die ISOM-Fahrzeugbeschreibung zugeordnete Liste möglicher L-Kanäle für das Steuergerät.

Eventuelle, per Isom.Context.ContextConfiguration.SetDefaultLChannels() gesetzte Globalvorgaben werden filternd berücksichtigt.

   Isom.Base.Boolean FilterFlash( TherapyPlanAction action ) 
   { 
     Isom.Base.StringList channels = action.GetEcu().GetPossibleLChannels(); 
     action.SetPossibleLChannels( channels ); 
     //.. 
     return true; 
    } 

Rückgabe:

Isom.Base.StringList
Liste möglicher L-Kanäle laut ISOM-Fahrzeugbeschreibung.

Datum:

letzte Änderung am 19.07.2010

Fragt ab, welche Varianten für das Steuergerät laut ISOM-Fahrzeugbeschreibung möglich sind.

  Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
  Isom.Context.EcuList variantList = ecu.GetPossibleVariants(); 

Rückgabe:

Isom.Context.EcuList
Liste aller möglichen Varianten.

Datum:

letzte Änderung am 19.07.2010

Fragt die Codierabklingzeit für eine Codiereinheit dieses Steuergerätes ab.

Die Codierabklingzeiten eines Steuergeräts sind Teil der ISOM-Fahrzeugbeschreibung.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.Number postCodingDelay = ecu.GetPostCodingDelay("MOTOR_CODE_1"); 

Parameter:

codeName

value Name der Codiereinheit

Rückgabe:

Isom.Base.Number
Codierabklingzeit.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Codierabklingzeit nicht ermittelt werden konnte.

Siehe auch:

Isom.Context.Ecu.SetPostCodingDelay()

Datum:

letzte Änderung am 19.07.2010

Ermittelt den primären Bus des Steuergeräts

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String primaryBus = ecu.GetPrimaryBus(); 
   if(primaryBus.IsVoid().Not()) 
   { 
     // Bearbeitung mit dem primären Bus 
   } 

Rückgabe:

Isom.Base.String
Name des primären Buses

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der primäre Bus des Steuergeräts nicht definiert ist.

Datum:

letzte Änderung am 14.03.2012

Ermittelt den Wert der vorgegebenen Eigenschaft (Property) für das Steuergerät.

Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden. Wenn der Wert für <propName> ungesetzt ist und <propName> kein : enthält, wird zusätzlich noch nach einem Wert <propName>:ByIsom gesucht und dieser im Erfolgsfall zurückgeliefert. Dies dient einem transparenten Rückfall auf von ISOM vorausberechnete Werte, wenn ein qualifizierter Wert für <propName> nicht ermittelbar ist. Dieses Verhalten kann unterdrückt werden, indem an <propName> ein : als letztes Zeichen angehängt wird.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String val = ecu.GetProp("PartNumber"); 

Parameter:

propName

Name der Eigenschaft

Rückgabe:

Isom.Base.String
Wert der Eigenschaft.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Wert ungesetzt oder gleich "" ist.

Siehe auch:

Isom.Context.Ecu.SetProp()

Isom.Context.Ecu.GetAllPropertyNames()

Isom.Context.Ecu.InvalidateProp()

Datum:

letzte Änderung am 19.07.2010

Liefert die Namen aller technischen Eigenschaften des Steuergeräts.

Es werden die Eigenschaftsnamen für die technischen Eigenschaften (siehe Isom.Context.Ecu.GetProp()) zurückgeliefert. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Base.Boolean DoFlash (Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Base.StringList propertyNames = ecu.GetPropNames(); 
     propertyNames.Reset(); 
     while(propertyNames.HasNext()) 
     { 
       //Abfrage des Werts für den gelieferten Eigenschaftsnamen und z. B. Aufzeichnung ins Protokoll 
     } 

     //Aktionsausführung 

     return true; 
   } 

Rückgabe:

Isom.Base.StringList
Liste der Namen aller technischen Eigenschaften des Steuergeräts.

Siehe auch:

Isom.Context.Ecu.GetProp()

Datum:

letzte Änderung am 09.09.2010

Liefert das Protokoll zur Kommunikation mit dem Steuergerät.

Die Funktion liefert das in der Fahrzeugbeschreibung der eingestellten Baureihengruppe angegebene Protokoll zur Kommunikation mit dem Steuergerät.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("42"); 
   Isom.Base.String protocol = ecu.GetProtocol(); 
   if(protocol.IsVoid().Not()) 
   { 
       //... 
   } 

Rückgabe:

Isom.Base.String
Protokoll als Zeichenkette

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Protokoll nicht ermittelt werden kann.

Datum:

letzte Änderung am 11.06.2010

Fragt die Steuergeräte-Zustände in allen State-Kategorien (Zustandsautomaten) ab.

Es werden die vollqualifizierten Namen aller Zustände geliefert.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.GetStates(false).Contains( "Isom.Flash.BaseEcu"))  // Grundsteuergerät 
   { 
     //.. 
   } 

Parameter:

includeUnknown

'... .UNKNOWN'-Zustände werden unterdrückt, falls 'false'

Rückgabe:

Isom.Base.StringList
Die vollqualifizierten Zustände in allen State-Kategorien.

Siehe auch:

Isom.Context.Ecu.SetState()

Isom.Context.Ecu.IsInState()

Datum:

letzte Änderung am 19.07.2010

Identifiziert ein Steuergerät durch Kommunikation mit dem Fahrzeug.

Danach werden die Informationen zum identifizierten Steuergerät aus der der ISOM-Fahrzeugbeschreibung gelesen und in das Fachobjekt übertragen. Typischerweise sind danach alle Diagnoseinformationen des Ist-Zustandes gesetzt.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress( "18" ); 
   if (ecu.Identify().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true', wenn mindestens eine Basisidentifikation erfolgreich war, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Nachbedingung:

Zustand 'Isom.Identify.FullyIdentified' oder 'Isom.Identify.PartiallyIdentified' oder 'Isom.Identify.Failed'.

Zustand 'Isom.Communication.Responding' oder Isom.Communication.NotResponding.

Datum:

letzte Änderung am 19.07.2010

Löscht die vorgegebene Eigenschaft (Property) für das Steuergerät unter Umgehung des Überschreibschutzes für Steuergeräte der Ist-Sg-Liste

Ein Aufruf für nicht im Istkontext vorhandene Steuergeräte ist zulässig und gleichwertig zu Isom.Context.Ecu.SetProp(). Das Rücksetzen einer Steuergeräte-Eigenschaft (property) wirkt sich konventionsmäßig immer auf alle im System bekannten Fahrzeug-Kontexte aus (transparentes Autoren-Property-Modell), d.h. autorengesetzte Eigenschaften haben globalen Charakter und unterliegen keiner Einfügehistorie. Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   ecu.InvalidateProp("PartNumber"); 

Parameter:

propName

Name der Eigenschaft

Rückgabe:

Isom.Base.Boolean
Immer 'true'

Siehe auch:

Isom.Context.Ecu.GetProp()

Isom.Context.Ecu.SetProp()

Isom.Context.Ecu.GetAllPropertyNames()

Datum:

letzte Änderung am 19.07.2010

Ermittelt, ob das Steuergerät codierbar ist.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.IsCodeable()) 
   { 
     //.. 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls das Steuergerät codierbar ist, 'false' sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Identifikationsdaten nicht ausreichen, um die Codierbarkeit zu ermitteln

Datum:

letzte Änderung am 19.07.2010

Ermittelt, ob das Steuergerät programmierbar ist.

Dafür wird geprüft, ob in der ISOM-Fahrzeugbeschreibung eine FlashInfo angegeben ist. Eventuell im SG hinterlegte Zähler/Beschränkungen für Programmiervorgänge werden nicht ausgewertet. Wenn die Diagnoseinformationen noch nicht genügen, um die Variante zu identifizieren, wird 'true' zurückgegeben, 'false' wenn alle Varianten flashbar sind bzw. falls alle Varianten nicht flashbar sind. Ansonsten wird 'Void' zurückgegeben.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.IsFlashable()) 
   { 
     //.. 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls das Steuergerät eindeutig programmierbar ist, 'false' falls das Steuergerät eindeutig nicht programmierbar ist

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Identifikationsdaten nicht ausreichen, um die Programmierbarkeit zu ermitteln

Datum:

letzte Änderung am 19.07.2010

Prüft, ob sich der vorgegebene Zustandsautomat im angegebenen Zustand befindet.

Dies ist eine Bequemlichkeitsfunktion für

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.GetStates(true).Contains("Isom.Flash.BaseEcu")) // Grundsteuergerät 
   { 
     //.. 
   } 

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.IsInState("Isom.Flash.BaseEcu")) // Grundsteuergerät 
   { 
     //.. 
   } 

Parameter:

newState

vollqualifizierter Zustandsname.

Rückgabe:

Isom.Base.Boolean
'true', wenn sich der vorgegebene Zustandsautomat im angegebenen Zustand befindet.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der Zustandsautomat nicht existiert.

Siehe auch:

Isom.Context.Ecu.GetStates()

Isom.Context.Ecu.SetState()

Datum:

letzte Änderung am 19.07.2010

Bestimmt, ob es sich um ein Routing-Steuergerät handelt.

Ein Steuergerät ist ein Router-Steuergerät, wenn es:

• laut aktueller Bustopologie an mehr als einen Bus angeschlossen ist
• laut ISOM-Fahrzeugbeschreibung Routing-Fähigkeiten aufweist

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.Boolean isRouter = ecu.IsRouter(); 
   if(isRouter) 
   { 
     // Sonderbehandlung für Routing-SG ... 
   } 

Rückgabe:

Isom.Base.Boolean
'true', wenn es sich um ein Routing-Steuergerät handelt

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Routing-Fähigkeiten des Steuergeräts nicht ermittelt werden konnte.

Datum:

letzte Änderung am 19.07.2010

Bestimmt, ob die Aufrufinstanz das Void-Objekt ist.

Das Void-Objekt kann z. B. bei Funktionsaufrufen geliefert werden, um einen Fehler anzuzeigen.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   //Prüfung auf Void 
   if (ecu.IsVoid()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true', falls dies das Void-Objekt ist, 'false' sonst

Datum:

letzte Änderung am 20.07.2010

Bestimmt Logistikdaten für typische Aktionen auf diesem Steuergerät.

Typischerweise wird für das Steuergeräte-Objekt über die konfigurierten Logistik-Fachdienste ein Logistikplan berechnet, welcher Tausch- und Programmierinformationen für das Steuergerät beinhaltet. Die Ergebnisse werden als logische Einheiten mit dem Zustand "Isom.Source.Logistics" in die vorgegebenen Steuergeräte-Datenobjekte eingetragen. Eigenschaftsnamen und Spezifika der jeweiligen Fachdienste sind im herstellerspezifischen Begleitdokument beschrieben.

Die Funktion ist primär für Anwendungsfälle gedacht, in denen die Ist-Verbauinformation durch Fahrzeugkommunikation nicht hinreichend ermittelt werden kann, z.B. aufgrund eines nicht antwortenden Gateway-Steuergeräts.

Konventionsmäßig erfolgt der Aufruf mit

• dem Ist-Fahrzeugauftrag und
• dem vom Autor gesetzten Soll-I-Level (wenn gesetzt) beziehungsweise dem über Logistik automatisch ermittelten Soll-I-Level (sonst)

Zu beachten:

Durch die Logistikberechnung kann ein mehrfacher Aufruf (beispielsweise für zahlreiche Steuergeräte) zeitaufwändig sein.

Im Codebeispiel werden die Steuergeräte des Soll-Kontext (Isom.Context.FutureVehicleContext) verwendet. Dieses Vorgehen ist deswegen zu bevorzugen, weil Aktionen als assoziiertes Steuergerät (Isom.Plan.TherapyPlanAction.GetEcu()) immer ein Steuergerät des Soll-Kontext verwenden. Werden stattdessen Steuergeräte des Ist-Kontext befüllt und dann Aktionen für diese Steuergeräte eingeplant, stehen die von Isom.Context.Ecu.QueryLogistics() berechneten Properties in dem durch Isom.Plan.TherapyPlanAction.GetEcu() gelieferten Steuergerät unter Umständen nicht zur Verfügung.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.QueryLogistics().Failed()) 
   { 
     // Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreicher Ermittlung aller Logistikinformation, 'false' sonst.

Datum:

letzte Änderung am 29.03.2012

Liest alle Fehlerspeichereinträge im Steuergerät.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.ReadDtc().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Lesen

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, wenn die Fehlerspeicher nicht ausgelesen werden konnten

Siehe auch:

Isom.Context.CurrentVehicleContext.ReadDtcFromAllEcus() für funktional adressiertes/sequentielles Lesen von Fehlerspeichereinträgen.

Isom.Context.Dtc.ReadDetails() für logisch adressiertes Lesen von Fehlerspeichereinträgen.

Datum:

letzte Änderung am 19.07.2010

Liest eine Repräsentation der Fahrzeugkonfiguration aus dem Steuergerät.

   Isom.Context.CurrentVehicleContext cvc = Isom.Context.CurrentVehicleContext.GetInstance(); 
   Isom.Context.EcuList vcEcus = cvc.GetVehicleConfigurationEcus(); 
   while (vcEcus.HasNext()) 
   { 
     Isom.Context.Ecu vcEcu = vcEcus.Next(); 
     Isom.Context.VehicleOrder vo = vcEcu.ReadVehicleOrder(); 
     //.. 
   } 

Rückgabe:

Isom.Context.VehicleOrder
Gelesene Fahrzeugkonfiguration als Instanz der Fachklasse Isom.Context.VehicleOrder.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die notwendigen Fahrzeug-Metadaten nicht ermittelbar sind.

Es wird das Void-Objekt zurückgegeben, falls das Steuergerät keine Fahrzeugkonfiguration trägt.

Es wird das Void-Objekt zurückgegeben, falls die Fahrzeugkonfiguration nicht gelesen werden konnte.

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Ermittlung der Identifikatoren der Softwarestände (Build-, Historical-,Current-) für das Fahrzeug aus dem informationstragenden Steuergerät.

Ermittelt den aktuellen Identifikator des Softwarestands, den Identifikator beim Bau des Fahrzeugs und den Identifikator des Softwarestands vor der letzten Aktualisierung. Aktualisiert im Erfolgsfall den CurrentVehicleContext.

Zu beachten:

Sollte nur für Steuergeräte aufgerufen werden, die im ISOM-Fahrzeugmodell als versionstragend modelliert sind und infolgedessen von der Fachfunktion Isom.Context.CurrentVehicleContext.GetSoftwareVersionEcus() zurückgeliefert werden.

Diese Funktion ist nur dann erfolgreich ausführbar wenn die für das Fahrzeug konfigurierten Fachdienste eine Möglichkeit anbieten, Versionen SG-bezogen zu lesen.

  Isom.Context.CurrentVehicleContext currentContext = Isom.Context.CurrentVehicleContext.GetInstance(); 
  Isom.Context.EcuList versionEcus = currentContext.GetSoftwareVersionEcus(); 
  Isom.Context.Ecu master = versionEcus.At(0); // SoftwareVersionEcu mit höchster Priorität 
  master.ReadVersions(); 
  Isom.Base.String currentVersion = currentContext.GetCurrentVersion(); // z.B. "E060-06-09-520" 

Rückgabe:

Isom.Base.Boolean
'true' wenn das Lesen der Identifikatoren erfolgreich war;
'false' sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die notwendigen Fahrzeug-Metadaten nicht ermittelbar sind.

Es wird das Void-Objekt zurückgegeben, falls das Steuergerät keine Fahrzeugkonfiguration trägt.

Es wird das Void-Objekt zurückgegeben, falls die Fahrzeugkonfiguration nicht gelesen werden konnte.

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.CurrentVehicleContext.GetCurrentVersion für Zugriff auf den aktuellen Integrationsstand

Isom.Context.CurrentVehicleContext.GetBuildVersion für Zugriff auf den Bau-Integrationsstand

Isom.Context.CurrentVehicleContext.GetHistoricalVersion für Zugriff auf den Backup-Integrationsstand

Isom.Context.CurrentVehicleContext.ReadVersions für Fahrzeug-bezogenes Lesen

Datum:

letzte Änderung am 30.03.2011 (Neueinführung mit BZ-11492)

Ruft einen benannten Sonderprozess auf.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress( "64" ); 
   Isom.Base.String processName = "ExampleProcess"; 
   Isom.Base.StringDictionary args = Isom.Base.StringDictionary.CreateStringDictionary(); 

   //Angabe der vom Sonderprozess benötigten Argumente 

   Isom.Base.StringDictionary result = ecu.RunProcess(processName, args); 

Parameter:

	processName	Name des aufgerufenen Sonderprozesses
	arguments	Argumente des Aufrufs

Rückgabe:

Isom.Base.StringDictionary
Ein prozessspezifisches Wörterbuch der Aufrufergebnisse.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, wenn der aufgerufene Sonderprozess nicht implementiert ist.

Es wird das Void-Objekt zurückgegeben, wenn der aufgerufene Sonderprozess fehlgeschlagen ist.

Datum:

letzte Änderung am 19.07.2010

Setzt die Assoziation zu den im Steuergerät enthaltenen Teil-Steuergeräten.

(direkte Children-Beziehung).

  Isom.Context.Ecu parent = Isom.Context.Ecu.CreateNewByAddress("222"); 
  Isom.Context.EcuList children = EcuList.CreateNew(); 

  //Befüllen der Liste 'children' mit den Teil-Steuergeräten 

  parent.SetAssemblingChildren(children); 

Rückgabe:

Isom.Base.Boolean
'true' im Erfolgsfall, 'false' sonst

Datum:

letzte Änderung am 19.07.2010

Setzt die Assoziation zum enthaltenden Aggregat-Steuergerät (direkte Parent-Beziehung).

  Isom.Context.Ecu  = Isom.Context.Ecu.CreateNewByAddress("222"); 
  Isom.Context.Ecu child = Isom.Context.Ecu.CreateNewByAddress("11"); 
  child.SetAssemblingParent(parent); 

Parameter:

ecu

Zu setzendes Aggregat-Steuergerät

Rückgabe:

Isom.Base.Boolean
'true' im Erfolgsfall, 'false' sonst.

Datum:

letzte Änderung am 19.07.2010

Setzt den Basisvarianten-Namen des Steuergeräts.

Bisher ungesetzte Steuergeräte-Eigenschaften werden anhand der Informationen aus der ISOM-Fahrzeugbeschreibung aktualisiert.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.SetBaseVariant("MOTOR").Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

newBaseVariant

Neuer Basisvarianten-Name oder String.Void(), um diesen zurückzusetzen.

Rückgabe:

Isom.Base.Boolean
immer 'true'

Siehe auch:

Isom.Context.Ecu.GetBaseVariant()

Datum:

letzte Änderung am 19.07.2010

Setzt die Codierreihenfolge für dieses Steuergerät.

Mit der Funktion lassen sich aus der ISOM-Fahrzeugbeschreibung ausgelesene Werte überschreiben.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.SetCodingSequence(1).Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

value

value Codierreihenfolge

Rückgabe:

Isom.Base.Boolean
'true', falls die Codierreihenfolge erfolgreich gesetzt wurde, 'false' sonst

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Codierreihenfolge nicht gesetzt werden konnte.

Siehe auch:

Isom.Context.Ecu.GetCodingSequence()

Datum:

letzte Änderung am 19.07.2010

Setzt den Diagnose-Namen des Steuergeräts.

Bisher ungesetzte Steuergeräte-Eigenschaften werden anhand der Informationen aus der ISOM-Fahrzeugbeschreibung aktualisiert. Der Diagnosename wird auch als Varianten-Name des Steuergeräts bezeichnet.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.SetDiagName("MOTOR_VARIANT_1").Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

newDiagName

Neuer Variantenname oder String.Void(), um den Variantennamen zurückzusetzen.

Rückgabe:

Isom.Base.Boolean
immer 'true'

Siehe auch:

Isom.Context.Ecu.GetDiagName()

Isom.Context.Ecu.GetPossibleVariants() liefert mögliche Variantennamen eines Steuergeräts.

Datum:

letzte Änderung am 19.07.2010

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Steuergerät.

Setzt den Wert der vorgegebenen Anzeigeeigenschaft für das Steuergerät. Die unterstützen Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden. Das Setzen einer Steuergeräte-Anzeigeigenschaft (DisplayProperty) wirkt sich konventionsmäßig immer auf alle im System bekannten Fahrzeug-Kontexte aus (transparentes Autoren-Property-Modell), d.h. autorengesetzte Eigenschaften haben globalen Charakter und unterliegen keiner Einfügehistorie.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   ecu.SetDisplayProp("EcuType", "Test"); 

Parameter:

	propName	Name der Eigenschaft
	propName	Neuer Wert der Eigenschaft

Rückgabe:

Isom.Base.Boolean
Immer 'true'

Siehe auch:

Isom.Context.Ecu.GetDisplayProp()

Datum:

letzte Änderung am 19.07.2010

Setzt für das Steuergerät einen Fehlerspeichereintrag.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.StringDictionary errorInfo = Isom.Base.StringDictionary.CreateStringDictionary(); 

   //Befüllen von 'errorInfo' 

   if(ecu.SetDtc("1", errorInfo).Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

	errorID	Gibt den Identifikator des Fehlers an. Dies kann z.B. die Fehlernummer sein.
	errorInfo	Enthält weitere Informationen, die den Fehler genauer beschreiben.

Rückgabe:

Isom.Base.Boolean
'true', falls der Fehlerspeichereintrag erfolgreich gesetzt wurde.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Fehlerspeichereinträge nicht gesetzt werden konnten.

Datum:

letzte Änderung am 19.07.2010

Setzt den Namen der Diagnosegruppendatei des Steuergeräts.

Er wird typischerweise zur Adressierung von Steuergeräte-Basisvarianten in EDIABAS-Aufrufen verwendet.

Veraltet:

Ist spezifisch für das Laufzeitsystem EDIABAS und wird seit Version 15 von Argonaut nur noch aus Kompatibilitätsgründen unterstützt; Aufruf sollte ersetzt werden durch Aufruf von Isom.Context.Ecu.SetProp("GroupName").

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.SetGroupName("D_MOTOR").Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

newGroupName

Neuer Namen der Diagnosegruppendatei oder Void, um diesen zurückzusetzen.

Rückgabe:

Isom.Base.Boolean
immer 'true'

Siehe auch:

Isom.Context.Ecu.GetGroupName()

Datum:

letzte Änderung am 19.07.2010

Legt die Liste der logischen Einheiten eines Steuergeräts fest.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   //Liste von logischen Einheiten erzeugen 
   Isom.Context.LogicalUnitList logicalUnitList = Isom.Context.LogicalUnitList.CreateNew(); 
   //EdmIds als Zeichenkette 
   Isom.Base.String edmids = "btld_00000894-004_000_000,swfl_00000895-006_000_006,cafd_00000896-006_006_001,hwel_000008b0-002_005_001"; 
   Isom.Base.StringList edmIdsList = edmids.Split(","); 
   edmIdsList.Reset(); 
   while(edmIdsList.HasNext()) 
   { 
       Isom.Context.LogicalUnit logicalUnit = Isom.Context.LogicalUnit.ParseSgbmId(edmIdsList.Next()); 
       logicalUnitList.Insert(logicalUnit); 
   } 
   //logische Einheiten im Steuergerät setzen 
   if(ecu.SetLogicalUnits(logicalUnitList).Failed()) 
   { 
       //Fehlerbehandlung 
   } 

Parameter:

logicalUnits

Liste logischer Einheiten des Steuergeräts

Rückgabe:

true, wenn die Liste logischer Einheiten festgelegt wurde

Setzt die Codierabklingzeit für eine Codiereinheit dieses Steuergerätes.

Mit der Funktion lassen sich aus der ISOM-Fahrzeugbeschreibung ausgelesene Werte überschreiben.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   if(ecu.SetPostCodingDelay("MOTOR_CODE_1", 100).Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

	codeName	Name der Codiereinheit
	value	Codierreihenfolge

Rückgabe:

Isom.Base.Boolean
'true', falls die Codierabklingzeit erfolgreich gesetzt wurde, 'false' sonst

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die Codierabklingzeit nicht gesetzt werden konnte.

Siehe auch:

Isom.Context.Ecu.GetPostCodingDelay()

Datum:

letzte Änderung am 19.07.2010

Setzt den Wert der vorgegebenen Eigenschaft (Property) für das Steuergerät.

Die systemseitig ermittelten Eigenschaftsnamen sind in den herstellerspezifischen Begleitdokumenten zu finden. Das Setzen einer Steuergeräte-Eigenschaft (property) wirkt sich konventionsmäßig immer auf alle im System bekannten Fahrzeug-Kontexte aus (transparentes Autoren-Property-Modell), d.h. autorengesetzte Eigenschaften haben globalen Charakter und unterliegen keiner Einfügehistorie.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   Isom.Base.String propName = "PartNumber"; 
   if(ecu.GetProp(propName).IsVoid()) 
     ecu.SetProp(propName, "5444442"); 

Parameter:

	propName	Name der Eigenschaft
	propValue	Neuer Wert der Eigenschaft

Rückgabe:

Isom.Base.Boolean
Immer 'true'

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls das Steuergeräteobjekt Teil der Ist-Sg-Liste ist und die Eigenschaft bereits nicht leer gesetzt ist.

Siehe auch:

Isom.Context.Ecu.GetProp()

Isom.Context.Ecu.GetAllPropertyNames()

Isom.Context.Ecu.InvalidateProp()

Datum:

letzte Änderung am 19.07.2010

Setzt den Steuergeräte-Zustand im passenden Zustandsautomaten.

Dazu wird der Name des zu setzenden Zustands vollqualifiziert als Parameter übergeben.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress("64"); 
   ecu.SetState("Isom.Identify.Unknown"); 

Parameter:

newState

vollqualifizierter Zustandsname.

Rückgabe:

Isom.Base.Boolean
Immer 'true'.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls der neue Zustand nicht vollqualifiziert ist.

Siehe auch:

Isom.Context.Ecu.GetStates()

Isom.Context.Ecu.IsInState()

Datum:

letzte Änderung am 19.07.2010

Verbringt einen Freischaltcode in das Fahrzeug.

   Isom.Base.Boolean DoActivate(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Plan.ActivationCode fsc = action.GetActivationCode(); 
     if(ecu.StoreActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     if(ecu.EnableActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Parameter:

fsc

Freischaltcode

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Schreiben, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.Ecu.EnableActivationCode()

Isom.Context.Ecu.StoreAndEnableActivationCode()

Isom.Context.Ecu.DisableActivationCode()

Datum:

letzte Änderung am 05.01.2012

Überträgt einen Freischaltcode an ein Steuergerät und schaltet die entsprechende Funktion frei.

   Isom.Base.Boolean DoActivate(Isom.Plan.TherapyPlanAction action) 
   { 
     Isom.Context.Ecu ecu = action.GetEcu(); 
     Isom.Plan.ActivationCode fsc = action.GetActivationCode(); 
     if(ecu.StoreAndEnableActivationCode(fsc).Failed()) 
     { 
       //Fehlerbehandlung 
     } 
     //.. 
     return true; 
   } 

Parameter:

fsc

Freischaltcode

Rückgabe:

Isom.Base.Boolean
'true' nach erfolgreichem Aktivieren, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Siehe auch:

Isom.Context.Ecu.StoreActivationCode()

Isom.Context.Ecu.EnableActivationCode()

Isom.Context.Ecu.DisableActivationCode()

Datum:

letzte Änderung am 05.01.2012

Schreibt eine Repräsentation der Fahrzeugkonfiguration in das Steuergerät.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress( "64" ); 
   Isom.Context.FutureVehicleContext fvc = Isom.Context.FutureVehicleContext.GetInstance(); 
   Isom.Context.VehicleOrder vo = fvc.GetVehicleOrderClone(); 
   if(ecu.StoreVehicleOrder(vo).Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Parameter:

vo

Zu schreibende Repräsentation der Fahrzeugkonfiguration.

Rückgabe:

Isom.Base.Boolean
'true', nach erfolgreichem Schreiben, 'false' sonst.

Ausnahmebehandlung:

Es wird das Void-Objekt zurückgegeben, falls die notwendigen Fahrzeug-Metadaten nicht ermittelbar sind.

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Synchronisiert Steuergeräte-Informationen zwischen ISOM-Modell und Fachdiensteanbindung.

Achtung:

Dieser Aufruf ist nur für Spezialanwendungen vorgesehen, in denen ein spezieller Abgleich zwischen einem Fachdienst und ISOM stattfinden muss, welcher über die vorimplementierte Datenhaltung einer "normalen" ISOM-Sitzung hinausgeht.

Zu beachten:

Für Notwendigkeit und Umfang des Abgleichs siehe das herstellerspezifische Begleitdokument.

   Isom.Context.Ecu ecu = Isom.Context.Ecu.CreateNewByAddress( "18" ); 
   if (ecu.UpdateContext().Failed()) 
   { 
     //Fehlerbehandlung 
   } 

Rückgabe:

Isom.Base.Boolean
'true', wenn keine Fehler aufgetreten sind, 'false' sonst.

Ausnahmebehandlung:

Void wird bei baureihenspezifischen Fehlern zurückgegeben, siehe herstellerspezifisches Begleitdokument.

Datum:

letzte Änderung am 19.07.2010

Erzeugt ein Void-Objekt.

Die Funktion kann in Fehlerfällen verwendet werden, um z.B. einen ungültigen Funktionsrückgabewert zu erzeugen.

   //Erzeuge Void-Objekt 
   Isom.Context.Ecu ecu = Isom.Context.Ecu.Void(); 

Rückgabe:

Isom.Context.Ecu
Die Funktion liefert immer ein Void-Objekt.

Ausnahmebehandlung:

Void wird von dieser Funktion immer geliefert.

Datum:

letzte Änderung am 20.07.2010