Release Notes
Release Notes
1
CarMaker
The information in this document is furnished for informational use only, may be revised
f r o m t i m e t o t i m e, a n d s h o u l d n o t b e c o n s t r u e d a s a c o m m i t m e n t by t h e
IPG Automotive Group. IPG Automotive Group assumes no responsibility or liability for any
errors or inaccuracies that may appear in this document.
This document contains proprietary and copyrighted information and may not be copied,
reproduced, translated, or reduced to any electronic medium without prior consent, in writ-
ing, from IPG Automotive Group.
For better readability, the masculine form is used for personal designations and words refer-
ring to persons in this documentation. In the interests of equal treatment, the corresponding
terms apply to all genders as we are an inclusive and diverse organization and we recog-
nize the diversity. The abbreviated form of language is for editorial reasons only and does
not imply any judgment.
All CarMaker variants use several open source components. A quick overview of the com-
ponents is available in the overview document FOSS-Licenses.pdf in the /doc folder of the
installation directory.
IPGMovie in GPUSensor mode uses additional components of proprietary third-party soft-
ware. The corresponding end-user license agreements (EULA) can be found in directory
doc/EULA-3rd-Party of each CarMaker installation.
Contents
Chapter 1
CarMaker General Information
TruckMaker
TruckMaker Edition
Module/Feature
pro
includes all CarMaker pro and MotorcycleMaker features ✕
Truck, max. number of axles 6
Truck, max. number of steerable axles 2
Truck, max. number of lift-axles 2
Truck, drivetrain: 4x2, 4x4 ✕
Truck, drivetrain: 6x2, 6x4, 6x6 ✕
Truck, drivetrain: 8x2, 8x4, 8x6, 8x8 ✕
Truck, drivetrain: 10x4 ✕
Truck, drivetrain: 12x4 ✕
Truck, drivetrain: retarder ✕
Truck, spring mounted drivers cab and platform ✕
Truck, brake system: brake force distribution (BFD) ✕
Truck, brake system: hydraulic ✕
Truck, power steering model ✕
Truck / Trailer, brake system: pneumatic ✕
Truck / Trailer, axles type: rigid, single carrier ✕
Truck / Trailer, wheels: single, twin ✕
Trailer, trailer type: semi, center axle, drawbar (full) ✕
Trailer, max. number of axles 3
Trailer, max. number of steerable axles (full trailer) 1
TruckMaker
TruckMaker Edition
Module/Feature
pro
Trailer, max. number of lift-axles 2
Trailer, brake system: overrun brake, BFD ✕
Trailer, frame torsion1 ✕
Trailer, coupling of second trailer (Gigaliner) ✕
1. Currently under development, ask for latest information about availability
Feature CarMaker
Windows Linux for Windows Linux
Simulink
FMI Support ✕ ✕ ✕ ✕ ✕
TameTire 1 ✕ ✕ ✕ ✕ ✕
MF-Tyre/MF-Swift ✕ ✕ ✕ ✕ ✕
FTire ✕ ✕ ✕ ✕ ✕
ADTF ✕ ✕ ✕ ✕ ✕
GPU-based Sensors ✕ ✕ ✕ ✕ ✕
Camera HiFi Sensor ✕ ✕ ✕ ✕ ✕
TestManager parallel ✕ ✕
execution mode
Fail Safe Tester Support
CAN ✕ ✕
EtherCAT
FlexRay
Automotive Ethernet
SOME/IP
M-Modul I/O
CCP/XCP ✕ ✕ ✕ ✕ ✕
CockpitPackage Std. ✕ ✕ (req) ✕ ✕
CockpitPackage Pro ✕ ✕
Sim Net ✕ ✕
1. CarMaker and TruckMaker, not available for MotorcycleMaker
(req) = on request
Available for
License Option Motorcycle-
CarMaker TruckMaker
Maker
Physical Sensor Models (PSM) ✕ ✕ ✕
Raw signal interfaces1
- Free Space Sensor Plus
- Camera RSI
- Lidar RSI
- Radar RSI
- Ultrasonic RSI
Multi-body System Suspensions ✕ ✕
High resoluted multi-body system suspension
models
Available for
License Option Motorcycle-
CarMaker TruckMaker
Maker
Sim Net ✕ ✕ ✕
Simulating a traffic scenario with several ego vehi-
cles
Cockpit Package standard/pro ✕ ✕
Interface for driving simulators
Here Map Interface ✕ ✕ ✕
Export of roads and road networks from HERE
ADAS RP and HERE HD Live Maps
Exchange of road information during simulation
with HERE ADAS RP
1. Physical Sensor Models (PSM) are licensed token based. Each PSM license is
equivalent to 4 tokens. One token can be used for one instance of Free Space Sen-
sor Plus, Camera RSI, Lidar RSI and Radar RSI or one group of Ultrasonic RSI
sensors bundled on one GPU Sensor process.
For Linux users: The libraries libOpenGL.so, libGLX.so and libEGL.so need to be
installed. See table 1.1 for the corresponding package names in the repositories. For
the usage of IPGMovie, version 1.5 or higher of the XRandR configuration utility is
required.
Intel Chipsets: Only Intel HD Graphics, HD 3000 or better are supported (however, we
strongly recommend to use NVIDIA or AMD graphics cards).
Distribution Dependencies
Ubuntu 20.04 libopengl0
Ubuntu 22.04 libglx0
libegl1
RHEL 8 libglvnd-opengl
libglvnd-glx
libglvnd-egl
• Network connection:
- To be able to use a nodelocked license for IPG products, at least one physical net-
work adapter is required. This is not the case for other licensing models such as
dongle or floating licenses.
- Using a floating license with CarMaker HIL requires a direct network connection
from the real-time system to the license server. In case the company restrictions do
not allow a real-time system accessing the company network, please contact the
CarMaker support team for further instructions.
• CarMaker Office Extended
For an optimal performance, the host computer should meet these requirements:
- Mid-range CPU, e.g. Intel i5-10400 or AMD Ryzen 5 3600
- 16 GB RAM
EKF PC7
CarMaker HIL for SCALEXIO (dSPACE) runs on any recent SCALEXIO Processing Unit,
equipped with Intel XEON processors, such as:
CarMaker HIL for PXI (National Instruments) runs on all recent PXI / PXIe real-time sys-
tems, running Phar Lap ETS (NI ETS) or NI Linux Real Time operating system. CarMaker
HIL was tested successfully with the following real-time controllers:
NI Real-Time Controller
PXI 81xx PXIe 81xx
PXIe 88xx
GNU Toolchain
On Linux systems the CarMaker executable can be rebuilt using the GNU Toolchain.
Depending on the Linux distribution it might be necessary to install certain additional pack-
ages using the systems package manager. Please refer to the following table for a detailed
list of required packages for the supported distributions.
CMake
CarMaker’s GPU Coding Interface is compatible with CMake installation of version 3.14 or
higher.
CUDA
CarMaker’s GPU Coding Interface is compatible with the CUDA runtime version 11.8 com-
bined with a graphic card driver of the same version or newer.
Eclipse
CarMaker is compatible with Eclipse C/C++ Development Toolkit (CDT) version 2022-03 up
to version 2023-06.
MinGW/MSYS environment
The MSYS compiler is provided with the CarMaker installation package. The currently sup-
ported version is the MSYS-2023 environment with gcc/g++ 11.3.0 and XENO cross com-
piler 11.3.0.
MATLAB
A MATLAB installation is required to run CarMaker for Simulink and CarMaker HIL for
SCALEXIO (dSPACE). Regarding CarMaker HIL for SCALEXIO (dSPACE), the supported
MATLAB versions depend on what MATLAB versions are supported by the used dSPACE
software release.
For all other CarMaker variants (except of CarMaker for Simulink), a MATLAB installation is
not required to work with CarMaker.
Each CarMaker release includes support for e.g. the integration of Simulink models via Sim-
ulink Coder including the use of Simscape blocks. Accessing CarMaker data in the MATLAB
workspace and in m-file scripts is supported as well.
CarMaker is compatible with following versions of MATLAB (64-bit) on Linux and MS Win-
dows:
• MATLAB 9.10 (Release 2021a)
• MATLAB 9.11 (Release 2021b)
• MATLAB 9.12 (Release 2022a)
• MATLAB 9.13 (Release 2022b)
• MATLAB 9.14 (Release 2023a)
• MATLAB 23.2 (Release 2023b)
Please note the MATLAB-related information in chapter ’Announcements for Future
Releases’.
Python
CarMaker test benches can be automated with the help of Python scripts. This requires the
installation of the CarMaker Python API add-on package. The CarMaker Python API add-
on contains a Python implementation of the ASAM XIL interface for CarMaker, the CarMak-
er Python API core (cmapi) and associated Python bindings for APO and Info Files.
The CarMaker Python API add-on with version 13.0 is compatible with the following Python
versions:
• Python 3.7m
• Python 3.8
• Python 3.9
• Python 3.10
• Python 3.11
Python scripts that are executed on Xpack4 real-time systems need to be compatible to
Python version 3.4 and may not address features of Python 3.5 and newer.
1.3.2 Docker
CarMaker can be operated in Docker environments with base images of any kind of oper-
ating systems supported by CarMaker according to section 1.2.1 ’Host Computer’. To cre-
ate a docker container to run a CarMaker Test Run the following software packages need
to be installed in the container:
To run certain CarMaker GUI features or IPGMovie in a container the nvidia/cudagl base
images are required. To run these images the nvidia-docker runtime is required (installation
instructions see: section 28.3 ’CarMaker with RSIs’ in the Programmer’s Guide), which is
available for current Ubuntu and RHEL releases. The following dependencies are required
in the respective base images:
Note that only IPGMovie instances based on EGL (MovieEGL.exe) can be run inside a nvid-
ia container.
All steps required to run CarMaker in a docker container are explained in the Programmer’s
Guide, section ’Using CarMaker with Docker’.
FTire
CarMaker is compatible with Cosin FTire versions 2023-1 up to 2023-3. Please also note
the list of supported platforms under section ’Feature Support for Different Target Architec-
tures’.
MF-Tyre/MF-Swift
CarMaker is compatible with TASS Delft-tyre MF-Tyre/MF-Swift 2306. Please also note the
list of supported platforms under section ’Feature Support for Different Target Architec-
tures’.
TameTire
CarMaker is compatible with Michelin TameTire 6.3. Please also note the list of supported
platforms under section ’Feature Support for Different Target Architectures’.
OpenDRIVE
Road scenarios created in OpenDRIVE (*.xodr files) are supported according to Open-
DRIVE versions 1.4 up to 1.7.
ETAS INCA
CarMaker is compatible with ETAS INCA versions 6.2 to 7.1.
ASAM FIBEX
The FIBEX versions 2.0, 3.0.0, 3.1.0 and 4 are supported.
AUTOSAR
CarMaker rudimentary supports AUTOSAR CLASSIC PLATFORM version 4.x. However,
support for any AUTOSAR database cannot be guaranteed. Project specific adaptions may
be required.
CANdb
The CANdb support was developed based on CANdb++ version 2.5 from Vector Informatik
GmbH. Compatibility to CAN databases that were created with other versions of CANdb++
cannot be guaranteed.
EB Assist ADTF
CarMaker is compatible with ADTF 3.15.5. Newer versions of the same major release are
likely to work as well. The supported DDL file versions are 1.0+, 1.02 and 2.0.
Platform availability: CarMaker Office, CarMaker Office Extended, CarMaker HIL for
Xpack4.
Rinex Files
CarMaker supports the navigation message files describing satellite movements for GPS
satellites provided by the NASA. Only files with extension “n.Z” are accepted.
IPG Modules
MEN/DUAGON Modules
Supported since
Type Description
CarMaker release
D203 6U M-Module Carrier 4 Slots 2.0
F204 3U M-Module Carrier 1 Slot 2.0
F205 Ext. 3U M-Module Carrier 2 Slots 2.0
M27 16 Digital Optocoupler Outputs Low-Side 2.x
Switching
M28 16 Digital Optocoupler Outputs High-Side 2.x
Switching
Supported since
Type Description
CarMaker release
M31 16 Digital Optocoupler Inputs High-Side 2.x
Switching
M32 16 Digital Optocoupler Inputs Low-Side 2.x
Switching
M35 8/16 Analog Inputs, 14 Bit 2.x
M36N 8/16 Analog Inputs, 16 Bit 2.x
M43 8 Relay Outputs 2.x
M62 16 Analog Outputs 2.x
M77N 4 UARTs, RS232, RS422, or RS485
M81 16 Binary Outputs 2.x
Supported since
Type Description
CarMaker release
FST-CC Fail Safe Tester Controller < 4.5
FST-SRC Standard Relay Card (5A) < 4.5
FST-HCRC High Current Relay Card (30A) < 4.5
FST-RC50A High Current Relay Card (50A) < 4.5
FST-HVC High Voltage Relay Card < 4.5
FST-PRC Programmable Resistor Card < 4.5
FST-VSC Voltage Supply Card < 4.5
CarMaker Office Extended support the following devices from Vector Informatik GmbH.
CarMaker Office
Chapter 2
New Features of the CarMaker Product
Family 13.1
Real-time Expressions
• New Real-time Expression functions:
- exists(var), try(var) and try(var,expr)
- modfloor, deltamod, distmod
- Angle and RelativeAngle
• New option for coordinate system "world" for the measure calculation
Python API
• Added simulation mode “Model Check” to the CarMaker Python API
2.1.2 Visualization
Movie NX
• New visualization of rain effects in Movie NX
• Separated adjustment of vertical and horizontal field of view via slider in camera set-
tings
• Operation of mirror mode via Camera Settings menu or Python API
• New status display showing the current connection state and simulation status
• New system info dialog providing useful system information
• New option in View menu allowing to hide the IPG logo
• Road Preview using Movie NX
3D assets
• Several new vehicle and trailer models in the 3D object library
• Extended light signal mapping emissive surfaces to all asset components
• Support for material id parameterization in gltf models
2.1.3 Vehicle
Car
Powertrain
• TCU model DCT + AMT supporting powertrain AxleSplit
• Additional shift map for SelectorCtrl_S
Tire
• Tire-Generator: new tire dimensions 275/40R21, 285/45R22 and 305/35R21
2.1.4 Sensors
RSIs in general
• Improved ray tracing results by introducing material id textures for existing HD scenari-
os in Movie NX
• Sychronized updates for visualization and Video Interface Box (VIB) GPU sensor
instances of Movie NX and IPGMovie
Road API
• Road API extension: Export rd5 files to OpenDRIVE®
Maneuver in general
• New reference points for start positions
• New option for Follow Trajectory to automatically adjust the start of the trajectory when
the object is not at the start of the trajectory
• New teleport mode for Follow trajectory
IPGDriver
• Check for motorway exits during overtaking
2.1.7 Environment
• New parameter set for snow and ice in the material library
Xeno-rt
• Update to Xeno-rt 13.1 including:
- update miodrv.ko for KPA master distributed clocks
- update mioutil to version 4.15
- update dropbear to version 2024.84
- add missing symbolic link /lib64/libtinfo.so.5
- update EtherCAT components to version 13.1
IO Configurator
• New supported modules:
- M401 Frequency generator and frequency meter
- M418 and M418-01 16 bits analog inputs
- ISC-1 Quad 2.5G Ethernet sidecard for PC7 SBC
• Extended support for M414:
- Built-in function for counters
- Extended number of tx nibbles
- Increased number of serial messages
• M405: Increase of LIN messages
IPGTools
OpenSCENARIO Converter
• Support of the OpenSCENARIO FollowTrajectoryAction with CarMaker maneuver Fol-
lowTrajectory
Third-party tools
MATLAB
• Support for MATLAB releases 23.2 R2023b and 9.10 R2021a
• CarMaker Simulink Coder plug-ins with versioning
Real-time Expressions
• New Real-time Expressions functions:
- exists(var): returns 1 in case variable var (internal variable or User Accessible
Quantity) exists, otherwise returns 0.
- try(var): tries to access variable var, returns 0 if var does not exist.
- try(var,expr): tries to access variable var. If var does not exist, expr will be evaluat-
ed and returned. expr can be any term, e.g. a constant, a function call or an assign-
ment.
- modfloor(a,m): calculates the modulo using floored division which always leads to a
positive result.
- deltamod(a,b,m): calculates the offset of two values considering a modulo.
- distmod(a,b,m): calculates the distance between two values considering a modulo.
This is defined as the absolute value of deltamod(a,b,m).
Please find more information in the User’s Guide, section B.2.2 ’Built-in Functions’.
- Angle: calculates an entity’s (traffic object or ego vehicle) angle in a specified coordi-
nate system and in a specified direction in radians. Either the heading, pitch or roll
direction can be evaluated.
- RelativeAngle: calculates an entity’s angle in relation to a reference entity in a spec-
ified coordinate system and in a specified direction in radians.
Please find more information in the User’s Guide, section B.2.3 ’Distance and Time
Measurements’.
• New option for coordinate system "world" for the measure calculation
A third option for coordinate system "world" for the measure calculation is available.
This option means a calculation of cartesian distances in the world coordinate system.
Please find more information in the User’s Guide, section B.2.3 ’Distance and Time
Measurements’.
Python API
• Added simulation mode “Model Check” to the CarMaker Python API
The simulation mode “Model Check” can now be specified for a variation object. This
simulation mode performs the Model Check procedure on the variation and saves the
output result files in the ModelCheck subdirectory of the SimOutput folder in the project
directory. This will yield results equivalent to a Model Check performed with the Car-
Maker GUI, but without the extended analysis and visual processing in IPG Graph.
Please find more information in the CarMaker Python API Reference available under
Additional Documents in the Help menu of the CarMaker main GUI.
2.2.2 Visualization
Movie NX
New visualization of rain effects in Movie NX
Movie NX introduces a new system for visualizing rain effects. This also replaces the
old rain effects. This release specializes in the visualization of different rain effects with-
in a Test Run depending on the environment rain rate. This includes, among other
things, the visualization of precipitation, the formation of puddles of varying intensity
and even completely flooded roadways. The precipitation also affects the wet road sur-
face through the formation of visible capillary waves (ripples). Vehicles are dynamically
influenced by precipitation as raindrops also accumulate on the bodywork and win-
dows. Please find more information in the Reference Manual, section 4.6 ’Weather
Effects in Movie NX’.
Figure 2.1: Wheel rain spray and rain droplets on the windshield in Movie NX
Known issues:
- Precipitation visible with depth coloration modes and depth output formats in combi-
nation with weather effects.
- Rain effects can sometimes be visible inside the vehicle, especially towards the out-
side, caused by precision differences. When the camera is pointing vertically down-
wards, rain effects can also be noticed.
• Separated adjustment of vertical and horizontal field of view via slider in camera
settings
The camera’s field of view can now be set independently in horizontal and vertical
direction. A slider was added for a more convenient adjustment of the field of view to
the Basic tab in the Camera Settings menu. Please find more information in section
6.2.1 ’"Basic" Tab’ of the Movie NX User Manual.
• New status display showing the current connection state and simulation status
A new status display was added showing the current connection state and simulation
status. The connection icon is a quick link to the Connect dialog. Further, a balloon help
shows the current application name, host name, host IP address and process ID in sta-
tus Connected. Please find further information in the Movie NX User Manual, section
2.2 ’User Interface’.
3D assets
• New vehicle and trailer models in the 3D object library
The 3D object library has been extended by several new vehicle models and a boat
trailer. Further variants of existing vehicles including weather effects were added.
For an overview of new objects, open the 3D Objects Catalog (CarMaker main GUI >
Help > 3D Objects Catalog). In the catalog, click New in 13.1.
2.2.3 Vehicle
Car
Powertrain
• TCU DCT + AMT supporting powertrain AxleSplit
A new TCU model DCT + AMT is available that allows the use of a DCT gearbox with
the axle split powertrain configuration. The Pre-Configuration setting in the Vehicle
Data Set Editor on the General tab was extended for the axle split hybrid kind offering
the DCT + AMT TCU. Please find further information in the Reference Manual, section
16.3.3 ’Transmission control unit (TCU)’.
Tire
• Tire-Generator: new tire dimensions 275/40R21, 285/45R22 and 305/35R21
The Tire Data Set Generator was extended by the following new tire dimensions: 275/
40R21, 285/45R22 and 305/35R21. Please find further information about the generator
in the User’s Guide, section 10.9 ’Tire Data Set Generator’.
2.2.4 Sensors
RSIs in general
• Improved ray tracing results by introducing material id textures for existing HD
scenarios in Movie NX
The ray tracing results for Movie NX based RSIs were improved by introducing material
id textures for existing HD scenarios.
• Sychronized updates for visualization and Video Interface Box (VIB) GPU sensor
instances of Movie NX (or IPGMovie)
Visualization and Video Interface Box (VIB) GPU sensor instances of Movie NX (or
IPGMovie) from now on receive updates of simulation data at identical points in time,
so that their scene representation is identical. Please note, however, that this is only
possible among instances using identical cycle time settings.
Road API
• Road API extension: Export rd5 to OpenDRIVE®
The functions used for the export of a road definition to ASAM OpenDRIVE® are part of
the IPGRoad API now. Moreover, the export to ASAM OpenDRIVE® is now available
with a CarMaker standard license in the Scenario Editor.
Please find further information about the new IPGRoad API functions in the IPGRoad
API Reference, section Changes, available under Additional Documents in the main
GUI’s Help menu.
Maneuver in general
• New reference points for start positions
To better support the OSC standard, the reference point can now be set to the rear axle
(RearAxle) and center of mass (CoM) for the position types Global, Lane, Link, Rela-
tiveGlobal, RelativeLane, RelativeLink and RelativeObject. The reference points CoM
and RearAxle can also be used for the calculation of the position of reference entities
for the relative position types RelativeGlobal, RelativeLane, RelativeLink and Relative-
Object. For activation use the key <LatStepPre>.RefPos = mode under Additional param-
eters. For details see section ’Vehicle reference position’ in the Reference Manual.
• New option for Follow trajectory to automatically adjust the start of the trajectory
When enabled, the start of the trajectory is automatically adjusted so that the first point
in front of the vehicle is the new start point of the trajectory. If a time channel is avail-
able, it will be adjusted to achieve a smooth transition in the velocity profile. For activa-
tion use the keys <LatStepPre>.AdjustTrajStart.* under Additional parameters. For
more information, see section ’Adjust trajectory start’ in the Reference Manual.
• New teleport mode for Follow trajectory
The teleport mode has the options Follow and Position. Position corresponds to the
existing behavior of CM 13.0. If Follow is specified, the object will now not be teleported
if it is already at the start of the trajectory and the first time entry is zero. For activation
use the key <LongStepPre>.TeleportMode = Follow under Additional parameters. For
more information, see section ’Teleport Mode’ in the Reference Manual.
IPGDriver
• IPGDriver: Check for motorway exits during overtaking
IPGDriver is now able to detect an exit during overtaking on highways. This can be acti-
vated with the additional Info File key Driver.Percept.DetectExits in the additional
parameters tab of the Driver Template Editor. If the driver detects that the active route is
along an exit, the driver will try to change to the exit lane in time, taking into account the
surrounding traffic. Furthermore, IPGDriver checks if an exit is ahead before starting an
overtaking maneuver. Per default this behavior is deactivated.
Please find further information in the IPGDriver User Manual, section ’Parameter field’.
2.2.7 Environment
• New parameter set for snow and ice in the material library
A parameter set for snow and ice was added to the material library:
Material.22.Name = snow-ice
Please find further information about the definition of the material library in the User’s
Guide, section ’Edit Material Library’.
Xeno-rt
• Update to Xeno-rt 13.1 including:
- update of miodrv.ko for KPA master distributed clocks
- update of mioutil to version 4.15
- update of dropbear to version 2024.84
- added missing symbolic link /lib64/libtinfo.so.5
- update of EtherCAT components to version 13.1
IO Configurator
• The IO Configurator’s module support was extended
- M401 Frequency generator and frequency meter
The M401 Frequency generator and frequency meter is now available in the IO Con-
figurator. The parameters for the module and the messages can now be configured
in the user interface. Please find more information in the User’s Guide for Real-time
Applications, section ’Frequency Generator and Meter - M401-01’.
- M418 and M418-01 16 bits analog inputs
The M418 and M418-01 16 bits analog input modules are now available in the IO
Configurator. The parameters for the module and the messages can now be config-
ured in the user interface. Please find more information in the User’s Guide for Real-
time Applications, section ’Analog Inputs - M35N00, M35N02, M36N00, M36N01,
M418, M418-01’.
- ISC-1 Quad 2.5G Ethernet sidecard for PC7 SBC
The ISC-1 Quad 2.5G Ethernet Sidecard for PC7 SBC is now available in the IO
Configurator. It can now be configured in the carrier boards section of the user inter-
face. Please find more information in the User’s Guide for Real-time Applications,
section ’Carrier boards’.
• Extended support for M414
- Built-in function for counters
It is now possible to configure 2 rolling counters for the M414. Additional modes to
compute the checksum are available, too.
- Extended number of tx nibbles
The number of tx nibbles for the M414 is extended to 8.
- Increased number of serial messages
The number of serial messages for the M414 is increased to 64.
Please find more information in the User’s Guide for Real-time Applications, section
’SENT module with SPC support - M414’.
• M405: Increase of LIN messages
The number of LIN messages per channel was increased to 40 for the M405 module.
Please find more information in the User’s Guide for Real-time Applications, section
section ’LIN Interface - M405’.
IPGTools
OpenSCENARIO Converter
• The OpenSCENARIO FollowTrajectoryAction is now supported with CarMaker
maneuver FollowTrajectory
- New supported features of OpenSCENARIO FollowTrajectoryAction:
- TimeReference->None
- TimeReference->Timing->domainAbsoluteRelative->relative
- TimeReference->Timing->offset != 0.0
- TimeReference->Timing->scale != 1.0
- StartTrigger is now no longer limited to SimulationTimeCondition = 0.0
- Start position of the entity is no longer limited to start position of the trajectory.
These new features are not supported with the --trajlegacy option.
- Old support of FollowTrajcetoryAction is deprecated. But it can be activated with
new argument --trajlegacy.
- A new argument to the converter was added: --trajlegacy.
It enables trajectory conversion with legacy module, which converts the trajectory to
a route and speed profile for ego vehicle and to Input From File (IFF) for traffic. Posi-
tions in the IFF file for traffic objects are optimized with higher position resolution.
- The reference point of the start position changes from Fr1 to center of the rear axle
for the vehicle and to the center of mass for traffic objects of kinds Pedestrian and
MiscObject.
- A path list is automatically generated based on the start position and first trajectory
found in the maneuver. The maximum number of the path list is limited to 10.
Please find further information in the User’s Guide, section ’OpenSCENARIO Convert-
er’.
Third-party tools
MATLAB
• Support for MATLAB releases 23.2 R2023b and 9.10 R2021a
The support for MATLAB 23.2 R2023b was added and support for MATLAB release
9.10 R2021a was resumed.
• CarMaker Simulink Coder plug-ins with versioning
CarMaker plug-ins created with Simulink Coder now use the version of their Simulink
model by default.
Rebuilding existing plug-in models will change the Simulink model version, if the ver-
sion specified in the wrapper file differs from 1.0. To correctly reflect the version number
in the plug-in library, in some cases the model must be recreated twice, once to migrate
the version number from the wrapper to the Simulink model, and a second time to use
the new version number for the plug-in library information.
Simulation framework
• Bugfixes in the logging module:
- Multi threading issues occurred regarding concatenation of log messages distribut-
ed over more than one Log() call, i.e. where only the last logged string contained the
line ending character \n). Fixed on all platforms except lvrt.
- Log buffer management issues potentially led to memory access outside the buffer’s
boundaries.
• Bugfix: The simulation program crashed at the initial executable startup or at simulation
start if values higher than 0.01 are selected for SimParam.DeltaT in the SimParameters
file.
• Bugfix: An interrupt signal during a Test Run caused the simulation program to crash
when being started with a startup file.
Real-time Expressions
• The SimParameter key RTExpr.ErrorWrongUnit is introduced. It specifies if an error is
triggered instead of a warning, in case the unit of an existing User Accessible Quantity
defined in the c-code, is modified via Real-time Expression. Default value is 0 (warning
instead of error).
• Bugfix: The error messages for time and distance measurement Real-time Expressions
were improved.
• Bugfix: Real-time Expressions which include a term in parenthesis which evaluates to a
string could have led to a segmentation fault. Now the string value is implicitly convert-
ed to a numerical value.
- Bugfix: MSYS started with an error message if the user name contained spaces
Test Manager
• Bugfix: When opening the Load dialog in Test Manager, the vehicle image in the Car-
Maker main GUI was changed even though it should not be affected by the Test Man-
ager.
• Bugfix: In some cases a Tcl error occurred when dragging and dropping items.
• Bugfix: When saving Test Manager files from data pools or the installation directory, the
user was not notified.
Test Configurator
• Bugfix: The creation of Test Ware packages with an already existing name is now pre-
vented.
Script Control
• The ScriptControl commands KeyValue reset and NamedValue reset are now docu-
mented in the Programmer’s Guide.
• Bugfix: When reading variables from a result file using the ScriptControl command
ImportResFile, the return value has been corrected. 0 indicates the variable exists, -1
that it does not exist in given result file.
2.3.3 Visualization
Movie NX
• Bugfix: The full screen mode did not working as expected. E.g. the loading screen
shown in full screen mode did not have a proper scale. When exiting the full screen
mode the main window did not restore the specified startup size.
• Bugfix: Initializing the size of the main window client on Windows caused a Qt warning
at start up.
• Bugfix: Fisheye renderings were leaking pixels from previous simulations.
• Bugfix: The orthographic fisheye field of view in the Camera Settings dialog was not
limited to its maximum of 180 deg.
• Bugfix: The labeling of the lens modes in the Camera dialog were made more consis-
tent.
• Bugfix: Support of gltf, glb and assetinfo files (alongside node) in Movie NX search
paths as a replacement for IPGMovie objs.
• Bugfix: The gltf importer didn’t read image file paths correctly in some cases.
• Bugfix: MovieNX did not show the correct value of speed markers with unit "mph".
• Bugfix: The export window size selection Same as Selected view was not always
applied properly.
• Bugfix: During caching of imported assets collisions could lead to asset cache over-
rides.
• Bugfix: An occasional crash could occur after refreshing the list in the Connect dialog.
• Bugfix: All buttons are now uniformly activated upon a click which equals a press and
release.
• Known issue: Movie NX shows incorrect textures when started without warm up.
IPGMovie
• Bugfix: A tcl error occurred under specific circumstances when trying to export a video
file via IPGMovie Script Control command in Test Manager when a video file with the
same name already existed.
3D assets
• Bugfix: The descriptions of the assetinfo files was incorrect for the two example vehi-
cles Examples/Demo_AssetInfo and Examples/
Demo_IPG_CompanyCar_EV_AssetInfo.
2.3.4 Vehicle
Car
Powertrain
• Bugfix: The Info File keys for the DCT TCU sync clutch functionality Power-
Train.TCU.ClutchCtrl.<i>.SyncClutch.* were not read in as described in the Reference
Manual.
• Bugfix: The PTControl Clutch User Accessible Quantities were missing for hybrid pow-
ertrain models.
Truck
2.3.5 Sensors
• Bugfix: Several sensor types could crash if their name was too long.
Camera Sensor
• Bugfix:The content of the RSDS export in YUV422 format was not correct for some
channel’s order.
• Bugfix: In some cases incorrect object detections were provided at the beginning of a
Test Run.
• Bugfix: The Camera sensor used incorrect bounding box dimensions if 2D contours
were activated.
Radar Sensor
• Bugfix: In some cases incorrect object detections were provided at the beginning of a
Test Run.
RSIs in general
• Bugfix: After a significant re-implementation of some of the inner workings on the serv-
er side in APO 2.1 for CarMaker 13.0, a performance decrease in conjunction with RSI
sensors was noticed in CarMaker Office which is fixed with the latest APO release
included this CarMaker version.
• Bugfix: Log entries concerning GPU sensors now use the proper IP address of the cor-
responding GPU sensor instead of the address of the host running the simulation pro-
gram.
• Bugfix: The GPU sensor registration sometimes failed upon a changed sensor cluster
configuration at the start of a simulation, especially if GPUs on different hosts were
involved. Error message: "GPUSensor: Instance ... has not registered with the Sim-
Prog".
Ultrasonic RSI
• Bugfix: Inserting an unassigned Sensor mounting when an Ultrasonic RSI was in the
previous Test Run could have led to a parametrization error.
Camera RSI
• Bugfix: In specific cases, when the network is heavily slowed down or congested, a
race condition occurred that caused IPGMovie to corrupt the data fetched from the
Camera RSI and sent to the RSDS client.
Static scenario
• Bugfix: When smoothing over a specified area, the specified smoothing intensity was
not taken into account correctly.
• Bugfix: The normal vector calculation for the transition area of virtual and extended
junctions was incorrect.
• Bugfix: When adding a junction in the Scenario Editor, the z-coordinate of the center
point was not adjusted.
• Bugfix: In some cases, the geometry of junction links created using the Add selective
junction links function was incorrect. As a result, these junction links could not be used
as part of a route across the junction.
• Bugfix: In certain cases, when evaluating the road surface on the transition area of an
extended junction’s arm, the determined information was incorrect.
• Bugfix: Adding give way markers could have led to a crash if the junction geometry is
unfavorable.
• Bugfix: In some cases, after rebuilding a junction (deleting/adding junction arms), add-
ing give way markers to such a junction might have caused a crash.
• Bugfix: In some cases, the simulation on a spiral-shaped route running along multiple
links connected by (extended) junctions did not work: At the transition from a link to the
following junction, instead of a position on this junction a position on the previous junc-
tion was found.
• Bugfix: Rearranging the links in the link list of Scenario Editor’s Route Generation tool
sometimes led to internal confusion regarding the proper link order.
• Bugfix: If a traffic light controller was added or removed using Undo or Redo, the list of
available controllers shown in the Parameters tab of a traffic light or a stop marker of
type Traffic light was not adjusted.
• Bugfix: When a link was reverted, its visualization parameters were not adjusted. In
consequence, the parameters for its left and right side were interchanged.
• Bugfix: Rotating background images and junctions using an object group led to angles
larger than 360˚ in certain cases.
• Bugfix: The minimum size limit for displaying Road painting and Road surface objects in
IPGMovie and Movie NX was removed.
• Bugfix: Invalid road markings, traffic barriers and raised profiles of type Line were visu-
alized as red circles at the last valid position instead of the current one. Moreover,
some of the messages converting invalid bumps and accessories were missing or not
suitable.
• Bugfix: In the parameters tab of an extended junction, a NamedValue could be added
to the Automatic mesh generation checkbox, although it had no effect.
• Bugfix: In the Height profile smoothing tool, NamedValues could be added to the
Parameters tab although they had no effect.
• Bugfix: Misleading warnings regarding invalid transition areas were triggered. The
warning was based on an incorrectly calculated criterion for checking the validity of a
transition area.
• Bugfix: The file browser for Geometry objects started in the wrong directory for Movie
NX.
• Bugfix: In the Scenario Editor, when saving a road definition to a road file or Test Run,
files located in a data pool were automatically copied to the current project directory
without any notification.
Traffic
• General traffic behavior parametrization: Changing the selection from Default to a man-
ually created preset has no effect when it is performed on a Test Run which had been
read from file. For new Test Runs the behavior was as intended.
• Bugfix: When using smart traffic features with enabled preparation thread and simulta-
neously Real-time Expressions with parameters refPntTrig or refPntRef the simulation
terminated with unusual error messages.
• Bugfix: A link start position of a traffic object on the road side led to a crash of the Sce-
nario Editor. In combination with a routing on a dynamic path list and no assigned path,
this also led to a crash of the simulation program.
• Bugfix: Traffic objects were deactivated at path transitions during a longitudinal and lat-
eral maneuver step Follow trajectory, if they had a dynamic path list as routing.
• Bugfix: For the maneuver step Follow trajectory with a position type RelativeObject and
a reference of the object itself, the target positions were calculated incorrectly with an
offset in the longitudinal direction.
• Bugfix: It is now possible to specify up to five paths in the entry under Motion > Path
change of a traffic object.
• Bugfix: The Traffic longitudinal maneuvers Position, IFF position and User position did
not take circuits properly into account. In some cases traffic objects vanished from the
simulation if the route was closed with itself.
• Bugfix Traffic generator: A Tcl error occurred when consecutively clicking on the tooltip
text in the empty link list and on the empty route list.
• Bugfix: The 2D bounding box for a traffic object without associated 3d object did not
use the correct dimensions.
• Bugfix: In the User preferences dialog, the Assisted traffic generator was referred to as
Traffic generator.
IPGDriver
• Bugfix: When a new maneuver step starts for the ego vehicle, not every dynamic is cal-
culated in the same cycle. This means, that e.g. IPGDriver’s control variables are not
propagated in this cycle, causing the User Accessible Quantities for Driver and Driv-
Man to diverge. In order to evaluate the maneuver step at start, the additional Info File
key DrivMan.Step.CalcAtStart was introduced. It can be specified either in the SimPa-
rameters or the Test Run Info File (Test Run overwrites SimParameters). Per default,
the parameter is zero which means the behavior described above (as in CarMaker ver-
sions < 13.1) is deactivated.
• Bugfix: If an initial offset to the route was specified, IPGDriver took this offset into
account when outputting the Static Desired Course, resulting in a course in parallel to
the actual course (e.g. in ModelCheck).
• Bugfix: In some cases, IPGDriver was unable to find the correct start gear for a given
start velocity and a time for shifting of zero (shifting without clutch).
• Bugfix: In some cases, IPGDriver was unable to operate the selector control with auto-
matic transmission and the option use handbrake for driveaway.
IO Configurator
• Bugfix: Very large parameterization tables were not read correctly.
• Bugfix: E2E Profile 6 was not correctly displayed in the dialog, missing the length signal
and having a length parameter for the CRC signal.
• Bugfix: Removing a frame from an existing and already saved RBS configuration pro-
duced unnecessary warnings.
• Bugfix: Changes to Frame/PDU type filter were not recognized as changes in the
Select ECU dialog. As a result, the OK button was not available.
• Bugfix: In some cases the database type was not correctly shown in the data storage
browser information field.
• Bugfix: The tree representation was not correctly updated when removing a mapping.
• Bugfix: Functions for new elements were not initialized after changes in the Select ECU
dialog.
• Bugfix: The compiler macro #if 0 was filtered while loading in the Hook Editor.
• Bugfix: Custom compile parameters added in the build dialog were not correctly
applied.
• Bugfix: The RBS prefix was not correctly exported to user code.
• Bugfix: Menu entries of edited user code were not correctly marked while loading in the
Hook Editor.
XCP
• The ODT optimization according to the ASAM layer protocol specification will now be
applied to the generated measurement. Please find further information on the support-
ed optimization types in the Programmer’s Guide, with the Info File key description of
ECU.<n>.DAQ.Opt = OptType AddrExt IdentFieldType.
• Bugfix: Variables at the upper address range border were erroneously discarded.
• Bugfix: A Tcl error could occur when starting a simulation with active XCP while the
XCP dialog had not been opened in the current CarMaker session.
• Bugfix: (De-)Activation via Onboard Diagnostics did not work, because the entries
Enable XCP or Disable XCP in the context menu of the XCP Configuration dialog could
not be activated.
• Bugfix: The mapping of a variable was not correctly cleared when it was removed from
a group in the XCP Config dialog.
• Bugfix: A Tcl error could occur while removing a measurement group in the XCP Con-
figuration dialog.
• Bugfix: Loading older XCP configurations in the XCP Setup dialog led to the ASAP2
keys being duplicated while saving.
• Bugfix: The automatic update function to update an APO based XCP parameterization
(CarMaker 9.x) to an Info File based XCP parameterization lost the active UAQ vari-
ables.
• Bugfix: Synchronizing the ECU and not applying the changes still led to a warning of
not saved changes.
• Bugfix: The XCP-Diff dialog showed the XCPParameters as difference.
• Bugfix: No feedback was given in case of a synchronization with the ECU where no dif-
ferences were found.
• Bugfix: The default button of the dialog asking if a manually started measurement that
does not match the loaded measurement on the simulation program should be run was
changed.
• Known Issue: A Tcl error occurs while connecting to a real-time system without opening
the XCP dialog first, when the active XCPParameters contains a variable mapping.
Workaround: Please start the XCP dialog first.
General
• Bugfix: Depending on the road geometry the Vhcl.sRoad value was not properly reset
after the previous simulation in CarMaker HIL.
Hardware
• Bugfix: Mioutil did not display the M418 module correctly. This is now fixed with mioutil
revision 4.15.
• Bugfix: Due to a bug in MIO, the sensor emulations of DF11i, DF30i and other PWM
based sensors could not be configured and used on channels 1 to 5 with the M400
module.
Bus systems
• The default value of the optional parameter ByteOrder for the Info File keys
PDU.<PDUName>.SecOC.MsgLink and PDU.<PDUName>.SecOC.AuthFV is
changed to MSB.
• Bugfix: For PDUs in the static FlexRay segment, the cycle time of the PDU was not
considered. This meant that the PDU was always sent when the associated frame was
ready for sending (base cycle/repetition cycle). Now NULL frames are sent if the PDU
is not ready to send, e.g. if the PDU cycle time is a multiple of the frame cycle time.
• Bugfix: In the case that a PDU in a FIBEX database has no trigger no default timing
was applied.
• Bugfix: Container PDUs led to frame timings not being determined correctly.
• Bugfix: To prevent stalling of the real-time system, the RBS restart functionality for
FlexRay is restricted. The FlexRay restart option is retained, with the restriction that the
FlexCardParameter Info File remains unchanged. Otherwise, a restart of the execut-
able is necessary.
• Bugfix: The FlexCard UAQs FC.NumPackets and FC.T_In were created unnecessarily,
even if no FlexCard IO configuration is set up.
• Bugfix: In some cases simulated ECUs had an exported TxMapping as well as a
GWMapping in GateWay mode.
EtherCAT
• The new User Accessible Quantity <ECAT.0.DictDefPrefix>.ResetError was introduced
to enable the user to reset faulty states in slaves.
• If CarMaker isn’t able to reach the requested state on startup, the session log now
shows a warning.
• Bugfix: When CarMaker was shut down, EtherCAT triggered a log message stating that
the master status had been changed. This log now indicates that a shutdown is
requested and a corresponding state is triggered for this reason.
• Bugfix: Faulty slave states are now indicated by a warning.
• Bugfix: KPA EtherCAT master start-up in distributed clocks mode failed with the error
message "EcatTimerNsSetClock: Operation not permitted".
• Bugfix: Entries in the ESI file containing whitespaces were not read correctly.
• Bugfix: PDO entries in the ESI file which did not have the Datatype element, caused
CarMaker to show an error. Now the entries are read correctly.
• Bugfix: If the CarMaker was not terminated correctly, there was sometimes an Ether-
CAT error spam in the session log.
IO Configurator
• The half duplex support for the M77N was removed within the IO Configurator due to a
firmware issue on the supplier’s side that will not be fixed.
• Bugfix: Selecting mapping kind DDict of an output channel of the M66 module led to a
segmentation fault.
• Bugfix: Selecting "Constant" for the mapping of the status nibble led to a zero as output.
RealtimeMaker
• Bugfix: The Encrypt data dialog showed a CarMaker versions in RealtimeMaker.
IPGTools
connected. In the latter case, extending the data dictionary in smaller chunks might be
a used as a workaround, i.e. calling AposReady() (CarMaker: DDictReady()) more
often.
OpenSCENARIO Converter
• Files created by the OpenSCENARIO Converter will now use the OpenSCENARIO ver-
sion for the FileCreator information in the header.
• More detailed logging messages are now provided for unsupported features.
• Bugfix: The log file created with the "--logtofile" option contained extra quotation marks.
• Bugfix: The axle position for traffic objects with 4Wheel motion model was ignored
which led to an incorrect initial placement of the object.
• Bugfix: During the import of OSC files containing the LateralOffsetAction an error was
triggered by an incorrect LatAccMinLimit for traffic only.
• Bugfix: When converting a non-vehicle entity, which is referred in the condition as "enti-
tyRef", a wrong reference point was set.
• Bugfix: If no ego vehicle is selected in the OpenSCENARIO Converter GUI, the valida-
tion was not used even if it was activated.
• Bugfix: If error messages occurred in the OpenSCENARIO Converter during validation,
only the very first error message was displayed in the GUI.
Third-party tools
MATLAB
• Bugfix: CarMaker tools for the Matlab command line like cmread or ifile failed on argu-
ments of type string array.
• Bugfix: In CarMaker for Simulink the Matlab workspace variable CMData was set with-
out its elements NValues and Variation.
• Bugfix: The Matlab command Simulink.Bus.createObject resulted in duplicate defini-
tion errors, when called on a model that contained any of the blocks Define CM Dict,
Signal Access or Body Frame.
• Bugfix: The start position of the ego vehicle in the example Test Run Examples/
Basic/Functions/Driver/SteeringByTorque was adjusted slightly in order to not
trigger a session log warning.
• Bugfix: The position for two stationary traffic objects was adjusted in the product exam-
ple TestRun Examples/DriverAssistance/ParkingAssist/
ParallelParkingInCity.
• Bugfix: Small graphic issues were fixed in the product example HD Scenario Test Run
Examples/HDScenarios/SanFrancisco/SanFrancisco_Driving_Summer.
• Bugfix: The performance in the HD Scenarios SanFrancisco, SuburbanStreet,
ParkingGarage, A9_Garching, CityTunnel, MountainRoad and UK_Highway was
improved.
• Bugfix: The start time in product example Test Run Examples/HDScenarios/A9_Garching/
A9_Garching_Autumn_Cloudy was changed to improve headlight effects.
Vehicles
• Bugfix: The orientation of the Radar RSI rear sensor in
Demo_IPG_CompanyCar_MultiRSI has been corrected.
Model extensions
• Bugfix: Unit definitions were missing in the MySteering_FMU product example.
• Bugfix: A wrong gearbox User Accessible Quantity was used in ESP_RTW.mdl example.
Coding examples
• Bugfix: The description of the Python API product example usage inside the example
code files was outdated.
• Bugfix: The auxiliary functions for the output of messages in the code samples in
<IPGHOME>/carmaker/<architecture>-<version>/Examples/IPGRoad reverted
the order of messages not considering multi-part information.
• Bugfix: The example code in <IPGHOME>/carmaker/<architecture>-<version>/
Examples/APO did not compile under MS Windows because of two missing files,
resources.rc and ApoClnt.exe.manifest.
Documentation
• A new chapter about EtherCAT master synchronization modes was added to the Pro-
grammer’s Guide, see section 21.3.3 ’Sychronization Modes’.
• Bugfix: The documentation about Rest Bus Simulation and SOME/IP in the Program-
mer’s Guide was reworked and completed, see section ’Rest Bus Simulation for
FlexRay, CAN & Automotive Ethernet’.
• Bugfix: The description of function MIO_M403_GetEvDuration() was corrected.
• Bugfix: Some of the GPU Coding Interface code examples were outdated in the Pro-
grammer’s Guide.
• Bugfix: The description for the Lidar RSI UAQ nRefl in the Reference Manual was out-
dated.
• Bugfix: The documentation of deprecated normal vector User Accessible Quantities
provided by the Free Space Sensor Plus was removed from the Reference Manual.
• Bugfix: The default value of the parameter Materials.N in the Reference Manual was
outdated.
Chapter 3
Release History Bugfix Releases
Licensing
• Only one dongle ID was displayed in the Help > License Info dialog of the CarMaker
main GUI, even if more than one dongle was used on the current system.
• Bugfix: License sharing for CarMaker Add-on licenses (CM-MBSS, CM-PSM) did not
work for nodelocked and dongle licenses on Windows systems if the Test Manager was
used in parallel execution mode. Floating licenses and Linux systems were not affected
by this.
Please note: Mixed operation of current/previous Test Manager releases with CarMaker
executables of previous/current releases may not work when using parallel execution
mode and nodelocked/dongle licenses.
Project Update
• Bugfix: The project update from CarMaker 12.x to CarMaker 13.0 failed for Test Runs
containing a path point maneuver.
• Bugfix: The UAQs PT.GearBoxM.* were not considered by the project update.
• Bugfix: UAQs named PT.Gearbox.GearNo.* were not converted by the project update
but only marked with prefix REMOVED. However, UAQs referring to GearboxM units
still need manual treatment as the use is not always unambiguous.
• [Bugfix: The project update of modified versions of the HydBrakeCU_ESP.mdl only
worked if it was not renamed.
Simulation framework
• Bugfix: The simulation program did not show up in the Task Manager of Windows 10 if
it was started by the GUI.
Script Control
• Bugfix: Key Values of type Txt were not always used correctly when querying in the
GUI. Affected Script Control procedures were KeyValueTxt set and IFileValueTxt.
3.1.3 Visualization
Movie NX
• The Connect to Application dialog has been improved visually and functionally.
• Added underlined shortcuts as a possible menu control for Movie NX. Pressing Alt and
the underlined letter of a menu item opens the corresponding dialog. For example
[alt+f] opens the File dialog.
• Bugfix: It was not possible to directly use shortcuts if the full screen mode was opened
via the menu bar.
• Bugfix: The exposure settings and naming were clarified in the GUI.
• Bugfix: The Movie NX session log and file log did not contain the engine log. In addi-
tion, the log output has been reformatted to better highlight log level and origin of the
log message.
• Bugfix: Smart traffic could lead to noticeable frame spikes proportional to the amount of
objects in the Test Run.
• Bugfix: The field of view and fitmode of the distorted rectilinear lens in interactive Movie
NX were invalid.
• Coloration modes viewed with the distorted rectilinear lens were displayed in a wrong
resolution.
• Bugfix: Some materials were missing when object class coloration was used before
loading a Test Run.
• Bugfix: In some cases the simulation of a Test Series could crash Movie NX if the start
position of the ego vehicle was not specified by correct values.
• Bugfix: Road paintings were not painted on road markings but displayed inside of them.
• Bugfix: Movie NX could not read textures of Road elements (e.g. sign plates or road
paintings) from the Movie folder.
• Bugfix: The Movie NX installation directory contained an unnecessary simulation log
folder.
• Bugfix: The replay slider movement was blocked at some timestamps.
• Bugfix: The replay toolbar did not properly take the rounded corners into account when
using Windows 11.
• Bugfix: Movie NX capped its frame rate to half of the expected value if OpenGL was
used on Linux with active vertical synchronization. This affected both the Camera RSI
in VIB mode and the visualization instance.
IPGMovie
• Bugfix: A Tcl error occurred when the Test Run contained traffic objects and was
reloaded internally.
• Bugfix: Road markings were always black even if another color was defined in an object
class coloration configuration file.
• Bugfix: The Key Value substitution for terrain files did not work correctly, leading to a
false animation in IPGMovie.
3D assets
• Bugfix: The vehicle 3D asset Audi S3 2015 was changed to fix the visual indicator func-
tionality.
• Bugfix: The number plate position of the 3D asset Cadillac_Escalade_V_ESV_2023
was corrected for Movie NX.
• Bugfix: Missing materials of GMC_Hummer_EV_2022 were added.
• Bugfix: The material parameters of the Lexus_NX300h_2015_Wheel were fixed.
• Bugfix: The steering wheel in the asset information ExampleCar.assetinfo was attached
to the wrong frame.
• Bugfix: Several warnings in the Movie NX log caused by 3D assets were fixed.
3.1.4 Vehicle
Car
Model Check
• Bugfix: The Equilibrium Configuration of the ModelCheck failed to encounter static
equilibrium after running ModelCheck in SPMM mode using a MF-Tyre/MF-Swift tire.
• Bugfix: Static equilibrium calculations were erroneously done prior to the evaluation of
the Design Configuration.
Powertrain
• Bugfix: The serial hybrid powertrain allowed a manumatic TCU setting which could lead
to a conflict with the shifting points in the driver parametrization.
• Bugfix: The Electric Motor tab for Powertrain MCU exported incorrect Info File keys.
• Bugfix: An error occurred, when using the copy functionality for an electric powertrain
Drive Source.
• Bugfix: An error occurred, when loading a vehicle with a 2D look-up table for gears.
• Bugfix: It was not possible to use the converter clutch model with an external power-
train Info File.
• Bugfix: Gearbox models were not shown correctly in the powertrain after opening a file.
Suspensions
• Bugfix: The compliance model "not specified" (deactivated compliance) could not be
simulated, when being changed after a vehicle with compliance model Linear had been
loaded.
Truck
Suspensions
• Bugfix: The User Accessible Quantity Car.KinRollCenter.<R3,R4>.* was calculated with
the transformation matrix of vehicle Fr1A instead of Fr1B for flexible trucks with more
than 4 axles. Same applied for external velocities of wheel carriers at axles R3 and R4.
3.1.5 Sensors
Radar Sensor
• Bugfix: A bug in the object detection algorithm could have rarely led to an error.
GPU Sensors
• Bugfix: The balloon help for Movie command in the GPU Configuration dialog could
contain a nonsensical GUI host port address under some circumstances.
• Triggering a calculation outside an active simulation now will have no influence on sub-
sequent triggers during the simulation.
RSIs in general
• The minimum required CUDA version for Lidar RSI, Radar RSI and Ultrasonic RSI has
been increased from 11.7 to 11.8.
• Bugfix: Lidar RSI, Radar RSI and Ultrasonic RSI crashed when a Test Run was restart-
ed which used a Python script with "get_material_unique".
Radar RSI
• Bugfix: Simulating a Radar RSI with File output on a cluster with more than one sensor
could lead to an error.
Ultrasonic RSI
• Bugfix: The Ultrasonic RSI used a version of a CUDA library that was not compatible
with GPUs of the Ada Lovelace architecture resulting in a memory failure.
Camera RSI
Static scenario
• The automatic creation of GiveWay markers on junctions has been improved. Now,
when placing the lane, the lane width of both the lane that has the right of way and the
lane that gives the right of way is taken into account. In addition, only one marker is
placed per lane giving priority.
• Bugfix: When automatically creating GiveWay markers at junctions, the direction of lane
paths in left lanes relative to the reference line was not correctly taken into account. As
a result, e.g. Traffic Swarm was disabled.
• Bugfix: An autonomously driving traffic object might have stopped at the GiveWay
marker and did not continue driving if two GiveWay markers were placed at the exact
same position.
• Bugfix: When adding a GiveWay or priority path to a Right of way controller, no selec-
tion menu was offered to choose between overlapping paths.
• Bugfix: In some cases connecting or splitting links connected to a junction could lead to
invalid connection information about the junction’s junction links. This caused faulty
routes or a crash of the GUI if a route was defined over such a junction link.
• Bugfix: The junction mode specified in the Scenario Editor’s User preferences was not
always considered correctly: For virtual junctions, the mode "Add all junction links" had
no effect and the corresponding context menu functionality was missing. Moreover, the
existing junction links of a simple or extended junction were replaced if a junction arm
was added to the junction.
• Bugfix: In some cases the GUI could crash if a link connected to an extended junction
with a mesh height map using automatic mesh creation was deleted.
• Bugfix: When using OpenCRG files, the slope and banking channels may not have
been taken into account correctly.
• Bugfix: The interpolation methods Step0 and Step1 were not handled correctly in
OpenCRG. The transition area, which is always based on cubic interpolation, was also
corrected for these cases.
• Bugfix: When reading an invalid *.rd5 Info File with a File segment with a missing Open-
CRG object, an inappropriate OpenCRG object was added without informing the user.
• Bugfix: In case an OpenCRG surface was used to define the 3D surface of a link, the
link was not visible in the Scenario Editor in some cases.
• Bugfix: If the Route Generation tool was applied with route criterion fastest, links with
road type undefined were considered as links with road type urban road. Moreover, a
speed limit definition of a road type set to zero was treated as 130km/h.
• Bugfix: The performance of dismissing a road definition in the Scenario Editor by using
for example New road definition was improved noticeably.
• Bugfix: If a background image or right of way controller were added or adjusted an
unsaved changes dialog was missing.
• Bugfix: In case the image anchor point of a background image was not defined explicit-
ly but by a certain mode, the entry fields for the coordinates were not disabled.
• Depending on the system used, Shift key interactions in the Scenario Editor did not
work correctly.
• Bugfix: If visualization parameters, terrain parameters or Static scenario settings were
changed by New road definition, the highlighting pointing out invalid values or Named
Values was not removed.
• Bugfix: For some object types visualization was not possible within a second scenario
created by New road definition. This affected background images, geometry objects,
road paintings, traffic lights, traffic signs and markers.
• Bugfix: It was not visible in the Parameters tab that Named Values are not supported for
background images.
• Bugfix: In the Scenario Editor, in some cases concerning elevation, slope and camber
profile, lateral offset, lane width, inner/outer height and width of a raised profile, there
was a special treatment for the value -999, although it had no special meaning in
IPGRoad.
• Bugfix: Unsuitable values for settings led to an error message if the scenario was saved
or the simulation or the 3D preview was started. Moreover, generating a terrain led to
an error message if unsuitable terrain settings were defined.
Road API
• Bugfix: When using IPGRoad API functions, connecting already connected junction
arms or link nodes to another link node or junction arm was not prevented and let to
faulty connections. This also affected OpenDRIVE imports.
• Bugfix: The version of IPGRoad stated in the API header files and code samples was
not up to date.
Traffic
• Bugfix: In rare cases a segmentation fault occurred when using Traffic Swarm and a
starting traffic object in a source was disabled in the same.
• Bugfix: When using Traffic Swarm, it sometimes led to an error when the ego vehicle
stopped harshly at a border between two lane sections or between a lane section and a
junction.
• Bugfix: When using Traffic Swarm and a road position evaluation error occurred, the
error message "outside of link/junction" was displayed. Now, temporary road position
evaluation errors are allowed. However, if too many subsequent road evaluation errors
arise, an error is thrown due to restrictions in the algorithm.
• Bugfix: A segmentation fault occurred if a traffic object with motion model Ball was used
as a stationary object.
• Bugfix: If enabled, GCS quantities for Smart Traffic objects were always created with
the value 0.
• Bugfix: In rare cases, an unsuccessful initialization of a linear map within the traffic gen-
erator module could lead to a simulation crash.
• Bugfix: An error could occur in the Traffic Generator for a very steep gradient of the
route.
• Bugfix: It was not possible to start the simulation if a 2D contour was added to a traffic
object and some entries were deleted.
• Bugfix: Selecting a vehicle start position of type lane with the mouse could lead to a Tcl
error, if the lane is was not exactly under the cursor.
• Bugfix: A Tcl error occurred when expanding a directory item in the Traffic Object Tem-
plate browser or editor.
• Bugfix: The value of Longitudinal Motion -> Proportional gain speed control entered in
the Traffic Driver Templates dialog was ignored by the simulation program.
• Bugfix: An error occurred when Traffic objects were selected in the Object list before
switching into static mode.
• Bugfix: The path list entry field of the Traffic Editor’s Routing was marked red as soon
as 10 elements were selected. Now the input field correctly only turns red with more
than 10 entries.
Maneuver in general
• The reference position was not calculated correctly in the initialization phase if a rela-
tive Follow Trajectory action was used as the first maneuver step.
IPGDriver
• Bugfix: The ModelCheck of IPGDriver failed when sampling the lane borders on a spe-
cific junction. In that context the example roads RuralRoad_Tollgate.rd5 and
Eight_20m.rd5 have been adjusted slightly.
• Bugfix: Now the simulation aborts immediately if a Driver adaption of only Controller
dynamics was performed without knowledge about the Vehicle dynamics.
• Bugfix: After a driver adaption the slider for adjusting the z-clipping plane did not work
correctly.
• Bugfix: The Additional Parameter Vhcl.Class in the Driver knowledge was not recog-
nized correctly by the GUI and colored red.
• Bugfix: The Driver dialog in MotorcycleMaker 13.0 incorrectly displayed the Traffic
parameterization tab even though traffic detection is not supported by the Motorcycle-
Maker driver.
IO Configurator
• The number of hook functions for IO Configurator was increased to 1000.
• Bugfix: The entry for c-code byte 6 was not shown when Mapping type c-code was
selected.
• Bugfix: Using more than 1 byte with Direct Variable Access and the M405 module led to
a segmentation fault.
XCP
• Bugfix: The XCP control LED in the CarMaker main GUI was not correctly updated
when a measurement was started without opening the XCP Configuration dialog first.
• Bugfix: When using the DAQ block mode it was possible to create a configuration in
which a variable was only partly in the block.
Modules
• Bugfix: The handling and error message for unsupported revisions from 5.1 were miss-
ing for M400.
General
• Bugfix: Xeno executables built on Ubuntu 22.04 could not be executed on Xpack4 sys-
tems.
Xeno-rt
• Update to Xeno-rt 13.0.1 including:
- update EtherCAT components to version 13.0.1
- update to GLIBC 2.35 (Ubuntu 22.04.3)
- update of bin/ldd (matching with GLIBC 2.35)
- update of libstdc++ to version GLIBCXX 3.4.30 (Ubuntu 20.04.3)
- several missing files were added such as:
/lib64/libc_nonshared.a (referenced by /lib64/libc.so)
/lib64/libc_malloc_debug.so.0
/lib64/libmemusage.so
/lib64/libpcprofile.so
- /lib64/libc_nonshared.a was removed
- corrected permissions for lib64/ld-linux-x86-64.so.2 on Windows hosts
EtherCAT
• Bugfix: Running an older CarMaker HIL simulation program with EtherCAT master on
an Xpack4 real-time system with up-to-date boot environment sometimes failed
because of inconsistent mempoolsize settings.
RealtimeMaker
• Bugfix: Realtime Expressions using the variables cnt or t didn’t work properly in Real-
timeMaker. Both variables’ value was zero all the time.
• Bugfix: The Functional Mock-up Interface (FMI) did not work with RealtimeMaker.
IPG Tools
IPGControl
• Update to IPGControl 3.0.14:
For more information on this bugfix release, see release history in the IPGControl User
Manual (IPGControl > Help > User Manual).
OpenSCENARIO Converter
• Bugfix: Updating the OpenSCENARIO project to CarMaker 13.0 could result in a Tcl
error.
• Bugfix: The option --defaultman was ignored, if no maneuver was defined for the ego
vehicle entity.
Third-party tools
MATLAB
• Bugfix: In rare cases the error Embedded FARoadSensor Geo: [...] not found on Road
could occurred with CarMaker for Simulink.
• Bugfix: Depending on their parameterization, the CarMaker for Simulink blocks Radar
RSI and Ultrasonic RSI could not be used multiple times in the same model.
• Bugfix: The MATLAB workspace variable CMData is now updated consistently in the
base workspace.
HD Scenarios
• Bugfix: Some animated objects were not working correctly in the HD scenario Subur-
banStreet.
• Bugfix: Switching between HD scenarios and other Test Runs could cause some ele-
ments of the scene to be missing.
• Bugfix: An unnecessary braking maneuver of the ego vehicle was fixed in the HD Sce-
nario Parking Garage.
• Bugfix: An unnecessary braking maneuver of the ego vehicle was fixed in the HD Sce-
nario San Francisco.
• Bugfix: Due to internal changes, the download link for HD Scenarios has been adjust-
ed.
Documentation
• Bugfix: The supported OpenDRIVE versions listed in chapter 1.3 ’Compatibility and
Supported Standards’ were incomplete.
• Bugfix: The software discontinuation process described in this document was outdated.
• Bugfix: The documentation of the Camera RSI in the User’s Guide was enhanced
regarding the usage of a RSDS client with further options like port specification.
• Bugfix: The Camera RSI documentation in the Reference Manual was updated with the
information that TGPU.GPUSensor.<No>.Total is not valid for Camera RSIs in VIB
mode.
• Bugfix: The description of the parameters for the driving maneuver Velocity Control in
chapter 3 of the Reference Manual has been improved.
• Bugfix: The outdated description of the quadrature encoder output mode of the function
MIO_M401_SetUnitMode() has been corrected in the Programmer’s Guide.
• Bugfix: The documentation of the MIO M417 driver in the Programmer’s Guide was cor-
rected.
• Bugfix: The function RoadGetSensorObjectList() was not suitably described in the IPG
Road API Reference.
• Bugfix: The description of the IPGDriver’s knowledge parameter Vhcl.Class for defining
the class of the driven vehicle was clarified in the IPGDriver User Manual.
• Bugfix: Missing UML diagrams were added in the Movie NX Python API User’s Guide.
• Bugfix: The Movie NX Python API User’s Guide was updated to the new workflow
regarding the configuration of Test Runs / Movie NX Mounts and scripts.
• Bugfix: The Movie NX Python API User’s Guide node structure diagrams with mirrors
were updated.
• Bugfix: A few outdated sections in the Quick Start Guide have been updated.
• Bugfix: The Product Examples documentation about HD Scenarios was refined, clarify-
ing that RSIs based on IPGMovie cannot be used with HD Scenarios.
• Bugfix: A dead link to another manual was fixed in the User’s Guide for RealtimeMaker.
Chapter 4
New Features of CarMaker Product Family
13.0
Simulation framework
• New product variant CarMaker Office Extended for real-time simulations in Office envi-
ronments
Real-time Expressions
• One new Real-time Expression and extensions of several existing Real-time Expres-
sions
Script Control
• New command Application performance to modify the simulation’s performance mode
4.1.3 Visualization
Movie NX
• Higher level of detail for tree strips in Movie NX
• New HD Scenario CityTunnel
3D assets
• New vehicle and proving ground models in the 3D object library
• Support for compositions of asset and custom vehicles with Asset Info Files in Movie
NX
4.1.4 Vehicle
Car
Powertrain
• New model Free End for the modular powertrain
• Simplified powertrain interfaces for gearbox and clutch
• Extension of Parallel P2 PT Control model regarding opening behavior of de-coupling
clutch
• Physical interface between MCU and motor including models for field oriented control
and a permanent magnet synchronous motor
• New User Accessible Quantities and interface variables for the DrivMan and Vehicle
Control modules for modeling a digital gear selector
• Configurable behavior for DCT TCU when ignition is off
Suspensions
• New ModelClass Susp_TopMount with Kelvin-Voigt damper top mount model
• New model classes for suspension framework:
- Suspension_FrcSystem to model interactions between different force element types
and across the suspensions on different wheels
- Susp_SpringSystem, Susp_DamperSystem, Susp_BufferSystem &
Susp_StabiSystem to model interactions across different wheels for each force ele-
ment type, i.e. spring, damper, buffer, stabilizer.
• New multi-body suspension model FourLinkModExtended
• New multi-body suspension model variant DoubleWishbone ForceCoupling
Brake
• New Hydraulic Integrated Powerbrake Model HydIPB
Tire
• Support of FTire 2023-3
• Support of MF-Tyre/MF-Swift 2306
• Support of TameTire 6.3.7
4.1.5 Sensors
RSIs in general
• Support of albedo textures for Movie NX based RSIs
Static scenario
• Importing multiple routes in KML file
• Moving and rotating multiple objects via temporary groups
• Improved depiction of road paintings
• Improved presentation of height information
• Terrain generation: New option to ignore links and junctions
• Extension of User preferences by default road type
• Expansion of the German traffic sign library
IPGRoad API
• Terrain generation: New option to ignore links and junctions
Traffic
• Introduction of new Smart Traffic Generator features:
- Existing Traffic Source sink renamed to Traffic Swarm
- Traffic Swarm with consistent consideration of density and car ratio from lane paths
in road, e.g. to define local traffic condition anomalies in a scenario
- Placeable user sources and sinks on the road to create or remove traffic flow in the
simulation
Maneuver in general
• New maneuver step Follow trajectory for ego and traffic
• New relative target values for the maneuver steps Velocity, Speed transition, Lane
Change and Lane Offset
• New relative position types and orientation types for start and teleport positions
IPGDriver
• Revised parametrization of IPGDriver with driver templates
• Reworked and extended dialogs for driver parametrizations, including a new Expert
Parameters dialog
• Reworked and extended dialogs for driver adaption and editing of learned knowledge
• Support for multiple knowledge data per driver from different adaptions
• Improved OpenSCENARIO support
• IPGDriver with speeds lower than 1 kph
XCP
• New ECU Sync option to compare the ECU configuration with the ECU settings
Hardware
• Update to busybox version 1.26.1
- new commands: /bin/tree, /sbin/seedrng
- new options for the find command: -atime, -ctime, -amin, -cmin, -samefile
• Update mioutil 4.14: unrestricted Memory-Pool-Size
• Update EtherCAT-Module: default Xenomai memory pool size 256M
• Additional Kernel modules macvlan.ko, macvtap.ko, macsec.ko
EtherCAT
• New ProductCode in ESI_File for EtherCAT slave card (F752)
• Reworked EtherCAT State Machine
IO Configurator
• New supported modules:
- M77 Quadruple RS232/423 - RS422/485 UART
- M416 DSI3
- M417 and M417-01 Analog outputs
• M400 with new sensors: A1923, A1933 and TLE5549iC
• On demand propagation of channel-activation to the top
IPG Tools
OpenSCENARIO Converter
• Integration of the OpenSCENARIO Converter in the CarMaker GUI
• Support for ASAM OpenSCENARIO v1.1 and v1.2
• Extended validation incl. new command line arguments and support for referenced files
• New position types for initialization phase by importing OpenSCENARIO file
Third-party tools
MATLAB
• Support for MATLAB 9.14 R2023a
• The data types of the input and output ports of the Signal Access Block can now be
inherited from the connected blocks and are no longer fixed to double.
ADTF
• Synchronization of ADTF run level
• Simplification of connection parameters
• Support for Linux OS
Documentation
• New User’s Guide for RealtimeMaker
Figure 4.1: Former Additional Parameters dialog as revised Test Run Parameters dialog with
visualization parameters
Simulation framework
• New product variant CarMaker Office Extended
A product variant CarMaker Office Extended for real-time simulations in Office environ-
ments is available. The main differences compared to CarMaker Office are:
- Fixed real-time factor of 1.0 in the all phases (ramp-up, simulation and idle states)
- Improved timer to avoid time-offsets and cycle violations
- IO communication with the Peak- and Vector-Interfaces
New parameters and User Accessible Quantities for the observation of the cycle time
distribution are available. Please find further information about features, hardware
requirements and current limitations in the User’s Guide, section 2.1.5 ’CarMaker
Office Extended’.
Note: To run the simulation with CarMaker Office Extended a license extension is
required.
Real-time Expressions
• One new Real-time Expression and extensions of several existing Real-time
Expressions
- The new Real-time Expression CheckCollisionByType was added which checks for
a collision of the trigger entity with other objects of the indicated type. Traffic objects
with object class Unknown or Toy are considered as type misc. Traffic objects with
object class Animals and People are considered as type pedestrian. All other traffic
objects, the ego vehicle, and the trailer are considered as type vehicle.
- A second option for the calculation of the Relative Lane Position is available and can
be selected with the optional parameter UseRefLineDir. For this new option the lon-
gitudinal offset (ds) and the number of offset lanes (dLane) are specified in direction
of the reference line instead of the direction the reference object is facing.
Please find further information in the User’s Guide, section B.2.3 ’Distance and Time
Measurements’.
Script Control
• New command Application performance to modify the simulation’s performance
mode
A new Script Control function Application performance is introduced to modify the cur-
rently selected performance mode of the simulation. Please find more information in
the Programmer’s Guide, section 25.4.13 ’Application commands’.
4.2.3 Visualization
Movie NX
• Higher level of detail for tree strips in Movie NX
A new level of detail procedure is introduced for tree strips in Movie NX. This method
blends between two 3D models of different complexity depending on the viewing dis-
tance. In order to ensure full utilization of this system and to increase graphical fidelity,
the 3D models used were also exchanged. These measures result in a more detailed
illustration of tree strips in Movie NX.
3D assets
• New vehicle and proving ground models in the 3D object library
The 3D object library has been extended by 14 new vehicle models and two new "prov-
ing ground" models with different variants. For an overview of new objects, open the 3D
Objects Catalog (CarMaker main GUI > Help > 3D Objects Catalog). In the catalog,
click New in 13.0.
• Support for compositions of asset and custom vehicles with Asset Info Files in
Movie NX
Compositions of asset and custom vehicles for Movie NX can be created with the newly
introduced Asset Info Files. Please find further information in the Movie NX manual,
section 7.2 ’Asset Info Files’.
4.2.4 Vehicle
Car
Powertrain
• New model Free End for the modular powertrain
A new model Free End for the modular powertrain is introduced. It works as the end of
a mechanical chain that is not connected to the driveline or the wheels. The model rep-
resents a free-spinning end. An external torque can be applied to it via Direct Variable
Access on the User Accessible Quantities PT.FreeEnd.<Id>.Trq_ext.
Please find further information in the Reference Manual, section 16.4.6 ’Free End’.
• Simplified powertrain interfaces for gearbox and clutch
The powertrain interfaces for gearbox and clutch were simplified. The GearBoxIF and
GearBoxM_IF[i] structs were merged to a single GearBoxIF[i] struct. The ClutchIF and
ClutchM_IF[i] structs were merged to a single ClutchIF[i] struct.
This implies the renaming of several Info File Keys and User Accessible Quantities, as
well as interface variables and parameters for user model extensions and FMUs.
All changes are documented in the UserInterfaceChanges.csv available in the installa-
tion directory under <IPGHOME>/carmaker/<arch>-<version>/doc/
UserInterfaceChanges.csv.
Please note, that the automated project update does not cover all adaptions. See sec-
tion ’Upgrading from Version 12.x to 13.0’ in this document for further information.
• Extension of Parallel P2 PT Control model regarding opening behavior of de-cou-
pling clutch
A new parameter for the Parallel P2 PT Control model is available to define the opening
behavior of the de-coupling clutch. The parameter PowerTrain.Control.Eng-
Stop.ClGrad_Open enables to parametrize the gradient of the engine torque ramp-
down and the gradient for the de-coupling of the clutch. This parameter is treated as
additional parameter. Please find further in the Reference Manual, section ’PTControl
model Parallel P2’.
• Physical interface between MCU and motor including models for field oriented
control and a permanent magnet synchronous motor
The interface between MCU and motor transfers motor voltage and current in stator
phase (UVW) or relative (dq) coordinates. New motor models have been introduced for
a permanent magnet synchronous machine (PMSM) and field oriented control (FOC).
They have been implemented for the product example Demo_Tesla_S.
The model can be selected from the Motor model selection menu on the Powertrain tab
in the Vehicle Data Set Editor. Its parameters need to be configured on the Additional
Parameters tab.
Please find further in the Reference Manual, section ’Electric Motor model "PMSM"’.
Figure 4.4: New electric motor model PMSM and its parameters
• New User Accessible Quantities and interface variables for the DrivMan and Vehi-
cle Control modules for modeling a digital gear selector
New User Accessible Quantities and interface variables have been added for the Driv-
Man and Vehicle Control modules that allow the modeling of a digital gear selector. The
quantities DM.DigitalSelectorCtrl.<0-2> can be used to generate a square wave signal.
This signal can be interpreted in a Vehicle Control user model to change VC.SelectorC-
trl. A new entry SelectorCtrl_S was added to the enum tSelectorCtrl in Vehicle.h.
• Configurable behavior for DCT TCU when ignition is off
A new set of parameters for the Double Clutch Transmission Control Unit (DCT TCU) is
available that allows the parametrization of the clutch and gearbox state for the case
that the ignition is off.
Please find further in the Reference Manual, section ’Ignition Off’.
Suspensions
• New ModelClass Susp_TopMount with Kelvin-Voigt damper top mount model
A new model class Susp_TopMount is introduced. A top mount can be placed between
damper and vehicle body. Top mounts of this model class can be combined with arbi-
trary damper models, including FMUs, Simulink plug-ins, and C code models.
A new model of a Kelvin-Voigt top mount is introduced (Model Kelvin-Voigt). The model
consists of a parallel connection of a spring and a damper with an optional additional
mass.
Please note: The usage of the old damper model kind Newtonian_wTopMnt is depre-
cated. The same model approach can be represented by combining a simple Newto-
Figure 4.5: New Damper Top Mounts in the Vehicle Data Set Editor
force elements are disabled and grayed out, because they are also considered by
the Susp_FrcSystem model. An exception is the Damper tab, because it’s Top-
Mounts can still be parameterized there.
Figure 4.6: New vertical System tab for the Susp_FrcSystem model class
type. As figure 4.7 shows for the example of the Spring, each of the force elements
now have a horizontal System tab besides the Front and Rear tabs. If the user
selects a user model on the System tab, the Front and Rear tabs get disabled.
Figure 4.7: New horizontal System tab for the Susp_FrcSpringSystem model class
- The Damper tab is shown in figure 4.8, where the Damper TopMount always stays
available.
Figure 4.8: New horizontal System tab for the Susp_DamperSystem model class
- All new suspension classes have additional full vehicle state inputs and optional
control signals, which can be configured by the user.
- C-Code, Simulink Coder and FMU example models for the suspension force sys-
tem, spring system, damper system, buffer system and stabilizer system model
classes are provided.
Please note: New user models should be incorporated within the framework of the
new model classes and old ones should be adapted to the interface of the model
classes, because the External Suspension Forces model class will be removed in
future CarMaker releases.
More information about the new model structure and parameters is available in the
User’s Guide, section ’Vehicle Model’. For more technical details please refer to the
Reference Manual, section ’Suspension Force Elements’.
• New multi-body suspension model FourLinkModExtended
A new MBS suspension model Fourlink modified is introduced. The differences
between the Fourlink extended and Fourlink modified suspension model are bushings
between wheel carrier and lower wishbone, wheel carrier, and steering rod as well as
between wheel carrier and trailing arm. The upper wishbone is designed as A-arm with
two bushings between upper wishbone and subframe. The stabilizer link can optionally
be attached to the upper wishbone. Please find more information in the Reference
Manual, section 13.6.10 ’Fourlink modified extended suspension’.
Brake
• New Hydraulic Integrated Powerbrake Model HydIPB
The new HydIPB Hydraulic Brake System model is available. It models a hydraulic Inte-
grated Power Brake, which previously could not be simulated in CarMaker. The struc-
ture of the HydIPB model is shown in figure 4.11.
Reservoir
p0
Reservoir
Valve
Master Cylinder
Brake
Pressure Booster Pedal
Pres. M
Booster Emulator
Check Valve Valve
Damper Damper
Chamber 2 Chamber 1
to Reservoir to Reservoir
Outlet Outlet
Valve Valve
The main novelty of the model is the pressure booster cylinder, depicted in the center.
While in more conventional brake systems the pressure generated in the master cylin-
der is used to build up the braking force, this is not the case for the HydIPB model.
Instead, the pressure booster cylinder is used to generate the brake pressure in the
brake circuits. When a travel of the brake pedal is registered (in reality by a sensor) the
hydraulic brake control unit gives a drive signal to the various valves of the brake sys-
tem. The pressure build up in the pressure booster then leads to the pressure build up
in the circuits.
For autonomous brake interventions the drive signals for the solenoid valves and the
signals to control the pressure booster will be given by the HydBrake Control Unit inde-
pendently of the pedal travel, i.e. without being triggered by the brake pedal movement.
Please find further information in the Reference Manual, section 17.5 ’High Resolution
Hydraulic Brake System models "HydESP" & "HydIPB"’.
Tire
FTire
• Support of FTire 2023-3
FTire version 2023-3 is supported. Please pay attention to the platform dependency of
this tire model according to section ’Feature Support for Different Target Architectures’.
For more information please refer to the Reference Manual, section 18.8 ’Tire Model
"FTire"’.
MF-Tyre/MF-Swift
• Support of MF-Tyre/MF-Swift 2306
MF-Tyre/MF-Swift version 2306 is supported. The interface was extended to allow the
user to modify some parameters of the .tir file via Info File key and Direct Variable
Access (DVA).
If the Info File key <Param>.Override is set to one, overruling of parameters with syntax
<Param>= LMUX, LMUY, LKX, LKY, LKYZ, LKZC, LTR, INFPLRES is enabled.
<Param.StartVal> sets the start value and overrides the quantity value read from the
*.tir file.
Please pay attention to the platform dependency of this tire model according to section
’Feature Support for Different Target Architectures’.
For more information please refer to the Reference Manual, section 18.7 ’Tire Model
"MF-Tyre/MF-Swift"’.
TameTire
• Support of TameTire 6.3.7
TameTire version 6.3.7 is supported. The new Info File key Init.InfPress for overwriting
the initial inflation pressure read from the .tir file has been introduced.
Please pay attention to the platform dependency of this tire model according to section
’Feature Support for Different Target Architectures’.
For more information please refer to the Reference Manual, section 18.6 ’Tire Model
"TameTire"’.
4.2.5 Sensors
For each object class specific additional information is available, such as position, ori-
entation and dimensions for traffic signs, traffic lights and mounts and the current state
of a traffic light. Via the c-code API further information such as neighboring lanes can
be accessed directly by pointers to the according object.
For more information on the Ground Truth Sensor, see Reference Manual section 21.8
’Ground Truth Sensor’.
RSIs in general
• Support of albedo textures for Movie NX based RSIs
The Radar RSI, Lidar RSI and Ultrasonic RSI based on Movie NX now support albedo
textures when using OpenGL.
The sensor preview mimics this behavior and does not render scene lighting anymore.
Please refer to the Reference Manual, section 21.3.9 ’Movie NX limitations’, for details
on the OpenGL support.
Static scenario
• Importing multiple routes in KML file
In the Scenario Editor, the option Import from KML file was added. With Import from
KML file, KML files with multiple routes can be imported (see figure 4.14).
Every route from the KML file is converted into a Road5 link (see figure 4.15).
To improve the overall result of unsuitable KML files, additional postprocessing parame-
ters can be set in the User preferences (User preferences > Import and export > KML
import).
For more information, see User’s Guide section ’Import from KML file’ and section
’KML import’.
• Moving and rotating multiple objects via temporary groups
For the selection of multiple objects in the object-related tools of the Scenario Editor in
static mode, temporary object groups are now used. These object groups allow to
move and rotate several objects at once by editing the parameters in the object group’s
Parameters tab or by adjusting the object group using the mouse.
Temporary object groups are only available for root objects!
Figure 4.16: Moving and rotating multiple objects in the Road segment tool
To select multiple objects, press and hold Ctrl and click all desired objects or draw a
rectangle around the objects. The objects’s type must match the type of the active tool.
A temporary object group is created for the selected objects.
Background images, global reference lines, links, and junctions can also be grouped
using the Selection mode.
The object group’s rotation center is adjusted automatically.
Elements of object groups that are created with the Selection mode, the Background
image mode, the Global reference line mode, or the Road segment tool can be trans-
formed. After the object group was transformed, objects can be added to or removed
from the object group.
If objects in an object group are transformed, all connections between links and junc-
tions that are part of the object group and links and junctions that are not part of the
object group are removed!
Object groups that are created with tools that are not related to root objects can only be
used to delete several objects at once.
Figure 4.17: Defining road paintings in the Scenario Editor’s top view
Figure 4.18: Resulting z values displayed on a link’s and a junction’s Parameters tab
For junctions using a simple height map and therefor requiring the definition of a z val-
ue, the parameter Height is editable now. For the definition of a link’s or global refer-
ence line’s elevation, the corresponding elevation profile is used. Therefor, the
parameters Height at start and Height at end have been added to its Parameters tab.
It is no longer possible to delete the elevation profile of a link or global reference line,
since height information is needed for these objects, but a context menu option to
delete all its height points has been added.
As usual, points defined at start or end of an elevation profile override Height at start or
Height at end, respectively. To illustrate this, the corresponding entries are disabled and
a balloon help is shown. This has also been implemented for the parameters defining a
lane’s width as well as for width, inner and outer height of a raised profile.
Moreover, in case of a link, the height information of a junction connected to its start or
end might override the link’s elevation, slope or camber profile. This is now illustrated in
the corresponding Parameters tab: A point defined at the link’s start or end is disabled
in the list and provided with a balloon help, if it is overridden.
To demonstrate this, the depiction in the Scenario Editor’s 2D top view and Height pro-
file view has been adapted. In case the height at start or end is determined by a con-
nected junction, the position is marked with a diamond. Otherwise, if no point is defined
at the position, a triangle is used.
IPGRoad API
• Terrain generation: New option to ignore links and junctions
Terrain generation: An option to ignore links and junctions during the terrain generation
was added. It helps to improve the terrain generation for road scenarios with overlap-
ping elements like a parking deck with several levels. To do so, use the Road API with
the flag ROAD_LINK_DONT_ADAPT_TERRAIN (for links) or ROAD_JUNC_DONT_ADAPT_TERRAIN (for
junctions). Please find further information in the User’s Guide, section ’Terrain genera-
tion’.
its start position reference. This only works in the s-direction of the selected start posi-
tion reference.
Note: The drag & drop function is not available for the start position type Reference.
Figure 4.23: Positioning of the ego vehicle via drag and drop
Traffic
• Introduction of new Smart Traffic Generator feature
The existing functionality Traffic sources / sinks has been renamed to Traffic Swarm. It
comes with minor changes and additions like a more intuitive parametrization. In addi-
tion, similar advanced traffic generator features were established which, together with
Traffic Swarm, all trade under the mutual name Smart Traffic Generator (see
figure 4.24). The features need to be enabled on the General parameters tab and can
be further parameterized in separate tabs.
Figure 4.24: Smart Traffic Generator General parameters tab with enabled features
With the new functionality User sources, one can place sources manually on a link on
the road. In such sources, traffic objects are created on the specified lane paths during
the simulation to create a spawning traffic flow. The intensity of the flow can be either
adjusted by mode Density or Rate (start velocity and distance to object in front before
starting are calculated according to the fundamental diagram of traffic flow). User
sources can be interactively placed on the road within the Scenario Editor and are dis-
played in green color on the road (see figure 4.25).
User sinks on the other hand remove traffic objects from the simulation if the traffic
object drives over the lane path position the sink is placed on. Like User sources, sinks
can only be placed on links. Sinks either delete all detected traffic objects in general or
only at a specified rate. User sinks are displayed in red on the specified position on the
road (see figure 4.25).
Figure 4.25: User sources (green or highlighted in yellow) and sinks (red) with parameters and
positioning on road network
The Traffic Swarm now consistently considers varying traffic condition parameters from
the road. By default all links and lanes are placed with traffic objects based on the glo-
bally adjusted traffic density and car ratio. However, a selected traffic density and car
ratio for a specific lane path on the road is considered, too, and overrides the global
parameter set if the option is enabled. By enabling the mode in the Traffic Swarm tab
(figure 4.26), a selected lane path density and car ratio serves as a local traffic condi-
tion anomaly (e.g. to model approaching a traffic jam, see figure 4.27).
An additional checkbox enables a more advanced mode in which the lane path param-
eters are interpreted as a change in traffic condition, meaning all subsequent lane
paths inherit the parameters from the predecessor lane path’s parameter set. This
might be useful if a road consists of small lane sections and an individual parametriza-
tion of several lane paths might be cumbersome.
Figure 4.26: Traffic Swarm tab with checkboxes to enable the “Consider lane path parameter”
functionality
Figure 4.27: Traffic condition parameters Traffic density and Car ratio of selected lane path
Please find further information in the User’s Guide, section 5.7.3 ’Smart Traffic Genera-
tor’ and in the Reference Manual, section 22.8 ’Smart Traffic Generator’.
Maneuver in general
• New maneuver step Follow trajectory for ego and traffic
The new maneuver step Follow trajectory is available for the ego vehicle and traffic
objects, improving support for the Open SCENARIO standard. Furthermore, this
maneuver step replaces and supplements the traffic maneuver step Path points. The
improved interpolation behavior to determine the position on the trajectory may result in
Follow trajectory is accessible on the Lateral dynamics tab (see figure 4.28), where the
lateral dynamics are parameterized. Among other settings, the trajectory type, the posi-
tioning type and the orientation type are specified. In addition to the trajectory type
Spline, as used in Path points, there is now also the type Polyline from the OpenSCE-
NARIO standard. It is also possible to set the trajectory points absolute or relative to
objects. The trajectory is defined in a separate dialog (see figure 4.29).
In case of combined steps, the checkbox Specify time channel on the Lateral tab can
be used to specify whether the longitudinal dynamics of the vehicle should also be
defined using Follow trajectory. In this case, Follow trajectory is also displayed on the
Longitudinal tab and the longitudinal behavior can be parameterized. This includes the
channel input and the time reference type. The time can now be set relative to the pre-
vious trajectory point, the step time, or the global time. If Follow trajectory is only a lat-
eral maneuver step, other maneuver steps can be selected on the Longitudinal
dynamics tab.
In the table (see figure 4.29) the trajectory is defined by a list of points. Depending on
the previous settings, the position, vehicle orientation, curvature, time and velocity are
specified for each target point.
For more information on Follow trajectory, see Reference Manual section 22.5.7 ’Follow
Trajectory’.
Path point maneuver steps are converted automatically to Follow trajectory by the
project update. However, for objects driving backwards, the velocities must now be
entered with a negative sign. This is not updated automatically because it is not known
when an object drives backwards, but a warning is issued during the simulation and the
sign can then be adjusted.
• New relative target values for the maneuver steps Velocity, Speed transition,
Lane Change and Lane Offset
The target values for the maneuver steps Velocity, Speed transition, Lane Change and
Lane Offset can now be specified relative to the speed or lane position of a reference
object. For the steps Velocity and Speed transition the relative target value can be
specified via an offset or a factor to the current speed of the reference object. The refer-
ence objects are specified with their name for traffic objects, "Ego" for the ego vehicle
and "Trailer" for the ego trailer.
For more information, search for “Use reference object” in the User’s Guide, section
5.7.6 ’Maneuvers’.
Figure 4.30: Target values depending on a reference object for ego vehicle maneuvers
• New relative position types and orientation types for start and teleport positions
The options to place the ego vehicle and traffic objects at their start and teleport posi-
tion are further extended. The new position types RelativeRoute, RelativePath, Rela-
tiveLane, RelativeLink, RelativeGlobal and RelativeObject allow a positioning in relation
to other objects using different coordinate systems. The orientation can be further
parametrized with the orientation types Relative, RelativeRef and Absolute. Relative
and RelativeRef define an orientation relative to the corresponding coordinate system
either at the start position or at the position of the reference entity. Absolute means a
Figure 4.31: New start position mode for ego vehicle and traffic objects
Figure 4.32: New lateral maneuver step Lane Offset for traffic objects
IPGDriver
• Revised parametrization of IPGDriver with driver templates
In this release the IPGDriver data storage got restructured with a focus on better reus-
ability of existing driver parametrizations across Test Runs. Therefore, changes were
made to the following components: Driver parametrization dialog, Driver adaption dia-
log and Driver knowledge which will be presented in the following.
Figure 4.33: Selection of driver in the ego vehicle view of Dynamic Scenario Editor.
To change the selected driver parametrization, the driver browser can be opened by
the button next to the value. In the Driver Template Browser all parametrizations,
available as driver templates in the project directory or embedded into the Test Run,
are displayed in a list.
A brief preview for the current highlighted parametrization and search / filter widgets
help to find the desired parametrization. A matching parametrization can be select-
ed with the Select button. If a parametrization needs to be edited or there is no
matching parametrization yet, there is a shortcut button to open the Driver Editor for
further steps.
Figure 4.35: Shortcut button to open selected driver template for editing.
The first item in the list of driver parametrizations has the special value Test Run. It
cannot be renamed or deleted. This item holds the always available parametrization
saved in the current Test Run. The following items are driver templates located in the
project directory (created by user) and in the installation directory (product exam-
ples). Several new product examples with pre-configured drivers were added and
are available as driver templates in the installation directory.
Figure 4.37: Driver Editor with driver template list and plus button to create a new parametrization.
The plus button opens the assistant for creation of new driver parametrizations.
- Reworked assistant for driver parametrization creation
The reworked assistant for new drivers now bundles the various means to initialize a
new driver parametrization from different sources. The process of loading pre-con-
figurations has been revised and streamlined, compared to the old Driver Editor. All
the decisions made here are not final. The assistant can be called any time later,
e.g. to reset an existing parametrization.
The Import from ... option allows to replace the current values with the parameters
from an existing Test Run or driver template.
- Reworked Driver parametrization dialog
The Driver parametrization dialog has been cleaned up and re-arranged. Many
parameters, which have been additional parameters before, can now be defined
explicitly from a new Expert Parameters dialog. Parameters which were only valid in
the context of either race driver mode or standard driver mode no longer are visible
in both modes.
Figure 4.40: Longitudinal parameters in race driver mode with cross-references to the driver
knowledge
Parameters which are part of the learned Driver Knowledge are better distinguish-
able through the introduction of a new Driver Knowledge Editor. Cross-references
for fast access between the two dialogs are available.
- New Expert Parameters dialog
User defined parameters can be given as additional Info File keys, but many previ-
ous additional parameters have now been moved to a dedicated parametrization
view, which can be reached with the Expert Parameters button on the Additional
Parameters tab.
Figure 4.43: New driver knowledge dialog with reworked adaption tool.
The Driver Knowledge is initially empty and receives values after a Driver Adaption
has been performed. All the parameters learned can be fine-tuned manually after-
wards, using the Knowledge Editor. Like before, selected parameters can be tempo-
rary overwritten in the Driver Editor itself.
The Driver Knowledge can be selected, similar to the driver template, in the General
Parameters view of the ego vehicle parameters using the Driver Knowledge Brows-
er.
• Updated selection method of active CAN channels: Support for channels on dif-
ferent modules and interface types in the same RBS
The new CAN module display, shown in figure 4.46, allows to select CAN interfaces no
matter what hardware or software interface is used.
The first displayed interface is always the interface selected in the IO Configurator and
it can be updated by pressing the reload button.
In Gateway mode, up to three additional CAN interfaces can be selected.
All interfaces shown in the display will be assumed to be active and will be exported
into the generated RBSParameters. Please find further information in the User’s Guide
for Real-time Applications, section ’CAN’.
XCP
• New ECU Sync option to compare the ECU configuration with the ECU settings
The XCP Setup dialog is now able to synchronize the configuration of an ECU with the
ECU to check for errors. Use the ECU Sync button to trigger the synchronization.
Please find more information in the User’s Guide for Real-time Applications, section 5.2
’Structure of the XCP Setup Dialog’.
Hardware
• Update to busybox version 1.26.1
The busybox was updated to version 1.26.1
- The following new commands are available: /bin/tree, /sbin/seedrng
- The find command provides the following new options: -atime, -ctime, -amin, -cmin, -
samefile
- The command sendmail is no longer supported.
• Update mioutil 4.1
IPG’s mioutil was updated to version 4.14. With it, the memory pool size is now unsre-
stricted.
• Update EtherCAT-Module
EtherCAT module was updated. The default Xenomai memory pool size of 256M is now
used.
• Additional Kernel modules macvlan.ko, macvtap.ko, macsec.ko
The kernel modules macvlan.ko, macvtap.ko and macsec.ko have been added. macv-
lan.ko allows to create virtual interfaces that map packets to or from specific MAC
addresses to a particular interface. The optional module macvtap.ko adds specialized
tap character device driver. The module macsec.ko is currently not used.
EtherCAT
• Reworked EtherCAT State Machine
The behavior of the EtherCAT State Machine has changed. The following changes
have been made:
- State changes can now only be executed after the necessary intermediate states
have been passed through. These transitions will be done automatically.
- Master and Slave state changes are monitored now. If they were unsuccessful a cor-
responding timeout warning will be triggered. The Info File key KPA.<nC>.TimeOut
has been added in KPAParameters to modify this timeout value.
- The slave is now able to change its state without the master doing so.
- The Slave state can no longer be greater than the master state.
- The Slave state follows the master state, triggered by a request.
- The slave can no longer pass any values to its outputs if the current state is not
Operating. To support the old functionality, the Info File key KPA.<nC>.EnableNon-
OPOut was added to KPAParameters, which disables this mechanism.
- The master cannot be switched to the Init state, since otherwise a reconfiguration
and a restart of the simulation program would be necessary. If nevertheless an
attempt is made to switch the master to this state, a corresponding message is dis-
played and the master is switched to the pre-operational state.
Please find more information in the Programmer’s Guide, section 21.3.2 ’Master Con-
figuration’.
• New ProductCode in ESI_File for EtherCAT slave card (F752)
The ESI_File now provides a ProductCode of the EtherCAT slave card (F752) defined
by CarMaker. With the key CIFX.<nC>.SubProductCode a SubID can be defined in
the CIFXParameters file which can be accessed via the function
ECAT_SetSlaveProdCode (). Please find more information in the Programmer’s Guide,
section 21.2 ’Xpack4 as EtherCAT Slave’.
IO Configurator
The IO Configurator’s module support was extended
• The M77 UART module is now available in the IO Configurator. The parameters for the
module and the messages can now be configured in the user interface. Please find
more information in the User’s Guide for Real-time Applications, section ’UART - M77’.
• For the M416 DSI3 four slave and one master channel can be parameterized. Up to 15
sensors can be used per channel and the following modes are supported:
- Command Response Mode (CRM)
- Periodic Data Collection Mode (PDCM)
- Background Diagnostic Mode (BDM)
- Power Function Class Command Response Mode
- Discovery Mode Physical Address Assignment
Please find more information in the User’s Guide for Real-time Applications, section
’DSI3 Interface- M416’.
• The new M417 and M417-01 modules can be chosen in the IO Configurator. The
parameters are the same as for M62N. Please find more information in the User’s
Guide for Real-time Applications, section ’Analog Output - M417/M417-01’.
IPG Tools
- Effect Parameters
With the standard parameterization, oscillations can occur under certain circum-
stances. To avoid these, the parameters for Cockpit Package pro have been extend-
ed. There are now predefined basic parameter sets available: Default, Medium and
Soft. For a more specific setting, the parameters can also be changed individually.
- Position Control
The integrated position controller of the SENSO-Wheel can now be used for ADAS
and autonomous drive capability.
Please find further information in the User’s Guide, section 15.2.5 ’Parameters for
Cockpit Package Pro’.
• SensoWheel CAN Interface Integration
The SensoWheel can now be used via the CAN Interface and as such it can be config-
ured via the IO Configurator.
OpenSCENARIO Converter
• Integration of the OpenSCENARIO Converter in the CarMaker GUI
The OpenSCENARIO Import dialog is available in the CarMaker main GUI under File >
Import OpenSCENARIO file or by pressing Ctrl+i. This dialog is used to convert a
OpenSCENARIO file (.xosc) into corresponding CarMaker files and load them into Car-
Maker.
The file to be converted must be located in the project directory under Data > Open-
SCENARIO. The OpenSCENARIO file can either be selected by clicking the file brows-
er button or by entering the relativ file path between the project directory and the
OpenSCENARIO file location directly.A name for the resulting file is automatically gen-
erated based on the original file name. It is possible to change the name manually.
As long as no ego vehicle is selected, further conversion settings are disabled and the
import process cannot be started.
During the import process, the conversion of the OpenSCENARIO file generates sever-
al CarMaker files. These are Test Run, Vehicle, Road and Traffic object Info Files. The
name of the Test Run file is also used for naming all other files created during the con-
version. For example, the prefix ’_road’ is added to the specified Test Run name for
road files. After the conversion from OpenSCENARIO to CarMaker the generated Test
Run is loaded into the CarMaker GUI.
Please note: When the Test Run is loaded into CarMaker the dialog may be come unin-
teractable.
- Default settings
The OpenSCENARIO Import dialog tries to match already existing Info Files with the
entities from the OpenSCENARIO file. This provides a better representation and
increases the simulation quality when using sensors. This is achieved by either map-
ping the entities from the OpenSCENARIO to the corresponding CarMaker ego
vehicle and traffic Info File (corresponding command line option: --mapentitiy) or, if
that isn’t applicable, by looking for traffic template objects that match the traffic enti-
ties of the OpenSCENARIO file (corresponding command line option: --trfmobj).
- Ego vehicle
This drop-down is used to select an entity from the OpenSCENARIO file to use it as
the ego vehicle for the Test Run. In the drop-down list you can choose between a
pre-selection of entities, ’no entity’ to convert all entities as traffic, or ’browse all...’.
The latter enables the selection of an ego vehicle from all entities within the Open-
SCENARIO file.
- Validate OSC file
This pre-selected checkbox enables the validation of the OpenSCENARIO file. We
strongly recommend to use the file validation.
- Keep simulation running after last maneuver
Activating this option adds a maneuver step for the ego vehicle to keep the simula-
tion running for the selected time. Note: If a global stop trigger is defined, this option
will be overwritten.
- Set ‘action at end’ for all traffic objects
Activating this option allows to set the end mode action at end for all traffic objects to
either Freeze Velocity, Freeze Position or Hide.
Please find a full description of the OpenSCENARIO Converter in the User’s Guide,
section ’OpenSCENARIO Converter’.
Please note that the usage of the OpenSCENARIO Converter requires a license exten-
sion!
• Support for ASAM OpenSCENARIO v1.1 and v1.2
Support for ASAM OpenSCENARIO v1.1 and v1.2 was added.
The validation process incorporates the appropriate OpenSCENARIO version, either
defined by using the "--oscversion" flag or extracted from the OpenSCENARIO file.
Catalog files are parsed and validated using the version specified in the main Open-
SCENARIO file.
Version 1.2 of the API is used for the conversion.
• Extended validation incl. new command line arguments
New command line arguments are available for the OpenSCENARIO Converter:
- --oscversion: Optional. Sets the version of OpenSCENARIO file used for validation.
Possible values are '100','110' or '120'. If the version is not defined, the OpenSCE-
NARIO Converter takes the version from the file. The latter is always the case when
using the OpenSCENARIO Import dialog.
- --validatedeprecated: Optional. Activates the warning of deprecated features in the
OpenSCENARIO file for the validation. Use this command together with "--validate".
• Support for referenced files
Referenced catalog files are now also included in the validation.
• New position types for initialization phase by importing OpenSCENARIO file
New support of the RelativeLanePosition and RelativeRoadPosition, which could be
defined in the OpenSCENARIO initialization phase with TeleportAction.
Third-party tools
MATLAB
• Support for MATLAB 9.14 R2023a
The support for MATLAB 9.14 R2023a was added.
For more information on using CarMaker with MATLAB, see Programmer’s Guide sec-
tion ’CarMaker for Simulink’.
Further information can be found in the Programmer’s Guide, section 9.1 ’Integrating
an FMU’.
ADTF
• Synchronization of ADTF run level
CarMaker can now synchronize the ADTF runlevel to its current simulation status.
Documentation
• New User’s Guide for RealtimeMaker
A new User’s Guide for RealtimeMaker is available. It can be accessed via the Help
menu in the RealtimeMaker main GUI.
• The download and extraction process for HD Scenarios have been improved.
• Bugfix: The proxy dialog when downloading HD Scenarios has been improved.
• Bugfix: To avoid possible errors, interaction with CarMaker is now disabled while a HD
Scenario is downloaded.
• Bugfix: A second CarMaker GUI could take over the role of the main GUI (for the simu-
lation program) although the first GUI was still running and connected. This could lead
to negative behavior, e.g. if a second GUI was connected and disconnected from the
simulation program in CarMaker Office, the simulation program could terminate imme-
diately.
• Bugfix: The GUI required more time to load certain Test Runs in CarMaker version 12
than in previous versions.
• Bugfix: The project update for SLX files was updated due to changes in MATLAB
2020a.
• Bugfix: During the automatic project update, Real-time Expression commands Man-
Jump that do not match the official syntax were not converted correctly to the new
StepJump command.
• Bugfix: The file browser that is used to select the desired CarMaker executable now
opens in the current project directory.
• Bugfix: In the CarMaker HIL’s Application Configuration dialog, the unnecessary menu
entry System Info was removed.
• Bugfix: The behavior of the Unsaved changes dialog when closing the CarMaker GUI
was not correct.
• Bugfix: Choosing Browse in the DVA dialog with quantity names containing square
brackets caused a Tcl error.
• Bugfix: File browser annotations (New, Pro, ...) were not displayed when changing to a
parent directory.
Simulation Framework
• Bugfix: A sequence of data dictionary changes that finally neutralized each other could
cancel the User Accessible Quantity delivery for connected APO clients with CarMaker
HIL for Xpack4. Only the next (real) dictionary change (or a reconnect) could end the
clients’ state.
Real-time Expressions
• The relative lane and road position calculations for the distance and time measurement
Real-time Expressions have been improved. A target position on a different link than
the one the reference entity is on is now calculated, if it corresponds to the routing of
the reference entity.
• The calculation of a relative lane position for the distance and time measurement Real-
time Expressions was changed and now considers the reference object’s orientation
instead of its path’s orientation. Furthermore, the lane offset is determined in direction
of the target lane instead of the direction of the reference object’s path. To restore the
old behavior the optional InfoFile Key RTExpr.RelativeLanePos.UseRefEntityPathDir
can be used.
Please find further information on distance and time measurement Real-time Expres-
sions in the User’s Guide, section B.2.3 ’Distance and Time Measurements’.
• Bugfix: In the User’s Guide, the return values of the Real-time Expressions CheckColli-
sion and ReachPosition were clarified to be Boolean expressions in double floating-
point format.
Licensing
• The handling of license dongles was optimized in terms of faster dongle scanning and
code size reduction.
Test Manager
• When selecting a Settings item in Test Manager’s Test Series tree the corresponding
line within the parameters table is now brought into view.
• Bugfix: The Test Manager’s parallel execution mode did not work when the setting Use
Matlab/Simulink was enabled.
• Bugfix: Creating the maneuver list for the Test Manager’s report sometimes led to a
segmentation fault if the list was too long.
• Bugfix: The values Dist and Time in the TestRunFinished Info File for Test Series run in
parallel execution mode were only saved with two or three decimal spaces.
• Bugfix: Test Configuration items that have been added to an existing Test Series via
CarMaker’s Test Manager were not always appended at the correct position.
Script Control
• Bugfix: The Script Control command QuantSubscribe is now more robust against tim-
ing issues induced by the underlying APO connection.
4.3.3 Visualization
• Bugfix: Starting IPGMovie or Movie NX during a paused simulation did not work cor-
rectly.
Movie NX
• The new Movie NX start option -apodatafrequency allows to specify the frequency of
simulation data updates. Increasing the frequency might be necessary for monitors
with a refresh rate above 100Hz. However, this will decrease the available replay time
span. Please find further information in the Movie NX User Manual, section 3.3.1 ’Com-
mand Line Options’.
• The Unigine package was updated to version 2.17.0.1. The default rendering backends
are now DirectX 12 (Windows) and Vulkan (Linux). OpenGL and DirectX 11 (Windows
only) is still available using the -renderapi option when starting Movie NX, see section
3.3.1 ’Command Line Options’ in the Movie NX manual.
Please note: The experimental render backends Vulkan and DirectX 12 cause perfor-
mance degradation when having high frame rates and/or long simulation durations.
• Bugfix: Relative paths are now allowed for all the distortion files.
• Bugfix: Fisheye renderings could have leaked pixels onto each other for specific config-
urations.
• Bugfix: Under specific circumstances, Movie NX could get stuck when loading a tempo-
rary Test Run (changed Test Run which was not saved).
• Bugfix: The User Guide now explicitly indicates the valid ranges for the environment
parameters sun elevation and rain rate. For the visualization in Movie NX, the rain rate
is now also clamped between 0 and 25 mm/h (= very heavy rain). This helps to avoid
low performance and other issues with particle systems while still providing enough
realism.
• Bugfix: When using CarMaker HIL for PXI (National Instruments), the path conversion
failed. The path conversion from the NI-LRT format to a Windows-usable format tried to
convert Xeno paths. Use the option -projectdir according to section 3.3 ’Command
Line’ in the Movie NX User Manual.
• The bundled Python version was updated to 3.11.5.
• Bugfix: Movie NX crashed when accessing Traffic lights with non-defined controllers
through the Movie NX Python API.
• Bugfix: Fixed Movie NX Python API View.set_grid_layout not applying the spacing.
Please find a complete list of all Movie NX Python API changes in the Movie NX Python
API User’s Guide > Migration Guide available under Additional documents in the main
GUI’s Help menu.
IPGMovie
• The command line option -exitAtSimEnd was renamed to -exitatsimend to make it con-
sistent to Movie NX. For now, both notations are supported. However, the camel case
version will be removed with CarMaker 13.1.
• Bugfix: In IPGMovie, some objects were displayed with incomplete shadows.
• Bugfix: Traffic objects with file type .manim were only displayed as a bounding box.
• Bugfix: Adjusting the size of any picture-in-picture view may have led to a crash.
• Bugfix: A Tcl error "key "BBox" not known in dictionary" occurred when at least two dif-
ferent traffic objects had no file name.
• Bugfix: A tcl error could occur under specific circumstances when exporting a video
that contains visualized sensor data from at least 2 GPU sensor instances.
• Bugfix: If Google Earth was opened, IPGMovie could crash.
• Bugfix: A Tcl error occurred when selecting File > Connect to Google Earth if no project
directory was given.
• Bugfix: If the two Script Control commands to delete an IPGMovie window and to cre-
ate an IPGMovie window were sent to IPGMovie immediately one after the other, IPG-
Movie could freeze.
• Bugfix: The example code that shows how to write a CSV file for the rectilinear lens
radial distortion was obsolete and removed.
3D assets
• Animated pedals have been added to cyclist characters.
• Bugfix: Animated "_RightFoot" characters have been added for Movie NX.
• Bugfix: The animations of Pedestrian_Female_Casual_01 have been adjusted to be
more consistent with the animations of other characters.
• Bugfix: All cyclist animations have been updated to have more realistic playback speed.
• Bugfix: The seating positions of all animated cyclists have been updated.
• Bugfix: Foodbiker_Male_01 and Foodbiker_Male_02 had the wrong material and were
displayed improperly in Movie NX.
• Bugfix: The materials parameters for some vehicles were updated.
• Bugfix: The vehicle 3D asset Audi S3 2015 was changed to fix the visual indicator func-
tionality.
• Bugfix: The geometry object ScooterRider_Female_Child_01 and its traffic object tem-
plate were renamed to ScooterRider_Female_Child_01_RightFoot.
4.3.4 Vehicle
• Bugfix: If an encrypted vehicle file was opened, wrong tires were displayed in the main
GUI.
• Bugfix: If the vehicle was not reloaded for every Test Run (default for CarMaker HIL or
Vehicle.Reload = Auto for other than CarMaker HIL applications), any error (e.g. a
missing license) during the vehicle initialization led to undefined behavior in the subse-
quent Test Run. This happened only if the subsequent Test Run was started without
modifications in any of the Info Files that were used for the Test Run.
Car
Powertrain
• Bugfix: The P3 PTControl model did not reset the PTControl battery target values cor-
rectly.
• Bugfix: In certain cases, the PTControl model for the P2 hybrid powertrain could start
controlling the decoupling clutch for the engine.
• Bugfix: The quantities for the ClutchM models were missing in the PTControl submod-
ule.
• Bugfix: The electric powertrain did not consider regeneration drag correctly. It would
always provide a drag torque, if the gas interpreter torque target was negative even
when regeneration drag was deactivated.
• Bugfix: The simulation program crashed when using the DCT gearbox model and the
key PowerTrain.Gearbox.*.TrqLossMode was not provided in the vehicle Info File.
• Bugfix: The unused powertrain Info File keys PowerTrain.TCU.Clutch.Grad_open and
PowerTrain.TCU.Clutch.Pos_shift were removed.
Suspensions
• Bugfix: The control signal CtrlIn for suspension force elements was initialized with 0
instead of NOTSET=-99999 if the suspension control unit was not active.
• Bugfix: For Carrier<L,R<.<cTz,kTz> of the TwistBeam and TwistBeamExtended axles,
the third entry of a vector was used instead of a scalar value.
• Bugfix: The deprecated compliance models DisplaceLinFr1 and DisplaceLinFr2 are no
longer supported as announced.
• Bugfix: The Multi-body suspension (MBS) axle McPherson with ForceCoupling did not
consider bushing forces from steer rod to steer rack for ForceCoupling. To restore the
behavior from CarMaker 12 use CompatMode_CM12 = 1 in the MBS Info File or Addi-
tional Parameters.
Truck
Assembly
• Bugfix: In a TruckMaker vehicle, the masses of Body Cab and Platform were not con-
sidered in the Model Check and simulation if Rigid Mounting was chosen.
Suspensions
• Bugfix: The bogie axle was not activated properly. If activated for the second rear axle
(AxleR2.Bogie.Active) several problems occurred:
- The activation was ignored for vehicles with 4 axles or less.
- A bogie axle was activated at the third rear axle (R3) for trucks with 5 axles
- A bogie axle was activated at the third rear axle (R3) for trucks with 6 axles and
caused a misleading warning for axle R4.
Further, AxleR3.Bogie.Active and AxleR4.Bogie.Active were completely ignored.
Motorcycle
Suspensions
• Bugfix: The Damper top mount option in the MotorcycleMaker GUI never had any effect
and has been removed.
Tires
• Bugfix: In some cases the static equilibrium position found with MF-Swift tires showed
deviations between the sum of all vertical tire forces and the total vehicle mass.
• Bugfix: Temperature outputs of MF Swift Tire were not documented in the Reference
Manual’s User Accessible Quantity list.
• Bugfix: Fr2 was erroneously described as equal to the TYDEX C axis system in section
’Tire’ of the Reference Manual.
4.3.5 Sensors
Object Sensor
• The maximum rotation angle around the x-axis (roll angle) in the object sensor parame-
terization was extended up to +/- 90 deg.
Camera Sensor
• Bugfix: The Camera Sensor did not detect traffic lights of type Red (large).
• Bugfix: Ground Truth Sensors and Camera Sensors could affect each other uninten-
tionally.
Radar Sensor
• Bugfix: The RCS Maps dialog could not be closed using the Close button when started
from the Vehicle Data Set Editor Sensors tab.
GPU-based Sensors
• Bugfix: When running CarMaker in batch mode with a start-up file and a Test Run
involving GPU sensors, the combination of certain command line options and a start-up
file not containing information about GPU sensors could sometimes cause the Test
Run to fail with the error message "Not enough free GPUSensors available".
• Bugfix: In rare cases, involving a vehicle with many IPGMovie/Movie NX GPU sensors,
the GUI gets stuck in GPUSensor Init after the simulation start.
• Bugfix: It was not possible to trigger a GPU sensor calculation in the first simulation
cycle.
• Bugfix: Fixed an issue where Movie NX used as a GPU Sensor sends the hostname
instead of the IP address, resulting in APO disconnects. This could cause an immedi-
ate time-out error on the second start of the same Test Run and occurred primarily on
HIL systems.
• Bugfix: Fixed a periodic unresponsiveness of the GPU Configuration dialog, when unre-
solvable host names were present.
• Bugfix: When closing GPU Sensors or IPGMovie, they could close with an error in
some cases.
RSIs in general
• The minimum required CUDA version for Lidar RSI, Radar RSI, Ultrasonic RSI has
been increased from 11.2 to 11.7, see section 1.2 ’System Requirements’ in this docu-
ment.
• Bugfix: The new Expert Parameter RSDS.MaxSendDataTries was added to control the
number of times Movie NX and IPGMovie try to send every RSDS data packet. This
stabilizes remotely running RSDS clients. Please refer to section ’Avoiding Network
Congestion’ in the Reference Manual for details.
• The error handling and error reporting was improved for Movie NX based RSIs.
• Bugfix: In rare cases, Movie NX crashed when being improperly started as a GPU Sen-
sor instance from the command line.
• Bugfix: Using Cycle Control or Cycle Offset could cause Movie NX to send a mistimed
result message back to the simulation, triggering prematurely the Movie NX based
RSIs.
• Bugfix: The sensor preview in Movie NX showed object animations even though anima-
tions are not supported by Lidar RSI, Radar RSI and Ultrasonic RSI with a Movie NX
based GPU sensor.
• Bugfix: The occlusion calculation was sensitive to floating point imprecision.
• The documentation of the parameter Range used by Lidar RSI, Radar RSI, and Ultra-
sonic RSI has been improved.
Radar RSI
• Bugfix: Noise did not match the expected random distribution.
• Bugfix: The polarization of reflected rays was not always computed correctly.
• Bugfix: The Radar RSI could not handle interaction points with exactly perpendicular
incidence.
• Bugfix: Using Named Values in field of view entries broke the calculation of ray num-
bers.
• Bugfix: Activating File output in the sensor assembly could lead to an initialization error.
• Bugfix: A small memory leak occurred if the Radar RSI was simulated.
Lidar RSI
• Bugfix: Geometries tagged as transmissive could only be penetrated up to a depth of
0.5 mm by Lidar RSI rays.
• Bugfix: The absorptance for transmissive materials was corrected in default Material-
Lib.
• Bugfix: Lidar RSI rays used wrong field of view constraints.
• The documentation of the Lidar RSI was improved, explaining the limitations of the
reception area parameter and pointing out appropriate parameterization. See section
21.21.2 ’Intensity Calculation’ in the Reference Manual for details.
Camera RSI
Static scenario
• The undo/redo functions in the Scenario Editor were improved.
For every step, the relevant object is selected, the corresponding Parameter tab is dis-
played and the associated tool is selected.
The old behavior can be restored in the User preferences with the option Preserve
active object (Scenario Editor > General).
• In the Route editing tool, a pop-up shows information on the selected route. This pop-
up has been extended and shows now also the route’s height at the cursor position.
• The import feature in the Scenario Editor was harmonized. When importing road net-
works from OpenDRIVE files or from HERE HD Live Map, the existing road network is
not replaced anymore. The imported road network is added to the existing road net-
work. If the scenario had been empty before the import, the scenario is replaced by the
imported scenario. This means, that the localized settings of the imported scenario are
used instead of the previously defined localized settings.
• Bugfix: The calculation of the z-values and the normal vector of the transition area of
the extended and virtual junction was incorrect. This could lead to small jumps at the
transition area and junction area.
• Bugfix: The evaluation functions returned a wrong z-value for raised profiles that were
defined at the boundary of an extended junction. Because of this, sign plates were not
placed at the correct height, for example.
• Bugfix: In the Scenario Editor, the height of the existing global reference lines was not
considered when adding a new link, junction or global reference line.
• Bugfix: When splitting a link, the additional parameters of the link’s material definition,
the link’s visualization parameters, and the Named Values of the link’s parameters were
not copied correctly.
• Bugfix: Some of the messages concerning splitting and connecting a route have been
improved.
• Bugfix: If a lane section was added in the Scenario Editor, the material of the lanes,
road markings and traffic barriers of the previous lane section was not copied to the
corresponding objects of the new lane section.
• Bugfix: If a junction arm was deleted, some of the junction reference lines that refer-
enced the no longer connected link were not deleted.
• Bugfix: The preview image of the currently selected lane configuration was imprecise
and had some drawbacks.
• Bugfix: The material preview for an object was only updated if the material definition
was explicitly changed by the user.
• Bugfix: Solved an issue where the automatic route generation created a route that
crosses a lane of type Traffic island.
• Bugfix: In some cases, the automatic route generation produced an unnecessary lane
change.
• Bugfix: In some cases, the automatic route generation deleted existing connector
paths. Additionally, connector paths affected the route generation.
• Bugfix: If the chosen start path started very close to the end of the first link, the auto-
matic route generation did not prevent lane changes within the first route section.
• Bugfix: The automatic route generation tool failed in cases where the new route should
lead over a virtual junction.
• Bugfix: The automatic route generation tool failed in cases where the new route should
lead over a link with virtual junctions and then over a junction at the end of the link.
• Bugfix: The automatic route generation behaved differently on the first chosen link
depending on if it was followed by a direct or a non-direct junction and if the chosen
start path belonged to the lane section immediately before the junction or not.
• Bugfix: If a scenario was adapted in a way that affected its routes, for example by delet-
ing a direct junction, these routes were not always adjusted correctly. In particular, a
route was not adjusted if an object group was used to move or rotate a part of the sce-
nario with only a part of the route.
• Bugfix: In some cases, valid connector paths were rejected when read. This could
result in shortened routes.
• Bugfix: The errors and warnings during the route generation have been revised.
• Bugfix: When a road definition was read from an Info File created with older versions
than CarMaker 10.0, the first link connected to a junction was displaced in some cases.
• Bugfix: In some cases, when deleting all points of a lane (via context menu > Delete all
lane width points) or of an elevation, slope, or camber profile (via Parameters tab >
Delete object button), some entries remained in the Parameters tab’s point list.
• Bugfix: The z values of certain junction reference lines could be adapted, although they
are not written into the Info File, since such reference lines have no own height informa-
tion.
• Bugfix: When a point was added to a height profile, the details of the previously select-
ed point were shown in the Parameters tab instead of the information about the new
point.
• Bugfix: If a Named Value was used for a raised profile configuration’s curb or gutter
type, hovering the corresponding widget in the Parameters tab led to an error message.
• Bugfix: If no raised profile of type point list had been active before, creating a raised
profile of type spline with only two points led to an error message. Otherwise, the raised
profile of type point list created since at least three points are needed for a spline used
the configuration of the last active raised profile of type point list instead of the chosen
configuration.
• Bugfix: Raised profile files of type spline or point list that are defined on overlapping
links were not taken into account in the evaluation on all links in the overlap area.
• Bugfix: The snapping of traffic barriers on global reference lines did not work.
• Bugfix: With road markings and traffic barriers with point lists (spline or polylines), it
was not possible to place points on the end of a link.
• Bugfix: Road markings and traffic barriers of type Line can now be drawn on a link with
offset and lane sections.
• Bugfix: Road Markings that were defined on lane borders did not always follow them
correctly.
• Bugfix: In some cases it could happen that not all road markings were linked correctly.
• Bugfix: Some objects (e.g. road markings) were not displayed if they run along the
intersection boundary. To avoid this, the intersection areas of virtual junctions and
extended junctions were virtually widened by approximately 1 m.
• Bugfix: Markers of type Driver speed, Wind or User-defined defining the end of the
validity zone of another marker were ignored if they were defined exactly at the start of
a path.
• Bugfix: An invalid range given for an OpenCRG could lead to a crash.
• Bugfix: When an OpenCRG surface was added to a link, the Detailed visualization flag
was not removed correctly.
• Bugfix: When converting road files from IPGRoad versions earlier than 12.0 to
IPGRoad 12.0 files, Detailed visualization was used for all OpenCRG surfaces created
from CRG bumps with Use mesh option.
• Bugfix: Some minor bugs in the OpenCRG description in the IPGRoad Info File
Description were fixed.
• Bugfix: When an OpenCRG surface on a link was deleted, the link’s surface was not
redrawn in the Scenario Editor’s top view.
• Bugfix: In the Scenario Editor, adding a note to an imported object group was not pre-
vented.
• Bugfix: When a road definition was imported, the new names of renamed traffic light
controllers were missing in the corresponding messages.
• Bugfix: If a road definition was imported, the currently chosen parameters for the terrain
generation were overwritten by the corresponding User preferences.
• Bugfix: When a scenario was imported, the Object List was not completed right away.
• Bugfix: The number of objects written to a road file was increased by a temporary
object group used for the import of a scenario.
• Bugfix: A memory leak occurred when using a traffic light in a Test Run.
• Bugfix: When a road definition was read, certain errors concerning the definition of a
lane led to a crash of the GUI.
• Bugfix: When exporting a selection of a road definition, the final depiction of it only
included routes starting on one of the selected links or junctions. Routes running
through or ending in the selected area were not highlighted.
• Bugfix: The export of a selection of a scenario resulted in a discard dialog when loading
a new scenario, even if the scenario was not changed. Moreover, the import of a sce-
nario in combination with the history module did not result in a discard dialog in some
cases.
• Bugfix: When exporting a selection to a road file or Test Run, the GUI crashed if a direct
junction but not all of its connected links were selected.
• Bugfix: If Undo/Redo was used, the information about the objects controlled by a traffic
light controller was removed from the controller’s Parameters tab in some cases. If the
scenario was exported in this invalid state, the information was also missing in the
exported file. Using this invalid file caused unexpected behavior including an error of
IPGMovie.
• Bugfix: If Undo/Redo was used, the description of a scenario was removed.
• Successors and predecessors for parametric cubic curves of type
RPCCT_RoadMarking and RPCCT_TrafficBarrier were not set.
• Bugfix: If a background image with anchor mode Explicit and an image anchor point
with x or y coordinate greater than 50 was defined in a scenario, simulating was not
possible.
• Bugfix: When Ctrl was pressed during an action, a mouse click within the top view
aborted the action and caused unexpected behavior.
• Bugfix: When using the multiple selection mode of a tool, already selected objects with
inappropriate types were not discarded. In the road segment and the global reference
line tool, replacing the already selected objects with the appropriate type by their root
objects did not work properly in all cases.
• Bugfix: In the Scenario Editor, the material parameters and some of the other parame-
ters chosen within a session were not discarded at the end of the session.
• Bugfix: When the User preferences dialog was opened, the current action was aborted,
but the currently active object kept active. This led to inconsistent behavior after the
User preferences dialog was closed.
• Bugfix: The junction mode specified in the Scenario Editor’s user preferences was not
always considered correctly. For virtual junctions, the mode Add all junction links had
no effect and the corresponding context menu functionality was missing. Moreover, the
existing junction links of a simple or extended junction were replaced if a junction arm
was added to the junction.
• Bugfix: Using Undo in the Scenario Editor added already known messages to the mes-
sages log.
• Bugfix: The Automatic mesh generation checkbox for extended junctions has not been
tracked in the history and therefore had no undo / redo functionality.
• Bugfix: Visual improvements were made in the terrain’s Parameters tab.
• Bugfix: If the generation of the visualization geometry for an RD5 file that references a
zipped terrain file was called several times in a short time, the generation could fail.
This could occur, e.g. when using multiple RSIs or GPU instances.
• Bugfix: The material ID information needed for IPGMovie (GPU sensor and visualiza-
tion) was missing in generated terrain files.
• Bugfix: When a selected part of a scenario was exported, the parameters of the terrain
were not considered.
• Bugfix: The highlighting of a global reference line’s complete elevation profile in the
Scenario Editor’s 2D top view did not work.
• Bugfix: If a new segment of type File was added to an existing link, the segment was
not highlighted as active in the Scenario Editor’s 2D top view.
• Bugfix: With respect to the Scenario Editor view settings, invalid tree stripes were con-
sidered as Road decorations.
• Bugfix: In the Scenario Editor’s Road segment tool, the mouse cursor of the junction
link mode didn’t behave correctly.
• Bugfix: In some cases, scrollable frames were adjusted iteratively to the available
space.
• Bugfix: The visibility of objects was generally improved in the Scenario Editor.
• Bugfix: Several error messages were improved.
• Bugfix: When a road definition was exported to OpenDRIVE, the absolute height was
used for the road’s shape information instead of the height above the reference plane.
• Bugfix: When a road definition was exported to OpenDRIVE 1.5 or 1.6, roads in the
environment of direct junctions were twisted: The road’s shape information did not
match the original road definition.
• Bugfix: If a road definition was exported to OpenDRIVE, the message concerning a not
fully compatible OpenCRG surface was missing in some cases.
IPGRoad API
• Bugfix: For RD5 files created with CarMaker version 10.0 or 10.0.1, the sign of the gra-
dient parameters and the transverse slope needs to be changed for some direct junc-
tions.
If you created RD5 files with CarMaker version 10.0 or 10.0.1 and edited them with
CarMaker version 10.1 to 12.0.1, an automatic correction is not possible. Please check
your files for false gradient parameters and transverse slopes and correct them manu-
ally!
• To simplify the behavior of RoadDeleteLink(), a two-armed junction connecting start
and end of the link is no longer likewise deleted.
• Bugfix: When converting coordinates from the global frame Fr0 in GCS and back from
GCS to Fr0 coordinates using the built-in functions (GCS_ConvGCStoFr0,
GCS_ConvFr0toGCS from GCS.h), there was a small deviation for the GCS Lat and
Long position before and after the conversion within one simulation step. This bug was
fixed for the projection methods FlatEarth and PROJ.
• The function GCS_Init is no longer available, because the GCS initialization is done
once within the road and cannot be changed during the simulation properly.
• Bugfix: RoadIsEmpty() did not consider background images and traffic light controllers.
In the Scenario Editor, this caused inappropriate behavior with scenarios where only
traffic light controllers are defined.
• Bugfix: The first call to the IPGRoad API function RoadRouteEvalExt() with xyz as input
returned no lane information if the xyz point is on a junction.
• Bugfix: The description of the parameter t of the function RoadLaneGetRelLatPosOfXY()
has been corrected.
Please find a complete list of all IPGRoad API changes in the IPGRoad Reference >
Changes available under Additional Documents in the main GUI’s Help menu.
Maneuver in general
• In the ego vehicle and traffic maneuver step dialog, the label Duration has been
renamed to Limit.
• The internal autonomous completion of paths along the route or a path list in combina-
tion with junctions has been revised to make the functionality more flexible and more
application-specific.
• Bugfix: A lane change to an incorrect lane was performed, if a lane change target value
was specified as an absolute lane, OnlyDrvLane was activated and at least one non-
driving lane was between the current lane and the specified target lane.
• Bugfix: If an update of a traffic object’s path list or the ego vehicle’s path list failed, the
simulation stopped without an error message.
An error message is now sent if an update of the path list of the ego vehicle fails. If an
update of a traffic object’s path list fails, the affected traffic object is deactivated instead
of stopping the simulation.
• Bugfix: The multi-selection menu was missing in Start position when using the object
select button.
• Bugfix: The use of Named Values in the drop-downs Motion and Superimposed in the
Maneuver steps was not possible.
IPGDriver
• Bugfix: The IPGDriver’s behavior when using the handbrake for driveaway in vehicles
with automatic transmission has been improved: If the selector control has to be moved
to position Drive, the handbrake was released too early, which could lead to rolling
backwards on slopes.
• Bugfix: In some cases, a problem could occur when creating the IPGDriver’s Static
Desired Course in combination with lap driving.
• Bugfix: In some cases, IPGDriver could not drive forwards again after driving back-
wards.
• Bugfix: The quantity DM.StopTime which describes the remaining time standing at a
stop sign could take values lower -1.0 s. This describes the state if no stop sign is
ahead and should be the minimum value of the quantity. This bugfix has no influence
on the simulation behavior.
Traffic
• Bugfix: The validation of traffic object names in the GUI did not work anymore. It was
possible to choose too long names or use special characters or blanks that are not sup-
ported by the simulation, IPGMovie, or IPGControl and also lead to invalid traffic object
quantities.
If a Test Run with a too long traffic object name is loaded, it will now be renamed auto-
matically in T<nn>. This change also affects User Accessible Quantities for a renamed
traffic object!
• Bugfix: When using Traffic Swarm (formerly Traffic Source Sink) the initial traffic object
filling procedure on the link around the ego vehicle did not recognize the ego vehicle
properly. If the ego vehicle’s start velocity was relatively low, the traffic objects behind
could sometimes not react to the ego vehicle due to a too high start velocity and too
short gap.
• Bugfix: When using Traffic Swarm (formerly Traffic Source Sink), it led to an error when
reverse driving over a lane section and a junction with the ego vehicle. Now the simula-
tion continues. However, in this case the outer link range around the ego vehicle is not
updated, but only when driving forward over the old position again.
• Bugfix: When using Traffic Swarm, too few traffic objects appeared in the simulation
occasionally due to a too large waiting time of traffic objects in a source.
• Bugfix: In rare cases a segmentation fault occurred when using Traffic Swarm and virtu-
al junctions were part of the road network.
• Bugfix: Defining traffic objects with start positions on a route or path with more than 15
characters as t-coordinate, might have led to a wrong s-coordinate.
• Bugfix: If an autonomously driving traffic object on a route started from standstill, the
simulation program crashed.
• Bugfix: If an autonomous driving traffic object had a desire to overtake in the simulation
cycle before it arrived on the last junction of its routing and the link after the junction
had a length of less than 5m, the simulation crashed.
• Bugfix: At junctions with give way markers without assigned give way or right of way
paths, the deadlock resolution of autonomous driving traffic objects might not have
worked as expected and in very rare cases caused the simulation to crash.
• Bugfix: In rare cases the first traffic object (object 0) was not considered properly during
a sheer-in situation on a merging lane.
• Bugfix: When importing traffic objects from another Test Run, duplicate traffic object
names could occur.
• Bugfix: When trying to start a simulation with a wrong traffic object parametrization and
fixing it after the first try, invalid User Accessible Quantities "Traffic.*" were created.
• Bugfix: When opening the Remove drop-down menu in the traffic objects list, the
selected traffic object was removed immediately.
• Bugfix: Changes in the static scenario that affect the positioning of dynamic objects
have been processed after a small delay. Now, changes trigger an instant update of the
dynamic objects. During drag-and-drop editing in the static scenario, the dynamic
objects are not shown for a better interaction experience.
• Bugfix: The error message for a missing driver template for autonomous traffic objects
was imprecise.
• Bugfix: Traffic vehicles did not recognize the MyCar.c user vehicle example at the
beginning of the Test Run, because Vehicle.Fr1A was not initialized.
• Bugfix: The user accessible C variable of traffic object’s Cfg.Info always contained an
empty string.
• The Info File key Traffic.<Id>.Info was wrongly documented as a string key instead of
a text key.
• Bugfix: The traffic autonomous driving template Car_Generic_Aggressive was not
usable due to a wrong key.
• When adding a new traffic object, a different vehicle is now used as default.
4.3.9 Environment
• Bugfix: The error message for invalid environment models was clarified.
IO Configurator
• Bugfix: The IOParameters file was not written correctly for mode Set relays.
• Bugfix: It was possible to add CAN and FlexRay channels to a group.
• Bugfix: The baud rate of a FlexRay cluster was not correctly determined for AUTOSAR
databases of version 4.0.
• Bugfix: The support for Fibex version 2 was not working properly and led to Tcl errors.
• Bugfix: With a virtual bus selected in the IO Configurator, the node names were partly
not transferred correctly to the Rest Bus Configurator.
• Bugfix: Every Gateway ECU was automatically assigned to channel 0 in the RBS Con-
figurator although another channel was selected in the IO Configurator.
• Bugfix: The separation time was not shown for SOME/IP fields in the Rest Bus Config-
urator.
• Bugfix: A Tcl error could occur while loading an AUTOSAR database containing Sec-
OC.
• Bugfix: If a CANdb was used to create the RBS, the multiple transmitter check during
saving used ECUs that were not included in the RBS.
• Bugfix: Importing code did not enable the Apply button.
• Bugfix: Opening a file that does not contain any C functions in the Import dialog led to a
Tcl error.
• Bugfix: If the build dialog was closed while saving, a Tcl error could occur.
• Bugfix: A Tcl error could occur if an RBS was loaded in which the e2e_p2 flag is used.
• Bugfix: The behavior of the timing editor in the dialog was improved.
• The fibex2flex and fibex2sip utilities were removed with CarMaker 13.0 as the RBS
Configurator fully replaces this functionality.
SecOC
• Bugfix: An invalid SecretKey with a length of zero lead to a segmentation fault.
• Bugfix: The Info File Key PDU.<Name>.AuthenticPDU was read in even without an
active SecOC configuration. This led to various problems and malfunctions, e.g. influ-
encing the transmission behavior.
XCP
• Bugfix: Receiving DTO packages for XCP on Ethernet with small ODT sizes was
slowed down by too many memmove operations. The processing of XCP packages has
been optimized by avoiding memmove.
• Bugfix: If the CANIfParameters Info File was reloaded in the XCP Setup dialog, the dis-
play of the used CAN interface was not reset correctly.
• Bugfix: CAN-FD was not correctly exported if activated manually.
• Bugfix: A2L files containing a characteristic with the keyword "READ_ONLY" were not
correctly parsed.
• Bugfix: The Info File key ECU.<n>.TimestampSource was documented incorrectly. With
CarMaker 12.0, the ECU.<n>.TimestampSource key had been renamed to
ECU.<n>.TimestampSource.Deprecated. In addition, the default value had changed
from ECU to CM.
• Bugfix: In the Programmer’s Guide, an incorrect default value for
ECU.<n>.OverrideASAP2 was documented. The default value is 1 instead of 0.
Diagnostics
• Bugfix: The CAN communication for diagnostic requests or responses was not started
properly.
• Bugfix: When using the diagnostic module, communication via the CAN interface did
not work and led to several warnings during CarMaker initialization.
• Bugfix: Error messages provided by the ECU diagnostics were extended.
Bus systems
• The product example IO_CAN has been revised to allow cycle times smaller than 1ms.
• Bugfix: With the M-Modules M51 or M410, it was possible to send a CAN frame even if
the CAN communication was not started correctly by a previous call of CANIf_Start().
IO Configurator
• M412: The parameter to configure the origin has been renamed from CarMaker to User
settings.
XENO-RT
• The doas command provides more detailed usage output with explanation of options.
• Bugfix: The FlexCard ID was shown even if scanning a single module slot.
RealtimeMaker
• Bugfix: RealtimeMaker tried to connect to two Fail Safe Testers even if one Fail Safe
Tester or both Fail Safe Testers were disabled.
• Bugfix: The header file Periodic.h was incompatible with RealtimeMaker and the
code did not compile.
• Bugfix: Unnecessary data directories have been removed from the RealtimeMaker
project directory structure.
IPG Tools
OpenSCENARIO Converter
• Bugfix: The converter crashed if the StartTrigger was not correctly defined in the
ManeuverCatalog files.
• Bugfix: The orientation of LanePosition was converted incorrectly.
• Bugfix: Wrong log information was shown when the evaluation of the lane position
failed.
• Bugfix: When converting an OpenSCENARIO file and attempting to load the Open-
DRIVE file, no proper error message was logged in case of a license error.
• Bugfix: When a wrong name was given using -egoname, all entities were converted into
traffic objects without a warning message.
• Bugfix: The OpenSCENARIO Converter crashed if a non-existing file without validation
was used.
• Bugfix: When converting OpenSCENARIO files that contain ParameterDistribution, the
OpenSCENARIO Converter crashed without error message.
Sim Net
• Bugfix: If the Traffic Object Template files were not located in the project directory, the
import of the templates failed, and the Sim Net-specific Test Runs could not be saved.
• Bugfix: The UAQ SimNet.SimNet<AppID>.Vhcl.PoI.GCS.Long was incorrectly report-
ing the latitude coordinate of the vehicle instead of the longitudinal coordinate.
Third-party tools
MATLAB
• Bugfix: The generated C code did not compile when multiple instances of the Radar
RSI block with output type set to VRx are used in the same Simulink model.
• Bugfix: When multiple suspension plug-ins were integrated into the same executable
with Simulink Coder, one of two possible errors occurred, depending on the used com-
piler toolchain. On older toolchains, the parameter tuning stopped working. On newer
toolchains, the linker complained about multiple definitions.
• Bugfix: MATLAB callback functions that are specified in the Additional Parameters of
the Vehicle Data Set did not get executed for vehicles that are stored in a shared Data
Pool.
• Bugfix: Invoking cmread with no path or with a directory path fails with an "Invalid argu-
ment" error instead of opening a file browser.
• Bugfix: Due to an issue in MATLAB Simulink, CarMaker for Simulink failed with a
license server time-out on MATLAB Simulink installations newer than R2018 and with
many add-ons. This bug was limited to Linux operating systems.
• Bugfix: External Suspension Forces for 3rd and 4th rear axles were not taken into
account in the simulation with TruckMaker for Simulink.
• Bugfix: Some wires of the fourth trailer axle were not named correctly in the Trailer sub-
system of the TruckMaker4SL library.
• Bugfix: FMUs could not find their resources when they were started with the CarMaker
Python API on Windows hosts.
Documentation
• Bugfix: Some entries in the main GUI’s Help menu were harmonized.
• The IPGDriver User Manual has been revised, especially the sections ’Concepts of
IPGDriver’, ’Parametrization’ and ’Learning Procedure’.
• In the IPG Road API documentation, the information about memory allocation has been
expanded and improved.
• In the Movie NX Python API User’s Guide the difference between Viewport and Cam-
era has been clarified.
• In the Programmer’s Guide, the documentation the Secure Onboard Communication
(SecOC) documentation has been enhanced, see section 18.3.1 ’Secure Onboard
Communication (SecOC)’.
• The User’s Guide for HIL Applications has been renamed into User’s Guide for Real-
time Applications with regard to the new CarMaker Office Extended product line.
• Bugfix: In the Reference Manual, the equation for the automatic gearbox in section
’PTControl OSM Model "Generic"’ was corrected.
• Bugfix: A radar cross section class RCS_Motorcycle was documented for traffic
objects, even though it is not selectable in the traffic object template editor and no fitting
RCS map is available as a product example.
• Bugfix: In the Programmer’s Guide, the SPN format description for J1939 signals was
incomplete. The Offset parameter was missing.
• Bugfix: Corrected the terminology for roll angle according to ISO.
• In the Movie NX Python API User’s Guide the difference between Viewport and Cam-
era has been clarified.
Chapter 5
Upgrading from Version 12.x to 13.0
Please note that an updated project is no longer available for usage with the previous Car-
Maker major release and its bugfix releases!
During the following update process, where possible, unmodified product example files in
the project directory are cleaned. Files in the Data directory are converted automatically to
the CarMaker 13.0 format. The update includes:
- an update of all Info File keys according to DataType IFkey in <IPGHOME>/
carmaker/<arch>-<version>/doc/UserInterfaceChanges.csv
- an update of renamed User Accessible Quantities according to DataType “UAQ” in
<IPGHOME>/carmaker/<arch>-<version>/doc/UserInterfaceChanges.csv
in
- Real-time Expressions used in Maneuver, Traffic, Characteristics in Test Series
- Direct Variable Access commands in the Maneuver definition and in the DVA dia-
log settings
- Output Quantities configurations
- Test Series with diagrams and criteria
- CarMaker for Simulink models with Read/Write CM Dict blocksets
UAQs from older CarMaker versions which were removed get the prefix
“REMOVED_” allowing an easy parsing.
- an update of all Test Runs containing links to renamed product example vehicles or
road definitions according to DataType FileName in <IPGHOME>/carmaker/
<arch>-<version>/doc/UserInterfaceChanges.csv
- an update of references to renamed or restructured 3D geometry objects according
to DataType FileName in <IPGHOME>/carmaker/<arch>-<version>/doc/
UserInterfaceChanges.csv
- changes in 3D geometry object files (*mobj, *manim) according to DataType FileNa-
me in <IPGHOME>/carmaker/<arch>-<version>/doc/
UserInterfaceChanges.csv in the Test Run and *.rd5 files. 3D geometry objects
from older CarMaker versions which were removed in the current CarMaker get the
prefix “REMOVED_” allowing an easy parsing.
- adding of new CarMaker c- and header files in the src folder with backup of the
existing files. A backup of source files to be updated is created (e.g. FILE.c ->
FILE_yyyyddmm.c).
The automatic project update has the target to change the content of CarMaker Info Files
to match with the new major release’s format and, at the same time, to guarantee the same
behavior as when using the unconverted data with the previous major release wherever
possible.
After the update process has finished, you have to port your own modifications from the
backup files to the new source files in the src*/ directories. Further adaptions to user spe-
cific project extensions might be required, see section 5.2 ’Step 2: Updating your source
code and other user specific extensions’.
• Path point maneuver steps converted to Follow trajectory with backwards driving
objects
• terrain files created by the user
• modular powertrains
Those require a manual update! Please note the following hints for the topics Path point
maneuver steps and modular powertrains below.
GearBoxM_In.GB_m<gb>.Clutch_dis.ro
tv_in
ClutchIn.rotv_out ClutchIn.<i>.rotv_out
ClutchM_In.Cl_m<i>.rotv_out GearboxIn.<gb>.Clutch.rotv_out
GearBoxIn.Clutch.rotv_out GearboxIn.<gb>.Clutch_dis.rotv_out
GearBoxIn.Clutch_dis.rotv_out
GearBoxM_In.GB_m<gb>.Clutch.rotv_o
ut
GearBoxM_In.GB_m<gb>.Clutch_dis.ro
tv_out
ClutchIn.rotv_out_trg ClutchIn.<i>.rotv_out_trg
ClutchM_In.Cl_m<i>.rotv_out_trg GearboxIn.<gb>.Clutch.rotv_out_trg
GearBoxIn.Clutch.rotv_out_trg GearboxIn.<gb>.Clutch_dis.rotv_out_trg
GearBoxIn.Clutch_dis.rotv_out_trg
GearBoxM_In.GB_m<gb>.Clutch.rotv_o
ut_trg
GearBoxM_In.GB_m<gb>.Clutch_dis.ro
tv_out_trg
ClutchIn.Trq_in ClutchIn.<i>.Trq_in
ClutchM_In.Cl_m<i>.Trq_in GearboxIn.<gb>.Clutch.Trq_in
GearBoxIn.Clutch.Trq_in GearboxIn.<gb>.Clutch_dis.Trq_in
GearBoxIn.Clutch_dis.Trq_in
GearBoxM_In.GB_m<gb>.Clutch.Trq_in
GearBoxM_In.GB_m<gb>.Clutch_dis.Tr
q_in
ClutchIn.Trq_out ClutchIn.<i>.Trq_out
ClutchM_In.Cl_m<i>.Trq_out GearboxIn.<gb>.Clutch.Trq_out
GearBoxIn.Clutch.Trq_out GearboxIn.<gb>.Clutch_dis.Trq_out
GearBoxIn.Clutch_dis.Trq_out
GearBoxM_In.GB_m<gb>.Clutch.Trq_o
ut
GearBoxM_In.GB_m<gb>.Clutch_dis.Tr
q_out
ClutchIn.Trq_out_trg ClutchIn.<i>.Trq_out_trg
ClutchM_In.Cl_m<i>.Trq_out_trg GearboxIn.<gb>.Clutch.Trq_out_trg
GearBoxIn.Clutch.Trq_out_trg GearboxIn.<gb>.Clutch_dis.Trq_out_trg
GearBoxIn.Clutch_dis.Trq_out_trg
GearBoxM_In.GB_m<gb>.Clutch.Trq_o
ut_trg
GearBoxM_In.GB_m<gb>.Clutch_dis.Tr
q_out_trg
There were also changes to the Motor Control Unit reference names.
Chapter 6
Announcements for Future Releases
- The deprecated functions to generate, initialize, evaluate and free the ‘IPGDriver-
lite’ will be removed with CarMaker 14.0.
Utilities
• CANiogen
With CarMaker 14.0, CANiogen will no longer be provided with the CarMaker installa-
tion. The J1939 functionality will be provided by a newly introduced utility. For further
functionality please use the RBS Configurator which replaces and exceeds the CANio-
gen functionality.
• PCANIO
This module will be no longer available in CarMaker Office. It will become an exclusive
feature of CarMaker Office Extended.
• The RBS compatibility mode to save RBS configurations in a format compatible with
older CarMaker releases (CarMaker versions 6.x to 8.1.1) will be removed.
Industry Standards
• CarMaker’s ADTF interface will no longer support the UDP communication interface.
• ASAM FIBEX databases of version 2.0 will no longer be supported.
Chapter 7
Software Discontinuation Process
Maintaining the high quality of our software is important to us, which is why we are introduc-
ing a software discontinuation process. This process ensures that you will continue to
receive support for earlier versions of our software and, at the same time, allows us to drive
innovation in our products that you have come to rely on in each release.
This release-based process, which applies to the CarMaker product family, became effec-
tive with the final release of CarMaker 8.0.
Please refer to each product phase listed below for detailed information on our discontinu-
ation process.