Port DIAGNOSTICS - J1939

HIRAIN-HW 通过 CAN 访问 J1939。属于 Add-on ecu.test diagnostics 附加组件。

Stimulation

此端口不具备激励能力。

Name

在以下情况下可用

默认值

有效值

Type

Description

Channel number

‘1’

string

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

Bit rate

‘500KB’

[‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’]

string

Bit rate

Activate terminating resistor

☐

bool

激活内部 120 Ω 终端电阻

J1939 测试仪名称

‘00:00:20:04:00:81:00:20’

string

Address Claim 名称的字节序列(以冒号分隔)

J1939 Tester Source Address

123

int

用于 J1939 Address Claim 的源地址(必须 > 0)。

J1939 TP Priority

6

int

J1939 Connection Mode Datatransfer Protocol 所用控制消息的优先级(值为 0 到 7)。

Transmission confirmation

☐

bool

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

传输确认的超时时间

1000

int

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

ClearDTC

删除所有先前处于活动状态(DM3)和当前活动(DM11)的错误码

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DestinationAddress

string

接收方的数字 ID 或 TLA。使用 0xff 表示广播。

DTC

‘Previously Active’

[‘Active’, ‘Previously Active’]

string

Type of DTC

CloseJ1939MemoryAccessSession

关闭诊断会话

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DestinationAddress

string

接收方的数字 ID 或 TLA。

DTCRequest

请求当前激活(DM1)和先前激活(DM2)的错误码

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DestinationAddress

string

接收方的数字 ID 或 TLA。使用 0xff 表示广播。

DTC

‘Active’

[‘Active’, ‘Previously Active’]

string

Type of DTC

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

收到的 J1939DTCList 对象。

GenericPGNSendReceive

发送用户特定的 J1939 消息,并期望收到带有指定参数的响应消息

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

ReceivePayloadFilterMask

ByteStream

要检查的字节的掩码(ByteStream)

ReceivePayloadFilterValue

ByteStream

报文的 payload 必须接受的字节值(ByteStream)

ReceivePduFormat

0

int

接收到的 PGN 的第一个字节

ReceivePduSpecific

0

int

所接收 PGN 的第二个字节

SendPayload

ByteStream()

ByteStream

要发送的有效载荷;如果 ByteStream 为空,则只进行接收。

SendPduFormat

0

int

要发送的 PGN 的第一个字节

SendPduSpecific

0

int

要发送的 PGN 的第二个字节

SendPriority

0

int

要发送的消息的优先级

Timeout

1

int

等待应答的时间,单位为秒

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

接收到的 J1939Message 对象列表。

GetAvailableTLAs

返回包含所有活动参与者及其源地址和 TLA(三字母缩写)的字典

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

Parameterization

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

Dict {sourceAddress: TLA}

MemoryAccessRequest

发送内存访问请求(DM14),并提供相应的应答(DM15、DM16)

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Command

‘Read’

[‘Erase’, ‘Read’, ‘Write’, ‘Status Request’, ‘Operation Completed’, ‘Operation Failed’, ‘Boot Load’, ‘EDCP Generation’]

string

内存访问类型

DestinationAddress

string

接收方的数字 ID 或 TLA。

Key

65535

int

默认:No Key (0xFFFF)

Length

0

int

取决于指针类型(PT):寻址内存的长度(以字节为单位,PT = 0)或对象数量(PT = 1)

Pointer

0

int

PointerExtension

0

int

PointerType

‘Direct Spatial Addressing’

[‘Direct Memory Addressing’, ‘Direct Spatial Addressing’]

string

WriteData

ByteStream()

ByteStream

“Write” 命令的写入数据

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

接收到的 J1939Message 对象列表。

OpenJ1939MemoryAccessSession

打开一个 J1939 诊断会话(内存访问)并保持其打开状态:每 [timeout] ms 通过 DM14 循环发送指定的消息内容。

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DestinationAddress

string

接收方的数字 ID 或 TLA。

Key

65535

int

默认:No Key (0xFFFF)

Length

0

int

取决于指针类型(PT):寻址内存的长度(以字节为单位,PT = 0)或对象数量(PT = 1)

Pointer

0

int

PointerExtension

0

int

PointerType

‘Direct Spatial Addressing’

[‘Direct Memory Addressing’, ‘Direct Spatial Addressing’]

string

Timeout

80

int

为保持诊断访问而向测试对象发送消息的时间间隔(ms)

Receive

返回具有指定 PduFormat、PduSpecific 以及(如需要)SourceAddress 的最后一条已接收消息

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

PduFormat

int

PduSpecific

int

SourceAddress

int

发送方 ID 或过滤后的 TLA(无过滤时为空)

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

接收到的 J1939Message 对象。

Send

发送自定义 J1939 消息

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

Payload

ByteStream()

ByteStream

请求的负载。

PduFormat

int

PduSpecific

int

Priority

int

StandardPGNRequestResponse

发送标准 PGN 请求并返回响应

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

Parameterization

Parameter

Name

在以下情况下可用

默认值

有效值

Type

Description

DestinationAddress

string

接收方的数字 ID 或 TLA。使用 0xff 表示广播。

Payload

ByteStream()

ByteStream

请求的负载。

返回值

Name

在以下情况下可用

默认值

有效值

Type

Description

Return

object

接收到的 J1939Message 对象列表。