Data operations(数据操作)

本类别包含所有可用于修改或评估变量的 test step(测试步骤)。

Read from inbox(从 inbox 读取)

从 inbox 读取消息。

关于该 test step 从 inbox 读取消息的详细说明,请参见章节 Parallel test threads。

Calculation(计算)

选择 test step Calculation 会打开对话框 Calculation。

iUtility_Berechnung_2

Calculation test step 用于对变量窗口中的变量执行算术或逻辑运算。此外,还可以访问全局可用的标准 Python 函数以及来自 userPyModules 的用户自定义 Python 函数。

在字段 Name 中,可以为插入的 calculation test step 指定显示名称。该名称会显示在 package editor、执行对话框和报告中。如果未输入名称,则默认使用 Calculation。

待求值的表达式必须输入到文本字段 Expression 中。在该字段上右键即可通过上下文菜单方便地插入变量名。

Calculation test step 的结果可以保存到某个变量中,该变量名称在字段 Save in 中填写。

Bit extract(位提取)

选择 test step Bit extract 会打开相应对话框。

../../../_images/Utility_BitExtract.png

该 test step 用于从字节序列中提取单独的位。在 Expression 中指定包含该字节序列的变量或函数。若条件允许,其内容会在下方预览区中显示。Start bit 和 Bit length 用于确定从哪个位置开始提取多少位,这部分也会在显示中以橙色背景标出。

Byte order 用于指定该字节序列采用 Intel 还是 Motorola 格式。Save in 用于指定保存提取结果位的变量。

Write to outbox(写入 outbox)

向 outbox 写入数据。

关于向 outbox 写入数据的该 test step 的详细说明,请参见章节 Parallel test threads。

Multi-Check(多项校验)

在 ecu.test 中,为某个 test step 编写一个与前序 test step 评估结果相关的 expectation 往往比较困难。这是因为每个 expectation 表达式都只对应其所属 test step 的结果。

test step Multi-Check 解决了这个问题。Multi-Check 是一个容器型 test step,其结果取决于其子 test step 的评估结果。

Info

Multi-Check 只能包含 read、calculation 和 job 类型的 test step,不能添加其它类型的 test step。不过子 test step 的数量不受限制。需要注意的是,Multi-Check 会顺序执行每个 test step,而不是并行执行。

../../../_images/Utility_Multi_Check.png

在 Fulfilled for 下,可以为 Multi-Check test step 设置总体条件。此外,还可以选择若干时间选项之一,将 expectation 与时间条件关联起来。为此,子 test step 会重复执行,直到满足 Multi-Check 的 expectation。

如果选择 every test step,则只有当所有底层 test step 在同一时刻都被评估为 SUCCESS 时,Multi-Check 才会成为 SUCCESS。(这里的“同一时刻”是指“在 Multi-Check 的同一个轮询周期内”。)

下表汇总了选项 each test step 的行为:

SUCCESS(成功)的条件: FAILED(失败)的条件:
wait until true(等待直到为真) 所有 test step 同时变为 SUCCESS。 达到超时时间。
true for at least(至少持续为真) 所有 test step 在指定的最短持续时间内持续保持 SUCCESS。 在最短持续时间到达前,至少有一个 test step 变为 FAILED。
true for at least … within …(在……范围内至少持续为真……) 在超时范围内的任意时刻,所有 test step 都在指定的最短持续时间内持续保持 SUCCESS。 距离超时的剩余时间已短于最短持续时间,且至少有一个 test step 变为 FAILED。

选项 at least one test step 的效果是:只要其某个子 test step 变为 SUCCESS,Multi-Check 就会立即结束。在这种情况下,Multi-Check 本身也会被评估为 SUCCESS。

这种行为可由下表概括:

SUCCESS(成功)的条件: FAILED(失败)的条件:
wait until true(等待直到为真) 至少有一个 test step 变为 SUCCESS。 达到超时时间。
true for at least(至少持续为真) 至少有一个 test step 在指定的最短持续时间内持续保持 SUCCESS。 在最短持续时间到达前,所有 test step 都变为 FAILED。
true for at least … within …(在……范围内至少持续为真……) 某个 test step 首次在指定的最短时间内持续保持 SUCCESS。 距离超时的剩余时间已短于最短持续时间,且所有 test step 都不再变为 SUCCESS。

设置 every test step at least once 后,只要其子 test step 的每个条件在执行期间都至少满足过一次,该 test step 就会结束。这些条件不一定要在 Multi-Check 的“同一个轮询周期内”满足。

对于时间选项 true for at least 和 true for at least … within,其行为未定义。

下表说明了这种行为:

SUCCESS(成功)的条件: FAILED(失败)的条件:
wait until true(等待直到为真) 每个 test step 都在某个时刻返回过 SUCCESS。 达到超时时间。
true for at least(至少持续为真) 未定义 未定义
true for at least … within …(在……范围内至少持续为真……) 未定义 未定义

对于所有选项,only synchronisation 的行为都与 wait until true 相同,但不会对 Multi-Check 进行评估。

Multi-Check test step 也可以在不指定任何时间选项的情况下使用。在这种情况下,每个 test step 只会被评估一次。