ecu.test 的远程控制¶
目前,可通过以下不同软件方式自动执行 ecu.test:
所有这些机制在内部都会通过本地网络连接访问正在运行的 ecu.test 实例。
该连接默认使用端口 8000。
如果该端口已被其他程序占用,则可以通过手动创建注册表值来配置其他端口号:
为此,需要创建一个 DWORD 值 xmlrpcPort,用于指定所需的端口号,创建位置为
HKEY_LOCAL_MACHINE/Software/tracetronic/ecu.test 2026.3
如果希望该设置区别于系统范围配置,并仅对单个用户生效,请使用 HKEY_CURRENT_USER 分支,而不是 HKEY_LOCAL_MACHINE。
在 Windows 下,明确提供以下两种变体:
带图形用户界面的实例:ecu.test.exe
作为控制台应用程序的 Runner: ecu.test_runner.exe
命令行(批处理接口)¶
可以使用命令行自动启动并控制 ecu.test。例如,可以指定并加载 Test Configuration(测试配置,TCF)和 Test Bench Configuration(测试台架配置,TBC),也可以打开并执行 Package 或 Project。
ecu.test 的命令行接口可在 Windows、Linux 或 Docker 容器中使用。
执行 Package(测试包)或 Project(测试项目)¶
可使用子命令 execute 通过一次调用启动 ecu.test,执行一个 Package 或 Project,然后再次退出 ecu.test。
参数¶
参数 |
说明 |
备注 |
|---|---|---|
|
[可选] 输出该子命令的使用帮助 |
列出此命令的全部参数 |
|
用于执行的 ecu.test Workspace 路径 |
绝对路径或相对于 |
|
[可选] 用于执行的测试配置路径 |
支持绝对路径、相对于 Configurations directory(在 Workspace 设置中指定)的路径,以及格式为 |
|
[可选] 用于执行的测试台架配置路径 |
支持绝对路径、相对于 Configurations directory(在 Workspace 设置中指定)的路径,以及格式为 |
|
[可选] 用于保存报告文件的空目录路径 |
绝对路径或相对于 |
|
要执行的 Package 或 Project 路径 |
支持绝对路径、相对于 Packages directory 的路径(在工作区设置中指定),以及格式为 |
返回码¶
使用带 GUI 的 ecu.test 时,该命令会立即返回,且返回码始终为 0。
使用不带 GUI 的 ecu.test 时,日志输出会显示在控制台中;命令会在发生错误后返回(返回码 1),或者在测试完成后根据测试结果返回相应的返回码。
此场景下可能的返回值如下表所示。
返回码 |
说明 |
备注 |
|---|---|---|
|
执行的测试结果为 SUCCESS 或 NONE |
|
|
执行的测试结果为 INCONCLUSIVE |
|
|
执行的测试结果为 FAILED |
|
|
执行的测试结果为 ERROR |
|
|
执行过程中发生错误,命令未能正确执行。 |
错误原因可在日志中查看。 |
信息
在 Windows 命令行中,可使用 echo %errorlevel% 查看最后执行命令的返回码。
示例¶
所有路径始终都必须按平台特定方式指定。
例如,在 Windows 下,命令可以如下所示:
ecu.test execute --workspace C:/Data/ecu.test --testbenchconfiguration local.tbc --testconfiguration myTCF.tcf myPackage.pkg
在 Linux 下,示例命令如下:
ecu.test execute --workspace /home/Data/ecu.test --testbenchconfiguration sub/local.tbc --testconfiguration myTCF.tcf subFolder/myPackage.pkg
控制 ecu.test 实例¶
可以通过命令行使用配置以及一个 Package 或 Project 自动启动 ecu.test,然后执行该对象。如果 ecu.test 已在运行,则会使用该现有实例。
参数¶
所有参数都可以组合使用,且对于配置相关参数,通常也应组合使用。
参数 |
操作 |
备注 |
|---|---|---|
|
指定与 |
|
|
指定其他 ToolLibs.ini |
|
|
在指定的 Workspace 中启动 |
|
|
以自动化模式启动 ecu.test,抑制需要手动操作的对话框 |
|
|
等待已启动的 ecu.test 实例就绪 |
|
|
加载测试配置 |
|
|
加载测试台架配置 |
加载配置文件时,在 ecu.test 启动后将直接加载配置,而不会打开测试配置编辑器或测试台架配置编辑器。 |
|
打开 Package、Project、测试报告或测试(台架)配置 |
|
|
以 URL 表示法打开 Package、Project、测试报告或测试(台架)配置 |
|
|
以 URL 表示法打开 Package、Project、测试报告或测试(台架)配置,并使用相对于 Workspace 的路径 |
打开配置文件时,会根据配置类型打开相应的配置编辑器。 |
|
以带锚点的 URL 形式打开 Package、测试报告或 test bench configuration |
打开测试报告时,可以指定测试报告内部某个 id 的锚点。显示 Report Viewer 后,将自动选中具有该 id 的条目。可以在报告条目的上下文菜单中单击 Copy Link 复制此类 URL。 |
|
执行已打开的 Package 或 Project,并等待执行完成 |
|
|
等待 Package 或 Project 执行完成 |
仅可与 |
|
启动用于 ecu.test code 的 web API |
既可在启动 ecu.test 时指定,也可在控制已运行的 ecu.test 实例时指定。 |
|
退出正在运行的 ecu.test 实例 |
|
|
强制退出正在运行的 ecu.test 实例 |
返回码¶
如果 ecu.test 进程因错误而终止,则会返回一个不为 0 的返回码:
返回码 |
说明 |
备注 |
|---|---|---|
|
命令执行成功 |
|
|
执行期间发生错误,例如启动实例时超时 |
错误原因可在日志中查看 |
|
无法启动新实例 |
例如,该端口上已有实例在运行 |
|
缺少许可证 |
示例¶
所有路径始终都必须按平台特定方式指定。
例如,在 Windows 下,命令可以如下所示:
ecu.test.exe --workspaceDir C:/Data/ecu.test
在 Linux 或 Docker 容器中,示例命令如下:
ecu.test --workspaceDir /home/Data/ecu.test
rem start ecu.test with indicated configuration
start ecu.test.exe
timeout /T 10
ecu.test.exe -w
timeout /T 5
ecu.test.exe -c "C:/Data/ecu.test/Configurations/empty.tcf" -b "C:/Data/ecu.test/Configurations/local.tbc"
rem wait for started ecu.test to be ready
ecu.test.exe -w
rem open package....
ecu.test.exe -o "C:/Data/ecu.test/Packages/DrivingCycle.pkg"
rem execute package....
ecu.test.exe -r "C:/Data/ecu.test/Packages/DrivingCycle.pkg"
rem further actions possible
rem quit ecu.test
ecu.test.exe -q
Runner 作为控制台应用程序¶
除了 GUI 变体之外,ecu.test_runner 还提供了一个更快的控制台应用程序,无需图形用户界面。
这在执行速度方面具有明显优势,尤其适用于测试自动化场景。
使用 Runner 的命令行可以如下所示:
ecu.test_runner execute --workspace C:/Data/ecu.test myPackage.pkg
通过命令行安装外部 Python 库¶
外部 Python 库 也可以通过命令行安装,例如:
ecu.test_runner task install-python-libraries --workspace C:/Data/ecu.test --timeout 90
COM API¶
除了通过批处理文件进行非常简单的控制外,ecu.test 还提供了一个 COM 服务器,可提供更丰富的控制和信息查询能力。
ecu.test COM 接口的命令已在 COM API 的 API 文档中做了详细说明。此外,在 <installation path>/Help/api/ExampleCOM 中还通过以下两个示例演示了 COM 接口的使用方式。
Excel: 通过 ecu.test COM 接口执行一个 Package,并将结果插入 Excel 表格。
C#: 通过 ecu.test COM 接口执行一个 Package。
信息
安装时必须启用 ecu.test 的 COM 服务器注册。
否则 COM API 将不可用。
如果已卸载其他版本的 ecu.test,则 COM API 对剩余版本仍可使用,但必须在
Dispatch 调用中显式提供版本号——例如 win32com.client.Dispatch('ecu.test.Application.2026.3'),或
win32com.client.Dispatch('ECU-TEST.Application.2023.3')(适用于 2023.4 之前的版本)
如果再次启动安装程序并分别选择 “change” 或 “repair” 选项,也可以重新执行 COM 服务器注册。如果这样仍无效,还可通过命令行手动执行 COM 服务器注册:
~ecu.test program folder~/ecu.test_COM.exe /register
若要执行系统范围的注册,需要管理员权限。或者,也可以通过附加选项 /peruser 仅为当前用户执行注册。此时命令如下:
~ecu.test program folder~/ecu.test_COM.exe /register /peruser
信息
有关 COM API 的补充信息,请参见 API references(API 参考)
REST API¶
为了对 ecu.test 的测试执行进行远程控制,系统提供了一个基于 OpenAPI 的 REST API,作为 COM API 的替代方案。
有关 REST API 的补充信息,请参见 API documentation(API 文档)。
ecu.test execution plugin(ecu.test 执行插件)¶
ecu.test execution plugin 可在持续集成服务器 Jenkins 中实现对 ecu.test 和 Tool Server 的便捷集成与控制。
有关该插件安装与配置的更多信息,请参见该项目的 Github-Repository。