ViGEM: CCA¶

Herstellerinformationen

Hersteller	Webseite	Produktname	Version
ViGEM GmbH	https://vigem.de	Car Communication Analyzer	1.8.3 - 4.5.2

Kategorien

MDL 🛈	APL 🛈	BAN 🛈	BMA 🛈	SVC 🛈	DGN 🛈	FIU 🛈	EES 🛈	FCT 🛈	DBG 🛈	IMG 🛈	AUDIO 🛈	ENVSIM 🛈	ENVCOM 🛈

Plattform

Betriebssystem	Unterstützung
Windows	✓
Linux

Besonderheiten¶

Diese Toolanbindung ermöglicht das Starten, Stoppen sowie anschließende Abholen von Aufnahmen bei ViGEM CCA Datenloggern.

Die Toolanbindung kann lokal oder per Tool Server benutzt werden. Auf dem Toolhost müssen dazu folgende Bedingungen erfüllt sein:

ein aktuelles ViGEM CCA Framework ist installiert
der Installationspfad zum ViGEM CCA Framework wird über die Umgebungsvariable CCA_FRAMEWORK_HOME_x_y_z bereitgestellt (z.B. CCA_FRAMEWORK_HOME_4_5_2 = C:/Program Files (x86)/ViGEM GmbH/CCA Framework/v4.5.2/)
der Logger ist eingeschaltet und als Netzlaufwerk vom Toolhost erreichbar

Für eine zuverlässige Aufnahme sollte der Logger kontinuierlich aufzeichnen, die Eigenschaft ‚start_event‘ des relevanten Writers sollte also auf ‚Sofort starten‘ stehen. Analog sollte auch die Eigenschaft ‚stop_event‘ auf ‚deaktiviert‘ gesetzt werden.

Bei der Verbindung mit dem Logger wird die Option keep_logger_alive auf True gesetzt, um zu verhindern, dass der Logger automatisch herunterfährt während ecu.test verbunden ist.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
CCA Framework Version	‚Latest‘	[ONLINE]	string	Version des CCA Frameworks. Die Liste enthält alle installierten CCA Frameworks. Die Option „Latest“ nimmt immer die aktuellste Version
IP Adresse	‚192.168.x.x‘		string	IP-Adresse oder Hostname des Datenloggers.
Konfigurationsdatei ❲optional❳			string	Pfad zu einer Konfigurationsdatei (*.cca), welche auf dem Testhost verfügbar ist. Der Pfad kann absolut oder relativ zum Workspace angegeben werden. Um die Konfiguration zu übernehmen wird der Datenlogger neu gestartet. Wenn das Feld leer ist, werden die aktuellen Einstellungen des Loggers verwendet.
Timeout für Toolzugriffe ❲in Sek.❳	‚600‘		string	Zeit nach der eine Anfrage an das Tool abgebrochen wird.

Jobs 🛈¶

DownloadLatestRecordings¶

Lädt alle Aufnahmen herunter, welche zwischen den letzen Aufrufen von StartLogging und StopLogging entstanden sind. Die Aufnahmen werden in das lokale Reportverzeichnis gelegt. Je nach Größe der Aufnahmen und Netzwerkgeschwindigkeit kann die Übertragung eine große Zeitspanne in Anspruch nehmen.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
ExcludePatterns		[]		object	Liste von Glob-Mustern, um Aufzeichnungen vom Download auszuschließen. Glob-Muster werden mit Pfaden abgeglichen, die relativ zum Aufzeichnungsverzeichnis sind. Dateien und Ordner, die mindestens einem Muster entsprechen, werden vom Download ausgeschlossen. Ausschlussmuster werden nach den Einschlussmustern angewendet. Beispiel: [„run_“, „nightly_“, „2025-03-*.rec“]
IncludePatterns		[]		object	Liste von Glob-Mustern, um Aufzeichnungen in den Download einzuschließen. Glob-Muster werden mit Pfaden abgeglichen, die relativ zum Aufzeichnungsverzeichnis sind. Nur Dateien oder Ordner, die mindestens einem Muster entsprechen, werden in den Download aufgenommen. Einschlussmuster werden zuerst angewendet. Beispiel: [„run_“, „nightly_“, „2025-03-*.rec“]

RebootLogger¶

Startet ViGEM-CCA neu. Blockierend, bis erneut eine Verbindung zum Logger hergestellt werden konnte oder die maximale Anzahl an Verbindungsversuchen erreicht ist.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
MaxAttempts		3		int	Maximale Anzahl an durchgeführten Verbindungsversuchen. Wenn ViGEM-CCA nach dem Neustart noch nicht wieder betriebsbereit ist, dauert ein Versuch maximal 20s.

SendTrigger¶

Löst ein automatisches Anwenderereignis/Trigger aus. Falls mit diesem Ereignis eine Aufnahme gestartet wird, so werden deren Daten nur abgeholt, wenn der Aufruf und dessen Aufnahmeende zwischen einem StartLogging- und einem StopLogging-Schritt liegen.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
TriggerId		0		int	ID des auszulösenden Anwenderereignis

StartLogging¶

Startet die Aufnahme.

StopLogging¶

Stoppt die Aufnahme.