Access to signal values

How values are accessed via ecu.test can be configured in the “Read Configuration” or “Write Configuration” of each widget. Available access types depend on the widget type.

Global mapping

ecu.test lab enables access to variables of a tool with high performance. The variables are accessed through the global mapping that is active in ecu.test.

Once a variable is available as a global mapping, it can then be configured in the widget as a Read or Write Configuration of type Global mapping.

../_images/widget_configuration_read_mapping.png

To prepare all relevant mappings, you can set them up in one or more global mapping files and add the .xam files to the test configuration associated with the view. This way, the global mappings will be available upon configuration start.

If the Read Configuration of a widget is set to a global mapping, it is updated periodically in live mode.

If the Write Configuration of a widget is set to a global mapping, the value set by the user will be written to that mapping.

Info

As of now, only scalar values, images and jobs are supported for global mapping access.

Package

If the type Package is set in the “Read Configuration” or “Write Configuration”, a package for test case execution can be selected in the widget configuration - along with its parameter configuration. It will be executed when the execution button of the widget is clicked.

For write access, depending on the widget type, one package parameter can be marked “dynamic”, e.g. for the number widget. This parameter will be filled with the given value of the widget when the package is executed.

../_images/widget_configuration_write_package.png

For read access, the name of a test case variable of type “return value” can be configured in the “Return” setting. After package execution, this value will be shown in the widget. When the live mode is active, the configured package will be executed periodically to update the widget - according to the acquisition rate.

../_images/widget_configuration_read_package.png

The package execution in ecu.test lab uses a minimalistic, but faster execution engine. This makes it possible to include packages in the live mode. This also means that not all test steps are supported. If a package contains an unsupported test step, a warning will be displayed in ecu.test lab.

Officially not supported in this release:

Temporal behaviour

Wait test steps in packages that are executed from ecu.test lab do not cause simulation time to proceed when stepwise execution in simulation time is active.

Expression

ecu.test lab can evaluate expressions. These are similar to the expressions that can be used in ecu.test calculation test steps, with the limitation that only the Internal API (api.) and UserPyModules (user.) can be accessed.

When Expression is selected in the “Read Configuration” or “Write Configuration”, the expression can be entered in the text field below. For the Write Configuration, the name of the parameter of the function can be specified. The value of the widget is then passed as a keyword argument to the function.

../_images/configuration_of_expressions.png

The above example with “test” as input for the widget would result in the following calls:

user.MyModule.SetValue(some_value="test")