State Model(状态机模型)

要使用 ecu.test code Library,必须先了解可能的状态及其状态切换。相关状态包括 uninitialized(未初始化)、initialized(已初始化) 和 running(运行中)。根据当前状态不同,可用功能也不同。例如,必须先使用 ToolAccess.job("tool/myJob") 注册 job,之后才能调用。下方状态图说明了不同状态下可用的功能。

状态切换方式

状态切换可通过以下两种方式完成:

说明

即使使用显式状态切换方式(不使用上下文管理器),如果由于意外错误(未捕获异常、强制终止等)导致 Python 进程结束,ecu.test 也会检测到连接已断开,并自动将其内部状态恢复为初始状态,就像调用了 ToolAccess.deinit() 一样。这样可避免 ecu.test 在后续会话中保持不一致状态。

显示 Uninitialized(未初始化)、Initialized(已初始化)和 Running(运行中)状态之间切换关系的状态图

ecu.test code Library 的状态机模型,展示了各状态及其切换关系。

示例

下面给出这两种状态切换方式的简短示例。

基于上下文管理器的状态切换

from ecutest.toolaccess import ToolAccess

with ToolAccess().init() as ta:  # -> initialized
   job = ta.job("PORT/MyJob")
   with ta.run():               # -> running
      result = job(1, 2)
   # leaving run context -> initialized
# leaving init context -> uninitialized

显式状态切换

from ecutest.toolaccess import ToolAccess

ta = ToolAccess()            # uninitialized
ta.init()                    # -> initialized
job = ta.job("PORT/MyJob")
ta.run()                     # -> running
result = job(1, 2)
ta.stop()                    # -> initialized
ta.deinit()                  # -> uninitialized