IPG: CarMakerHeadless¶
供应商信息
Vendor |
Web page |
产品名称 |
Version |
|---|---|---|---|
IPG Automotive GmbH |
CarMakerHeadless |
11.1 to 15.0 |
Categories
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
Signal recordings(信号记录) 🛈
文件格式 |
Comment |
|---|---|
*.erg, *.erg.info |
CarMaker recording file with meta information |
Platform
操作系统 |
Support |
|---|---|
Windows |
✓ |
Linux |
✓ |
Ports¶
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.
从 Ubuntu 22.04 LTS 或 Windows 10(Python 3.9 或更高版本)开始,IPG 支持 CarMaker Python API。 从 CarMaker 15.0.x 起,安装过程分为两部分。 首先,在 CarMaker 安装过程中选择选项 “Python API py3.9..3.13 Add-On 15.0”。
有关安装该 API 的更多信息,请参见 CarMaker 安装指南中的
[CARMAKER_INSTALLATION]/doc/InstallationGuide/Content/Content_Installation-Guide/B-Installing-Topics/Installation-of-Add-on-Packages.htm
和 [CARMAKER_INSTALLATION]/doc/CMAPI/index.html。
之后必须手动完成安装。根据要支持的 Python 版本,必须在 C:\IPG\carmaker\win64-15.0.x\Python 下创建相应的目录,例如“python3.9”。在 Linux 上,该目录应创建在 /opt/ipg/carmaker/linux64-15.0.x/Python/python3.9 下。为 CarMaker API 提供的 Python 版本可能与执行 ecu.test 所用的 Python 版本不同。但必须确保 CarMaker API 与 TBC 设置中选择的 Python 版本兼容。以下章节分别介绍在 Windows 和 Linux 上手动安装 API 所需的步骤。
Windows:
md C:\IPG\carmaker\win64-15.0.1\Python\python3.9
cd C:\IPG\carmaker\win64-15.0.1\Python\python3.9
cp -rf ..\ASAM .
cp -rf ..\IPG .
cp -rf ..\IPGRoad .
tar -xf ..\apoc-2.4.1-cp39-cp39-win_amd64.whl
tar -xf ..\cmapi-15.0.1-cp39-abi3-win_amd64.whl
tar -xf ..\infofiles-2.1-cp39-cp39-win_amd64.whl
del setup.py
Linux:
sudo su
md /opt/ipg/carmaker/linux64-15.0.1/Python/python3.9
cd /opt/ipg/carmaker/linux64-15.0.1/Python/python3.9
cp -rf ../ASAM .
cp -rf ../IPG .
cp -rf ../IPGRoad .
unzip ../apoc-2.4.1-cp39-cp39-win_amd64.whl
unzip ../cmapi-15.0.1-cp39-abi3-win_amd64.whl
unzip ../infofiles-2.1-cp39-cp39-win_amd64.whl
rm setup.py
chown -R <user>:<group> /opt/ipg/carmaker/linux64-15.0.1/Python/python3.9
chmod -R u=rwX,go=rX /opt/ipg/carmaker/linux64-15.0.1/Python/python3.9
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 |
在以下情况下可用 |
默认值 |
有效值 |
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 |
工具调用被中止前的超时时间。 |