Vector: XL API

供应商信息

Vendor

Web page

产品名称

Version

Vector Informatik GmbH

http://www.vector.com

XL API

25.20.14

Categories

MDL 🛈

APL 🛈

BAN 🛈

BMA 🛈

SVC 🛈

DGN 🛈

FIU 🛈

EES 🛈

FCT 🛈

DBG 🛈

IMG 🛈

AUDIO 🛈

ENVSIM 🛈

ENVCOM 🛈

✓

✓

✓

✓

✓

✓

✓

Signal recordings(信号记录) 🛈

文件格式

Comment

*.asc

*.mf4

BUSACCESS - CAN(-FD) 端口仅支持 MDF4 总线日志。XCP 端口支持基于信号的 MDF4 记录。

*.pcapng

BUSACCESS - CAN(-FD) 端口将使用 linktype=227。生成的文件无法由 Trace Analysis 处理。

Platform

操作系统

Support

Windows

✓

Linux

Ports

Info

带有 ✦ 标记的端口属于 Add-on ecu.test calibration(需要单独的许可证)

Specifics

This interface allows, by means of hardware, direct bus access to CAN, CAN-FD, Ethernet, LIN and FlexRay. It supports the test steps read signal, read/write signal group (all bus systems) as well as monitor (CAN, CAN-FD, LIN and FlexRay) and supports signal recording (all bus systems), Raw diagnostics with KWP2000 over ISO-TP (CAN only), the Mini residual bus simulation (CAN, CAN-FD and FlexRay) and Additional functions of the close-to-hardware bus connections (all bus systems).

For further information regarding the auto fill of E2E-Signals please see Automatic E2E calculation.

Supported drivers

To use the driver in ecu.test, it is necessary that the file vxlapi64.dll is located in the directory %windir%/System32/. If the Vector installer does not store it there, the vxlapi64.dll must be copied manually.

If the tool adapter is used in combination with another Vector application (CANoe, CANalyzer, CANape, …), make sure that ecu.test will be initialized with the hardware first. Otherwise it might happen that the device is blocked and a connection setup is not possible.

It is recommended to install version 25.20.14 of the Vector XL API and to use the latest drivers that are compatible with that API version. The use of ecu.test with other API and driver versions is untested. Unexpected errors of all kinds can occur, or the tool adapter can fail to work at all.

硬件选择

One can either choose the device to be used directly in the test bench configuration. For example: The controller number 2 in a CAN port will then correspond to the second CAN channel.

Or, if hardware channels of several devices should be combined, the Entry “ecutest” in Vector Hardware Manager has to be selected. For this, an Application with the name ecutest (without a dot, because Vector Hardware Manager does not allow dots inside application names) must be created in the program Vector Hardware Manager. Then one must manually assign the hardware channels as Application Channels to the application ecutest in Vector Hardware Manager. The help of Vector Hardware Manager or its predecessor Vector Hardware Config contains further information.

Note on the use of ethernet ports

ecu.test uses the network-based mode for ethernet-based ports, e.g. SERVICE, ETHERNET-RAW or DLT-VERBOSE. The TBC option Hardware at tool level does therefore not affect ethernet-based ports. Thus, no ethernet port needs to be configured for ecu.test in the Vector Hardware Config. Instead, at port level a physical connector must be selected, which consists of the network name and port name.

Further information about how to use services offered via SOME/IP is found in section Service access.

Important

In order to use ethernet-based ports, the Network-based mode must have been activated in the Vector Hardware Config at device level by changing the entry Ethernet access mode configuration. When using PTP the option Forward gPTP frames has to be enabled on all switches.

Info

Further informationen about the purposes of the various Ethernet port types and their differences can be found in the description of the tool adapter tracetronic: Ethernet. All those not ending in -RAW here except ARP correspond to a similarly named type with the suffix or infix -PCAP there.

Warning

Incorrect timestamps in recordings

Certain Vector synchronization modes, like “Hardware Synchronization” may lead to incorrect timestamps in the corresponding ecu.test recordings.

Try mode “Legacy Software Synchronization” if you encounter incorrect timestamps. Also, make sure that the system time of measurement computers runs synchronous to the system time of the ecu.test host.

Tested hardware:

  • Vector CANcaseXL

  • Vector VN8970

  • Vector VN16xx

  • Vector VN56xx

Name

在以下情况下可用

默认值

有效值

Type

Description

Hardware

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

string

选择应使用的硬件

Debug

☐

bool

Activate model time

☐

bool

For diagnostics and the virtual CAN, use the model time of the model port configured as the time source in the TCF.

Timeout for tool call ❲in sec.❳

‘600’

string

工具调用被中止前的超时时间。