使用 trace step 模板

在资源管理器视图左侧的 Trace step templates 标签页中,可以通过上下文菜单或拖放将 Trace step 模板添加到 trace analysis 中。

Trace step 模板本身以文件形式管理在目录中,其目录内容显示在 Trace step templates 选项卡中。这里提供隐式 library workspace 的数据集 StandardTraceStepTemplates(参见 Standard trace step templates 章节)以及 Templates。在 Templates 下配置的用户自定义目录可在 Options ‣ Settings ‣ Directories 中修改。

../../../../_images/InsertTraceStepTemplate.png

通过拖放添加新的 trace step 模板

将测量轨迹步骤模板添加为测量轨迹步骤时,需要对信号和值参数进行参数化。信号部分允许将输入和输出信号链接到通用信号。如果信号名称以粗体显示,则必须为该信号绑定一个通用信号。如果信号不是粗体,则通用信号的绑定是可选的。如果已将通用信号绑定到测量轨迹步骤模板的信号,则在解析 Mapping 或在 Recording 中查找该信号时不得出现任何问题;否则,测量轨迹分析将以错误终止。

Info

未加粗的信号可以有可选绑定(trace step 模板的设置)。对于 这些信号,列 Optional 中会显示一个复选框。该复选框 表示该信号是可选存在的。如果绑定到 trace step 信号的通用信号 出现问题,不会报告错误。此时该信号会被视为在 Recording 中没有采样点。 仅当预期该信号在特定情况下可能缺失于 Recording 中时,才应使用此选项。

可以为输入信号指定物理单位。通用信号的值在传递到 trace step 模板内的分析之前, 会先转换为指定的单位。 自动单位转换仅适用于包含单位信息的通用信号。该单位 信息可以直接存储在文件中(MDF 格式),也可以在加载了 总线数据库的情况下为二进制文件确定。计算信号(trace step 的输出信号)没有单位。 如果为某个在前面的 trace step 中计算的输入信号指定单位,则会 导致错误。

任何有效的 Python 表达式都可以作为传入参数(即方向为 IN 的参数), 特别是可以使用变量名。 在基于 Python 的 trace step 模板中,返回值(即方向为 OUT 的参数) 可以关联到每个已有变量。该变量将在后续片段(episode)中保存新 赋予的值。

若在 trace step 模板中为输入参数配置了默认值,则使用该模板时,只要该参数的值分配为空(“None”),就会采用此默认值。若为该参数分配了显式值,则显式值优先于已配置的默认值。

Info

为了保证行为明确,使用输入参数和输出参数时存在一定限制(与信号类似)。如果变量值由基于 Python 的 trace step 模板的返回值设置,则不允许在同一 episode 内对该变量进行读取访问。因此,使用该变量的后续 trace step 必须放在 新的 episode 中。例外情况是单个 trace step 对变量的更新,即单个 trace step 允许将同一变量同时关联到输入参数和输出参数。

此外,trigger block 内不允许使用带返回值的基于 Python 的 Trace step 模板。

../../../../_images/TraceStepTemplateConfiguration.png

以默认 trace step 模板 “CalculateMinMax”为例说明 trace step 模板的参数化

在 Report settings for spots 区域中配置报告中找到的 spot。一个 spot 由时间戳和关联的消息组成。在 时序图 中,spot 会自动生成,用于在 Trace 中处理时序图(未)满足时找到的 spot(取决于设置)。使用 基于事件的 Python trace step 时,用户可以通过 API 方法 ReportSpot(time, message) 定义 spot。

选项 Maximum number 定义报告中最多显示多少个标记点 (从第一个标记点开始)。设置项 Minimum distance 指定报告中两个 相继找到的标记点之间的最小时间间隔:若某标记点的时间戳与前一个标记点的时间戳之差 小于该最小距离,则不在报告中显示该标记点。 若最小距离内的标记点判定比先前在报告中显示的最差判定更差, 仍会报告这些标记点。

如果各个 Trace 步骤模板不应在 Trace Analysis 中执行,可以通过上下文菜单(右键单击)或快捷键 <Space> 将其禁用:

../../../../_images/TracestepDisable.png

禁用 trace step 模板