Port BUSACCESS - FLX¶

VECTOR-HW-Zugriff auf FLX

Stimulation¶

Dieser Port unterstützt alle in Stimulationssteuerung beschriebenen Funktionen.

Eigenschaften 🛈¶

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Kanalnummer	‚1‘		string	Auswahl der Kanalnummer wenn mehrere Kanäle des gleichen Typs vorhanden sind.
RBS aktiv lassen	☐		bool	Restbussimulation bleibt über die Testfallausführung hinaus aktiv.
TimeMaster aktiv lassen	☐		bool	DMCS-TimeMaster bleibt über Testfalldauer hinaus aktiv. Wird gemeinsam mit der Testkonfiguration heruntergefahren
Bus-DB			string
Platzhalterwert für automatische E2E-Berechnung			int	Wenn für ein E2E-Signal (z.B. CRC) dieser Wert angegeben wird, ersetzt ecu.test diesen beim Senden automatisch durch den korrekten, berechneten Wert. Diese Option dient dazu, beliebige feste Werte (ungleich dem hier eingestellten Wert) senden zu können. Diese Option leer zu lassen deaktiviert die Funktion komplett. Für mehr Informationen siehe Toolkategorien - Automatische E2E-Berechnung in der Dokumentation.
Automatischer Start/Stopp	‚Testausführung‘	[‚Testausführung‘, ‚Konfigurationsstart/-stopp‘, ‚Nie‘]	string	Diese Option beeinflusst, wann der FlexRay-Controller automatisch gestartet und gestoppt wird. Bei Auswahl von ‚Nie‘ muss der Controller explizit über den Port-Job ‚SwitchBusState‘ gestartet und gestoppt werden. Achtung: Sämtliche Zeitstempel (z.B. in ASC-Traces) beziehen sich auf den Zeitpunkt des Controller-Starts.
Bei Synchronisationsverlust reinitialisieren	☑		bool	Wenn diese Option gesetzt ist, wird der FlexRay-Controller automatisch neu initialisiert, wenn er die Synchronisation zum Bus verloren hat. Achtung: Falls erforderlich erfolgt die Reinitialisierung trotz gesetzter Option ‚Automatischer Start/Stopp‘.
Listen only	☐		bool	Kontroller läuft im passiven Modus. Schreiben nicht möglich
Loggen von Events	☐		bool	Die Events SCE,SE und EE werden mit ins ASC geschrieben während einer Aufnahme
Konfigurationsmodus	‚Busdatenbank‘	[‚Busdatenbank‘]	string	Insofern der Port mehrere Möglichkeiten bietet konfiguriert zu werden, kann dies hier eingestellt werden. Im Modus ‚Konfigurationsdatei‘ muss der Pfad in der entsprechenden Eigenschaft eingetragen werden. Bei dem Konfigurationsmodus ‚Busdatenbank‘ werden die nötigen Information aus der Datenbank gelesen.
TX-ECU-Namen ❲Busdatenbank❳			string	Komma-getrennte Liste von Steuergeräten, für deren Botschaften Sendepuffer konfiguriert werden sollen. Nur im Konfigurationsmodus ‚Busdatenbank‘ nötig.
Kaltstartknoten ❲Busdatenbank❳	‚<auto>‘	[‚<auto>‘, ‚Kein Kaltstartknoten‘, ‚Kaltstartknoten‘]	string	Entscheidet darüber ob der Knoten sich am Clusterstart beteiligen soll oder nicht. Bei <auto> wird die in der Busdatenbank hinterlegte Einstellung für die gewählten TX-ECUs verwendet. Nur im Konfigurationsmodus ‚Busdatenbank‘ nötig.
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.
Null-Frames	☐		bool	Null-Frames werden mitgeloggt bei ‚True‘
Kaltstartverhalten	‚Leader‘	[‚Leader‘, ‚Follower‘, ‚Both‘]	string	Verhalten des Ports beim Kaltstart. Wenn der Port sowohl ‚Leader‘ als auch ‚Follower‘ sein soll, kann die Option ‚Both‘ ausgewählt werden. In diesem Fall muss die Vector Advanced XL-Driver-Library installiert sein.
Spymode	☐		bool	In diesem Modus ist kein Schreiben möglich. Statt der gesamten FlexRay Konfiguration, wird nur die Baudrate benötigt.
Baudrate ❲nur für Spymode relevant❳	‚10 Mbit/s‘	[‚10 Mbit/s‘, ‚5 Mbit/s‘, ‚2.5 Mbit/s‘]	string

Jobs 🛈¶

ClearFrame¶

Löscht den Empfangspuffer des angegebenen Frames

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
SlotId			int	Frame ID
StartCycle			int	Startzyklus

CloseFrTpSession¶

Schließt die FrTP-Session.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return			[False, True]	bool	Session erfolgreich geschlossen

DeregisterFrameForInbox¶

Deregistriert ein Frames das in die Inbox gestream wird

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
Inbox			object	Bestehende Inbox
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

DeregisterStreamForInbox¶

Deregistriert eine FrTp-Session.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
conId				int	Connection ID

DisableSendFrameCyclic¶

Zyklisches Senden einer Botschaft mit angegebener ID deaktivieren

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
SlotId			int	Frame ID
StartCycle			int	Startzyklus

GetFirstValue¶

Liest den ersten empfangenen Wert des angegebenen Signals

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

GracefulShutdown¶

Den Bus die angegebene Anzahl von Zyklen nach der letzten Versendung der durch die Parameter identifizierten Botschaft herunterfahren. Die tatsächliche Botschaft kann eine Zyklenkonfiguration haben, durch die sie noch öfter verwendet wird, als hier im Job parametriert. In diesem Fall wird als letztes Versenden eines gewählt, das den Job-Parametern entspricht. Optional kann ein abweichender Payload für das letzmalige Versenden spezifiziert werden. Falls vorhanden, wird Treiber-Unterstützung für verzögertes Herunterfahren verwendet.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
NCycles			int	Anzahl Zyklen
PayloadForFinalTransmission			ByteStream	Abweichender Payload für das letztmalige Versenden. Wenn angegeben wird beim letzten Versenden dieser Payload verwendet. Wenn nicht, erfolgt das letzte Versenden mit dem Payload, den es auch hätte, wenn dieser Job nicht aufgerufen worden wäre.
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

InitFrame¶

Initialisiert das angegebene Frame

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
DataLength			int	Länge in Words
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

OpenFrTpSession¶

Öffnet eine FlexRay-TP-Session.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
acknowledged	False	[False, True]	bool	Durch das Acknowledge Bit (C_CT communication type) wird signalisiert, ob der Sender eine Empfangsbestätigung (Acknowledged) wünscht (STFA mit Acknowledged = 1), keine Empfangsbestätigung (Unacknowledged) wünscht (STFU mit Acknowledged = 0). - Integer
blockSize	0		int	Blockgröße in Byte; maximale Anzahl von Bytes, die in den folgenden Consecutive Frames übertragen werden darf, bevor der Sender auf einen weiteren Flow Control Frame warten muss. - Integer
fillByte			ByteStream	Byte zum Auffüllen von Nachrichten (optional) - ByteStream der Länge 1
flowControlAddr	-1		int	Abweichende Adresse des Steuergerätes (ECU) für FlowControl - Hex (optional Integer)
maxFrameLength	0		int	Maximale Länge eines Frames in Byte (gilt sowohl für Start-, Consecutive- und LastFrames); Wenn dieser Wert auf 0 gesetzt wird, wird der im ISO 10681-2 beschriebene Maximalwert verwendet - Integer
mnpc	0		int	MNPC gibt an, wie viele Consecutive Frames der Empfänger innerhalb ein und desselben FlexRay-Zyklus verarbeiten kann. Mit MNPC = 0 darf der Sender die maximale mögliche Bandbreite nutzen. - Integer
requestBaseCycle			int	Cycle Offset im Application Cycle Window - Integer < RequestCycleRepetition
requestCycleRepetition			int	Anzahl Cycle, nach der der Frame beginnend ab BaseCycle zyklisch gesendet wird - Integer >= 1
requestSlotId			int	Frame-ID für Anfragen an das Steuergerät - 1 oder 2 Byte Hex (Integer)
responseBaseCycle			int	Cycle Offset im Application Cycle Window - Integer < ResponseCycleRepetition
responseCycleRepetition			int	Anzahl Cycle, nach der der Frame beginnend ab BaseCycle zyklisch empfangen wird - Integer >= 1
responseSlotId			int	Frame-ID für Steuergeräteantworten - 1 oder 2 Byte Hex (Integer)
scExp	0		int	SC definiert den Mindestabstand an Cycles bis der Sender den nächsten Consecutive Frame senden darf. SC = 2^SCexp - 1 - Integer
sourceAddr			int	Adresse des Testers (ecu.test) - Hex (Integer)
targetAddr			int	Adresse des Steuergerätes (ECU) - Hex (Integer)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				int	Connection ID

ReadFrame¶

Liest das angegebene Frame (vorher InitFrame notwendig!)

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
doDelete	False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

Rückgabewert

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

ReadFrameEx¶

Liest das angegebene Frame (vorher InitFrame notwendig!)

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
doDelete	False	[False, True]	bool	Löscht Frame nach dem Lesen wenn „True“
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

Rückgabewert

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

RegisterFrameForInbox¶

Registriert ein Frame um in eine Inbox gestreamt zu werden.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
Inbox			object	Bestehende Inbox
saveAsFlxFrame	False	[False, True]	bool	Wenn True wird das Frame als FlexRayFrame-Objekt gespeichert, sonst als ByteStream
SlotId			int	Frame ID
StartCycle			int	Startzyklus (Zyklusoffset)

RegisterStreamForInbox¶

Registriert eine FrTp-Session, um in eine Inbox gestreamt zu werden.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
conId				int	Connection ID
inbox				object	Bestehende Inbox

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¶

Sendet die angegebene Frame-ID. Die Frame-ID muss vorher per Job „InitFrame“ registriert werden.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
CycleRepetition			int	Zykluswiederholung
Data			ByteStream	zu sendende Daten
SlotId			int	Frame ID
StartCycle			int	Startzyklus

SendFrameCyclic¶

Zyklisches Senden einer Botschaft mit angegebener ID und Daten. Die Botschafts-ID muss vorher per Job „InitFrame“ registriert werden.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Channel	‚A‘	[‚A‘, ‚B‘, ‚*‘]	string	FlexRay-Kanal (A, B, oder *)
Count			int	Anzahl der Sendewiederholungen
CycleRepetition			int	Zykluswiederholung
DataByteStream			ByteStream	zu sendende Daten
Interval			int	Zykluszeit in ms; 0 für in jedem Zyklus
SlotId			int	Frame ID
StartCycle			int	Startzyklus

SendStream¶

Senden eines Datenstroms über FrTp.

Parameter

Name	Typ	Beschreibung
conId	int	Connection ID
data	object	Payload, der über FrTp gesendet werden soll
timeout	int	Timeout für das Senden der Nachricht in Millisekunden

SetFlowControlCTS¶

Wenn ausgeführt, werden eingehende, segmentierte Botschaften, immer mit einer Flow Control „ContinueToSend“ Nachricht beantwortet. Zusätzlich können den internen Parametern BlockSize, MNPC und SCexp neue Werte zugewiesen werden.

Parameter

Name	Typ	Beschreibung
BlockSize	int	Blockgröße in Byte; maximale Anzahl von Bytes, die in den folgenden Consecutive Frames übertragen werden darf, bevor der Sender auf einen weiteren Flow Control Frame warten muss. - Integer Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControlCTS“ beibehalten.
MNPC	int	MNPC gibt an, wie viele Consecutive Frames der Empfänger innerhalb ein und desselben FlexRay-Zyklus verarbeiten kann. Mit MNPC = 0 darf der Sender die maximale mögliche Bandbreite nutzen. - Integer Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControlCTS“ beibehalten.
SCexp	int	SC definiert den Mindestabstand an Cycles bis der Sender den nächsten Consecutive Frame senden darf. SC = 2^SCexp - 1 - Integer Bei None wird die zuletzt gewählte Einstellung aus der Testkonfiguration, dem OpenDiagSession-Job oder einem vorherigen Aufruf von „SetFlowControlCTS“ beibehalten.
SessionId	object	Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet.

SetFlowControlWait¶

Wenn ausgeführt, werden eingehende, segmentierte Botschaften, immer mit einer Flow Control „Wait“ Nachricht beantwortet. Beachte: Dadurch können keine segmentierten Botschaften mehr empfangen werden. Um dieses Verhalten zurückzusetzen, muss der Job SetFlowControlCTS ausgeführt werden.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
SessionId				object	Handle der Diagnosesitzung. Dieses kann entweder der in der TCF angegebene SUT Name oder ein durch den Job OpenDiagSession zurückgegebenes Handle sein. Wird None angegeben, wird automatisch der SUT Name verwendet.
WaitTimeInterval		0		int	Wartezeitintervall in ms. Bei einem Wert von 0 werden die Flow Control „Wait“-Nachrichten nur einmal als Antwort auf eine segmentierte Anfrage gesendet. Ist der Wert größer als 0, werden Flow Control „Wait“-Nachrichten in regelmäßigen Abständen mit dem angegebenen Intervall gesendet.

StartTimeSyncMaster¶

Startet die Zeitsychronisation als TimeMaster über FlexRay - Es sollte zu jedem Zeitpunkt maximal ein TimeMaster auf einem Bus aktiv sein

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
BaseCycle	0		int	BaseCycle der Sync-Frames
Channel	‚A‘	[‚A‘, ‚B‘, ‚AB‘]	string	Channel der Sync-Frames
CycleRepetition	1		int	CycleRepetition der Sync-Frames
HwTimstampOffset	0		int	Offset in Nanosekunden (positiv oder negativ), der zu Zeitstempeln der Hardware addiert wird
SequenceCounterFreeze	False	[False, True]	bool	SequenceCounter einfrieren
SequenceCounterInit	0		int	Startwert des SequenceCounter
SlotID			int	Slot-ID der Sync-Frames
SyncDataId			object	Daten-ID für SYNC-Nachrichten zur Identifizierung während der CRC-Berechnung (Liste mit 16 Ganzzahlen)
SyncInterval	900000000		int	Intervall in Nanosekunden zwischen zwei Sync-Frames
TimeDomain			int	Spezifiziert die Zeitachse, welche synchronisiert werden soll
UserByte0	0x00		int	Optionales Nutzdatenbyte
UserByte1	0x00		int	Optionales Nutzdatenbyte

StopTimeSyncMaster¶

Stoppt die Zeitsynchronisation als TimeMaster über FlexRay

SwitchBusState¶

Schaltet den FlexRay-Controller ein oder aus.

Achtung: Das Einschalten des Kontrollers setzt die ASC-Zeitstempel zurück. Falls während Stop und Start des Kontrollers eine Aufnahme läuft, kann dadurch eine ASC-Datei mit nicht monoton steigenden Zeitstempeln entstehen.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
State		‚Off‘	[‚Off‘, ‚On‘]	string	Neuer Status des Busses

UpdateTimeSyncMaster¶

Aktualisiert die Parameter bei laufendem TimeMaster.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
BaseCycle	0		int	BaseCycle der Sync-Frames
Channel	‚A‘	[‚A‘, ‚B‘, ‚AB‘]	string	Channel der Sync-Frames
CycleRepetition	1		int	CycleRepetition der Sync-Frames
HwTimstampOffset	0		int	Offset in Nanosekunden (positiv oder negativ), der zu Zeitstempeln der Hardware addiert wird
SequenceCounterFreeze	False	[False, True]	bool	SequenceCounter einfrieren
SequenceCounterInit	0		int	Startwert des SequenceCounter
SlotID			int	Slot-ID der Sync-Frames
SyncDataId			object	Daten-ID für SYNC-Nachrichten zur Identifizierung während der CRC-Berechnung (Liste mit 16 Ganzzahlen)
SyncInterval	900000000		int	Intervall in Nanosekunden zwischen zwei Sync-Frames
TimeDomain			int	Spezifiziert die Zeitachse, welche synchronisiert werden soll
UserByte0	0x00		int	Optionales Nutzdatenbyte
UserByte1	0x00		int	Optionales Nutzdatenbyte