STAR ELECTRONICS: FL3X¶

Herstellerinformationen

Kategorien

Plattform

Ports¶

Besonderheiten¶

Diese Schnittstelle ermöglicht die Manipulation von Bus-Signalen sowie Botschaftsausfall auf einem als RBS und/oder Gateway eingerichteten FL3X Device oder FL3X System.

Um ein Signal auf einen vorgegebenen Wert zu zwingen, genügt es, diesen Wert auf das Signal zu schreiben. Andere Manipulationsarten werden angesteuert, indem man einen wie folgt aufgebauten Ausdruck als Rohwert schreibt. Eckige Klammern kennzeichnen optionale Parameter. Der gesamte Ausdruck muss dabei als String geschrieben werden, also in Anführungszeichen stehen.

offset(value: int[, min: int, max: int])

Zum ursprünglichen Rohwert des Signals wird value addiert. Falls min und max angegeben sind, wird der neue Rohwert außerhalb dieses Bereichs auf min erhöht bzw. auf max verringert.

Das Offset kann auch negativ sein.

Beispiel: "offset(-7)"

factor(value: int[, min: int, max: int])

Der ursprüngliche Rohwert des Signals wird mit value multipliziert. Falls min und max angegeben sind, wird der neue Rohwert außerhalb dieses Bereichs auf min erhöht bzw. auf max verringert.

Ein negativer Faktor ist nicht möglich.

Beispiel: "factor(3)"

ramp(start: int, end: int, steps: int[, hold: bool[, min: int, max: int]])

Anstelle des ursprünglichen Rohwerts wird eine Rampe von start bis end in steps Schritten gesendet. Falls hold angegeben und True ist, wird der letzte Wert gehalten. Anderenfalls wiederholt sich die Rampe wieder und wieder. Falls min und max angegeben sind, wird der neue Rohwert außerhalb dieses Bereichs auf min erhöht bzw. auf max verringert.

Negative Werte sind nicht möglich, steps darf außerdem nicht 0 sein.

Beispiel: "ramp(0, 14, 7)" – gibt nacheinander die Werte 0, 2, 4, …, 14 aus und beginnt dann wieder von vorn.

drift(start: int, end: int, steps: int[, hold: bool[, min: int, max: int]])

Eine Rampe (wie bei ramp) wird auf den ursprünglichen Rohwert des Signals addiert.

Beispiel: "drift(0, 6, 3, True, 3, 9)" – addiert zuerst 0, dann 3, dann 6 auf den Signalwert und behält dann das Offset +6 bei. Wenn der jeweils resultierende Wert kleiner als 3 ist, wird stattdessen 3 gesendet. Wenn er größer als 9 ist, wird stattdessen 9 gesendet.

freeze()

Der aktuelle Wert des Signals wird eingefroren.

blackout()

Alle Bits des Signals werden als 0 gesendet.

factor_phys(factor: float, signal_factor: float, signal_offset: float[, min: int, max: int])

Mit Hilfe von signal_factor und signal_offset wird aus dem Rohwert der physikalische Zahlenwert berechnet. Dieser wird mit factor multipliziert und dann zurück zum neuen Rohwert gewandelt. Falls min und max angegeben sind, wird der neue Rohwert außerhalb dieses Bereichs auf min erhöht bzw. auf max verringert.

Beispiel: "factor_phys(1.2, 0.1, -6.0, 0, 254)" – der zu sendende Rohwert wird wie folgt berechnet:

PHYS_orig := 0.1 * RAW_orig - 6.0
PHYS_new := PHYS_orig * 1.2
RAW_new := (PHYS_new + 6.0) / 0.1, als Ganzzahl ohne Nachkommastellen
RAW_send := min(max(0, RAW_new), 254)

Um die Werte von Testfallvariablen in einem solchen Ausdruck zu verwenden, eignet sich z.B. die format-Methode der Python-Klasse str: "offset({0}, {1}, {2})".format(variable1, variable2, variable3).

Die Werte für min, max, signal_factor und signal_offset können bei Bedarf über die BusBrowser-API ermittelt werden (GetMinRawValue, GetMaxRawValue, GetLinearCoeffs).

Jede Manipulation wird sofort aktiv, ersetzt eine etwaige bisherige Manipulation desselben Signals (sofern diese mit ecu.test vorgenommen und der Tooladapter seither nicht neu gestartet wurde) und wirkt zusätzlich zu Manipulationen anderer Signale.

Zum Zurücknehmen einer einzelnen Signalmanipulation eignet sich der Testschritt Zurücksetzen. Mit dem Tool-Job StopAllManipulations werden sämtliche (auch außerhalb des aktuellen Testfalls oder gar außerhalb von ecu.test vorgenommenen) Manipulationen und Botschafts-Unterdrückungen gestoppt.

Daneben können noch Botschaften unterdrückt werden – entweder einzeln (Testschritt PDU-Timing ändern; nur Aktivierungsstatus, keine Zykluszeit oder Berechnungsklasse) oder alle Botschaften eines Steuergeräts (durch „Schreiben“ von 0 bzw. 1 auf das Steuergerät selbst).

Eigenschaften 🛈¶

Jobs 🛈¶

CheckConnection¶

Prüft, ob das Gerät Online ist und antwortet

DownloadApp¶

Lädt die Anwendung (*.s19-Datei) auf das Gerät, in den angegebenen Slot

DownloadFPGA¶

Lädt das FPGA-Image (*.fpga-Datei) auf das Gerät, in den angegebenen Slot

ReadGlobalVariable¶

Liest den Wert einer globalen Variable. Gibt eine ganze Zahl zurück wenn die Variable kein Array ist, und eine Liste von ganzen Zahlen wenn sie ein Array ist.

StartApp¶

Startet die aktuell auf dem Gerät installierte Anwendung

StopAllManipulations¶

Stoppt alle gegenwärtig aktiven Manipulationen und Botschaftsausfälle

StopApp¶

Stoppt die auf dem Gerät laufende Anwendung

WriteGlobalVariable¶

Schreibt den Wert einer globalen Variable. Parameter ‚value‘ muss eine ganze Zahl sein wenn die Variable kein Array ist, und eine Liste von ganzen Zahlen wenn sie ein Array ist.