Vector: XL API

Bisheriger/interner Bezeichner: VECTOR-HW

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

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).

Info

Die APPLICATION-Ports sind nur mit dem Add-on ecu.test calibration verfügbar.

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 Config gewählt werden. Dazu muss im Programm Vector Hardware Config eine Application mit dem Namen ecutest (ohne Punkt im Produkt-Namen, da die Vector Hardware Config 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 Config oder dessen Nachfolger Vector Hardware Manager.

Um mehr als 64 Hardware-Kanäle anzusprechen, ist die Version 24.40 oder neuer der XL-Driver-Library nötig. Außerdem muss in den Einstellungen des Tools Vector: XL API die Checkbox Unterstützung für mehr als 64 Kanäle aktiviert werden.

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.

Getestete Geräte:

  • Vector CANcaseXL

  • Vector VN8970

  • Vector VN16xx

  • Vector VN56xx