Vector: DYNA4

供应商信息

Vendor

Web page

产品名称

Version

Vector Informatik GmbH

https://www.vector.com/

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.

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

工具调用被中止前的超时时间。

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