Port APPLICATION - DEFAULT¶

Application access

Stimulation¶

This port has no stimulus capabilities.

Specifics¶

Initial setup

You must set the properties ECUCPort configuration file and ECUMPort configuration file. All other options are optional. Usually the available signals are queried directly from the tool via the API, so just create a control unit in the test configuration without specifying an *.a2l or *.hex.

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
ECUCPort configuration file				string	The path to the configuration file of the XIL-API ECUCPort on the tool host. Specify either an absolute path or a path relative to the model directory.
Overwrite ECUCPort configuration parameters		‘<none>’		string	Allows the port configuration parameters in the specified configuration file to be overwritten. The parameter paths, including the new values, must be specified in a JSON format, e.g. ‘{“sample.path”: value}’. The parameter paths to be overwritten must already be defined in the port configuration file.
ECUMPort configuration file				string	The path to the configuration file of the XIL-API ECUMPort on the tool host. Specify either an absolute path or a path relative to the model directory.
Overwrite ECUMPort configuration parameters		‘<none>’		string	Allows the port configuration parameters in the specified configuration file to be overwritten. The parameter paths, including the new values, must be specified in a JSON format, e.g. ‘{“sample.path”: value}’. The parameter paths to be overwritten must already be defined in the port configuration file.
A2L file				string	A2L file to use. A2L files that may be referenced in the port configuration file will be ignored. The file is automatically transferred to the tool host.
HEX-File				string	The image file which is associated with the A2L file. HEX files that may be referenced in the port configuration file will be ignored. The file is automatically transferred to the tool host.
Default acquisition rate		‘Tool-Default’		string	Declaration of measurement acquisition rate used as alternative in case no acquisition rate is set in the test step (”*” and “?” can be used as wildcard). “Tool-Default” activates the use of the default acquisition rate of the tool
Enforce default acquisition rate for recording		☐		bool	The default acquisition rate is enforced for all quantities when recording.
Recording format		MF4	[CSV, MDF, MF4]	string	File format for recording
Delimiter	Recording format: ‘CSV’	‘;’	[‘;’, ‘,’]	string	Delimiter of CSV file
Recording down-sampling rate		<default>		int	This value can be specified to store only every N-th signal value. “<default>” means that the down-sampling rate is not specified and the vendor default is to be used.
Recording start timeout ❲s❳		30		int	Maximum allowed duration until the tool has actually started the capture after manually starting a capture.
Calibration access		‘Automatic’	[‘Automatic’, ‘Manual’]	string	Automatic: Activate the calibration access automatically when the configuration is started. Manual: Calibration access must be activated and deactivated via tool jobs.
Data transfer direction		‘Download’	[‘Download’, ‘Upload’]	string	Specifies the direction of the data transfer when activating calibration access. Download: Writes the content of the current memory page to the ECU. Upload: Fetches the content of the current memory page from the ECU.
Start of measurement		‘Automatic’	[‘Automatic’, ‘Manual’]	string	Automatic: start measurement automatically at test start. Manual: Start and stop measurement using tool jobs
Support for online A2L query		☑		bool	Activates or deactivates the interface for the test configuration to query a2l information.
Adapt matrix layout	Support for online A2L query	☐		bool	Convert matrices from row layout (XIL) to column layout (ecu.test). In contrast to ASAM XIL, which implements the row layout for storing matrices, ecu.test uses the column layout. If this option is set, matrices are adapted to the internally implemented column layout when they are read in and before they are used in ecu.test. As a result, matrices are displayed correctly and indexing is done consistently according to the scheme [column][row]. If this option is not set, the missing adaptation of the layout causes that one works with the transposed matrix (see e.g. display in report). Thus, indexing the transposed matrix according to the above scheme in ecu.test is equivalent to indexing the (non-transposed) original matrix using the scheme [row][column] from the tool’s point of view. An unset option corresponds to the former behavior. It is recommended to set this for new test cases.

Jobs 🛈¶

CalculateReferencePageCRC¶

Returns the checksum of the reference page as a numerical value.

Return value

Name	Available if	Default value	Valid values	Type	Description
WorkPageChecksum				string	Checksum of the reference page

CalculateWorkPageCRC¶

Returns the checksum of the working page as a numerical value.

Return value

Name	Available if	Default value	Valid values	Type	Description
RefPageChecksum				string	Checksum of the working page

GetCalibrationConfigState¶

Returns the current status of the specified configuration parameter. The parameter must be given as a complete path.

Parameter

Name	Available if	Default value	Valid values	Type	Description
configParam				string	Path of the configuration parameter within the configuration file of the port, e.g. “sample.path.value”.

Return value

Name	Available if	Default value	Valid values	Type	Description
return				string	Value of the configuration parameter

GetMeasurementConfigState¶

Returns the current status of the specified configuration parameter. The parameter must be given as a complete path.

Parameter

Name	Available if	Default value	Valid values	Type	Description
configParam				string	Path of the configuration parameter within the configuration file of the port, e.g. “sample.path.value”.

Return value

Name	Available if	Default value	Valid values	Type	Description
return				string	Value of the configuration parameter

GetNumberOfPages¶

Returns the number of pages that are supported by the MC system.

Return value

Name	Available if	Default value	Valid values	Type	Description
NumberOfPages				string	Number of pages that are supported by the MC system.

StartMeasurement¶

Starts the measurement.

StartOnlineCalibration¶

Activates the calibration access.

Parameter

Name	Available if	Default value	Valid values	Type	Description
LoadingDirection		‘Download’	[‘Download’, ‘Upload’]	string	Specifies the direction of the data transfer when activating calibration access. Download: Writes the content of the current memory page to the ECU. Upload: Fetches the content of the current memory page from the ECU.

StopMeasurement¶

Stops the measurement.

StopOnlineCalibration¶

Deactivates the calibration access.

SwitchToRefPage¶

Switches to the reference page.

SwitchToWorkPage¶

Switches to the working page.

TriggerClientEvent¶

Inserts an event into all running recordings of the port.

Parameter

Name	Available if	Default value	Valid values	Type	Description
description				string	Description of the event (freely selectable).
eventId		0		int	ID of the event (freely selectable). Range of valid values: 0-18446744073709551615.