Stimulation control(激励控制)¶
本类别包含用于控制激励运行的 test step:Start Stimulus 和 Stop Stimulus。
除了回放激励外,还可以使用 test step Signal-Stimulation(简称 Stimulus test step)。
在 stimulus test step 中,信号形状直接在测试用例中定义,且只能激励单个目标变量;相比之下,Start Stimulus test step 提供以下能力:
- 使用符合 ASAM XIL 标准的 STI 和 STZ 文件。
- 直接使用 CSV、MAT、MDF4 等其它数据文件类型。
- 只要在所使用的 STI/STZ 文件中已定义,就可以分配输入信号(根据 ASAM 标准,作为 segment property 的 StringSymbol,以及停止触发表达式中的 Alias)和参数。
- 待激励文件中的信号可以分配给多个目标变量。
限制和特殊说明
上述激励能力并非对所有 tools with stimulation support(支持激励的工具) 都可用。这是因为激励的实际回放由所使用的工具负责,ecu.test 只是将待激励的数据传递给工具。不过,ecu.test 也会尽量按照具体工具的要求准备这些待激励数据:
对于只能通过 CSV 进行激励的工具,指定的数据文件会自动转换为 CSV(例如 Silver、VeriStand)。因此,在 Start Stimulus test step 中可以指定任意文件类型。
如果某个工具原生支持某种文件格式的激励,则该文件会未经修改直接发送给工具用于激励。
如果某个工具支持 STZ 格式,且指定的是数据文件(例如 MAT),则会隐式创建一个临时 STZ 文件。该 STZ 文件会为 test step 使用到的每个信号创建一个 DataFileSegment,并引用相应的数据文件。在这种情况下,必须确保所使用的数据文件受对应工具支持,因为 ecu.test 不能为所有 Tools with stimulus support 都将引用文件转换为工具兼容格式。更多信息请参见 Overview of the stimulus capabilities of the tools。
对于大多数工具,ecu.test 会完全负责将激励数据准备为工具兼容格式。因此,只要 ecu.test 能读取该输入数据格式,通常就可以直接使用。
通常,最好先了解所用工具支持哪些信号激励能力。相关信息可在对应工具的手册中找到,或直接咨询工具厂商。尤其是对于 ASAM XIL 的 STI 格式,可能只支持某些特定版本(如 1.0、2.0、2.1、2.2 等),或者并非所有已定义的 stimulus segment types 都被允许。
另一个特殊情况是带有外部引用数据文件的 STI 文件(例如通过 DataFileSegment 或 SignalValueSegment 引用)。特别是在使用 Tool Server 时,工具运行在另一台计算机上,因此必须注意:用于激励的相关文件需要从 ecu.test 传输到目标计算机。但无法始终保证被引用的文件也会一并传输。此外,这些文件在目标计算机上的文件系统路径不可避免地会发生变化(位于 ToolLibTemp 目录中)。有些工具还会对 STI 文件中引用文件的写法有特殊要求,例如要求使用绝对路径或相对路径。
为避免此类问题,建议使用 STZ 格式。它本质上是一个简单的 ZIP 文件(扩展名为 .stz),可将这些被引用的文件一起打包进去。
Start Stimulus(启动激励)¶
该 test step 用于启动一个包含信号曲线的文件中的激励回放。支持的文件格式取决于所选工具。通常支持 stimulus 文件(.sti)或压缩的 stimulus 文件(.stz)。ecu.test 自带 Signal Editor,可用于创建或编辑此类文件。除 .sti/.stz 文件外,所有 ecu.test 可读取的 trace 格式也都可以直接用于激励。
ecu.test 会在执行时创建一个 STI 文件,并将指定 trace 文件中选中的信号作为 data file segment 包含进去。默认情况下,ecu.test 会将指定的 trace 文件转换为工具兼容的格式(某些工具/端口除外,参见 Overview of the stimulus capabilities of the tools)。STI 文件中 DataFileSegment 引用的 trace 文件也会自动转换为工具兼容格式。
添加该 test step 后,会打开以下对话框:
激励文件显示在 Stimulus file 字段中。除了直接输入文件名文本外,也可以通过 Open 按钮在常规文件打开对话框中选择文件。文件路径既可以是绝对路径,也可以是相对于当前工作区的路径。
Info(说明)
激励文件也可以通过测试用例变量进行参数化。测试执行期间,激励会在运行时更新。根据所使用的工具不同,设置新激励时可能存在延迟。因此,建议不要将当前激励文件修改为与 package 启动时不同的文件。
Signal assignment(信号分配)¶
激励是基于端口执行的,因此不允许在同一个 Start Stimulus test step 中分配来自不同端口的 mapping。如果需要在不同端口上激励测试量,则必须在测试用例中为每个端口分别配置一个独立的 Start Stimulus test step(必要时还需配置对应的 Stop Stimulus test step)。
允许多个 Start Stimulus test step 使用同一个激励文件。
Output signals(输出信号)¶
Signal mapping 表格左侧列显示最近一次加载的 stimulus 文件中包含的全部激励信号,右侧列可选择要运行该激励的 signal mapping。一个激励信号可以分配给多个 signal mapping,但每个 signal mapping 只能分配给一个激励信号。
Info(说明)
激励的启动和停止是基于端口的,并受到端口/工具特定延迟的影响。因此,在使用 continuous 和 real-time 执行模式时(参见 Temporal behaviour),不能期望不同 Start Stimulus test step 的激励严格同步运行。
可通过下拉列表切换三种信号分配模式。默认选择 Manually assign signals。使用 Automatically assign signals 时,系统会在测试执行时根据名称将信号按 1:1 自动分配到已加载的 mapping。使用 Assign unassigned signals automatically 时,则可采用混合模式,只对 signal assignment 表中尚未手动分配的信号执行自动分配。
当需要在多个测试用例中激励测量文件中的大量信号时,(部分)自动信号分配会很有优势。此时只需为待激励信号使用全局 mapping,并在测试配置中加载该 mapping。在所有使用了(部分)自动信号分配的 Start Stimulus test step 中,凡是存在唯一 1:1 mapping 的信号,都会在测试执行时自动激励。
在 Automatically assign signals 或 Assign unassigned signals automatically 模式下,如果名称无法唯一实现 1:1 匹配,也可以指定匹配模式。例如,当信号名称相对于 mapping 名称存在某些前缀时,这种方式就很有用。
模式使用示例
例如,需要将输出信号 recording/10ms/velocity 分配到 mapping velocity [m/s],可使用以下模式:
Output signal pattern:
recording/*/(*)Mapping pattern:
(*) [*
圆括号之间确定出的部分字符串会从标识符中提取出来,并用于比较。
模式语法
每个模式都必须包含 且仅包含一对 圆括号,用于定义比较时关注的子字符串。支持以下特殊字符:
* … 任意字符串的通配符
? … 任意单个字符的通配符
进行信号分配时,只会考虑那些适用于相应模式的信号或 mapping。该模式必须从第一个字符到最后一个字符完整匹配标识符。
Info(说明)
在 Automatically assign signals 模式下,对于该 test step 是否能够无错误执行的检查能力是有限的。这是因为运行时实际存在的 stimulus 文件,可能与测试用例编辑时使用的 stimulus 文件不同。不过,动态信号分配始终基于执行时的 stimulus 文件。
此外,还取决于所使用的工具:在运行时,是否可以激励那些在 package 执行开始时尚未知的其它目标变量。这个问题必须结合具体情况逐项检查。
Input signals(输入信号)¶
如果所选 stimulus 文件中包含输入信号定义(例如作为 segment property 的 StringSymbol,或作为停止触发表达式中的 Alias),则也可以使用该 test step 对这些信号进行映射。
Info(说明)
ASAM 标准允许 Alias 和 StringSymbol 使用相同名称。在这种情况下,StringSymbol 输入信号和 Alias 输入信号只能共用同一个 mapping。如果确实需要为这两类输入信号分配不同的 mapping,则必须确保 Alias 输入信号和 StringSymbol 输入信号能够彼此明确区分。
Options(选项)¶
存在两种执行模式:
- Asynchronous execution
激励启动后,测试执行会立即继续,不会等待激励完整回放结束。这是默认行为。
- Synchronous execution
测试用例执行会暂停,直到激励完整回放结束。该执行模式通过复选框 Synchronous execution 启用。
如果启用了 Synchronous execution,还可以选择 Stop stimulus automatically。启用后,激励在完整回放结束后会自动隐式停止,因此后续测试用例流程中无需再额外配置 Stop Stimulus test step。
可以将计算得到的激励持续时间保存到测试用例变量中,随后在测试用例中使用该值,例如在 Wait test step 中。计算持续时间时,只会考虑激励文件中实际已分配的信号。
Stop Stimulus(停止激励)¶
该 test step 用于终止来自某个激励文件的激励使用。
与对应 Start Stimulus 的关联通过实例标识符完成,因此这里必须选择与 Start Stimulus 中相同的实例标识符。