ViGEM: CCA¶

Vendor information

Vendor	Web page	Product name	Version
ViGEM GmbH	https://vigem.de	Car Communication Analyzer	1.8.3 - 4.5.2

Operating system	Support
Windows	✓
Linux

Specifics¶

This tool connection enables the start, stop and subsequent download of recordings with ViGEM CCA data loggers.

The tool connection can be used locally or via Tool Server. The following conditions must be met on the tool host:

a recent ViGEM CCA framework is installed
the installation path to the ViGEM CCA framework is provided via the environment variable CCA_FRAMEWORK_HOME_x_y_z (e.g. CCA_FRAMEWORK_HOME_2_0_3 = C:/Program Files (x86)/ViGEM GmbH/CCA Framework/v2.0.3/)
the logger is turned on and accessible as a network drive from the tool host

For reliable recording the logger should record continuously, so the property ‘start_event’ of the relevant writer should be set to ‘Start immediately’. Similarly, the property ‘stop_event’ should be set to ‘disabled’.

When connecting to the logger, the keep_logger_alive option is set to True to prevent the logger from shutting down automatically while ecu.test is connected.

Properties 🛈¶

Name	Default value	Valid values	Type	Description
CCA framework version	‘Latest’	[ONLINE]	string	Version of the CCA framework. This list contains all installed CCA frameworks. The option “Latest” chooses the most current version
IP address	‘192.168.x.x’		string	IP address or hostname of the data logger.
Configuration file ❲optional❳			string	Path to a configuration file (*.cca) that is available on the test host. The path can be given absolute or relative to the workspace. The logger will be restarted to apply the configuration. If the field is empty, the current settings of the logger are used.
Timeout for tool call ❲in sec.❳	‘600’		string	Timeout after which a tool call is aborted.

Jobs 🛈¶

DownloadLatestRecordings¶

Downloads all recordings made between the last calls of StartLogging and StopLogging. The recordings are placed in the local report directory. Depending on the size of the recordings and network speed, the transfer may take a long time.

Parameter

Name	Available if	Default value	Valid values	Type	Description
ExcludePatterns		[]		object	List of glob patterns to exclude recordings from download. Glob patterns are matched against paths relative to the recording directory. Files and folders matching at least one pattern are excluded from the download. Exclude patterns are applied after include patterns. Example: [“run_”, “nightly_”, “2025-03-*.rec”]
IncludePatterns		[]		object	List of glob patterns to include recordings in download. Glob patterns are matched against paths relative to the recording directory. Only files or folders matching at least one pattern are included in the download. Include patterns are applied first. Example: [“run_”, “nightly_”, “2025-03-*.rec”]

RebootLogger¶

Reboots ViGEM-CCA. The call is blocking until a connection to the logger is reestablished or the maximum number of connection attempts has been reached.

Parameter

Name	Available if	Default value	Valid values	Type	Description
MaxAttempts		3		int	Maximum number of connection attempts made. If ViGEM-CCA is not already up and running after the reboot, one attempt takes at maximum 20s.

SendTrigger¶

Sends an automatic trigger event. If a recording is started with this event, its data is only fetched if the call and the end of its triggered recording are between a StartLogging step and a StopLogging step.

Parameter

Name	Available if	Default value	Valid values	Type	Description
TriggerId		0		int	ID of the trigger to send

StartLogging¶

Starts a recording.

StopLogging¶

Stops a recording.