Vector: XL API

Herstellerinformationen

Hersteller

Webseite

Produktname

Version

Vector Informatik GmbH

http://www.vector.com

XL API

25.20.14

Kategorien

MDL 🛈

APL 🛈

BAN 🛈

BMA 🛈

SVC 🛈

DGN 🛈

FIU 🛈

EES 🛈

FCT 🛈

DBG 🛈

IMG 🛈

AUDIO 🛈

ENVSIM 🛈

ENVCOM 🛈

✓

✓

✓

✓

✓

✓

✓

Signalaufnahmen 🛈

Dateiformat

Kommentar

*.asc

*.mf4

BUSACCESS - CAN(-FD)-Ports unterstützen nur MDF4 BusLogging. XCP-Ports unterstützen signalbasierte MDF4-Aufzeichnung.

*.pcapng

BUSACCESS - CAN(-FD)-Ports nutzen linktype=227. Die resultierenden Dateien können von der Traceanalyse nicht verarbeitet werden.

Plattform

Betriebssystem

Unterstützung

Windows

✓

Linux

Ports

Info

Mit ✦ gekennzeichnete Ports sind Teil des Add-on ecu.test calibration (separate Lizenz benötigt)

Besonderheiten

Diese Schnittstelle ermöglicht mit der Hardware direkte Buszugriffe auf CAN, CAN-FD, Ethernet, LIN und FlexRay. Sie erlaubt die Testschritte Signal-Lesen und Signalgruppe Lesen/Schreiben (alle Bussysteme) sowie Überwachen (nur CAN, CAN-FD, LIN und FlexRay) und unterstützt Signalaufzeichnung (alle Bussysteme), Rohdiagnose mit KWP2000 über ISO-TP (nur CAN), die Mini-Restbussimulation (nur CAN, CAN-FD und FlexRay) und Weitere Funktionen der hardwarenahen Bus-Anbindungen (alle Bussysteme).

Für mehr Informationen zur automatischen Befüllung von E2E-Signalen siehe Automatische E2E-Berechnung.

Unterstützte Treiber

Für die Verwendung des Treibers in ecu.test ist es notwendig, dass die Datei vxlapi64.dll im Verzeichnis %windir%/System32/ liegt. Sollte der Vector-Installer diese nicht dort ablegen, muss die vxlapi64.dll manuell dahin kopiert werden.

Wird der Tooladapter in Kombination mit einer anderen Vector Anwendung (CANoe, CANalyzer, CANape, …) verwendet, ist darauf zu achten, dass sich ecu.test zuerst mit der Hardware initialisiert. Andernfalls kann es vorkommen, dass das Gerät blockiert wird und ein Verbindungsaufbau nicht möglich ist.

Es wird empfohlen, Version 25.20.14 der Vector XL API sowie die neuesten zur verwendeten API-Version kompatiblen Treiber zu installieren. Die Verwendung von ecu.test mit anderen API- und Treiberversionen ist nicht getestet und kann zu unerwartetem Verhalten führen, oder die Nutzung komplett verhindern.

Hardware-Auswahl

Das zu verwendende Gerät kann direkt in der Testbenchkonfiguration angegeben werden. Dann entspricht z.B. die Kontrollernummer 2 in einem CAN-Port dem zweiten CAN-Kanal.

Wenn mehrere Geräte gleichzeitig verwendet werden, muss der Eintrag „ecutest“ in Vector Hardware Manager gewählt werden. Dazu muss im Programm Vector Hardware Manager eine Application mit dem Namen ecutest (ohne Punkt im Produkt-Namen, da die Vector Hardware Manager keine Punkte in Anwendungsnamen zulässt) erstellt und im Anschluss die benötigten Hardware-Kanäle manuell logischen „Application channel“ zugewiesen werden. Weitere Informationen zum Erstellen einer „Application“ und dem Zuweisen von Kanälen finden sich in der Hilfe zur Vector Hardware Manager oder dessen Vorgänger Vector Hardware Config.

Hinweis zur Verwendung der Ethernet-Ports

ecu.test verwendet für Ethernet-basierte Ports wie z.B. SERVICE, ETHERNET-RAW oder DLT-VERBOSE den Network-based mode. Die TBC-Option Hardware auf Tool-Ebene spielt insofern für Ethernet-basierte Ports keine Rolle. Deshalb muss in der Vector Hardware Config auch kein Ethernet-Port für ecu.test angelegt werden. Stattdessen wird auf Port-Ebene ein physischer Anschluss ausgewählt, der sich aus Netzwerk- und Portname zusammensetzt.

Weitergehende Informationen wie per SOME/IP angebotene Services verwendet werden können finden sich im Abschnitt Service-Zugriff.

Wichtig

Um Ethernet-basierte Ports verwenden zu können, muss in der Vector Hardware Config auf Ebene des Geräts unter Ethernet access mode configuration der Network-based mode aktiviert werden. Für die Verwendung von PTP muss weiterhin die Option Forward gPTP frames auf jedem Switch aktiviert werden.

Info

Weitere Informationen über die Zwecke der verschiedenen Ethernet-Porttypen und ihre Unterschiede finden sich auch in der Beschreibung des Tool-Adapters tracetronic: Ethernet. Alle hier nicht mit -RAW endenden Port-Typen außer ARP entsprechen dort gleichnamigen Typen mit Suffix bzw. Infix -PCAP.

Warnung

Inkorrekte Zeitstempel in Aufnahmen

Bestimmte Vector-Synchronisations-Modi, zum Beispiel „Hardware Synchronization“, können zu inkorrekten Zeitstempeln in den entsprechenden ecu.test-Aufnahmen führen.

Probieren Sie den Modus „Legacy Software Synchronization“ wenn Sie Probleme mit inkorrekten Zeitstempeln haben. Stellen Sie außerdem sicher, dass die Systemzeit von Messtechnik-Rechnern synchron zu der Systemzeit des ecu.test-Host läuft.

Getestete Geräte:

  • Vector CANcaseXL

  • Vector VN8970

  • Vector VN16xx

  • Vector VN56xx

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Hardware

[‚<online query>‘, ‚<no toollib start>‘]

string

Wählen Sie hier die zu verwendende Hardware aus

Debug

☐

bool

Modellzeit aktivieren

☐

bool

Für die Diagnose und den virtuellen CAN verwenden Sie die Modellzeit des Modellports, der in der TCF als Zeitquelle konfiguriert ist.

Timeout für Toolzugriffe ❲in Sek.❳

‚600‘

string

Zeit nach der eine Anfrage an das Tool abgebrochen wird.