Port DIAGNOSTICS - J1939 🛈

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

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈

Name	Verfügbar wenn	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
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).
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

Parametrierung

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

Parametrierung

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

Parametrierung

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	Liste von J1939-DTC-Objekten

GenericPGNSendReceive

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

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	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	J1939Message-Objekt

GetAvailableTLAs

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

Parametrierung

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)

Parametrierung

Parameter

Name	Verfügbar wenn	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 mit empfangenen J1939Message-Objekten

OpenJ1939MemoryAccessSession

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

Parametrierung

Parameter

Name	Verfügbar wenn	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

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	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	J1939Message-Objekt

Send

Sendet eine nutzerspezifische J1939 Nachricht

Parametrierung

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	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

Parametrierung

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 von J1939Message-Objekten

2025-12-05