Port MODELACCESS¶
Stimulation¶
Einschränkungen:
Stimulus-Eingangssignale werden nicht unterstützt.
Die in einer STI-Datei im DataFileSegment referenzierten Tracedateien werden von ecu.test nicht konvertiert.
Unterstützte Ausführungsmodi¶
Siehe auch: Details zu den Zeitmodi
Bevorzugte Zeitquelle/Modus: Schrittweise Simulationszeit
- 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.
- 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.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
FMU-Datei |
string |
Relativpfad zur FMU-Datei bezogen auf das FMU-Wurzelverzeichnis. |
|||
FMI-Typ |
automatisch |
[automatisch, CoSimulation, ModelExchange] |
string |
Der für die Simulation zu verwendende FMI-Typ. Bei „automatisch“ wird der in der Model-Description definierte Typ verwendet bzw. „CoSimulation“, sofern die FMU beide Typen unterstützt. |
|
Model-Description validieren |
☑ |
bool |
Soll beim Laden der FMU die Model-Description-XML gegen das Schema aus dem FMI-Standard validiert werden? |
||
Simulationsverhalten |
|||||
Simulationsgeschwindigkeit |
Simulationsverhalten |
ungebremst |
[ungebremst, individuell, 1x, 2x, 4x, 8x] |
string |
Bei Echtzeitsimulationen kann die Simulationsgeschwindigkeit auf einen Sollwert (Vielfaches der Realzeit) gedrosselt werden. |
individuelle Simulationsgeschwindigkeit |
Simulationsverhalten » Simulationsgeschwindigkeit: ‚individuell‘ |
1.0 |
float |
individuelle Simulationsgeschwindigkeit (Vielfaches der Realzeit) festlegen |
|
Kommunikationsschrittweite |
Simulationsverhalten |
automatisch |
[automatisch, aus Default-Experiment ermitteln, individuell] |
string |
Schrittweite, mit der die Stimulation von Signalen erfolgt. Wird für ModelExchange-FMUs mit fixed-step-Solver zudem als „stepSize“ verwendet. Bei „automatisch“ wird zunächst versucht die Schrittweite aus dem Default-Experiment zu bestimmen. Ist diese nicht vorhanden oder ist kein Default-Experiment definiert wird 0.001 (1 ms) verwendet. |
individuelle Kommunikationsschrittweite |
Simulationsverhalten » Kommunikationsschrittweite: ‚individuell‘ |
0.001 |
float |
Individuelle Kommunikationsschrittweite festlegen (Angabe in Sekunden) |
|
Downsampling-Faktor für Signalaufnahme |
Simulationsverhalten |
1 |
int |
Faktor zur Reduzierung der Datenpunkte (Samples) bei der Aufzeichnung von Signalen. Der Faktor ist bezogen auf die Kommunikationsschrittweite und nicht auf die Schrittweite mit der die FMU intern rechnet. Bei einem Faktor von 10 wird nur jeder zehnte Datenpunkt in die Aufnahme geschrieben. Standardmäßig werden alle Datenpunkte aufgezeichnet (Faktor 1). |
|
Logging |
|||||
Debug-Logging aktivieren |
Logging |
☐ |
bool |
Aktiviert das Debug-Logging für die FMU. Diese Option sollte in der Produktivumgebung deaktiviert werden, da die Ausgabe vieler Debug-Prints die Simulationsleistung stark beeinträchtigen kann. |
|
Logging für FMI-Aufrufe aktivieren |
Logging |
☐ |
bool |
Aktiviert das Logging aller FMI-Aufrufe. Diese Option sollte in der Produktivumgebung deaktiviert werden, da die Ausgabe vieler Debug-Prints die Simulationsleistung stark beeinträchtigen kann. |
Jobs 🛈¶
GetFmiType¶
Gibt den FMI-Simulations-Typ der FMU zurück
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
string |
FMI-Simulations-Typ |
GetSampleTime¶
Gibt die effektive Kommunikationsschrittweite zurück
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
float |
konfigurierte Schrittweite |
GetSimulationTime¶
Gibt die aktuelle Simulationszeit zurück
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
float |
aktuelle Simulationszeit |
SetDebugLogging¶
De-/Aktiviert das Debug-Logging für die FMU
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
categories |
object |
Liste von Kategorien für die das Logging aktiviert werden soll (Typ: list[str]). (wirkt sich sowohl auf die regulären Log-Ausgaben als auch auf die Debug-Log-Ausgaben aus) Die zur Verfügung stehenden Kategorien können der modelDescription.xml der FMU entnommen werden. ‚None‘ oder eine leere Liste ‚[]‘ führen dazu, dass die Log-Ausgaben nicht gefiltert werden, also alle Log-Kategorien ausgegeben werden. |
|||
loggingOn |
True |
[False, True] |
bool |
Debug-Logging de-/aktivieren |
StartSimulation¶
Kann verwendet werden um die Simulation innerhalb eines Package zu starten, z.B. wenn die Simulation nicht automatisch beim Package-Start gestartet wird (siehe Testbench-Option).
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
/ |
Kein Rückgabewert |
StopSimulation¶
Kann verwendet werden, um die Simulation innerhalb eines Packages zu stoppen
Parametrierung
Rückgabewert
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
result |
float |
aktuelle Simulationszeit |