CANoe InstallationQuickStartGuide
CANoe InstallationQuickStartGuide
CANoe InstallationQuickStartGuide
CANoe
Version 10.0.3
English
Imprint
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 maximum extent permitted
under law, all technical data, texts, graphics, images and their design are protected by copyright law, various international treaties and
other applicable law. Any unauthorized use may violate copyright and other applicable laws or regulations.
Copyright 2017, Vector Informatik GmbH. Printed in Germany.
All rights reserved.
Installation & Quick Start Guide CANoe Contents
Contents
1 Introduction 3
1.1 About this User Manual 4
1.1.1 Access Helps and Conventions 4
1.1.2 Certification 5
1.1.3 Warranty 5
1.1.4 Support 5
1.1.5 Trademarks 5
2 Installation 7
2.1 General 8
2.2 System Requirements 8
2.3 Installation Requirements 8
2.4 Installation Procedure 9
2.5 Notes on Activating a Software Based License 9
2.6 Vector USB Dongle 10
2.7 MOST 11
2.7.1 MOST150: Use with Optolyzer G2 3150o 11
2.7.2 MOST50: Use with Optolyzer G2 3050e 12
2.8 Further CANoe Options 12
2.9 Switching Language Versions 13
2.10 Running the Test 13
2.11 Troubleshooting 14
2.11.1 Hardware-Specific Error Notifications 14
3 CANoe Tour 15
3.1 Overview 16
3.2 Preparations 16
3.3 Setting up the Bus 18
3.4 Transmitting Data 20
3.5 Analysis Windows 24
3.6 Working with Symbolic Data 25
3.7 Analysis of Signal Values in the Data Window 28
3.8 Analysis of Signal Responses in the Graphics Window 30
3.9 Logging a Measurement 31
3.10 Evaluating a Logging File 33
3.11 Creating a CAPL Program 33
3.12 Simulation of Distributed Systems in CANoe 36
3.12.1 Creating the Database 37
3.12.2 Definition of System Variables 38
3.12.3 Creating Panels 40
3.12.4 Creating Network Node Models 41
4 Appendix A: Support 45
1 Introduction
To find information The user manual provides you the following access helps:
quickly > at the beginning of each chapter you will find a summary of its contents,
> in the header you see the current chapter and section,
> in the footer you see to which program version the user manual replies.
Reference: Please refer to the help of CANoe for detailed information on all topics.
Conventions In the two following tables you will find the conventions used in the user manual
regarding utilized spellings and icons.
Style Utilization
bold Blocks, surface elements, window- and dialog names of the
software. Accentuation of warnings and advices.
[OK] Push buttons in brackets
File|Save Notation for menus and menu commands
CANoe Legally protected proper names and side notes.
Source code File name and source code.
Hyperlink Hyperlinks and references.
<Ctrl>+<S> Notation for key combinations.
Symbol Utilization
This icon indicates notes and tips that facilitate your work.
Symbol Utilization
This icon indicates an introduction into a specific topic.
1.1.2 Certification
1.1.3 Warranty
Restriction of We reserve the right to modify the contents of the documentation or the software
warranty 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.1.4 Support
You need support? You can get through to our hotline at the phone number
+49 (711) 80670-200
or you send a problem report to the CANoe Support.
1.1.5 Trademarks
Protected All brand names in this documentation are either registered or non registered
trademarks trademarks of their respective owners.
2 Installation
2.1 General
Overview This manual describes the installation of the software and associated hardware. It
also describes the functional test used to check whether the software and hardware
are installed correctly.
Note: The hardware drivers on the CANoe installation CD may be newer than the
ones shipped with the hardware. Please use always the latest drivers.
Note: Please note that the CAN hardware you intend to use must be enabled for use
with CANoe.
Installation sequence Please carry out the installation in the following order:
1. Install the hardware as described in the hardware manual.
Once the hardware is installed, please carry out a driver update. For more
information on this, please see the appendix.
2. Install the software.
Other You will need (D)COM version 1.2 or later to support the COM interface.
Note: Please note that you cannot install CANoe version 3.0 or later over an older
CANoe version (CANoe version 2.5 or older). You can, however, delete the old
CANoe version, rename the old CANoe installation, or install the new CANoe
installation in a new folder. This makes it possible to work with different CANoe
versions.
Windows 10, 8.1, 7 Installation of the software is identical for these operating systems.
User profiles CANoe may only be installed on Windows local user profiles. The use of roaming
profiles is not supported and may result in incorrect behavior during and after
installation.
Installing the Options Further installation steps may be required if your package includes additional options.
Please refer to the installation notes in the manual for each option.
How to start the Please take the following steps to install the CANoe software:
installation…
1. Place the CANoe installation CD in your CD drive.
A Start window will appear, in which you can start the software installation.
If your computer is not configured to automatically launch Start windows, you can
launch the installation program SETUP.exe from the Application folder on the
CD.
2. Follow the installation program instructions.
Note: For the installation you need administrator rights.
If you are logged on as standard user (with standard user rights), you have to start
the CANoe installation program Setup.exe from the Explorer directly. A dialog is
opened to be logged on as a user with administrator rights. After that the installation
routine can be executed successfully.
Products The following products and versions support software based license protection:
> CANoe/CANalyzer ≥ 7.1
> vTESTstudio ≥ 1.0
Licensing The software product you are about to install requires a license.
The license protection method depends on the product:
> Hardware based license protection
License becomes available when USB dongle or network interface hardware is
inserted/plugged
Activation ID If the product is delivered with a software based license protection, you will find a
sticker on the CD/DVD cover, which shows an Activation ID of one of the following
formats (examples given):
> A-1A2B3C4D5F6G7-1A2B3C4D5F6G7
> ACT-0000012345-000012-123456
After installing the software you will need this Activation ID to activate the license on
your computer.
Activating a license Once the software has been installed, start the License Manager from the product
start menu command (sometimes may also be located in the Tools subfolder) and
make your selections there.
At one point you are asked to enter the Activation ID. Enter the Activation ID
exactly as printed on the sticker found on the CD/DVD cover. After the license has
been activated successfully, you can start working with your application.
Note: Some product installers may automatically start the License Manager once the
installation is complete.
Help & support Further help on activating a license is available by clicking the [Help] button in the
License Manager.
If you need further assistance with activating a license (e.g. when you do not have
Internet access from your machine to activate the license online) please direct your
questions to: activation@vector.com
Note: You can also search for a current driver in the Vector Download Center. Install
the driver with the downloaded program Setup.exe afterwards.
2.7 MOST
Reference: For help with installing the MOST hardware, please refer to the
associated installation manual.
Overview The options are designed as an add-on to the standard CANoe. A number of
standard CANoe files are replaced during installation (e.g. driver) and others are
added (e.g. sample configurations).
It is therefore important for the versions that they match properly. The installation
program tests this compatibility and issues a warning if appropriate. If there is any
incompatibility between versions, you should get in touch with Vector Support.
In addition to the sample configurations of the standard CANoe, option-specific
examples are installed in a directory.
A number of different level 7 options can be installed simultaneously in a single
directory – e.g. ISO11783, J1939, and CANopen.
Option Ethernet Please consider the following information if you install option .Ethernet.
Caution: During installation the network connection is reset. Close all applications
which rely on network connections.
Configuration The German and English language versions are installed by default during the
standard installation.
You can set the language for all of the program features and the help:
File ribbon tab|Options|Appearance|Program.
You need to close and then restart CANoe for the changes to become effective.
Prerequisite To test the CANoe software installation, the CAN hardware must be successfully
installed.
Procedure 1. Connect the two CAN ports of your CAN hardware using a cable that is
terminated in a way that is appropriate to the bus system.
2. Load the CANSystemDemo.cfg sample configuration (File ribbon tab|Open:
CANoe Sample Configurations\CAN\CANSystemDemo) and start it.
If the installation is successful, you will be able to observe CAN messages in the
Trace Window.
Result This functional test also confirms that the CAN hardware has been installed correctly.
2.11 Troubleshooting
Overview Some error notifications pertain to faulty settings in the CANcardXL driver
configuration dialog.
You can open the driver installation dialog via the Windows menu under
Start|Settings|Control Panel|Vector Hardware.
Procedure Please adapt the count of the application channels in your configuration and assign
the additional channels to the network interfaces.
No. 4001: The hardware associated with CAN channel X is not present!
Procedure Verify your PC card is inserted. Check the PC card (PCMCIA) settings and CAN
hardware settings in your panel!
Procedure Verify your PC card is inserted. If so, please (re-)install the CAN device driver!
3 CANoe Tour
3.1 Overview
Operating concept If you are starting up CANoe for the first time, and its functionality and controls are
still completely new to you, the following tour will help you to become familiar with its
operating concept and its most important features.
For this tour you will first set up a very simple CAN bus where CANoe acts as both,
sender and receiver.
Set up CANoe In the first step CANoe is configured as a data source, i.e. as a transmitting station.
You will then learn about CANoe analysis options by studying the generated data in
the analysis windows afterwards.
In complex real systems CANoe typically also acts as sender and receiver. You can
utilize the program as a data source to transmit data to other controllers, but you can
simultaneously use it to observe, log and evaluate the data traffic on the CAN bus.
CAPL In the last part of the tour you will become familiar with the CAPL programming
language and create two network nodes of a distributed system to solve a simple
simulation task in CANoe.
3.2 Preparations
Starting CANoe If you open CANoe the first time a configuration with the desktops Trace,
Configuration, and Analysis is opened automatically.
Windows CANoe has various analysis windows (e.g. Trace, Data, Graphics and Statistics
Window) as well as a Measurement Setup and a Simulation Setup that indicates the
data flow and simultaneously allows to configure CANoe.
You can access all program windows via the ribbon.
Simulation Setup In the Simulation Setup the overall system is shown graphically with the CAN bus and
all network nodes. The simulated bus is represented by a red horizontal line. The blue
line above symbolizes the real bus. The two buses are connected to one another via
the hardware interface (e.g. CANcardXL). To transmit data from CANoe on the bus,
insert transmit blocks in the Simulation Setup, which must be connected by the red
line.
Figure 3: Bus symbol in Simulation Setup with context menu of the bus lines
Measurement Setup The data flow diagram of the CANoe Measurement Setup has a connection to the
Simulation Setup on the left - symbolized by the >> symbol - and various evaluation
blocks on the right serving as data sinks. That is, the data flow is from left to right.
Connection lines and branches are drawn between the individual elements to clarify
the data flow.
In the data flow diagram you will also recognize small rectangles: . At these
insertion points (hot spots) you can insert additional function blocks for manipulating
the data flow (Filter Block, Replay Block or CAPL program blocks with user-definable
functions).
Analysis windows The information arriving at each evaluation block is displayed in the analysis window
of the block. For example, the Trace Window displays all information arriving at the
Trace block, while the Graphics Window shows you information arriving at the
Graphics block.
The only exception is the Logging Block, which is not assigned a window but rather a
file in which the data arriving at the block are logged.
Create a new Make sure that you begin this tour with a new configuration. Select the
configuration CAN_83kBaud_2ch.tcn template via the File ribbon tab|New, and click on Create
Configuration.
The wizard is not needed for this tour.
Preparations To start up CANoe use a test setup that is independent of existing CAN bus systems
with only two network nodes. The two CAN controllers of your network interface can
serve as the network nodes. As network interface you can use e.g. CANcaseXL or
CANcardXLe.
Connect channels on First, connect channel 1 and 2 on the network interface (D-Sub 9 connectors). For a
the network interface high-speed network interface you need a connection cable (CANcable) with two bus
termination resistors of 120 Ω each. For a low-speed interface you will simply need a
3-conductor cable to interconnect the pins of the two controllers that are assigned to
the bus lines CAN high, CAN low and ground.
Consequently, the CAN bus that you use during this tour will consist of a short 2-
conductor or 3-conductor cable that connects the two CAN controllers of the CAN
card to one another. This is necessary as a minimal configuration, since the CAN
protocol requires – in addition to a sender – at least one receiver that confirms the
correct receipt of messages with an acknowledge.
Connect the network For external network interfaces, e.g. VN1638 or CANcaseXL, use a USB cable to
interface with your connect to the computer. Internal network interfaces, e.g. CANcardXLe, plug directly
computer into your computer.
Define the bus Up to this point we have not considered definitions of bus parameters (Transmission
parameters speed, sampling point, etc.) which must be set for each of the two participating
controllers.
1. To do this, open the Simulation Setup (Configuration desktop or Simulation
ribbon tab|Simulation Setup) and press the right mouse button on the square
bus symbol with the Network CAN1 label.
2. Choose the context menu command Network Hardware… and open the
Network Hardware Configuration dialog.
3. Then select CAN1|Setup from the configuration dialog for the first controller and
type in the value for the baud rate 100 kBaud.This makes sense for both high-
speed and low-speed buses. CANoe recommends default values for the
controller registers, which you accept with [OK].
When you do this – besides the transmission speed of 100 kBaud – you also
implicitly define other controller parameters (Sampling point, BTL cycles, and
synchronization jump width). For the overall system to function properly, the same
exact values must be set for the second controller CAN 2 (click + and Setup).
When you exit the dialog, accept the values with [OK].
Real channels, With the [Driver…] button you can open the Vector Hardware Config dialog. There
application channels you can assign the application channels to the real channels.
Set up a data source Your current test setup still does not have a data source. So set up a data source
which places information on the bus cyclically.
Unit 1 Configure CANoe so that – after the start of measurement– a CAN message with
identifier 64 (hex) is sent on the bus every 100 milliseconds. In this case the message
should contain exactly four data bytes with the values D8 (hex), D6 (hex), 37 (hex)
and 0.
Insert a visual You can solve this task by inserting a visual sequence which transmits the message
sequence on the bus.
1. Open the Automation Sequences Window via the Simulation ribbon
tab|Automation.
Note: To execute this visual sequence it must be activated in this dialog. Since
the sequence has no contents yet, it is displayed as invalid ..
After it is created, the visual sequence Message 1 will be opened in the Visual
Sequencer automatically.
3. Enter the data of the message in the first row as follows:
Command: Set CAN Raw Frame (selection via list field)
Object:
> Channel: CAN1
> Identifier: 0x64
> Selector: all data
Operator: =
Operand: D8 D6 37 00
Wait: 0
4. To send the message cyclically, you have to enter in the second row the following
settings:
Command: Set CAN Cyclic Raw Frame (selection via list field)
Object:
> Channel: CAN1
> Identifier: 0x64
> Selector: not available
Operator: cycle time (ms)
Operand: 100
Wait: 0
5. Activate with in the toolbar the replay of the sequence Message 1 until
measurement stop.
6. Activate with in the toolbar the automatic start of the sequence at the start of
measurement.
Reference: You can find detailed information about the Automation Sequences or the
Visual Sequencer in the help of CANoe.
Save your Before you start the measurement you should save the configuration that you have
configuration prepared to this point via the File ribbon tab|Save. You can then reload this
configuration at any time and resume your work precisely at this point.
Start the Start the measurement with on the Home ribbon tab. CANoe immediately begins
measurement to cyclically transmit the message you have configured in the sequence Message 1.
Display in the Trace In the Trace Window (Trace desktop or Analysis ribbon tab|Trace) you can see that
Window the message is transmitted via channel 1 (Transmit attribute Tx [= Transmit]) and
received by the second controller (Receive attribute Rx [= Receive]).
The first column shows the transmit time relative to the measurement start. The next
column shows you which of the two CAN channels was used to transmit.
Unit 2 Expand the configuration of the last task such that, additionally, a message with
identifier 3FC (hex) is transmitted every 500 milliseconds. The value of the first data
byte of this message should cyclically get values from 1 to 5.
Insert a second You can solve this task by inserting a second visual sequence Message 2 that
visual sequence transmits a new message on the bus.
Stop the measurement with on the Home ribbon tab before entering the second
sequence.
Sequence Message 2 must be defined as follows:
Activate with in the toolbar the periodic replay of the sequence Message 2 until
measurement stop. Wait sets the time between the execution of the single sequence
steps.
Activate with in the toolbar the automatic start of the sequence at the start of
measurement.
Start the measurement again with on the Home ribbon tab.
Further data sources Besides the Visual Sequencer, CANoe offers additional block types as data sources.
> With the Interactive Generator (IG) you can configure and send messages
interactively while a measurement is running. Additionally you can define Signal
Generators.
> With a Replay Block you can play back data on the bus that were logged with
CANoe logging function.
> A program block allows you to integrate your own transmit functionalities – which
may be quite complex – into CANoe with the CAPL programming language.
Reference: You can find detailed information about these block types in the help of
CANoe.
Data analysis Analysis windows are used to analyze data generated by the Message 1 and
Message 2 sequences.
Trace Window You have already learned about the Trace Window. Data that reach the Trace block
of the Measurement Setup are displayed here as CAN messages in bus based
format. Besides the time stamp, this includes the number of the CAN controller, the
identifier, an attribute for differentiating transmitted and received messages, and the
data bytes of the CAN message.
Configuration of the You can configure the Trace Window – like all other analysis windows – from the
Trace Window context menu that is accessed by pressing the right mouse button on the window or
on the appropriate block.
Furthermore, the different buttons in the toolbar can be used to configure the Trace
Window. For example, with you can toggle from stationary mode to the scroll
mode, in which each message arriving at the Trace block is written to a new line.
With you can toggle between absolute and relative time representation. In relative
time representation, the time difference between two successive messages ("transmit
interval") is shown in the first column. Of course, in this display format it is also easy
to find the transmit interval that you entered previously in the Visual Sequencer: 100
milliseconds.
Statistics Window Another bus based window, the CAN Statistics Window (Analysis desktop or
Analysis ribbon tab|Statistics), provides an overview of bus data traffic. Displayed
here are the total frequencies of data, remote and Error Frames, bus loading and
CAN controller status.
Since in our case Message 1 is sent every 100 ms and the Message 2 every 500 ms,
the total frequency of all messages is 12 frames per second. With an average data
length of about 70 bits per frame, approx. 12 * 70 ≈ 840 bits are placed on the bus in
one second. At a baud rate of 100 kBit/sec the bus load in our example would be on
the order of magnitude of one percent.
Symbolic description Before we discuss the remaining windows in detail, let us have a look at the
of data capabilities offered by CANoe for the symbolic description of data. Of primary interest
in the analysis of CAN systems – besides bus-related information such as messages,
Error Frames and message frequencies – is information on useful data, i.e. signals
such as RPM, temperature and engine load, which are provided by individual
controllers, and are sent on the bus with the help of CAN messages.
To describe this information symbolically, CANoe provides you with the database
format DBC and a database editor with which you can read, create and modify CAN
databases.
Reference: Please refer to the CANdb++ manual and the CANdb++ help included
with the CANoe product for further information on the CANdb++ Editor.
Assign a database At this point we would like to assign a delivered database to the current CANoe
configuration. This database will be used to interpret the data bytes of the messages
generated by the Visual Seqencer. You can find the database POWERTRAIN.dbc in
the directory CANoe Sample Configurations\CAN\CANSystemDemo\CANdb.
The location of the directory depends on the installation. In the Options dialog you
can find the file location here:
File ribbon tab|Options|General|File Locations: Location of user data.
1. Stop the measurement to assign the database and open the Simulation Setup
(Configuration desktop or Simulation ribbon tab|Simulation Setup).
In the System View of the Simulation Setup, you can see a tree representation of
the current configuration.
2. Select Databases in the System View and open the Open dialog with the context
menu command Add….
3. Select in this dialog the above mentioned database.
4. If you click on the [OK] button, the new database is accepted for the current bus
and displayed in the System View.
Now open the database using the symbol on the Tools ribbon tab. The CANdb++
Editor is opened, and the contents of the database POWERTRAIN.dbc are shown in
the Overall View Window of the CANdb++ Editor.
Double click the Messages object type in the area on the left side of the Overall View
Window. The subordinate structural level is then also shown in this area, and the area
on the right shows the available messages with their system parameters (e.g. sym-
bolic name, identifier, etc.).
Note: The CANdb++ Editor validates inputs and displays potential errors or issues in
the Overall View Window. In this database the symbol to the left of the message
indicates that this message has no assigned receiver node.
First, toggle the numbering format from decimal to hexadecimal via the
Options│Settings menu path. We can deduce from the symbolic names of the
messages that the system under consideration involves a description of
communications in a rudimentary engine area system.
Click the message EngineData in the left area of the Overall View Window. The
system parameters of signals transmitted in this message are shown in the area on
the right side of the Overall View Window.
The temperature EngTemp, for example, is a 7 bit signal. To obtain the physical
value in degrees celsius, the bit value must be multiplied by the factor 2, and the
offset 50 must be subtracted from the result.
The idle switch signal Idle Running in the last bit of the third data byte is a binary
signal (one bit), which can assume the value 0 or 1.
Note: With the help of this symbolic information the data contents of messages can
now be interpreted in CANoe. Please note that this is only practical if the database
information describes the system that you are currently observing. So you have to
ensure that the database associated to the configuration matches the real network.
Display in the Trace Now you can see in the Trace Window the identifier and the symbolic message
Window name.
Please note that the message you generated in the first task has the identifier 64
(hex). This agrees with the identifier of the message EngineData.
Display of Besides the use of symbolic message names, the associated database can also be
momentary signal used to analyze signal values. The purpose of the Data Window (Analysis desktop or
values Analysis ribbon tab|Data) is to assist in the study of momentary signal values.
This explains why the Data Window is initially empty in a new configuration. The
signal values to be displayed are dependent inter alia upon information from the
database. You as the user must decide which signal values should be displayed.
Unit 3 Configure the Data Window to display the signal values of the message EngineData
(ID 64 hex) that is generated in the Simulation Setup.
Add signals in the For the display of signal values in the Data Window, you have to add signals.
Data Window
1. With the Data Window context menu command Add Signals… open the Symbol
Selection dialog.
The tree view of the dialog allows you to search for a specific signal. Each
database gets one branch each for signals, messages and nodes.
2. Choose the EngineData message and select all signals of this message.
Display in the Data After the measurement start the sequence Message 1 begins to cyclically send the
Window message EngineData with data bytes D8, D6, 37 and 0 onto the bus. According to
the message description in the database, the Data Window in the Measurement
Setup now interprets these byte values as engine speed, temperature and idle switch
and displays the appropriate signal values in the Data Window in physical units.
With the help of the conversion formula in the database, engine speed is shown in
RPM, while temperature is shown in degrees centigrade (Celsius). The values of all
three signals remain constant over time, since the message is constantly transmitted
with the same data bytes D8, D6, 37 and 0.
Analysis of signal While the Data Window displays momentary signal values, you can have the time
responses sequences of signal values displayed in the Graphics Window (Analysis desktop or
Analysis ribbon tab|Graphics). After the end of measurement the signal sequences
are available for study by user-friendly analysis functions.
Unit 4 Configure the Graphics Window so that signal values are displayed for message 3FC
(hex) that is generated in the Simulation Setup.
Add signals in the The second message generated in the Simulation Setup is also described in the
Graphics Window associated database.
1. Open with the Graphics Window's context menu command Add Signals… the
Symbol Selection dialog.
In the database it will be apparent to you that the identifier 3FC is associated with
the symbolic message name GearBoxInfo containing the signals Gear,
ShiftRequest and EcoMode.
2. Choose the signals and confirm them with [OK].
In the Graphics Window you see that the signals are now entered in the legend
on the left side of the window.
Display in the You can now observe the time sequences of these signals in the Graphics Window.
Graphics Window After the measurement start you observe that the signal Gear cyclically assumes
values from 1 to 5, while the other two signals remain constant over time.
For a useful display of the single gear values the Step connection type of the lines is
suitable.
In the curve of the Gear signal you can see the five values that you entered in the
sequence Message 2 as part of unit 2. The values remain in the Graphics Window
after the end of the measurement.
For this graphical display you have to select under the separate views of the Y-
axes.
Reference: The measurement functions that the window provides for post-analysis
are described detailed in the help of CANoe.
Data logging CANoe has extensive logging functions for data logging. In the Measurement Setup
(Configuration desktop or Analysis ribbon tab|Measurement Setup) the logging
branch is shown at the very bottom of the screen.
You can easily recognize it by the file icon , that symbolizes the logging file. The
logging file is filled with CAN data during the measurement.
Unit 5 Log – in ASCII format – all CAN data traffic that is generated in a short measurement
(approx. 20 sec.) by the sequences.
Activate the logging To log the data that arrives in CANoe Measurement Setup to a file, first stop the
branch measurement and activate the logging branch. Also remove the break that separates
the Logging Block of a new configuration from the data source. You can do this by
double clicking the break symbol or with its context menu command Remove
Break.
Configure the logging With the context menu command Logging File Configuration… of the file icon
file located at the far right of the logging branch, you can open the configuration dialog.
Here you can enter the file name for the measurement log as well as its format.
Select ASCII format (ASC) here.
Logs in binary format (BLF) take up less space on your hard drive, but they cannot be
read in normal text editors. The program offline mode offers you the same evaluation
options for logs in both formats.
Configure the trigger Besides the file icon, you can also specify trigger conditions for file logging in the
conditions Logging block. This is often advisable, since frequently it is not the data traffic on the
CAN bus over the entire measurement period that is of interest, but rather only certain
time intervals, e.g. when there are implausible signal values or when Error Frames
occur.
Open the Trigger Configuration dialog with the Logging Block context menu
command Configuration….
To log the entire measurement the Entire measurement mode must be selected in
the Trigger Configuration dialog.
Start the After the configuration of the log file and the trigger condition start the measurement,
measurement which you stop again after 20 seconds.
Open the log file With the context menu command Open Logging File…of the file icon you can open
the logged ASCII file. Besides the logged messages you can see that statistical
information was also logged. These lines correspond exactly to the information that is
displayed in the Statistics Window during a measurement.
Play back recorded Logging files in ASCII format can indeed be viewed with text editors, but often it is
data more sensible to utilize the capabilities that CANoe provides for offline analysis of
logging files.
Unit 6 Play back the logging file recorded for the last task in offline mode, and observe the
signal response in the Graphics Window.
Activate the offline To solve this task, first switch CANoe to offline mode. For that select the Offline
mode Mode on the Home ribbon tab, or switch with a double click on the Online/Offline
symbol in the Measurement Setup to offline mode. All configuration settings are taken
over to offline mode. In the Measurement Setup the bus symbol is displayed
deactivated and the data symbol is activated as data source.
Choose the data Select the logging file of the last task via the Configuration… context menu
source command of the file icon at the left of the Measurement Setup.
Deactivate the You have also to separate the Logging Block. You can do this by double clicking the
logging branch hot spot symbol on the left of the Logging Block or with the context menu of this hot
spot.
Play back the logging You can now play back the measurement with the <F9> key or with on the Home
file ribbon tab. In contrast to online mode, here CANoe also offers you the option of
replaying the measurement in slow motion (Home ribbon tab|Animate or <F8>) or in
Single-Step mode (Home ribbon tab|Step or <F7>).
Analysis in offline The same analysis functions are available to you in offline mode as in online mode.
mode That is, the logged data are displayed in bus based format in the Trace Window, while
you can observe the log signal responses in the Graphics Window. Of course, you
can also insert filters or CAPL programs in the Measurement Setup to further reduce
the data or introduce additional user-defined analysis functions.
What is CAPL CAPL is an event based programming language. Each CAPL program consists of
event procedures, with which you can react to external events (e.g. occurrence of
specific messages on the CAN bus or activation of keys on the computer keyboard).
The CAPL Browser is described in detail in the help of CANoe. With its sub windows
("Panes") it allows you to create and edit CAPL programs quickly and easily.
In principle, you can also use your own text editor to create CAPL programs. CAPL
programs are normal ASCII files with the default name extension .CAN, which must
be compiled before the start of measurement using the compiler provided with the
CANoe product.
Reference: You will find a complete description of the programming language
together with numerous detailed examples in the help of CANoe.
Create a CAPL In the next task you will create a simple CAPL program to count messages that are
program generated in CANoe's Simulation Setup.
Unit 7 Create a CAPL program with which you can count the number of messages of the
type EngineData (ID 64 hex) and output the counted number of messages to the
Write Window in response to a key press.
Insert a CAPL node First you must decide where you wish to insert your CAPL program in the data flow
plan. Because this program is only for analysis purposes and does not generate any
messages itself, but only counts them, it is advisable to insert the program in the
Measurement Setup, perhaps before the Trace Window. In the hot spot context menu
choose the function Insert Program Node. A function block with the program symbol
P now appears at the selected point in the Measurement Setup.
Configure the CAPL You can also access the node configuration dialog via the context menu
node Configuration…. First, select a program name, e.g. COUNTER.can.
Start the CAPL Start the CAPL Browser either from the configuration dialog [Edit...] button or directly
Browser by double clicking the program block P in the Measurement Setup.
Insert a variable For your program you will first need an integer variable which counts the messages.
For example, you could name it counter. Go to the editor pane and enter this name
in the variables block. The following should now appear in this pane:
variables
{
int counter;
}
Like all global variables, this variable is automatically initialized to zero at the start of
measurement.
Create an In the next step, this variable should be incremented whenever an EngineData
on message message is registered. For this, you must expand the CAPL program to include an
event procedure event procedure of the type on message ("React to message event"). To do this,
click the CAN entry in the left tree view pressing the right mouse button. Open the
submenu New Event Handler. Then select the on message <new message>
command.
Now a procedure template appears in the Procedures Text Editor. First replace the
text <newMessage> by the symbolic name EngineData, which you could also
overtake directly from the database via the context menu command Message from
Database…. During compilation the CAPL compiler replaces the symbolic name by
the corresponding identifier 0x64.
Now you only need to define which actions should be performed when the event
occurs. Since the program is to count messages, the variable counter must be
incremented whenever a message is registered. The complete procedure appears as
follows:
on message EngineData
{
counter++;
output(this); // The EngineData value is displayed in the
// Trace Window
}
Create a second To display all other measurement values in the Trace Window, insert the following
on message procedure:
event procedure
on message*
{
output(this);
}
Note: Without this procedure the CAPL program would have the effect of a filter
because only the message EngineData would be transmitted to the Trace Window in
the Measurement Setup.
Create a on key As a last step, the output to the Write Window must still be implemented. Finally, the
event procedure program should not just count messages, but also keep track of how many messages
have been counted.
The output to the Write Window should occur when the <a> key is pressed. For this,
you must define another event procedure for the event Press key <a>.
Now insert a Keyboard event in the CAPL program. To do this, click the System entry
in the left tree view pressing the right mouse button. Open the menu path New Event
Handler|on key <newKey>. A new procedure template will appear in the Procedures
Text Editor, which you fill out as follows:
on key 'a'
{
write("%d EngineData messages counted ",counter);
}
The format entry %d refers to the integer variable counter, which is entered after
the comma. For the most part, this format string conforms to the C function
printf().
Save and compile That completes the program. Save it and then start the compiler either with the <F9>
the program key, or the menu path Compiler│Compile or by the button on the toolbar.
If you have made an error in creating the program, a message window will open
showing you the error. Double click this error notification to go to the location where
the error occurred. After you have corrected it and saved the program file again,
recompile the program. Once the program has compiled without errors, the message
Compilation succeeded appears in the Output Window.
Display in the Write Now start the measurement. The sequence Message 1 begins to cyclically transmit
Window messages of the type EngineData, which are now counted by your program.
Whenever you press the <a> key the text n EngineData messages counted can be
seen in the Write Window, where n represents the number of messages counted.
Working with system CANoe provides system variables to model the functional bus behavior of network
variables nodes. These system variables are described by events and states of the system
environment (external pressure, temperature, switch positions, etc.). You can observe
and intentionally change these states - i.e. the values of the system variables - on
user-definable panels.
To work with system variables in CAPL you use the event procedure type on
sysvar (React to change in system variable). The CAPL functions
SysGetVariableInt and SysSetVariableInt are used to read and write system
variables.
These language tools and symbolic access to the various variables defined in the
database make it possible to create simple prototypical network node models.
Unit 8 Create a complete CANoe configuration with two network node models and
associated periphery, i.e. panels. This should only involve implementation of
distributed functions: After the user activates a switch pressing the left mouse button,
the first node informs the second node of this action. The second node then activates
an indicator lamp in its periphery.
Diagram
Procedure A model for distributed systems can be created efficiently in CANoe in three steps:
> Create the database with messages, signals and environment variables
> Create the network node periphery, i.e. the panels
> Create the network node models in CAPL
To prepare this task, select the CAN_83kBaud_2ch.tcn template via the File ribbon
tab|New and click on Create Configuration.
Usage of a database The first step involves creating a database which describes a significant aspect of the
system: The exchange of information between the two network nodes via the
communication medium, i.e. the CAN bus.
The database message and signal objects are available for describing the exchange
of information over the CAN bus. The simple functionality of the example can be
handled by a 1-bit signal which describes the state of the switch at the first node. This
signal is packed in a CAN message and is only transmitted if the switch state
changes (spontaneous transmission).
Create a database Now create a new database with message Msg1 and signal bsSwitch.
1. Open with the symbol on the Tools ribbon tab the CANdb++ Editor.
2. Open the Template dialog via File|Create Database….
3. Select the CANoeTemplate.dbc template.
4. With [OK] you open the New Database File dialog.
Enter here the name of the new database (e.g. Database).
5. Close the dialog with [Save].
The new database is opened in the CANdb++ Editor.
Create a message Now create the message Msg1 with the identifier 100, which is to be transmitted by
the first node.
For this, select Messages and open with the context menu command New… the
configuration dialog for the new message. Enter the following values in the Definition
page:
> Name: Msg1
> Typ: CAN Standard
> ID: 0x100
> DLC: 8
Close the dialog with [OK].
Create signal Create the signal bsSwitch to describe the switch position and assign it to the
message Msg1.
For this, select Signals and open with the context menu command New… the
configuration dialog for the new signal. Enter the following values in the Definition
page:
> Name: bsSwitch
> Length [Bit]: 1 (for the transmission of the states on=1 and out=0)
> Byte Order: Intel
> Value Type: Unsigned
> Factor: 1
> Offset: 0
> Minimum: 0
> Maximum: 1
Assign signal to You can assign the signal bsSwitch to the message Msg1 via drag and drop.
message
Add the database to In the Simulation Setup you can add the database. If you go in the tree view of the
the configuration current configuration to Databases with the mouse pointer and press the right mouse
button, you can run the context menu command Add.
Define system With the second step you have to describe the I/O interface between the nodes and
variables their peripheries. For this CANoe provides system variables. Each peripheral element
(Switch, indicator lamp, slider, etc.) is wired to a system variable, i.e. it is connected
to the CAPL program for the network node.
In this example there are exactly two peripheral elements: A switch at the first node
and an indicator lamp at the second node. For this, two system variables must be
created in the database, e.g. svLight and svSwitch.
1. Create the two system variables in the System Variable Configuration dialog.
Open this dialog via the Environment ribbon tab| System Variables.
4. Open the New System Variable dialog via again and define the second
system variable svSwitch. Enter the following values:
> Namespace: MyNamespace
> Name: svSwitch
> Data type: Integer
5. Close the dialog with [OK].
Now you can see that both system variables are assigned to the namespace
MyNamespace.
6. Close the dialog with [OK].
Reference: You can find detailed information about system variables in the help of
CANoe.
Node's periphery A separate application, the Panel Designer, is provided with CANoe for creating the
node periphery. In the current configuration, one separate panel must be created for
each of the two nodes.
Reference: Please refer to the help of CANoe for a detailed introduction into the
Panel Designer.
Create the first panel The first panel has a single control, a switch.
1. You can start the Panel Designer with on the Tools ribbon tab of CANoe. This
ensures that the database is available.
A new panel will be opened automatically.
2. Enter in the Properties grid under Panel|Panel Name the name of the panel
SWITCH. After saving the panel this name will be displayed on the opened panel
top left.
3. Select a Switch from the Toolbox of the Panel Designer and place it on the
panel, e.g. via drag and drop.
4. Configure the Switch in the Properties grid under Settings|State Count as a
control with 2 states.
5. Assign the Switch in the Properties grid under Settings|Mouse Activation Type
the Left mouse button.
6. Assign the Switch in the Properties grid under Appearance|Image the image file
IOrgPushButton_2.bmp from CANoe directory CANoe Sample
Configurations\Programming\Bitmap_Library\Global\Switches_2S
tates.
7. To display system variable in the Symbol Explorer you have to open the
Filtered by list and select Variables. Then drag the environment variable
svSwitch from the Symbol Explorer to the Switch on the panel.
8. Label the switch by selecting the Static Text display element from the Toolbox
and place it on the panel to the right of the Switch. Enter the label in the
Properties grid of the Static Text under Appearance|Text.
9. You can change the size of the panel by clicking the panel border and dragging it.
Try not to size panels any larger than necessary, since available screen space is
usually a very limited and hence valuable resource.
10. Save the panel under the name SWITCH.xvp.
Create the second The second panel has a small simple lamp as an indicating element.
panel
1. Open a new panel with the menu path File|New Panel and select as panel name
LIGHT.
2. Select a Switch from the Toolbox of the Panel Designer and place it on the
panel, e.g. via drag and drop.
3. Configure the Switch in the Properties grid under Settings|State Count as a
display element with 2 states.
4. Assign the Switch in the Properties grid under Appearance|Image the image file
mLedred_2.bmp from CANoe directory CANoe Sample
Configurations\Programming\Bitmap_Library\Global\Indicator_2
States
5. Assign the environment variable svLight to the Switch via drag and drop from the
Symbol Explorer.
6. Label the switch by selecting the Static Text display element from the Toolbox
and place it on the panel to the right of the Switch. Enter the label in the
Properties grid of the Static Text under Appearance |Text.
7. Save the panel under the name LIGHT.xvp.
Add the panels to the You complete this step of this unit by integrating the created panels into the CANoe
configuration configuration with the button of the toolbar.
Save the Before creating the network node models, you should save the configuration you just
configuration created with on the Home ribbon tab of CANoe.
Create network node You create the network node models in the Simulation Setup. At the least, the model
models for the first node must send a message when the switch is activated, and therefore it
may not be inserted in the Measurement Setup.
Insert two network In this example you need two network nodes in the Simulation Setup: The first node
nodes supplies the switch position, and the second reacts to this by activating or
deactivating a small lamp.
In the Simulation Setup click the bus lines to insert new network node models.
Configure the nodes You open the configuration dialog of the nodes with the context menu command
Configuration…. Enter here the node name (e.g. ECU 1 or ECU 2).
Open with [File…] the Open dialog. Enter here the name of the CAPL program that
simulates the functionality of the network node (e.g. ECU1.CAN or ECU2.CAN).
Create the used Double click on each node to open the CAPL Browser for the particular CAPL
CAPL programs program. The first CAPL program belongs to a node at whose periphery there is a
switch. When the switch position changes, the program acquires the new switch value
and immediately outputs it on the bus:
// Reaction to change of system variable svSwitch
on sysvar sysvar::MyNamespace::svSwitch {
// Declare a CAN message to be transmitted
message Msg1 msg;
// Read out the value of the light switch,
// Assign to the bus signal bsSwitch
msg.bsSwitch = SysGetVariableInt(sysvar::MyNamespace::svSwitch);
// Output message on bus (spontaneous transmission)
output(msg);
}
The second network node reacts to this message. The CAPL program reads the
value of the bus signal for the switch position and then activates or deactivates the
indicator lamp at its periphery. Please note that the switch value is only acquired via
the signal value on the bus. The value of the environment variable svSwitch is not
known to this CAPL program. That is, the communication between the two nodes
occurs via the bus:
// Reaction to receipt of the CAN message M1
on message Msg1 {
// Read out a bus signal and
// set the system variable
SysSetVariableInt(sysvar::MyNamespace::svLight, this.bsSwitch);
}
Start the Now start the measurement in CANoe. Whenever you activate the switch on Panel 1
measurement the indicator lamp illuminates. Whenever you turn the switch off, the indicator lamp
goes off. The Trace Window shows you both the bus communication (Spontaneous
transmission of message Msg1 when the switch position changes) and the values of
system variables svSwitch and svLight.
4 Appendix A: Support
What our support To answer your support questions quickly, whether by phone, e-mail, fax or mail, we
team needs to know require the following information:
Software > Detailed description of the software, hardware model and version number, e.g.,
CANoe 7.5.66 (SP2), CANcardXL
> Serial number
Note: You will find this information in CANoe on File ribbon tab|Help|Details.
> News
> Products
> Demo Software
> Support
> Training Classes
> Addresses
www.vector.com
Installation & Schnelleinstieg
CANoe
Version 10.0.3
Deutsch
Impressum
Vector behält sich vor, die in diesen Dokumenten enthaltenen Angaben und Daten jederzeit ohne vorherige Ankündigung zu ändern.
Ohne ausdrückliche schriftliche Zustimmung von Vector dürfen diese Dokumente, auch nicht teilweise, vervielfältigt oder übertragen
werden, unabhängig davon, auf welche Weise oder mit welchen Mitteln dies geschieht. Alle technischen Angaben, Texte, Bilder und
Grafiken einschließlich deren Anordnung unterliegen soweit gesetzlich zulässig den geltenden gesetzlichen Vorschriften zum Schutz
des geistigen Eigentums, insb. dem Schutz des Urheberrechts. Jede nicht genehmigte Verwendung kann eine Verletzung dieser
Vorschriften darstellen.
Copyright 2017, Vector Informatik GmbH. Printed in Germany.
Alle Rechte vorbehalten.
Installation & Schnelleinstieg CANoe Inhaltsverzeichnis
Inhaltsverzeichnis
1 Einführung 3
1.1 Zu diesem Handbuch 4
1.1.1 Zugriffshilfen und Konventionen 4
1.1.2 Zertifizierung 5
1.1.3 Gewährleistung 5
1.1.4 Support 5
1.1.5 Marken 5
2 Installation 7
2.1 Allgemeines 8
2.2 Systemvoraussetzungen 8
2.3 Installationsvoraussetzungen 8
2.4 Installationsvorgang 9
2.5 Hinweise zur Aktivierung einer software-basierten Lizenz 9
2.6 Vector USB Dongle 10
2.7 MOST 11
2.7.1 MOST150: Betrieb mit Optolyzer G2 3150o 11
2.7.2 MOST50: Betrieb mit Optolyzer G2 3050e 12
2.8 Weitere CANoe Optionen 13
2.9 Umschaltung der Sprachversionen 13
2.10 Test der Softwareinstallation 14
2.11 Troubleshooting 14
2.11.1 Hardware-spezifische Fehlermeldungen 14
3 CANoe Einsteigertour 15
3.1 Übersicht 16
3.2 Vorbereitungen 16
3.3 Einrichten des Busses 18
3.4 Daten senden 20
3.5 Analysefenster 24
3.6 Arbeiten mit symbolischen Daten 25
3.7 Analyse von Signalwerten im Daten-Fenster 28
3.8 Analyse von Signalverläufen im Grafik-Fenster 30
3.9 Aufzeichnen einer Messung 31
3.10 Auswerten einer Logging-Datei 33
3.11 Erstellen eines CAPL-Programms 33
3.12 Simulation verteilter Systeme in CANoe 36
3.12.1 Erstellen der Datenbasis 37
3.12.2 Definition von Systemvariablen 39
3.12.3 Erstellen der Panels 41
3.12.4 Erstellen der Netzwerkknotenmodelle 42
4 Anhang A: Support 45
1 Einführung
Konventionen In den beiden folgenden Tabellen finden Sie die durchgängig im ganzen Handbuch
verwendeten Konventionen in Bezug auf verwendete Schreibweisen und Symbole.
Stil Verwendung
fett Felder, Oberflächenelemente, Fenster- und Dialognamen der
Software. Hervorhebung von Warnungen und Hinweisen.
[OK] Schaltflächen in eckigen Klammern
File|Save Notation für Menüs und Menübefehle
CANoe Rechtlich geschützte Eigennamen und Randbemerkungen.
Quellcode Dateinamen und Quellcode.
Hyperlink Hyperlinks und Verweise.
<Strg>+<S> Notation für Tastenkombinationen.
Symbol Verwendung
Dieses Symbol gibt Ihnen Hinweise und Tipps, die Ihnen die Arbeit
mit CANoe erleichtern.
Dieses Symbol weist Sie auf Dateien hin, die Sie nicht ändern
dürfen.
Symbol Verwendung
Dieses Symbol weist Sie auf Stellen im Handbuch hin, an denen
Sie Grundwissen finden.
1.1.2 Zertifizierung
Qualitäts- Die Vector Informatik GmbH ist gemäß ISO 9001:2008 zertifiziert.
managementsystem Der ISO-Standard ist ein weltweit anerkannter Qualitätsstandard.
1.1.3 Gewährleistung
Einschränkung der Wir behalten uns inhaltliche Änderungen der Dokumentation und der Software ohne
Gewährleistung Ankündigung vor. Vector übernimmt keine Gewährleistung und/oder Haftung für die
Vollständigkeit oder Richtigkeit der Inhalte oder für Schäden, die sich aus dem
Gebrauch der Dokumentation ergeben.
1.1.4 Support
Sie benötigen Hilfe? Sie können unsere Hotline telefonisch unter der Rufnummer
+49 (711) 80670-200
oder per Web-Formular unter CANoe-Support erreichen.
1.1.5 Marken
2 Installation
2.1 Allgemeines
Überblick Diese Anleitung beschreibt die Installation der Software sowie der zugehörigen
Hardware. Sie beschreibt zudem einen Funktionstest, um die erfolgreiche Installation
von Software und Hardware zu prüfen.
Hinweis: Die auf der CANoe CD enthaltenen Hardware-Treiber können neuer sein,
als die, die der Hardware beiliegen. Verwenden Sie stets die neuesten Treiber.
Hinweis: Bitte beachten Sie, dass die verwendete CAN-Hardware für den Betrieb mit
CANoe freigeschaltet sein muss.
2.2 Systemvoraussetzungen
Sonstiges Zur Unterstützung der COM-Schnittstelle benötigen Sie (D)COM in der Version 1.2
oder neuer.
2.3 Installationsvoraussetzungen
Hinweis: Bitte beachten Sie, dass CANoe Version 3.0 und neuer nicht über eine
ältere CANoe Version (CANoe Version 2.5 oder älter) installiert werden darf. Sie
können jedoch die alte Version von CANoe löschen, das Verzeichnis der alten
CANoe Installation umbenennen oder die CANoe Installation in ein neues Verzeichnis
vornehmen. Damit ist es möglich mit unterschiedlichen CANoe Versionen zu arbeiten.
Windows 10, 8.1, 7 Die Installation der Software ist für diese Betriebssysteme identisch.
Benutzerprofil CANoe darf nur auf auf lokalen Windows-Benutzerprofilen installiert werden. Das
Verwenden von servergespeicherten Profilen wird nicht unterstützt und kann zu
fehlerhaftem Verhalten während und nach der Installation führen.
Installation der Für zusätzlich ausgelieferte Optionen sind unter Umständen weitere
Optionen Installationsschritte notwendig. Beachten Sie bitte die entsprechenden
Installationshinweise im Handbuch der jeweiligen Option.
2.4 Installationsvorgang
So starten Sie die Gehen Sie folgendermaßen vor um die CANoe Software zu installieren:
Installation…
1. Legen Sie die CANoe Installations-CD in ein CD-Laufwerk ein.
Es erscheint ein Startfenster, bei dem Sie die Installation der Software starten
können.
Sollte bei Ihrer Computerkonfiguration das Startfenster nicht automatisch
erscheinen, rufen Sie das Installationsprogramm SETUP.exe aus dem
Verzeichnis Application der CD auf.
2. Folgen Sie den Anweisungen des Installationsprogramms.
Hinweis: Für die Installation benötigen Sie Administrator-Rechte. Sind Sie nur als
Standardbenutzer (mit Standardbenutzerrechten) angemeldet, müssen Sie das
CANoe Installationsprogramm Setup.exe direkt im Explorer starten. Es wird ein
Dialog geöffnet, um sich als Benutzer mit Administrationsrechten anzumelden, damit
die Installationsroutine erfolgreich ausgeführt werden kann.
Produkte Die folgenden Produkte und Versionen unterstützen einen software-basierten Lizenz-
Schutz:
> CANoe/CANalyzer ≥ 7.1
> vTESTstudio ≥ 1.0
Lizenzierung Die Software, die Sie gerade installieren, setzt eine gültige Lizenz voraus:
Der Lizenz-Schutz ist abhängig von Ihrem Produkt:
> Hardware-basierter Lizenz-Schutz
Die Lizenz ist verfügbar, wenn der USB-Dongle oder die Netzwerk-Interface-
Hardware angeschlossen wird.
Aktivierungs-ID Wird das Produkt mit software-basiertem Lizenz-Schutz ausgeliefert, finden Sie einen
Aufkleber auf der CD/DVD-Hülle, auf dem eine Aktivierungs-ID in einem der
folgenden Formate aufgedruckt ist (Beispiele):
> A-1A2B3C4D5F6G7-1A2B3C4D5F6G7
> ACT-0000012345-000012-123456
Nach dem Installieren der Software benötigen Sie diese Aktivierungs-ID, um die
Software-Lizenz auf Ihrem Computer freizuschalten.
Lizenz aktivieren Starten Sie den License Manager über das Start Menü der installierten Software
(oder aus dem Tools Unterordner heraus) und folgen Sie den Anweisungen.
Innerhalb des Aktivierungsvorgangs werden Sie nach der Aktivierungs-ID gefragt.
Geben Sie hier die Aktivierungs-ID ein, die auf der ausgelieferten CD/DVD-Hülle
aufgedruckt ist. Nach erfolgreicher Lizenz-Aktivierung können Sie die Arbeit mit Ihrer
Software beginnen.
Hinweis: Einige Installationsprogramme starten den License Manager automatisch,
sobald die eigentliche Programm-Installation abgeschlossen ist.
Hilfe & Support Über die [Hilfe] Schaltfläche im License Manager erhalten Sie weitere Hilfe zur
Lizenz-Aktivierung.
Benötigen Sie weitere Unterstützung bei der Lizenz-Aktivierung (z.B. wenn Sie keinen
Internetzugang haben, um die Lizenz online zu aktivieren), wenden Sie sich an:
activation@vector.com
Hinweis: Sie können für den Vector USB-Dongle auch nach einem aktuellen Treiber
im Vector Download Center suchen. Installieren Sie dann den Treiber über das
heruntergeladene Programm Setup.exe.
2.7 MOST
Verweis: Hinweise zur Installation von MOST-Hardware erhalten Sie ggf. in den
zugehörigen Installationsanleitungen.
Installation 1. Installieren Sie den Optolyzer G2 3150o oder Optolyzer G2 3150o Production
entsprechend dem Handbuch des Optolyzer.
Hinweise: Beachten Sie, dass zum Betrieb eine Lizenz des Optolyzer Integration
Package (OIP) von Vector auf einer Vector Hardware, USB-Dongle oder als
Lizenzschlüssel benötigt wird.
Der Optolyzer G2 wird über folgende Ethernet-Port-Nummern angesprochen.
Eine möglicherweise installierte Firewall darf diese nicht blockieren.
Spy: 27998
Node: 27999
Computer-seitig werden die Port-Nummern automatisch vergeben. Sollten
dennoch nur bestimmte Port-Nummern verwendet werden, muss die Datei
CAN.ini angepasst werden. Für den Optolyzer G2 3150o (MOST150) an Kanal 1
gilt dabei folgender Abschnitt:
[OptolyzerG2_1]
MyPortNode=
MyPortSpy=
2. Wählen Sie im CANoe Dialog Netzwerk-Hardware-Konfiguration (Registerkarte
Hardware des Menübands|Netzwerk-Hardware) für den MOST-Kanal den
Speedgrade MOST150 und den HW-Typ Optolyzer OL3150o.
3. Geben Sie die IP-Adresse des Optolyzer auf der Seite Interface ein.
(Wenn der Optolyzer bereits angeschlossen ist, können Sie dessen IP-Adresse
per Knopfdruck ermitteln).
4. Wählen Sie ebenfalls auf der Seite Setup den Netzwerkadapter an dem der
Optolyzer angeschlossen ist.
Installation 1. Installieren Sie den Optolyzer G2 3050e oder Optolyzer G2 3050e Production
entsprechend dem Handbuch des Optolyzer.
Hinweise: Beachten Sie, dass zum Betrieb eine Lizenz des Optolyzer Integration
Package (OIP) von Vector auf einer Vector-Hardware, USB-Dongle oder als
Lizenzschlüssel benötigt wird.
Der Optolyzer G2 wird über folgende Ethernet-Port-Nummern angesprochen.
Eine möglicherweise installierte Firewall darf diese nicht blockieren.
Spy: 27998
Node: 27999
Computer-seitig werden die Port-Nummern automatisch vergeben. Sollten
dennoch nur bestimmte Port-Nummern verwendet werden, muss die Datei
CAN.ini angepasst werden. Für den Optolyzer G2 3050e (MOST50) an Kanal 1
gilt dabei folgender Abschnitt:
[OptolyzerG2_50_1]
MyPortNode=
MyPortSpy=
2. Wählen Sie im CANoe Dialog Netzwerk-Hardware-Konfiguration (Registerkarte
Hardware des Menübands|Netzwerk-Hardware) für den MOST-Kanal den
Speedgrade MOST50 und den HW-Typ Optolyzer OL3050e.
3. Geben Sie die IP-Adresse des Optolyzer auf der Seite Interface ein.
(Wenn der Optolyzer bereits angeschlossen ist, können Sie dessen IP-Adresse
per Knopfdruck ermitteln).
4. Wählen Sie ebenfalls auf der Seite Setup den Netzwerkadapter an dem der
Optolyzer angeschlossen ist.
Überblick Die Optionen sind jeweils als Erweiterung des Standard-CANoe ausgeführt. Bei der
Installation werden einige Dateien des Standard-CANoe durch optionsspezifische
Dateien ersetzt (z.B. Treiber) sowie Erweiterungen hinzugefügt (z.B.
Beispielkonfigurationen).
Es ist daher wichtig, dass die eingesetzten Versionen zusammenpassen. Das
Installationsprogramm prüft diese Kompatibilität und warnt gegebenenfalls. Bei
Inkompatibilität der Versionen sollte der Vector Support verständigt werden.
Neben den Beispielkonfigurationen des Standard-CANoe werden optionsspezifische
Beispiele in ein separates Verzeichnis installiert, welches Sie bei der Installation
angeben können.
Dabei können mehrere verschiedene Schicht-7-Optionen gleichzeitig in einem
Verzeichnis installiert sein, z.B. ISO11783, J1939 und CANopen.
Option .Ethernet Bei der Installation der Option .Ethernet beachten Sie bitte die folgenden Hinweise.
Voraussetzung Für einen Test der CANoe Softwareinstallation ist eine erfolgreiche Installation der
CAN-Hardware erforderlich.
Vorgehensweise 1. Verbinden Sie die beiden CAN-Schnittstellen Ihrer CAN-Hardware mit einem dem
Bussystem entsprechend abgeschlossenen Kabel.
2. Laden Sie die Beispielkonfiguration CANSystemDemo.cfg (Registerkarte Datei
des Menübands|Laden: CANoe Sample
Configurations\CAN\CANSystemDemo) und starten Sie diese.
Bei erfolgreicher Installation können Sie im Trace-Fenster CAN-Botschaften
beobachten.
Ergebnis Dieser Funktionstest bestätigt auch eine korrekte Installation der CAN-Hardware.
2.11 Troubleshooting
Vorgehen Bitte passen Sie die Anzahl der Applikations-Kanäle an Ihre Konfiguration an und
weisen Sie die zusätzlichen Kanäle den Netzwerk-Interfaces zu.
Vorgehen Überprüfen Sie, ob die PC-Karte eingesteckt ist. Überprüfen Sie außerdem die PC-
Karte-(PCMCIA-)Einstellungen und die CAN-Hardware-Einstellungen in Ihrer
Systemsteuerung!
Vorgehen Überprüfen Sie, ob die PC-Karte eingesteckt ist. Ist dies der Fall, wiederholen Sie die
CAN-Treiber-Installation.
3 CANoe Einsteigertour
3.1 Übersicht
Bedienkonzept Falls Sie CANoe zum ersten Mal in Betrieb nehmen und Funktionsweise und
Bedienung für Sie noch völlig neu sind, hilft Ihnen die folgende Tour, in wenigen
Stunden mit dem Bedienkonzept und den wichtigsten Features vertraut zu werden.
Sie werden für diese Tour zunächst einen sehr einfachen CAN-Bus aufbauen, bei
dem CANoe sowohl die Rolle des Senders als auch die des Empfängers übernimmt.
CANoe einrichten Im ersten Schritt wird CANoe als Datenquelle, d.h. als Sendestation, konfiguriert. Sie
werden dann die Analysemöglichkeiten von CANoe kennen lernen, indem Sie die
erzeugten Daten anschließend in den Messfenstern untersuchen.
Auch in komplexeren realen Systemen übernimmt CANoe typischerweise beide
Aufgaben. Sie können das Programm als Datenquelle einsetzen, um Daten an
andere Steuergeräte zu senden, Sie können es aber gleichzeitig verwenden, um den
Datenverkehr am CAN-Bus zu beobachten, aufzuzeichnen und auszuwerten.
CAPL Im letzten Teil der Tour werden Sie die CAPL-Programmiersprache kennen lernen
und zwei Netzwerkknoten eines verteilten Systems erstellen, um eine einfache
Simulationsaufgabe in CANoe zu lösen.
3.2 Vorbereitungen
CANoe starten Wenn Sie CANoe das erste Mal öffnen, dann wird automatisch eine neue
Konfiguration mit den Desktops Trace, Configuration und Analysis geöffnet.
Fenster CANoe verfügt über verschiedene Analysefenster (z.B Trace-, Daten-, Grafik- und
Statistik-Fenster) sowie einen Messaufbau und einen Simulationsaufbau, die Ihnen
den Datenfluss anzeigen und über die Sie CANoe gleichzeitig konfigurieren können.
Sie erreichen alle Fenster des Programms über das Menüband.
Legen Sie eine neue Stellen Sie sicher, dass Sie diese Tour mit einer neuen Konfiguration beginnen.
Konfiguration an Wählen Sie dazu über die Registerkarte Datei des Menübands|Neu das Template
CAN_83kBaud_2ch.tcn aus und klicken Sie auf Konfiguration erzeugen.
Der Assistent wird für diese Tour nicht benötigt.
Es wird eine Konfiguration mit den Desktops Trace, Configuration und Analysis
geöffnet.
Vorbereitungen Zur Inbetriebnahme von CANoe verwenden Sie einen von vorhandenen CAN-
Bussystemen unabhängigen Versuchsaufbau mit lediglich zwei Netzwerkknoten. Als
Netzwerkknoten dienen dabei die beiden CAN Controller Ihres Netzwerk-Interfaces.
Als Netzwerk-Interface verwenden Sie z.B. CANcaseXL oder CANcardXLe.
Verbinden Sie die Verbinden Sie zunächst die Kanäle 1 und 2 am Netzwerk-Interface (D-Sub-9-
Kanäle Ihres Stecker). Für eine High-Speed-Busankopplung benötigen Sie ein Verbindungskabel
Netzwerk-Interfaces (CANcable) mit zwei Busabschlusswiderständen von je 120 Ω. Bei einer Low-Speed-
Ankopplung benötigen Sie lediglich ein 3-adriges Kabel, um die den Busleitungen
CAN-High, CAN-Low und Masse zugeordneten Pins beider Controller miteinander zu
verbinden.
Der Bus, den Sie während dieser Tour verwenden, besteht also aus einem kurzen 2-
bzw. 3-adrigen Kabel, das die beiden CAN Controller der CAN-Karte miteinander
verbindet. Diese minimale Konfiguration ist erforderlich, da das CAN-Protokoll neben
einem Sender mindestens einen Empfänger erfordert, der korrekt empfangene
Botschaften mit einem Acknowledge quittiert.
Verbinden Sie das Bei externen Netzwerk-Interfaces, wie z.B. einem VN1630 oder einem CANcaseXL,
Netzwerk-Interface verwenden Sie ein USB-Kabel für die Verbindung zum Computer. Interne Netzwerk-
mit Ihrem Computer Interfaces wie, z.B. die CANcardXLe, stecken Sie direkt in Ihren Computer ein.
Legen Sie die Offen geblieben ist bis jetzt die Festlegung der Busparameter
Busparameter fest (Übertragungsgeschwindigkeit, Abtastzeitpunkt,…), die an jedem der beiden
beteiligten Controller eingestellt werden müssen.
1. Öffnen Sie zu diesem Zweck den Simulationsaufbau (Desktop Configuration
oder Registerskarte Simulation des Menübands|Simulationsaufbau) und
klicken Sie mit der rechten Maustaste auf das quadratische Bussymbol mit der
Beschriftung Netzwerk CAN1.
Abbildung 7: Netzwerk-Hardware-Konfigurationsdialog
3. Bearbeiten Sie die Busparameter zunächst für den ersten Controller. Dazu
klicken Sie auf CAN1|Setup und stellen Sie im Konfigurationsdialog zunächst die
Baudrate ein. Tragen Sie den Wert 100 kBaud ein. Dieser ist sowohl für High-
Speed als auch für Low-Speed-Busse sinnvoll. CANoe schlägt Ihnen
Standardwerte für die Controller-Register vor.
Damit haben Sie neben der Übertragungsgeschwindigkeit von 100 kBaud implizit
auch die anderen Controller Parameter (Abtastzeitpunkt, BTL Zyklen und
Synchronisationssprungweite) festgelegt. Damit das Gesamtsystem funktionieren
kann, müssen diese Werte genauso für den zweiten Controller CAN 2 (klick auf +
und Setup) übernommen werden. Bestätigen Sie die Werte mit [OK].
Reale Kanäle, Mit der Schaltfläche [Treiber...] öffnen Sie den Vector Hardware Config Dialog, in
Applikationskanäle welchem Sie die Applikationskanäle den realen Kanälen zuweisen können.
Erstellen Sie eine Ihr aktueller Versuchsaufbau enthält noch keine Datenquellen. Richten Sie daher
Datenquelle zuerst eine Datenquelle ein, die Informationen zyklisch auf den Bus legt.
Übung 1 Konfigurieren Sie CANoe so, dass nach Messungsstart alle 100 Millisekunden eine
CAN-Botschaft mit dem Identifier 64 (hex) auf den Bus gesendet wird. Die Botschaft
soll dabei genau vier Datenbytes mit den Werten D8 (hex), D6 (hex), 37 (hex) und 0
enthalten.
Fügen Sie eine Sie lösen diese Aufgabe, indem Sie eine Visuelle Sequenz einfügen, die die
Visuelle Sequenz ein gewünschte Botschaft auf den Bus sendet.
1. Öffnen Sie das Fenster Automatisierungssequenzen über das Register
Simulation des Menübands|Automatisierung.
Hinweis: Damit die Visuelle Sequenz abgespielt werden kann, muss sie in
diesem Fenster aktiviert sein. Da die Sequenz bis jetzt noch keine Daten enthält,
wird sie als ungültig angezeigt.
Die Visuelle Sequenz Botschaft 1 wird nach dem Anlegen automatisch im Visual
Sequencer geöffnet.
3. Geben Sie in der ersten Zeile die Daten der Botschaft mit den folgenden
Einstellungen ein:
Befehl: Set CAN Raw Frame (Auswahl über Listenfeld)
Objekt:
> Kanal: CAN1
> Identifier: 0x64
> Selektor: alle Daten
Operator: =
Operand: D8 D6 37 00
Abstand: 0
4. Um die Botschaft zyklisch zu senden, wählen Sie in der zweiten Zeile folgende
Einstellungen:
Befehl: Set CAN Cyclic Raw Frame (Auswahl über Listenfeld)
Objekt:
> Kanal: CAN1
> Identifier: 0x64
> Selektor: nicht verfügbar
Operator: cycle time (ms)
Operand: 100
Abstand: 0
6. Aktivieren Sie mit in der Symbolleiste das automatische Starten der Sequenz
bei Messungsstart.
Speichern Sie die Bevor Sie die Messung starten, sollten Sie Ihre bis hierhin vorbereitete Konfiguration
Konfiguration über die Registerkarte Datei des Menübands│Speichern abspeichern. Sie können
die Konfiguration dann jederzeit wieder laden und Ihre Arbeit genau an diesem Punkt
fortführen.
Starten Sie die Starten Sie die Messung mit auf der Registerkarte Home des Menübands. CANoe
Messung beginnt unmittelbar mit dem periodischen Senden der Botschaft, die Sie in Sequenz
Botschaft 1 konfiguriert haben.
In der ersten Spalte wird der Sendezeitpunkt relativ zum Messungsstart angezeigt.
Die nächste Spalte zeigt Ihnen an, über welchen der beiden CAN-Kanäle gesendet
bzw. empfangen wird.
Übung 2 Erweitern Sie die Konfiguration aus der letzten Aufgabe so, dass zusätzlich alle 500
Millisekunden eine Botschaft mit dem Identifier 3FC (hex) gesendet wird, der Wert
des ersten Datenbytes soll dabei zyklisch die Werte von 1 bis 5 annehmen.
Fügen Sie eine Sie lösen diese Aufgabe, indem Sie eine zweite Visuelle Sequenz Botschaft 2
zweite Visuelle einfügen, die die gewünschte Botschaft auf den Bus sendet.
Sequenz ein
Stoppen Sie vor dem Einfügen der zweiten Sequenz die Messung mit auf der
Registerkarte Home des Menübands.
Die Sequenz Botschaft 2 muss folgendermaßen definiert werden:
Aktivieren Sie mit in der Symbolleiste das periodische Wiederholen der Sequenz
Botschaft 2 bis Messungsstopp. Der Abstand legt die Zeit zwischen dem Abarbeiten
des einzelnen Sequenz-Schritte fest.
Aktivieren Sie mit in der Symbolleiste das automatische Starten der Sequenz bei
Messungsstart.
Starten Sie erneut die Messung mit auf der Registerkarte Home des Menübands.
Weitere Neben dem Visual Sequencer stellt Ihnen CANoe die folgenden Blöcke als
Datenquellen Datenquellen-Typen bereit:
> Mit dem Interaktiven Generator (IG) können Sie während des Messbetriebes
Botschaften konfigurieren und interaktiv auf den Bus senden. Zudem können Sie
Signalgeneratoren definieren.
> Mit dem Replay-Block können Sie Daten, die mit der Logging-Funktion von CANoe
aufgezeichnet wurden, wieder auf den Bus abspielen.
> Der Programmblock bietet Ihnen die Möglichkeit, mit der Programmiersprache
CAPL eigene u.U. auch recht komplexe Sendefunktionalitäten zu programmieren
und in CANoe einzubinden.
Verweis: Detaillierte Informationen zu den oben genannten Blöcken finden Sie in der
Hilfe von CANoe.
3.5 Analysefenster
Daten-Analyse Um die Daten zu analysieren, die über die Sequenzen Botschaft 1 und Botschaft 2
erzeugt werden, setzen Sie die Analysefenter ein.
Trace-Fenster Das Trace-Fenster haben Sie bereits kennen gelernt. Hier werden die Daten, die in
den Trace-Block des Messaufbaus gelangen, in einem busbasierten Format als CAN-
Botschaften dargestellt. Neben dem Zeitstempel gehört dazu die Nummer des CAN
Controllers, der Identifier, ein Attribut zur Unterscheidung von gesendeten bzw.
empfangenen Botschaften sowie die Datenbytes der CAN-Botschaft.
Konfiguration des Sie können das Trace-Fenster, wie alle Analysefenster über das Kontextmenü
Trace-Fensters konfigurieren, das Sie durch Klicken mit der rechten Maustaste auf das Fenster
erhalten.
Zur Konfiguration des Trace-Fensters stehen Ihnen ferner verschiedene
Schaltflächen in der Symbolleiste zur Verfügung. Mit können Sie beispielsweise
vom feststehenden Modus in den Scroll-Modus umschalten, in dem jede im Trace-
Block eintreffende Botschaft in eine neue Zeile geschrieben wird.
Mit schalten Sie von absoluter auf relative Zeitdarstellung um. In der relativen
Zeitdarstellung wird in der ersten Spalte die Zeitdifferenz zwischen zwei aufeinander
folgenden Botschaften („Sendeabstand“) dargestellt. In diesem Darstellungsformat
finden Sie natürlich auch leicht den Sendeabstand wieder, den Sie vorhin im Visual
Sequencer eingetragen haben: 100 Millisekunden.
Statistik-Fenster Als weiteres busbasiertes Fenster bietet Ihnen das CAN-Statistik-Fenster (Desktop
Analysis oder Registerskarte Analyse des Menübands|Statistik) eine
Gesamtübersicht über den Busdatenverkehr. Hier werden die Gesamthäufigkeiten
von Daten-, Remote und Error Frames, die Busauslastung sowie die Zustände der
CAN Controller angezeigt.
Da in unserem Fall eine Botschaft 1 alle 100 ms und die Botschaft 2 alle 500 ms
gesendet werden, liegt die Gesamthäufigkeit aller Botschaften bei 12 Frames pro
Sekunde. Bei einer durchschnittlichen Datenlänge von etwa 70 Bit pro Frame sollten
in der Sekunde ca. 12 * 70 ≈ 840 Bit auf den Bus gelangen. Bei einer Baudrate von
100 kBit/sec liegt folglich die Buslast in unserem Beispiel in der Größenordnung von
einem Prozent.
Symbolische Bevor wir auf die verbleibenden Fenster näher eingehen, werfen wir einen Blick auf
Beschreibung von die Möglichkeiten, die CANoe zur symbolischen Beschreibung von Daten bietet. Von
Daten Interesse sind bei der Analyse von CAN-Systemen neben busbasierten
Informationen, wie Botschaften, Error Frames und Botschaftshäufigkeiten vor allem
die Nutzinformationen, d.h. Signale, wie Drehzahl, Temperatur oder Motorlast, die
von einzelnen Steuergeräten bereitgestellt und mit Hilfe von CAN-Botschaften über
den Bus gesendet werden.
Um diese Informationen symbolisch zu beschreiben, stellt Ihnen CANoe das
Datenbasisformat DBC einschließlich eines Datenbasis-Editors zur Verfügung, mit
dem Sie Datenbasen lesen, erstellen und modifizieren können.
Verweis: Das CANdb++ Handbuch und die CANdb++ Hilfe enthalten weitere
Informationen zum Datenbasis-Editor.
Datenbasis zuordnen Wir wollen an dieser Stelle der aktuellen CANoe Konfiguration eine vorgegebene
Datenbasis zuordnen, mit der sich die Datenbytes der im Visual Sequencer erzeugten
Botschaften interpretieren lassen. Die Datenbasis PowerTrain.dbc befindet sich im
Verzeichnis CANoe Sample Configurations\CAN\CANSystemDemo\CANdb.
Der Speicherort des Verzeichnisses hängt von der Installation ab. Im Dialog
Optionen wird Ihnen der Speicherort angezeigt:
Registerkarte Datei des Menübands|Optionen|Allgemein|Speicherorte: Speicherort
für Benutzerdateien.
1. Stoppen Sie die Messung, um die Datenbasen hinzufügen, und öffnen Sie den
Simulationsaufbau (Desktop Configuration oder Registerskarte Simulation des
Menübands|Simulationsaufbau).
In der Systemansicht des Simulationsaufbaus sehen Sie eine Baumdarstellung
der aktuellen Konfiguration.
2. Selektieren Sie dort Datenbasen und öffnen Sie mit dem Kontextmenübefehl
Hinzufügen… den Dialog Öffnen.
3. Wählen Sie in diesem Dialog die oben genannte Datenbasis aus.
4. Mit der Schaltfläche [OK] wird die neue Datenbasis für den aktuellen Bus
übernommen und in der Systemansicht dargestellt.
Öffnen Sie nun die Datenbasis über das Symbol auf der Regisrekarte Werkzeuge
des Menübands. Der CANdb++ Editor wird geöffnet und der Inhalt der Datenbasis
POWERTRAIN.dbc im Übersichtsfenster des CANdb++ Editors dargestellt.
Hinweis: Der CANdb++-Editor validiert Eingaben und zeigt potentielle Fehler oder
Probleme im Übersichtsfenster an. Das Symbol an der Botschaft weist zum Beispiel
darauf hin, dass für diese Botschaft kein Empfängerknoten definiert ist.
Hinweis: Mit Hilfe dieser symbolischen Information lassen sich nun die Dateninhalte
von Botschaften in CANoe interpretieren. Beachten Sie, dass dies nur dann sinnvoll
ist, wenn die Informationen der Datenbasis das System beschreiben, das Sie gerade
beobachten. Stellen Sie daher sicher, dass die der Konfiguration zugeordnete
Datenbasis und das reale Netzwerk zusammenpassen.
Ausgabe im Trace- Im Trace-Fenster sehen Sie nun zusätzlich zum Identifier den symbolischen
Fenster Botschaftsnamen.
Beachten Sie, dass die Botschaft, die Sie in der ersten Aufgabe generiert haben, den
Identifier 64 (hex) besitzt. Dieser stimmt mit dem Identifier der Botschaft EngineData
überein.
Anzeige momentaner Neben den symbolischen Botschaftsnamen lassen sich mit der zugeordneten
Daten/Werte Datenbasis auch Signalwerte analysieren. Zur Untersuchung der momentanen
Signalwerte dient das Daten-Fenster (Desktop Analysis oder Registerskarte
Analyse des Menübands|Daten).
Damit ist klar, warum das Daten-Fenster in einer neuen Konfiguration zunächst leer
ist: Die anzuzeigenden Signalwerte hängen unter anderem von der Information aus
der Datenbasis ab. Welche Signalwerte angezeigt werden sollen, müssen Sie als
Benutzer entscheiden.
Übung 3 Konfigurieren Sie das Daten-Fenster so, dass die Signalwerte der im
Simulationsaufbau erzeugten Botschaft EngineData (ID 64 hex) angezeigt werden.
Fügen Sie im Daten- Um im Daten-Fenster Signalwerte anzeigen zu lassen, müssen Sie im Daten-Fenster
Fenster Signale Signale hinzufügen.
hinzu
Ausgabe im Daten- Nach Messungsstart beginnt die Sequenz Botschaft 1 die Botschaft EngineData
Fenster zyklisch mit den Datenbytes D8, D6, 37 und 0 auf den Bus zu legen. Nach der
Botschaftsbeschreibung in der Datenbasis, interpretiert das Daten-Fenster im
Messaufbau diese Bytewerte nun als Drehzahl, Temperatur und Leerlaufschalter und
stellt die entsprechenden Signalwerte in ihren physikalischen Einheiten im Daten-
Fenster dar.
Die Drehzahl wird also mit Hilfe der Umrechnungsformel der Datenbasis in
Umdrehungen pro Minute angezeigt, während Sie die Temperatur in Grad Celsius
sehen. Die Werte aller drei Signale bleiben zeitlich konstant, da vom Visual
Sequencer stets die Botschaft mit den gleichen Datenbytes D8, D6, 37 und 0
gesendet wird.
Analyse von Während das Daten-Fenster momentane Signalwerte anzeigt, können Sie im Grafik-
Signalverläufen Fenster (Desktop Analysis oder Registerskarte Analyse des Menübands|Grafik)
den zeitlichen Verlauf von Signalwerten darstellen. Nach Messungsende stehen zur
Untersuchung der Signalverläufe komfortable Analysefunktionen bereit.
Übung 4 Konfigurieren Sie das Grafik-Fenster so, dass die Signalwerte der im
Simulationsaufbau erzeugten Botschaft 3FC (hex) angezeigt werden.
Fügen Sie im Grafik- Auch die zweite im Simulationsaufbau erzeugte Botschaft ist in der zugeordneten
Fenster Signale Datenbasis beschrieben.
hinzu
Ausgabe im Grafik- Sie können den zeitlichen Verlauf dieser Signale jetzt im Grafik-Fenster beobachten.
Fenster Nach Start der Messung beobachten Sie, dass das Signal Gear zyklisch die Werte 1
bis 5 annimmt, während die anderen beiden Signale zeitlich konstant bleiben.
Für eine sinnvolle Darstellung der einzelnen Schaltwerte eignet sich die Linien-
Verbindungsart Stufe.
In der grafischen Darstellung des Signals Gear erkennen Sie die fünf Werte, die Sie
in Übung 2 in Sequenz Botschaft 2 eingetragen haben. Nach dem Ende der
Messung bleiben die Werte im Grafik-Fenster erhalten.
Für diese grafische Darstellung müssen Sie unter die separaten Ansichten der y-
Achsen auswählen.
Verweis: Die Messfunktionen, die Ihnen das Fenster zur nachträglichen Analyse von
Signalverläufen bietet, sind in der Hilfe von CANoe ausführlich beschrieben.
Sie erkennen ihn leicht am Dateisymbol , das die Logging-Datei symbolisiert. Die
Logging-Datei wird während der Messung mit CAN-Daten gefüllt.
Übung 5 Zeichnen Sie den gesamten CAN-Datenverkehr, der bei einer kurzen Messung (ca.
20 sec) von den Sequenzen erzeugt wird, im ASCII Format auf.
Aktivieren Sie den Um die Daten, die im Messaufbau von CANoe eintreffen, in eine Datei
Logging-Zweig aufzuzeichnen, stoppen Sie zunächst die Messung und aktivieren Sie den Logging-
Zweig. Entfernen Sie dazu die Unterbrechung, die den Logging-Block bei einer neuen
Konfiguration von der Datenquelle trennt, durch einen Doppelklick auf das
Unterbrechungssymbol oder über dessen Kontextmenübefehl Unterbrechung
entfernen.
Konfigurieren Sie die Die Angabe von Trigger-Bedingungen für die Dateiaufzeichnung ist oft sinnvoll, da
Trigger-Bedingungen der Datenverkehr auf dem CAN-Bus nicht während der gesamten Messung
interessiert, sondern nur bestimmte zeitliche Intervalle etwa bei unplausiblen
Signalwerten oder beim Auftreten von Error Frames.
Mit dem Kontextmenübefehl Konfiguration… des Logging-Blocks öffnen Sie den
Trigger-Konfigurationsdialog.
Zum Aufzeichnen der gesamten Messung muss im Trigger-Konfigurationsdialog der
Modus Gesamte Messung ausgewählt sein.
Starten Sie die Starten Sie nach der Konfiguration der Logging-Datei und der Trigger-Bedingungen
Messung die Messung, die Sie nach 20 Sekunden wieder stoppen.
Öffnen Sie die Mit dem Kontextmenübefehl Logging-Datei öffnen… des Dateisymbols öffnen Sie
Logging-Datei die aufgezeichnete ASCII-Datei. Neben den geloggten Botschaften erkennen Sie,
dass auch Statistikinformationen mit aufgezeichnet worden sind. Diese Zeilen
entsprechen genau den Informationen, die während einer Messung im Statistik-
Fenster dargestellt werden.
Aufgezeichnete Logging-Dateien im ASCII-Format lassen sich mit Texteditoren betrachten. Oft ist es
Daten wiedergeben aber sinnvoller, die Möglichkeiten auszunutzen, die CANoe zur Offline-Analyse von
Logging-Dateien bereitstellt.
Übung 6 Spielen Sie die der letzten Aufgabe aufgezeichnete Logging-Datei im Offline-Modus
ab und beobachten Sie den Signalverlauf im Grafik-Fenster.
Aktivieren Sie den Um die Aufgabe zu lösen, schalten Sie CANoe zunächst in den Offline-Modus.
Offline-Modus Wählen Sie dazu auf der Registerkarte Home des Menübands den Offline-Modus
aus oder schalten Sie mit einem Doppelklick auf das Online-/Offline-Symbol im
Messaufbau zum Offline-Modus um. Alle Konfigurationseinstellungen werden in den
Offline-Modus übernommen.
Im Messaufbau wird nun das Bussymbol deaktiviert dargestellt. Stattdessen wird das
Dateisymbol als Datenquelle aktiviert.
Wählen Sie die Wählen Sie die Logging-Datei der letzten Aufgabe über den Kontextmenübefehl
Datenquelle Konfiguration… des Dateisymbols links im Messaufbau.
Deaktivieren Sie den Unterbrechen Sie nun die Verbindung zum Logging-Block. Dies können Sie durch
Logging-Zweig einen Doppelklick auf den Hot Spot vor dem Logging-Block (links) oder über dessen
Kontextmenü machen.
Spielen Sie die Mit der <F9>-Taste oder mit auf der Registerkarte Home des Menübands können
Logging-Datei ab Sie nun die Messung abspielen. Im Gegensatz zum Online-Modus bietet Ihnen
CANoe hier zusätzlich die Möglichkeit die Messung verlangsamt (Registerkarte
Home des Menübands| Animieren bzw. <F8>) bzw. im Einzelschrittbetrieb
(Registerkarte Home des Menübands|Zeitschritt bzw. <F7>) abzuspielen.
Analyse im Offline- Im Offline-Modus stehen Ihnen die gleichen Analysefunktionen wie im Online-Modus
Modus zur Verfügung. Somit werden in beiden Modi die aufgezeichneten Daten busbasiert
im Trace-Fenster dargestellt, während Sie im Grafik-Fenster die Signalverläufe der
Aufzeichnung beobachten können.
Natürlich können Sie in den Messaufbau auch Filter oder CAPL-Programme
einfügen, um die Daten weiter zu reduzieren bzw. zusätzliche benutzerdefinierte
Analysefunktionen einzuführen.
Was bedeutet CAPL CAPL ist eine ereignisorientierte Programmiersprache. Jedes CAPL-Programm
besteht aus Ereignisprozeduren, mit denen Sie auf äußere Ereignisse (wie z.B. auf
das Auftreten bestimmter Botschaften am Bus oder das Betätigen von Tasten auf der
Computer Tastatur) reagieren können. Der CAPL Browser wird in der Hilfe von
CANoe ausführlich beschrieben. Er ermöglicht es Ihnen mit seinen Teilfenstern
(„Panes“) CAPL-Programme schnell und einfach zu erstellen und zu bearbeiten.
Grundsätzlich können Sie zum Erstellen von CAPL-Programmen auch Ihren eigenen
Texteditor verwenden. CAPL Programme sind normale ASCII Dateien mit der
Standard Dateierweiterung *.can, die vor dem Messungsstart mit dem zum
Lieferumfang von CANoe gehörenden Compiler übersetzt werden müssen.
Verweis: Eine vollständige Beschreibung der Programmiersprache finden Sie
zusammen mit zahlreichen ausführlichen Beispielen in der Hilfe von CANoe.
Erstellen eines In der nächsten Aufgabe werden Sie ein einfaches CAPL-Programm erstellen, um
CAPL-Programms Botschaften zu zählen, die im Simulationsaufbau von CANoe erzeugt werden.
Übung 7 Erstellen Sie ein CAPL-Programm, mit dem Sie Botschaften von Typ EngineData (Id
64 hex) zählen und die Anzahl der gezählten Botschaften auf Tastendruck im Write-
Fenster ausgeben können.
Vorbereitungen > Schalten Sie CANoe zunächst wieder in den Online-Modus zurück.
> Mit der Sequenz Botschaft 1 wird die Botschaft EngineData zyklisch auf den Bus
gelegt.
Fügen Sie einen Zunächst müssen Sie entscheiden, an welcher Stelle Sie Ihr CAPL-Programm im
CAPL-Knoten ein Datenflussplan einfügen. Da es sich um ein reines Analyse-Programm handelt, das
keine Botschaften erzeugt, sondern lediglich zählt, bietet es sich an, das Programm
im Messaufbau, etwa vor dem Trace-Fenster einzufügen. Wählen Sie im
Kontextmenü des Hot Spots die Funktion Programmknoten einfügen. Im
Messaufbau erscheint an der gewählten Stelle nun ein Funktionsblock mit dem
Programmsymbol P.
Konfigurieren Sie Den Konfigurationsdialog des Knotens öffnen Sie über den Kontextmenübefehl
den CAPL-Knoten Konfiguration…. Wählen Sie hier zunächst einen Programmnamen, z.B.
COUNTER.can aus.
Starten Sie den Starten Sie den CAPL Browser entweder über die Schaltfläche [Bearbeiten…] des
CAPL Browser Konfigurationsdialoges oder direkt mit einem Doppelklick auf den Programmblock P
im Messaufbau.
Fügen Sie eine Zunächst benötigen Sie für das Programm eine Ganzzahlvariable, welche die
Variable ein Botschaften zählt. Nennen Sie sie z.B. counter. Gehen Sie in den Editorbereich des
Browsers, und tragen Sie diesen Namen im Variablenblock ein. In diesem Teilfenster
sollte nun
variables
{
int counter;
}
stehen. Die Variable wird – wie alle globalen Variablen – bei Messungsstart
automatisch auf Null initialisiert.
Erstellen Sie eine Im nächsten Schritt soll diese Variable inkrementiert werden, immer wenn eine
Ereignisprozedur Botschaft EngineData registriert wird. Sie müssen das CAPL Programm also um eine
on message Ereignisprozedur vom Typ on message („Reagiere auf Botschaftsereignis“)
erweitern. Klicken Sie dazu links in der Baumansicht den Eintrag CAN mit der rechten
Maustaste an. Öffnen Sie das Untermenü Neuer Event Handler. Wählen Sie dann
den Befehl on message <newMessage>.
Im Prozedurtext-Editor erscheint nun ein Prozedurrumpf. Ersetzen Sie hier zunächst
den Text <newMessage> durch den symbolischen Namen EngineData, den Sie
auch direkt über den Kontextmenübefehl Botschaft aus Datenbasis… aus der
Datenbasis übernehmen können. Der CAPL-Compiler ersetzt beim Kompilieren den
symbolischen Namen durch den entsprechenden Identifier 0x64.
Jetzt bleibt nur noch zu definieren, welche Aktionen bei Eintreten des Ereignisses
ausgeführt werden sollen. Da das Programm Botschaften zählen soll, muss die
Variable counter beim Registrieren einer Botschaft inkrementiert werden. Die fertige
Prozedur sieht folgendermaßen aus:
on message EngineData
{
counter++;
output(this); // Die Botschaft EngineData wird im
// Trace-Fenster angezeigt
}
Erstellen Sie eine Damit auch alle anderen Botschaften im Trace-Fenster angezeigt werden, muss noch
zweite on message folgende Prozedur geschrieben werden:
Ereignisprozedur
on message*
{
output(this);
}
Hinweis: Ohne diese Prozedur würde das eingefügte CAPL-Programm wie ein Filter
wirken, da nur die Botschaft EngineData an das Trace-Fenster im Messaufbau
weitergeleitet werden würde.
Erstellen Sie eine Im letzten Schritt muss nun noch die Ausgabe ins Write-Fenster implementiert
Ereignisprozedur werden. Schließlich soll das Programm nicht nur Botschaften zählen, sondern Sie
on key möchten auch kontrollieren, wie viele Botschaften gezählt worden sind.
Die Ausgabe soll auf Drücken der Taste <a> ins Write-Fenster erfolgen. Sie müssen
also eine weitere Ereignisprozedur für das Ereignis Drücke Taste <a> definieren.
Fügen Sie nun dem CAPL Programm eine Keyboard-Ereignisprozedur hinzu. Klicken
Sie dazu links in der Baumansicht den Eintrag System mit der rechten Maustaste an.
Öffnen Sie den Menüpfad Neuer Event Handler|on key <newKey>. Im
Prozedurtext-Editor erscheint ein neuer Prozedurrumpf, den Sie folgendermaßen
ausfüllen:
on key 'a'
{
write("%d Botschaften EngineData gezaehlt",counter);
}
Die Formatangabe %d bezieht sich auf die Ganzzahlvariable counter, die hinter
dem Komma angegeben ist. Der Format-String entspricht weitgehend dem der C
Funktion printf().
Speichern und Das Programm ist damit fertig. Speichern Sie es ab und starten Sie dann den
Kompilieren Sie das Compiler mit der Taste <F9>, über den Menüpfad Compiler│Kompilieren oder über
Programm die Symbolleiste.
Falls Sie beim Erstellen des Programms einen Fehler gemacht haben, öffnet sich ein
Meldungsfenster, das Ihnen den Fehler anzeigt. Doppelklicken Sie auf diese
Fehlermeldung, um an die Stelle zu gelangen, an welcher der Fehler aufgetreten ist.
Nachdem Sie ihn korrigiert und die Programmdatei erneut abgespeichert haben,
kompilieren Sie das Programm erneut. Wenn das Programm fehlerfrei kompiliert
werden konnte, erscheint im Ausgabe-Fenster die Meldung Kompilierung
erfolgreich beendet.
Ausgabe im Write- Starten Sie nun die Messung. Die Sequenz Botschaft 1 beginnt daraufhin,
Fenster Botschaften vom Typ EngineData zyklisch zu senden, die nun von Ihrem Programm
gezählt werden. Immer wenn Sie die Taste <a> drücken, werden Sie den Text n
Botschaften EngineData gezaehlt im Write-Fenster sehen, wobei n die Anzahl der
gezählten Botschaften bezeichnet.
Arbeiten mit Um das funktionale Busverhalten von Netzwerkknoten zu modellieren, stellt Ihnen
Systemvariablen CANoe Systemvariablen zur Verfügung, mit denen Ereignisse und Zustände der
Systemumgebung (äußerer Druck, Temperatur, Schalterstellungen, …) beschrieben
werden. Sie können diese Zustände, d.h. die Werte der Systemvariablen auf frei
gestaltbaren Panels sowohl beobachten als auch gezielt verändern.
Zum Arbeiten mit Systemvariablen verwenden Sie in CAPL den Ereignisprozedurtyp
on sysvar ("Reagiere auf Systemvariablenänderung"). Zum Lesen und Schreiben
der Systemvariablenwerte dienen z.B. die CAPL-Funktionen SysGetVariableInt
und SysSetVariableInt. Diese Sprachmittel und der symbolische Zugriff auf die
verschiedenen in der Datenbasis definierten Variablen ermöglichen die einfache
prototypische Erstellung von Netzwerkknotenmodellen.
Übung 8 Erstellen Sie eine komplette CANoe Konfiguration mit zwei Netzwerkknotenmodellen
und der zugehörigen Peripherie, d.h. den Panels. Dabei soll lediglich eine verteilte
Funktionen realisiert werden: Nachdem der Benutzer einen Schalter mit der linken
Maustaste betätigt, informiert der erste Netzwerkknoten den zweiten über diese
Aktion. Der zweite Knoten schaltet daraufhin an seiner Peripherie ein Lämpchen ein.
Schaubild
Vorgehensweise Die Erstellung eines Modells für verteilte Systeme wird in CANoe zweckmäßigerweise
in drei Teilaufgaben unterteilt:
> Erstellen der Datenbasis mit Botschaften und Signalen
> Erstellen der Netzwerkknotenperipherie, d.h. der Panels
> Erstellen der Netzwerkknotenmodelle in CAPL
Bereiten Sie die Aufgabe vor, indem Sie über die Registerkarte Datei des
Menübands│Neu das Template CAN_83kBaud_2ch.tcn auswählen und auf
Konfiguration erzeugen klicken.
Funktion einer Im ersten Schritt erstellen Sie eine Datenbasis, welche einen wesentlichen Teilaspekt
Datenbasis des Systems beschreibt: den Informationsaustausch zwischen den beiden
Netzwerkknoten über das Kommunikationsmedium, d.h. den Bus.
Zur Beschreibung des Informationsaustausches über den Bus stellt Ihnen die
Datenbasis Botschafts- und Signalobjekte zur Verfügung. Die einfache Funktionalität
des Beispiels lässt sich in einem 1 Bit Signal fassen, das den Zustand des Schalters
am ersten Netzwerkknoten beschreibt. Dieses Signal wird in eine Botschaft gepackt
und immer dann gesendet, wenn sich der Zustand des Schalters ändert (spontanes
Senden).
Datenbasis erstellen Erstellen Sie nun eine Datenbasis, die die Botschaft Msg1 und das Signal bsSwitch
enthält.
1. Öffnen Sie über das Symbol auf der Registerkarte Werkzeuge des
Menübands den CANdb++ Editor.
2. Öffnen Sie den Dialog Vorlage über Datei|Datenbank erstellen….
3. Wählen Sie das Template CANoeTemplate.dbc aus.
4. Mit [OK] öffnen Sie den Dialog Neue Datenbankdatei.
Geben Sie hier den Namen der neuen Datenbasis (z.B. Database) an.
5. Schließen Sie den Dialog mit [Speichern].
Die neue Datenbasis wird im CANdb++ Editor angezeigt.
Botschaft erstellen Erstellen Sie nun die Botschaft Msg1 dem Identifier 100, die vom ersten
Netzwerkknoten gesendet werden soll.
Selektieren Sie dazu Botschaften und öffnen Sie mit dem Kontextmenübefehl Neu…
den Konfigurationsdialog für die neue Botschaft. Geben Sie auf der Seite Definition
folgendes ein:
> Name: Msg1
> Typ: CAN Standard
> ID: 0x100
> DLC: 8
Schließen Sie den Dialog mit [OK].
Signal erstellen Erstellen Sie das Signal bsSwitch zur Beschreibung der Schalterstellung und
verknüpfen Sie es mit der Botschaft Msg1.
Selektieren Sie dazu Signale und öffnen Sie mit dem Kontextmenübefehl Neu… den
Konfigurationsdialog für das neue Signal. Geben Sie auf der Seite Definition
folgendes ein:
> Name: bsSwitch
> Länge [Bit]: 1 (für die Übertragung der Zustände an=1 und aus=0)
> Byteorder: Intel
> Wertetyp: Unsigned
> Faktor: 1
> Offset: 0
> Minimum: 0
> Maximum: 1
Signal mit Botschaft Sie können das Signal bsSwitch per Drag-and-Drop mit der Botschaft Msg1
verknüpfen verknüpfen.
Datenbasis der Die Zuordnung der Datenbasis erfolgt im Simulationsaufbau. Gehen Sie dazu in der
Konfiguration Baumdarstellung der aktuellen Konfiguration mit dem Mauszeiger auf Datenbasen
zuordnen und rufen Sie über die rechte Maustaste den Befehl Hinzufügen… des
Kontextmenüs auf.
Definieren Sie Im zweiten Schritt beschreiben Sie die I/O Schnittstelle zwischen Netzwerkknoten
Systemvariablen und Peripherie. Dazu stellt Ihnen CANoe Systemvariablen zur Verfügung. Jedes
Peripherie Element (Schalter, Lämpchen, Schieberegler, …) wird mit einer
Systemvariable „verdrahtet“, d.h. an das CAPL-Programm für den Netzwerkknoten
angeschlossen.
In diesem Beispiel gibt es genau zwei Peripherie-Elemente: einen Schalter am ersten
Netzwerkknoten und ein Lämpchen am zweiten. Also müssen zwei Systemvariablen
z.B. svLight und svSwitch in der Datenbasis erstellt werden.
4. Öffnen Sie für die Definition der zweiten Systemvariablen svSwitch über
wieder den Dialog Neue Systemvariable und machen Sie folgende Eingaben:
> Namensraum: MyNamespace
> Name: svSwitch
> Datentyp: Integer
5. Schließen Sie den Dialog mit [OK].
Sie sehen nun, dass beide Systemvariablen dem Namensraum MyNamespace
zugewiesen sind.
6. Schließen Sie den Dialog mit [OK].
Netzwerkknoten- Zum Erstellen der Peripherie der Netzwerkknoten steht Ihnen in CANoe eine eigene
Peripherie Applikation, den Panel Designer, zur Verfügung. Für die aktuelle Konfiguration ist für
jeden der beiden Netzwerkknoten ein Panel zu erstellen.
Verweis: Eine ausführliche Einführung zum Panel Designer finden Sie in der Hilfe
von CANoe.
Erstellen Sie das Das erste Panel hat als Bedienelement einen Schalter.
erste Panel
1. Sie starten den Panel Designer mit auf der Registerkarte Werkzeuge des
Menübands von CANoe. Damit ist gewährleistet, dass im Panel Designer die
Datenbasis zur Verfügung steht.
Ein neues Panel wird automatisch geöffnet.
2. Geben Sie dem Panel im Eigenschaften-Fenster unter Panel|Panel Name den
Namen SWITCH. Dieser Name wird nach dem Speichern des Panels oben links
im geöffneten Panel angezeigt wird.
3. Wählen Sie aus der Toolbox des Panel Designer einen Switch aus und
platzieren Sie ihn z.B. per Drag-and-Drop auf dem Panel.
4. Konfigurieren Sie den Switch im Eigenschaften-Fenster unter Settings|State
Count als Bedienelement mit 2 Zuständen.
5. Weisen Sie dem Switch im Eigenschaften-Fenster unter Settings|Mouse
Activation Type die linke Maustaste Left zu.
6. Weisen Sie dem Switch im Eigenschaften-Fenster unter Appearance|Image die
Datei IOrgPushButton_2.BMP aus dem CANoe Verzeichnis CANoe Sample
Configurations\Programming\Bitmap_Library\Global\Switches_2S
tates zu.
7. Damit im Symbol Explorer die definierten Systemvariablen angezeigt werden,
müssen Sie im Listenfeld Beschränkt auf den Eintrag Variablen auswählen.
Ziehen Sie anschließend die Systemvariable svSwitch aus dem Symbol
Explorer per Drag-and-Drop auf den Switch im Panel.
8. Beschriften Sie den Switch, indem Sie das Anzeigeelement Static Text aus
der Toolbox auswählen und auf dem Panel rechts neben dem Switch platzieren.
Geben Sie im Eigenschaften-Fenster für den Static Text unter Appearance|Text
die gewünschte Beschriftung ein.
9. Die Größe des Panels verändern Sie, indem Sie im Panel Designer den Rand
des Panels anklicken und dann ziehen. Gestalten Sie die Panels nicht größer als
unbedingt nötig, da der freie Bildschirmplatz meist eine wertvolle, sehr
beschränkte Ressource darstellt.
10. Speichern Sie das Panel unter dem Namen SWITCH.xvp ab.
Erstellen Sie das Das zweite Panel verfügt lediglich über ein Lämpchen als Anzeigeelement.
zweite Panel
1. Öffnen Sie über den Menüpfad Datei|Panel neu ein neues Panel und wählen Sie
als Panel Namen LIGHT.
2. Wählen Sie aus der Toolbox des Panel Designers einen Switch aus und
platzieren Sie ihn z.B. per Drag-and-Drop auf dem Panel.
3. Konfigurieren Sie den Switch im Eigenschaften-Fenster unter Settings |State
Count als Anzeigeelement mit 2 Zuständen.
4. Weisen Sie dem Switch im Eigenschaften-Fenster unter Appearance|Image die
Bild-Datei MLEDRED_2.BMP aus dem CANoe Verzeichnis CANoe Sample
Configurations\Programming\Bitmap_Library\Global\Indicator_2
States zu.
5. Weisen Sie per Drag-and-Drop aus dem Symbol Explorer die Systemvariable
svLight dem Switch zu.
6. Beschriften Sie den Switch, indem Sie das Anzeigeelement Static Text aus
der Toolbox auswählen und auf dem Panel rechts neben dem Schalter platzieren.
Geben Sie im Eigenschaften-Fenster für den Static Text unter Appearance|Text
die gewünschte Beschriftung ein.
7. Speichern Sie das Panel unter dem Namen LIGHT.xvp ab.
Fügen Sie die Panels Sie beenden diesen Aufgabenteil, indem Sie über die Schaltfläche in der
in die Konfiguration Symbolleiste die erstellten Panels in die CANoe Konfiguration integrieren.
ein
Speichern Sie die Vor dem Erstellen der Netzwerkknotenmodelle sollten Sie die bis jetzt angelegte
Konfiguration Konfiguration mit der Schaltfläche auf der Registerkarte Home des Menübands
von CANoe abspeichern.
Fügen Sie zwei In diesem Beispiel benötigen Sie zwei Netzwerkknoten im Simulationsaufbau: der
Netzwerkknoten ein erste Knoten liefert die Schalterposition, der zweite reagiert darauf, indem er das
Lämpchen ein- bzw. ausschaltet.
Klicken Sie im Simulationsaufbau auf den Busstrang, um neue
Netzwerkknotenmodelle einzufügen.
Konfigurieren Sie die Den Konfigurationsdialog der Knoten öffnen Sie über den Kontextmenübefehl
Netzwerkknoten Konfiguration…. Tragen Sie hier den Knotennamen ein (z.B. ECU 1 bzw. ECU 2).
Über [Datei…] öffnen Sie den Dialog Öffnen. Geben Sie hier den Namen des CAPL-
Programms an, welches die Funktionalität des Netzwerkknotens simuliert (z.B.
ECU1.can bzw. ECU2.can).
Erstellen Sie die Doppelklicken Sie auf jeden Knoten, um den CAPL Browser für das jeweilige CAPL-
benötigten CAPL- Programm zu öffnen. Das erste Programm gehört zu einem Netzwerkknoten, an
Programme dessen Peripherie sich ein Schalter befindet. Das Programm erfasst bei Änderung
der Schalterposition den neuen Schaltwert und gibt diesen unmittelbar auf den Bus
aus:
// Reaktion auf die Änderung der Systemvariable svSwitch
on sysvar sysvar::MyNamespace::svSwitch {
// Deklaration einer zu versendenden CAN-Botschaft
message Msg1 msg;
// Auslesen des Wertes des Lichtschalters,
// Zuweisung an das Bussignal bsSwitch
msg.bsSwitch = SysGetVariableInt(sysvar::MyNamespace::svSwitch);
// Ausgabe der Botschaft auf den Bus (spontanes Senden)
output(msg);
}
Der zweite Netzwerkknoten reagiert auf diese Botschaft. Das CAPL Programm liest
den Wert des Bussignals für die Schalterposition und schaltet daraufhin das
Lämpchen an seiner Peripherie ein oder aus. Beachten Sie, dass der Wert des
Schalters allein über den Signalwert am Bus erfasst wird. Der Wert der
Systemvariablen svSwitch ist diesem CAPL Programm nicht bekannt. Die
Kommunikation zwischen beiden Knoten erfolgt also über den Bus:
// Reaktion auf den Empfang der CAN-Botschaft M1
on message Msg1 {
// Auslesen eines Bussignals und
// Setzen der Systemvariablen
SysSetVariableInt(sysvar::MyNamespace::svLight, this.bsSwitch);
}
Starten Sie die Starten Sie nun in CANoe die Messung. Immer wenn Sie den Schalter auf Panel 1
Messung einschalten, leuchtet das Lämpchen auf. Wenn Sie ihn wieder ausschalten, erlischt
das Lämpchen. Das Trace-Fenster zeigt Ihnen dazu sowohl die Buskommunikation
(Spontanes Senden der Botschaft Msg1 bei Ändern der Schalterposition) als auch
die Werte der Systemvariablen svSwitch und svLight an.
4 Anhang A: Support
Diese Informationen Bei Supportanfragen per Telefon, E-Mail, Fax oder per Post benötigen wir für eine
benötigt der Support schnelle Bearbeitung folgende Angaben:
Software > Detaillierte Bezeichnung der Software, Hardware-Ausführung und
Versionsnummer, z.B. CANoe 7.5.66 (SP2), CANcardXL
> Seriennummer
Hinweis: Diese Informationen finden Sie in CANoe auf der Registerkarte Datei des
Menübands|Hilfe|Details.
> News
> Produkte
> Demo-Software
> Support
> Seminare und Workshops
> Adressen
www.vector.com