Stimulation package 与 Analysis package¶
使用 stimulation packages(激励 Package)
和 analysis packages(分析包)
后,可以在 Project(测试项目)中将激励与 Trace Analysis(测量轨迹分析)分离。
与把激励和 Trace Analysis 放在同一个 Package 中的常见做法相比,这种方式可提升模块化程度和复用性。
Analysis package 中使用的信号通常会自动分配到对应 stimulation package 的信号组。 因此,如果向 Project 中新增一个使用先前未用到信号的 analysis package,通常无需调整 stimulation package。
Stimulation package(激励 Package)¶
普通 Package 可以在 Project 中作为 stimulation package
使用。
为此,需要将该 Package 作为 stimulation package 引用插入到 Project 中,例如通过 Workspace 浏览器中的上下文菜单,
或通过 Project 编辑器中的工具栏:
通过 Workspace 浏览器(左)或 Project 编辑器(右)插入 stimulation package¶
信号 Recording 必须在 stimulation package 本身内部创建,例如使用 start-trace / stop-trace 步骤。 如果 stimulation package 调用了可提供额外 Recording 的 subpackage,这些 Recording 不会被纳入考虑。
如果 stimulation package 包含一个或多个 Trace Analysis,则它们会在激励执行完成后运行。 这些 Trace Analysis 中包含的信号 Recording 步骤可作为关联 analysis package 的 Recording 来源。
Analysis package(分析包)¶
Analysis packages
可通过 创建,
也可在 Workspace 浏览器中右键并在相应上下文菜单中选择 创建。
它们是独立工件,文件扩展名为 .ta。
新建的 analysis package¶
Analysis package 调用插入到 Project 的方式与普通 Package 调用类似,例如可从 Workspace 浏览器中拖放, 也可通过 Project 编辑器中的工具栏插入。
新插入的 analysis package 会自动与前一个 stimulation package 引用建立关联。 该关联可在 analysis package 调用的 Edit 对话框中修改。
多个 analysis package 可以引用同一个 stimulation package。
Analysis package 会针对对应 stimulation package 的所有 Parameter Set(参数集)自动执行,并使用其提供的 Recording。 根据每个 stimulation package 的 Recording 数量,系统会创建独立的分析作业。 例如,在下列 Project 中,两个 analysis package 都会分别使用这两个 Parameter Set 执行:
执行分析时,系统首先应用相关 analysis package(或相应 Parameter Set)的 Mapping 空间。 如果某个 Mapping 指向通用目标或无效目标,则会继续应用 stimulation package(或相应 Parameter Set)的 Mapping 空间, 以查找有效 Mapping。例如,analysis package 中的通用 Mapping 可以由 stimulation package 的本地 Mapping 解析。
如果在 stimulation package 选择中选用了 <all previous> 选项,则一个 analysis package 可以针对多个激励执行。
此时,只会引用 Project 中位于该 analysis package 调用之前的 stimulation package 调用。
执行期间,报告中会为每个被引用的 stimulation package 调用创建一个包含相应 analysis package 调用的 Project 文件夹。
将信号分配给信号组¶
执行包含 stimulation package 和 analysis package 的 Project 时,ecu.test 会尝试把至少在某个 analysis package 中存在信号连接的 Mapping 自动分配到该激励的信号组,以便这些信号被记录。 系统会按以下优先级从高到低尝试确定合适的信号组:
某个信号组已经提供了该 Mapping。
对于具体 Mapping,名称和目标都必须匹配。
对于 analysis package 的通用 Mapping,只要求名称与 stimulation package 中某个 Mapping 匹配。
某个信号组的名称与被寻址 Mapping 目标的系统标识符一致 (例如“A-FlexRay”)。
某个信号组已经提供了具有相同系统标识符的 Mapping。
对于类型为 “Trace file” 的 Mapping:
如果只有一个信号组,则使用该信号组。
如果 Mapping 目标与某个信号 Recording 步骤中的信号匹配,则使用该信号组。
如果以上规则都无法应用,则必须在 Project 中通过 stimulation package 调用的 Edit 对话框, 将相应信号手动分配给某个信号组:
手动分配的信号会以橙色字体显示;来自 test configuration 中默认 Package 集信号组的自动分配信号会以青绿色显示;未分配信号则以红色显示。
如果 stimulation package 的两个信号组都包含同名 Mapping,则 analysis package 的通用 Mapping 既无法自动解析,也无法手动解析。 此时应调整 stimulation package 中的 Mapping 名称,以消除命名冲突。
特殊信号与 Recording 组¶
Test case 变量
当至少有一个 test case 变量被选中用于 Recording 时,stimulation package 对话框中会显示 test case 变量的 Recording 组。 分配完全基于 Mapping 名称匹配进行。这意味着,如果变量 ‘loopCounter’ 要在 Trace Analysis 中使用, 则必须创建并分配一个同名 Mapping。与前述情况一样,该分配必须是唯一的,也就是说,不能有其他信号组包含名为 ‘loopCounter’ 的 Mapping。
此外,Mapping 项的类型必须为 ‘Trace file’,并且 Mapping 目标必须等于该 test case 变量的名称。
信号 Recording 步骤
对于 stimulation package 的 Trace Analysis 中包含的每个信号 Recording 步骤,都会显示一个额外的 Recording 组。 该分配同样通过 Matching Mapping 完成。因此,analysis package 必须包含一个 Mapping,其 Mapping 目标为已计算并存储的该信号的通用信号名称。
此外,Mapping 项的类型必须为 ‘Trace file’,并且 Mapping 目标必须等于 stimulation package 的 Trace Analysis 中的通用信号名称。
伪信号
对于伪信号的分析,例如来自 ASC 或 BLF 文件的信号 ‘FrameId’,其处理方式与使用已记录的 test case 变量类似。 如果这些信号在 stimulation package 中未分配到某个信号组,则这类信号(trace file 信号)通常无法自动分配到组。 因此,必须在 Project 中修改 stimulation package 引用,并将这些信号手动分配到相应信号组。
如果需要从多个信号组读取该伪信号(例如一个组用于 CAN,另一个组用于 FlexRay),则分配时会发生冲突。 可通过创建多个指向同一目标的 Mapping 来避免该问题,例如 ‘FrameId_CAN’ 和 ‘FrameId_FLX’ 都指向 ‘FrameId’。
在 Analysis package 中使用 stimulation package 的返回值¶
有时需要把 stimulation package 在运行时确定的信息传递给关联的 analysis package。该场景可通过 Package 变量实现。
在 stimulation package 中,每个需要在 analysis package 中访问的变量都必须标记为返回值。
在 analysis package 的 Parameter Set 中,可通过标识符 stim 访问关联 stimulation package 的返回值。
例如,可通过 stim.returnVariable 访问名为 returnVariable 的变量返回值。
为减少赋值工作量,可使用 “Use stimulation return values as standard parameterization” 选项。 启用该选项后,如果 analysis package 的某个参数既没有通过 Parameter Set 赋值,也没有通过 Project 级参数化赋值, 则只要 stimulation 中存在同名返回值,该参数就会自动使用该返回值替换。
信息
返回值是 stimulation package 中最后一次设置的值。变量既可以在 test case 中设置,也可以在后续某个 Trace Analysis 中设置。 在 Trace Analysis 内,必须通过某个 Trace 步骤的返回参数显式设置该值,系统才会将其纳入考虑。
如果多个 Trace Analysis 都设置了该变量的值,则最后执行的 Trace Analysis 中设置的值会成为返回值。 不过,由于各个 Trace Analysis 通常彼此独立运行,因此不建议采用这种做法。
在 Analysis package 中使用 stimulation package 的全局常量值和属性值¶
很多情况下,希望在 stimulation 时设置的全局常量值和属性值也能在 analysis package 中生效。
大多数情况下,只需在 test configuration 中,或通过共同的上级 Project 元素参数化来定义全局常量即可。 但在少数情况下,全局常量只会在 stimulation 中确定并设置。
因此,在执行 stimulation 期间,如果某些全局常量和属性在该时刻尚未定义,或者只在 test configuration 中定义, 则它们的有效值会被接管到 analysis package 的执行上下文中。
请求分析¶
通常,分配给 stimulation package 的所有 analysis package 都会执行。 如果希望实现条件式执行,同时又确保激励中的某些方面由合适的 Trace Analysis 检查, 则可以在该激励的 test case 中“请求分析”。
请求分析时,需要使用 test step Request analysis
,
并为所请求的分析定义一个标签。该标签用于关联请求与相应的 analysis package。
插入 stimulation package 的 Project¶
如果将 stimulation package 拖入 Project,则系统会针对每个请求标签自动生成所谓的 Analysis package mapping steps
。
这些步骤作为实际 analysis package 的占位符,并支持更高级的工作流,详见下一节
Analysis package mapping steps(Analysis package 映射步骤)。
在入门场景下,只需将 Workspace 中的某个 analysis package 拖到某个 analysis package mapping step 上,
即可用实际 analysis package 替换这些占位符。
替换后,占位符会变成具体的 Package 引用,并设置属性 “Implements requested analysis”。
该属性也可在 Project 中现有或新添加的 analysis package 上编辑。
只有在 Project 执行期间实际执行了相应的 test step “Request Analysis” 时, 实现该请求分析的 analysis package 才会执行。例如,这可以通过 If-Then-Else 块控制。 不过,也可以将 analysis package 的 “Implements requested analysis” 选项设置为 “none (always run)”,从而始终执行。
多个 analysis package 可以实现同一个请求分析。 多个 test step 也可以请求同一个分析;这不会产生额外影响。
信息
如果某个 analysis package 调用引用了多个 stimulation package 调用, 则它不能实现某个请求分析。
如果启用 Take over result of analysis 选项,则该 test step 会接收关联 analysis package 的总体判定结果。
信息
注意:如果启用了 Take over result of analysis 选项的 test step Request analyses 后面紧跟一个计算步骤,
并且该步骤通过 api.TestEnvironment.ExecutionInfo.LastTestStepResult 访问上一个 test step 的结果,
则返回值始终为 INCONCLUSIVE。原因是分析结果在 test 执行时尚未确定。
Analysis package 映射步骤¶
使用 Analysis package 映射步骤时的示意工作流¶
Analysis package mapping steps
作为实际 analysis package 的占位符。
如果向 Project 中添加了会请求分析的 stimulation package,系统会自动创建这些步骤。
缺失的步骤可通过 stimulation package 的上下文菜单生成。
顾名思义,Analysis package 映射步骤通过全局 Mapping 来解析 analysis package。 这样便可基于不同的 test configuration 文件(例如针对不同 test bench)对分析进行变体处理。 分配依据是已实现的分析名称,该名称必须与 Mapping 中某个条目的名称一致。
创建 Analysis package Mapping¶
此类 Mapping 条目的类型必须为 ANALYSIS。 可通过将 Workspace 中的 analysis package 插入到全局 Mapping 中,或将其拖入 Mapping 编辑器(见截图)来创建。 如果 analysis package 位于该目录之外,则路径会以相对于 Package 目录的相对路径或绝对路径形式存储。
如果在编辑时无法正确解析 analysis package 映射步骤,Project 编辑器中的检查会给出警告。 不过,真正关键的是在步骤执行时能否加载该 Mapping。例如,这也可以通过配置更改步骤实现。 缺失条目可通过 Project 检查对话框自动创建到全局 Mapping 中,随后必须将这些条目编辑为引用现有 analysis package。
信息
用 analysis package 替换 Analysis package 映射步骤¶
Analysis package 映射步骤之所以能在 Project 中支持 advanced workflow, 是因为它们会受当前已加载配置的 Mapping 影响。 但对于更简单的 Project,直接使用 analysis package 即可。 可以将这些 analysis package 从 Workspace 拖到 Project 的 analysis package 映射步骤上进行替换。
在 test.guide 中查找某个激励的分析¶
为便于在 test.guide 中更轻松地关联激励与分析,系统会为 Project 中 stimulation package 的每次运行创建一个名为 TT_STIMULATION_RUN_ID 的内部全局常量, 其值为 UUID。 该常量会传递给已分配的 analysis package。在 test.guide 中,可在过滤器中使用该常量查找针对某个激励执行过的所有分析。
限制¶
选择性执行模式不适用于包含 stimulation package 和 analysis package 的 Project。
对于 stimulation package 和 analysis package,与普通 Package 一样,既可以使用 Parameter Set,也可以使用 Parameter Set 生成器。
但 Parameter Set 生成器无法向 analysis package 添加 Recording。
此外,analysis package 的 Parameter Set 生成器必须在生成器的 GetUsedMappingItems() 方法中,
定义所有将通过 CycleData.AddMappingItem() 添加到生成 Parameter Set 的 Mapping,
以便 stimulation package 能识别这些 Mapping
(参见 Parameter set generator API(参数集生成器 API))。