XIL Mapping

Getting Started
Release 2024-A – May 2024
How to Contact dSPACE
Mail: dSPACE GmbH
Rathenaustraße 26
33102 Paderborn
Germany
Tel.: +49 5251 1638-0
E-mail: [email protected]
Web: https://www.dspace.com

How to Contact dSPACE Support

If you encounter a problem when using dSPACE products, contact your local dSPACE
representative:
§ Local dSPACE companies and distributors: https://www.dspace.com/go/locations
§ For countries not listed, contact dSPACE GmbH in Paderborn, Germany.
Tel.: +49 5251 1638-941 or e-mail: [email protected]

You can also use the support request form: https://www.dspace.com/go/supportrequest. If

you are logged on to mydSPACE, you are automatically identified and do not have to add
your contact details manually.

If possible, always provide the serial number of the hardware, the relevant dSPACE License
ID, or the serial number of the CmContainer in your support request.

Software Updates and Patches

dSPACE strongly recommends that you download and install the most recent patches
for your current dSPACE installation. Visit https://www.dspace.com/go/patches for the
software updates and patches themselves and for more information, such as how to
receive an automatic notification when an update or a patch is available for your dSPACE
software.

Important Notice
This publication contains proprietary information that is protected by copyright. All rights
are reserved. The publication may be printed for personal or internal use provided all the
proprietary markings are retained on all printed copies. In all other cases, the publication
must not be copied, photocopied, reproduced, translated, or reduced to any electronic
medium or machine-readable form, in whole or in part, without the prior written consent
of dSPACE GmbH.

© 2024 by:
dSPACE GmbH
Rathenaustraße 26
33102 Paderborn
Germany

This publication and the contents hereof are subject to change without notice.

AURELION, AUTERA, ConfigurationDesk, ControlDesk, MicroAutoBox, MicroLabBox,

SCALEXIO, SIMPHERA, SYNECT, SystemDesk, TargetLink, and VEOS are registered
trademarks of dSPACE GmbH in the United States or other countries, or both. Other
brand names or product names are trademarks or registered trademarks of their respective
companies or organizations.
 Contents

Contents

About This Document 5

New Features in the XIL Mapping Tool Chain 7

New Features in the XIL Mapping Tool Chain................................................... 7

Introduction to XIL Mapping 9

XIL Mapping Concepts and Benefits................................................................ 9

XIL Mapping Tool Chains 13

XIL Mapping Tool Chain for HIL Simulations................................................... 13
XIL Mapping Tool Chain for SIL Simulations................................................... 18

Tool Chain Products 23

AutomationDesk........................................................................................... 24
Bus Manager................................................................................................. 25
ConfigurationDesk........................................................................................ 26
ControlDesk.................................................................................................. 28
dSPACE XIL API............................................................................................. 30
Ethernet Configuration Package.................................................................... 31
FlexRay Configuration Package...................................................................... 32
MATLAB/Simulink.......................................................................................... 33
VEOS................................................................................................ ............ 34

Appendix 37
ASAM XIL Standard....................................................................................... 37
ASAM XIL Standard and Mapping at dSPACE................................................ 40

Glossary 45

3
May 2024 Getting Started with XIL Mapping
 Contents

4
Getting Started with XIL Mapping May 2024
 About This Document

About This Document

Content This document introduces you to XIL mapping and how you can use XIL mapping
to decouple test automation tools (framework side) from simulation platforms
(testbench side).

You can use XIL mapping in all dSPACE tools that are part of the
hardware‑in‑the‑loop (HIL) or software‑in‑the‑loop (SIL) tool chain.

Symbols dSPACE user documentation uses the following symbols:

Symbol Description
Indicates a hazardous situation that, if not avoided,
V DANGER
will result in death or serious injury.
Indicates a hazardous situation that, if not avoided,
V WARNING could result in death or serious injury.
Indicates a hazardous situation that, if not avoided,
V CAUTION could result in minor or moderate injury.
Indicates a hazard that, if not avoided, could result in
NOTICE
property damage.
Indicates important information that you should take
Note
into account to avoid malfunctions.
Indicates tips that can make your work easier.
Tip
Indicates a link that refers to a definition in the
glossary, which you can find at the end of the
document unless stated otherwise.
Follows the document title in a link that refers to
another document.

Naming conventions dSPACE user documentation uses the following naming conventions:

%name% Names enclosed in percent signs refer to environment variables for

file and path names.

5
May 2024 Getting Started with XIL Mapping
 About This Document

<> Angle brackets contain wildcard characters or placeholders for variable

file and path names, etc.

Special Windows folders Windows‑based software products use the following special folders:

Common Program Data folder A standard folder for application-specific

program data that is used by all users.
%PROGRAMDATA%\dSPACE\<InstallationGUID>\<ProductName>
or
%PROGRAMDATA%\dSPACE\<ProductName>\<VersionNumber>

Documents folder A standard folder for application‑specific files that are

used by the current user.
%USERPROFILE%\Documents\dSPACE\<ProductName>\<VersionNumber>

Local Program Data folder A standard folder for application-specific

program data that is used by the current user.
%USERPROFILE%\AppData\Local\dSPACE\<InstallationGUID>\
<ProductName>

Accessing dSPACE Help and After you install and decrypt Windows‑based dSPACE software, the
PDF files documentation for the installed products is available in dSPACE Help and as PDF
files.

dSPACE Help (local) You can open your local installation of dSPACE Help:
§ On its home page via Windows Start Menu
§ On specific content using context-sensitive help via F1

PDF files You can access PDF files via the icon in dSPACE Help. The PDF
opens on the first page.

dSPACE Help (Web) Independently of the software installation, you can

access the Web version of dSPACE Help at https://www.dspace.com/go/help.
To access the Web version, you must have a mydSPACE account.
For more information on the mydSPACE registration process, refer to
https://www.dspace.com/faq?097.

6
Getting Started with XIL Mapping May 2024
 New Features in the XIL Mapping Tool Chain

New Features in the XIL Mapping Tool Chain

New Features in the XIL Mapping Tool Chain

dSPACE Release 2024-A The following features in the XIL mapping tool chain are new in dSPACE Release
2024‑A:

Feature Provided By More Information

Generating XIL Bus Manager As of dSPACE Release 2023-A, the Bus Manager generates XIL mappings for
mappings bus configuration function ports. You can now configure the template that
is used by the Bus Manager to generate the framework label IDs. Refer to
Using TRC File Variables for XIL Mapping (ConfigurationDesk Bus Manager
Implementation Guide ).
Merging XIL ConfigurationDesk ConfigurationDesk now provides a feature to merge several XIL mapping
mappings files to generate an overall XIL mapping file. Refer to Using Elements that
Provide XIL Mapping Files (ConfigurationDesk Real-Time Implementation
Guide ).
Automatic ControlDesk ControlDesk now provides a preview feature to automatically import
import of XIL XIL mapping files created by ConfigurationDesk. Refer to Basics on Variable
mappings Mappings (ControlDesk Variable Management ).
Providing XIL XILMappingParser The XILMappingParser reads XIL mapping files and makes XIL mappings
mappings usable with the dSPACE XIL API. Refer to Using the XIL Mapping Parser
(dSPACE XIL API MAPort Implementation ).

7
May 2024 Getting Started with XIL Mapping
 New Features in the XIL Mapping Tool Chain

8
Getting Started with XIL Mapping May 2024
 Introduction to XIL Mapping

Introduction to XIL Mapping

XIL Mapping Concepts and Benefits

Introduction XIL mapping is a feature to decouple test automation tools from test benches
(simulation platforms ) with an additional abstraction layer. As a result,
structural changes in simulation models no longer have any influence on test
automation tools and the test cases created with them. XIL mapping lets you
also reuse test cases from one test automation tool on different test benches
with minimal to no migration effort.

For more information on the ASAM XIL standard, refer to:

§ ASAM XIL Standard on page 37
§ https://www.asam.net/standards/detail/xil/

Accessing variables via In dSPACE test automation tools such as AutomationDesk and ControlDesk,
their path in the variable you get access to variables of the simulation application via loading a system
description description file (SDF file ) and the variable description referenced by it (TRC
file). You can connect these variables, for example, to instruments. The variable
connections remain functional until, for example, the paths to the variables in
the variable description file change due to structural changes in the simulation
model. In such a case, you must replace all changed variable connections after
loading the new SDF file.

9
May 2024 Getting Started with XIL Mapping
 Introduction to XIL Mapping

Simulation model Tests and layouts

Connect variables to instruments or access

‘Platform()://Model/Root/.../SubsystemA/...‘
variables in scripts via their path

Model structure change, e.g.,

renaming SubsystemA to SubsystemB ‘Platform()://Model/Root/.../SubsystemA/...‘

‘Platform()://Model/Root/.../SubsystemB/...‘
Connections become invalid
whenever the model
structure is changed
Effort

Accessing variables via XIL The XIL mapping feature of the ASAM XIL standard eliminates the need to
mappings replace variable connections after structural changes to the simulation model via
an additional abstraction layer.

10
Getting Started with XIL Mapping May 2024
 XIL Mapping Concepts and Benefits

Simulation model Tests and layouts

‘Platform()://Model/Root/.../SubsystemA/...‘ Connect
Label mapping framework
labels to
instruments and
Testbench label 1 Framework label 1 use framework
Model structure change, e.g.,
renaming SubsystemA to SubsystemB labels in scripts

‘Platform()://Model/Root/.../SubsystemB/...‘
Framework label 1

Instead of using the variable path for connections, the XIL mapping feature
provides the functionality to map an abstract identifier (framework label )
to a concrete and simulator‑dependent identifier (testbench label ). In test
automation tools such as ControlDesk, you can connect framework labels to
instruments. The framework labels are independent of structural changes in the
simulation model. The connection to a variable of the simulation application is
established via an mapped testbench label that contains the variable path.

If structural changes to the simulation model are made, it is sufficient to reload

the variable description and the related XIL mapping file . You do not have to
replace any connections because the framework labels remain unchanged and
the test automation tools automatically resolve the framework labels to the new
testbench labels.

Components of XIL mappings The XIL mapping feature is based on the following components:

Framework label A framework label is an abstract identifier. You can use

framework labels according to ASAM XIL in test automation tools to map
instruments and scripts.
A framework label is defined by the following information:
§ A unique label name (ID).
§ A data type.

11
May 2024 Getting Started with XIL Mapping
 Introduction to XIL Mapping

Testbench label A testbench label is a concrete and simulator‑dependent

identifier. You can use testbench labels according to ASAM XIL to identify
variables on the test bench.
A testbench label is defined by the following information:
§ A unique label name (ID) for each testbench port. That means that the same
ID can exist on different ports. For more information, refer to Appendix on
page 37.
dSPACE uses the variable path in the variable description file as testbench label
ID.
§ A data type.

Label mapping You can use label mappings according to ASAM XIL to
map framework labels (identifiers) to testbench labels (identifiers).
A label mapping is defined by the following information:
§ A testbench label reference with a port ID.
§ A framework label reference.

In the appendix, you can find an excerpt of an XIL mapping file. Refer to ASAM
XIL Standard and Mapping at dSPACE on page 40.

Related topics Basics

ASAM XIL Standard.................................................................................................................. 37

ASAM XIL Standard and Mapping at dSPACE............................................................................ 40
XIL Mapping Tool Chain for HIL Simulations.............................................................................. 13
XIL Mapping Tool Chain for SIL Simulations.............................................................................. 18

12
Getting Started with XIL Mapping May 2024
 XIL Mapping Tool Chains

XIL Mapping Tool Chains

Where to go from here Information in this section

XIL Mapping Tool Chain for HIL Simulations............................................. 13

To enable the use of XIL mappings in test automation tools such as
AutomationDesk and ControlDesk, dSPACE has integrated XIL mapping
into the HIL tool chain.

XIL Mapping Tool Chain for SIL Simulations............................................. 18

To enable the use of XIL mappings in test automation tools such
as AutomationDesk and ControlDesk, dSPACE has integrated the XIL
mapping feature into the SIL tool chain.

XIL Mapping Tool Chain for HIL Simulations

Introduction To enable the use of XIL mappings in test automation tools such as
AutomationDesk and ControlDesk, dSPACE has integrated the XIL mapping
feature into the HIL tool chain.

13
May 2024 Getting Started with XIL Mapping
 XIL Mapping Tool Chains

Overview

Generating Merging Using Simulation

XIL mappings XIL mappings XIL mappings platforms
ApplTools
TA Library

XIL mapping

ApplTools
XILMapper
Simulink

AutomationDesk

XIL mapping

Access simulation
XIL mapping variables via
Bus Manager XIL mappings

ConfigurationDesk
I/O functions dSPACE XIL API

XIL mapping

ApplTools
XIL Mapper

ConfigurationDesk

ControlDesk
Ethernet
Configuration XIL mapping
Package

The XIL mapping workflow for HIL simulations can be divided into the following
steps:
§ Generating XIL mappings with different tools. Refer to Generating XIL
mappings on page 15.
§ Merging XIL mappings from different tools to generate an overall XIL mapping
file via ConfigurationDesk. Refer to Merging XIL mappings on page 15.
§ Using XIL mappings in test automation tools and accessing variables of the
simulation application via XIL mappings. Refer to Using XIL mappings on
page 16.

14
Getting Started with XIL Mapping May 2024
 XIL Mapping Tool Chain for HIL Simulations

Generating XIL mappings Generating XIL mappings is the first step. In the following illustration, you can
view the tools that generate XIL mappings for HIL simulations:

FlexRayTM
ApplTools TA Library Configuration ApplTools
and XILMapper Package XILMapper

Ethernet
Configuration
Package

Bus Manager

Model SIC BSC Bus configuration BSC

XIL mappings for:

FlexRay bus configuration elements Simulations variables Bus configuration function ports
I/O functionality Ethernet configuration elements

Bus Manager To implement XIL mappings in your bus communication, the

Bus Manager generates XIL mappings for bus configuration function ports.
Refer to Bus Manager on page 25.

ConfigurationDesk In ConfigurationDesk, the ApplTools XILMapper from the

ApplTools Solution implements XIL mappings for the I/O functionality on build.
Refer to ConfigurationDesk on page 26.

Ethernet Configuration Package To implement XIL mappings in your

Ethernet networks, the Ethernet Configuration Package provides a feature to
generate XIL mappings for network configuration elements. Refer to Ethernet
Configuration Package on page 31.

FlexRay Configuration Package To implement XIL mappings in your FlexRay

networks, you can use the ApplTools XILMapper from the ApplTools Solution.
Refer to FlexRay Configuration Package on page 32.

MATLAB/Simulink To implement XIL mappings in your simulation models ,

you can use the ApplTools TA Library and the ApplTools XILMapper from
the ApplTools Solution in MATLAB®/Simulink®. Refer to MATLAB/Simulink on
page 33.

Merging XIL mappings Merging XIL mappings is the second step. In the following illustration, you can
view the input and the merging of XIL mappings to generate an overall XIL
mapping file via ConfigurationDesk:

15
May 2024 Getting Started with XIL Mapping
 XIL Mapping Tool Chains

Ethernet
Configuration
Package

Bus Manager

Model SIC BSC Bus configuration BSC

Input

ApplTools
XILMapper

Build

RTA, TRC
Overall XIL
mapping file

XIL mappings for:

FlexRay bus configuration elements Simulation variables Bus configuration function ports
I/O functionality Ethernet configuration elements

ConfigurationDesk ConfigurationDesk is the central tool in the XIL mapping

tool chain. It merges several XIL mapping files to generate an overall XIL
mapping file. Refer to ConfigurationDesk on page 26.

Using XIL mappings Using XIL mappings is the third step. In the following illustration, you can view
the tools that use XIL mappings to access variables of a simulation application:

16
Getting Started with XIL Mapping May 2024
 XIL Mapping Tool Chain for HIL Simulations

RTA, TRC
Overall XIL
mapping file

Import

dSPACE XIL API

Access variables
via XIL mappings

SCALEXIO dSPACE

-XS9

-XS7

T1-4

dSPACE dSPACE dSPACE dSPACE dSPACE dSPACE dSPACE dSPACE dSPACE dSPACE

DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1 DS5481F1

C2+ C2+ C2+ C2+ C2+ C2+ C2+ C2+ C2+ C2+ C2+ C2+

C2- C2- C2- C2- C2- C2- C2- C2- C2- C2- C2-

C1+ C1+ C1+ C1+ C1+ C1+ C1+ C1+ C1+ C1+

C1- C1- C1- C1- C1- C1- C1- C1- C1- C1- C1-

SPARE

-XS11
TDK•Lambda ISO-SPI

SPARE
POWER

SPARE

-XS6 -XS10
LV01 LV02

E
A

SPARE

-XS3
RTPC
A

E
A

dSPACE

SC-Power Supply
+12V

DC OK
Overvoltage

XIL mappings for:

FlexRay bus configuration elements Simulation variables Bus configuration function ports
I/O functionality Ethernet configuration elements

AutomationDesk To access variables via XIL mappings, AutomationDesk

provides a feature to import XIL mappings. Refer to AutomationDesk on
page 24.

ControlDesk To access variables via XIL mappings, ControlDesk provides a

feature to import XIL mappings. Refer to ControlDesk on page 28.

dSPACE XIL API You can use the dSPACE XIL API to access variables via XIL
mappings. Refer to dSPACE XIL API on page 30.

Related topics Basics

Tool Chain Products.................................................................................................................. 23

XIL Mapping Concepts and Benefits........................................................................................... 9
XIL Mapping Tool Chain for SIL Simulations.............................................................................. 18

17
May 2024 Getting Started with XIL Mapping
 XIL Mapping Tool Chains

XIL Mapping Tool Chain for SIL Simulations

Introduction To enable the use of XIL mappings in test automation tools such as
AutomationDesk and ControlDesk, dSPACE has integrated the XIL mapping
feature into the SIL tool chain.

Tool chain overview

Generating Merging Using Simulation

XIL mappings XIL mappings XIL mappings platforms
ApplTools
TA Library

XIL mapping

ApplTools
XILMapper
ApplTools
Simulink XILMapper
AutomationDesk
Access simulation
XIL mapping variables via
XIL mappings

XIL mapping
VEOS
dSPACE XIL API
Bus Manager

Ethernet
Configuration XIL mapping
Package ControlDesk

The XIL mapping workflow for SIL simulations can be divided into the following
steps:
§ Generating XIL mappings with different tools. Refer to Generating XIL
mappings on page 19.
§ Merging XIL mappings from different tools to generate an overall XIL mapping
file with VEOS and the ApplTools XILMapper. Refer to Merging XIL mappings
on page 19.
§ Using XIL mappings in test automation tools and accessing variables of the
simulation application via XIL mappings. Refer to Using XIL mappings on
page 20.

18
Getting Started with XIL Mapping May 2024
 XIL Mapping Tool Chain for SIL Simulations

Generating XIL mappings Generating XIL mappings is the first step. In the following illustration, you can
view the tools that generate XIL mappings for SIL simulations:
ApplTools TA Library
and XILMapper

Ethernet
Configuration
Package

Bus Manager

SIC BSC BSC

XIL mappings for:

Simulations variables Bus configuration function ports
Ethernet configuration elements

Bus Manager To implement XIL mappings in your bus communication, the

Bus Manager generates XIL mappings for bus configuration function ports.
Refer to Bus Manager on page 25.

Ethernet Configuration Package To implement XIL mappings in your

Ethernet networks, the Ethernet Configuration Package provides a feature to
generate XIL mappings for network configuration elements. Refer to Ethernet
Configuration Package on page 31.

MATLAB/Simulink To implement XIL mappings in your simulation model,

you can use the ApplTools TA Library and the ApplTools XILMapper from
the ApplTools Solution in MATLAB®/Simulink®. Refer to MATLAB/Simulink on
page 33.

Merging XIL mappings Merging XIL mappings is the second step. In the following illustration, you can
view the import and the merging of XIL mappings to generate an overall XIL
mapping file with VEOS and the ApplTools XILMapper:

19
May 2024 Getting Started with XIL Mapping
 XIL Mapping Tool Chains

Ethernet
Configuration
Package

Bus Manager

SIC BSC BSC

Import

VEOS

Build

OSA, TRC

ApplTools
XILMapper

Build

OSA, TRC
Overall XIL
mapping file

XIL mappings for:

Simulation variables Bus configuration function ports

Ethernet configuration elements

VEOS VEOS is the central tool for SIL testing. With the ApplTools
XILMapper, you can generate an overall XIL mapping file for a related offline
simulation application (OSA). The ApplTools XILMapper merges several XIL
mapping files to generate an overall XIL mapping file. Refer to VEOS on
page 34.

Using XIL mappings Using XIL mappings is the third step. In the following illustration, you can view
the tools that use XIL mappings to access variables of a simulation application:

20
Getting Started with XIL Mapping May 2024
 XIL Mapping Tool Chain for SIL Simulations

OSA, TRC

Import

ControlDesk AutomationDesk dSPACE XIL API

Accessing variables via

XIL mappings

XIL mappings for:

Simulations variables Bus configuration function ports
Ethernet configuration elements

AutomationDesk To access variables via XIL mappings, AutomationDesk

provides a feature to import XIL mappings. Refer to AutomationDesk on
page 24.

ControlDesk To access variables via XIL mappings, ControlDesk provides a

feature to import XIL mappings. Refer to ControlDesk on page 28.

dSPACE XIL API You can use the dSPACE XIL API to access variables via XIL
mappings. Refer to dSPACE XIL API on page 30.

Related topics Basics

Tool Chain Products.................................................................................................................. 23

XIL Mapping Concepts and Benefits........................................................................................... 9
XIL Mapping Tool Chain for HIL Simulations.............................................................................. 13

21
May 2024 Getting Started with XIL Mapping
 XIL Mapping Tool Chains

22
Getting Started with XIL Mapping May 2024
 Tool Chain Products

Tool Chain Products

Where to go from here Information in this section

AutomationDesk..................................................................................... 24
AutomationDesk lets you use XIL mappings to implement and execute
automation tasks.

Bus Manager........................................................................................... 25
The Bus Manager lets you generate XIL mappings to access the variables
that are available for bus configuration function ports.

ConfigurationDesk.................................................................................. 26
The ApplTools XILMapper generates XIL mappings for the I/O
functionality implemented in ConfigurationDesk. ConfigurationDesk
itself merges all XIL mappings to generate an overall XIL mapping file.

ControlDesk............................................................................................ 28
ControlDesk lets you add XIL mappings to your current experiment. You
can use the framework labels of XIL mappings, for example, to connect
instruments without an existing platform and variable description.

dSPACE XIL API........................................................................................ 30

The dSPACE XILMappingParser reads XIL mapping files and makes
them usable with the dSPACE XIL API. The dSPACE XIL API lets you
automate the access to variables of a simulation application on a dSPACE
simulation platform without using another dSPACE software product,
such as ControlDesk.

Ethernet Configuration Package.............................................................. 31

The Ethernet Configuration Package lets you generate XIL mappings
to access the variables that are available for Ethernet configuration
elements.

FlexRay Configuration Package................................................................ 32

The ApplTools TA Library and the ApplTools XILMapper let you create XIL
mappings for FlexRay bus configuration elements in MATLAB/Simulink.

MATLAB/Simulink.................................................................................... 33
In MATLAB/Simulink, you can use the ApplTools TA Library and the
ApplTools XILMapper of the ApplTools Solution to generate XIL mappings
for simulation variables.

23
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

VEOS....................................................................................................... 34
You can build an offline simulation application (OSA) with VEOS and the
ApplTools XILMapper lets you merge and generate an XIL mapping file
for the OSA.

AutomationDesk

Introduction AutomationDesk lets you use XIL mappings to implement and execute
automation tasks. AutomationDesk lets you also generate XIL mappings.

Integration into XIL mapping In the XIL mapping tool chain, AutomationDesk is a tool that accesses variables
tool chain of the simulation application via XIL mappings. AutomationDesk lets you also
generate and export XIL mapping files .
RTA, TRC

OSA, TRC
Simulation platform
Access variables
Input (XIL API MAPort,
via XIL mappings
SCALEXIO, VEOS ...)
*
*
(optional)
Additional XIL
mapping

*In AutomationDesk, you can import and generate additional XIL mappings.

XIL mappings for:

FlexRay bus configuration elements Simulation variables Bus configuration function ports
I/O functionality Ethernet configuration elements

Input AutomationDesk can get the following input:

§ The overall XIL mapping file for the simulation application .
§ Import of additional XIL mapping files.

Result AutomationDesk lets you do the following with XIL mappings:

§ Access variables of the simulation application.
§ Generate XIL mapping files with the Mapping Editor. Refer to How to
Specify the Variable Mapping of a Framework Configuration (AutomationDesk
Accessing Simulation Platforms ). AutomationDesk lets you also export XIL
mapping files.

Use cases for XIL mappings In AutomationDesk, you can use XIL mappings for the following use cases:
§ Developing tests that are robust against structural changes in the simulation
model .

24
Getting Started with XIL Mapping May 2024
 Bus Manager

§ Developing tests that can be reused with minimal to no migration effort, e.g.,
when changing from SIL to HIL simulation.
§ Developing tests at an early stage of development, even without a device
under test or simulation model.

Related topics Basics

Working with an XIL API Framework (AutomationDesk Accessing Simulation

Platforms )

Bus Manager

Introduction The Bus Manager lets you generate XIL mappings to access the variables that
are available for bus configuration function ports.

Integration into XIL mapping In the XIL mapping tool chain, the Bus Manager is a tool that generates XIL
tool chain mapping files .

Generating BSC BSC

SIC

Input Output
Model

Bus configuration

Bus Manager On build in

ConfigurationDesk*

*Only available for Bus Manager in ConfigurationDesk.

XIL mappings for:

Simulation variables
Bus configuration function ports

Input The Bus Manager can get the following input:

§ A Simulink implementation container (SIC) file including an XIL mapping file
(optional).
§ A simulation model and a related XIL mapping file (optional and only with
the Bus Manager in ConfigurationDesk).

Output The Bus Manager can generate the following output:

§ A bus simulation container (BSC) file. The BSC file contains an XIL mapping
file with all mappings generated by the Bus Manager. If the BSC file is
generated with an SIC file, the XIL mappings of the SIC file are transferred
unchanged to the BSC file.
§ XIL mappings for applicable bus configuration function ports (only with
the Bus Manager in ConfigurationDesk). These XIL mappings are merged

25
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

in ConfigurationDesk to generate an overall XIL mapping file. Refer to

ConfigurationDesk on page 26.

Generating XIL mappings The Bus Manager generates XIL mappings for each variable of bus configuration
function ports that is available in the variable description file (TRC file). To
generate the required framework label IDs, the Bus Manager uses a default
template. You can configure the template according to your requirements. Refer
to Using TRC File Variables for XIL Mapping (ConfigurationDesk Bus Manager
Implementation Guide ).

Related topics Basics

Using TRC File Variables for XIL Mapping (ConfigurationDesk Bus Manager
Implementation Guide )

ConfigurationDesk

Introduction The ApplTools XILMapper generates XIL mappings for the I/O functionality
implemented in ConfigurationDesk. ConfigurationDesk itself merges all XIL
mappings to generate an overall XIL mapping file .

Integration into XIL mapping ConfigurationDesk is the central tool in the HIL tool chain. On build, the
tool chain ApplTools XILMapper generates an XIL mapping file for the I/O functionality and
ConfigurationDesk merges all XIL mappings to generate an overall XIL mapping
file.

26
Getting Started with XIL Mapping May 2024
 ConfigurationDesk

Model

SIC

ApplTools
BSC XILMapper

** RTA, TRC
Overall XIL
Bus configuration Input Output mapping file
*
Bus Manager

Ethernet BSC
Configuration
Package

*If you use the Bus Manager in ConfigurationDesk, the XIL mappings for bus configurations are generated on build.
**The ApplTools XILMapper generates XIL mappings for the I/O functionality on build.

XIL mappings for:

FlexRay bus configuration elements Simulations variables Bus configuration function ports
I/O functionality Ethernet configuration elements

Input ConfigurationDesk can get the following input:

§ The ApplTools XILMapper provides an XIL mapping file for the I/O functionality
implemented in ConfigurationDesk.
§ A Simulink implementation container with a related XIL mapping file that
contains information to access variables of the simulation model .
§ A simulation model with related XIL mapping files:
§ An XIL mapping file that contains information to access variables of the
simulation application.
§ An XIL mapping file that contains information to access variables of FlexRay
bus configuration elements.
§ A bus simulation container (BSC) from the Bus Manager with a related XIL
mapping file that contains information to access variables of bus configuration
function ports. If the BSC file is generated with an SIC file, it also contains the
related XIL mapping files.
§ If you use the Bus Manager in ConfigurationDesk, an XIL mapping file that
contains information to access variables of bus configuration function ports is
generated on build of the real‑time application.
§ A BSC file from the Ethernet Configuration Package with a related XIL
mapping file that contains information to access variables of Ethernet
configuration elements.

Output ConfigurationDesk generates the following output on build:

§ An overall XIL mapping file. This file contains the merged XIL mappings
provided by various simulation components. Refer to Generating overall XIL
mapping file on page 28.

27
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

Generating XIL mappings for The ApplTools XILMapper from the ApplTools Solution generates XIL mappings
I/O functionality for the I/O functionality implemented in ConfigurationDesk. You can enable
the generation of XIL mappings for the I/O functionality via the XILMapperGUI
available in the ConfigurationDesk User Functions ribbon group.

The XILMapper uses a fixed template to generate unique framework label IDs.

Generating overall XIL On build, ConfigurationDesk merges XIL mappings provided by various
mapping file simulation components to generate an overall XIL mapping file.

RTA, TRC
Overall XIL
mapping file

The resulting overall XIL mapping file is located in the Build Results folder with
the name:
<real‑time application name>.xilmapping.xml

Related topics Basics

Using Elements that Provide XIL Mapping Files (ConfigurationDesk Real-Time

Implementation Guide )
XIL Mapping Tool Chain for HIL Simulations.............................................................................. 13

ControlDesk

Introduction ControlDesk lets you add XIL mappings to your current experiment. You can
use the framework labels of XIL mappings, for example, to frontload the
creation of layouts and instruments. If you later add a platform and a variable
description, ControlDesk automatically assigns the testbench labels to the
variable description.

28
Getting Started with XIL Mapping May 2024
 ControlDesk

Integration into XIL mapping In the XIL mapping tool chain, ControlDesk is a tool that accesses variables of the
tool chain simulation application via XIL mappings.

OSA, TRC

RTA, TRC
Simulation platform
Access variables
Input (XIL API MAPort,
via XIL mappings
SCALEXIO, VEOS ...)
*
(optional)

Additional XIL
mapping

*In ControlDesk, you can import additional XIL mappings.

XIL mappings for:

FlexRay bus configuration elements Simulation variables Bus configuration function ports
I/O functionality Ethernet configuration elements

Input ControlDesk can get the following input:

§ The overall XIL mapping file for the simulation application.
§ Import of additional XIL mapping files.

Result ControlDesk lets you access the variables of the active variable
description for each platform/device via XIL mappings.

Experimenting with XIL ControlDesk provides the following methods to import XIL mappings:
mappings § Automatic import of overall XIL mapping files from ConfigurationDesk
(preview feature). Refer to Basics on Variable Mappings (ControlDesk Variable
Management ).
§ Manual import of XIL mapping files via the Mappings folder in the Project
pane.

Use cases In ControlDesk, you can use XIL mappings for the following use
cases:
§ You can frontload the creation of layouts and instruments. Framework labels
can be connected to instruments before a variable description file is available.
§ Structural changes to a simulation model and the resulting changes to the
variable description created for that model have no impact on the visualization
of the related variables on layouts and instruments.

Related topics Basics

Connecting Variables and Framework Labels to Instruments (ControlDesk

Layouting )
Working with Variable Mappings (ControlDesk Variable Management )

29
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

dSPACE XIL API

Introduction The dSPACE XILMappingParser reads XIL mapping files and makes them
usable with the dSPACE XIL API. The dSPACE XIL API lets you automate
the access to variables of a simulation application on a dSPACE simulation
platform without using another dSPACE software product, such as
ControlDesk.

Integration into XIL mapping In the XIL mapping tool chain, the dSPACE XIL API is a tool that accesses
tool chain variables of the simulation application via XIL mappings.

RTA, TRC

OSA, TRC
Simulation platform
Access variables
XILMappingParser Input (SCALEXIO, VEOS)
via XIL mappings
*
(optional)

Additional XIL
dSPACE XIL API
mapping

*With the dSPACE XIL API, you can use additional XIL mappings.

XIL mappings for:

FlexRay bus configuration elements Simulation variables Bus configuration function ports
I/O functionality Ethernet configuration elements

Input The XILMappingParser reads XIL mapping files and makes XIL mappings
usable with the dSPACE XIL API.
The dSPACE XIL API can get the following input:
§ The overall XIL mapping file for the simulation application.
§ Import of additional XIL mapping files.

Result The dSPACE XIL API lets you access the variables of a simulation
application on a dSPACE simulation platform via XIL mappings.

Use cases for XIL mappings You can use XIL mappings and the dSPACE XIL API for the following use cases:
§ Developing tests that are robust against structural changes in the simulation
model .
§ Developing tests that can be reused with minimal to no migration effort.
§ Developing tests at an early stage of development, even without a device
under test or simulation model.

30
Getting Started with XIL Mapping May 2024
 Ethernet Configuration Package

Related topics Basics

Using the XIL Mapping Parser (dSPACE XIL API MAPort Implementation )

Ethernet Configuration Package

Introduction The Ethernet Configuration Package lets you generate XIL mappings to access
the variables that are available for Ethernet configuration elements.

Note

The Ethernet Configuration Package is not part of the dSPACE

Release, but is distributed separately. For more information on
the Ethernet Configuration Package, contact dSPACE Support
(www.dspace.com/go/supportrequest).

Integration into XIL mapping In the XIL mapping tool chain, the Ethernet Configuration Package is a tool that
tool chain generates XIL mapping files .

Ethernet BSC
Configuration Output
Package

XIL mappings for:

Ethernet configuration elements

Input The Ethernet Configuration Package gets no input from other tools in
the XIL mapping tool chain.

Output If a bus simulation container (BSC) file is generated, the BSC file
contains an XIL mapping file with all XIL mappings generated by the Ethernet
Configuration Package.

Generating XIL mappings The Ethernet Configuration Package generates XIL mappings for Ethernet
configuration elements. The Ethernet Configuration Package uses a fixed
template to generate unique framework label IDs.

31
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

FlexRay Configuration Package

Introduction The ApplTools TA Library and the ApplTools XILMapper let you create XIL
mappings for FlexRay bus configuration elements in MATLAB®/Simulink®.

Integration into XIL mapping In the XIL mapping tool chain, the FlexRay Configuration Package is a tool
tool chain that generates XIL mappings via the ApplTools TA Library and the ApplTools
XILMapper.
ApplTools TA Library
and XILMapper

Model
Output
FlexRayTM
Configuration
Package

XIL mappings for:

FlexRay bus configuration elements
Simulation variables

Input The FlexRay Configuration Package gets no input from other tools in
the XIL mapping tool chain.

Output If you import a simulation model with a FlexRay configuration

in ConfigurationDesk, the ApplTools XILMapper generates the related XIL
mappings.

Generating XIL mappings The following listing shows the workflow to create XIL mappings for FlexRay bus
configuration elements via the ApplTools TA Library, the ApplTools XILMapper,
and the FlexRay Configuration Package in MATLAB/Simulink:
§ Activate the automatic generation of XIL mappings in the TASetup block.
§ Add a FlexRay model update block to your simulation model.
§ If you import the simulation model in ConfigurationDesk, the ApplTools
XILMapper generates an XIL mapping file as input for ConfigurationDesk. The
XIL mapping file is also located in MATLAB's current directory with the name:
<model name>_FlexRay.xilmapping.xml
where:
<model name> is the name of your simulation model.
The ApplTools XILMapper uses a fixed template to generate unique framework
label IDs.

Related topics Basics

MATLAB/Simulink..................................................................................................................... 33

32
Getting Started with XIL Mapping May 2024
 MATLAB/Simulink

MATLAB/Simulink

Introduction In MATLAB®/Simulink®, you can use the ApplTools TA Library and the ApplTools
XILMapper of the ApplTools Solution to generate XIL mappings for simulation
variables.

Integration into XIL mapping In the XIL mapping tool chain, Simulink is a tool that generates XIL mapping
tool chain files via the ApplTools TA Library and the ApplTools XILMapper.

Input A connection to a pool of framework labels or a framework label list.

Output Simulink, the ApplTools TA Library, and the ApplTools XILMapper can
generate the following output:
§ A Simulink implementation container (SIC) file. The SIC file contains an XIL
mapping file with all XIL mappings generated by the ApplTools XILMapper.
§ A simulation model with a related XIL mapping file if you import the
simulation model in ConfigurationDesk.

Generating XIL mappings The following listing shows the workflow to generate XIL mappings with the
ApplTools TA Library and the ApplTools XILMapper in MATLAB/Simulink:
§ Place blocks of the TA Library into Simulink's signal path.
§ Define unique signal names (framework label IDs) for each block. You can also
import framework labels from a pool of framework labels.
§ Activate the automatic generation of XIL mappings in the TASetup block.
§ If you build an SIC file, the XIL Mapper integrates the XIL mapping file into the
SIC file. The XIL mapping file is also located in MATLAB's current directory with
the name:
<model name>.xilmapping.xml
where:
<model name> is the name of your Simulink model.

§ If you import the simulation model in ConfigurationDesk without building

an SIC file first, the XIL Mapper creates an XIL mapping file as input for
ConfigurationDesk.

33
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

For more information, contact dSPACE Support

(www.dspace.com/go/supportrequest).

VEOS

Introduction You can build an offline simulation application (OSA) with VEOS and the
ApplTools XILMapper lets you merge and generate an XIL mapping file for the
OSA.

Integration into XIL mapping VEOS is the central tool in the SIL tool chain. In a first step, VEOS lets you
tool chain import SIC and BSC files to build an OSA file.

SIC

BSC OSA, TRC

Input Output

Bus Manager
VEOS

Ethernet BSC
Configuration
Package

XIL mappings for:

Simulation variables Bus configuration function ports
Ethernet configuration elements

Input VEOS imports SIC and BSC files, and includes them in an OSA file.
VEOS gets the following input:
§ A Simulink implementation container (SIC) file.
§ A bus simulation container (BSC) file from the Bus Manager with an
integrated XIL mapping file containing all mappings of the bus configuration
elements.
§ A bus simulation container (BSC) file from the Ethernet Configuration Package
with an integrated XIL mapping file containing all mappings of the Ethernet
configuration.

34
Getting Started with XIL Mapping May 2024
 VEOS

Output The output of VEOS is an OSA file. In a second step, the ApplTools
XILMapper is needed to merge XIL mappings provided by various simulation
components to generate an overall XIL mapping file .

Generating overall XIL The ApplTools XILMapper is needed to merge XIL mapping files of various
mapping file simulation components to generate an overall XIL mapping file. The OSA file
provides the paths to the SIC and the BSC files used in the build process and the
XILMapper merges the contained XIL mapping files.

OSA, TRC OSA, TRC

ApplTools
Input Output
XILMapper

VEOS

XIL mappings for:

Bus configuration function ports Simulation variables
Ethernet configuration elements

The resulting overall XIL mapping file is located in the same directory as the OSA
file with the name:
Merged.xilmapping.xml

Note

Building the OSA and generating the overall XIL mapping file should be
done on the same PC, otherwise it is possible that the ApplTools XILMapper
cannot find the paths to the SIC and BSC files and the related XIL mappings.

Related topics Basics

XIL Mapping Tool Chain for SIL Simulations.............................................................................. 18

35
May 2024 Getting Started with XIL Mapping
 Tool Chain Products

36
Getting Started with XIL Mapping May 2024
 Appendix

Appendix

Where to go from here Information in this section

ASAM XIL Standard................................................................................. 37

ASAM XIL is a standard for the communication between test automation
tools and test benches, which lets you decouple test automation tools
from real and virtual test benches.

ASAM XIL Standard and Mapping at dSPACE................................ .......... 40

dSPACE provides the mapping feature regardless of whether you access
your test bench via the dSPACE XIL API implementation or by a
proprietary interface.

ASAM XIL Standard

Introduction ASAM XIL is a standard for the communication between test automation tools
and test benches, which lets you decouple test automation tools from real and
virtual test benches. The character "X" in XIL represents that the standard can
be used at all development stages, which includes hardware‑in‑the‑loop (HIL) ,
model‑in‑the‑loop (MIL), and software‑in‑the‑loop (SIL) simulations.

The decoupling of test automation tools and test benches lets you reuse test
cases from one test automation tool on different test systems with minimal to no
migration efforts.

Proprietary systems Commonly test automation tools are rigidly connected to test systems of the
same manufacturer. The communication between test automation tools and
test benches is realized by proprietary interfaces and a great deal of effort is
necessary to transfer a test case from one test system to another.

37
May 2024 Getting Started with XIL Mapping
 Appendix

System A System Z

Test automation tool A Test automation tool Z

Test case 1 Test case n Test case 1 Test case m

Proprietary interface Proprietary interface

Test bench of system A Test bench of system Z

Decoupling of test The ASAM XIL standard lets you decouple test automation tools from test
automation tools from test benches. This enables you to transfer test cases of a test automation tool to
benches different test benches.

Test automation tool A Test automation tool Z

Test case 1 Test case n Test case 1 Test case m

ASAM XIL Standard

Test bench A
Test bench B
Test bench C
Test bench ...

To achieve the decoupling of test automation tools and test benches, the ASAM
XIL standard has the following two major components:
§ The Testbench API to provide port‑based access to the test bench.
§ The Framework API to provide functionality such as mapping of variables,
data types, and units as well as managing of port‑based communication to the
test bench.

The XIL mapping feature is supported only by the Framework API.

Mapping The mapping feature provides the functionality to map an abstract identifier
on the framework side (framework label ) to a concrete identifier on the test
bench side (testbench label ). Mapping also provides the possibility to handle
different physical units and data types on the framework and the test bench
sides.

38
Getting Started with XIL Mapping May 2024
 ASAM XIL Standard

The basic principle of the mapping feature according to the ASAM XIL standard
is shown in the following illustration:

Test case

Framework Labels

Test automation tool

Label mapping list

Framework label list Label mapping 1 Testbench label list +
port ID
Reference to Reference to testbench
Framework label 1 framework label label + port ID Testbench label 1

Framework label 2 Testbench label 2

Label mapping n
Framework label n Reference to Reference to testbench Testbench label n
framework label label + port ID

Framework

Assignment via port ID

ECUCPort ECUMPort MAPort NetworkPort

Simulation
ECU ECU Networks
application

Calibration Measurement
Variables Signals
values variables

Part of the testbench Part of the testbench Part of the testbench Part of the testbench

Framework label You can use framework labels according to ASAM XIL in
test automation tools.
A framework label is defined by the following information:
§ A unique label name (ID).
§ A data type.

Testbench label You can use testbench labels according to ASAM XIL to
identify variables on the test bench.
A testbench label is defined by the following information:
§ A unique label name (ID) for each testbench port. This means that the same ID
can exist on different ports.
§ A data type.

39
May 2024 Getting Started with XIL Mapping
 Appendix

Label mapping You can use label mappings according to ASAM XIL to
map framework labels (identifiers) to testbench labels (identifiers). Mapping of
strings and rasters is also possible.
A label mapping is defined by the following information:
§ A testbench label reference with a port ID.
§ A framework label reference.

ASAM documentation If you installed the Test Automation product set, you have access to the user
documentation for the dSPACE XIL API .NET implementation. These documents
provide basic information on the ASAM XIL standard and its dSPACE-specific
implementation.

Refer to:
§ dSPACE XIL API MAPort Implementation
§ dSPACE XIL API ECUPort Implementation

Related topics Basics

Basics on SIL Testing (SIL Testing Overview )

Using a SCALEXIO System for Hardware-in-the-Loop Simulation (SCALEXIO
Hardware Installation and Configuration )
XIL Mapping Concepts and Benefits........................................................................................... 9

ASAM XIL Standard and Mapping at dSPACE

Introduction dSPACE provides the following possibilities to access a test bench from a test
automation tool:
§ dSPACE XIL API implementation
§ Proprietary interface

You can use the mapping feature regardless if you access your test bench via the
dSPACE XIL API or by a proprietary interface.

Mapping with the dSPACE XIL The mapping feature in the dSPACE XIL API is currently restricted to the MAPort.
API The basic principle of the mapping feature with the dSPACE XIL API is shown in
the following illustration:

40
Getting Started with XIL Mapping May 2024
 ASAM XIL Standard and Mapping at dSPACE

Test case

Framework Labels

Test automation tool

Label mapping list

Framework label list Label mapping 1 Testbench label list +
port ID
Reference to Reference to testbench
Framework label 1 framework label label + port ID Testbench label 1

Framework label 2 Testbench label 2

Label mapping n
Framework label n Reference to Reference to testbench Testbench label n
framework label label + port ID

Framework

MAPort

Simulation application

Variables

dSPACE simulation platform

Mapping with a proprietary If you use a proprietary interface to access a dSPACE simulation platform, the
interface mapping feature is directly implemented in the test automation tool as shown in
the following illustration:

41
May 2024 Getting Started with XIL Mapping
 Appendix

Test case

Framework Labels

Label mapping list

Framework label list Label mapping 1 Testbench label list +
port ID
Reference to Reference to testbench
Framework label 1 framework label label + port ID Testbench label 1

Framework label 2 Testbench label 2

Label mapping n
Framework label n Reference to Reference to testbench Testbench label n
framework label label + port ID

dSPACE test automation tool

Proprietary interface

Simulation application

Variables

dSPACE simulation platform

Mapping file To implement the XIL mapping feature, the following information is needed in
one or more mapping files :
§ Framework labels .
§ Testbench labels .
§ Label mappings .

In the following example, you can view a mapping file with a single mapping
from the Scalexio demo in ControlDesk:

42
Getting Started with XIL Mapping May 2024
 ASAM XIL Standard and Mapping at dSPACE

<?xml version="1.0" encoding="utf-8"?>

<!--Root element of the mapping-->
<Mapping xmlns="http://www.asam.net/XIL/Mapping/2.2.0"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<!--FrameworkLabelList: Contains the framework labels (abstract identifiers)

used in test automation tools (framework side)-->
<FrameworkLabelList Description="">
<FrameworkLabel Id="SignalGen_Output" Type="FloatVariable" />
</FrameworkLabelList>

<!--TestbenchLabelList: Contains the testbench labels (concrete identifiers)

and a port ID used on the testbench side-->
<TestbenchLabelList Description="" PortId="Platform">
<TestbenchLabel Id="Platform()://Model Root/SignalGenerator/SignalGenerator/SignalGenOutput">
<TestbenchSimpleType Type="FloatValue">
<Metadata IsWritable="false" />
</TestbenchSimpleType>
</TestbenchLabel>
</TestbenchLabelList>

<!--MappingTable with LabelMappings: Maps framework labels to

testbench labels-->
<MappingTable Description="">
<LabelMappingList>
<LabelMapping>
<TestbenchLabelReference LabelId="Platform()://Model Root/SignalGenerator/SignalGenerator/SignalGenOutput">
<FromSimple>
<OneToOne/>
</FromSimple>
</TestbenchLabelReference>
<FrameworkLabelReference LabelId="SignalGen_Output"/>
</LabelMapping>
</LabelMappingList>
</MappingTable>
</Mapping>

Related topics Basics

Basics on SIL Testing (SIL Testing Overview )

Using a SCALEXIO System for Hardware-in-the-Loop Simulation (SCALEXIO
Hardware Installation and Configuration )
XIL Mapping Concepts and Benefits........................................................................................... 9

43
May 2024 Getting Started with XIL Mapping
 Appendix

44
Getting Started with XIL Mapping May 2024
 Glossary

Glossary

Introduction The glossary briefly explains the most important expressions and naming
conventions used in the context of XIL mapping.

Where to go from here Information in this section

B............................................................................................................. 45

E............................................................................................................. 46

F.............................................................................................................. 46

H............................................................................................................. 46

L.............................................................................................................. 47

O............................................................................................................. 47

S............................................................................................................. 47

T............................................................................................................. 48

V............................................................................................................. 48

X............................................................................................................. 48

Bus Manager
§ Bus Manager in ConfigurationDesk
A ConfigurationDesk component that lets you configure bus communication
and implement it in real‑time applications or generate bus simulation
containers .

45
May 2024 Getting Started with XIL Mapping
 Glossary

§ Bus Manager (stand-alone)

A dSPACE software product based on ConfigurationDesk that lets you
configure bus communication and generate bus simulation containers.

Bus simulation container A container that contains bus communication

configured with the Bus Manager or the Ethernet Configuration Package.
Bus simulation container (BSC) files that are generated with the Bus Manager
contain CAN and/or LIN communication, BSC files generated with the Ethernet
Configuration Package contain Ethernet communication.
Depending on the contained bus communication, BSC files can be used in
VEOS , in ConfigurationDesk, and/or in RTMaps:
§ In VEOS, they let you implement the bus communication in an offline
simulation application to perform SIL simulation on VEOS.
§ In ConfigurationDesk, they let you implement the bus communication in a
real‑time application for SCALEXIO, MicroAutoBox III, or MicroLabBox II.
§ In RTMaps, they let you implement the bus communication in an
RTMaps‑based application for the AUTERA AutoBox, for example.

ECU Abbreviation of electronic control unit.

Framework label The name of a variable on the experiment level (framework

label in ASAM XIL) that is decoupled from the name of a variable on the
modeling level (testbench label in ASAM XIL). A framework label is defined
by a label name (ID) and a data type. The framework labels in a framework label
list are unique.

Hardware-in-the-loop (HIL) simulation A method of testing a controller

with a model of the controlled system which is simulated in real time. When
you have produced a new controller, you usually want to test it. For the final
tests, you usually connect the real controller to a model of the controlled system
which, of course, must be simulated in real time. This way, you can ensure that
the controller does not contain any errors that could damage the real plant. This
technique is called hardware‑in‑the‑loop simulation (HIL).

46
Getting Started with XIL Mapping May 2024
 L

Label mapping A concept according to ASAM XIL to map framework

labels to testbench labels .

Offline simulation application An offline simulation application (OSA) file

is an executable file for VEOS. After the build process, the OSA file can be
downloaded to VEOS.
An OSA contains one or more VPUs, such as V‑ECUs and/or environment VPUs.

SDF file A file that describes a dSPACE simulation application , including the
contained parameters and measurement variables. SDF files are created during
the build process.

Simulation application The generic term for real-time application and

offline simulation application. The application runs on a simulation platform.

Simulation model A model that is designed in MATLAB/Simulink for

simulating control algorithms or a controlled system. It is a generic term for
real-time models or models that are used for offline simulations.

Simulation platform The generic term for real-time systems that calculates
the real-time application in real time and simulators that are not connected to a
physical system and therefore independent of the real time.

Simulink implementation container A container that contains the model

code of a Simulink simulation model . A Simulink implementation container
is generated from a Simulink simulation model by using the Model Interface
Package for Simulink. The file name extension of a Simulink implementation
container is SIC.

Software‑in‑the‑loop (SIL) simulation A PC-based simulation in which the

simulator is not connected to a physical system and is thus independent of the
real time.

47
May 2024 Getting Started with XIL Mapping
 Glossary

Testbench label Name of a variable on the modeling level (testbench label in

ASAM XIL) to identify model variables from the variable description. A testbench
label is defined by a label name (ID) and a data type. The testbench labels are
unique in each testbench label list with an assigned port ID.

VEOS A simulator which is part of the PC and allows the user to run an
offline simulation application without relation to real time.

XIL API MAPort platform A platform that provides access to a simulation

platform via the ASAM XIL API implementation that is installed on your host PC.

XIL mapping file An XML file according to the ASAM XIL standard that
contains, for example, all the information required for XIL mapping (identifier
mapping):
§ Framework labels
§ Testbench labels
§ Label mappings

48
Getting Started with XIL Mapping May 2024