IPG: CarMakerHeadless¶

Legacy/internal identifier: CARMAKERHEADLESS

Vendor information

Vendor	Web page	Product name	Version
IPG Automotive GmbH	https://www.ipg.de	CarMakerHeadless	11.1-14.0

File format	Comment
.erg, .erg.info	CarMaker recording file with meta information

Operating system	Support
Windows	✓
Linux	✓

Ports¶

Port ENVSIM 🛈

Specifics¶

Basic information on dealing with environmental simulations can be found in section Tab Environment Simulation.

This tool connection allows for starting a new CarMakerHeadless instance as well as connecting to a running one. Afterwards CarMaker TestRuns can be loaded and the simulation can be started and stopped. In addition, it is possible to record and read signals.

Preparation when using CarMaker under Linux¶

For using the Runner under Linux, the same preconditions as for the GUI version apply.

Configuration¶

The TBC options should be configured beginning from the top. In particular, the information in the Common section must be set at the beginning.

Python-Executable¶

The CarMakerHeadless is controlled via the CarMaker-Python-API provided by IPG, which is available for different Python versions. For the API to work, the user must install the appropriate Python interpreter on his/her own system and specify the path to the interpreter in the TBC under Path to the Python executable.

Configure with auto start¶

ecu.test can automatically start the Runner when the configuration is being activated. To do this, the start mode in the section Tool connection needs to be set to Start automatically with ecu.test.

Configure and connect with running instance¶

The configuration of a connection to a running CarMakerHeadless instance requires that this instance has already been started. This can be achieved as follows:

Start the CarMaker runner.
Set the property Start mode in the Tool connection section to Connect to a running instance.
Refresh the list of available Carmaker instances by clicking the refresh button.
Select the CarMaker runner instance.

Warning

In order to create recordings, when starting CarMaker manually, the project directory must be specified with the -projectDir parameter. If this parameter is not specified, CarMaker uses the directory in which the application is located as the project directory.

Recording modes¶

This tool connection supports the recording via Auto-Start/Stop as well as manual recording control. When using Auto-Start/Stop, the system will automatically record the entire simulation.

Manual recording control is possible by the individual use of Start Trace and Stop Trace test steps.

CarMaker for Simulink¶

It is possible to use the CarMaker headless connection to connect to CarMaker for Simulink. The procedure is identical to the IPG: CarMaker|RealTimeMaker connection.

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
Common
CarMaker Lib directory	Common			string	Absolute path to lib directory containing the libapo-dll or corresponding .so-file
CarMaker project directory	Common			string	Project directory as absolute or relative path. Path can be relative to the tool host base path or to the workspace, if no tool host base path is set.
Path to the Python executable	Common			string	Path to Python executable as absolute path
Tool connection
Start mode	Tool connection	Start automatically with ecu.test	[Start automatically with ecu.test, Connect to a running instance]	string	ecu.test either starts a new CarMaker instance or connects to an already started instance
CarMaker instance	Tool connection » Start mode: ‘Connect to a running instance’		[‘<online query>’, ‘<no toollib start>’]	string	CarMaker server instance on the tool host.
Optional
Simulation speed	Optional	‘Use CarMaker settings’	[‘Use CarMaker settings’, ‘0.2x’, ‘0.5x’, ‘1x’, ‘2x’, ‘3x’, ‘5x’, ‘Max’]	string	Sets the simulation speed to the selected multiple of the real time or maximum possible speed for “Max”. “Use CarMaker settings” will maintain the speed set in CarMaker.
Timeout for tool call ❲in sec.❳		‘600’		string	Timeout after which a tool call is aborted.