Creating stream-based trace step templates(创建基于流的 trace step 模板)

创建新 trace step 模板的流程已在 General approach(一般方法) 一节中说明。 虽然各种模板在信号和参数的创建方式上相同,但实际分析指令的实现方式明显不同。

Stream-based trace step 模板允许用户引入自己的 Python 代码,并在每次分析运行时恰好执行一次。

以下示例说明如何将 Recording(测量记录)传递给外部程序:

../../../../../_images/TraceStepTemplates_PythonStreamBasedExample.png

默认情况下,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(参考))。