Page 1
User Manual
CANoe Test Hardware VH1150
Version
English
1.3
Page 2
Imprint
Vector Informatik GmbH
Ingersheimer Straße 24
D
Vector reserves the right to modify any information and/or data in this user documentation without notice. This documentation nor any of
its parts may be reproduced in any form or by any means without the prior written consent of Vector. To the
under law, all technical data, texts, graphics, images and their design are protected by copyright law, various international
other applicable law. Any unauthorized use may violate copyright and other applicable laws
All rights reserved.
80438
-70499 Stuttgart
Copyright 2016, Vector Informatik GmbH. Printed in Germany.
or regulations.
maximum extent permitted
treaties and
Page 3
User Manual CANoe Test Hardware VH1150 Table of Contents
Table of Contents
1 Introduction 3
1.1 Product Overview 4
1.2 Safety Instructions and Hazard Warnings 5
1.2.1 Proper Use and Intended Purpose 5
1.2.2 Hazards 5
1.2.3 Disclaimer 6
1.3 About this User Manual 7
1.3.1 Certification 8
1.3.2 Warranty 8
1.3.3 Support 8
1.3.4 Trademarks 8
2 Installation 9
2.1 VH1150 Overview 10
2.2 Hardware Setup 12
2.2.1 Required Power Supply 12
2.2.2 Recommended Power Supply 12
2.3 Software Requirements 13
2.4 Software Installation 13
2.5 Compatibility with VH100 13
2.6 Configuring VH1150 13
3 Technical Data 15
3.1 Output Voltage Terminal 15/30 16
3.2 Measurement of Output Current 16
3.3 Relay for Terminals 16
3.4 Ground Offset for DUT Supply 17
3.5 Ground Offset LIN Line 17
3.6 LIN Recessive Level Limit 18
3.7 Device IOs 18
3.7.1 Analog Input Port 18
3.7.2 Analog Output Port 18
3.7.3 Digital Output Port 19
3.7.4 Digital Input Port 19
3.7.5 I/O Connector Pin Assignment 19
3.8 Short Circuit and Interruption of CAN, LIN 20
3.8.1 Y Cable 20
3.8.2 Connector CAN/LIN 22
4 API 23
4.1 General Functions 24
4.1.1 VHDevSearchOpen 24
4.1.2 VHDevOpen 25
4.1.3 VHDevClose 25
4.1.4 VHDevSetSafeState 26
4.1.5 VHDevGetHWRevision 26
© Vector Informatik GmbH Version 1.3 - I -
Page 4
Table of Contents User Manual CANoe Test Hardware VH1150
4.1.6 VHDevResetOverload 27
4.1.7 VHDevGetOverload 27
4.1.8 VHDevSetDebugFlag 27
4.2 Terminal Control and Measurement 28
4.2.1 VHDevSetRelay 28
4.2.2 VHDevSetRelayEx 29
4.2.3 VHDevGetVoltage 30
4.2.4 VHDevGetCurrent 30
4.2.5 VHDevSetVoltageVBatt 31
4.2.6 VHDevSetVoltageVBattEx 31
4.2.7 VHDevSetCurrentMeasurementRange 32
4.3 Ground Offset and LIN Recessive Limit 33
4.3.1 VHDevSetGroundOffset 33
4.3.2 VHDevSetTesterBusGroundOffset 34
4.3.3 VHDevSetLINRecessiveVoltageLimit 35
4.4 Device Inputs/Outputs 35
4.4.1 VHDevSetAnalogOutput 35
4.4.2 VHDevSetDigitalOutput 36
4.4.3 VHDevSetLINCabSupplyMode 36
4.4.4 VHDevGetAnalogInput 37
4.4.5 VHDevGetDigitalInput 37
4.5 Bus Line Disturbance 38
4.5.1 VHDevSetBusFaults 38
4.5.2 VHDevSetPeriodicalLINBusFault 39
4.6 CAN Network 40
4.6.1 VHDevMeasureCANTermResistor 40
4.6.2 VHDevSetCANCapacitors 41
4.6.3 VHDevMeasureCANDiffVoltage 41
4.7 Error Codes 42
5 Index 43
- II - Version 1.3 © Vector Informatik GmbH
Page 5
User Manual CANoe Test Hardware VH1150 Introduction
1 Introduction
In this chapter you will find the following information:
1.1 Product Overview page 4
1.2 Safety Instructions and Hazard Warnings page 5
Proper Use and Intended Purpose
Hazards
Disclaimer
1.3 About this User Manual page 7
Certification
Warranty
Support
Trademarks
© Vector Informatik GmbH Version 1.3 - 3 -
Page 6
Introduction User Manual CANoe Test Hardware VH1150
CANoe.LIN.
> CANoe version 7.1 or higher
> 2 CANterms 120 Ohm
1.1 Product Overview
Applications The CANoe test hardware VH1150 is a USB-hardware for automating ECU
conformance tests for CAN and LIN. It is typically used by CANoe-based test
implementations to automatically hardware reset the ECU before each test case.
Further applications include the programmed adjustment of the ECU’s supply voltage
and the automated detection of sleep and wake modes by measuring the ECU’s
current consumption.
Additionally the VH1150 supports stress features to produce a ground offset or to limit
the recessive level of the LIN line. It is also possible to short circuit or interrupt CAN
and LIN lines.
The VH1150 provides IO lines which allow to interface with external devices.
Currently this hardware is used by the Vector CANoe test package VAG for CAN
high-speed and by the LIN conformance tests implementation provided with
Requirements
Scope of delivery
> CANoe version 8.0 SP4 or higher for Windows 8
> CANoe version 7.2 SP3 or higher for Windows 7
> USB hardware VH1150 (external power supply not included)
> VH1150 installation manual
> Installation CD
> USB cable (2 m)
> Y cable
- 4 - Version 1.3 © Vector Informatik GmbH
Page 7
User Manual CANoe Test Hardware VH1150 Introduction
the interface.
KnowledgeBase for updated information prior to the operation of the interface.
performing test drives in order to reduce hazards.
1.2 Safety Instructions and Hazard Warnings
Caution: In order to avoid personal injuries and damage to property, you have to
read and understand the following safety instructions and hazard warnings prior to
installation and use of this interface. Keep this documentation (manual) always near
1.2.1 Proper Use and Intended Purpose
Caution: The interface is designed for analyzing, controlling and otherwise
influencing control systems and electronic control units. This includes, inter alia, bus
systems like CAN, LIN, K-Line, MOST, FlexRay, Ethernet and/or BroadRReach.
The interface may only be operated in a closed state. In particular, printed circuits
must not be visible. The interface may only be operated (i) according to the
instructions and descriptions of this manual; (ii) with the electric power supply
designed for the interface, e.g. USB-powered power supply; and (iii) with accessories
manufactured or approved by Vector.
The interface is exclusively designed for use by skilled personnel as its operation may
result in serious personal injuries and damage to property. Therefore, only those
persons may operate the interface who (i) have understood the possible effects of the
actions which may be caused by the interface; (ii) are specifically trained in the
handling with the interface, bus systems and the system intended to be influenced;
and (iii) have sufficient experience in using the interface safely.
1.2.2 Hazards
The knowledge necessary for the operation of the interface can be acquired in
workshops and internal or external seminars offered by Vector. Additional and
interface specific information, such as „Known Issues“, are available in the Vector
KnowledgeBase on Vector´s website at www.vector.com. Please consult the Vector
Caution: The interface may control and/or otherwise influence the behavior of control
systems and electronic control units. Serious hazards for life, body and property may
arise, in particular, without limitation, by interventions in safety relevant systems (e.g.
by deactivating or otherwise manipulating the engine management, steering, airbag
and/or braking system) and/or if the interface is operated in public areas (e.g. public
traffic, airspace). Therefore, you must always ensure that the interface is used in a
safe manner. This includes, inter alia, the ability to put the system in which the
interface is used into a safe state at any time (e.g. by „emergency shutdown“), in
particular, without limitation, in the event of errors or hazards.
Comply with all safety standards and public regulations which are relevant for the
operation of the system. Before you operate the system in public areas, it should be
tested on a site which is not accessible to the public and specifically prepared for
© Vector Informatik GmbH Version 1.3 - 5 -
Page 8
Introduction User Manual CANoe Test Hardware VH1150
from insufficient training or lack of experience of personnel using the interface.
1.2.3 Disclaimer
Caution: Claims based on defects and liability claims against Vector are excluded to
the extent damages or errors are caused by improper use of the interface or use not
according to its intended purpose. The same applies to damages or errors arising
- 6 - Version 1.3 © Vector Informatik GmbH
Page 9
User Manual CANoe Test Hardware VH1150 Introduction
This user manual provides you with the following access help:
> At the end of the user manual an index will help you to find information quickly
throughout the manual.
File|Save
Source Code
1.3 About this User Manual
To find information
quickly
> At the beginning of each chapter you will find a summary of the contents
> The header shows in which chapter of the manual you are
> The footer shows the version of the manual
Conventions
In the two tables below you will find the notation and icon conventions used
Style Utilization
bold
Windows Legally protected proper names and marginal notes.
Hyperlink Hyperlinks and references.
<Ctrl>+<S> Notation for shortcuts.
Fields/blocks, user/surface interface elements, window- and dialog
names of the software, special emphasis of terms.
[OK] Push buttons in square brackets
Notation for menus and menu entries
File and directory names, source code, class and object names,
object attributes and values
Symbol Utilization
This icon indicates notes and tips that facilitate your work.
This icon warns of dangers that could lead to damage.
This icon indicates more detailed information.
This icon indicates examples.
This icon indicates step-by-step instructions.
This icon indicates text areas where changes of the currently
© Vector Informatik GmbH Version 1.3 - 7 -
described file are allowed or necessary.
This icon indicates files you must not change.
Page 10
Introduction User Manual CANoe Test Hardware VH1150
Management System
The ISO standard is a globally recognized standard.
> Online formula
trademarks
trademarks of their respective owners.
Symbol Utilization
1.3.1 Certification
Quality
Vector Informatik GmbH has ISO 9001:2008 certification.
1.3.2 Warranty
This icon indicates multimedia files like e.g. video clips.
This icon indicates an introduction into a specific topic.
This icon indicates text areas containing basic knowledge.
This icon indicates text areas containing expert knowledge.
This icon indicates that something has changed.
Restriction of
warranty
We reserve the right to modify the contents of the documentation or the software
without notice. Vector disclaims all liabilities for the completeness or correctness of
the contents and for damages which may result from the use of this documentation.
1.3.3 Support
You need support? You can get through to our hotline at the phone number
> Phone:+49 711 80670-200
> Email: support@de.vector.com
1.3.4 Trademarks
Protected
All brand names in this documentation are either registered or non registered
- 8 - Version 1.3 © Vector Informatik GmbH
Page 11
User Manual CANoe Test Hardware VH1150 Installation
2 Installation
In this chapter you will find the following information:
2.1 VH1150 Overview page 10
2.2 Hardware Setup page 12
Required Power Supply
Recommended Power Supply
2.3 Software Requirements page 13
2.4 Software Installation page 13
2.5 Compatibility with VH100 page 13
2.6 Configuring VH1150 page 13
© Vector Informatik GmbH Version 1.3 - 9 -
Page 12
Installation User Manual CANoe Test Hardware VH1150
> Voltage Supply: Programmable voltage supply.
2.1 VH1150 Overview
Block diagram
Terminals and
CAN/LIN connector
> Controller: Control unit of the VH1150.
> Current Measurement: Measures the ECU current consumption (e.g. detection of
sleep/wake-up of an ECU).
> Fault Injection: controls ground offset, recessive level limitation of LIN line and
bus line disturbances.
> Relays: Switching the terminals 30, 15, 31’.
> CAN/LIN: Connector to attach the bus lines.
- 10 - Version 1.3 © Vector Informatik GmbH
Page 13
User Manual CANoe Test Hardware VH1150 Installation
> IO: Digital and analog input and output ports.
connector/4 mm connectors)!
Power supply, USB
and IO connectors
> Power Supply: Four pin connector for recommended power supply. 4 mm
connectors for laboratory power supply.
> USB connector: Connection to the PC. An FTDI driver is required. The device is
referenced as a COM port in the PCs hardware configuration.
Note: The device is referenced as a USB serial port in the Windows Device
Manager (section COM and LPT connections)
Caution: Neither power supply nor terminal connections must be removed nor
connected while the VH1150 operates!
Never supply the VH1150 device on both power supply connectors (four pin
© Vector Informatik GmbH Version 1.3 - 11 -
Page 14
Installation User Manual CANoe Test Hardware VH1150
that your CAN bus is properly terminated.
> Description: GS120A24-R7B
The power supply can be purchased from Vector Informatik GmbH.
must not be connected to a protective conductor.
2.2 Hardware Setup
Hardware
connections
VH1150
> VH1150 should be connected to PC or laptop using the USB cable provided.
> An external power supply (12-28 V) is required for the VH1150. Please note that
the power supply is not included in the scope of delivery. For a power supply
recommendation please refer to chapter 2.2.2 Recommended Power Supply.
> The external power supply can be connected to the VH1150 via the 4 mm
connectors or the four pin connector.
> The ECU supply lines should be connected to the ECU’s terminals for ignition
(15), battery (30) and ground (31’).
> Required bus lines must be connected to the CAN/LIN connector. Please ensure
2.2.1 Required Power Supply
Output Voltage
Output Voltage
(reduced VH1150 output current)
Output Current
2.2.2 Recommended Power Supply
22 V – 28 V (+- 0.3 V)
12 V – 22 V (+- 0.3 V)
5.0 A
- 12 - Version 1.3 © Vector Informatik GmbH
> Manufacturer: Mean Well
Caution: The Mean Well power supply connects internally ground to the protective
conductor (PE). Therefore, the ground line or any other line of the VH1150 device
Page 15
User Manual CANoe Test Hardware VH1150 Installation
> Windows 2000 with Service Pack 4
> CANoe version 7.1 or higher
FTDI driver
Version 2.08.30 or higher (http://www.ftdichip.com/Drivers/VCP.htm)
the installation steps below:
VH1150.
Uninstall
FTDI and CANoe driver can be uninstalled using the standard Windows mechanism.
Package) the VH1100 has to be selected although a VH1150 is used as real device.
(see figure below).
2.3 Software Requirements
Operating system
CANoe version
> Windows 7, 8
> Windows VISTA
> Windows XP with Service Pack 2
> CANoe version 8.0 SP4 or higher for Windows 8
> CANoe version 7.2 SP3 or higher for Windows 7
2.4 Software Installation
Installation Please ensure that you have administrator access rights for your PC before following
1. Install or update CANoe.
2. Close CANoe application.
3. Update VH1150 CANoe driver (see Installtion CD).
4. Install or update the FTDI driver (see Installtion CD).
5. Connect all hardware as described in chapter 2.2 Hardware .
6. After successful installation please connect the VH1150 via USB interface to your
PC. Power up your VH1150. Windows should automatically recognize the
2.5 Compatibility with VH100
Compatibility The VH1150 is backward compatible to the VH1100. This means, in configuration
dialogs of older CANoe versions (e.g. LIN Conformance Test Module, VAG Test
2.6 Configuring VH1150
VHDevDLL.dll The API (see chapter 4 API) to control the VH1150 is implemented in the
VHDevDLL.dll. The DLL can be found in the EXEC32 directory of the CANoe
installation. To use the API the VHDevDLL.dll has to be attached to a test module
Note: The VHDevDLL.dll must not be attached to a network node. The VHDevDLL.dll
always requires the context of a test module.
© Vector Informatik GmbH Version 1.3 - 13 -
Page 16
Installation User Manual CANoe Test Hardware VH1150
Configuration of
VHDevDLL.dll
- 14 - Version 1.3 © Vector Informatik GmbH
Page 17
User Manual CANoe Test Hardware VH1150 Technical Data
3 Technical Data
In this chapter you find the following information:
3.1 Output Voltage Terminal 15/30 page 16
3.2 Measurement of Output Current page 16
3.3 Relay for Terminals page 16
3.4 Ground Offset for DUT Supply page 17
3.5 Ground Offset LIN Line page 17
3.6 LIN Recessive Level Limit page 18
3.7 Device IOs page 18
Analog Input Port
Analog Output Port
Digital Output Port
Digital Input Port
I/O Connector Pin Assignment
3.8 Short Circuit and Interruption of CAN, LIN page 20
Y Cable
Connector CAN/LIN
© Vector Informatik GmbH Version 1.3 - 15 -
Page 18
Technical Data User Manual CANoe Test Hardware VH1150
3.1 Output Voltage Terminal 15/30
Parameter Value Range
Voltage Range 2 – 28 V
Output Current @ input voltage >= 22V Max. 2.5 A
Output Short-circuit proof
Accuracy Output Voltage +- 60 mV
Typical Settling Time <= 5 ms
3.2 Measurement of Output Current
Parameter Value
Measurement location Supply line to the ECU
Accuracy +- 2 % or 0.5 mA
3.3 Relay for Terminals
Parameter Value Range
Relay Terminal 30
Typical switching time 7 ms
Terminal 15
Terminal 31’
- 16 - Version 1.3 © Vector Informatik GmbH
Page 19
User Manual CANoe Test Hardware VH1150 Technical Data
3.4 Ground Offset for DUT Supply
Block diagram
ground offset
Parameter Value Range
Offset Voltage Terminal 31’ 0 – 10 V
Terminal 31 Supply Ground
Accuracy +- 50 mV
3.5 Ground Offset LIN Line
Principle ground
offset LIN line
© Vector Informatik GmbH Version 1.3 - 17 -
Page 20
Technical Data User Manual CANoe Test Hardware VH1150
batt
The VH1150 fault injection unit allows to limit the LIN recessive level.
Parameter Value Range
Offset Range VS 2.5 – 17.5 V
Operation Range V
Accuracy +- 50 mV
Settling Time 100 ms or faster
6.0 – 28.0 V
3.6 LIN Recessive Level Limit
Parameter Value Range
V_LIN_Rec_min 3.0 V
V_LIN_Rec_max 28.0 V
V_LIN_Rec
Accuracy
Settling Time 100 ms
General V_Batt > V_LIN_Rec
+-70 mV
in the range 3 V to (V_Batt-3V)
3.7 Device IOs
3.7.1 Analog Input Port
3.7.2 Analog Output Port
Parameter Value Range
Measurement Range 0 – 30 V
Accuracy +- 1 % of full scale
Input Resistance > 500 kOhm
Max Voltage +- 40 V
Parameter Value Range
Voltage Range 0 – 15 V
Accuracy +- 0.5 %
Output Current +- 5 mA
Short circuit proof
- 18 - Version 1.3 © Vector Informatik GmbH
Page 21
User Manual CANoe Test Hardware VH1150 Technical Data
3.7.3 Digital Output Port
Parameter Value Range
Output Type Open drain with 3.3 kOhm pull-up to V
Current I_low max 100 mA @ V = 0.2 V
Max Voltage 30 V
3.7.4 Digital Input Port
Parameter Value Range
Switching Threshold 1.5 – 2.5 V
Input Resistance > 10 kOhm
Max Voltage Max. 40 V
3.7.5 I/O Connector Pin Assignment
Pin
D-Sub 9 connector (female)
batt
Caution: The current must not exceed
100mA! Do not attach a power supply to
the port!
Description
.
1 Digital input
2 Not available
3 Terminal 31’
4 Not used
5 Analog input
6 Digital output
7 Terminal 30
8 Terminal 15
9 Analog output
Caution: Do not draw over 0.5 A at any pin. Especially, this applies for the terminals
30, 15 and 31’.
© Vector Informatik GmbH Version 1.3 - 19 -
Page 22
Technical Data User Manual CANoe Test Hardware VH1150
and interruption
> CAN_L interrupted
3.8 Short Circuit and Interruption of CAN, LIN
Connection CAN/LIN
line for short circuit
Possible short
circuits
The CAN/LIN lines are routed over the VH1150 to the DUT.
The CAN/LIN lines can be interrupted or short-circuited.
> CAN_H/LIN – ground
> CAN_L – ground
> CAN_H/LIN – V
> CAN_L – V
> CAN_H – CAN_L
> CAN_H/LIN interrupted
batt
batt
3.8.1 Y Cable
Y cable
Connector Type
Connector Tester D-Sub 9 connector (female)
Connector DUT D-Sub 9 connector (male)
Connector VH1150 D-Sub 9 connector (female)
- 20 - Version 1.3 © Vector Informatik GmbH
Page 23
User Manual CANoe Test Hardware VH1150 Technical Data
Y cable wiring
© Vector Informatik GmbH Version 1.3 - 21 -
Page 24
Technical Data User Manual CANoe Test Hardware VH1150
3.8.2 Connector CAN/LIN
Pin
D-Sub 9 connector (male)
1 CAN_L DUT
2 CAN_L Tester CAN low connection of the
3 CAN GND Cab Connected to terminal 31
4 Pdis LINcab/LINpiggy forced to
5 – Not used
6 – Not used
7 CAN H / LIN Tester CAN/LIN connection
8 CAN H / LIN DUT CAN/LIN connection ECU
9 CAN VB+ Can be switched with relay
Note: For CAN and LIN tests it is required that the DUT is also connected to the
supply terminals 30 (VBat) or 15 (IGN) and 31’ (GND).
Name Description
CAN low connection of the
device (DUT)
CANcab/CANpiggy
external supply
Tester
(DUT)
to V
batt
- 22 - Version 1.3 © Vector Informatik GmbH
Page 25
User Manual CANoe Test Hardware VH1150 API
4 API
In this chapter you find the following information:
4.1 General Functions page 24
VHDevSearchOpen
VHDevOpen
VHDevClose
VHDevSetSafeState
VHDevGetHWRevision
VHDevResetOverload
VHDevGetOverload
VHDevSetDebugFlag
4.2 Terminal Control and Measurement page 28
VHDevSetRelay
VHDevSetRelayEx
VHDevGetVoltage
VHDevGetCurrent
VHDevSetVoltageVBatt
VHDevSetVoltageVBattEx
VHDevSetCurrentMeasurementRange
4.3 Ground Offset and LIN Recessive Limit page 33
VHDevSetGroundOffset
VHDevSetTesterBusGroundOffset
VHDevSetLINRecessiveVoltageLimit
4.4 Device Inputs/Outputs page 35
VHDevSetAnalogOutput
VHDevSetDigitalOutput
VHDevSetLINCabSupplyMode
VHDevGetAnalogInput
VHDevGetDigitalInput
4.5 Bus Line Disturbance page 38
VHDevSetBusFaults
VHDevSetPeriodicalLINBusFault
4.6 CAN Network page 40
VHDevMeasureCANTermResistor
VHDevSetCANCapacitors
VHDevMeasureCANDiffVoltage
4.7 Error Codes page 42
© Vector Informatik GmbH Version 1.3 - 23 -
Page 26
API User Manual CANoe Test Hardware VH1150
deviceType[], char deviceName[], int buffSize)
ERR_OPEN_NO_REPLACEMENT_FOUND
Automation Explorer (MAX).
4.1 General Functions
4.1.1 VHDevSearchOpen
Syntax
Function
Parameters
long VHDevSearchOpen (long handle[1], char
At first, the function tries to open a VH1100 device if National
Instruments driver is installed. The function builds a list of
compatible devices as known by the National Instruments driver.
If this list contains more than one entry, no device will be opened
and the function returns the error code
ERR_OPEN_NO_REPLACEMENT_FOUND. If the list contains exactly
one entry, the function opens this device.
If no VH1100 device is found the function tries to open a VH1150
device.
The function opens the first compatible device. If no compatible
device is found, the function returns the error code
.
handle
This function returns a handle. The handle is valid if the function
returns zero, otherwise the handle must not be used.
deviceType
Returns the type of the current device. Either VH1100 or VH1150.
deviceName
Returns the name of the actual used device.
> VH1150
The COM-PortID referring to the device as a one or two-digit
number encoded as string.
> VH1100
The name of the device as specified in the Measurement and
buffSize
Size of the buffers deviceType and deviceName.
Returns
0 on success, handle is valid. Otherwise see Error Codes.
Support VH1100 VH1150
• •
- 24 - Version 1.3 © Vector Informatik GmbH
Page 27
User Manual CANoe Test Hardware VH1150 API
handle[1])
automatically search for the correct port.
long VHDevClose (long handle)
4.1.2 VHDevOpen
Syntax
Function
Parameters
Returns
long VHDevOpen (char deviceName[], long
Opens the specified VH device. The format of the parameter
deviceName determines whether the function opens a VH1100 or
VH1150 device.
deviceName
> VH1100
The name of the device as specified in the Measurement and
Automation Explorer (MAX). Typical names are dev1 or dev2.
> VH1150
COM-PortID encoded as string. The COM-PortID is a one or
two digits number and identifies the COM port of the VH1150.
There can be entered any value from 0-99. The function will
handle
The function returns a handle. The handle is valid if the function
returns zero, otherwise the handle must not be used.
0 on success, handle is valid. Otherwise see Error Codes.
Support VH1100 VH1150
• •
4.1.3 VHDevClose
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
• •
Closes an opened device.
Calling this function invalidates the handle.
handle
A handle referencing the VH device.
0 on success, handle is valid. Otherwise see Error Codes.
© Vector Informatik GmbH Version 1.3 - 25 -
Page 28
API User Manual CANoe Test Hardware VH1150
long VHDevSetSafeState (long handle)
hwRev[1])
4.1.4 VHDevSetSafeState
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
4.1.5 VHDevGetHWRevision
Syntax
Function
Sets the device in a defined and secure state.
Note: This function requires Hardware Revision Number ≥ 2.
handle
A handle referencing the VH device.
0 on success, handle is valid. Otherwise see Error Codes.
–
long VHDevGetHWRevision (long handle, long
Retrieves the hardware revision number.
This number describes the features of the VH device. API functions
may require a certain hardware revision number. For example the
function VHDevStartVoltageProfile for a VH1100 device
requires a HRN of >1. If the application uses such a function, the
application should first check the HRN and handle the case when
the HRN is too low.
Note: The HRN cannot be used to distinguish between a VH1100
and VH1150.
•
handle
A handle referencing the VH device.
Parameters
hwRev
The hardware revision number.
Returns
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
• •
- 26 - Version 1.3 © Vector Informatik GmbH
Page 29
User Manual CANoe Test Hardware VH1150 API
long VHDevResetOverload (long handle)
overloadState[1])
> 1=device is in overload state
long VHDevSetDebugFlag (long debugFlag)
> 1=enable
4.1.6 VHDevResetOverload
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
4.1.7 VHDevGetOverload
Syntax
Function
Terminates the Overload state of the device.
Calling this function has no effect when the device is not in the
Overload mode. If an overload condition (e.g. short circuit on
output) is pending, the device may go back into its overload state.
handle
A handle referencing the VH device.
0 on success. Otherwise see Error Codes.
–
long VHDevGetOverload (long handle, long
Retrieves the overload state of the VH1150 device.
handle
A handle referencing the VH device.
•
Parameters
Returns
Support VH1100 VH1150
4.1.8 VHDevSetDebugFlag
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
overloadState
Function returns:
> 0=normal state
0 on success. Otherwise see Error Codes.
–
Sets the debug option flag to enable debug output into the CANoe
Write Window.
debugflag
> 0=disable
0 on success. Otherwise see Error Codes.
•
• •
© Vector Informatik GmbH Version 1.3 - 27 -
Page 30
API User Manual CANoe Test Hardware VH1150
long state)
> 2=V31
> 1=closed.
4.2 Terminal Control and Measurement
4.2.1 VHDevSetRelay
Syntax
Function
Parameters
Returns
long VHDevSetRelay (long handle, long selector,
Switches the specified relay.
VH1150:
The ground line relay (GND, 31) can be controlled only if the
ground offset is turned off.
handle
A handle referencing the VH device.
selector
Selects the relay:
> 0=V30
> 1=V15
state
Relay contacts:
> 0=open
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
• •
- 28 - Version 1.3 © Vector Informatik GmbH
Page 31
User Manual CANoe Test Hardware VH1150 API
long state, long relaySettleTime)
> 2=V31
4.2.2 VHDevSetRelayEx
Syntax
Function
long VHDevSetRelayEx (long handle, long selector,
Switches the specified relay.
This function should be used for special applications only, in most
applications VHDevSetRelay can be used instead.
VH1150:
The ground line relay (GND, 31) can be controlled only, if the
ground offset is turned off.
handle
A handle referencing the VH device.
selector
Selects the relay:
> 0=V30
> 1=V15
Parameters
state
Relay contacts 0=open, 1=closed
relaySettleTime
Relay settle time in ms. The function sends the relay command to
the VH device and waits the specified time before it returns to the
caller. A settleTime of zero is valid.
Returns
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
• •
© Vector Informatik GmbH Version 1.3 - 29 -
Page 32
API User Manual CANoe Test Hardware VH1150
double voltage[1])
This value is valid only when ground offset is turned on.
double current[1])
4.2.3 VHDevGetVoltage
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
• •
4.2.4 VHDevGetCurrent
long VHDevGetVoltage (long handle, long selector,
Retrieves a voltage value at the specified terminal.
handle
A handle referencing the VH device.
selector
> 0=V30
> 1=V15
VH1150:
> 2=V31
Voltage
The measured voltage in volts.
0 on success. Otherwise see Error Codes.
Syntax
Function
Parameters
Returns
long VHDevGetCurrent (long handle, long range,
Retrieves the measured current at the terminals 30/15.
VH1100:
The caller is responsible to set an appropriate range selector.
handle
A handle referencing the VH device.
range
> 0=low up to 200 mA
> 1=high up to 2 A
VH1150:
parameter is ignored.
current
The measured current in milli amps (mA).
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
• •
- 30 - Version 1.3 © Vector Informatik GmbH
Page 33
User Manual CANoe Test Hardware VH1150 API
voltage)
voltage, long settleTime)
VHDevSetVoltageVBatt
4.2.5 VHDevSetVoltageVBatt
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
• •
4.2.6 VHDevSetVoltageVBattEx
Syntax
Function
long VHDevSetVoltageVBatt (long handle, double
Sets the output voltage V
handle
A handle referencing the VH device.
voltage
Output voltage in volts.
0 on success. Otherwise see Error Codes.
long VHDevSetVoltageVBattEx (long handle, double
Sets the output voltage V
This function should be used for special applications only, in most
applications
of the device.
batt
of the device.
batt
can be used instead.
handle
A handle referencing the VH device.
voltage
Parameters
Returns
Output voltage in volts.
settleTime
Settle time in ms. The function sends the set voltage command to
the device, waits the specified settleTime, and returns to the caller.
A settleTime of zero is valid.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
• •
© Vector Informatik GmbH Version 1.3 - 31 -
Page 34
API User Manual CANoe Test Hardware VH1150
long range)
> 2=high range.
4.2.7 VHDevSetCurrentMeasurementRange
Syntax
Function
Parameters
Returns
long VHDevSetCurrentMeasurementRange(long handle,
Sets the current measurement range.
Note: It is not possible to select the low current measurement
range.
Note: This function requires Hardware Revision Number ≥ 5.
handle
A handle referencing the VH device.
range
> 0=automatic, device selects the current measurement range.
This is the default behavior.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
•
- 32 - Version 1.3 © Vector Informatik GmbH
Page 35
User Manual CANoe Test Hardware VH1150 API
offsetVoltage)
4.3 Ground Offset and LIN Recessive Limit
4.3.1 VHDevSetGroundOffset
Syntax
Function
Parameters
Returns
long VHDevSetGroundOffset (long handle, double
VH1150:
Shifts the ECU ground voltage by the specified value.
Note: Enabling the ground offset will turn off the features LIN
Recessive Level and Analog Output.
handle
A handle referencing the VH device.
offsetVoltage
Range 0.0 – 10.0 V.
A value of <= 0.0 turns off the ground offset feature.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
Example
–
If the ECU is supplied with a voltage of 14.4 V and the ground
offset is set to 2.0 V, the actual ECU supply voltage measured
between the pins IGN and GND' (connector 31') amounts to 12.4 V.
Note that the battery voltage, measured between the pins IGN and
GND (connector 31), remains unchanged (ie. 14.4 V). Depending
on the ECU current and offset voltage, the ground offset feature
may considerably increase the power dissipation of the VH1150.
This may cause the VH1150 to transit into its Overload state.
•
© Vector Informatik GmbH Version 1.3 - 33 -
Page 36
API User Manual CANoe Test Hardware VH1150
double offsetVoltage)
4.3.2 VHDevSetTesterBusGroundOffset
Syntax
Function
Parameters
Returns
long VHDevSetTesterBusGroundOffset (long handle,
VH1150:
Shifts the bus ground line on the tester side by the specified value.
This feature is intended to be used in LIN networks.
Note: Enabling the ground offset will turn off the features Ground
Offset, LIN Recessive Level and Analog Output.
Note: Please ensure that the LINcab is externally supplied. Please
refer to the function VHdevSetLinCabSupplyMode.
Note: This function requires Hardware Revision Number ≥ 2.
Handle
A handle referencing the VH device.
offsetVoltage
Range 0.0 – 20.0 V.
A value of <= 0.0 turns off the ground offset feature.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
Example
–
On a LIN network, the bus ground offset (on the tester side) is set
to a value of 2.0 V. If the LIN line has a recessive level, the ground
offset has no primary effect. Both, the tester and the ECU, measure
the recessive level on the LIN bus.
If the tester sets its dominant level, the ECU sees a LIN voltage of
about 2.7 V. This value results from the 2.0 V offset and a 0.7 V
voltage over a diode in the drain – source path of the tester
transceiver transistor. Thus, the Tester Ground Offset feature
allows to increase the dominant level recognized by the ECU.
Typically, the LIN transceiver of the tester is supplied by the
VH1150. Even if the tester transceiver is setup to generate its own
supply voltage, the Tester Ground Offset feature can be used.
•
- 34 - Version 1.3 © Vector Informatik GmbH
Page 37
User Manual CANoe Test Hardware VH1150 API
handle, double recessiveVoltage)
analogOutputVoltage)
4.3.3 VHDevSetLINRecessiveVoltageLimit
Syntax
Function
Parameters
Returns
long VHDevSetLINRecessiveVoltageLimit (long
VH1150:
Limits the recessive LIN voltage level to the specified value.
Note: Turning on the LIN recessive voltage will turn off the features
Analog Output and Ground Offset.
handle
A handle referencing the VH device.
recessiveVoltage
Range 0.0 – 28.0 V.
A value of <= 0.0 turns the feature off.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
Example
–
The ECU is supplied with a voltage of 14.4 V and the recessive
voltage is set to 9.5 V. This limits a LIN recessive bit (high) to 9.5
V. If the LIN recessive voltage is set to a value larger than the
master's battery voltage (in this example > 14.5 V) the recessive
voltage remains unchanged.
•
4.4 Device Inputs/Outputs
4.4.1 VHDevSetAnalogOutput
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
long VHDevSetAnalogOutput (long handle, double
VH1150:
Sets the Analog Output voltage to the specified value.
batt
batt
.
. This
The output voltage is derived from the battery voltage V
means the analog output voltage will never exceed V
Note: Turning on the Analog Output will turn off the features LIN
recessive voltage and Ground Offset.
handle
A handle referencing the VH device.
analogOutputVoltage
Range 0.0 – 28.0 V.
A value of <= 0.0 turns off the feature.
0 on success. Otherwise see Error Codes.
© Vector Informatik GmbH Version 1.3 - 35 -
–
•
Page 38
API User Manual CANoe Test Hardware VH1150
state)
> 1=true=high
mode)
none, the LINcab is not supplied!
4.4.2 VHDevSetDigitalOutput
Syntax
Function
Parameters
Returns
long VHDevSetDigitalOutput (long handle, long
VH1150:
Sets the digital output to the specified state.
handle
A handle referencing the VH device.
state
> 0=false=low
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
4.4.3 VHDevSetLINCabSupplyMode
Syntax
Function
long VHDevSetLINCabSupplyMode (long handle, long
VH1150:
Sets the voltage supply mode of the LINcab connected to the
Cab/Piggy connector of the VH1150 Y cable.
•
handle
A handle referencing the VH device.
mode
> 0=internal
Parameters
Returns
LINcab produces its own 12V supply voltage.
> 1=external/internal
If an external supply voltage > 12V is available (pin 9) it will be
used. Otherwise, the LINcab produces its own supply voltage.
> 2=external
The LINcab uses the external supply voltage (pin 9). If there is
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
•
- 36 - Version 1.3 © Vector Informatik GmbH
Page 39
User Manual CANoe Test Hardware VH1150 API
analogInputVoltage[1])
digitalInputState[1])
> 1=true (high voltage)
4.4.4 VHDevGetAnalogInput
Syntax
Function
Parameters
Returns
Support VH1100 VH1150
4.4.5 VHDevGetDigitalInput
Syntax
Function
long VHDevGetAnalogInput (long handle, double
VH1150:
Retrieves the digital input state.
handle
A handle referencing the VH device.
analogInputVoltage
Measured voltage in volts.
0 on success. Otherwise see Error Codes.
–
long VHDevGetDigitalInput (long handle, long
VH1150:
Retrieves the digital input state.
handle
A handle referencing the VH device.
•
Parameters
Returns
digitalInputState
Function returns:
> 0=false (low voltage)
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
•
© Vector Informatik GmbH Version 1.3 - 37 -
Page 40
API User Manual CANoe Test Hardware VH1150
passThru, long CanH, long CanL)
> 3=CAN_H and CAN_L are interrupted
> 3=connected to CAN_L, parameter CanL is ignored (CAN only)
> 2=connected to V
batt
4.5 Bus Line Disturbance
4.5.1 VHDevSetBusFaults
Syntax
Function
Parameters
long VHDevSetBusFaults (long handle, long
VH1150:
Interrupts or connects the CAN/LIN lines to ground or V
The mode is specified by three parameters. In the following
description CAN_H corresponds to LIN.
Note: Enabling this function will turn off the LIN periodical short to
ground.
handle
A handle referencing the VH device.
passThru
> 0=normal operation CAN_H and CAN_L are not interrupted
> 1=CAN_H interrupted / LIN interrupted
> 2=CAN_L interrupted
CanH / LIN
> 0=nomal operation
> 1=connected to GND
> 2=connected to V
batt
batt
.
CanL
> 0=nomal operation
> 1=connected to GND
Returns
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
•
- 38 - Version 1.3 © Vector Informatik GmbH
Page 41
User Manual CANoe Test Hardware VH1150 API
long mode, double frequency)
> 2=fast periodic short connection to V
batt
4.5.2 VHDevSetPeriodicalLINBusFault
Syntax
Function
Parameters
Returns
long VHDevSetPeriodicalLINBusFault(long handle,
Switches the LIN line periodically to either GND or V
Note: Enabling this function will turn off the LIN bus faults.
Note: This function requires hardware revision number ≥ 4.
handle
A handle referencing the VH device.
modes
> 0=normal operation, short connection disabled
> 1=fast periodic short connection to GND
frequency
Frequency of short connection in Hertz.
1/(2*f) = time span of connection to GND or VBatt.
Allowed range: 2 Hz - 50 kHz.
0 on success. Otherwise see Error Codes.
batt
.
Support VH1100 VH1150
–
•
© Vector Informatik GmbH Version 1.3 - 39 -
Page 42
API User Manual CANoe Test Hardware VH1150
termResNegMeasVoltage [1])
4.6 CAN Network
4.6.1 VHDevMeasureCANTermResistor
long VHDevMeasureCANTermResistor(long handle,
Syntax
Function
Parameters
double termResPosMeasVoltage[1] , double
Measures the CAN termination resistor between the CAN_H and
CAN_L lines. The termination resistor is measured twice by
inverting the polarity of the measurement voltage. One
measurement uses a positive CAN_H to CAN_L voltage, whereas
the other measurement puts CAN_L on a higher voltage than
CAN_H.
Note: This function requires hardware revision number ≥ 4.
handle
A handle referencing the VH device.
termResPosMeasVoltage
The measured termination resistor value in Ohm. The
measurement is carried out with a positive CAN_H to CAN_L
measurement voltage.
termResNegMeasVoltage
The measured termination resistor value in Ohm. The
measurement is carried out with a negative CAN_H to CAN_L
measurement voltage.
Returns
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
•
- 40 - Version 1.3 © Vector Informatik GmbH
Page 43
User Manual CANoe Test Hardware VH1150 API
enable)
lines.
double vDominant[1])
4.6.2 VHDevSetCANCapacitors
Syntax
Function
Parameters
Returns
long VHDevSetCANCapacitors (long handle, long
Switches capacitors to the CAN_H and CAN_L lines. The other
ends of the capacitors are connected to GND. Each capacitor has
capacitance of 1.6 nF.
Note: This function requires hardware revision number ≥ 4.
handle
A handle referencing the VH device.
enable
> 0=capacitors are switched off, i.e. they are not connected to the
CAN lines.
> 1=capacitors are switch on, i.e. they are connected to the CAN
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
–
4.6.3 VHDevMeasureCANDiffVoltage
•
long VHDevMeasureCANDiffVoltage (long handle,
Syntax
Function
Parameters
Returns
double measurementPeriod, double vRecessive[1],
Measures the recessive and dominant voltage of the differential
CAN signal.
Note: This function requires hardware revision number ≥ 4.
handle
A handle referencing the VH device.
measurementPeriod
Duration of measurement in ms. If measurementPeriod is <= 0,
the de-fault value of 1000 ms is used.
vRecessive
Measured recessive (logic level H or 1) voltage of U_CAN_diff in
Volts.
vDominant
Measured dominant (logic level L or 0) voltage of U_CAN_diff in
Volts.
0 on success. Otherwise see Error Codes.
Support VH1100 VH1150
© Vector Informatik GmbH Version 1.3 - 41 -
–
•
Page 44
API User Manual CANoe Test Hardware VH1150
4.7 Error Codes
Error Code Error No. Comment
ERR_OK 0
ERR_FAILED -1
ERR_INVALID_HANDLE 2
ERR_NOT_IMPLEMENTED 3
ERR_INVALID_PARAMETER 4
ERR_DEVICE_INUSE 5
ERR_VIA_NL 6
ERR_VIA_CAST 7
ERR_AINFAILED 8
ERR_AINNODATA 9
ERR_DRIVERDLL_NOT_LOADED 10 Unable to load driver DLL
ERR_INTERNAL_NONL 11 Internal error, node layer not
available
ERR_VOLTAGEPROFILE_RUNNNING 12 Function call cot allowed at this
time
ERR_HARDWARE_REV_NUMBER
_TOO_LOW
ERR_CALIB_FAILED 14
ERR_OPEN_NO_REPLACEMENT
_FOUND
ERR_INCOMPATIBLE_DEVICE 16 This type of device cannot
ERR_NO_ANSWER_FROM
_INTERFACE
13 Newer hardware required
15 Open of specified device
failed. Too many or no
compatible devices found
handle the command
17 Interface is not responding
- 42 - Version 1.3 © Vector Informatik GmbH
Page 45
User Manual CANoe Test Hardware VH1150 Index
5 Index
A
Analog Input Port ................................................ 18
Analog Output Port ............................................. 18
API ...................................................................... 23
C
Connector CAN/LIN ............................................ 22
D
Device IOs .......................................................... 18
Digital Input Port ................................................. 19
Digital Output Port .............................................. 19
E
Error Codes ........................................................ 42
G
Ground Offset
DTU Supply ............................................... 15, 17
LIN Line ..................................................... 15, 17
H
Hardware Setup .................................................. 12
R
Relay for Terminals ............................................ 16
S
Short Circuit ................................................. 15, 20
Software
Installation ................................................... 9, 13
Requirements.............................................. 9, 13
T
Technical Data ................................................... 15
V
VH1150
Overview ....................................................... 3, 4
USB Hardware ............................................ 9, 10
VHDevClose ...................................................... 25
VHDevGetAnalogInput....................................... 37
VHDevGetCurrent .............................................. 30
VHDevGetDigitalInput ........................................ 37
VHDevGetHWRevision ...................................... 26
VHDevGetOverload ........................................... 27
VHDevGetVoltage .............................................. 30
I
I/O Connector Pin Assignment ........................... 19
Interruption .................................................... 15, 20
L
LIN Recessive Level Limit .................................. 18
M
Measurement of Output Current ......................... 16
VHDevMeasureCANDiffVoltage ........................ 41
VHDevMeasureCANTermResistor .................... 40
VHDevOpen ....................................................... 25
VHDevResetOverload........................................ 27
VHDevSearchOpen ........................................... 24
VHDevSetAnalogOutput .................................... 35
VHDevSetBusFaults .......................................... 38
VHDevSetCANCapacitors ................................. 41
VHDevSetCurrentMeasurementRange ............. 32
O
Output Voltage Terminal 15/30 ........................... 16
P
Power Supply
Recommended ................................................ 12
Required .......................................................... 12
© Vector Informatik GmbH Version 1.3 - 43 -
VHDevSetDebugFlag......................................... 27
VHDevSetDigitalOutput ..................................... 36
VHDevSetGroundOffset..................................... 33
VHDevSetLINCabSupplyMode .......................... 36
VHDevSetLINRecessiveVoltageLimit ................ 35
Page 46
Index User Manual CANoe Test Hardware VH1150
VHDevSetPeriodicalLINBusFault ....................... 39
VHDevSetRelay .................................................. 28
VHDevSetRelayEx .............................................. 29
VHDevSetSafeState ........................................... 26
VHDevSetTesterBusGroundOffset ..................... 34
VHDevSetVoltageVBatt ..................................... 31
VHDevSetVoltageVBattEx ................................. 31
Y
Y Cable .............................................................. 20
- 44 - Version 1.3 © Vector Informatik GmbH
Page 47
Page 48
More Information
> News
> Products
> Demo Software
> Support
> Training Classes
> Addresses
www.vector.com
Loading...