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(读取故障内存测试步骤)。

../../_images/NeueDiagnose.png

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)也会自动从数据库中解析。

../../_images/AlteDiagnose.png

诊断标签页的第一级节点对应于控制单元。如果某个控制单元在 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 标签页中进行评估。

../../_images/NegativeResponse.png

test step(测试步骤)read fault memory

Read fault memory 操作会调用 UDS (ISO 14229) 服务 Read DTC Information (SID $19)。可通过 Fault Memory 节点的上下文菜单(鼠标右键) –> Read 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(勾选 All others),也可以显式指定一个列表(与 Check DTCs 下的方式相同)。

可在相应标签页下设置 Time Options(时间选项)。

../../_images/DiagnoseDTC.png

test step(测试步骤)DID-read、DID-write 和 IOControl

许多 DID 可以通过 UDS (ISO 14229) 服务 Read Data By Identifier(SID $22)读取。 对此,使用的是仅包含返回值的专用 Execute test step(测试步骤)。 而写入则可以通过多种方式完成:

某些 DID 支持 Write Data By Identifier(SID $2E),在 ecu.test 中, 这是通过仅包含输入参数的专用 Execute test step(测试步骤)完成的。

../../_images/DiagnoseDIDReadWrite.png

对于其他 DID,必须使用 Input/Output Control By Identifier(SID $2F)。在这种情况下, 可将以下部分或全部模式作为 Execute test step(测试步骤)使用: Return control to ECU、Reset to default、 Freeze current state 和 Short term adjustment。

../../_images/DiagnoseDIDIOCtrl.png

write test step(测试步骤)的参数可以指定为 PHYS 或 TEXT。PHYS 表示整数或浮点数值,例如 “42” 或 “3.14”。TEXT 例如可用于 ID 或版本号, 如 “‘XA05’”,也可用于字节序列,例如身份验证时传输证书或 challenge 时使用的字节流, 如 “ByteStream(‘0a:0b:0c’)”。字节序列的返回值同样会以 TEXT 形式作为 ByteStream 返回。

在 Short term adjustment 情况下,可以指定目标值;所有模式 有时还接受一个位掩码作为最后一个参数,用于说明只影响与该 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~。

复杂结构

要访问结构中的元素,可以使用类似常见编程语言中的属性表示法。对于基础数据类型的元素,仍可像平常一样编写期望条件。

../../_images/DiagnoseStruktur.png

数组中的单个元素可通过其对应索引访问,索引写在方括号中。

../../_images/DiagnoseArray.png

ODX 表具有特殊作用,因为表在 ODX 中采用特殊映射方式。表结构表示实际期望的参数化内容,但它并不具有静态唯一类型。其类型由所引用表键的值动态决定。因此,表结构参数的自动补全会随着表键参数选择的不同而变化。