Port MODELACCESS - ESI¶

ESI-XIL-API-MAPort

Stimulation¶

Einschränkungen:

• Die in einer STI-Datei im DataFileSegment referenzierten Tracedateien werden von ecu.test nicht konvertiert.

• Es obliegt dem Benutzer zu prüfen, ob das verwendete Trace-Format vom Tool unterstützt wird.

Unterstützte Ausführungsmodi¶

Siehe auch: Details zu den Zeitmodi

Bevorzugte Zeitquelle/Modus: Echtzeit

Echtzeit:

Zur Verwendung des Echtzeit-Modus muss in der Testkonfiguration im Tab Ausführung als Quelle „Echtzeit“ konfiguriert sein.

Schrittweise Simulationszeit:

Zur Verwendung des schrittweisen Simulations-Modus muss der Port in der Testkonfiguration im Tab Ausführung ausgewählt und der Modus auf „schrittweise“ gestellt sein. Warte-Bis-Wahr-Ausdrücke werden - wenn möglich - vom Tool ausgewertet. Wenn das Tool diese nicht auswerten kann, erfolgt die Auswertung durch ecu.test. Dies kann zu einer schlechteren Performance führen. Ungültige Ausdrücke werden nur im Log vermerkt, wenn das Log-Level auf „Maximum“ gestellt ist.

Kontinuierliche Simulationszeit:

Zur Verwendung des kontinuierlichen Simulations-Modus muss der Port in der Testkonfiguration im Tab Ausführung ausgewählt und der Modus auf „kontinuierlich“ gestellt sein.

Besonderheiten¶

SILVER bietet komplexe Datenstrukturen, wie Vektoren und Matrizen, ausschließlich durch ihre Einzelelemente im Modell an, z.B. wird VektorA durch seine Elemente VektorA[0], VektorA[1], VektorA[2] und VektorA[3] präsentiert. Zur Vereinfachung des Umgangs mit komplexen Datenstrukturen können sogenannte *.esi-Dateien erstellt und schließlich in der Testkonfiguration als Toolspezifische Zusatzdateien angegeben werden. Diese Dateien sind modellspezifisch und müssen somit für jedes Modell eigenhändig angelegt werden. Anschließend können Vektoren und Matrizen direkt gelesen und geschrieben werden. Die Aufzeichnung dieser komplexen Signale wird allerdings derzeit nicht unterstützt.

Die Syntax soll anhand des folgenden Beispiels dargestellt werden:

# ecu.test + SILVER Konfigurationsdatei
# Diese Datei soll alle in SILVER verfügbaren Variablen vom Typ Vektor und Matrix auflisten,
# die von ecu.test gelesen oder geschrieben werden sollen.


# VECTOR
# Syntax: SILVER-Name[ersterIndex:letzterIndex|*]
# Der * ist als Platzhalter statt letzterIndex, der dann zur Laufzeit ermittelt wird, erlaubt.

# Beispiel Interner ABF Zähler:
# Abf_EreigZaehler[0], Abf_EreigZaehler[1], ..., Abf_EreigZaehler[19]
Abf_EreigZaehler[0:19]

# Beispiel VektorA mit vier Elementen:
VektorA[0:3]

# Beispiel Vektor[1] (die [1] gehört hier zum Namen selbst) mit 18 Elementen:
# Vektor[1][3], Vektor[1][4], ..., Vektor[1][20]
Vektor[1][3:20]

# Beispiel dynamischer VektorD, dessen Länge erst zur Laufzeit feststeht.
# VektorD[0], ...
VektorD[0:*]


# MATRIX
# Syntax: SILVER-Name[ersterZeilenIndex:letzterZeilenIndex|*][ersterSpaltenIndex:letzterSpaltenIndex|*]
# Beispiel Datenpuffer:
# Data_Buffer_ABW_NEw1[0][0], Data_Buffer_ABW_NEw1[0][1], ..., Data_Buffer_ABW_NEw1[0][19],
# Data_Buffer_ABW_NEw1[1][0], Data_Buffer_ABW_NEw1[1][1], ..., Data_Buffer_ABW_NEw1[1][19],
# ...
# Data_Buffer_ABW_NEw1[12][0], Data_Buffer_ABW_NEw1[12][1], ..., Data_Buffer_ABW_NEw1[12][19],
Data_Buffer_ABW_NEw1[0:12][0:19]

# Beispiel dynamische Tabelle, deren Spaltenanzahl erst zur Laufzeit feststeht.
# Tabelle[0][0], ...
# Tabelle[1][0], ...
Tabelle[0:1][0:*]

Eigenschaften 🛈¶

Jobs 🛈¶

DownloadParameterSets¶

Lädt eine oder mehrere Parameterdateien im XIL-Server.

ExecuteTargetScript¶

Lädt ein Target Script auf das Zielsystem und führt es aus. Die maximale Ausführungsdauer entspricht dem Timeout für Toolzugriffe des Tools.

GetAllStimulations¶

Liste der initialisierten Stimuli abfragen

GetConfigState¶

Gibt den aktuellen Zustand des angegebenen Konfigurationsparameters zurück. Der Parameter muss als vollständiger Pfad angegeben werden.

GetRecordingFilesStates¶

Dictionary aller Aufnahmedateien mit zugehörigem Aufnahmezustand abfragen

GetSimulationState¶

Status der Simulation abfragen

GetSimulationTime¶

Simulationszeit abfragen

GetStimulationState¶

Status der Stimulation abfragen

PauseSimulation¶

Pausiert die Simulation und stellt den Zustand „paused“ her.

PauseStimulation¶

Stimulation pausieren

ResumeStimulation¶

Pausierte Stimulation fortsetzen

StartSimulation¶

Startet die Simulation. Wird die Anbindung im SiL-Modus betrieben, wird der Port in den Zustand „paused“ gebracht. Im HiL-Modus wird direkt der Zustand „running“ hergestellt.

StopSimulation¶

Beendet die Simulation und stellt den Zustand „stopped“ her.

TriggerClientEvent¶

Fügt ein Ereignis in alle laufenden Aufzeichnungen des Ports ein.