Vector: DYNA4¶
Bisheriger/interner Bezeichner: DYNA4
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
Vector Informatik GmbH |
DYNA4 |
Ab R5 bis R8. |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Signalaufnahmen 🛈
Dateiformat |
Kommentar |
|---|---|
*.mf4 |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Besonderheiten¶
Die Toolanbindung von DYNA4 ermöglicht mithilfe von Tooljobs das Laden, Parametrieren und Starten von Tasks sowie Abrufen der Signalaufnahmen einer Simulation in ecu.test.
Einrichtung¶
Beim Starten der TBC wird DYNA4 automatisch gestartet; um das zu gewährleisten müssen allerdings einige Optionen in der TBC korrekt gesetzt sein:
Die Option Pfad zur DYNA4-Python-API muss auf die Datei dyna4_api.py verweisen. Bzw. auf die Datei dyna4.py bei DYNA4 Versionen < 8. Diese befindet sich üblicherweise im Verzeichnis DYNAwareProductsRemoteAPI im Dyna4-Installationsverzeichnis. Anstatt der mitgelieferten Datei kann auch eine eigene, gegebenenfalls modifizierte Datei genutzt werden.
Die Option XMLRPC-API-Port muss auf den Port der DYNA4-XMLRPC-API verweisen (Default: 10895).
Die Option Projekt muss auf den Namen eines existierendes DYNA4-Projekts verweisen. Diese sind in DYNA4 im Workspace unter Project Navigator gelistet. Dieses Projekt wird von ecu.test nach dem Start von DYNA4 geladen.
Verwendung¶
Abfolge der Jobs¶
Bei der Reihenfolge der angebotenen Tooljobs gibt es Folgendes zu beachten:
Bevor mit RunTask die Simulation gestartet werden kann, muss sowohl mit LoadModelConfiguration eine Model-Konfiguration als auch mit LoadTask ein Task geladen werden.
Um mit GetSimulationResults die Signalaufnahmen abzurufen, muss zuvor eine Simulation mit RunTask ausgeführt worden sein.
Der Job LoadTask setzt alle zuvor mit SetTaskParameter gesetzten Task-Parameter zurück.
Namen von Model-Konfigurationen und Tasks¶
Bei den Jobs LoadModelConfiguration sowie LoadTask muss der Dateipfad des zu ladenden Artefakts angegeben werden. Hierbei handelt es sich um den Pfad relativ zum artefaktspezifischen Verzeichnis in der Database des Projekts. Beispielsweise würde der Task MyVehicleProject/Database/Tasks/MyVehicleTasks/MyTask1.task im Tooljob mit „MyVehicleTasks/MyTask1.task“ referenziert werden.
Parametrierung von Tasks¶
Mit dem Job SetTaskParameter kann jeweils ein Parameter des geladenen Tasks verändert werden. Ist der Task im GUI von DYNA4 angewählt, kann an den angegebenen Input-Feldern abgelesen werden, welche Parameter für den Task variiert werden können. Wichtig ist, dass nicht nur der ParameterName in ecu.test korrekt ist, sondern auch der Wert von ParameterValue den richtigen Datentyp besitzt.
Verschiedene Simulation-Targets¶
Über die Option Simulation-Target in der TBC wird für die aktuelle Ausführung die Plattform der Simulation gesetzt. Abhängig von der Plattform ist gegebenenfalls ein Kompilier- und Downloadvorgang notwendig. Dabei findet der Download implizit bei RunTask statt, während die Kompilierung mit dem Job BuildSimulationTarget gestartet werden kann.
Einschränkungen¶
Aufgrund einer Limitierung der DYNA4-Schnittstelle ist es derzeit nicht möglich, neue Tasks aus dem Projektverzeichnis zu laden. Wird mit dem Tooljob LoadTask ein Task ausgewählt, muss dieser vorher im aktuell ausgewählten Projekt geladen worden sein.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Allgemein |
|||||
Projekt |
Allgemein |
string |
Name des DYNA4-Projekts, welches beim Start geladen werden soll |
||
Simulation-Target |
Allgemein |
‚DYNA4 Windows Executable‘ |
[‚Simulink‘, ‚DYNA4 Windows Executable‘, ‚CANoe‘, ‚dSPACE SCALEXIO‘] |
string |
Simulation-Target, für das die Simulation kompiliert werden soll |
Ausführungstimeout |
Allgemein |
130 |
int |
Zeit in Sekunden, die beim Simulationslauf auf API-Antwort gewartet wird |
|
Toolverbindung |
|||||
Pfad zur DYNA4-Python-API |
Toolverbindung |
string |
Pfad zur Datei „dyna4.py“. Diese ist ab Version 8.0.1 im Unterverzeichnis „DYNAwareProducts\RemoteAPI“ der DYNA4-Installation zu finden. In Vorgängerversionen ist diese der DYNA4-Hilfe zu entnehmen. |
||
Pfad zur MATLAB-Installation |
Toolverbindung |
string |
Pfad zum Installationsverzeichnis von MATLAB |
||
XMLRPC-API-Port |
Toolverbindung |
10895 |
int |
Port, auf dem die DYNA4-XMLRPC-API bereitsteht |
|
DYNAanimation immer starten |
Toolverbindung |
☑ |
bool |
DYNAanimation immer starten, wenn Simulation beginnt |
|
DYNA4 bei Verbindungsabbau schließen |
Toolverbindung |
☐ |
bool |
Laufende DYNA4-Instanz schließen, wenn Konfiguration deaktiviert wird |
|
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
BuildSimulationTarget¶
Baut das ausgewählte Simulation-Target. Wird nur unterstützt für DYNA4 Windows Executable, CANoe, dSPACE SCALEXIO.
DownloadTargetModel¶
Lädt das Modell herunter. Anschließend wird eine vollständige Zuweisung der Modellparameter durchgeführt. Wenn für das aktuelle Simulationsziel kein Download erforderlich ist, wird nur die Parameterzuweisung durchgeführt.
GetSimulationResults¶
Rufe Ergebnisse der letzten Simulation ab
LoadModelConfiguration¶
Lädt bzw. aktiviert Model-Configuration in DYNA4
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ModelConfiguration |
string |
Name der DYNA4-Model-Configuration |
LoadTask¶
Lädt Task in DYNA4 und setzt zuvor gesetzte Task-Parameter zurück
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
TaskName |
string |
Name des Tasks |
RunTask¶
Startet Ausführung des geladenen Tasks in DYNA4
SetTaskParameter¶
Setze Parameter für aktuellen Task
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
ParameterName |
string |
Name des Task-Parameters |
|||
ParameterValue |
object |
Wert des Task-Parameters |