General approach(一般方法)¶
在 ecu.test 中,trace step 模板可以采用以下几种类型。 这些类型的 trace step 可以在同一个 Trace 分析中组合使用。
通常,trace step 模板会作为目录中的文件进行管理,这些目录内容会显示在左侧 Explorer 视图的 Trace step templates 标签页中。 系统提供 My templates 和 Default templates 两个类别。 My templates 对应的目录可以在 中修改。 在 ecu.test 中,可以在该目录下创建任意层级的子文件夹,以便对 trace step 模板进行分组 (参见图 Creating a (sub)folder in the trace step template directory(在 trace step 模板目录中创建文件夹或子文件夹))。
在 trace step 模板目录中创建文件夹或子文件夹¶
单击 New trace step template 按钮即可创建新的 trace step 模板。 选择 Python event-based 或 Python stream-based 时,会打开用于编辑 trace step 模板的对话框。
该对话框包含以下四个区域:
Common,
Signals,
Parameter,以及
Analysis instruction。
选择 NumPy array-based 时,会显示一个类似的对话框,但它实际上是一个向导。 填写完成并单击 Generate 后,系统会生成并打开一个 Python 源文件,实际的分析指令可在其中实现。
创建 Timing diagrams 时,会显示另一个包含多个面板的对话框:工具箱 Element properties、Parameters 和 Assignments,以及用于将时序图建模为分析指令的实际工作区。 关于时序图编辑器的详细说明,请参见 timing diagram manual(时序图手册), 因此后续章节不再展开介绍。
编辑一个基于 Python 事件的 trace step 模板¶
- Description
Description 可用于说明该 trace step 模板的一般功能。
Info
如果在使用该 trace step 模板时未填写专门的说明,报告中将显示第一段内容 (即直到第一个空行为止的文本)。
- Signals
Signals 用于定义该 trace step 模板中应使用的信号。 第一列中的信号名称可以自由指定,并且应尽量做到见名知意。
在第二列中,每个信号可定义为输入信号(IN),即后续可以为其分配一个现有信号,并且只能被读取;或者定义为输出信号(OUT),即通过方法 dataContainer.EmitSignal 创建。 创建后即可通过名称访问,并可继续供后续 trace step 模板使用(另请参见章节 Signal processing with trace steps(使用 trace step 进行信号处理))。
在第三列中,可以通过勾选复选框将某个信号标记为 Optional。 该列仅对输入信号有效。 在这种情况下,后续使用时不一定必须为其分配一个泛型信号。 这样可以使 trace step 模板更加灵活,例如在一组相似应用中部分信号并不总是可用时,就可以避免创建大量仅有细微差异的模板。
Info
如果用户之后决定使用这样的可选信号,则必须为其分配一个完全可用的泛型信号。 如果分配的信号存在问题,ecu.test 会报告错误(ERROR 报告条目)。 可能的问题包括 Mapping 损坏,或在 Trace 分析的 Signal connection 区域中遗漏了信号绑定。
不过,用户也可以将该具体信号绑定标记为 optionally present。 这会明确告知 ecu.test:根据配置或 Recording 的不同,在解析 Mapping 或在 Trace 中查找该信号时可能出现问题 (例如某个特定测试台架并未测量该信号)。 设置该选项后,即使该信号存在问题,Trace 分析仍会启动。 此时系统会按该信号没有采样值来处理。
第四列用于填写信号的可选说明。 单击省略号按钮会打开一个对话框,可在其中输入文字说明。
Info
此处无需也不能确定具体信号。 只有在后续实际使用该 trace step 模板时,才会与泛型信号建立连接。
- Parameters
Parameters 部分用于尽可能提高 Trace step 模板的可复用性。通过它可定义参数,以便在后续使用时为 Trace step 模板赋予具体值。参数区域同样分为五列。
第一列中的参数名称可以自由指定。
在第二列中,每个参数可定义为输入参数(IN),即后续可以为其分配一个值或 Package 变量;或者定义为输出参数(OUT),即在执行 trace step 模板时生成一个值,并可将其赋给 Package 变量。
这些值可以是有效的 Python 表达式,尤其可以包含变量名 (来自 Variables 标签页)。 在后续对 trace step 模板进行参数化时,可以使用任何有效的 Python 表达式进行值赋值。因此, 参数类型(可在第三列中选择 “INTEGER”、 “FLOAT”、“STRING”、“BOOLEAN” 或 “PYOBJECT”)仅用于表达模板创建者的 预期。
第四列 Default value 可用于为传入参数定义可选的默认值。该列的输入控件取决于所选的参数类型。 值为空表示未配置默认值。
使用模板时,仅当参数值赋值为空(“None”)时才应用此默认值。
与信号一样,参数也可以在最后一列中填写说明。
- Analytical instruction
定义信号和参数的目的,是在 trace step 模板的实现中使用这些已定义的名称(Analytical instruction)。 不同模板类型如何实现这一点,将在后续章节中说明。