IPG: CarMakerHeadless

Herstellerinformationen

Hersteller

Webseite

Produktname

Version

IPG Automotive GmbH

https://www.ipg-automotive.com

CarMakerHeadless

11.1 bis 15.0

Kategorien

MDL 🛈

APL 🛈

BAN 🛈

BMA 🛈

SVC 🛈

DGN 🛈

FIU 🛈

EES 🛈

FCT 🛈

DBG 🛈

IMG 🛈

AUDIO 🛈

ENVSIM 🛈

ENVCOM 🛈

✓

Signalaufnahmen 🛈

Dateiformat

Kommentar

*.erg, *.erg.info

CarMaker-Aufnahmedatei mit Metainformationen

Plattform

Betriebssystem

Unterstützung

Windows

✓

Linux

✓

Ports

Besonderheiten

Grundlegende Informationen zum Umgang mit Umfeldsimulationen finden sich im Abschnitt Tab Umfeldsimulation.

Diese Toolanbindung ermöglicht das Starten einer neuen CarMakerHeadless-Instanz sowie das Verbinden auf eine laufende Instanz. Anschließend können CarMaker-TestRuns geladen und die Simulation gestartet und gestoppt werden. Außerdem ist es möglich, Signale aufzuzeichnen und im Testfall zu lesen.

Vorbereitung bei Nutzung von CarMaker unter Linux

Für die Nutzung des Runner unter Linux gelten dieselben Vorbedingungen wie für die GUI-Variante.

Einrichtung

Die TBC-Optionen sollten von oben nach unten konfiguriert werden. Insbesondere die Angaben in der Sektion Allgemein müssen am Anfang gesetzt werden.

Python-API

Der CarMakerHeadless wird über die von IPG bereitgestellte CarMaker-Python-API gesteuert, welche für verschiedene Python-Versionen zur Verfügung steht. Für die Funktion der API muss der Nutzer den passenden Python-Interpreter auf seinem eigenen System installieren und den Pfad zum Interpreter in der TBC unter Pfad zur Python-Executable referenzieren.

IPG unterstützt die CarMaker Python-API ab Ubuntu 22.04 LTS bzw. Windows 10 mit Python 3.9 oder höher. Ab CarMaker 15.0.x ist der Installationsprozess zweigeteilt. Zuerst ist bei der Installation von CarMaker die Option „Python-API-py3.9..3.13 Add-On 15.0“ auszuwählen.

Weitere Informationen zum Installieren der API finden sich in der CarMaker-Installation-Guide unter [CARMAKER_INSTALLATION]/doc/InstallationGuide/Content/Content_Installation-Guide/B-Installing-Topics/Installation-of-Add-on-Packages.htm und [CARMAKER_INSTALLATION]/doc/CMAPI/index.html.

Danach ist die Installation manuell zu vervollständigen. Je zu unterstützender Python-Version ist unter C:\IPG\carmaker\win64-15.0.x\Python eine entsprechendes Verzeichnis wie zum Beispiel „python3.9“ ertellt werden. Unter Linux wäre entsprechend das Verzeichnis unter /opt/ipg/carmaker/linux64-15.0.x/Python/python3.9 zu erstellen. Die für die CarMaker-API bereitgestellte Python-Version darf von der Python-Version, die für die Ausführung von ecu.test verwendet wird, abweichen. Es ist jedoch sicherzustellen, dass die CarMaker-API mit der Python-Version kompatibel ist, welche in den TBC-Einstellungen ausgewählt wurde. Die nötigen Schritte zur manuellen Installation der API sind für Windows und Linux in den folgenden Abschnitten beschrieben.

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

Konfiguration mit Autostart

ecu.test kann die Runner-Instanz bei der Aktivierung der Konfiguration automatisch starten. Dazu muss in der Sektion Toolverbindung der Startmodus auf Automatisch mit ecu.test starten gesetzt werden.

Konfiguration und Verbindung mit laufender Instanz

Die Verbindung zu einer laufenden CarMaker-Instanz kann nur mit einer bereits gestarteten CarMaker-Instanz konfiguriert werden. Dies erfolgt in folgenden Schritten:

  1. CarMaker-Runner manuell starten.

  2. In der Sektion Toolverbindung der TBC den Startmodus auf Verbindung zu einer laufenden Instanz herstellen setzen.

  3. Die Liste der verfügbaren CarMaker-Instanzen mit einem Klick auf die Aktualisieren-Schaltfläche aktualisieren.

  4. Die gewünschte CarMaker-Runner-Instanz aus der Liste auswählen.

Warnung

Um Aufzeichnungen zu erstellen, muss beim manuellen Starten von CarMaker das Projektverzeichnis mit dem Parameter -projectDir angegeben werden. Ohne Angabe des Parameters nutzt CarMaker das Verzeichnis als Projektverzeichnis, in dem sich die Anwendung befindet.

Aufzeichnungsmodi

Diese Toolanbindung unterstützt die Aufzeichnung per Auto-Start/Stopp sowie die manuelle Aufnahmesteuerung. Bei der Verwendung von Auto-Start/Stopp wird automatisch die gesamte Simulation aufgezeichnet.

Die manuelle Aufnahmesteuerung erlaubt den individuellen Einsatz der Start Trace und Stopp Trace Testschritte.

Es ist möglich die CarMaker Headless Anbindung zu verwenden um sich mit CarMaker for Simulink zu verbinden. Das Vorgehen ist identisch, wie bei der IPG: CarMaker|RealTimeMaker-Anbindung.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Allgemein

CarMaker Lib-Verzeichnis

Allgemein

string

Pfad zum Lib-Verzeichnis mit der libapo-DLL/*.so als absoluter Pfad

CarMaker-Projektverzeichnis

Allgemein

string

Projektverzeichnis als absoluter Pfad oder als relativer Pfad. Pfad kann relativ zum Toolhost-Basispfad oder zum Workspace sein, falls kein Toolhost-Basispfad angegeben wurde.

Pfad zur Python-Executable

Allgemein

string

Pfad zur Python-Executable als absoluter Pfad

Toolverbindung

Startmodus

Toolverbindung

Automatisch mit ecu.test starten

[Automatisch mit ecu.test starten, Verbindung zu einer laufenden Instanz herstellen]

string

ecu.test startet entweder eine neue CarMaker-Instanz oder verbindet sich mit einer bereits gestarteten Instanz

CarMaker-Instanz

Toolverbindung » Startmodus: ‚Verbindung zu einer laufenden Instanz herstellen‘

[‚<online query>‘, ‚<no toollib start>‘]

string

CarMaker Server-Instanz auf dem Tool-Host.

Optional

Simulationsgeschwindigkeit

Optional

‚Use CarMaker settings‘

[‚Use CarMaker settings‘, ‚0.2x‘, ‚0.5x‘, ‚1x‘, ‚2x‘, ‚3x‘, ‚5x‘, ‚Max‘]

string

Setzt die Simulationsgeschwindigkeit auf das ausgewählte Vielfache der Echtzeit oder maximal mögliche Geschwindigkeit für „Max“. Bei „Use CarMaker settings“ wird die in CarMaker gesetzte Geschwindigkeit beibehalten.

Timeout für Toolzugriffe ❲in Sek.❳

‚600‘

string

Zeit nach der eine Anfrage an das Tool abgebrochen wird.