Vector: CANape¶
Bisheriger/interner Bezeichner: CANape
Herstellerinformationen
Hersteller |
Webseite |
Produktname |
Version |
|---|---|---|---|
Vector Informatik GmbH |
CANape |
14 SP4, getestet bis 22 SP4 |
Kategorien
MDL 🛈 |
APL 🛈 |
BAN 🛈 |
BMA 🛈 |
SVC 🛈 |
DGN 🛈 |
FIU 🛈 |
EES 🛈 |
FCT 🛈 |
DBG 🛈 |
IMG 🛈 |
AUDIO 🛈 |
ENVSIM 🛈 |
ENVCOM 🛈 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
✓ |
✓ |
Plattform
Betriebssystem |
Unterstützung |
|---|---|
Windows |
✓ |
Linux |
Ports¶
Besonderheiten¶
Lesen und Schreiben von Kalibriergrößen¶
Beim Lesen und Schreiben von Kalibriergrößen die Stützstellen verwenden (Map und Curve), sind die Stützstellen in ecu.test nur sicht- und modifizierbar, wenn sie in Form von Referenzen auf ebenfalls definierte Signale vorliegen. Liegen die Stützstellen in anderer Form vor ist der Zugriff aufgrund einer Einschränkung seitens CANape nicht möglich und die betreffenden Felder im Parametrierungsdialog des Testschritts bleiben leer.
Info
Das Lesen und Aufzeichnen des Arbeitspunkts von Curves und Maps wird aktuell nicht unterstützt.
Lesen und Aufzeichnen von Messgrößen¶
ecu.test unterstützt das Lesen und Aufzeichnen von Skalar-, Vektor- und Matrix-Messgrößen. Die Einzelelemente von Vektoren und Matrizen können nur dann verwendet werden, wenn diese Elemente, wie skalare Werte in der Form <Messgrößenname>_[<Index>] in der A2L-Datei aufgeführt sind.
Hinweis: Wir empfehlen in CANape als Aufnahmeformat MDF4 einzustellen. Bei MDF3 kann es vorkommen, dass die Aufnahmedatei nicht sortiert ist und deshalb in der Traceanalyse nicht verwendet werden kann.
Durchführung von Wake-Up Tests¶
Im Fall, dass ein Steuergerät getestet wird, welches zu Beginn der Testfallausführung noch nicht aktiviert ist, kann der Messungsstart manuell gesteuert werden (Tooleigenschaft „Messungsstart“ -> „Manual“). Im Testablauf wird damit ermöglicht, dass nach Aktivierung des Geräts bzw. Schalten der Klemmen die Tooljobs InitializeHardware zum Aktivieren des Geräts und StartMeasurement verwendet werden können.
Hinweis: Vor dem Zugriff auf Kalibriergrößen sollte das Gerät in CANape aktiviert sein. Bevor auf Messgrößen zugegriffen wird, muss zusätzlich die Messung gestartet sein.
Hinweise zu UseNAN¶
Für den Steuergerätezugriff kann es nützlich sein, bei noch nicht vorliegenden Werten einen Spezialwert (in CANape ~~nan~~, in ecu.test ~~~NotPresent~~~) zu erhalten. So kann z.B. per Warte bis wahr auf den ersten Wert gewartet werden, oder geprüft werden ob tatsächlich Werte vom Steuergerät übertragen werden.
Zu diesem Zweck wird die Option Altes Verhalten für Bus-und Mess-Lesen auf ~~False~~ gestellt.
Leider bewirkt diese Einstellung zugleich, dass für Bus-Signale nur dann ein Wert gelesen werden kann, wenn das zu lesende Signal in der zuletzt empfangenen Botschaft enthalten ist. Anderenfalls ist der Bus-Signalwert ebenfalls ~~nan~~ bzw. ~~~NotPresent~~~. Für Mess-Signale vom Steuergerät kommt dieser Fall nicht vor.
Wenn die Option Altes Verhalten für Bus-und Mess-Lesen auf ~~True~~ gestellt wird, erhält man für Bus-Signale immer den zuletzt empfangenen Wert; jedoch erhält man für Bus-Signale deren Botschaft noch nie emfpangen wurde, und für Mess-Signale vom Steuergerät für die noch kein Wert vorliegt, 0 stat ~~nan~~ bzw. ~~~NotPresent~~~.
Spezifizieren der Abrufrate pro gemappter Größe¶
In der MEAS Sektion des Bearbeiten-Dialogs von Mapping-Items von CANape-Größen kann als Raster beispielsweise polling#123 angegeben werden, um das Polling auf eine gewünschte Rate von 123 ms zu setzen. Dasselbe ist möglich mit dem Stichwort cyclic. Näheres zum Einstellen des Rasters bei Mapping-Items findet sich hier.
Konfigurationsstart mit laufendem CANape-Prozess¶
Damit ecu.test eine manuell gestartete CANape-Instanz steuern kann, muss diese durch Drücken des entsprechenden Buttons Tools->ASAP3 in den ASAP3-Modus versetzt werden. Dabei gelten folgende Einschränkungen:
In der Testbenchkonfiguration darf keine CNA-Datei angegeben werden.
Die TBC-Option Beim Beenden herunterfahren muss auf False gesetzt sein.
Diese Einschränkungen gelten nicht, wenn die CANape-Instanz ursprünglich durch ecu.test (oder mit der Kommandozeilenoption -u) gestartet wurde.
Eigenschaften 🛈¶
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
CANape-Projekt |
uri |
CANape Projekt (Verzeichnis oder CNCC-Datei). Achtung, wenn ein Verzeichnis angegeben wird, wird dessen Inhalt verändert! (absoluter Pfad oder relativ zum angegebenen Basispfad). |
|||
.cna-Datei |
string |
Dateiname der *.cna-Datei. Falls leer, benutzt CANape die zuletzt im CANape-Projekt referenzierte *.cna-Datei. Falls das Projekt keine *.cna-Dateien referenziert, kann das Laden einer *.cna-Datei einen Modalen Dialog zum Speichern der aktuellen Konfiguration als *.cna-Datei verursachen. Um dies zu vermeiden, entweder diese Einstellung leer lassen, oder ein Projekt verwenden, das eine *.cna-Datei referenziert. |
|||
CANape-Installation |
string |
Auswahl der zu verwendenden CANape-Installation anhand des Installationspfads |
|||
Messungsstart |
‚Automatic‘ |
[‚Automatic‘, ‚Manual‘] |
string |
Automatic: Messungsstart automatisch bei Teststart (sofern Messgrößen vorhanden sind). Falls die Messung automatisch gestartet werden soll, werden alle nicht gestarteten Geräte aktiviert und online gesetzt. |
|
Synchroner Messungsstart |
☑ |
bool |
Wenn True wird gewartet, bis CANape tatsächlich die Messung gestartet hat bevor der Test gestartet wird. |
||
Timeout für synchronen Messungsstart |
10 |
int |
Timeout in [s] für synchrones Starten der Messung. |
||
FIFO Puffergröße |
‚Default‘ |
string |
Anzahl an Samples die von CANape im Speicher gehalten werden. Diese werden in CANape gleichmäßig auf 23 FIFO-Puffer verteilt die jeweils einem Messraster zugeordnet sind. (Maximal 2944, Default=230) |
||
Sample Größe |
‚Default‘ |
string |
Anzahl der Messwerte pro Sample. (Maximal 256, Default=128) |
||
CANape-Version |
‚wird erst zur Laufzeit bestimmt und steht dann im Report‘ |
string |
Verwendete CANape-Version |
||
Skript Timeout |
30 |
int |
Timeout (in s) für CANape-Skript Ausführung |
||
CANape-Oberfläche |
‚vollständig‘ |
[‚vollständig‘, ‚nur Write-Fenster‘, ‚versteckt‘] |
string |
Um die Performance und Stabilität zu erhöhen, kann die Sichbarkeit von CANape eingeschränkt werden. |
|
Beim Beenden herunterfahren |
☐ |
bool |
Soll CANape bei Tool-Beendigung heruntergefahren werden? |
||
Altes Verhalten für Bus-und Mess-Lesen |
☑ |
bool |
Deaktiviert UseNAN. Siehe Abschnitt ‚Hinweise zu UseNaN‘ in der ecu.test-Anwenderhilfe, Kapitel Tools -> CANape |
||
Sammelgerät ‚_All_‘ für Traceanalyse von MDF3-Aufnahmen |
☐ |
bool |
In der Traceanalyse werden aufgezeichnete MDF3-Dateien mit dem Gerät ‚_All_‘ verarbeitet. Dadurch können über eine einzelne Signalgruppe die Signale aller tatsächlich aufgezeichneten Geräte über entsprechende Mappings adressiert werden. |
||
Alle Recorder deaktivieren, die nicht durch ecu.test verwendet werden. |
☐ |
bool |
CANape startet bei Messungsstart alle vorhandenen Recorder automatisch. Wenn diese Option gewählt ist, werden alle von ecu.test nicht verwendeten Recorder deaktiviert. |
||
Timeout für Toolzugriffe ❲in Sek.❳ |
‚600‘ |
string |
Zeit nach der eine Anfrage an das Tool abgebrochen wird. |
Jobs 🛈¶
GetCANapeLog¶
Kopiert die CANape-Logdatei ins Reportverzeichnis.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
Path |
‚PROJECT_ROOT\\CANape.log‘ |
string |
Pfad zu Logdatei - PROJECT_ROOT entspricht dem Reportverzeichnis. |
InitializeHardware¶
Aktiviert alle registrierten Devices und setzt sie online. Zuvor werden aktive Devices offline gesetzt und deaktiviert.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
measStartReconnectDevicesDelay |
0 |
float |
Zeit zwischen dem Offline-setzen und der erneuten Aktivierung und Online-setzen (in Sekunden). |
InitVariable¶
Fügt die angegeben Größe dem Experiment hinzu (notwendig für ReadVariable). Eine laufende Messung wird hierzu angehalten und anschließend neu gestartet.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DeviceName |
string |
Name des Device in CANape |
|||
Rate |
string |
Name des Messrasters |
|||
VariableName |
string |
Name der Größe die initialisiert werden soll |
ReadVariable¶
liest eine Größe aus dem Experiment (InitVariable vorher notwendig!) Es wird immer ein Skalar zurückgegeben.
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
DeviceName |
string |
Name des Device von dem gelesen wird |
|||
VariableName |
string |
Name der zu lesenden Größe |
RunCANapeScript¶
Führt ein Skript in CANape aus
Parametrierung
Parameter
Name |
Verfügbar wenn |
Standardwert |
Gültige Werte |
Typ |
Beschreibung |
|---|---|---|---|---|---|
SourceCode |
string |
Skriptcode der ausgeführt werden soll |
StartMeasurement¶
Startet die Messung
StopMeasurement¶
Stoppt die Messung