Vector: CANape¶

Vendor information

Vendor	Web page	Product name	Version
Vector Informatik GmbH	http://www.vector.com	CANape	14 SP4, tested up to 24

Operating system	Support
Windows	✓
Linux

Ports¶

Specifics¶

Reading and writing calibration quantities¶

In reading and writing calibration quantities which use supporting points (map and curve), the supporting points can only be seen and modified in ecu.test if they are available in the form of references to signals which are defined as well. If the supporting points exist in other forms no access is possible due to a restriction on the part of CANape, and the corresponding fields in the parameterization dialog of the test step will remain empty.

Info

Reading and recording the running value of a curve or map is currently not supported.

Reading and Recording of Measurements¶

ecu.test supports reading and recording of scalar, vector and matrix values as measurements. The individual elements of vectors and matrices can only be used if these elements are listed in the A2L file, such as scalar values in the form <Measurement name>_[<index>].

Note: We recommend setting MDF4 as the recording format in CANape. With MDF3, it can happen that the recording file is not sorted and therefore cannot be used in trace analysis.

Execution of Wake-Up Tests¶

If a control unit is tested which has not yet been activated at the beginning of the test execution, the start of the measurement can be controlled manually (tool property “Start of measurement” -> “Manual”). In the test case, it is possible to activate the terminals and to start the measurement by using the tool jobs InitializeHardware and StartMeasurement.

Note: Before accessing calibration variables, the device should be activated in CANape. Before: measurement variables are accessed, the measurement must also be started.

Advice regarding UseNAN¶

When accessing ECU values, receiving a special value (in CANape nan, in ecu.test ~NotPresent~) in case there is no value available yet, can be useful. This allows using Wait until true for the initial value, or checking whether the transfer of values from the ECU is actually happening.

For this purpose, the option Old behavior for read-bus/-measurement has to be set to False.

Sadly, this setting also causes bus signals to have a value only when the signal that is being read is contained in the most recently received message. Otherwise, the bus signal’s value is also given as nan or ~NotPresent~. For measurements from the ECU, this scenario does not occur.

If the option Old behavior for read-bus/-measurement is set to True, bus signals always provide the most recently received value. However, both for measurements from the ECU which have no value available yet, as well as for bus signals contained in a message that has not yet been received, the value 0 is provided instead of nan or ~NotPresent~.

Specifying the aquisition rate of mapped items¶

In the MEAS section of a Mapping-Items edit-dialog for CANape-Values you can set the aquisiton rate to polling#1234. The same is possible with the keyword cyclic. For more informations regarding Mapping-Items and their aquisition-rate please see here.

Configuration start with an active CANape process¶

In order for ecu.test to be able to control a manually started CANape instance, it must be put into ASAP3 mode by pressing the corresponding button Tools->ASAP3. The following restrictions apply:

The CNA file cannot be specified in the test bench configuration.
The TBC option Shut down on exit must be set to False.

These restrictions do not apply if the CANape instance was originally started by ecu.test (or with the -u command line option).

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
CANape project				uri	CANape project (Directory or CNCC file). Attention, if a directory is specified, its contents get modified! (absolute path or relative to the specified base path).
.cna file				string	Filename of the .cna file. If empty, CANape will use the most recent .cna file referenced in the CANape project. If the project does not reference any .cna files, loading a .cna file can cause a modal dialog for saving the current configuration as a .cna file. To avoid this, either leave this setting empty, or use a project that references a .cna file.
Use CANape Test Bench Edition		☐		bool	CANape will be started in Test Bench Edition mode if set to True.
CANape installation	Use CANape Test Bench Edition: ‘False’			string	Choice of CANape Installation to use, by Installation path
Start of measurement		‘Automatic’	[‘Automatic’, ‘Manual’]	string	Automatic: Measurement start automatically at test start (in case there are signals used). If the measurement is to be started automatically, all devices that have not been started are activated and set online.
Synchronous start of measurement		☑		bool	Wait until CANape started the measurement before starting the test if set to True.
Timeout for synchronous start of measurement		10		int	Timeout in [s] for starting the synchronous measurement.
Buffersize of FIFO		‘Default’		string	Number of samples held in memory by CANape. There are distributed over 23 FIFO buffers in CANape. Each buffer is assigned to an acquisition rate. (max=2944, default=230)
Sample size		‘Default’		string	Number of measurement values in each sample. (max=256, default=128)
CANape version		‘determined at runtime (only for the test report)’		string	Used version of CANape
Script timeout		30		int	Timeout (in s) for CANape script execution
CANape GUI		‘full’	[‘full’, ‘only write window’, ‘hidden’]	string	To increase performance and stability, the visibility of CANape can be restricted.
Shutdown on exit		☐		bool	Should CANape be shut down if the tool is closed?
Old behavior for read-bus/-measurement		☑		bool	Deactivates UseNAN. See section ‘Advice regarding UseNAN’ in the ecu.test user documentation, chapter Tools -> CANape
Collective device ‘_All_’ for trace analysis of MDF3 recordings		☐		bool	In the trace analysis MDF3 recordings will be processed with the ‘_All_’ device. Thus, the signals of any actual recorded device can be addressed by a single signal group via corresponding mappings.
Disable all recorders that are not used by ecu.test.		☐		bool	CANape starts all existing recorders automatically when the measurement ist started. If this option is active all recorders that are not used by ecu.test are disabled.
Timeout for tool call ❲in sec.❳		‘600’		string	Timeout after which a tool call is aborted.

Jobs 🛈¶

GetCANapeLog¶

Copies the CANape log file into the report directory.

Parameter

Name	Available if	Default value	Valid values	Type	Description
Path		‘PROJECT_ROOT\\CANape.log’		string	Path to log file - PROJECT_ROOT correlates to the report directory.

InitializeHardware¶

Activates all registered Devices and sets them online. Previously, active Devices are set offline and deactivated.

Parameter

Name	Available if	Default value	Valid values	Type	Description
measStartReconnectDevicesDelay		0		float	Time between switching offline and re-activating /switching online (in seconds).

InitVariable¶

Adds the specified signal to the Experiment (needed for ReadVariable). If a measurement is currently running, it will be stopped and re-started.

Parameter

Name	Type	Description
DeviceName	string	Name of device in CANape
Rate	string	Name of acquisition rate
VariableName	string	Name of value to be initialized

ReadVariable¶

reads a value from experiment (use InitVariable before!) Always returns a scalar.

Parameter

Name	Available if	Default value	Valid values	Type	Description
DeviceName				string	Name of device to be read from
VariableName				string	Name of quantity to be read

RunCANapeScript¶

Runs a CANape script

Parameter

Name	Available if	Default value	Valid values	Type	Description
SourceCode				string	Script code to be executed

StartMeasurement¶

Starts the measurement

StopMeasurement¶

Stops the measurement