Vector: DYNA4¶
供应商信息
Vendor |
Web page |
产品名称 |
Version |
|---|---|---|---|
Vector Informatik GmbH |
DYNA4 |
From R5 to R10. |
Categories
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Signal recordings(信号记录) 🛈
文件格式 |
Comment |
|---|---|
*.mf4 |
Platform
操作系统 |
Support |
|---|---|
Windows |
✓ |
Linux |
Specifics¶
The DYNA4 tool connection with its tooljobs allows loading, parameterizing and starting of Tasks as well as retrieving signal recordings of a simulation.
Setup¶
When starting the TBC, DYNA4 will be started automatically; however, in order to ensure this, some options in the TBC must be set correctly:
- DYNA4 Python API 的路径
- DYNA4 R10 and newer
远程 API 通过 Python wheel 提供,必须先使用 以下命令手动安装。这需要互联网连接。 此处指定的
<target_directory>文件夹必须为此选项在 TBC 中输入。 为使 ecu.test 能够使用 DYNA4 远程 API,必须对 ecu.test 所使用的 Python 版本执行pip install,该版本打印在ecu.test_out.log头部。pip install "path/to/wheel.whl" --target "<target_directory>"Python wheel 通常位于 DYNA4 安装目录下的
DYNAwareProducts/RemoteAPI/dist中。- DYNA4 R9 and older
包含文件 dyna4_api.py(R8 和 R9)或 dyna4.py(R7 及更早版本)的文件夹。该文件夹通常位于 DYNA4 安装目录下的
DYNAwareProducts/RemoteAPI。
Info
除了所提供的文件外,也可以使用自己修改过的文件。
- XMLRPC API port
DYNA4 XMLRPC API 的端口(默认:10895)。
- Project
现有 DYNA4 项目的名称。这些项目可在 DYNA4 工作区的 Project Navigator 下找到。 DYNA4 启动后,ecu.test 会加载该项目。
Usage¶
Job sequence¶
The following should be considered regarding the order of the tool jobs:
Before the simulation can be started with RunTask, a Model Configuration and a Task must be loaded with LoadModelConfiguration and LoadTask.
Before signal recordings can be retrieved with GetSimulationResults, a simulation must have been run with RunTask.
The job LoadTask resets all Task Parameters previously set with SetTaskParameter.
Names of Model Configurations and Tasks¶
For the LoadModelConfiguration and LoadTask jobs, the file path of the artifact to be loaded must be specified. This is the path relative to the artifact specific directory in the Database within the project. For example, when loading the Task MyVehicleProject/Database/Tasks/MyVehicleTasks/MyTask1.task, it would be referenced with “MyVehicleTasks/MyTask1.task”.
Parameterization of Tasks¶
The SetTaskParameter job can be used to change one parameter of the loaded Task. If the Task is selected in the GUI of DYNA4, the specified input fields indicate, which parameters can be varied for the Task. It is important that not only the parameterName is correct, but also that the value of ParameterValue has the right datatype.
Different simulation targets¶
The option Simulation-Target in the TBC sets the platform of the simulation. Depending on the platform, compilation and download might be necessary. The download is implicitly executed during RunTask, while the compilation can be invoked with the Job BuildSimulationTarget.
Limitations¶
Due to a limitation of the DYNA4 interface, it is currently not possible to load new tasks from the project directory. If a task is selected with the tool job LoadTask, this task must have been previously loaded in the currently selected project.
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Common |
|||||
Project |
Common |
string |
Name of the DYNA4 project to be loaded at startup |
||
Simulation Target |
Common |
‘DYNA4 Windows Executable’ |
[‘Simulink’, ‘DYNA4 Windows Executable’, ‘CANoe’, ‘dSPACE SCALEXIO’] |
string |
Simulation Target to compile the simulation for |
Execution timeout |
Common |
130 |
int |
Time in seconds to wait for API response during simulation run |
|
Tool connection |
|||||
Path to DYNA4 Python API |
Tool connection |
string |
DYNA4 远程 API 的路径。 从 DYNA4 R10 起,必须手动安装 remote API wheel。请指定 “dyna4_api” 包的安装路径。 从 DYNA4 R8 起,remote API 文件安装在 DYNA4 安装目录的子目录 “DYNAwareProducts\RemoteAPI” 中。 在较早的版本中,需要从 DYNA4 帮助中提取。 |
||
Path to the MATLAB installation |
Tool connection |
string |
Path to the MATLAB installation directory |
||
XMLRPC API port |
Tool connection |
10895 |
int |
Port on which the DYNA4 XMLRPC API is available |
|
Always start DYNAanimation |
Tool connection |
☑ |
bool |
Always start DYNAanimation when simulation starts |
|
Close DYNA4 when disconnecting |
Tool connection |
☐ |
bool |
Close running DYNA4 instance when configuration is deactivated |
|
Timeout for tool call ❲in sec.❳ |
‘600’ |
string |
工具调用被中止前的超时时间。 |
Jobs 🛈¶
BuildSimulationTarget¶
Builds the selected Simulation Target. Only supported for DYNA4 Windows Executable, CANoe, dSPACE SCALEXIO.
DownloadTargetModel¶
Downloads the target code. Afterwards a full assignment of the model parameters is performed. If no download is necessary for the current simulation target only the parameter assignment is executed.
GetSimulationResults¶
Retrieve results of the last simulation
LoadModelConfiguration¶
Loads or activates model configuration in DYNA4
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ModelConfiguration |
string |
Name of the DYNA4 Model Configuration |
LoadTask¶
Loads task into DYNA4 and resets previously set task parameters
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
TaskName |
string |
Task name |
RunTask¶
Starts execution of the loaded Task in DYNA4
SetTaskParameter¶
Set parameters for current Task
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
ParameterName |
string |
Name of the task parameter |
|||
ParameterValue |
object |
Value of the Task Parameter |