Port DIAGNOSTICS - J1939¶
SOCKETCAN-HW access to J1939 via CAN. Component of the Add-on ecu.test diagnostics
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Interface |
‘1’ |
[‘<online query>’, ‘<no toollib start>’] |
string |
Selection of the CAN interface |
|
Bit rate |
‘500KB’ |
[‘10KB’, ‘20KB’, ‘50KB’, ‘83.333KB’, ‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’] |
string |
Bit rate |
|
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)。 |
Jobs 🛈¶
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 对象列表。 |