Port MODELACCESS - DEFAULT¶
XIL-API-MAPort
Stimulation¶
Restrictions:
由 STI 文件中的 DataFileSegment 引用的 Trace 文件不会由 ecu.test 自动转换。
用户需要自行检查所使用的 Trace 格式是否受该工具支持。
Supported execution modes¶
另请参见:时间模式的特殊说明
Preferred time source/mode: Real-time
- Real-time:
To use real-time mode, the Test configuration in the Execution tab must be configured as the source ‘real time’.
- Stepwise simulation time:
To use the stepwise simulation mode, the port in the Test configuration in the Execution tab must be selected and the mode set to ‘stepwise’. Wait-until-true expressions are evaluated - if possible - by the tool. If the tool cannot evaluate them, the evaluation will be done by ecu.test. This can lead to lower performance. Invalid expressions are only noted in the log if the log level is set to “Maximum”.
- Continuous simulation time:
To use the continuous simulation mode, the port in the Test configuration in the Execution tab must be selected and the mode set to ‘continuous’.
Specifics¶
模型信息
有关可用信号和参数的信息从已配置的模型文件中读取,这会加快配置启动速度。若仍希望通过 XIL 在线查询可用的模型信息,可以改用工具适配器 ASAM: Generic XIL-API。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Platform |
string |
Name of the platform to be used e.g. VEOS, SCALEXIO, … |
|||
Model file |
string |
Path to the model file (*.sdf) to be used. If this path is not set (default), the model file referenced in the test configuration is used. |
|||
Loading behavior on reduced compatibility |
‘cancel’ |
[‘cancel’, ‘fix and download’, ‘ignore’] 显示值:
|
string |
Behavior of loading on reduced compatibility between model and SCALEXIO System |
|
Add configuration parameters |
‘<none>’ |
string |
Adds port configuration parameters to the generated port configuration file. The parameter paths, including the new values, must be specified in a JSON format, e.g. ‘{“sample.path”: value}’. |
||
Replace current configuration |
☐ |
bool |
“True” replaces the current configuration with the selected one. Otherwise the running configuration will be used. |
||
Start simulation |
‘start’ |
[‘start’, ‘test start’, ‘no start’] 显示值:
|
string |
Specifies when the simulation is started. “Start”: The simulation is started when the configuration starts. “On start of test”: The simulation is started when the execution of a test case starts. “Do not start”: The simulation will not be started. The resulting port state depends on the “Replace current configuration” setting. An already running and simulating application will not be stopped. |
|
Stop simulation |
‘stop’ |
[‘stop’, ‘test stop’, ‘no stop’] 显示值:
|
string |
Specifies when the simulation is stopped. “Stop”: The simulation is stopped when the configuration stops. “At test stop”: The simulation is stopped when the execution of the test case stops. “Do not stop”: The simulation is not stopped implicitly. |
|
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. |
||
Default recording acquisition rate |
‘Tool-Default’ |
string |
Recording acquisition rate to use as fallback, if no acquisition rate has been provided for the variable (”*” and “?” may be used as wildcards). “Tool-Default” uses the first available acquisition rate. |
||
Enforce default recording acquisition rate |
☐ |
bool |
The default recording acquisition rate is enforced for all quantities when recording. |
||
Model time refresh rate |
0 |
float |
Defines the interval (in seconds) at which the model time should be queried for synchronization with the test case. Value 0 causes a query after each simulation step. |
||
Parameter files |
string |
A comma separated list of parameter files. The files will be transferred to the XIL server on start of configuration. Paths can be absolute or relative to the tool host base path. |
|||
Adapt matrix layout |
☐ |
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 🛈¶
DownloadParameterSets¶
Loads a single or multiple parameter files to the XIL server.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
parameterFilePaths |
string |
A comma separated list of parameter files. |
ExecuteTargetScript¶
Loads a target script to the target system and executes it. The execution time is limited by the tool’s setting “Timeout for tool call”.
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
customProperties |
{} |
object |
Target Script 的自定义属性(字典形式),例如 {“ApplicationProcessor”: “leaderAppl”}。 |
||
inputParameters |
{} |
object |
Input parameters for Target Script as dictionary {“parameterName”: “parameterValue”}. Only primitive data types are supported. |
||
outputParameterNames |
[] |
object |
List of output parameters to be returned. These are read from the target script after execution. To be entered as a list of strings. Only primitive data types are supported. |
||
targetScriptPath |
uri |
Absolute or relative path to target script on this machine. Relative paths are resolved relative to the workspace directory. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
object |
Values of output parameters as dictionary {“outputParameter”: “valueAfterExecution”}. The target script parameters to be returned need to be specified before execution with the respective job parameter. |
GetAllStimulations¶
Get list of initialized stimuli files
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
RunningOnly |
False |
[False, True] |
bool |
Return only active (running and paused) Stimuli. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
object |
List of active stimulation files |
GetConfigState¶
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 |
GetRecordingFilesStates¶
Get dictionary containing all recording files and their corresponding recording state
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
object |
Dictionary containing file names and corresponding state (“activated”,”configured”, “running” or “finished”) |
GetSimulationState¶
Get status of simulation
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
string |
“disconnected”, “running”, “paused”, “stopped”, “not initialized” or “unknown: <MAPortState>”. The state “paused” is available since XiL-version 2.1. |
GetSimulationTime¶
Request simulation time
GetStimulationState¶
GetStatus of stimulation
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
InstanceIdentifier |
string |
Instance identifier of the stimulus of which to query the state. |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
return |
string |
“configuration”、“ready”、“running”、“paused”、“finished”、“stopped”、“not started” 或 “unknown: <SignalGeneratorState>” |
PauseSimulation¶
Pauses the simulation and sets the state to “paused”.
PauseStimulation¶
Pause stimulation
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
InstanceIdentifier |
string |
Instance identifier of the stimulus that is to be paused. |
ReadVariable¶
Read model variables
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
VariablePath |
uri |
Full model path |
ResumeStimulation¶
Resume paused stimulation
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
InstanceIdentifier |
string |
Instance identifier of the stimulus that is to be resumed. |
StartSimulation¶
Starts the simulation. If the connection is operated in SiL mode, the port state is set to “paused”. In HiL mode, the state “running” is established directly.
StopSimulation¶
Ends the simulation and sets the state to “stopped”.
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. |
WriteVariable¶
Write model variables
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Value |
string |
||||
VariablePath |
uri |
Full model path |