Diagnostics 标签页¶
信息
诊断功能只能配合 Add-on ecu.test diagnostics 使用
Diagnostics 标签页提供对控制单元诊断功能的符号化访问。
要使用该标签页,必须先加载包含诊断数据库的测试配置(参见 Control units tab(控制单元标签页))。根据所选数据库文件的格式不同, 诊断标签页可提供 execute DIAG-SERVICE、read fault memory、DID read、 DID write、execute IOControl 和 Routine Control 等 test step(测试步骤)。为了尽可能获得最佳的 符号化诊断支持,建议选择标准化的 ODX 格式作为数据库。
如果使用 stepwise execution in simulation time(仿真时间中的步进执行),这些 test step(测试步骤)会被设计为每次执行时都继续推进模型执行。
支持的数据库格式
Open Diagnostic Data Exchange Format (ODX):
ODX 或 PDX 文件中包含的所有诊断服务,都会以通用的 DIAG-SERVICE test step(测试步骤)形式提供,可在 Package(测试包)中执行。这些服务会按各自的服务标识符分组,并以树状结构展示。
诊断协议(UDS/KWP2000)会自动从数据库中解析。
为了提取 DTC,还会额外提供 Read fault memory test step(读取故障内存测试步骤)。
Global Diagnostic Data Export (GDX, MDX)、CANdela Diagnostic Data (CDD):
GDX、MDX 或 CDD 文件中包含的已选诊断服务,会以专用 test step(测试步骤)的形式提供,例如 Read fault memory、Read DID、Write DID、IOControl 和 Routine Control,用于在 Package(测试包)内执行。
诊断协议(UDS/KWP2000)也会自动从数据库中解析。
诊断标签页的第一级节点对应于控制单元。如果某个控制单元在 Test Configuration 中分配了诊断数据库和诊断端口, 该控制单元就会显示。如果不存在这样的控制单元,诊断标签页将保持为空。
test step(测试步骤)execute DIAG-SERVICE
该 test step(测试步骤)是对诊断数据库中各项服务的通用表示。
可通过拖放或右键将该 test step(测试步骤)添加到 Package(测试包)中。在这两种情况下,都会打开 Execute dialog(执行对话框)。
其参数对应请求参数,返回值对应肯定响应中的返回参数。
对于每个返回值,都可以在 Values in 列中选择 BITS、TEXT 或 PHYS 之一作为显示形式。关于各种表示形式的详细信息,参见 Representation(表示形式) 章节。
响应可以保存在 Save response 对话框中。返回的对象要么是 DiagServiceResult,要么是 NegativeResponse。
响应异常或超时会导致该 test step 被评定为 ERROR。
否定响应可在 Negative Response 标签页中进行评估。
test step(测试步骤)read fault memory
Read fault memory 操作会调用 UDS (ISO 14229) 服务 Read DTC Information (SID $19)。可通过 Fault Memory 节点的上下文菜单(鼠标右键) –> 插入该 test step(测试步骤),也可以将其拖入 test case(测试用例)中。
随后会出现新的 Read fault memory 窗口,可在其中对该 test step(测试步骤)进行参数化配置。 Request 区域用于定义子功能,并在需要时定义状态掩码。 状态掩码既可以直接输入,也可以在下拉菜单中勾选各个位来构建, 还可以取自 test case(测试用例)变量或其他表达式。
结果可以通过 Save value 选项存储到变量中。根据诊断响应不同,返回值可能是以下类型之一:
- api:
根据所选子功能返回列表 DTCListDiagResult 中的某个对象
NegativeResponse 对象:否定 UDS 响应(例如 ECU 不支持该服务)
DiagResult 对象:其他错误后的结果(例如超时)
信息
与大多数其他 test step(测试步骤)不同,Read fault memory test step(测试步骤)即使被评估为 ERROR,仍会将值存入变量。
在 Comparison 标签页下的 Evaluation 标签中,可以检查或容忍 DTC。此外,还可以设置 DTC 的表示形式。
Check DTCs 选项提供了一个列表,用于筛选期望出现或不应出现的 DTC。
这既可以通过搜索对话框中的加号按钮完成,也可以通过
From list 选项完成。在 From list 文本输入框中,可以
输入一个 Introduction in Python(Python 简介) 表达式,该表达式可以引用 test case(测试用例)变量和/或
api.GlobalConstants。表达式求值后的结果必须是一个 DTC 列表。列表中的每个 DTC
既可以是与所选 Representation 对应的字符串或数字,也可以是
DTCAndStatusRecord 对象。
后者允许复用此前调用该 test step(测试步骤)时存入变量中的
DTCListDiagResult 对象。
Tolerate DTCs 选项用于处理那些不应被明确期望为存在或不存在、但其存在可以被容忍的 DTC。可以选择容忍所有其他 DTC(勾选 ),也可以显式指定一个列表(与 Check DTCs 下的方式相同)。
可在相应标签页下设置 Time Options(时间选项)。
test step(测试步骤)DID-read、DID-write 和 IOControl
许多 DID 可以通过 UDS (ISO 14229) 服务 Read Data By Identifier(SID $22)读取。 对此,使用的是仅包含返回值的专用 test step(测试步骤)。 而写入则可以通过多种方式完成:
某些 DID 支持 Write Data By Identifier(SID $2E),在 ecu.test 中, 这是通过仅包含输入参数的专用 test step(测试步骤)完成的。
对于其他 DID,必须使用 Input/Output Control By Identifier(SID $2F)。在这种情况下, 可将以下部分或全部模式作为 test step(测试步骤)使用: 、、 和 。
test step(测试步骤)的参数可以指定为 PHYS 或 TEXT。PHYS 表示整数或浮点数值,例如 “42” 或 “3.14”。TEXT 例如可用于 ID 或版本号, 如 “‘XA05’”,也可用于字节序列,例如身份验证时传输证书或 challenge 时使用的字节流, 如 “ByteStream(‘0a:0b:0c’)”。字节序列的返回值同样会以 TEXT 形式作为 ByteStream 返回。
在 情况下,可以指定目标值;所有模式 有时还接受一个位掩码作为最后一个参数,用于说明只影响与该 DID 关联的数据结构中的一部分。 当前值始终还会额外作为返回值提供。
当结合对返回值的期望使用 Time Options(时间选项) 时, Input/Output Control By Identifier(SID $2F)只会在初始阶段调用;后续评估时, 返回值则通过 Read Data By Identifier(SID $22)获取。
上述所有 test step(测试步骤)与平时一样,都可以通过 DID 的上下文菜单创建,也可以将 DID 拖入 test case(测试用例)中创建。有关读取、写入和执行对话框的更多信息,请参见 Read / Write / Execute / Stimulus dialog(读取 / 写入 / 执行 / 激励对话框) 章节。
test step(测试步骤)execute Routine Control
Execute Routine Control 操作会调用 UDS (ISO 14229) 服务 Routine Control (SID $31)。将某个 routine control 拖入 test case(测试用例)后,会打开执行对话框。更多信息请参见 Execute dialog(执行对话框) 章节。如果控制单元没有响应,或返回否定响应,该 test step(测试步骤)会被评估为 ERROR。错误原因会记录在报告中。
信息
routine 的结果(子功能 0x03,requestRoutineResults)可以通过时间选项 wait-until-true 等待。为支持这种情况,否定响应码(NRC)0x24(requestSequenceError)会被转换为 ~NotPresent~。
复杂结构
要访问结构中的元素,可以使用类似常见编程语言中的属性表示法。对于基础数据类型的元素,仍可像平常一样编写期望条件。
数组中的单个元素可通过其对应索引访问,索引写在方括号中。
ODX 表具有特殊作用,因为表在 ODX 中采用特殊映射方式。表结构表示实际期望的参数化内容,但它并不具有静态唯一类型。其类型由所引用表键的值动态决定。因此,表结构参数的自动补全会随着表键参数选择的不同而变化。