Port BUSACCESS - LIN 🛈¶

VECTOR-HW-Zugriff auf LIN

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Besonderheiten¶

DLC im Master-Modus

Im Master-Modus erfordert die Vector XL-API für LIN eine explizite DLC-Konfiguration. ecu.test konfiguriert in diesem Fall die Botschaftslängen aus der Busdatenbank. Für nicht in der Busdatenbank aufgeführte Botschafts-IDs oder bei Verwendung ohne Busdatenbank wird als Rückfallwert DLC=8 verwendet.

Payloads mit davon abweichender Länge können trotzdem sowohl durch ecu.test als auch durch weitere Bus-Teilnehmer genutzt werden. Diese werden aber nicht korrekt empfangen bzw. aufgezeichnet.

Ohne Aktivierung des Master-Modus wird dagegen die Länge der LIN-Botschaften beim Empfang automatisch erkannt.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Kanalnummer	‚1‘		string	Auswahl der Kanalnummer wenn mehrere Kanäle des gleichen Typs vorhanden sind.
Baudrate	19200		float	Baudrate. Zahlen unter 100 werden als kbit/s interpretiert, Zahlen über 100 als bit/s
RBS aktiv lassen	☐		bool	Restbussimulation bleibt über die Testfallausführung hinaus aktiv.
LIN-Version	‚1.3‘	[‚1.3‘, ‚2.0‘]	string	Zu verwendende LIN-Protokollversion. Wirkt sich nur auf die Berechnung und Validierung der Frame-Prüfsumme aus. 1.3 = empfangene Frames müssen eine classic Prüfsumme haben. 2.0 = empfangene Frames dürfen eine enhanced oder classic Prüfsumme haben. Falls die Datenbasis keinen Prüfsummenmodus für ein bestimmtes zu sendendes Frame definiert, wird diese Option berücksichtigt, um entweder den Prüfsummenmodus classic (1.3) oder enhanced (2.0) zu verwenden.
LIN-Master	☐		bool	Auswahl ob der Port der Master (True) oder ein Slave (False) ist.
Bus-DB			string

Jobs 🛈¶

ClearFrame¶

Löscht den Empfangspuffer des angegebenen Frames

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId				int	Frame ID

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	ByteStream

DeregisterFrameForInbox¶

Deregistriert ein Frames das in die Inbox gestream wird

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId				int	Frame ID
Inbox				object	Bestehende Inbox

EnableFrame¶

Lässt diesen Slave auf die angegebene ID antworten (oder nicht antworten). Kann anstelle von „PDU-Timing ändern“ verwendet werden. Der Frame muss über „InitFrame“ initialisiert worden sein.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
enable			[False, True]	bool	Aktivieren oder deaktivieren
frameId				int	Frame ID

GetFirstValue¶

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FrameName			string	Frame-Name
NodeName			string	Name des Steuergeräts
RawValue	False	[False, True]	bool	Wenn ‚True‘ wird der Raw-Wert zurückgegeben.
Reset	False	[False, True]	bool	Wenn ‚True‘‘ wird der erste empfangene Wert nach dem Lesen gelöscht
SignalName			string	Signalname

InitFrame¶

Registriert die Botschaft für spätere Verwendung mit anderen Jobs

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId				int	Frame ID

ReadFrame¶

Liest die Botschaft mit der ID (vorher InitLinFrame notwendig!)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
doDelete		False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
FrameId				int	Frame ID

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				ByteStream	ByteStream

ReadFrameEx¶

Liest die Botschaft mit der ID (vorher InitLinFrame notwendig!)

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
doDelete		False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
FrameId				int	Frame ID

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	LinFrame

RegisterFrameForInbox¶

Registriert ein Frame um in eine Inbox gestreamt zu werden.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
FrameId			int	Frame ID
Inbox			object	Bestehende Inbox
saveAsLinFrame	False	[False, True]	bool	Wenn True wird das Frame als LinFrame-Objekt gespeichert, sonst als ByteStream

ResetFirstValue¶

Löscht den ersten empfangenen Wert des angegebenen Signals

Parameter

Name	Typ	Beschreibung
FrameName	string	Frame-Name
NodeName	string	Name des Steuergeräts
SignalName	string	Signalname

SendFrame¶

Kombiniert: Daten hinterlegen, Botschaft temporär aktivieren und einen Master-Request senden. Die Frame-ID muss vorher per Job „InitFrame“ registriert werden.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
checkSumMode	‚Default‘	[‚Enhanced‘, ‚Classic‘, ‚Default‘]	string	Modus der Checksummenberechnung. Bei Default wird die LIN-Version aus der TBC zur Bestimmung herangezogen.
DataByteStream			ByteStream	zu sendende Daten
FrameId			int	Frame ID

SendMasterRequest¶

Sendet den Botschaftsheader mit der angegebenen FrameId als Master aus.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
frameId				int	Frame ID

SetFrame¶

Hinterlegt die zu sendenden Daten für die komplette Botschaft (statt einzeln pro Signal). Zusätzlich muss die Botschaft per „Botschaftstiming ändern“ oder Job „EnableFrame“ aktiviert werden. Innerhalb eines Testlaufs kann nur eine konstante Länge verwendet werden (Einschränkung der Vector XL API). Falls auch Signal-Schreiben verwendet wird, ist dies die Länge laut Busdatenbank, ansonsten die Länge des ersten Job-Aufrufs. Spätere Aufrufe mit längeren Daten werden abgeschnitten; bei kürzeren Daten wird das Frame deaktiviert.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
checkSumMode	‚Default‘	[‚Enhanced‘, ‚Classic‘, ‚Default‘]	string	Modus der Checksummenberechnung. Bei Default wird die LIN-Version aus der TBC zur Bestimmung herangezogen.
data			ByteStream	Daten als ByteStream
frameId			int	Frame ID