Port DIAGNOSTICS - CAN

ETAS-BOA-HW Diagnostics

提供基于 ISO-TP 的 CAN 原始诊断访问。若要基于诊断描述文件(如 ODX 或 CDD)进行符号化诊断,则需要 Add-on ecu.test diagnostics。

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel number

‘1’

string

当存在多个同类型控制器时,用于选择通道号。

Bit rate

‘500KB’

[‘10KB’, ‘20KB’, ‘50KB’, ‘83.333KB’, ‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’]

string

Bit rate

Mode

Standard

[Standard, Extended, All]

string

寻址模式(Standard = 11bit,Extended = 29bit)

仅监听

☐

bool

控制器运行在被动模式。自动 ACK 已禁用,无法发送 CAN 帧。

接收错误帧

☐

bool

接收错误帧

Transmission confirmation

☐

bool

启用确认式发送。Bus-Write test step 和 Send 工具作业会阻塞,直到报文成功传输到总线上或确认超时到期。

传输确认的超时时间

1000

int

消息必须在此时间段(毫秒)内成功发送。否则会产生错误。(不得大于 64535ms)。仅在主动确认模式下使用。

AuthenticationConfiguration

Authentication (0x29) AuthenticationConfiguration:Authentication (0x29) authenticationConfiguration (0x08):表示服务器所提供的认证配置。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationConfigurationResult - 或 NegativeResponse

AuthenticationDeauthenticate

Authentication (0x29) DeAuthenticate:Authentication (0x29) deAuthenticate (0x00):请求退出已认证状态

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationDeauthenticateResult - 或 NegativeResponse

AuthenticationProofOfOwnership

Authentication (0x29) ProofOfOwnership:Authentication (0x29) proofOfOwnership (0x03):校验来自客户端的所有权证明。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

EphemeralPublicKeyClient

ByteStream

客户端为 Diffie-Hellman 密钥协商生成的临时公钥。 ByteStream

ProofOfOwnershipClient

ByteStream

对先前给出的质询的所有权证明,由服务器校验。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationProofOfOwnershipResult - 或 NegativeResponse

AuthenticationVerifyCertificateUnidirectional

Authentication (0x29) VerifyCertificateUnidirectional:Authentication (0x29) verifyCertificateUnidirectional (0x01):通过验证证书来启动认证。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

CertificateClient

ByteStream

要验证的证书。ByteStream

ChallengeClient

ByteStream

challenge(质询)包含整车厂特定格式的客户端数据(可能包含随机化信息),或者是一个随机数。此参数记录用于将该 challenge 传输到服务器。 ByteStream

CommunicationConfiguration

int

有关在 Authentication 之后如何在进一步的诊断通信中处理安全性的配置信息。

注 1 该信息与响应消息数据参数 sessionKeyInfo 是否存在及其内容相关。该参数的格式、会话密钥的生成以及证明值的计算均由整车制造商自行决定。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - AuthenticationVerifyCertificateUnidirectionalResult - 或 NegativeResponse

CallService

执行诊断服务请求。

示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Request

ByteStream

要发送的诊断服务请求(ByteStream)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - :

CallServiceFunctional

以功能寻址方式执行诊断服务请求。

示例:要调用 UDS 服务 Read Data by Identifier(SID=0x22,DID=0xACDC),Request 为 ByteStream(“22 AC DC”)

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Request

ByteStream

要发送的诊断服务请求。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

诊断结果列表(:)。

ClearDTCs

ClearDiagnosticInformation (0x14):清除一个或多个服务器内存中的诊断信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

GroupOfDTC

0xFFFFFF

int

要清除的 DTC 或 DTC 组的编号(默认值:0xFFFFFF = 所有 DTC)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

CloseSession

关闭诊断会话。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

DiagnosticSessionControl

DiagnosticSessionControl (0x10):在服务器中启用不同的诊断会话。注意,切换诊断会话可能导致 ECU 复位。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SessionType

int

要发送的诊断会话。1: DefaultSession, 2: ProgrammingSession, 3: ExtendedDiagnosticSession, 4: Safety SystemDiagnosticSession

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagnosticSessionControlResult - 或 NegativeResponse

ECUReset

ECUReset (0x11):请求服务器复位。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Subfunction

int

要执行的复位子功能

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - ECUResetResult - 或 NegativeResponse

InputOutputControlByIdentifier

InputOutputControlByIdentifier (0x2F):用某个值替代输入信号、服务器内部函数,和/或强制将电子系统的输出(执行器)控制在某个值上。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ControlEnableMaskRecord

ByteStream

位掩码,用于指定 shortTermAdjustment 时要调整的参数。ISO 14229-1 规定仅当 DID 由多个参数组成时才使用。

ControlStateRecord

ByteStream

Control 类型 “shortTermAdjustment” 的 DataRecord

DataIdentifier

int

Identifier

InputOutputControlParameter

int

根据 ISO 14229-1 附录 E.1 的控制类型:

0 = returnControlToECU,

1 = resetToDefault,

2 = freezeCurrentState,

3 = shortTermAdjustment

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - InputOutputControlByIdentifierResult - 或 NegativeResponse

OpenDiagSession

打开使用 ISO-TP 的 UDS 诊断会话。若已存在使用指定参数的会话,则返回现有会话的句柄,而不是打开新会话。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

AddressByte

ByteStream

网络目标地址或地址扩展(仅与扩展寻址或混合寻址相关) - 长度为 1 的 ByteStream

AddressMode

0

int

寻址模式代码 - 整数(0:标准寻址 | 1:扩展寻址)

BlockSize

0

int

可连续接收而无需中间流控的帧数(0 - 255) - Integer

DiagTimeoutCanIsoTp

2000

int

通过 ISO-TP 协议等待诊断请求响应时的超时时间,单位为毫秒 - 整数

FillByte

ByteStream

用于填充报文的字节(可选) - 长度为 1 的 ByteStream

FlowControlAddressByte

ByteStream

FlowControl 使用不同的网络目标地址或地址扩展(仅与扩展寻址和混合寻址相关)- 长度为 1 的 ByteStream

FlowControlId

int

流控消息的消息 ID(可选)- 十六进制(可选整数)

IsExtended

-1

int

是否使用扩展 CAN-ID 格式?(1=是 / 29 位;0=否 / 11 位;-1 = 使用 TBC 中的设置)

IsExtendedFlowControlId

-1

int

是否使用扩展 CAN ID 格式(用于 FlowControlId)?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

IsExtendedRequestId

-1

int

是否对 RequestId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

IsExtendedResponseId

-1

int

是否对 ResponseId 使用扩展 CAN ID 格式?(1=是/29 位;0=否/11 位;-1 = 使用与 IsExtended 相同的设置)

RequestId

int

ECU 请求的报文 ID - 十六进制(可选,整数)

ResponseId

int

ECU 响应的消息 ID - 十六进制(可选 Integer)

SeparationTime

0

int

连续片段之间的最小时间间隔 0x00..0x7F => 0..127ms,0x80..0xf0 => 保留,0xf1..0xf9 => 100.900µs,0xfa..0xff => 保留 - 整数

StartRequest

ByteStream

用于打开会话的诊断请求(可选) - ByteStream

StopRequest

ByteStream

用于结束会话的诊断请求(可选) - ByteStream

TesterPresentCycleTime

int

周期性 tester-available 信令的周期长度(ms,可选)- Integer

TesterPresentRequest

ByteStream

用于周期性 tester-available 信号的诊断请求(可选)- ByteStream

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionHandle

int

诊断会话的句柄

OpenTcfDiagSession

打开在 TCF 中配置的诊断会话。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SUT

object

诊断会话的句柄。可以是 TCF 中指定的 SUT 名称,或 None。仅当只指定了一个 SUT 时才能使用 None。

ReadDataByIdentifier

ReadDataByIdentifier (0x22):按一个或多个 dataIdentifier 从服务器请求数据记录值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DataRecordDiagResult - 或 NegativeResponse

ReadMemoryByAddress

ReadMemoryByAddress (0x23):允许客户端通过提供的起始地址和要读取的内存大小向服务器请求内存数据。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

MemoryAddress

int

内存地址

MemorySize

int

要读取的数据长度

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - MemoryDiagResult - 或 NegativeResponse

ReportDTCByStatusMask

ReadDTCInformation (0x19) reportDTCByStatusMask (0x02):该参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的 DTC 列表及相应状态。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportDTCFaultDetectionCounter

ReadDTCInformation (0x19) reportDTCFaultDetectionCounter (0x14):此参数指定服务器应向客户端发送当前“prefailed”DTC 的列表,这些 DTC 已被或尚未被检测为“pending”或“confirmed”。

DTCFaultDetectionCounter 的用途是提供一种简单方法,用于识别某个特定 DTC 的 statusOfDTC 字节无法识别/读取的渐进性问题或间歇性问题。DTCFaultDetectionCounter 的内部实现应视车辆制造商而定(例如字节数、有符号还是无符号等),但报告的值应为缩放后的 1 字节有符号值,使得 +127 (7F16) 表示测试结果为 “failed”,而任何其他非零正值表示测试结果为 “prefailed”。但 DTCFaultDetectionCounter 值为 +127 的 DTC 不应按下述规则报告。每次测试逻辑运行并指示该次测试运行失败时,DTCFaultDetectionCounter 应按车辆制造商规定的量递增。

报告的 DTCFaultDetectionCounter 值大于零且小于 +127(即 0116 至 7E16)表示已满足 DTC 启用条件,并且未完成的测试结果至少在一个条件或阈值上处于 prefailed 状态。

只应报告 DTCFaultDetectionCounter 为小于 +127 (7F16) 的非零正值的 DTC。

每当测试逻辑运行并指示该次测试通过时,DTCFaultDetectionCounter 应按整车制造商规定的数值递减。如果 DTCFaultDetectionCounter 递减到零或以下,则不应再在肯定响应报文中报告该 DTC。DTCFaultDetectionCounter 的值不应在操作循环之间保持。

若收到 ClearDiagnosticInformation 服务请求,则所有 DTC 的 DTCFaultDetectionCounter 值均应重置为零。其他重置条件应由车辆制造商定义。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCFaultCounterDiagResult - 或 NegativeResponse

ReportDTCSnapshotIdentification

ReadDTCInformation (0x19) reportDTCSnapshotIdentification (0x03):此参数规定,服务器应向客户端发送所有 DTCSnapshot 数据记录标识 [DTC 编号与 DTCSnapshot 记录编号]。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCSnapshotIdentificationDiagResult - 或 NegativeResponse

ReportDTCSnapshotRecordByDTCNumber

ReadDTCInformation (0x19) reportDTCSnapshotRecordByDTCNumber (0x04):此参数规定服务器应向客户端发送与客户端定义的 DTC 编号和 DTCSnapshot 记录编号相关联的 DTCSnapshot 记录(FF16 表示所有记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DoExtendedInterpretation

False

[False, True]

bool

如果要以解释后的形式返回快照数据,则为 True,否则为 False。解释通过额外的 ReadDataByIdentifier 调用(0x22)完成。仅适用于固定长度的数据标识符值。默认值:False

DTCMaskRecord

object

DTC 标识符:3 字节值,包含 DTCHighByte、DTCMiddleByte 和 DTCLowByte,三者共同构成要报告的诊断故障码的唯一标识号。例如 0x123456 或 SAE J2012 P-code:“P1234-56”

DTCSnapshotRecordNumber

int

DTC 快照记录编号:要检索其 DTC 快照记录数据的指定 DTC 的特定发生实例。若应报告所有已记录的快照,请指定 0xFF。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCSnapshotRecordDiagResult - 或 NegativeResponse

ReportDTCWithPermanentStatus

ReadDTCInformation (0x19) reportDTCWithPermanentStatus (0x15):此参数规定,服务器应向客户端发送具有“permanent DTC”状态的 DTC 列表。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportEmissionsOBDDTCByStatusMask

ReadDTCInformation (0x19) reportEmissionsOBDDTCByStatusMask (0x13):该参数规定,服务器应向客户端发送与排放相关的 OBD DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。所报告的 OBD DTC 列表应仅包含需要符合排放相关法规要求的 DTC。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportFirstConfirmedDTC

ReadDTCInformation (0x19) reportFirstConfirmedDTC (0x0C):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个已确认 DTC。

通过该 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被重置,则无论之后又有哪些其他 DTC 变为已确认,服务器都应继续保留第一条已确认的 DTC 记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportFirstTestFailedDTC

ReadDTCInformation (0x19) reportFirstTestFailedDTC (0x0B):此参数规定服务器应向客户端发送自上次清除诊断信息以来服务器检测到的第一个失败的 DTC。注意,通过此 SubFunction 参数报告的信息与 DTC 是否已确认或已老化无关。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMirrorMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportMirrorMemoryDTCByStatusMask (0x0F):该参数规定,服务器应向客户端发送从 DTC 镜像存储器中取出的 DTC 列表以及与客户端定义的状态掩码相匹配的相应状态。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMostRecentConfirmedDTC

ReadDTCInformation (0x19) reportMostRecentConfirmedDTC (0x0E):此参数指定服务器应向客户端发送自上次清除诊断信息以来检测到的最新已确认 DTC。

请注意,通过此 SubFunction 参数报告的信息应独立于已确认 DTC 的老化过程(例如,如果某个 DTC 老化到其状态允许被复位,则在之后没有其他 DTC 变为已确认的情况下,服务器应继续保留第一条已确认 DTC 记录)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportMostRecentTestFailedDTC

ReadDTCInformation (0x19) reportMostRecentTestFailedDTC (0x0D):此参数规定,服务器应向客户端发送自上次清除诊断信息以来服务器检测到的最新一次失败的 DTC。请注意,通过此 SubFunction 参数报告的信息应与该 DTC 是否已确认或已老化无关。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportNumberOfDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfDTCByStatusMask (0x01):该参数规定,服务器应向客户端传输与客户端定义的状态掩码相匹配的 DTC 数量。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportNumberOfEmissionsOBDDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfEmissionsOBDDTCByStatusMask (0x12):此参数指定服务器应向客户端发送与客户端定义的状态掩码相匹配的排放相关 OBD DTC 数量。所报告的 OBD DTC 数量应仅为那些需要与排放相关法规要求兼容的 DTC。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportNumberOfMirrorMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportNumberOfMirrorMemoryDTCByStatusMask (0x11):该参数规定,服务器应向客户端发送镜像存储器中与客户端定义的状态掩码相匹配的 DTC 数量。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCNumberDiagResult - 或 NegativeResponse

ReportSupportedDTCs

ReadDTCInformation (0x19) reportSupportedDTC (0x0A):此参数规定服务器应向客户端发送服务器内支持的所有 DTC 及对应状态的列表。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DTCListDiagResult - 或 NegativeResponse

ReportUserDefMemoryDTCByStatusMask

ReadDTCInformation (0x19) reportUserDefMemoryDTCByStatusMask (0x17):此参数规定,服务器应向客户端发送用户自定义 DTC 存储区中的 DTC 及其状态列表,这些状态需与客户端定义的状态掩码匹配。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

MemorySelection

int

用户定义的 DTC 存储器:只检索存储在所选存储器中的 DTC。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

StatusMask

0xFF

int

状态掩码:仅查询至少设置了掩码中所指定状态位之一的 DTC。(默认值:0xFF = 任意状态)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - UserDTCListDiagResult - 或 NegativeResponse

RequestDownload

RequestDownload (0x34):用于发起从客户端到服务器的数据传输(下载)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataFormatIdentifier

00

ByteStream

指定对要发送的数据所用压缩(高半字节)和加密(低半字节)方法。值 0 表示不压缩也不加密。其他所有值均由制造商定义。 ByteStream

MemoryAddress

ByteStream

要写入数据的服务器内存起始地址。ByteStream

MemorySize

ByteStream

TransferData 作业要发送的数据大小。如果对数据使用了压缩,则此参数是指压缩后数据的大小还是未压缩数据的大小取决于制造商。ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - RequestDownloadResult - 或 NegativeResponse

RequestTransferExit

RequestTransferExit (0x37):客户端用它结束客户端与服务器之间的数据传输(上传或下载)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

RoutineControl

RoutineControl (0x31):客户端使用 RoutineControl 服务执行已定义的步骤序列,并获取相关结果。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

hasRoutineInfo

[False, True]

bool

optional

RoutineId

int

例程的 ID

RoutineOptionRecord

ByteStream

例程参数(可选) ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Subfunction

1

int

子功能:Start (0x01)、Stop (0x02)、Request (0x03)

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - RoutineDiagResult - 或 NegativeResponse

SecurityAccessRequestSeed

SecurityAccess (0x27) requestSeed:请求具有车辆制造商所定义安全级别的种子。此外还可以指定一个 Seed&Key 库,用于计算与所获种子对应的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Options

object

要传递给 Seed&Key 库的选项字符串(可选 - str)。如果 Options 为 None,则调用库函数 GenerateKeyEx()。如果 Options 是字符串,则调用库函数 GenerateKeyExOpt(),即使是空字符串也是如此。

SecurityAccessDataRecord

ByteStream

请求 seed 信息时额外传输的数据(可选)。ByteStream

SecurityLevel

int

要解锁的安全级别,0x01 与 0x7D 之间的奇数

SeedAndKeyLibraryPath

string

用于计算与所获得种子对应的密钥的 Seed&Key 库路径(可选)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

Variant

string

要传递给 Seed&Key 库的 ECU 变体限定符(可选)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - SecurityAccessDiagResult - 或 NegativeResponse

SecurityAccessSendKey

SecurityAccess (0x27) sendKey:发送带有车辆制造商定义的安全等级的密钥。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SecurityKey

ByteStream

用于解锁所需安全级别的密钥。如果 SecurityAccessRequestSeed Job 使用了 Seed&Key 库,则计算出的密钥会在 SecurityAccessRequestSeed Job 的结果中返回。否则必须事先根据 SecurityAccessRequestSeed Job 结果中返回的 seed 计算出密钥。ByteStream

SecurityLevel

int

要解锁的安全级别,0x02 到 0x7E 之间的偶数(= SecurityAccessRequestSeed 的 SecurityLevel + 1)

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - DiagResult - 或 NegativeResponse

SetDiagTimeout

设置诊断会话的超时时间。注意:如果在诊断请求进行期间设置超时,时序行为可能不可预测。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DiagTimeout

int

超时时间(ms)。如果将该值设置为 None,则在打开会话时,超时时间会重置为初始值。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SetFlowControlCTS

激活后,将始终发送流控制“ContinueToSend”消息来响应分段请求。此外,还可以为内部参数 BlockSize 和 SeparationTime 赋予新值。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

BlockSize

int

可连续接收而无需中间流控的帧数(0 - 255) - Integer

如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。

SeparationTime

int

连续片段之间的最小时间间隔 0x00..0x7F => 0..127ms,0x80..0xf0 => 保留,0xf1..0xf9 => 100.900µs,0xfa..0xff => 保留 - 整数

如果为 None,则保留来自测试配置、OpenDiagSession 作业或上一次 SetFlowControlCTS 调用的最新设置。

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

SetFlowControlWait

激活后,对分段请求始终发送流控 “Wait” 消息。注意:激活期间无法接收任何分段消息。使用 Job SetFlowControlCTS 重置此行为。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

WaitTimeInterval

0

int

等待时间间隔,单位为 ms。如果设为 0,则只发送一次流控制“Wait”消息以响应分段请求。如果设为大于 0 的值,则按给定间隔周期性发送流控制“Wait”消息。

SetTesterPresent

更改测试配置中为周期性发送的 TesterPresent 报文指定的参数。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

TesterPresentCycleTime

int

周期性发送请求的周期长度(ms)。若将周期长度指定为 0,则停用周期性发送

TesterPresentRequest

ByteStream()

ByteStream

循环发送的报文的数据载荷

TransferData

TransferData (0x36):客户端用于传输数据,既可从客户端到服务器(download),也可从服务器到客户端(upload)。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

BlockLength

int

一个块内可传输的最大数据量。包含相应块的服务 ID 和序列计数器。- int

FlashData

ByteStream

要传输的总数据。该作业会根据块长度参数中指定的值自动拆分数据。 ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - TransferDataResult

WriteDataByIdentifier

WriteDataByIdentifier (0x2E):允许客户端在服务器中由所提供的数据标识符指定的内部位置写入信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataIdentifier

int

Identifier

DataRecord

ByteStream

要写入的数据记录 ByteStream

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - WriteDataByIdentifierResult - 或 NegativeResponse

WriteMemoryByAddress

WriteMemoryByAddress (0x3D):WriteMemoryByAddress 服务允许客户端向服务器的一个或多个连续内存位置写入信息。

此作业属于 Add-on ecu.test diagnostics。

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DataRecord

ByteStream

要写入的数据 ByteStream

MemoryAddress

int

要写入数据的起始地址

MemorySize

int

要写入的字节数

SessionId

object

诊断会话的句柄。这可以是 TCF 中指定的 SUT 名称、由 OpenDiagSession job 返回的句柄,或 None(仅当只指定了一个 SUT 时可用)。

Timeout

int

诊断系统中止等待诊断响应之后的超时时间(ms,可选) - 必须大于发送确认超时时间

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

DiagResult

诊断服务调用的结果 - WriteMemoryByAddressResult - 或 NegativeResponse