Port MODELACCESS - DEFAULT¶

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¶

Erstkonfiguration

Alle Einstellungen sind optional. Die vorgeschriebene Einstellung der Konfigurationsdatei sollte über den Tab Plattform erfolgen.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Konfigurationsdatei				string	Pfad zur MAPort-Konfigurationsdatei. Entweder als absolute Pfadangabe oder relativ zum Modellverzeichnis. Bei <auto> wird die in der TCF referenzierte Konfigurationsdatei verwendet.
Konfigurationsparameter überschreiben		‚<keine>‘		string	Ermöglicht das Überschreiben von Konfigurationsparametern des Ports in der angegebenen Konfigurationsdatei. Der Parameterpfade, inkl. der neue Werte müssen im JSON-Format angegeben werden., z.B. \‘{„sample.path“: value}\‘. Die zu überschreibenden Parameterpfade müssen bereits in der Konfigurationsdatei des Ports definiert sein.
Trennzeichen in Modellpfaden		‚/‘	[‚/‘, ‚.‘]	string	Gibt das in Modellpfaden verwendete Trennzeichen an. Damit werden Modellgrößen z.B. im Modellreiter visuell gruppiert.
Bestehende Konfiguration ersetzen		☐		bool	Falls „True“ gewählt ist, wird die bestehende Konfiguration ersetzt. Sonst wird versucht die laufende Konfiguration wiederzuverwenden.
Simulation starten		‚start‘	[‚start‘, ‚test start‘, ‚no start‘] Anzeigewerte: ‚start‘: ‚Starten‘ ‚test start‘: ‚Beim Teststart‘ ‚no start‘: ‚Nicht starten‘	string	Legt fest, wann die Simulation gestartet wird. „Starten“: Die Simulation wird beim Konfigurationsstart gestartet. „Beim Teststart“: Die Simulation wird zu Beginn der Ausführung eines Testfalls gestartet. „Nicht starten“: Die Simulation wird nicht gestartet. Der resultierende Port-Zustand hängt von der „Bestehende Konfiguration ersetzen“-Einstellung ab. Eine bereits laufende und simulierende Applikation wird nicht gestoppt.
Simulation stoppen		‚stop‘	[‚stop‘, ‚test stop‘, ‚no stop‘] Anzeigewerte: ‚stop‘: ‚Stoppen‘ ‚test stop‘: ‚Beim Teststop‘ ‚no stop‘: ‚Nicht stoppen‘	string	Legt fest, wann die Simulation gestoppt wird. „Stoppen“: Die Simulation wird beim Konfigurationsstop gestoppt. „Beim Teststop“: Die Simulation wird nach Abschluss eines Testfalls gestoppt. „Nicht stoppen“: Die Simulation wird nicht implizit gestoppt.
Aufnahmeformat		MF4	[CSV, MDF, MF4]	string	Dateiformat der Aufzeichnung
Trennzeichen	Aufnahmeformat: ‚CSV‘	‚;‘	[‚;‘, ‚,‘]	string	Trennzeichen der CSV-Datei
Aufnahme-Downsampling-Rate		<default>		int	Definiert nach wie vielen Samples der Signalwert in der Aufzeichung persistiert wird. Ist „<default>“ gewählt, wird die Downsamplig-Rate nicht explizit gesetzt - Standardeinstellung des Herstellers wird verwendet.
Timeout beim Aufnahmestart ❲s❳		30		int	Maximal zulässige Zeit nach dem manuellen Starten der Aufnahme, bis das Tool die Aufnahme tatsächlich gestartet hat.
Standardaufnahmeraster		‚Tool-Default‘		string	Angabe des Aufnahmerasters, das als Alternative verwendet wird, falls für die Testgröße kein Raster angegeben ist (“*“ und „?“ können als Platzhalter verwendet werden). „Tool-Default“ führt zur Verwendung des ersten aller verfügbaren Raster.
Standardaufnahmeraster erzwingen		☐		bool	Das als Standardaufnahmeraster hinterlegte Raster wird bei der Aufnahme für alle Größen erzwungen.
Aktualisierungsintervall der Modellzeit		0		float	Gibt an, in welchem Intervall (in Sekunden) die Modellzeit zur Synchronisation mit dem Testfall abgefragt werden soll. 0 aktualisiert nach jedem Simulationsschritt.
Parameterdateien				string	Hier kann eine kommaseparierte Liste von Parameterdateien angegeben werden. Diese Parameterdateien werden beim Konfigurationsstart an den XIL Server übergeben. Pfade können absolut oder relativ zum Basispfad des Toolhosts angegeben werden.
Matrix-Layout anpassen		☐		bool	Konvertierung von Matrizen vom Zeilenlayout (XIL) in das Spaltenlayout (ecu.test). Im Gegensatz zu ASAM XIL, welches das zeilenbasierte Layout zur Speicherung von Matrizen implementiert, verwendet ecu.test das Spaltenlayout. Bei gesetzter Option werden Matrizen beim Einlesen und vor der Nutzung in ecu.test an das interne Spaltenlayout angepasst. Dies hat zur Folge, dass Matrizen korrekt dargestellt werden und Indizierungen konsistent nach dem Schema [Spalte][Zeile] erfolgen. Bei nicht gesetzter Option bewirkt die fehlende Anpassung des Layouts, dass mit der transponierten Matrix gearbeitet wird (siehe z.B. Darstellung im Report). Eine Indizierung der transponierten Matrix gemäß dem obigen Schema in ecu.test ist damit äquivalent zur Indizierung der (nicht transponierten) Originalmatrix mittels des Schemas [Zeile][Spalte] aus Sicht des Tools. Eine nicht gesetzte Option entspricht dem Bestandsverhalten. Es wird empfohlen diese für neue Testfälle zu setzen.

Jobs 🛈¶

DownloadParameterSets¶

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

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
parameterFilePaths				string	Hier kann eine kommaseparierte Liste von Parameterdateien angegeben werden.

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.

Parameter

Name	Standardwert	Typ	Beschreibung
customProperties	{}	object	Benutzerdefinierte Eigenschaften für das Targetskript als Dictionary, z. B. {„ApplicationProcessor“: „leaderAppl“}.
inputParameters	{}	object	Input-Parameter für Target Script als Dictionary der Form {„parameterName“: „parameterValue“}. Es werden nur primitive Datentypen unterstützt.
outputParameterNames	[]	object	Liste der Output-Parameter, welche nach Ausführung des Target Scripts abgefragt und im Rückgabewert ausgegeben werden sollen. Angabe als Liste von Strings. Es werden nur primitive Datentypen unterstützt.
targetScriptPath		uri	Absoluter oder relativer Pfad zum Target Script auf diesem Rechner. Relative Pfade werden relativ zum Workspace-Verzeichnis aufgelöst.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Werte der Output-Parameter als Dictionary der Form {„outputParameter“: „valueAfterExecution“}. Die abzufragenden TargetScript-Parameter müssen vor Ausführung über den entsprechenden Job-Parameter angegeben werden.

GetAllStimulations¶

Liste der initialisierten Stimuli abfragen

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
RunningOnly		False	[False, True]	bool	Nur aktive (laufende und pausierte) Stimuli zurückgeben.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				object	Liste der aktiven Stimulationsdateien

GetConfigState¶

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

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
configParam				string	Pfad des Konfigurationsparameters innerhalb der Konfigurationsdatei des Ports, z.B. „sample.path.value“.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				string	Wert des Konfigurationsparameters

GetRecordingFilesStates¶

Dictionary aller Aufnahmedateien mit zugehörigem Aufnahmezustand abfragen

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				object	Dictionary bestehend aus Dateinamen und jeweils zugehörigem Zustand („activated“,“configured“, „running“ oder „finished“)

GetSimulationState¶

Status der Simulation abfragen

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				string	„disconnected“, „running“, „paused“, „stopped“, „not initialized“ oder „unknown: <MAPortState>“. Der Zustand „paused“ existiert erst ab XiL-Version 2.1.

GetSimulationTime¶

Simulationszeit abfragen

GetStimulationState¶

Status der Stimulation abfragen

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
InstanceIdentifier				string	Instanzbezeichnung des Stimulus, dessen Status abgefragt werden soll.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				string	„configuration“, „ready“, „running“, „paused“, „finished“, „stopped“, „not started“ oder „unknown: <SignalGeneratorState>“

PauseSimulation¶

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

PauseStimulation¶

Stimulation pausieren

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
InstanceIdentifier				string	Instanzbezeichnung des Stimulus, der pausiert werden soll.

ResumeStimulation¶

Pausierte Stimulation fortsetzen

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
InstanceIdentifier				string	Instanzbezeichnung des Stimulus, der fortgesetzt werden soll.

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.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
description				string	Beschreibung des Ereignisses (frei wählbar).
eventId		0		int	ID des Ereignisses (frei wählbar). Bereich gültiger Werte: 0-18446744073709551615.