Port DIAGNOSTICS - J1939¶

ZLG-HW-Zugriff auf J1939 über CAN. Bestandteil des Add-on ecu.test diagnostics

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Kanalnummer	‚1‘		string	Auswahl der Kanalnummer wenn mehrere Kanäle des gleichen Typs vorhanden sind.
Bitrate	‚500KB‘	[‚10KB‘, ‚20KB‘, ‚50KB‘, ‚83.333KB‘, ‚100KB‘, ‚125KB‘, ‚250KB‘, ‚500KB‘, ‚666.667KB‘, ‚800KB‘, ‚1000KB‘]	string	Bitrate
Abschlusswiderstand aktivieren	☐		bool	Aktiviert den internen 120-Ohm-Abschlusswiderstand
J1939 Tester Name	‚00:00:20:04:00:81:00:20‘		string	Bytefolge für den Namen, die für das Address Claiming verwendet wird mit (mit Doppelpunkt getrennt)
J1939 Tester Source Address	123		int	Quelladresse, die für den J1939 Address Claim verwendet wird (muss > 0 sein).
J1939 TP Priority	6		int	Priorität der J1939 Control Messages im Connection Mode Datatransfer Protokoll (Wert zwischen 0 und 7).
Sendebestätigung	☐		bool	Aktiviert das bestätigte Senden. Bus-Schreiben-Testschritte und Sende-Tooljobs blockieren so lange, bis die Nachricht erfolgreich auf den Bus übertragen wurde oder das Sendebestätigungs-Timeout abgelaufen ist.
Timeout für Sendebestätigung	1000		int	Dauer in Millisekunden binnen der die Nachricht erfolgreich versendet worden sein muss. Anderenfalls wird ein Fehler erzeugt. (darf nicht größer als 64535ms sein). Wird nur bei aktivierter Sendebestätigung verwendet.

Jobs 🛈¶

ClearDTC¶

Löscht alle vormals aktiven (DM3) und aktiven (DM11) Fehlercodes

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DestinationAddress				string	Numerische Id oder TLA des Empfängers. 0xff für Broadcast verwenden.
DTC		‚Previously Active‘	[‚Active‘, ‚Previously Active‘]	string	Art des DTCs

CloseJ1939MemoryAccessSession¶

Schließt die Diagnosesitzung

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DestinationAddress				string	Numerische Id oder TLA des Empfängers.

DTCRequest¶

Abfrage aktiver (DM1) und vormals aktiver (DM2) Fehlercodes

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DestinationAddress				string	Numerische Id oder TLA des Empfängers. 0xff für Broadcast verwenden.
DTC		‚Active‘	[‚Active‘, ‚Previously Active‘]	string	Art des DTCs

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Empfangenes J1939DTCList Objekt.

GenericPGNSendReceive¶

Sendet eine nutzerspezifische J1939 Nachricht und erwartet die Antwortnachricht mit den angegebenen Parametern

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Typ	Beschreibung
ReceivePayloadFilterMask		ByteStream	Maske für die zu überprüfendenByte (ByteStream)
ReceivePayloadFilterValue		ByteStream	Bytewerte, welche die payload der der Nachricht annehmen muss (ByteStream)
ReceivePduFormat	0	int	Erstes Byte der empfangenen PGN
ReceivePduSpecific	0	int	Zweites Byte der empfangenen PGN
SendPayload	ByteStream()	ByteStream	Zu sendende Payload. Falls der ByteStream leer ist, wird nur empfangen.
SendPduFormat	0	int	Erstes Byte der zu sendenden PGN
SendPduSpecific	0	int	Zweites Byte der zu sendenden PGN
SendPriority	0	int	Priorität der zu sendenden Nachricht
Timeout	1	int	Zeit in Sekunden in der auf Antworten gewartet wird

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Liste der empfangenen J1939Message Objekte.

GetAvailableTLAs¶

Liefert ein Dictionary aller aktiven Teilnehmer mit Source-Address zu TLA (Three Letter Acronym) zurück

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Dict {sourceAddress: TLA}

MemoryAccessRequest¶

Stellt eine Memory-Access Anfrage (DM14) und liefert die zugehörigen Antworten (DM15, DM16)

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Command	‚Read‘	[‚Erase‘, ‚Read‘, ‚Write‘, ‚Status Request‘, ‚Operation Completed‘, ‚Operation Failed‘, ‚Boot Load‘, ‚EDCP Generation‘]	string	Art des Speicherzugriffs
DestinationAddress			string	Numerische Id oder TLA des Empfängers.
Key	65535		int	Default: No Key (0xFFFF)
Length	0		int	Abhängig von Pointer Type (PT) die Länge des adressierten Speichers in Byte (PT = 0)oder die Anzahl der Objekte (PT = 1)
Pointer	0		int
PointerExtension	0		int
PointerType	‚Direct Spatial Addressing‘	[‚Direct Memory Addressing‘, ‚Direct Spatial Addressing‘]	string
WriteData	ByteStream()		ByteStream	Zu schreibende Daten für „Write“-Command

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Liste der empfangenen J1939Message Objekte.

OpenJ1939MemoryAccessSession¶

Öffnet eine J1939-Diagnosesitzung (Speicherzugriff) und und hält diese offen, indem der angegebene Nachrichteninhalt mittels DM14 zyklisch alle [Timeout] ms versendet wird.

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
DestinationAddress			string	Numerische Id oder TLA des Empfängers.
Key	65535		int	Default: No Key (0xFFFF)
Length	0		int	Abhängig von Pointer Type (PT) die Länge des adressierten Speichers in Byte (PT = 0)oder die Anzahl der Objekte (PT = 1)
Pointer	0		int
PointerExtension	0		int
PointerType	‚Direct Spatial Addressing‘	[‚Direct Memory Addressing‘, ‚Direct Spatial Addressing‘]	string
Timeout	80		int	Zeit in ms, in welcher eine Nachricht an das Testobjekt gesendet wird, um den Diagnosezugriff aufrecht zu erhalten

Receive¶

Gibt zuletzt empfangene Nachricht mit angegebenen PduFormat, PduSpecific und ggf. SourceAddress zurück

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Typ	Beschreibung
PduFormat	int
PduSpecific	int
SourceAddress	int	Absender Id oder TLA nach dem gefiltert wird (leer, wenn kein Filter)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Empfangenes J1939Message Objekt.

Send¶

Sendet eine nutzerspezifische J1939 Nachricht

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Standardwert	Typ	Beschreibung
Payload	ByteStream()	ByteStream	Payload für Anfrage.
PduFormat		int
PduSpecific		int
Priority		int

StandardPGNRequestResponse¶

Sendet eine Standard PGN Anfrage und liefert die Antwort zurück

Dieser Job ist Bestandteil des Add-on ecu.test diagnostics.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
DestinationAddress				string	Numerische Id oder TLA des Empfängers. 0xff für Broadcast verwenden.
Payload		ByteStream()		ByteStream	Payload für Anfrage.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Return				object	Liste der empfangenen J1939Message Objekte.