Port DIAGNOSTICS - J1939 🛈¶

VECTOR-HW access to J1939 via CAN. Component of the Add-on ecu.test diagnostics

Stimulation¶

This port has no stimulus capabilities.

Properties 🛈¶

Name	Default value	Valid values	Type	Description
Channel number	‘1’		string	Selection of channel number if there is more than one controller of same type.
Bit rate	‘500KB’	[‘10KB’, ‘20KB’, ‘50KB’, ‘83.333KB’, ‘100KB’, ‘125KB’, ‘250KB’, ‘500KB’, ‘666.667KB’, ‘800KB’, ‘1000KB’]	string	Bit rate
J1939 Tester Name	‘00:00:20:04:00:81:00:20’		string	Byte sequence for the Address Claim name (separated by a colon)
J1939 Tester Source Address	123		int	Source address used for the J1939 Address Claim (must be> 0).
Transmission confirmation	☐		bool	Activates acknowledged sending. Bus-Write test steps and Send tool jobs block until the message was successfully transferred on the bus or the confirm timeout expired.
Timeout for transmission confirmation	1000		int	Period in miliseconds in which a message has to be sent successfully. Otherwise an error is created. (must not be larger than 64535ms). Is only used in active confirm mode.

Jobs 🛈¶

ClearDTC¶

Deletes all previously active (DM3) and active (DM11) error codes

Parameter

Name	Available if	Default value	Valid values	Type	Description
DestinationAddress				string	Numeric Id or TLA of the receiver. Use 0xff for broadcast.
DTC		‘Previously Active’	[‘Active’, ‘Previously Active’]	string	Type of DTC

CloseJ1939MemoryAccessSession¶

Closes the diagnostic session

Parameter

Name	Available if	Default value	Valid values	Type	Description
DestinationAddress				string	Numerical ID or TLA of the receiver.

DTCRequest¶

Request of active (DM1) and previously active (DM2) error codes

Parameter

Name	Available if	Default value	Valid values	Type	Description
DestinationAddress				string	Numeric Id or TLA of the receiver. Use 0xff for broadcast.
DTC		‘Active’	[‘Active’, ‘Previously Active’]	string	Type of DTC

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	List of J1939 objects

GenericPGNSendReceive¶

Sends a user-specific J1939 message and expects the response message with the specified parameters

Parameter

Name	Default value	Type	Description
ReceivePayloadFilterMask		ByteStream	Mask for the Byte to be checked (ByteStream)
ReceivePayloadFilterValue		ByteStream	Byte values which the payload of the message must accept (ByteStream)
ReceivePduFormat	0	int	First byte of the received PGN
ReceivePduSpecific	0	int	Second byte of the received PGN
SendPayload	ByteStream()	ByteStream	Payload for sending, if the ByteStream is empty, it is only received.
SendPduFormat	0	int	First byte of the PGN to be sent
SendPduSpecific	0	int	Second byte of the PGN to be sent
SendPriority	0	int	Priority of the message to be sent
Timeout	1	int	Time in seconds to wait for answers

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	J1939 message object

GetAvailableTLAs¶

Returns a dictionary of all active participants with their source address and their TLA (Three Letter Acronym)

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	Dict {sourceAddress: TLA}

MemoryAccessRequest¶

Sends a memory access request (DM14) and provides the corresponding answers (DM15, DM16)

Parameter

Name	Default value	Valid values	Type	Description
Command	‘Read’	[‘Erase’, ‘Read’, ‘Write’, ‘Status Request’, ‘Operation Completed’, ‘Operation Failed’, ‘Boot Load’, ‘EDCP Generation’]	string	Type of memory access
DestinationAddress			string	Numerical ID or TLA of the receiver.
Key	65535		int	Default: No Key (0xFFFF)
Length	0		int	Depending on Pointer Type (PT) the length of the addressed memory in bytes (PT = 0) or the number of objects (PT = 1)
Pointer	0		int
PointerExtension	0		int
PointerType	‘Direct Spatial Addressing’	[‘Direct Memory Addressing’, ‘Direct Spatial Addressing’]	string
WriteData	ByteStream()		ByteStream	Write data for “Write” command

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	List of received J1939Message objects

OpenJ1939MemoryAccessSession¶

Opens a J1939 diagnostic session (memory access) and keeps it open, by sending the specified message content cyclically via DM14 every [timeout] ms.

Parameter

Name	Default value	Valid values	Type	Description
DestinationAddress			string	Numerical ID or TLA of the receiver.
Key	65535		int	Default: No Key (0xFFFF)
Length	0		int	Depending on Pointer Type (PT) the length of the addressed memory in bytes (PT = 0) or the number of objects (PT = 1)
Pointer	0		int
PointerExtension	0		int
PointerType	‘Direct Spatial Addressing’	[‘Direct Memory Addressing’, ‘Direct Spatial Addressing’]	string
Timeout	80		int	Time in ms in which a message is sent to the test object to maintain diagnostic access

Receive¶

Returns the last received message with the specified PduFormat, PduSpecific and if required the SourceAddress

Parameter

Name	Type	Description
PduFormat	int
PduSpecific	int
SourceAddress	int	Sender ID or the filtered TLA (empty if no filter)

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	J1939 message object

Send¶

Sends a custom J1939 message

Parameter

Name	Default value	Type	Description
Payload	ByteStream()	ByteStream	Payload for the request.
PduFormat		int
PduSpecific		int
Priority		int

StandardPGNRequestResponse¶

Sends a standard PGN request and returns the response

Parameter

Name	Available if	Default value	Valid values	Type	Description
DestinationAddress				string	Numeric Id or TLA of the receiver. Use 0xff for broadcast.
Payload		ByteStream()		ByteStream	Payload for the request.

Return value

Name	Available if	Default value	Valid values	Type	Description
Return				object	List of J1939Message objects