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。

参数

参数

说明

备注

--help or -h

[可选] 输出该子命令的使用帮助

列出此命令的全部参数

--workspace WORKSPACE

用于执行的 ecu.test Workspace 路径

绝对路径或相对于 cwd 的路径

--testconfiguration TCF

[可选] 用于执行的测试配置路径

支持绝对路径、相对于 Configurations directory(在 Workspace 设置中指定)的路径,以及格式为 <libraries.namespace.configurations>/Filename.tcf 的库路径。

--testbenchconfiguration TBC

[可选] 用于执行的测试台架配置路径

支持绝对路径、相对于 Configurations directory(在 Workspace 设置中指定)的路径,以及格式为 <libraries.namespace.configurations>/Filename.tbc 的库路径。

--reportdirectory REPORTDIR

[可选] 用于保存报告文件的空目录路径

绝对路径或相对于 cwd 的路径

TARGET

要执行的 Package 或 Project 路径

支持绝对路径、相对于 Packages directory 的路径(在工作区设置中指定),以及格式为 <libraries.namespace.packages>/PackageName.pkg 的库路径。

返回码

使用带 GUI 的 ecu.test 时,该命令会立即返回,且返回码始终为 0。

使用不带 GUI 的 ecu.test 时,日志输出会显示在控制台中;命令会在发生错误后返回(返回码 1),或者在测试完成后根据测试结果返回相应的返回码。

此场景下可能的返回值如下表所示。

返回码

说明

备注

0

执行的测试结果为 SUCCESS 或 NONE

2

执行的测试结果为 INCONCLUSIVE

3

执行的测试结果为 FAILED

4

执行的测试结果为 ERROR

1

执行过程中发生错误,命令未能正确执行。

错误原因可在日志中查看。

信息

在 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 已在运行,则会使用该现有实例。

参数

所有参数都可以组合使用,且对于配置相关参数,通常也应组合使用。

参数

操作

备注

-s "C:/Data/ecu.test/settings"

指定与 %AppData%/tracetronic/ecu.test x.y/ 不同的设置目录(用于 localsettings.xml、各种缓存等)

--toollibsini "C:/.../ToolLibs.ini"

指定其他 ToolLibs.ini

--workspaceDir "C:/.../workspace"

在指定的 Workspace 中启动

  • --startupAutomated True

以自动化模式启动 ecu.test,抑制需要手动操作的对话框

-w

等待已启动的 ecu.test 实例就绪

-c "C:/Data/ecu.test/Configurations/empty.tcf"

加载测试配置

-b "C:/Data/ecu.test/Configurations/local.tbc"

加载测试台架配置

加载配置文件时,在 ecu.test 启动后将直接加载配置,而不会打开测试配置编辑器或测试台架配置编辑器。

-o "C:/Data/ecu.test/Packages/loop.pkg"

打开 Package、Project、测试报告或测试(台架)配置

-u "tracetronic:///C:/Data/ecu.test/Packages/loop.pkg"

以 URL 表示法打开 Package、Project、测试报告或测试(台架)配置

-u "tracetronic:///{ET_WORKSPACE_DIR}/Packages/loop.pkg"

以 URL 表示法打开 Package、Project、测试报告或测试(台架)配置,并使用相对于 Workspace 的路径

打开配置文件时,会根据配置类型打开相应的配置编辑器。

-u "tracetronic:///C:/Data/ecu.test/Testreports/report.trf#231"

以带锚点的 URL 形式打开 Package、测试报告或 test bench configuration

打开测试报告时,可以指定测试报告内部某个 id 的锚点。显示 Report Viewer 后,将自动选中具有该 id 的条目。可以在报告条目的上下文菜单中单击 Copy Link 复制此类 URL。

-r "C:/Data/ecu.test/Packages/loop.pkg" --waitRunFinished

执行已打开的 Package 或 Project,并等待执行完成

--waitRunFinished

等待 Package 或 Project 执行完成

仅可与 -r 组合使用

--start-web-api

启动用于 ecu.test code 的 web API

既可在启动 ecu.test 时指定,也可在控制已运行的 ecu.test 实例时指定。

-q or --quit

退出正在运行的 ecu.test 实例

-k or --kill

强制退出正在运行的 ecu.test 实例

返回码

如果 ecu.test 进程因错误而终止,则会返回一个不为 0 的返回码:

返回码

说明

备注

0

命令执行成功

1

执行期间发生错误,例如启动实例时超时

错误原因可在日志中查看

8

无法启动新实例

例如,该端口上已有实例在运行

99

缺少许可证

示例

所有路径始终都必须按平台特定方式指定。

例如,在 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。