Port APPLICATION - DEFAULT¶
Application access
Stimulation¶
此端口不具备激励能力。
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 |
在以下情况下可用 |
默认值 |
有效值 |
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. |
|||
默认采集速率 |
‘Tool-Default’ |
string |
测量采集率的声明,用于在 test step 中未设置采集率时作为替代使用(”*” 和 “?” 可用作通配符)。“Tool-Default” 会启用工具的默认采集率 |
||
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.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
WorkPageChecksum |
string |
Checksum of the reference page |
CalculateWorkPageCRC¶
Returns the checksum of the working page as a numerical value.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
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.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
configParam |
string |
Path of the configuration parameter within the configuration file of the port, e.g. “sample.path.value”. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
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.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
configParam |
string |
Path of the configuration parameter within the configuration file of the port, e.g. “sample.path.value”. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
string |
Value of the configuration parameter |
GetNumberOfPages¶
Returns the number of pages that are supported by the MC system.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
NumberOfPages |
string |
Number of pages that are supported by the MC system. |
StartMeasurement¶
Starts the measurement.
StartOnlineCalibration¶
Activates the calibration access.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
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.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
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. |