Vector: DYNA4¶

Herstellerinformationen

Kategorien

Signalaufnahmen 🛈

Plattform

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. Dafür müssen einige Optionen in der TBC korrekt gesetzt sein:

Pfad zur DYNA4-Python-API

DYNA4 R10 und aktueller

Die remote API wird über ein Python wheel bereitgestellt und muss zunächst über den folgenden Befehl manuell installiert werden. Dafür ist eine Internetverbindung notwendig. Der dabei angegebene Ordner <target_directory> muss in der TBC für diese Option eingetragen werden. Damit ecu.test die DYNA4 remote API verwenden kann, muss pip install für die von ecu.test verwendete Python-Version ausgeführt werden, welche im ecu.test_out.log-Header steht.

pip install "path/to/wheel.whl" --target "<target_directory>"

Das Python wheel befindet sich üblicherweise im DYNA4-Installationsverzeichnis unter DYNAwareProducts/RemoteAPI/dist.

DYNA4 R9 und älter

Ordner, in dem sich die Datei dyna4_api.py (R8 und R9) bzw. dyna4.py (R7 und älter) befindet. Üblicherweise ist das im DYNA4-Installationsverzeichnis unter DYNAwareProducts/RemoteAPI.

Info

Anstatt der mitgelieferten Datei kann auch eine eigene, gegebenenfalls modifizierte Datei verwendet werden.

XMLRPC-API-Port

Port der DYNA4-XMLRPC-API (Default: 10895).

Projekt

Name eines existierendes DYNA4-Projekts. Diese sind im DYNA4-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 🛈¶

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

LoadTask¶

Lädt Task in DYNA4 und setzt zuvor gesetzte Task-Parameter zurück

RunTask¶

Startet Ausführung des geladenen Tasks in DYNA4

SetTaskParameter¶

Setze Parameter für aktuellen Task