CANdb++
Manual
Version 3.1
English
Imprint
Vector Informatik GmbH
Ingersheimer Straße 24
D-70499 Stuttgart
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 2019, Vector Informatik GmbH. Printed in Germany.
All rights reserved.
CANdb++ Manual
Table of Contents
1 Introduction
1.1 Concept
1.2 About This User Manual
1.2.1 Conventions
1.2.2 Certification
1.2.3 Warranty
1.2.4 Support
1.2.5 Trademarks
2 Basics
2.1 Overview of CANdb++
2.2 Datamodel of CANdb++
2.3 Installation
2.4 Main Window
3 Tutorial
3.1 Tutorial Overview
3.2 Start the Program
3.3 Creating a New CAN Database
3.3.1 Copying Existing Objects
3.3.2 Creating New Objects
3.3.3 Modifying Existing Objects
3.4 Linking Objects
3.5 Display Communication Matrix
3.6 Value Tables
3.7 Assign Value Tables
3.8 Create User-Defined Attributes
3.9 Modify Values of User-Defined Attributes
3.10 Perform Consistency Check
4 API
4.1 INI Files
4.1.1 CANdb.ini
5 Glossary
6 Index
Table of Contents
4
4
5
5
6
6
6
7
8
8
9
9
10
11
11
11
12
14
15
16
18
20
21
22
23
24
26
27
27
27
29
31
© Vector Informatik GmbH
3.1
- 3 -
CANdb++ Manual
1 Introduction
1.1 Concept
1 Introduction
All communication-relevant data that are processed in a networked CAN bus system as well as their
interrelationships are usually administered in a central communications database.
CANdb++ is a data administration program with which these communication data-bases can be created and
modified in the form of CAN databases.
© Vector Informatik GmbH
3.1
- 4 -
CANdb++ Manual
1 Introduction
1.2 About This User Manual
1.2.1 Conventions
In the two tables below you will find the notation and icon conventions used throughout the manual.
Style
bold
Microsoft
Source Code
Hyperlink
+
Symbol
Utilization
Fields/blocks, user/surface interface elements, window- and dialog names of the
software, special emphasis of terms
[OK] Buttons in brackets
File|Save Notation for menus and menu commands
Legally protected proper names
File and directory names, source code, class and object names, object attributes and
values
Hyperlinks and references
Notation for key combinations
Utilization
Dangers that could lead to damage
Notes and tips that facilitate your work
More detailed information
Examples
Step-by-step instructions
Text areas where changes of the currently described file are allowed or necessary
© Vector Informatik GmbH
3.1
- 5 -
CANdb++ Manual
1 Introduction
Symbol
Utilization
Files you must not change
Multimedia files e.g. video clips
Introduction into a specific topic
Text areas containing basic knowledge
Text areas containing expert knowledge
Something has changed
1.2.2 Certification
Vector Informatik GmbH has ISO 9001:2008 certification. The ISO standard is a globally recognized standard.
1.2.3 Warranty
We reserve the right to modify the contents of the documentation or the software without notice. Vector disclaims
all liabilities for the completeness or correctness of the contents and for damages which may result from the use
of this documentation.
1.2.4 Support
You can get through to our hotline at the phone number
+49 (711) 80670-200
or you send a problem report to the Vector Informatik GmbH Support.
© Vector Informatik GmbH
3.1
- 6 -
CANdb++ Manual
1 Introduction
1.2.5 Trademarks
All brand names in this documentation are either registered or non registered trademarks of their respective
owners.
© Vector Informatik GmbH
3.1
- 7 -
CANdb++ Manual
2 Basics
2.1 Overview of CANdb++
Program Versions
CANdb++ is available in the following program versions:
CANdb++
CANdb++ Admin
Functional Features
Function
Creating and modifying CANdb++ databases (*.mdc)
Creating and modifying CANdb network files (*.dbc)
Creating and modifying user-defined attributes
Creating and modifying value tables
Showing the communication matrix
Consistency check of a CAN database
Creating and modifying objects of the "Vehicles" object type
Comparing objects
Comparing CAN databases
Export of differences in text files (*.csv)
Import objects and CAN databases
Export objects and CAN databases
Import of attribute definitions
Timing analysis (estimation of bus load)
Integration in the Tool Chain
2 Basics
CANdb++
CANdb++ Admin
—
•
•
•
•
•
—
•
—
—
•
•
—
•
•
•
•
•
•
•
•
•
•
•
•
•
CANdb++ is a central tool in the Vector CAN tools toolbox, and it can be started directly from Vector CAN tools
such as CANalyzer, CANoe, CANape and CANscope. This provides the Vector CAN tools with direct access to
communication-relevant data via CANdb++.
Communication-relevant data are defined, modified and managed entirely within CANdb++; the Vector CAN
tools only read-access these data. The communication-relevant data must exist in the form of CANdb network
files (*.dbc) so that the Vector CAN tools can access them.
To also permit the use of data from CANdb++ databases (*.mdc) CANdb++ provides a data export option.
CANdb++ databases can be exported to one or more CANdb network files (*.dbc). In this way the user can either
export the data of an entire CANdb++ database or only those relevant to a Vehicle, Network or ECU.
© Vector Informatik GmbH
3.1
- 8 -