工具类别¶
工具类别按主题划分,提供 ecu.test 的可配置标准接口。每个工具类别都可以读取描述文件,并提供便于配置特定测试步骤的对话框,以及用于执行和生成测试报告的功能。
Model access - 模型仿真¶
工具类别“模型访问”用于在 HiL 中执行的测试。 现有组件的系统环境通过实时模型进行仿真。
与在实车中测试等方式相比,HiL 环境为仿真事件提供了明显更好的条件。为生成 test case,提供了用于读取和修改模型量的 test step。
适用的外设软件:
此外,模型访问还用于 MiL 和 SiL 工具,例如:
MATLAB/Simulink (MiL)
FMI tool adapter(SiL)
Usage:
Application - 应用访问¶
工具类别 application 允许通过测量和标定这两种方式,对参与测试的现有控制单元进行应用访问。测量提供用于读取控制单元内部量的测试步骤,而标定则既提供对系统常量的读取访问,也提供对特性曲线和特性图的读写访问。
测量与标定中的分类遵循 ASAM MCD-2MC (ASAP2) 标准,该标准 区分测量量和标定量。
使用的周边软件:
Usage:
诊断 - 诊断通信¶
Diagnostics 工具类别提供在 ECU 上执行诊断服务的选项。 这些服务可用于查询状态值、控制组件以及读取 故障存储器。
此工具类别的功能有三种不同用法:
Diagnostics
通过这种访问方式,可以经 CAN 执行 UDS 诊断。通信基于对硬件相关总线连接的支持。除硬件接口的设备驱动程序外,无需其他软件。在 Diagnostics tab 下可查看各功能概览。
支持以下协议标准:
UDS (ISO 14229-1)
KWP2000 (ISO 14230)
ISO-TP (ISO 15765-2)
DoIP (ISO 13400)
FlexRay TP (AUTOSAR FrTp, ISO 10681-2)
OBD DTC Definitions (ISO 15031-6 / SAE J2012)
SAE J1939
Info
诊断功能只能配合 Add-on ecu.test diagnostics 使用
Diagnostics(EDIABAS)
该访问类型专为 basic EDIABAS 设计。 在Diagnostics(EDIABAS) 标签页下可查看功能概览。
Diagnostics(DTS)
此访问模式支持对诊断工具 Softing: DTS 进行符合 ASAM MCD-2D/3D 的控制。 在 Diagnostics(DTS) 标签页 下可找到功能概览。
基于 ISO-TP 的 KWP2000 原始诊断¶
此外,接近硬件的 CAN 总线连接允许通过 ISO-TP (ISO 15765-2) 使用 KWP2000 执行诊断。为此,相应的诊断总线端口提供 端口作业 OpenKwp2000overIsoTpSession、CallService 和 CloseSession
首先调用 port job OpenKwp2000overIsoTpSession。需要输入的参数是请求 ID 和响应 ID(用于诊断请求和响应的 CAN 报文 ID)。其他所有参数都是可选的。该调用的返回值用作刚打开的诊断会话的标识特征,后续调用 CallService 和 CloseSession 时必须使用它;因此应将其保存在变量中。
为了调用诊断功能,现在要调用端口作业 CallService。除会话 ID(由工具作业 OpenKwp2000overIsoTpSession 作为返回值返回)之外,还需要以 ByteStream 的形式输入一个 request。可选地可以输入超时时间 (单位 ms)。返回值是一个 DiagResult 对象。
端口 Job CallService 的执行会立即完成,即使诊断请求的发送或响应的等待仍在后台进行。只有在读取 DiagResult 时,才必须等待结果出现。
总线通信¶
工具类别 bus access 提供在总线系统上发送和接收 PDU 所需的功能。这在测试分布在多个控制器上的功能时尤为必要。
适用的外设软件:
Usage:
贴近硬件的总线工具适配器提供了一些附加功能:
自动 E2E 计算¶
对于 E2E 配置文件 1、2、4、5 和 7,ecu.test 提供自动计算 E2E 信号 Data-ID(-Nibble)、DataLength、Counter 和 CRC(如果适用于相应配置文件)的选项。为此,请在 Test Bench Configuration 中设置一个占位值,并在 test case 中把该值赋给需要自动填充的那些 E2E 信号。
Mini 残余总线仿真¶
对于 CAN、CAN FD 和 FlexRay,可使用有限残余总线仿真。为此,需要 在测试台架配置中创建类型为 BUSACCESS 的端口, 其实现类型分别为 CAN、CAN-FD 或 FLX。在 测试配置中应将其选为操控点。
现在,在 Bus access 标签页 上,可以为 PDU 选择选项 Change PDU timing,以激活该 PDU 的循环发送。借助 Change PDU timing 可以改变循环时间,并激活或停用该 PDU 的循环发送。PDU 的内容可以随时修改(也可以在开启循环发送之前),方法是借助 Write 修改某些信号(参见 章节 Bus access 标签页)。
PDU 使用配置的数据周期性发送。可以在不重启循环的情况下更改配置。同时,PDU 的激活状态保持不变。
计算得到的帧和信号
使用 Mini residual bus simulation 时,在针对 CAN、CAN FD 或 FlexRay 的 test step Write signal group 中,可以指定一个用于确定帧或信号值的 python 对象。借助该对象,可以动态计算有效的信号值(例如用于校验和或存活计数器信号)。
计算类必须用 Python 实现,并且必须存放在 用户自定义 Python 函数 目录下名为 BusCalcFunctions 的子目录中。 在 Bus Access 标签页 中右键单击某个 PDU 并选择 Create calculation classes,即可自动生成计算类的骨架。 请参考生成的代码,了解必须如何实现该类。
帧计算对象只能用于 Mini 残余总线仿真。
要为特定 PDU 使用此类的实例,请在测试步骤 Change PDU timing 的输入框
Calculation object 中指定。(例如
user.BusCalcFunctions.MyProject.MyCalculationObjects.Calculate_MyFrame(),前提是该类定义在
名为 MyProject 的项目和名为 MyCalculationObjects 的模块中,且
名为 Calculate_MyFrame。project 是可选参数,由
BusCalcFunctions 中的子目录表示)
如果只想为特定信号指定用于计算原始值的计算对象, 请在测试步骤 Write 或 Write signal group 中指定。
关于访问计算类(例如进行实例化),请参见 用户自定义 Python 函数。
Info
包含计算类的脚本必须存放在 BusCalcFuncitons 中。要将计算类链接到 Project,可以将它们存放在子目录中。此时,目录名与 Project 名称相对应。
Info
含计算类的脚本会在每次 Package 执行开始时导入 ecu.test,因此此时它们必须已经存在。
支持带多路复用器的 PDU
如果使用带多路复用器的 CAN、CANFD 或 FlexRay PDU,则可以通过不同方式设置多路复用器 值:
可以在计算类中相应的信号计算方法里进行设置。
可以在 Package 中显式写入(通过 Write signal group)。之后,PDU 会以该多路复用值发送,直到新值将其覆盖。
使用已激活 PDU 的多路复用器值。若激活了多个 PDU, ecu.test 会循环使用它们各自的多路复用器值。
Info
只有位于已激活 PDU 中的信号才会被发送。不过,当发送某个动态部分 PDU 时,静态部分 PDU 的信号始终会一并发送。
Info
如果仅激活多路复用帧的静态部分 PDU,则会隐式激活所有至少配置了一个信号值的动态部分 PDU。
Info
仅当多路复用信号在帧内连续时, 才支持嵌套多路复用器。
复杂信号流的 Mini 残余总线仿真
作为 Mini residual bus simulation 的扩展,可以基于激励文件在总线上创建复杂的信号流。这些信号流可以使用 Signal Editor 创建。要将总线信号与激励文件中的信号连接起来,需使用 test step Start Stimulus。请注意,只有在一次 test step 调用中属于同一总线的信号才能组合,输入信号和输出信号均如此。所有信号值都视为物理值。必须注意,相关总线信号的 Mapping 元素必须已设置 Manipulation 选项。要启用或禁用 PDU,必须使用 test step Change PDU timing。使用 empty segment 时,信号原始值会设为 0。
贴近硬件的总线连接的附加功能¶
读取带附加信息的帧
端口作业 ReadFrameEx 返回 CanFrame、FlexRayFrame 或 LinFrame 对象, 可将其保存到变量中。之后可以(例如通过计算步骤)访问下面列出的属性。 并非所有实现都会填充所有属性槽。如果相应属性无法由实现求值,也可能出现 0 和 False 值。
将消息流式传输到收件箱
端口类型 BUSACCESS 与实现类型 CAN、FLX 和 LIN 组合时,提供 端口 job RegisterFrameForInbox 和 DeregisterFrameForInbox。 通过这些 job,当硬件通过 Tool Server 连接时,可将一条或多条报文与一个需创建为变量的 inbox 建立关联,或相应取消该关联。注册后,从总线接收的报文会自动归入 inbox 数据结构,并可从那里处理(参见 Inbox 与“Read from inbox”)。 这样便可在 test case 中无损地评估报文。除了报文的标识符(这些标识符在 CAN、CANFD 和 FlexRay 中各不相同,并作为 job 描述保存)之外,job RegisterFrameForInbox 还包含参数 saveAsCanFrame、saveAsFlxFrame 或 saveAsLinFrame。若启用该参数,报文将分别保存为 CanFrame、 FlexRayFrame 或 LinFrame 对象。 否则仅将报文的载荷保存为 ByteStream 对象。
原始诊断
请参见章节 基于 ISO-TP 的 KWP2000 原始诊断。
服务访问¶
服务访问工具类别可用于访问 SOME/IP 服务,支持使用方法、事件及其参数。
适用的工具适配器:
Info
ControlDesk Service Manager 只能读写叶子元素。
Usage:
服务仿真¶
除了访问控制单元提供的服务之外,ecu.test 本身也可以提供服务,供被测控制单元使用。
为此,首先必须生成 python 模块,这些模块 实现各相关服务所提供的方法和事件的行为。 通过编辑这些模块,可以调整行为:
对于每个方法和事件,其输入和输出参数的结构记录在实现该方法的头文件中。可以从输入参数中提取数据,并向初始为空的输出参数中填充值。
可以设置周期性事件的时间间隔。
可以向 ServiceInstance 类添加自己的方法以更改数据或行为,之后可以在测试用例中 调用这些方法。
随后可使用 service API 控制该仿真。
在测试台架配置中,可以选择随测试用例自动启动的仿真服务(无需调用相应的 API 函数),并设置仿真在其启动时所在的测试用例结束后继续运行。
Info
目前,模拟服务仅在相应工具适配器使用 local 工具连接时可用,而不适用于基于 Tool Server 的连接。
Info
如果提供的服务不同且 IP 地址不同,Send event or Provide method 和 Service-Simulation 可以同时使用。
低层仿真
有时需要仿真 SOME/IP 之外的其他网络服务。为此,较低网络层的端口提供作业 StartSendPacketCyclic。通过该作业,可以周期性地发送自定义字节序列。定义负载有两种方式:可以传入静态的 ByteStream 对象(例如 ByteStream('11:22:33')),也可以传入自定义对象。对于第二种情况,必须在 WORKSPACE/UserPyModules/CyclicPayloadFunctions/ 下的 *.py 文件中定义一个可调用类。在下面的示例中,在 WORKSPACE/UserPyModulesCyclicPayloadFunctions/SimpleCyclicFunction.py 中创建了一个类。
from tts.lib.dataStructures.ByteStream import ByteStream
class SimpleCyclicFunction:
def __init__(self, a="11", b="22", c="33"):
self.a = a
self.b = b
self.c = c
def __call__(self, *args, **kwargs):
return ByteStream("{0}:{1}:{2}".format(self.a, self.b, self.c))
作为 payload,现在可以传入如下实例
user.CyclicPayloadFunctions.SimpleCyclicFunction.SimpleCyclicFunction('11', '22', '33')。
创建该类时必须确保在使用参数时指定了默认值。
此外必须重写 __call__ 方法并返回一个 ByteStream 对象。
Debugging¶
调试工具类别用于访问调试器工具。
适用的外设软件:
Usage:
功能访问¶
工具类别 function access 允许同步/异步执行简单的外部 函数(例如来自 DLL 的函数)。作为参数和返回值,仅支持基本数据类型和字符串。
Configuration:
Usage:
故障仿真¶
故障模拟是指在控制器中制造电气故障。这些故障通常以故障存储器条目的形式显示。可以模拟的故障包括:
传感器/执行器导线中断或接触不良
对地或对电源短路
通过公共汇流排连接引脚
Configuration:
Usage (EES):
Usage (FIU):
特定测试步骤¶
工具类别 test steps 提供广泛的测试功能,例如通过 loop、暂停和条件执行进行测试运行控制、数据操作、用于测试结构化的 test step、在硬件引脚上创建电气故障以及其他特定实现。所有 test step 都是同名工具类别的专门组成部分。这样便可轻松实现更多用户特定功能,并以插件形式集成到现有的 ecu.test 安装中。
Usage:
多媒体访问¶
工具类别 “Multimedia access” 提供对视频设备的访问,例如网络摄像头。 可以比较图像和图像的一部分,使用用户定义的滤波器进行处理,并保存在 报告中。
Configuration:
Usage:
Extension:
Environment Simulation 访问¶
对于复杂驾驶员辅助系统和自动驾驶的测试,测试方法和测试工具 面临着新的要求。 因此,车辆环境仿真的重要性持续提升。 借助环境仿真工具,可以对环境建模并在测试中使用。
该环境通常由以下部分组成:
路线(道路几何、路面、路标、交通信号灯、树木、…)
涉及的参与者(自车、其他车辆、行人等)
各交通参与者的具体动作或操作(例如切入场景)
工具类别“Environment simulation access”用于启动、配置、参数化和控制环境仿真工具。
Configuration:
Usage:
环境通信访问¶
环境通信访问工具类别通过接收基于报文的通信来提供对环境信息的访问。
Configuration:
Usage: