NetworkDesigner22 LIN Manual en
NetworkDesigner22 LIN Manual en
Imprint
Vector Informatik GmbH
Ingersheimer Str. 24
D-70499 Stuttgart
The information and data given in this user manual can be changed without prior notice. No part of this manual may be reproduced in
any form or by any means without the written permission of the publisher, regardless of which method or which instruments, electronic
or mechanical, are used. All technical information, drafts, etc. are liable to law of copyright protection.
Copyright 2010, Vector Informatik GmbH. Printed in Germany.
All rights reserved.
80410
Table of contents
Table of contents
1
Introduction
1.1
1.2
1.3
1.4
7
8
8
8
8
Installation
2.1
General
10
2.2
11
2.3
11
Basics
13
3.1
Functionality
14
3.2
14
3.3
17
Usage
23
4.1
24
4.2
24
4.3
25
4.4
26
4.5
Windows / editors
4.5.1
The Project Explorer
4.5.2
The Library Browser
4.5.3
The Network Explorer
4.5.4
Object List window
4.5.5
Gateway Routing window
4.5.6
Attribute Definition window
4.5.7
Consistency Check window
27
27
28
29
31
31
32
32
Concepts
35
5.1
36
37
37
5.2
User-defined attributes
38
5.3
Workspace
39
5.4
39
5.5
40
Tutorial
41
Version 2.2
-I-
Table of contents
6.1
Overview
6.2
42
6.3
43
6.4
48
6.5
51
51
52
54
54
6.6
55
6.7
Consistency Check
56
6.8
57
6.9
58
Appendix A: Glossary
59
7.1
Network Designer
59
7.2
62
7.3
62
7.4
62
63
64
10
66
11
Appendix A: Addresses
67
- II -
42
Version 2.2
Introduction
1 Introduction
In this chapter you find the following information:
1.1
page 4
1.2
page 6
1.3
page 6
1.4
page 7
Version 2.2
-3-
Introduction
1.1
Application areas
Network Designer LIN is a tool for designing the network architecture and
communication data for distributed ECU systems. This includes
> design of hardware topologies based on ECUs and networks
> definition of signals and messages along with their transmitters and recipients, as
well as
> specification of message timings.
Organization of the
data
Data for multiple networks and vehicle projects are saved in one Network Designer
workspace.
The communication descriptions of individual LIN networks can be exported to and
imported from LDF files. The exported LDF files can then be used in subsequent
development steps, e.g., simulation, ECU software configuration and ECU testing.
The communication descriptions of individual LIN 2.x slave nodes can be exported to
and imported from NCF files.
Tool chain
User interface
-4-
The user interface is designed for efficiency. The hardware topology and network
communication are shown hierarchically. Data can be entered either directly into
object lists or via dialogs. Communication relations can be created using drag & drop
or via the menu.
Version 2.2
Introduction
Version 2.2
-5-
Introduction
1.2
Product family
components
Integrated use of
programs
Advantages of
integrated use
1.3
Interaction between
the programs
Network Designer LIN is the central tool in Vector LIN tool chains such as CANoe.LIN
as well as in CANbedded LIN software components.
Communication data is defined, modified and managed in Network Designer LIN, and
the Vector LIN tools have read-only access to that data. Communication data is
exchanged between tools in the form of LDF / NCF files (*.ldf / *.ncf) for this purpose.
Data export
-6-
Network Designer LIN provides several functions to export the LIN data contained in
a workspace. The data of a whole LIN network is exported to an LDF file while the
data of a single slave node is exported to an NCF file.
Version 2.2
1.4
Introduction
To find information
quickly
> At the beginning of each chapter you will find a summary of the contents,
> In the header you can see in which chapter and paragraph you are ((situated)),
> In the footer you can see to which version the user manual replies,
> At the end of the user manual you will find an index, with whose help you will
quickly find information.
In the two following charts you will find the conventions used in the user manual
regarding utilized spellings and symbols.
Style
Utilization
bold
Network Designer
Source code
Hyperlink
<STRG>+<S>
Symbol
Utilization
Conventions
Version 2.2
-7-
Introduction
1.4.1 Certification
Certified Quality
Vector Informatik GmbH has ISO 9001:2008 certification. The ISO standard is a
Management System globally recognized quality standard.
1.4.2 Warranty
Restriction of
warranty
We reserve the right to change the contents of the documentation and the software
without notice. Vector Informatik GmbH assumes no liability for correct contents or
damages which are resulted from the usage of the user manual. We are grateful for
references to mistakes or for suggestions for improvement to be able to offer you
even more efficient products in the future.
1.4.3 Support
You need support?
All trademarks mentioned in this user manual and if necessary third party registered
are absolutely subject to the conditions of each valid label right and the rights of
particular registered proprietor. All trademarks, trade names or company names are
or can be trademarks or registered trademarks of their particular proprietors. All rights
which are not expressly allowed are reserved. If an explicit label of trademarks, which
are used in this user manual, fails, should not mean that a name is free of third party
rights.
> Outlook, Windows, Windows XP, Windows 2000, Windows NT are trademarks of
the Microsoft Corporation.
> Network Designer is a trademarks of Vector Informatik GmbH.
> eclipse is subject to the Copyright of the Eclipse contributors and others.
-8-
Version 2.2
Installation
2 Installation
In this chapter you find the following information:
2.1
General
page 10
2.2
page 11
2.3
page 11
Version 2.2
-9-
Installation
2.1
General
Info: The software installation requires administrator rights!
Network Designer has a product activation feature that links the software license to
specific computer hardware. Unless activated Network Designer can't be started.
Please see documentation "NetworkDesigner_ProductActivation.pdf" available on the
installation CD.
- 10 -
Version 2.2
2.2
Installation
Network Designer LIN includes a comprehensive online help that can be accessed
via the Help menu, the [Help] button or the <F1> key.
Online help
Documentation
browser
2.3
Please contact us
Should you experience problems or errors when running the program, please send us
a description of the problem or error in as much detail as possible.
Please send an email with the following information to [email protected]:
>
>
>
>
Email contact
Please provide the
following information
Version 2.2
- 11 -
Basics
3 Basics
In this chapter you find the following information:
3.1
Functionality
page 14
3.2
page 14
3.3
page 17
Version 2.2
- 13 -
Basics
3.1
Functionality
Range of functions
3.2
Overview
Vehicle projects
Vehicle hardware
topology
- 14 -
ECUs realize specific behaviors via their software, and can exchange data on the
networks they are connected to. Such a connection is called a network node.
Version 2.2
Basics
An ECU can be connected to several networks via one network node respectively.
Such ECUs constitute gateways between networks.
Signals are routed from one network (source network) to another network (destination
network) via gateways.
Vehicle topology with 2 CAN buses, one LIN bus and one FlexRay bus.
Signals
These global signals can be used (referenced) in multiple vehicle projects and
networks. The global nature of these signals makes it possible to create a signal pool
for use across several projects.
In a vehicle, signals are sent from one ECU on a network and received by other
ECUs on that network. These transmission and reception relations are called Tx
(transmit) and Rx (receive) relations.
In order to be transmitted on a network, signals must be placed (mapped) on frames.
In a physical network, the frames are then transmitted using the network protocol.
In a vehicle, signals are sent from one ECU on a network and received by other
ECUs on that network. These transmission and reception relations are called publish
and subscribe relations.
Transmission and
reception relations
The exchange of data between ECUs is defined as follows: the ECU that makes the
data available sends it to the network in the form of signals. The ECU that requires
the data receives the signals from the network.
Because signals on a real network are always transmitted using frames, frames must
also be taken into consideration when creating a comprehensive description of the
communication relations.
In a LIN network the following communication relations exist:
Published signal
Subscribed signal
Published frame
Version 2.2
- 15 -
Basics
Workflow
The messages and frames are transmitted on the bus according to a defined timing.
The way this timing is defined depends on the bus system.
>
>
Design workflow
Development steps for designing a network architecture and the data communication:
Advantages
You can define all communication-related objects with Network Designer LIN and
save them in a Network Designer workspace. This data is then re-used in subsequent
development steps, such as the generation of software components for an ECU's
data communications, definition of ECU tests and network analyses. This way of
working has the advantage that you specify the data for all of the networks
consistently and simultaneously when you begin developing the distributed ECU
network, and then re-use it in subsequent development steps.
- 16 -
Version 2.2
Basics
V model
3.3
Export
Communication
description
Version 2.2
- 17 -
Basics
Designing the
hardware topology
The vehicles hardware topology thus has the following schematic structure:
In Network Designer LIN, the hardware topology for a vehicle project is defined in the
Project Explorer. It would look like this in our example:
Defining global
signals
- 18 -
The signals exchanged between the ECUs, along with the signal properties, are
defined in the table below:
Signal
Value type
Length
[bit]
Resolution
WindowMotion
unsigned
WindowPosition
unsigned
CrushGuardActivity
unsigned
Version 2.2
Value range
Unit
03
0: no motion
1: up
2: down
3: reserved
0.4
0100
01
0: inactive
1: active
Basics
In Network Designer LIN, the signals are defined either in the Library Browser or in
the signal list:
When the window lift button in a car is pressed, the door ECU transmits the desired
Designing signaldirection of motion to the WindowLifter ECU using the WindowMotion signal. This
oriented transmission
and reception
request is initially transmitted on the CAN bus and is received by the door ECU via
relations
this bus. The WindowLifter ECU transmits the current position of the window
(WindowPosition) and the anti-trap protection activity (CrushGuardActivity) to the door
ECU via the LIN bus.
The transmission and reception relations between the ECUs and signals are defined
in the Network Explorer:
In order to be transmitted on the LIN bus, signals must be placed (mapped) on LIN
frames.
Frames, along with their characteristic properties such as the LIN ID and minimum
and maximum cycle times, are therefore defined, and the signals mapped to the data
fields of the respective frames.
The list below shows the messages to be defined, along with their LIN ID, the length
of the respective data fields and the signals that are to be transmitted on the frames:
Version 2.2
- 19 -
Basics
Cycle
time
min..max
[ms]
Publisher
LIN frame
LIN ID
Length
[byte]
Mapped
signals
WindowSlave
0x1D
30120
DriverDoorModule WindowMotion
WindowMaster
0x1E
1050
WindowLifter
CrushGuardActivity
WindowPosition
In addition to the application signals, each LIN slave sends a so-called Response
Error Signal, which it uses to indicate whether a protocol error was identified. Like
the other signals, this signal is defined and mapped to a frame sent by the slave.
In the Network Designer LIN, the definition of messages and message properties as
well as the mapping of signals to messages is carried out in the Network Explorer.
In the screenshot, the LIN frames are shown under Unconditional Frames in the
object hierarchy on the right. The list on the right shows the messages mapped to the
selected frame. The frame properties can be defined in the opened dialog.
The Layout tab of the message properties dialog provides a visual representation of
the data field layout of the frames. The position of individual signals can be modified
interactively here.
- 20 -
Version 2.2
Basics
The last step in designing the communication is to define the scheduled transmission
behavior of the LIN network. With LIN buses, this is done using Schedule Tables.
Designing scheduled
transmission
behavior
The sequence in which the individual frames are to be sent on the LIN bus and the
respective pause before the next scheduled frame are specified in a Schedule Table.
Defining Schedule
Tables
Several Schedule Tables - one per network operating mode - are usually defined in a
LIN network.
In Network Designer LIN, you can create Schedule Tables in the Schedule Editor
interactively, or you can use the Schedule Table wizard to create them automatically
using specified minimum and maximum intervals.
Exporting the communication descriptions from a LIN network to an LDF file enables
them to be used in a different tool.
The LDF format is the communication data exchange standard defined by the LIN
Consortium, and is supported by practically all LIN tools.
The export is based on a single network and contains descriptions of the network
properties and the connected network nodes. The LDF file also contains all of the
frames along with the signals mapped to them, their properties and the networks
Schedule Table.
This data then becomes the basis for subsequent steps in the development of a
networked ECU system, e.g., code generation, configuration of embedded software
components, testing of individual ECUs, network analyses, etc.
Version 2.2
- 21 -
Basics
Exporting the communication descriptions of a LIN 2.x slave node to an NCF file
enables them to be used in subsequent development steps e.g. creating an LDF file
based on several NCF files.
The NCF format is the communication data exchange format standard for LIN 2.x
slave nodes defined by the LIN Consortium, and is supported by practically all LIN
tools.
The export is based on a single slave node and contains the node's properties as well
as all of the frames published and subscribed by the node along with the signals
mapped to them.
Designing gateways
As illustrated above, Network Designer LIN supports not only the design of a single
network, but also creation of the hardware topology of a gateway to other networks,
e.g. to a CAN network.
Network Designer CAN is required for defining communication relations on the CAN
bus. The WindowMotion signal is received by the door ECU on the CAN bus and is
then routed to the LIN bus. The Network Designer CAN Network Explorer is used to
define this reception relation on the CAN bus as well as the CAN message on which
the signal is transmitted via the CAN bus.
The signals routed from the CAN bus to the LIN bus, and vice versa, are listed in the
Gateway Signals list.
>
The Network Explorer for the CAN network is in the upper window. The
communication relations and the CAN network messages are defined here.
>
The lower window shows the list of gateway signals. Here, you can see that the
CrushGuardActivity and WindowPosition signals are routed from the LIN to
the CAN network, and that the WindowMotion signal is routed from the CAN to
the LIN network.
The messages on which the signals are transmitted on the respective networks are
also shown here.
- 22 -
Version 2.2
Usage
4 Usage
In this chapter you find the following information:
4.1
page 24
4.2
page 24
4.3
page 25
4.4
page 26
4.5
Windows / editors
The Project Explorer
The Library Browser
The Network Explorer
Object List window
Gateway Routing window
Attribute Definition window
Consistency Check window
page 27
Version 2.2
- 23 -
Usage
4.1
Accessing Network
Designer
Once the program is installed, the Network Designer icon will appear on your
desktop.
You can now start the program via this icon or via the Windows Start menu.
Starting Network
Designer LIN
>
Double-click the
>
Ending Network
Designer LIN
4.2
>
>
Click on
Structure/
Areas
The main window is divided into several areas. The uppermost area contains a menu
and toolbars for accessing various program functions, as is usual in Windows
programs. The status bar at the lower edge displays short notes and status
messages.
Workspace,
Project Explorer,
Library Browser
Dockable windows
The Project Explorer, Library Browser und Output window are dockable windows.
Drag & drop the windows to any edge of the main window to dock them.
The windows can be positioned outside of the main window. To prevent the windows
from docking to the edge of the main window, press the <Ctrl> key while dragging
them.
- 24 -
Version 2.2
Usage
Network Designer
main window
The remaining surface of the main window is reserved for the various editors. The
following editors are available in Network Designer:
>
>
>
Gateway Routing window for visualization of the signals that are routed from one
network to another via a gateway.
>
>
>
Schedule Editors to display and create schedule tables in LIN networks and static
and dynamic schedules in FlexRay clusters.
Editors
You can open the individual editors via the main menu, the toolbar icons or the
object-specific shortcut menus.
4.3
You can perform various operations either in Network Designers main menu or via
object-specific shortcut menus. The shortcut menus are menus that contain a
number of operations that can be performed specifically with the selected object. The
shortcut menus can also contain special commands that are not available via the
main menu. To activate a shortcut menu, select an object in a tree or list view and
then press your right mouse key.
Main menu,
shortcut menus
Dialogs are used to modify object properties or to select options for an operation that
is to be performed. Some of the dialogs consist of several dialog tabs; you can switch
between these using the tabs at the upper edge of the dialog.
Dialogs
Version 2.2
- 25 -
Usage
Toolbars
Usage of drag & drop You can drag individual objects from one window to another using drag & drop.
Keyboard operations
4.4
You can call up many of the Network Designer operations with your mouse as well as
your keyboard.
Opening a Network
Designer workspace
2. Select the file name of the desired document from the file list, or enter the name
of the file into the File name field. The default file extension is NDW (Network
Designer Workspace).
3. Click the [Open] button.
Once the workspace is opened successfully, the Project Explorer and the Library
Browser are displayed along with any vehicle projects, signals, and signal types
contained in the workspace.
toolbar icon, via the
You can also open a Network Designer workspace via the
<Ctrl-O> keyboard shortcut or by using drag & drop to drag a NDW file onto the main
window. The file list in the File menu shows the most recently opened workspaces.
Saving a Network
Designer workspace
- 26 -
Version 2.2
4.5
Usage
Windows / editors
Window / Editor
Description
Library Browser
Overview of user-defined attributes. New userdefined attributes can be added and already existing
attributes edited.
Output window
Windows
Overview
Screenshot
Version 2.2
- 27 -
Usage
Description of the
Project Explorer
The vehicle projects of the currently loaded workspace are displayed in the Project
Explorer, as well as the respective electronic control units (ECUs), networks, and
network nodes for each vehicle project.
A network node that represents the link between an ECU and a network is displayed
once under its network and once under its ECU. So for network nodes no name can
be defined, the connected ECU/network is shown as the network node's name.
The shown network node (Network 1 = ECU 1)
is created with the connection between ECU 1 and network 1.
>
>
>
The Library Browser displays the global network independent objects of the
workspace.
Workspace page
The Workspace page displays all objects currently available in the local workspace.
These objects can be used to design the network architectures.
- 28 -
Version 2.2
Usage
Screenshot
>
a list of objects that are assigned to the selected object type or that are linked
with the object.
Overview
Screenshot
Version 2.2
- 29 -
Usage
Description of the
Network Explorer
Depending on the object or object type selected in the left window, the following is
displayed:
>
>
Various attributes may be defined for objects of different object types or for links
between different object types. In this case, the total number of attributes is displayed.
If there are no attributes for certain objects or links, a minus sign () is displayed.
If a concrete network node is selected in the object hierarchy, for example, the
reception and transmission signals are displayed in the object list as mapped or
unmapped signals. Since no position is defined within a frame for unmapped signals,
a minus sign () is displayed in this column.
The values are displayed in the list in different colors. The colors have the following
meanings:
>
Black
Value of a displayed object or link. The value can be modified.
>
>
Gray
The value cannot be modified.
The values of the user-defined attributes are also displayed on the right side of the
Network Explorer. If there is an asterisk '*' after the attribute value, then the attribute
still has the default value defined in the attribute definition.
Info:
> If a new default value is assigned to the user-defined attribute, all object attribute
values followed by an asterisk '*' are automatically assigned the new default value.
> The asterisk is removed as soon as an object's attribute value is edited,
irrespective of the assigned concrete value. If there is no asterisk, the attribute
value has been edited. An attribute value is also considered edited if it has been
assigned the concrete value that corresponds to the default value of the attribute.
> Use the Reset to Default function in the shortcut menu of the list or click on the
[Reset] button on the Attributes register of the respective object dialog to reset the
attribute value to the default. If the default value is entered as an attribute value, a
prompt is displayed whether the attribute should be reset to the default.
- 30 -
Version 2.2
Usage
Additional information about the object or object type selected in the hierarchical view
is displayed in the status bar at the bottom of the Network Explorer.
>
The Network Explorer can be opened from the shortcut menu of a network by
double-clicking on a network in the Project Explorer or from the toolbar icon
>
Press <F2> to launch the editing mode for individual object properties of the
selected cell.
>
The lists can be sorted by the entries of a specific column by clicking on the
column title.
>
Operations in the
Network Explorer
Tips & tricks
Overview
The information displayed corresponds to the information of the object list in the
Network Explorer.
The objects displayed can also be edited and new objects can be created in the list
window similar to the procedure in the Network Explorer.
If a list window is open, it is automatically updated when any modification is made to
the object type or object displayed.
Screenshot
Version 2.2
Overview
- 31 -
Usage
Screenshot
This window contains the list of user-defined attributes. New user-defined attributes
can be added and existing attributes can be edited here. Open the Attribute
Definitions window from the View menu of the main menu or the toolbar icon .
Screenshot
If 0 has been entered for the Minimum and Maximum values, no range check of the
attribute values of this attribute is performed. In this case, any value (of the selected
value type) can be entered for the default value.
The results of checking the objects and their relations to each other for consistency
are displayed in the Consistency Check window.
The symbol at the start of the line represents the object status.
The consistency check can be performed for all workspace objects, individual vehicle
projects or networks. Vehicle projects and networks are checked for consistency from
the object's shortcut menu.
Screenshot
- 32 -
Version 2.2
Usage
>
The object for which a result is displayed in the Consistency Check window can
be edited directly using the Edit function from the shortcut menu.
>
Detailed information about the status of the object is available in the Note and
Explanation columns of the table in the Consistency Check window or the
Object Status dialog.
>
The Configure Display... shortcut menu item opens the Settings dialog to
configure the list. This dialog is used to specify what information should be
displayed in the Consistency Check window.
>
>
Version 2.2
Usage
- 33 -
Concepts
5 Concepts
This chapter contains the following information:
5.1
page 36
5.2
User-defined attributes
page 38
5.3
Workspace
page 39
5.4
page 39
5.5
page 40
Version 2.2
- 35 -
Concepts
5.1
Overview
Network Designer LIN is based on an object model designed specifically for network
architecture design and data communication.
The figure below shows a user-oriented view of this object model:
The object types and object connections within the object model are described next.
The properties of the individual object types and object relations are explained in a
separate documentation that comes with the respective Network Designer LIN
version. You can open these documents with the Documentation Browser.
- 36 -
Version 2.2
Concepts
Vehicle project
An ECU realizes a specific behavior via its software. The ECU is always a part of a
vehicle project in Network Designer and is defined there locally.
ECU
Data (signals) is transmitted via a network. The data transmission takes place with
the help of frames. A network is always a part of a vehicle project in Network
Designer and is defined there locally.
Network
Global signal
Frame
Network Designer supports the following message types for the respective bus
systems:
>
>
LIN unconditional frames, LIN diagnostic frames, LIN event-triggered frames, and
LIN sporadic frames
>
FlexRay frames for transmission in the static and dynamic FlexRay schedule
segments.
Network signal
Version 2.2
Network node
- 37 -
Concepts
Published signal/
Subscribed signal
Published frame/
Subscribed frame
These relations determine which values are exchanged between individual ECUs on
a concrete LIN bus.
>
The published signal relation describes a signal that is sent from an ECU on a
LIN bus. This relation can be defined by the user by creating of a link between a
global signal and a network node.
>
A published frame represents the relation between the transmitting node and a
frame.
A subscribed frame represents the relation between the receiving node and a frame.
This relation is derived of a mapped signal to a node automatically and cant be
defined manually. A frame is subscribed by a node as soon as one of the signals
mapped on the frame is received by the node. A frame cannot be defined as an
subscribed frame in its entirety because it is important to define which of the signals
transmitted on the frame are actually needed by the ECU to perform its tasks.
Frame signal
In order for a value to be transmitted on a network in the form of a signal, the signal
must be placed in a frame, either on its own or in most cases together with other
signals. A signal that is placed on a frame is called a frame signal.
The most important property of such a frame signal is its position in the data field of
the frame. To prevent signal values from being misinterpreted, signals cannot be
placed on the same positions and cannot overlap one another.
5.2
User-defined attributes
Saving additional
information
Network Designer LIN is based on the object model described above, as well as on
the properties of the individual object types. However, it is often necessary to add
additional properties to the pre-defined properties, e.g. if in a vehicle project, you want
to specify when the vehicle series began, or which editor is responsible for a given
ECU. The Network Designer object model can be customized using user-defined
attributes. You can use these to save any amount of additional information for objects
and object relations.
Objects/
Object types
Vehicle,
>
Signal,
>
ECU
object types.
- 38 -
Version 2.2
Concepts
>
Attribute definitions
minimum,
>
maximum,
>
>
A specific attribute value can be defined for every object for whose object type a userdefined attribute exists. This can be done either in the objects properties dialog or in
an object list. If an explicit value is not assigned to the object, the attribute default
value is used as the value for that object. This is indicated by an asterisk * in the
user interface.
5.3
Default values
Workspace
What is a
workspace?
Folder structure
5.4
An important part of designing a LIN network is the definition of LIN Schedule Tables.
The Schedule Tables are used to specify in which order and at which intervals the
frames are transmitted on the network.
Version 2.2
LIN timing
LIN Schedule Tables
- 39 -
Concepts
5.5
Data format
Applications exchange LIN network communication data using the LDF or NCF
format. The LDF and NCF formats are standardized by the LIN Consortium and are
supported by all LIN development systems.
Network Designer LIN offers functions for importing and exporting data in the LDF
and NCF format.
Network-oriented
data exchange
> Since LDF is a network-oriented format and the communication data describe
exactly one network in one file, exports to and imports from LDF files are
performed on the basis of one individual network. When data for several networks
is exported, a separate LDF file is created for each network.
Node-oriented
exchange
> Network Designer LIN offers functions for importing and exporting data in the NCF
format. Since NCF is a node-oriented format, exports to and imports from NCF
files are performed on the basis of one individual slave node.
FIBEX exchange
format
Network Designer LIN offers functionality for importing and exporting data in the
FIBEX format. All FIBEX versions officially released by ASAM (1.1.5, 1.2.0, 2.0.0) are
supported."
- 40 -
Version 2.2
Tutorial
6 Tutorial
This chapter contains the following information:
6.1
Overview
page 42
6.2
page 42
6.3
page 43
6.4
page 48
6.5
page 51
6.6
page 55
6.7
Consistency Check
page 56
6.8
page 57
6.9
page 58
Version 2.2
- 41 -
Tutorial
6.1
Overview
Purpose
The purpose of this tutorial is to familiarize you with the user interface concept and
the most important of the Network Designer LIN functions.
At the beginning of each chapter are tasks that you can solve with the help of the
explanations that follow.
The sign on the left identifies the tasks.
6.2
>
In this tutorial youll first create a workspace and a vehicle project with its network
topology.
>
>
After that youll design the network communication of the LIN network. There you
define which ECU publishes the signal and you create the LIN frames and place
the signals on them.
>
To complete the network description you will then define the transmission
behavior of the frames and design the LIN schedule.
>
Finally this tutorial describes further steps for checking the network design and
exporting the communication data.
on your desktop.
- 42 -
Version 2.2
Tutorial
6.3
Task: Create a new vehicle project and a hardware topology with two LIN buses and
several ECUs, of which one ECU is a gateway between the two LIN buses.
Creating a vehicle project
A vehicle consists of a number of ECUs and one or more networks. Vehicles may
also be used to represent vehicle model series.
1. Right Click on Vehicle Projects in the Project Explorer.
Version 2.2
- 43 -
Tutorial
- 44 -
Version 2.2
Tutorial
Version 2.2
- 45 -
Tutorial
- 46 -
Version 2.2
Tutorial
Version 2.2
- 47 -
Tutorial
6.4
- 48 -
Version 2.2
Tutorial
Version 2.2
- 49 -
Tutorial
Value descriptions
page
- 50 -
Version 2.2
Tutorial
6.5
The communication relations of a network are defined in the Network Explorer of the
network. The Open Network Explorer function from the shortcut menu of a network
or double-clicking on a network in the Project Explorer opens the Network
Explorer.
Overview
Drag & drop the WindowPosition signal from the Library Browser, list of
global signals or the list of network signals to the Published Signals folder of
the DriverDoorModule node in the Network Explorer.
>
To add the WindowPosition signal, use the [Add] function on the Published
Signals page of the Property dialog of the DriverDoorModule node.
>
Copy the WindowPosition signal to the clipboard and execute the Insert Link
function from the shortcut menu of the Published Signals folder of the
DriverDoorModule node.
Info: After a signal has been defined as a published signal of a certain node it can
also be defined a subscribed signal of another node.
Version 2.2
- 51 -
Tutorial
Within the Network Explorer: Drag & drop the WindowPosition signal from the
Published Signals list of the DriverDoorModule node to the
DriverDoor_Window frame in the Published Frames list of the
DriverDoorModule.
>
To add the WindowPosition signal, use the [Add] function on the Signals
page of the Property dialog of the DriverDoor_Window frame.
>
Copy the WindowPosition signal to the clipboard and execute the Insert Link
function from the shortcut menu of the DriverDoor_Window frame.
- 52 -
Version 2.2
>
Tutorial
>
Graphical formatting of the Data field on the Layout page in the Properties
dialog of the DriverDoor_Window frame.
The byte order (Intel/Motorola) and the display format of the start position is
automatically taken into account in this dialog.
Use the [Arrange] function to automatically arrange the signals.
The following arrangement criteria are taken into account:
>
Signals with a length of 8 bit or less do not exceed any byte limit; signals with
a length of 16 bit do not exceed any Word (2-byte) limit.
>
>
>
Arrangement criteria
The mapping rules are selected in such a way to ensure the most efficient access
of the embedded software to the signals.
Graphical signal
layout
Version 2.2
- 53 -
Tutorial
Open the Network Explorer, then drag & drop the DoorLockStatus signal from
the Library Browser, list of global signals or the list of network signals to the
Subscribed Signals folder of the DoorLock node.
>
To add the DoorLockStatus signal, use the [Add] function on the Subscribed
Signals page of the Property dialog of the DoorLock node.
>
Copy the DoorLockStatus signal to the clipboard and execute the Insert Link
function from the shortcut menu of the Subscribed Signals folder of the
DoorLock node.
Info: Before a signal can be defined as a subscribed signal of a certain node it has to
be defined as a published signal of another node.
- 54 -
Version 2.2
Tutorial
6.6
Task: Based on the created vehicle project and the designed network communication
of the DriverDoor_LIN network you will design the LIN schedule.
Set up a table with the NEW Table command:
8. Click in the Delay column of the DriverDoor_Window slot and change the value
to 10.
Version 2.2
- 55 -
Tutorial
1. Select the New Table using Wizard command in the shortcut menu of the
empty Schedule Tables section of the window.
The Schedule Table Wizard opens.
2. Select the Master Req diagnostic frame and press the [>>] button to add it to the
Selected frames list.
3. Select the SlaveResp diagnostic frame and press the [>>] button to add it to the
Selected frames list.
4. Click in the Req. Min. cell of the frames and change the Req. Min. time for both
frames to 10.
5. Change the Req. Max. time for both frames to 30.
6.7
Consistency Check
Task: Perform a consistency check for a network.
In order to determine whether the objects of a vehicle project and their relations are
mutually consistent, a consistency check can be performed with the Network
Designer.
1. Select the network on which to perform the consistency check.
- 56 -
Version 2.2
Tutorial
2. Select the Consistency Check command from the network's shortcut menu.
The result of the consistency check is displayed in a Consistency Check
window.
Task: Perform a consistency check for a vehicle project.
In order to determine whether the objects of a network and their relations are mutually
consistent, a consistency check can be performed with the Network Designer.
1. Select the vehicle project on which to perform the consistency check.
2. Select the Consistency Check command from the network's shortcut menu.
The result of the consistency check is displayed in a Consistency Check
window.
Info: The consistency check for a vehicle project only extends to the networks of the
vehicle project, whose type is supported by the Network Designer variants.
6.8
Task: Export the communication data of the current workspace to an LDF file.
1. Select the network that you want to export into an LDF file.
2. From the network's shortcut menu, select Export to|LIN Descrition File
3. Select the storage location and enter the file name.
4. Click [OK] to automatically export the network into a LIN Description file (*.ldf).
Export to LIN
Description File
dialog
Version 2.2
- 57 -
Tutorial
Info: You can also export all networks of a vehicle project in a single operation.
Select the vehicle project that contains the network you want to export and execute
the Export to|LIN Description Files shortcut menu item.
6.9
1. In the network explorer select the slave node that you want to export into an NCF
file.
2. From the nodes shortcut menu, select Export to|NCF File.
3. Select the storage location and enter the file name.
4. Via appearing dialog select desired option(s) for export.
5. Click [OK] to automatically export the node into a Node Capability File (*.ncf).
- 58 -
Version 2.2
Appendix A: Glossary
7 Appendix A: Glossary
7.1
Network Designer
Term
Description
attribute definition
communication
relations
data field or payload The area of a message on which signals are transmitted.
default value of a
user-defined
attribute
dockable window
ECU
electronic control
unit
gateway
gateway routing
gateway signal
global object
global signal
See "Signal"
hardware topology
Library Browser
local object
Version 2.2
- 59 -
Appendix A: Glossary
- 60 -
Term
Description
mapped Rx signal
mapped signal
mapped Tx signal
message or frame
network
Network Explorer
network node
network signal
object
object name or
symbolic identifier
object type
output window
PDU
Project Explorer
relation between
objects
Version 2.2
Appendix A: Glossary
Term
Description
Rx message or Rx
frame
Rx signal
schedule
signal
signal group
signal placement or
signal mapping
signal type
A signal type defines the properties, e.g. length and data type,
of one or more signals. Signals can reference the same signal
type, if they have identical properties.
source message
source network
Tx message or Tx
frame
Tx signal
user-defined
attribute
vehicle project
workspace
Version 2.2
- 61 -
Appendix A: Glossary
7.2
7.3
7.4
- 62 -
Description
CAN bus
CAN message
CAN network
Description
LIN frame
Unit that connects an ECU with a LIN bus. In this LIN bus the
ECU takes over the function of the master node.
LIN network
Unit that connects an ECU with a LIN bus. In this LIN bus the
ECU takes over the function of the slave node.
Description
FlexRay channel
FlexRay cluster
FlexRay frame
Version 2.2
A file name extension consists of three characters preceded by a period (full stop).
These are placed directly after the file name itself. The file name extension indicates
the file type.
File Extension
File Type
CHM
Help file
DBC
DLL
EXE
Executable program
FIBEX (XML)
INI
LDF
NDW
XML
Version 2.2
- 63 -
- 64 -
Key(s)
Description
<Ctrl>+<O>
Opens a workspace.
<Ctrl>+<N>
<Ctrl>+<S>
<Ctrl>+<C>
<Ctrl>+<V>
<Ctrl>+<A>
<Return>
<Esc>
<Del>
<Ins>
<Tab>
<Shift>+<Tab>
<Ctrl>+<Tab>
<Alt>+<Spacebar>
<F1>
<F2>
<Ctrl>+<F4>
<Alt>+<F4>
<F5>
<Ctrl>+<F5>
Version 2.2
Key(s)
Description
<Ctrl>+<F6>
<F10>
<Cursor up>
<Cursor down>
<Cursor left>
<Cursor right>
<Shift>+<Cursor up>
<Shift>+<Cursor down>
<Ctrl>+<Cursor up> +
<Ctrl>+<Space>
<Ctrl>+<Cursor down> +
<Ctrl>+<Space>
<Page up>
<Page down>
<Pos 1>
<End>
Version 2.2
- 65 -
NetworkDesigner.ini
- 66 -
Version 2.2
Appendix A: Addresses
11 Appendix A: Addresses
Vector Informatik GmbH
Vector Informatik
GmbH
Ingersheimer Str. 24
D-70499 Stuttgart
Phone: +49 (711) 80670-0
Fax: +49 (711) 80670-111
mailto:[email protected]
http://www.vector.com
Vector GB Ltd.
Rhodium
Central Boulevard
Blythe Valley Park
Solihull, Birmingham
West Midlands B90 8AS
United Kingdom
mailto:[email protected]
http://www.vector.com
Version 2.2
- 67 -
Appendix A: Addresses
VecScan AB
VecScan AB
Theres Svenssons Gata 9
SE-417 55 Gteborg
Phone: +46 (31) 76476-00
Fax: +46 (31) 76476-19
mailto:[email protected]
http://www.vector.com
- 68 -
Version 2.2
www.vector.com