Creating stream-based trace step templates(创建基于流的 trace step 模板)¶
创建新 trace step 模板的流程已在 General approach(一般方法) 一节中说明。 虽然各种模板在信号和参数的创建方式上相同,但实际分析指令的实现方式明显不同。
Stream-based trace step 模板允许用户引入自己的 Python 代码,并在每次分析运行时恰好执行一次。
以下示例说明如何将 Recording(测量记录)传递给外部程序:
默认情况下,ecu.test 提供函数 Handle。该函数不得重命名或删除,因为 ecu.test 始终将其作为入口点。
它具有四个参数:
recordingInfos:用于访问当前分析运行中的 Recording(测量记录)。该对象始终是一个列表, 即使当前分析运行中只有一个 Recording(测量记录)也是如此。
dataContainer:用于访问 ecu.test 变量。该对象接口说明见 Trace Analysis API 文档。
parameters:Python 字典,以参数名为键、对应参数值为值。
report:用于访问测试报告。该对象接口说明见 Trace Analysis API 文档。
若要将某项任务传递给外部程序,首先需要确定 Recording(测量记录)的文件名和路径:
for recordingInfo in recordingInfos:
path = recordingInfo.GetPath()
for recordingInfo in recordingInfos 会遍历当前分析运行中的所有 RecordingInfo 对象,
而 recordingInfo.GetPath() 则返回对应 Recording(测量记录)的文件路径。
随后,如需将任务传递给外部程序,可使用 Python 模块 os.system:
import os
cmdLine = '"C:/Programme/Programm.exe" -c "%s"'
...
result += os.system(cmdLine % path)
在本示例中,Recording(测量记录)的路径会以参数 c 传递给程序 Programm.exe。
该程序调用会返回一个结果值(多数情况下,失败返回 0,成功结束返回 1)。
该返回值会累加到变量 result 中。
最后,应根据 result 的值,在测试报告中调整该 trace step 的结果,并输出简短注释。
if result > 0:
report.SetResultId(report.RESULT_ID_ERROR)
report.SetResultText("Some ERRORs occured!")
else:
report.SetResultId(report.RESULT_ID_SUCCESS)
report.SetResultText("All checks SUCCESSful!")
如上所述,可通过 report 对象访问测试报告。函数 SetResultId 用于设定结果,
而函数 SetResultText 会将文本直接写入测试报告(详见
reference(参考))。