Startup_GM_SLP2s

User Manual
Startup with GM SLP2
A Step by Step Introduction
Version 3.0.0 for MICROSAR 4 Release 12
English

---

User Manual Startup with GM SLP2
Content
1 About This Manual
10
1.1 History Information
10
1.2 Finding Information Quickly
10
1.3 Conventions
10
1.4 Certification
11
1.5 Warranty
11
1.6 Support
12
1.7 Registered Trademarks
12
1.8 Errata Sheet of Hardware Manufacturers
13
1.9 Example Code
13
2 Introduction
14
2.1 What Do You Learn from This Manual
14
2.2 An Overall View
14
2.3 MICROSAR - Vector's AUTOSAR Solution
15
2.4 AUTOSAR Layer Model GM SLP2
16
2.5 Configuration Workflow GM SLP2
17
I STEPbySTEP
18
1 STEP1 Setup Your Project
19
1.1 Situation after Installation Guide
19
1.2 Setup Project via DaVinci Configurator Pro
19
1.3 Result Project Folder - result of the project set-up
21
1.4 Start Menu - Result of the Project Set-up
23
1.5 DaVinci Configurator Pro Project
23
2 STEP2 Define Project Settings
24
2.1 Add Input Files
24
2.1.1 Add System Description Files
25
2.1.2 Add Diagnostic Data Files
27
2.1.3 Add Standard Configuration Files
28
2.1.4 Update Configuration
28
2.2 Define Custom Workflow Steps and External Generation Steps
30
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 2-

---

User Manual Startup with GM SLP2
2.2.1 Custom Workflow Steps
30
2.2.2 External Generation Steps
31
2.3 Activate Your BSW Modules
32
2.4 Add ECUC File References
33
3 STEP3 Validation
34
3.1 Start Solve All Mechanism
34
3.2 Live Validation - Solving Actions
34
4 STEP4 Start BSW Configuration
36
4.1 Start Configuration with Configuration Editors
36
4.2 Base Services
36
4.3 Communication
37
4.4 Diagnostics
38
4.5 I/O
40
4.6 Memory
40
4.7 Mode Management Editors
41
4.8 Network Management
46
4.9 Runtime System
47
4.9.4 Create Tasks
49
4.10 Go on with Basic Editor
49
4.11 Start Solving Actions
49
4.12 Start On-demand Validation
49
4.13 BSW Configuration finished
51
5 STEP5 Design Software Components
52
5.1 Switch to DaVinci Developer
52
5.2 Design Software Components
52
6 STEP6 Mappings
53
6.1 Perform Data Mapping within DaVinci Developer or DaVinci Configurator?
53
6.2 Data Mapping within the DaVinci Developer
53
6.2.3 DaVinci Developer - Save and close
56
6.3 Switch (back) to DaVinci Configurator
56
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 3-

---

User Manual Startup with GM SLP2
6.4 Synchronize System Description
56
6.5 Add Component Connection
56
6.6 Service Mapping
57
6.7 Add Data Mapping
58
6.8 Add Memory Mapping
60
6.9 Add Task Mapping
60
7 STEP7 Code Generation
62
7.1 Start Custom Workflow Steps
62
7.2 Start Code Generation
62
7.3 Generation Process finished!
64
8 STEP8 Add Runnable Code
65
8.1 Component Template
65
8.2 Implement Code
66
9 STEP9 Compile and Link Your Project
67
9.1 Finish your project with compiling and linking
67
9.2 Congratulations, that’s it!
67
II Concept
68
1 General Overview
69
1.1 Software Component
71
1.1.1 Atomic components
71
1.1.2 Compositions
71
1.2 Runnables
71
1.3 Ports
72
1.3.1 Application Port Interfaces
72
1.3.2 Service Port Interfaces
72
1.4 Data Element Types
72
1.5 Connections
73
1.6 RTE
73
1.7 BSW – Basic Software Modules
73
1.8 Software, Tools and Files
73
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 4-

---

User Manual Startup with GM SLP2
1.9 Structure of the SIP Folder
75
2 Set-Up New Project
78
2.1 DaVinci Configurator
78
3 Define Project Settings
83
3.1 Input files
83
3.1.1 System Description Files
83
3.1.5 Diagnostic Data Files
84
3.1.8 Standard Configuration Files
84
3.2 Custom Workflow Steps / External Generation Steps
84
3.3 Activate BSW
85
4 Validation
86
4.1 Validation Concept
86
5 BSW Configuration with Configuration Editors
87
5.1 DaVinci Configurator Pro Editors
87
6 Software Component (SWC) Design
88
6.1 Data Exchange between DaVinci Developer and DaVinci Configurator Pro
88
6.2 About Application Components, Ports, Connections, Runnables and More…
88
6.3 Application Components
89
6.4 Ports, Port Init Values and Data Elements
98
6.5 Configure Service Ports within your Application Components
103
6.6 Define your Runnables
104
6.7 Triggers for the Runnables
105
6.8 Port Access of the Runnables
107
7 Mappings
109
7.1 Data Mapping
109
7.2 Task Mapping
110
7.2.1 Information about Interaction between Runnable, Re-entrance and Task Mapping
111
7.3 Memory Mapping
113
7.4 Service Mapping
114
8 Generation
116
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 5-

---

User Manual Startup with GM SLP2
8.1 MICROSAR Rte Gen
116
9 Runnable Code
117
10 Compile and Link
119
10.0.1 Using your "real" hardware
119
III Additional Information
120
1 Update Input Files
121
1.1 System Description Files
121
1.2 Diagnostic Data Files
121
2 Update Project Settings
122
3 Support Request via DaVinci Configurator Pro
123
3.1 Result
123
4 Multiple User Concept
125
4.1 General
125
4.2 Split Files for Software Component and ECU Project Configuration
126
4.3 Configure Software Component Prototype
128
4.4 Configure ECU project
128
4.5 Split Files in DaVinci Developer
129
4.6 Split Files for BSW Configuration
129
5 Configuration Update
131
5.1 Release x-1 to Release x (necessary steps for any update)
131
5.2 Release 8 to Release 9
133
5.3 Release 7 to Release 8
133
6 Update DaVinci Tools
135
6.1 DaVinci Configurator Pro
135
6.2 DaVinci Developer
135
7 Non-Volatile Memory Block
136
7.1 Configure and use Non-Volatile Memory Block
136
7.2 Port Access of your Runnables
139
7.3 Memory Mapping in DaVinci Configurator Pro
139
7.4 Validate the RTE
141
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 6-

---

User Manual Startup with GM SLP2
8 CANoe osCAN Library
142
8.1 Emulate your project with CANoe
142
9 Basic Software Modules
144
9.1 Generic BSW Modules
144
9.2 What is a BSW Module?
144
9.3 What Forms a BSW Module?
145
9.4 BSW Module Configuration
145
9.5 BSW Initialization
146
9.5.1 <Msn>_InitMemory()
146
9.5.2 <Msn>_Init()
146
9.6 BSW Module Version (xxx_GetVersionInfo)
146
9.7 Cyclic Calls
147
9.7.1 <Msn>_MainFunction()
147
9.8 Service Functions
147
9.8.1 Client Server Theory
147
9.9 Critical Sections - Exclusive Areas
148
9.9.1 Memory Section
149
9.9.2 Switch <MSN> Modules Off
149
10 Command Line Parameters of the DaVinci Configurator
150
10.1 Common parameters
150
10.2 Command Line Interface Use Cases
150
10.3 Usecase With GUI (only DaVinciCFG.exe)
150
10.4 Use Case DaVinci Configurator CodeGenerator
151
10.5 Use Case DaVinci Configurator Execute Converter
153
10.6 Use Case BaseEcucGenerator (create initial empty project, without GUI)
154
10.7 Use Case EcucUpdater (without GUI)
155
10.8 Use Case DaVinci Configurator Exporter (without GUI)
156
10.9 Use Case DaVinci Configurator Sign Script
157
10.10 Return Codes
158
11 Variant Handling
159
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 7-

---

User Manual Startup with GM SLP2
11.1 Define Criterion and Variants
159
11.2 Add and Assign Input Files to Variants
161
11.3 Define Variance for BSW Modules
162
11.4 Configure and Validate BSW
163
12 Add Module Stubs from AUTOSAR definition
165
13 TCP/IP stack migration of projects based on MICROSAR R11 and earlier (due to
FEAT-261)
167
13.1 SD – Service Discovery
167
13.2 TCPIP - Transmission Control Protocol / Internet Protocol
167
13.3 SOAD - Socket Adapter
168
14 SIP Update
169
15 Platform Types
170
15.1 Location of the common definition
170
15.2 Import/Export behavior
170
15.3 Service components use the new Platform Types
171
15.3.1 Old types
171
15.3.2 New types
171
15.4 Replacement of old developer standard types (Replace legacy Data Types)
172
16 Frequently Asked Questions
174
16.1 Annotations for any parameter
174
16.2 Find Reference Container
176
16.2.1 How to find references using the [Find] dialog
176
17 Release Notes
177
17.1 Release 12
177
17.2 Release 11.1
181
17.3 Release 8
184
17.4 Release 7.1
200
17.5 Release 7
201
17.6 Release 6
208
IV What’s New, What’s Changed
212
V Glossary
214
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 8-

---

User Manual Startup with GM SLP2
VI Index
226
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 9-

---

1 About This Manual
User Manual Startup with GM SLP2
1 About This Manual
1.1 History Information
Cross Reference
For detailed information about whats new, whats changes in current version, refer to sec-
tion Whats New, Whats Changed? on page 212.
1.2 Finding Information Quickly
The user manual provides the following access help:
> 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 to find information quickly,
> Also at the end of the user manual you will find a glossary to look up an explanation of the used
technical terms
1.3 Conventions
In the following two charts you will find the conventions used in the user manual regarding utilized
spellings and symbols.
Style Util-
Style Utilization
ization
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 entries
MICROSAR
Legally protected proper names and side notes.
Source Code
File name and source code.
Hyperlink
Hyperlinks and references.
<CTRL>+<S>
Notation for shortcuts.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 10-

---

1 About This Manual
User Manual Startup with GM SLP2
Symbol Utilization
Symbol Utilization
Here you can obtain supplemental information.
This symbol calls your attention to warnings.
Here you can find additional information.
Here is an example that has been prepared for you.
Instructions on editing files are found at these points.
This symbol warns you not to edit the specified file.
1.4 Certification
Vector Informatik GmbH has ISO 9001:2008 certification. The ISO standard is a globally recognized
standard.
1.5 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 documentation. 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.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 11-

---

1 About This Manual
User Manual Startup with GM SLP2
1.6 Support
Germany
And all other countries, not listed here.
+ 49 711 80670 3900
support@de.vector.com
BR
CN
Brazil, Argentina, Bolivia, Chile, Ecuador, Colombia,
China
Paraguay, Peru, Uruguay, Venezuela
+55 11 5180 2350
+86 21 6432 5353
support@br.vector.com
support@cn.vector.com
FR
IN
France
India
+33 1 42 31 40 10
+91 20 6673 6673
support@fr.vector.com
support@in.vector.com
IT
JP
Italia
Japan
+39 2 678171 10
TOKYO +81 3 5769 6972
support@de.vector.com
NAGOYA +81 52 238 5014
support@jp.vector.com
KR
Scandinavia
South Korea
Sweden, Denmark, Finland, Iceland, Norway
+82 2 807 0600
+46 31 764 76 00
support@kr.vector.com
support@se.vector.com
UK
North America
United Kingdom & Ireland
USA, Canada, Mexico
+44 121 7887 902
+1 248 449 9290, Option 2
support@uk.vector.com
support@vectorcantech.zendesk.com
1.7 Registered Trademarks
All trademarks mentioned in this documentation 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 fails, this should not mean, that this name is free of third party rights.
Outlook, Windows, Windows XP, Windows 2000, Windows NT, Visual Studio are trademarks of the
Microsoft Corporation.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 12-

---

1 About This Manual
User Manual Startup with GM SLP2
1.8 Errata Sheet of Hardware Manufacturers
Caution! Vector only delivers software!
Your hardware manufacturer will provide you with the necessary errata sheets concerning
your used hardware. In case of errata dealing with CAN, please provide us with the rel-
evant erratas and we will examine whether this hardware problem is already known to us
or whether to get a possible workaround.
Note
Because of many NDAs with different hardware manufacturers or because we are not
informed about them, we are not able to provide you with information concerning hard-
ware errata of the hardware manufacturers.
1.9 Example Code
Caution!
All application code in any of the Vector User Manuals is for training purposes only. They
are slightly tested and designed only to understand the basic idea of using a certain com-
ponent or set of components. Vector gives consent that you use it as a basis for devel-
oping your own code and modify it (Vector waives its copyright to forbid you the use),
however, with regard to the fact that the code is designed for training purposes only and
not for the use by you, usability of the code is not warranted and Vector’s liability shall be
expressly excluded in cases of normal negligence, to the extent admissible by law or stat-
ute. Of course you have to test the software developed on the basis of the code with dili-
gent care before using the software.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 13-

---

2 Introduction
User Manual Startup with GM SLP2
2 Introduction
2.1 What Do You Learn from This Manual
Use this document to
> Set up your project in just a few steps
> Learn how to use the Vector tools
> Learn how to work with the AUTOSAR means like software components, runnables, etc.
> Work with the Vector AUTOSAR Solution on a basic level
> Get a feeling of what you have to do when you start working for your actual project
The document is split in two parts, a STEPbySTEP description and an Expert Knowledge section.
> STEPbySTEP
This section gives you a short overview how to set up your project in just a few steps. Use the step
by step description to start up with basic information and get your project basically running.
> Expert Knowledge
This section gives you a detailed information about working with Vector AUTOSAR Solution. It con-
tains expert knowledge based on STEPbySTEP description sections and information about tool use
and general AUTOSAR concepts.
2.2 An Overall View
What we are talking about is an ECU, a module to be built-in a vehicle . The ECUs have to com-
municate with other ECUs and therefore almost every ECU participates in a bus system like e.g. CAN,
FlexRay, LIN, MOST or IP. Any ECU within one bus system has to provide an identical interface to this
bus system, because all ECUs have to share information via this bus system.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 14-

---

2 Introduction
User Manual Startup with GM SLP2
The illustration below shows an example of a CAN network that connects the ECUs of a vehicle.
All ECUs are built-up in a very similar way. There is a software part to perform the main job (applic-
ation) of the ECU, e.g. to control the engine or a door. The other part handles the network com-
munication and diagnostics.
2.3 MICROSAR - Vector's AUTOSAR Solution
The Vector MICROSAR Solution provides efficient and scalable basic software modules and an RTE for
AUTOSAR ECUs.
The individual AUTOSAR basic software modules are grouped into MICROSAR products that of related
functions. The configuration of the MICROSAR basic software with DaVinci Configurator Pro is simple,
user-friendly, and consistent. The included command-line-based generators create optimized code for
your ECU based on the configuration.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 15-

---

2 Introduction
User Manual Startup with GM SLP2
Cross Reference
To get more information about the MICROSAR concept refer to General Overview on page
69.
2.4 AUTOSAR Layer Model GM SLP2
The following figure shows the AUTOSAR Layer model for GM SLP2.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 16-

---

2 Introduction
User Manual Startup with GM SLP2
2.5 Configuration Workflow GM SLP2
The following figure shows the configuration workflow for GM SLP2.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 17-

---

I STEPbySTEP
User Manual Startup with GM SLP2
I STEPbySTEP
This section gives you a short overview about setup your project in just a few steps. Use it to startup
with basic information and get your project basically run.
> STEP1 Setup Your Project
> STEP2 Define Project Settings
> STEP3 Validation
> STEP4 Start BSW Configuration
> STEP5 Design Software Components
> STEP6 Mappings
> STEP7 Code Generation
> STEP8 Add Runnable Code
> STEP9 Compile and Link Your Project
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 18-

---

1 STEP1 Setup Your Project
User Manual Startup with GM SLP2
1 STEP1 Setup Your Project
This section includes all information for setting up a new project. It starts with the situation after
installation and provides all information about relevant tools.
Expert Knowledge
You need to know more? See section New Project on page 78.
1.1 Situation after Installation Guide
> Before you start your first steps with GM SLP2 Solution check whether you have installed all neces-
sary tools and software.
> Have you read the Installation Guide?
> Have you received and installed all the necessary tools mentioned there?
> Have you installed the MICROSAR SIP?
NO? Then please read the installation guide carefully and follow the installation guidelines given there.
Cross Reference
You will find the installation guide document at the Vector Knowledge Base:
https://vector.com/kbp/entry/640/
YES? You are ready to continue and to start with your first steps with the GM SLP2 Solution.
1.2 Setup Project via DaVinci Configurator Pro
Start the DaVinci Configurator Pro to set up your project.
Cross Reference
You use vVIRTUALtarget? Then refer to the UserManual_vVIRTUALtarget_DualTar-
get.pdf located at the \Doc\UserManuals.
Note
The DaVinci Configurator is located in your SIP Folder:
<SIPFolder>\DaVinciConfigurator\Core\DaVinciCFG.exe
1. Open File|New.
A set of four configuration windows will open; General Settings, Target, Project Folder Struc-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 19-

---

1 STEP1 Setup Your Project
User Manual Startup with GM SLP2
ture, and Tools
2. Enter the necessary Information for each window and click [Next>] to get to the next window.
Note for No-Communication Projects
For projects without communication modules like e.g. DEM only, just confirm the following
windows Target and Tools as the information is not relevant.
Especially the Target window will show pull-down menus where (undefined) is preset
and nothing else can be selected. This is not relevant for your use case and can be con-
firmed with [Next].
1.2.1 General Settings
The following settings are required for project setup.
> SIP root path
The SIP root path will be defined automatically based on the DaVinci Configurator Pro location and
cannot be changed by the user! The DaVinci Configurator Pro is always located within the SIP.
> Project Name
The name of your project (e.g. MyECU). It will be used as name of the generated ECUC files and
for the DaVinci Developer workspace.
> Project Folder
This is the root path of your project. Select an existing or define a new one.
> Create entries in the start menu
The checkbox Create entries in the start menu is set as default. This is a comfortable feature
that enables you to open your tools and project folder directly from the Windows start menu.
1.2.2 Target
Check Target Type, Derivative, Compiler and Pin layout (automatically set, based on SIP inform-
ation).
1.2.3 Project Folder Structure
Define your output paths here. You can use the given defaults or change paths to fit your project’s
needs.
Note
Default paths are based on the location of the defined project folder.
ECUC File Granularity
Additionally, you can specify whether the ECUC should be saved as one file (Single file) or is split into
several files (One file per module).
Note
Split to several files is necessary for multi user concept. Refer to Multiple User Concept.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 20-

---

1 STEP1 Setup Your Project
User Manual Startup with GM SLP2
1.2.4 Tools
> DaVinci Developer Workspace
If you have a RTE and you use the DaVinci Developer select the checkbox Create DaVinci
Developer Workspace and define the path to the DaVinci Developer executableand the path to
the workspace.
> Automatic update of DaVinci Developer workspace
Options used for updating the DaVinci Developer workspace during the project update process.
Details see DaVinci Developer help.
3. Click the button [Finish] to create your project.
1.3 Result Project Folder - result of the project set-up
The DaVinci Configurator Pro automatically creates and stores all relevant files to the project folder.
The content of the folder is described below briefly.
1.3.1 Appl folder
The Appl folder contains further folders GenData, GenDataVtt and Source. In GenData the con-
figuration tools generated their output files, if vVIRTUALtarget is used, the generated output will be
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 21-

---

1 STEP1 Setup Your Project
User Manual Startup with GM SLP2
stored in GenDataVtt. The Source folder is meant to carry your source code files.
1.3.2 Config folder
The Config folder contains the following folders:
> ApplicationComponents
This is a folder to put in additional SWC-Ts (Software Component Types). The DaVinci Configurator
Pro reads in all *.arxml files of this folder.
> AUTOSAR
The definition file of DataTypes (PlatformTypes_AR4.arxml) is stored centrally here.
> Developer
All relevant project data for DaVinci Developer is located in this folder.
> ECUC
This folder contains the created ECUC files. Before you add your input file(s), these files are only
placeholders without content.
File Name
Description
<ProjectName>.ecuc.arxml
ECU Configuration Description
<Pro-
Initial ECU Configuration Description for internal tool use
jectName>.ecuc.Initial.arxml
only.
> InternalBehavior
This folder contains the bswmd files for all activated modules in the DaVinci Configurator.
> McData
Folder is used for storing measurement and calibration data.
> ServiceComponents
The DaVinci Configurator stores all generated Service Component Prototypes to this folder.
Note
After you have added your Input file(s) and updated the configuration in the DaVinci
Configurator, the System folder will be added to the Config folder.
> System
The input file(s) and an additional created input file extract for communication use are stored to
this folder.
Do not edit manually!
These files must not be modified manually!
1.3.3 <ProjectName>.dpa
Project File
, that includes all relevant project data. Additionally the context
menu of this file is the control center to open your tools with already loaded projects.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 22-

---

1 STEP1 Setup Your Project
User Manual Startup with GM SLP2
1.3.4 Log Folder
Folder for the generated log files.
1.4 Start Menu - Result of the Project Set-up
The DaVinci Configurator Pro creates a link to start the tools with already loaded configuration. You
will find this link in Start | Programs | Vector AUTOSAR Projects | <ProjectName> if Create
entries in the startmenu was selected while project setup.
Info
You can also use the *.dpa file to start your project with already loaded configuration.
Therefore right-click on your *.dpa file and select Configure BSW to open the DaVinci
Configurator Pro with already loaded configuration or Configure SWCs to open the
DaVinci Developer for Software Design and Data Mapping.
1.5 DaVinci Configurator Pro Project
After finishing project set-up, a new empty project is loaded within the DaVinci Configurator Pro.
Note
Editors to configure modules will be available after input file import (see Add Input Files
on page 24) or after module activation (see Activate Your BSW Modules on page 32).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 23-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
2 STEP2 Define Project Settings
Before you start with the configuration it is necessary to define some project-specific data.
The definition of project-specific data comprises the definition of all necessary input file(s) for com-
munication and diagnostic purpose. Additional custom workflow steps, external generation steps
and the activation of the necessary Basic Software Modules has to be done in the DaVinci
Configurator Pro Project Settings view before.
Expert Knowledge
You need to know more? See section Project Settings on page 83.
Cross Reference
If you would use variant handling within your project, you have to define your variants
before adding input files. For detailed information about defining project settings for vari-
ant handling refer to Variant Handling on page 159.
2.1 Add Input Files
Open Input Files editor via Project | Input Files or use the input file button
of DaVinci
Configurator Pro toolbar.
Note
Any change of the input files requires an update of the configuration. Add all relevant files
before starting the update process.
If you save your project, and input files are modified, the DaVinci Configurator notice the
pending state and shows a window which enables starting update configuration directly via
[Save and update].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 24-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
2.1.1 Add System Description Files
Add your System Description File first. Therefore open the System Description Files view
. First you have to decide if you add AUTOSAR Files (arxml)
or Legacy
Files (dbc, xml, ldf)
.
Note
The following section describes the import of AUTOSAR files. If you use legacy file as
input, you have to perform nearly the same steps, only for 1. Legacy Files button
has to be selected.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 25-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
1. Use the AUTOSAR Files button
to open the window where you can add your AUTOSAR files.
2. Add your Input Files via [+]
Note - Only necessary if DBC is used as input file
There is a document TechnicalReference_DbcRules_Vector.pdf that describes necessary
DBC rules to help you creating your DBC file. You find this document in the Tech-
nicalReference folder of your delivery.
3. Go on with [Next] and select the ECU instance.
4. Make your input file path relative to your project folder via Make Path Relative button
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 26-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
2.1.2 Add Diagnostic Data Files
If diagnostic is used, you have to add a diagnostic data file. If not, you can skip this section. There are
different use cases to import diagnostic data, decide if you import your data from a diagnostic data file
or from a already existing configuration.
Use Case 1: Import Diagnostic Data from ODX, PDX or CDD File
Open your project in the DaVinci Configurator and go on with the following Steps to import your dia-
gnostic data from a diagnostic data file.
1. Open the Input Files editor via Project | Input Files or use the input file button
of
DaVinci Configurator Pro toolbar
2. Open the Diagnostic Data Files view
in the Input File editor and open the
Diagnostic Fileset Configuration window via Add, remove or modify diagnostic data button
3. Browse for the Diagnostic Description File (*.cdd/*.pdx/*.odx)
4. Select ECU and Variant
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 27-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
Use Case 2: Import Diagnostic Data From a Existing Configuration
Open your project in the DaVinci Configurator and go on with the following Steps to import your dia-
gnostic data from a existing Configuration.
1. Start Import Assistant via File | Import
2. Add [+] ECUC File and go on with [Next]
3. Select modules which should be imported and close the Modul Configuration Import dialog via [Fin-
ish].
Make your input file path relative to your project folder via Make Path Relative button
2.1.3 Add Standard Configuration Files
In some cases a OEM-specific preconfiguration is necessary, therefore add the Standard Configuration
File provided by your OEM.
2.1.4 Update Configuration
Any change of the input files lead to Pending Update state of the project, this requires an update of the
configuration.
Update the configuration via
.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 28-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
What happens while update configuration process?
Before the update starts the Update Configuration message opens, select Complete update pro-
cess and go on with [Yes].
Note
If you do not know if your changes will affect the DaVinci Developer workspace, always
select Complete update process!
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 29-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
The project file will be updated based on loaded input/diagnostic files. If you selected Complete
update process, the DaVinci Developer update will be run in background.
The update runs successfully?
Note
After the first update/import of data bases all required modules are automatically
enabled. This information is derived from the data base. If further modules are required
or some shall be removed please refer to section Activate Your BSW Modules on page 32.
2.2 Define Custom Workflow Steps and External Generation Steps
To define custom workflow steps/external generation steps, open Project Settings Editor via Project |
Project Settings or use the project settings icon
ofDaVinci Configurator Pro toolbar.
2.2.1 Custom Workflow Steps
In some cases it is necessary to define custom workflow steps, e.g. to Generate SWC Templates.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 30-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
Then perform the following steps.
1. Select Custom Workflow | Custom Workflow Steps
2. Add [+] step
Decide if internal or external step should be created.
Note
Internal Workflow Step
Internal Workflow steps will call the RTE generator for generating e.g. component header
files or component implementation templates.
These steps will be created automatically by the DaVinci Developer.
External Workflow Step
Create this step to call any external tool, e.g. for generating description files for applic-
ation software components.
3. Define Name and Parameters e.g. to Generate SWC Templates Rte: -g i.
2.2.2 External Generation Steps
You have external software that needs to be started during the code generation of DaVinci
Configurator? Or just before? Or afterwards?
Then link your software to the External Generation Steps of DaVinci Configurator Pro.
How? Follow these steps.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 31-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
1. Select Code Generation | External Generation Steps
2. Add [+] step
3. Define Name, Command line executable, Execution Type and Working folder.
2.3 Activate Your BSW Modules
Before you start configuring your Basic Software, you have to activate all modules you need for your
project. Therefore open Project Settings Editor via Project | Project Settings or use project set-
tings icon
at DaVinci Configurator Pro toolbar.
Select Modules to see all modules currently activated for your project.
Info
It depends on your Input File which modules are loaded initially.
You need additional modules?
1. Click [+] and select the source of the module definition.
2. Select the module you would like to add to your configuration and confirm with [OK].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 32-

---

2 STEP2 Define Project Settings
User Manual Startup with GM SLP2
Info
Multiple selection is possible for activating or deactivating modules.
Not all modules are needed?
To delete not used modules, select the module and delete it via [x].
Caution!
It is not recommended to delete initially activated modules from project!
You have a completely configured module and would use this for the current con-
figuration?
1. Make sure, that the module you would like to import, is deactivated in your current project.
2. Select File | Import
3. Add [+] ECUC file including the configured module
4. Click [Next]
5. Select the module configurations to be imported
Note
It is not allowed to import BSW modules which are currently activated.
6. Click [Finish]
2.4 Add ECUC File References
In some cases it is necessary to add a ECUC reference file, to include mechanisms for module con-
figuration from other projects.
1. Select File | Add ECUC File Reference...
2. Add [+] the ECUC file of the module configuration you want to refer
3. Click [Finish]
4. Open Project Settings Editor and ECUC File References view, select reference and make path rel-
ative via Make path relative to...
icon.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 33-

---

3 STEP3 Validation
User Manual Startup with GM SLP2
3 STEP3 Validation
Start initial validation process to solve the first warnings and errors.
The DaVinci Configurator Pro provides validation routines that run in the background and are called
live validation. At the beginning of the configuration, the project has a lot of leaks, errors and
information in the system is still missing. Therefore the DaVinci Configurator Pro offers a powerful
solving algorithm.
Expert Knowledge
You need to know more? See section Validation on page 86.
3.1 Start Solve All Mechanism
First of all start solving mechanism via the Solve All button
at the validation view of the
DaVinci Configurator.
Note
Not all errors can be fixed with Solve All mechanism.
Some errors might have two or more solutions, these errors cannot be fixed automatically
by the Solve All mechanism.
3.2 Live Validation - Solving Actions
The DaVinci Configurator Pro provides a live validation during project configuration. For some para-
meter errors the live validation process offers possible solution(s) in the validation view of the DaVinci
Configurator Pro. These errors are marked with a bulb.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 34-

---

3 STEP3 Validation
User Manual Startup with GM SLP2
Note 3rd Party Module Live Validation
If Automatic Generation Validation is activated in Project Setting Editor, the con-
figuration of 3rd party modules is also checked while live validation.
Check if the suggested solving action is correct. Double click the error message to open the con-
figuration window of the parameter.
Solving Action is correct?
Start the solving action via double click on the solving action entry in the validation window.
Note
If the solving action is not correct, you can additionally use the link in the solving action to
navigate to the parameter and configure the changes manually.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 35-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
4 STEP4 Start BSW Configuration
Start the configuration of the BSW modules now. The target of this first description is a basically
working configuration, using a minimal necessary configuration.
Expert Knowledge
You need to know more? See section Configuration with Configurator Editors on page 87.
Note
Changes in Configurator Editors could lead to errors during live validation!
If these errors include solving actions, check and start solving action in the validation view
Cross Reference
If you use variant handling within your project, you have to refer to Variant Handling on
page 159 for special configuration information.
4.1 Start Configuration with Configuration Editors
The configuration editors are use case oriented and optimized for displaying or configuring those parts
of the ECU configuration, which are related to the use case.
4.2 Base Services
The Base Services domain contains comfort editors for the configuration of the development error
reporting, general purpose timer channels, microcontroller units and RAM test algorithms.
4.2.1 Development Errors
Open Development Errors | Enable or Disable Error Tracing and select necessary modules or
domains to enable the development error tracing.
4.2.2 General Purpose Timer (GPT)
Use default settings.
Note
If the editor is deactivated (greyed out), you can activate the General Purpose Timer
(GPT) module via click. The Modules Assistant opens to specify the short name of the mod-
ule to be added. Click finish to add the module.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 36-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
4.2.3 Microcontroller Unit
1. Open tab McuModuleConfiguration
2. Create new configuration via [here].
3. Open Clock Config Sets | McuClockSettingConfig | McuClockReferencePoint, add [+] an
McuClockReferencePoint and define Clock Reference Point Frequency
4.2.4 RAM Test
Use default settings.
Note
If the editor is deactivated (greyed out), you can activate the RAM Test module via click.
The Modules Assistant opens to specify the short name of the module to be added. Click fin-
ish to add the module.
4.3 Communication
The Communication domain contains comfort editors for the configuration of general parameters of
the communication related modules, ECU Bus Controllers, protocol data units, data signals and the
transport protocol.
4.3.1 Communication General
Define central settings of the communication based modules.
CAN
1. Open CAN | Miscellaneous
2. Set […] parameter Counter Ref to SystemTimer.
3. Set Interrupt Category to CATEGORY 2
4. Set Interrupt Lock to DRIVER
4.3.2 Bus Controller
1. Open the CAN Controllers | <CANController>
2. Define […] Controller Default Baudrate
3. Define […] CPU Clock Ref
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 37-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Note
If no CPU Clock Ref available, add a new reference via [+] in the Select Reference Target
view.
4.3.3 PDUs
Configure the PDUs of the modules (depends on your project)
> CAN/LIN/FR
> CANIF/LINIF/FRIF
> CANTP/LINTP/FRISOTP
> PDUR
> IPDUM
> COM
4.3.4 Signals
Configure the communication signals of the ECU.
4.3.5 Socket Adapter Users
Use default settings.
Note
If the editor is deactivated (greyed out), you can activate the SOAD module via click. The
Modules Assistant opens to specify the short name of the module to be added. Click finish
to add the module.
4.3.6 Transport Protocol
1. Open FlexRay | Tx Pdu Pools and Rx Pdu Pools to add [+] a new Tx Pdu Pool and Rx Pdu
Pool.
2. Open FlexRay | Connections | FrTpConnection and set […]
> Connection Control,
> TxPduPool and
> RxPduPool.
4.4 Diagnostics
The Diagnostic domain contains comfort editors for the configuration of extended data records and
snapshot records, diagnostic events and production error handling of the individual BSW modules and
a automatic setup of the NV memory blocks.
4.4.1 Diagnostic Event Data
Use default settings.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 38-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
4.4.2 Diagnostic Events
If no configuration set is found, use the hyperlink here to create a valid configuration set.
4.4.3 Production Error Handling
Use default settings.
4.4.4 Add Diagnostic Data ID Assistant
Start the assistant, enter a Name and confirm with [Finish]. The assistant creates a new DCM
DID and a new Data Object based on the given name.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 39-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Note
The assistant can not be used within a project with variants.
4.4.5 Automap Diagnostic Data Objects
Maps the data objects of the DCM DIDs to NV memory blocks. Therefore start the assistant, select the
data objects, go on with [Next >], select Data object to be mapped and confirm with [Finish].
4.4.6 Setup Event Memory Blocks
The event memory block configuration needs to be updated. Start the Editor and confirm with
[finish].
Note
The automatic setup of the NV memory blocks is required for diagnostic purpose.
4.5 I/O
4.5.1 IO Hardware Abstraction
Use default settings.
4.6 Memory
The Memory domain contains comfort editors for the configuration of the general parameters of the
memory related modules, the memory block in the non volatile memory blocks.
4.6.1 Memory General
If FEE is used, define
> BSS Thresholder Reserved
BSS - Background Sector Switch
> FSS Thresholder Reserved
FSS - Foreground Sector Switch
4.6.2 Memory Blocks
Open Memory Partitions | PartitionConfiguration and define
> Partition Device
Add the reference to their device of the partition
Note
If the editor is deactivated (greyed out), you can activate the EA/FEE module via click. The
Modules Assistant opens to specify the short name of the module to be added. Click [fin-
ish] to add the module.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 40-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
4.6.3 Optimize Fee
If Fee is used, start FEE Optimization The number of chunk instances (parameter FeeNum-
berOfChunkInstances) of the Fee blocks will be optimized. Please review the new value or select
"skip" to leave the parameter.
Note
If the editor is deactivated (greyed out), you can activate the FEE module via click. The
Modules Assistant opens to specify the short name of the module to be added. Click [fin-
ish] to add the module.
4.7 Mode Management Editors
The Mode Management domain contains comfort editors for the configuration of BSW Management,
ECU Management, initialization and restart sequences of the BSW modules, sleep modes and wakeup
sources, supervised entities and watchdog modes.
4.7.1 BSW Management
Auto Configuration: Ecu State Handling
Open Auto Configuration: Ecu State Handling and configure Ecu State Handling settings via Configure
Ecu State Handling hyperlink
. The Configure Ecu State Handling dialog
opens.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 41-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Select the necessary use case definitions to create a state machine similar to the behavior of EcuM Fix
in AUTOSAR3.
Note
If you select Ecu State Machine, you have to define the project-specific settings Self Run
Request Timeout and Number of Run Request User.
Auto Configuration: Module Initialization
Open Auto Configuration: Module Initialization and configure Module Initialization via Configure Mod-
ule Initialization hyperlink
. The Configure Module Initialization dialog
opens.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 42-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Select module to create the necessary callouts to initialize the modules.
Note
Please notice that MCAL modules must be initialized by EcuM!
Note
If Restore Default Sequence is activated, the lists will be sorted automatically, all new
entries will be located at the end of the list.
Auto Configuration: Communication Control
Open Auto Configuration: Communication Control and configure Communication Control via Con-
figure Communication Control hyperlink
. The Configure Com-
munication Control dialog opens.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 43-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Select the bus systems for which you would like to create standard communication rules.
Custom Configuration
If necessary you can define additional Custom BswM Configuration information.
Note
To create a rule, at least one logical expression and one action list is necessary. If
they are not available, you can additionally configure them via Create Rule dialog.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 44-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
1. Open Custom Configuration, right click Rules and select Create Rule.
2. Define Short Name
3. Go on with [Next]
4. Define a non-empty expression for the resulting condition
5. Configure Action List "True", therefore define actions to be executed if the rule's condition eval-
uates to "true".
6. Configure Action List "False", therefore define actions to be executed if the rule's condition eval-
uates to "false".
Note
If no actions are configured, no action list will be created.
4.7.2 ECU Management
1. Open EcuMCommonConfiguration and define the OS Resource which is used to bring the ECU
into sleep mode.
2. Open EcuMCommonConfiguration | EcuMSleepModes and define Sleep Mode Mcu Mode
Ref and Wakeup Source Mask.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 45-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
3. Open EcuMCommonConfiguration | EcuMWakeupSources and add [+] wakeup source for
each channel.
4. Open EcuMFlexConfiguration and define Mcu Mode Ref which is being restored after a sleep.
4.7.3 Initialization
Open Initialization editor to configure initialization and restart sequence of the basic software.
Pre-OS Initialization Sequence
Open Configure Module Initialization via Configure Sequence button
.
Select all MCAL modules and the DET to call them on ECU startup. Confirm with [OK] and order the ele-
ments according to your needs with the Move up and Move Down buttons.
4.7.4 Watchdogs
Use default settings.
Note
If the Editor is deactivated (greyed out), you can activate the Wdg module via click. The
Modules Assistant opens to specify the short name of the module to be added. Click [fin-
ish] to add the module.
4.8 Network Management
The Network Management domain contains editors for the configuration of the general network man-
agement parameters and users which are relevant for the ECU communication management.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 46-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
4.8.1 Network Management General
Open FrNm | FrNmChannelConfigs | FrNmChannels | <FRNMChannelIdentifiers> |
FrNmChannelTiming and define
1. Data Cycle,
2. Repetition Cycle and
3. Voting Cycle.
Note
For all other NM modules, use default settings.
4.8.2 Communication Users
Use default settings.
4.8.3 Partial Networking
Use default settings.
4.9 Runtime System
The Runtime System domain contains comfort editor for the configuration of general RTE and OS para-
meters, operating system and mapping assistants.
4.9.1 Runtime System General
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 47-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
OS
1. Open Runtime System General | OS and activate/deactivate the following settings if necessary.
> Stack Monitoring
> Use GetServiceId
> Use Parameter Access
2. Define Scalability Class, CC and Schedule.
3. Open OS | Hook Routines and activate/deactivate the following settings if necessary.
> Startup Hook
> Error Hook
> Shutdown Hook
> Pre-Task Hook
> Post-Task Hook
> Protection Hook
Note
The Shutdown Hook is required for shutdown of the ECU to power off.
The Error Hook is recommended to inform the application on any error events in the OS.
4.9.2 ECU Software Components
ECU Composition and Application Components
Note
Read only data after STEP5 Design Software Components.
Service Components
Open ECU Software Components | Service Components and check if all Service Components are
added to your project. If not create new component prototypes, based on component types created by
the DaVinci Configurator Pro.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 48-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Note
The component types are stored in <ProjectFolder>\Config\ServiceComponents.
4.9.3 OS Configuration
4.9.4 Create Tasks
Open OS Configuration | Task. Add the following tasks, define Schedule, Priority and Type.
> Init_Task
> Rte_Task
> Main_Task
Note
All events and alarms which are required are created by the RTE automatically.
Derived from the settings for the runnables and their activation (triggers) some OS events
an OS alarms will be created automatically for RTE by the DaVinci Developer. The names
start with Rte_.
4.10 Go on with Basic Editor
Open the Basic Editor and configure additional settings, currently not supported by specific con-
figuration editors.
Note: Bottom Up Approach - from hardware-dependent to hardware-inde-
pendent modules
Start configuration with hardware dependent modules and continue with the hardware
independent modules.
4.11 Start Solving Actions
Changes in Configurator Editors/Basic Editor could lead to errors during live validation!
If these errors include solving actions, check and start solving action in the validation view.
4.12 Start On-demand Validation
The on-demand validation is performed in addition to the automatic validation before starting the code
generation or on explicit user request. The on-demand validation calls the specific validation function
of the code generators.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 49-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
1. Open On-demand Validation dialog via on-demand Validation button
2. Deactivate RTE
Note
Currently the RTE is not configured completely, this causes errors while validation. The
RTE configuration will be finished after SWC Design in the DaVinci Developer.
3. Start the Validation via [Validate]
Validation finished successfully?
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 50-

---

4 STEP4 Start BSW Configuration
User Manual Startup with GM SLP2
Save the DaVinci Configurator Pro project and go on with configuring SWCs in the DaVinci Developer.
Note
It is possible to work with both tools parallel. A update message within the DaVinci
Configurator will inform you about the DaVinci Developer workspace changes.
Validation finished NOT successfully?
See error message in validation view and fix the configuration.
4.13 BSW Configuration finished
You have finished your BSW Configuration?
Now it depends on your project, how to go on. You have created a Developer workspace while setting
up the project? Then you have to go on with the STEP5 Design Software Components on page 52using
the DaVinci Developer. If you have no Developer workspace, you can skip the following chapter an go
on with STEP6 Mappings on page 53.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 51-

---

5 STEP5 Design Software Components
User Manual Startup with GM SLP2
5 STEP5 Design Software Components
Switch to the DaVinci Developer to create, configure or modify software components, create or add
ports and data elements. Connect software components and define runnables and their activation
and interfaces (data access).
Expert Knowledge
You need to know more? See section Software Component Design on page 88.
5.1 Switch to DaVinci Developer
You can start DaVinci Developer with already loaded project in two different ways:
> Start | Programs | Vector AUTOSAR Projects | <your project name> | Configure SWCs
(Only if Create entries in the start menu is selected)
> Right-click on your <projectname>.dpa and select DaVinci Project Assistant | Configure
SWCs
Note
For faster resynchronization, the DaVinci Configurator may remain open while working
with the DaVinci Developer.
A update message within the DaVinci Configurator will inform you about the DaVinci
Developer workspace changes.
5.2 Design Software Components
If the software components are not delivered by the OEM, use the DaVinci Developer to design your
software components. How to do this is described more detailed in the expert knowledge part of this
manual. Use the link above.
Everything correct? Finally check your settings via .Check workspace
.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 52-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
6 STEP6 Mappings
Start project mappings via assistants offered by the DaVinci Configurator Pro. It is also possible to
perform data mapping within the DaVinci Developer.
Expert Knowledge
You need to know more? See section Mappings on page 109.
6.1 Perform Data Mapping within DaVinci Developer or DaVinci Configurator?
Via the data mapping, you connect data elements with network signals. Network signals have been
loaded via import of ECU Extract of System Description.
Data Mapping can be done in DaVinci Developer or DaVinci Configurator Pro. Decide which tool should
be used. In the following step, both variants are described.
Note
Data Mapping in DaVinci Developer has a higher priority than Data Mapping in the DaVinci
Configurator Pro.
Data Mapping performed in DaVinci Developer cannot be overwritten in DaVinci
Configurator Pro.
Cross Reference
To perform data mapping within the DaVinci Configurator Pro, skip this section and go on
with section Switch (back) to DaVinci Configurator on page 56.
6.2 Data Mapping within the DaVinci Developer
The DaVinci Developer offers two ways of data mapping - automatically OR manually.
6.2.1 Data Mapping Automatically - DaVinci Developer
Network signal oriented approach
Select bus signals and let DaVinci Developer create all necessary data elements, ports and the map-
ping of the signals to the data elements.
Finally, you only have to drag’n’drop the port interfaces to your software components and create the
connections. Here is how this works.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 53-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
1. Double-click Data Mapping from the ECU Projects view
2. Select the Signal view mode
3. Select signals to create Data Elements and Port(s)
4. Right-Click selected signals and select Create Port Prototypes … to open the Create Port Prototypes
window.
5. Define prefixes and postfixes for the Port Prototype Name, Port Interface Name and Data Element
Prototype Name.
6. Select whether you want One Port Prototype per Signal or One Port Prototype for all selected Sig-
nals.
Note
If you select One Port Prototype for all selected Signals, of course the signal must be of
equal direction, only Tx signals or only Rx signals.
7. Confirm your settings with [OK].
8. You see that one Port Prototype, three Data Elements and one Application Port Interface are gen-
erated. The pre- and postfixes help to easily find them in the list.
9. Select the Software Design view and see the delegation port that has been also created.
10. Now drag’n’drop the Application Port Interface form the library to your software component (same
direction as the delegation port) and connect them.
6.2.2 Data Mapping Manually - DaVinci Developer
You can also connect the data elements with real bus signals manually.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 54-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
Note
A prerequisite is that you have to create the necessary delegation ports before!
Select Data Mapping in the ECU Projects view and select e.g. the Data Element View Mode
and
see a list of data elements. The dash (-) on the right side below Network, Messages and Network Sig-
nals shows that there is no assignment between data elements and messages/signals from the ECU
Extract of System Description.
Right-click the Data Element column and click Select Signal…. Select the suitable signal in the
Select Signal window and confirm with [OK]. Repeat this until every signal is mapped.
The result of the data mapping should look like this.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 55-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
6.2.3 DaVinci Developer - Save and close
You have imported your Service Components, configured your Software Components and finished Data
Mapping?
Check
your workspace. If there are no messages in the Output view, save your project and
close the DaVinci Developer.
6.3 Switch (back) to DaVinci Configurator
Start the DaVinci Configurator Pro (again) with already loaded configuration using one of the two pos-
sibilities.
> Start | Programs | Vector AUTOSAR Projects | <your project name> | Configure BSW
(Only if Create entries in the start menu is selected)
> Right-click on your <projectname>.dpa and select DaVinci Project Assistant | Configure
BSW
6.4 Synchronize System Description
Changes by the DaVinci Developer require a synchronization of the System Description in the DaVinci
Configurator Pro.
The necessity of a synchronization is detected by the validation process of DaVinci Configurator Pro
and displayed in the Validation view. Start System Description synchronization via the validation
message RTE59000 | Synchronize the System Description.
6.5 Add Component Connection
Data elements can only be transported from one application component to another if their ports are
connected via connectors. Create these connections using the Component Connection Assistant
(below Runtime System).
1. Start Assistant, select connector type and go on with [Next]
Select Application Connector Prototypes to connect software components or Service Con-
nector Prototypes to connect service components
2. Select a Component Prototype and go on with [Next]
3. Select Port Prototypes and go on with [Next]
4. If necessary select additional search option and go on with [Next]
Initially the Component Connection Assistant will search matching port prototypes based on the
port prototype name automatically
5. Check mapping. All Connector Prototypes are mapped with the right ports? Confirm with [Finish]
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 56-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
6.6 Service Mapping
If you have connected your service components via Add Component Connection in the previous
step, the service mapping is basically done.
To define additional mappings manually you have to configure it in the service component directly.
Therefore open ECU Software Components | Service Components and select the service com-
ponent you want to map. Open service component and select Service Connectors.
Now you can see all ports, the automatically matched connections and unmapped ports. Is manually
service mapping necessary?
Note
Each client port
should be mapped to a server port
! For all unconnected client
ports the RTE will generate a dummy function returning RTE_E_UNCONNECTED.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 57-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
YES? Therefore select the service component port and use the connect button
to assign the
appropriate port prototype to the selected port of the service component.
6.7 Add Data Mapping
You have already performed Data Mapping within the DaVinci Developer?
Yes? Skip this section and go on with Add Memory Mapping on page 60.
Cross Reference
See section Perform Data Mapping within DaVinci Developer or DaVinci Configurator? on
page 53
No? Start Assistant via Add Data Mapping
and select mapping direction, i.e.
choose whether Signals or Data Elements should be mapped.
Choose Find matching signals for the data elements to assign your signals based on a selected
data element and go on with [Next]
Now you can see a list of data elements. The empty row Mapped Signals shows that there is no
assignment between data elements and messages/signals from the ECU Extract of System Descrip-
tion.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 58-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
Select the Data element prototypes you want to map and go on with [Next].
Now you can see if matched signals are found automatically. If there are no entry in row Signal to be
mapped, you have to define the signal manually.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 59-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
1. Click <Select signal...> to open the Select reference target window.
2. Select the signal you want to map.
3. Confirm with [OK].
Repeat these steps until all data elements you have selected for mapping are mapped to a signal.
4. Close Data Mapping with [Finish].
6.8 Add Memory Mapping
You have to map all per-instance memory objects of the application components to NV memory
blocks. Therefore use the Memory Mapping Assistant
.
Note
A per-instance memory object is mappable if it is referenced by a service need object.
The definition of per-instance memory objects or service needs is part of the component
type definition and not yet editable by DaVinci Configurator Pro.
1. Start Assistant, choose Use Case and go on with [Next]
2. Select component prototype and go on with [Next]
3. Select per-instance memory objects
Choosing Use Case Find existing NV memory blocks?
Go on with [Next], Check the memory mappings and confirm with [Finish]
Choosing Use Case Create new NV memory blocks?
Confirm with [Finish]
6.9 Add Task Mapping
You have to map all runnable entities and schedulable entities (e.g. Main Functions of the BSW mod-
ules) to a task. Therefore use the Task Mapping Assistant
.
Note
A runnable has to be mapped to a task if it is not re-entrant but could be called re-
entrantly during system operation.
1. Start Assistant, select all Triggered Functions with Function Trigger On Init and go on with [Next]
2. Select Init_Task and go on with [Next]
3. Define the position in task for each triggered function and confirm with [Finish]
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 60-

---

6 STEP6 Mappings
User Manual Startup with GM SLP2
4. Repeat the steps and select all Main Functions of Service Components and Modules and map
them to Main_Task.
5. Repeat the steps and select all Runnables of your Application Components and map them to
Rte_Task.
Note
Runnables with Function Trigger On Operation Invocation are normally not needed to
be mapped to a task, as they result in direct function calls.
Mappings finished? Validation successfully? Then go on with project generation!
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 61-

---

7 STEP7 Code Generation
User Manual Startup with GM SLP2
7 STEP7 Code Generation
Now you can go on with code generation.
Expert Knowledge
You need to know more? See section Generation on page 116.
7.1 Start Custom Workflow Steps
Open Project settings via Project Setting icon
from DaVinci Configurator Pro toolbar. Open Cus-
tom Workflow and check, if a step for creating SWC Templates is available.
Available?
Start Custom Workflow Step via Execute Custom Workflow icon
.
Not available?
Create a Custom Workflow Step with parameter RTE: -g i.
Cross Reference
How to create Custom Workflow Step? See section STEP2 Define Project Settings on page
30.
7.2 Start Code Generation
1. Open the Generation dialog via Generate button
Note
The activated generation steps depend on the project settings. If you want to take over
your selection to the project settings press [Change project settings].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 62-

---

7 STEP7 Code Generation
User Manual Startup with GM SLP2
2. Start Generation Process via [Generate]
If you select Start immediately the generation starts immediately after opening this dialog.
Note
Before the Generation process starts, Calculation and Validation has to be finished
successfully.
If code generation canceled because of calculation and validation errors, start solving
actions at the validation window of the DaVinci Configurator Pro (see section STEP3 Val-
idation on page 34).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 63-

---

7 STEP7 Code Generation
User Manual Startup with GM SLP2
7.3 Generation Process finished!
Generation Process finished and all generation steps are marked with Phase finished suc-
cessfully
?
Note
The DaVinci Configurator Pro strores all generated *.c and *.h file in the modules files
folder, given during project setup (the default is <ProjectFolder>\Appl\GenData).
Go on with implementation of your code to the runnable skeletons created during the generation pro-
cess.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 64-

---

8 STEP8 Add Runnable Code
User Manual Startup with GM SLP2
8 STEP8 Add Runnable Code
If configured, the DaVinci Configurator Pro code generator generates the skeletons for your run-
nables into the software component template files. Now you have to implement your code to the run-
nable skeletons.
Expert Knowledge
You need to know more? See section Runnable Code on page 117
8.1 Component Template
The software component templates contain all runnables of the according software components. The
RTE Template Generator generates skeletons for the runnables. The structure of those skeletons looks
as shown in the illustration below.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 65-

---

8 STEP8 Add Runnable Code
User Manual Startup with GM SLP2
8.2 Implement Code
Implement your code to the runnable skeletons. Make sure to enter your code between the start and
end comment. Only this section is protected against modification by a further generation process.
All other sections like execution information or interfaces can be changed depending on your settings
in the DaVinci Developer. If access to e.g. a port interface is missing, go back to the DaVinci
Developer and adapt your configuration, regenerate and then you can use this port interface. There is
no other way to do it properly.
Info
A backup (*.bak) file will be generated before a component template C file is modified to
make sure that your previous version is not deleted in case of any generation problem
caused by non-predictable reasons.
And there is a backup section at the end of the template file to rescue the code of run-
nables that have been deleted by the DaVinci Developer.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 66-

---

9 STEP9 Compile and Link Your Project
User Manual Startup with GM SLP2
9 STEP9 Compile And Link Your Project
Now you can compile and link to get your executable for the download to your hardware.
Expert Knowledge
You need to know more? See section Compile and Link on page 119.
9.1 Finish your project with compiling and linking
This step is highly dependent on your compiler, linker and project settings.
1. Compile, Link your code.
2. Test your code
A proper Compile and Link process is just the beginning. The final step is to test what you have
done until now. This is no detailed test. It is just to make sure that you have bus communication.
The ideal tester would be CANoe from Vector Informatik. Connect your hardware to CANoe, start
CANoe, set the correct baud rate and have a look at the trace window. You see any bus com-
munication?
No error frames?
9.2 Congratulations, that’s it!
The basic step is done, the GM SLP2 software is basically working together with your application.
That is the base you can start from to optimize your system. Refer to Technical References of the BSW
modules for more detailed information.
Cross Reference
You need additional Information? See section Additional Information on page 120.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 67-

---

II Concept
User Manual Startup with GM SLP2
II Concept
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 68-

---

1 General Overview
User Manual Startup with GM SLP2
1 General Overview
The following illustration shows the basic idea behind AUTOSAR and can be divided up into 3 parts,
upper, middle and lower part, named as
> Creation of Software Components
> Software Components and ECUs
> Development of ONE ECU
The upper part deals with software components, runnables, ports and connections. It is the design
level of functions and applications.
During the transition to the middle part, the software components are assigned to ECUs. Software com-
ponents that are assigned to the same ECU can communicate internally, via so-called internal con-
nections. Software components, that have to communicate and that are mapped to different ECUs
communicate via so-called external connection, i.e. via the used bus system.
In the last transition towards the ECU sight, the BSW is put in between the software components and
the hardware. And this is the starting point for the ECU development.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 69-

---

1 General Overview
User Manual Startup with GM SLP2
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 70-

---

1 General Overview
User Manual Startup with GM SLP2
The following sub chapters explain all the means that belong to AUTOSAR and that make it work.
1.1 Software Component
Software Components are described by their SWC file - a file in XML format. By definition SWC files
are independent from any ECU except for the sensor and actuator software components. Those soft-
ware components are dependent on the sensors and actuators attached to a specific ECU.
There are several kinds of software components
1.1.1 Atomic components
> Application
> Sensor Actuator
> Calibration
> I/O Hardware Abstraction
> Complex Driver
> Application (End-to-end Protection)
> Non-Volatile Memory Block
> Service components
1.1.2 Compositions
Use compositions to group software components.
1.2 Runnables
A runnable entity, runnable for short, is a C function that carries your code. It depends on the con-
figuration of the runnable when it is called and what data your code is allowed to access within the run-
nable. Runnables are triggered by the RTE.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 71-

---

1 General Overview
User Manual Startup with GM SLP2
1.3 Ports
Via ports, a software component can communicate with its outside world. This outside world can be
another software component within the same ECU or a software component within another ECU. There
are several kinds of ports:
1.3.1 Application Port Interfaces
To communicate between different SWCs
> Sender port
> Receiver port
> Client port
> Server port
> Calibration port
> Mode port
> Interface to non-volatile data
1.3.2 Service Port Interfaces
To communicate between BSW and SWCs
> Sender port
> Receiver port
> Client port
> Server port
> Calibration port
> Mode port
> Interface to non-volatile data
> NV Data Interface
1.4 Data Element Types
Data elements types determine the kind of data that can pass a port. There are predefined data ele-
ment types and you can define data elements on your own.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 72-

---

1 General Overview
User Manual Startup with GM SLP2
1.5 Connections
To define which software components communicate with each other, their ports have to be connected
via so-called connectors. The connectors realize the sender/receiver and client/server communication
between the software components. A connector can only be drawn between two ports, if their port
interfaces are compatible.
1.6 RTE
The RTE is the interface between the SWCs and the BSW. In essence the RTE
> controls the execution of the Runnables (your code),
> controls access of Runnables to the basic software modules,
> controls the access of Runnables to Services of the BSW,
> knows about external and internal transmission of data and
> provides data consistency
1.7 BSW – Basic Software Modules
The BSW contains configurable modules that offer services to the SWCs dealing with:
> Communication
> Diagnostics
> Mode management
> Memory management
> Network management
1.8 Software, Tools and Files
When setting up a new project using the DaVinci Configurator Pro, many things that are not necessary
to know for your basic work with the tool happen in the background. But sometimes it might be neces-
sary to know more. Then this part of the document is the place to get a deeper insight.
This chapter gives you an overview what kind of files you need to set up a new project, where the files
normally come from and how to work with the DaVinci Configurator Pro and, if necessary for software
component design, with DaVinci Developer. Get familiar with what is installed where and how to work
with it and to know, how to update if necessary.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 73-

---

1 General Overview
User Manual Startup with GM SLP2
Starting point is the development of a single ECU. The focus is set on the MICROSAR Solution and
where all the necessary software and files do come from.
To build up a project according AUTOSAR with MICROSAR from Vector you need the following tool(s),
software and files:
> Software Components (SWC) and Runnables
Software components are created by the OEM or the TIER1. A software component can be an SWC
file, where you have to perform the task mapping and decide about runnables and the code they
should contain. Or the software component is delivered ready-made, together with C and H files.
Then you only have to map it to a task and compile and link the files together with your project.
> DaVinci Developer (Vector Tool, has to be ordered separately - NOT included within
the SIP)
The DaVinci Developer is the Vector Tool to create and configure Software Components. Via a
graphical view you can draw software components, add ports, draw connections, etc. DaVinci
Developer and DaVinci Configurator Pro exchange information via the DaVinci Developer Work-
space.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 74-

---

1 General Overview
User Manual Startup with GM SLP2
> BSW and RTE (included in SIP)
The BSW modules together with their BSWMD files (dependent on your order) and the RTE are part
of the Vector delivery that is called SIP. SIP stands for Software Integration Package. A SIP is
a ready-made software from Vector, already tailored and tested for your hardware, derivative,
compiler, compiler version (as you filled-out the questionnaire) and can be put to work within a
few steps (see step by step description).
> DaVinci Configurator Pro (included in SIP)
The DaVinci Configurator Pro is the Vector Tool to configure the BSW and the RTE. It is part of the
SIP delivery. It contains a comfort editor to configure the BSW cluster-oriented, a powerful val-
idation concept to check your settings against constraints and it also offers to directly edit
AUTOSAR parameters.
1.9 Structure of the SIP Folder
The screenshot below shows the file structure that is created by installation of the SIP.
> BSW
Contains the code files (*.C and *.H) files for each Basic Software Module (BSW).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 75-

---

1 General Overview
User Manual Startup with GM SLP2
> BSWMD
Contains the BSWMD files for each Basic Software Module, which include necessary information for
DaVinci Configurator Pro.
> DaVinciConfigurator
Contains the DaVinci Configurator Pro tool itself. This is also the place where your tool is updated
when an update is available.
> Doc
Contains SIP relevant documentation e.g. Technical References, User Manuals, Startups (con-
taining Release Notes) and Application Notes.
> Generators
Contains Generators and additional tools
> Misc
Contains SIP-specific additional data
> ThirdParty
Contains MCAL-specific data
Note
Each MCAL Module is listed within a separate folder (<MCAL Short Name>).
This folder includes:
> \Supply
Location of the 3rd party MCAL delivery in its original structure
> \VectorIntegration (optional)
Location of scripts for the integration into the MICROSAR SIP
> Legal notes (optional)
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 76-

---

1 General Overview
User Manual Startup with GM SLP2
Vector MICROSAR for AUTOSAR 4 now has one major tool – the DaVinci Configurator Pro. DaVinci
Configurator Pro is the starting point, coming with the SIP. To start the tool, use the file DaVin-
ciCFG.exe located in the CORE folder of the DaVinci Configurator folder.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 77-

---

2 Set-Up New Project
User Manual Startup with GM SLP2
2 Set-Up New Project
The DaVinci Configurator Pro offers a Project Assistant to set up that helps you setting up a new pro-
ject file in just a view steps. The assistant guides you through several windows to enter necessary pro-
ject information.
The DaVinci Configurator Pro creates your new project to the defined folder. The project folder con-
tains:
> Appl folder for generated files and source files.
> Config folder for software components, BSWMD files, ECUC files, System description and DaVinci
Developer workspace
> Backup folder to store older DaVinci Developer workspaces
> Log folder
> Access to DaVinci Developer and DaVinci Configurator Pro via context menu on the *.dpa file.
Your development project consists of a folder structure on your disk, where all the configuration files,
template files, etc. are generated to and where you implement your runnables using the empty run-
nable skeletons. Then you compile and link and get your executable that you can download to your
hardware.
The DaVinci project file (DPA) is the central file which references all the related folders and files. It
also references the SIP, which is used for the project.
2.1 DaVinci Configurator
As already mentioned the DaVinci Configurator Prois the major tool for Vector MICROSAR for
AUTOSAR 4.
2.1.1 The Main Window of DaVinci Configurator Pro
The illustration below shows the main appearance of the DaVinci Configurator Pro. It consists of 3
main areas or views. The positions of the views can be defined manually and depend on your habits in
handling with tools.
> Navigation view
> Editor Area
> Validation, Output and Properties view
Cross Reference
For more information about simple tool handling and icons refer to the help of the DaVinci
Configurator Pro.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 78-

---

2 Set-Up New Project
User Manual Startup with GM SLP2
Navigation view
The Navigation view displays all available editors and assistants sorted by domain. What you select in
the Navigation view will be displayed in the Editor view.
Editor area
The Editor area is the place to configure the modules or whatever you have selected in the Navigation
view.
Validation view
The Validation view displays the overall list of validation messages. The messages are grouped by
their ID. You may expand such a group to display all message of the same ID. By expanding an indi-
vidual message, the related items are displayed as well as the proposed solutions, the so-called solv-
ing actions.
Using according commands in the shortcut menu you can navigate to the editors displaying the related
items, or execute one of the proposed solutions for solving the problem.
You can use the Validation view with the following buttons:
> Solve All
Calls the default solving action of all messages that provide a default solving action.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 79-

---

2 Set-Up New Project
User Manual Startup with GM SLP2
> Clear On-Demand Validation Messages
Deletes all validation messages issued by the external generators during the on-demand val-
idation.
> Link with Editor
Filters the Validation View to display only messages related to the currently focused editor.
Properties view
The Properties view displays details of the object (parameter or container) selected in an editor. The
view contains the following tabs:
> Definition: Displays the definition of the selected object
> Status: Displays information about the parameter state
> Description: Displays the description of the parameter definition
2.1.2 Project Settings
This Overview shows all necessary project data and enables the configuration of customer workflow
steps, the definition of external configuration steps and the activation of additional BSW modules.
2.1.3 Editors and Assistants
Generally spoken there are two different configuration editor concepts in the DaVinci Configurator Pro.
> Domain-specific configuration editors, which provide an optimized view on the ECUC
> Basic Editor, which provides a native view on the ECUC
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 80-

---

2 Set-Up New Project
User Manual Startup with GM SLP2
Assistants
An assistants guides you through special tasks like connections, data mapping, memory mapping or
task mapping.
Switch Between the Two Editors
You can switch from the basic editor to the domain-specific comfort editor and back. Move to a setting
or a value and click the little triangle to open the context menu. If there is a pendant in the other con-
figuration editor, you can switch from one to the other via Show in.
Set User Defined
It is very important to understand that you are responsible for these modifications! With
Set user defined you can change values even when they are grayed because their values are derived
from the input files or locked by a configuration dependency.
When you use Set user defined, the parameter will be marked with a little pin on the left side. The
upper check box in the example below is marked as user defined, the lower one is not.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 81-

---

2 Set-Up New Project
User Manual Startup with GM SLP2
Note
Set user defined will not work for pre-configured parameters. The setting in the context
menu is grayed and cannot be used. The information about predefined or not can be seen
in the Properties view. Select Status and look at Changeable or Deletable.
Remove user defined
To set back the user defined status, use the context menu and select Remove user defined.
Note
Every parameter set to user defined will provoke a warning during validation with the
information, that this parameter was set to be user defined.
Caution!
The feature set user defined enables settings that are terribly wrong. As soon as you
use this feature, you have to be sure that you know what you do and you have the com-
plete responsibility.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 82-

---

3 Define Project Settings
User Manual Startup with GM SLP2
3 Define Project Settings
Your first steps after the new project is set up, are:
> Define Input files
> Define your specific workflow steps and external generation steps (if needed)
> Activate all necessary BSWs
3.1 Input files
The DaVinci Configurator Pro needs information about your system, the bus communication, etc. This
information is stored in the SYSEX or when using legacy file formats dependent on the bus system, in
the DBC,LDFor FIBEX files. One or more (e.g. for systems with multiple channels) of these files must
be given to the DaVinci Configurator as input files.
The necessary diagnostic information is stored in CDD or ODX files and is also needed by the DaVinci
Configurator Pro.
3.1.1 System Description Files
You need one of the following description files:
3.1.2 SYSEX
ECU-specific extract of the System Description. This file is typically provided to the TIER1 by the OEM.
It contains
> ECU composition
> Atomic SWCs
> Compositions
> Communication
> Data mapping
> typically NO service SWCs
3.1.3 ECUEX
Base for the ECU development is the ECU Extract of System Description, ECUEX for short. It is created
from the SYSEX by flattening the SWC architecture. This means that SWC compositions have been
removed, only the atomic SWCs are left. And they now communicate directly with each other. Addi-
tionally to the SYSEX, the ECUEX contains:
> Service SWCs
> Service mapping, i.e. service connections between the ports of the SWCS and the ports of the ser-
vice SWCs.
3.1.4 Legacy Data Base files (DBC, LDF, FIBEX, ...)
The legacy data base files are normally not in ARXML format. They also contain information about
ECUCs, messages, signals, attributes, etc. Good AUTOSAR tools can read them and convert their
information into AUTOSAR-conform notation. The missing information when using legacy file formats
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 83-

---

3 Define Project Settings
User Manual Startup with GM SLP2
must be given to the configuration tool by the software developer.
3.1.5 Diagnostic Data Files
Your Project uses Diagnostic? Therefore you need one of the following diagnostic description files:
3.1.6 CDD / ODX
These files contain the diagnostic description for the ECU.
> *.CDD
The CANdelaStudio Document (*.cdd) format is specified by Vector for describing the diagnostic
feature set of an ECU.
> *.ODX/*.PDX
ODX (Open Diagnostic Data Exchange) is an ASAM standard which defines a unique, open XML
exchange format for diagnostic data. A packaged ODX file (*.PDX) comprises all files of an ODX
project.
3.1.7 State Description
Diagnostic session and security level management is modeled as a state machine which describes the
transitions between sessions and states triggered by the execution of diagnostic services.
If a CANdela Document (*.CDD) is used as diagnostic description file, all diagnostic session and secur-
ity level related information will be imported from the input file.
If a Packaged ODX file (*.PDX) is used as diagnostic description file, it will depend on the used ODX
version if an additional state description is required.
> ODX 2.2.0
For ODX 2.2.0, the state machines are defined within the ODX file, using the data model intended
for this purpose.
> ODX 2.0.1
As ODX 2.0.1 does not provide means to explicitly model diagnostic sessions, security levels and
their corresponding transitions, dedicated SDGs (special data groups) are used to annotate the
ODX data with supplemental information about the diagnostic session behavior. This information is
not sufficient in all cases and an additional state description will be mandatory to augment the ODX
data with the required information during the import of the diagnostic description.
A state description is a *.CSV (comma separated values) file which defines the transition matrices of
the diagnostic session and security level state machines.
3.1.8 Standard Configuration Files
In some cases a OEM-specific preconfiguration is necessary, therefore additional Standard Con-
figuration Files provided by your OEM are necessary. Add fragments of ECUC modules which will be
used as project specific mandatory configuration.
3.2 Custom Workflow Steps / External Generation Steps
In STEP7 Code Generation on page 62, after the configuration, DaVinci Configurator Pro generates
code. You can additionally let DaVinci Configurator Pro call any external tool during this step in a free
configurable order. If something is to be done before code generation, if you use some command line
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 84-

---

3 Define Project Settings
User Manual Startup with GM SLP2
tools or whatever, add these tools to the list and define the call order. With STEP7 Code Generation on
page 62, all your mentioned tools will be also called.
3.3 Activate BSW
Which modules are activated and which are not depends on the information in the input files. Activate
or deactivate the modules.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 85-

---

4 Validation
User Manual Startup with GM SLP2
4 Validation
Nothing done but imported some files and already many mistakes in the configuration?
Why is that?
The DaVinci Configurator Pro provides powerful validation routines that run in the background named
Live Validation. At start-up of your project, there is only the information from the input files of
STEP2 Define Project Settings on page 24. The content of these input files normally has leaks, some-
times errors or the information of the system is still missing and has to be accomplished during con-
figuration. This all leads to a number of errors detected by the validator of DaVinci Configurator Pro.
But with the powerful solving algorithms and assistants, it is very easy to solve off the first warnings
and errors.
4.1 Validation Concept
The validation concept comprises:
> Detailed validation of the ECU configuration
> Comprehensive set of domain-specific validation rules
> Navigation from validation message to the editors
> Tool makes proposal for solving an error (solving actions)
> Automatic consistency (auto-solving action) after changing the configuration via Comfort Editors or
via the Basic Editor
Live Validation
The Live Validation is performed in the background after loading a project or after changing the con-
figuration. The Live Validation directly gives feedback after entering wrong values.
On-Demand Validation
This validation is performed when you start a generation process. You can start the validation via Pro-
ject | on-demand validation. The on demand validation will also launch external generators or
execute more complex validation tasks that cannot be executed live.
Note
The result of a validation is displayed in the Validation View.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 86-

---

5 BSW Configuration with Configuration Editors
User Manual Startup with GM SLP2
5 BSW Configuration With Configuration Editors
5.1 DaVinci Configurator Pro Editors
To configure the BSW modules you can use the Basic Editor or the more comfortable and cluster-spe-
cific Configuration Editors.
Basic Editor
The Basic Editor is a generic configuration editor (GCE) and includes the native view of the ECU con-
figuration. It is based on the basic software module description (BSWMD) format and displays all mod-
ules of the ECU configuration.
Configuration Editors
The Configuration Editors offer a use-case oriented view of the ECU configuration. They are optimized
for displaying or configuring those parts of the ECU configuration, which are related to the use case.
Use the Configuration Editor first. To get the necessary settings for your fist step in dependency of
your OEM and its use cases refer to Start Configuration with Configuration Editors of the step by step
description.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 87-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
6 Software Component (SWC) Design
6.1 Data Exchange between DaVinci Developer and DaVinci Configurator Pro
The data exchange between DaVinci Developer and DaVinci Configurator Pro is done via the DaVinci
Developer workspace, file with DCF format.
DaVinci Developer uses this file to store the complete project information. It can read and write this
file.
DaVinci Configurator Pro only reads this file and only at tool start-up.
Note
Please re-open the DaVinci Configurator Pro if you have changed the DCF file via the
DaVinci Developer to get the current data from the DCF file.
Keep in mind that the DaVinci Configurator Pro is not able to write to DCF file.
6.2 About Application Components, Ports, Connections, Runnables and More…
Learn all about application components, ports, connection and runnables, how they work and how to
exchange information between application components.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 88-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
1. Application Components
2. Ports, Port Init Values and Data Elements
3. Connections
4. Runnables
5. Triggers
6. Port Access
7. Data Mapping
Cross Reference
To get basic tool handling information, refer to the online help of the DaVinci Developer.
6.3 Application Components
To create application components use the DaVinci Developer.
6.3.1 The Library – Type and Package
You find the Library of the DaVinci Developer (in standard configuration) below the ECU Projects.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 89-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Types or Package?
The Library you use in the following steps can basically be used in two ways.
> Type-oriented
> Package-oriented
The type-oriented workflow is shown in the following steps. But you can also choose the package-ori-
ented one. This concept will now be described briefly.
Packages
With Packages you can pack elements together like:
> Application Component Types
> Service Component Types
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 90-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
> Data Types
> Constants
> Mode Declaration Groups
> Application Port Interfaces
> Service Port Interfaces
It is like a kind of grouping with its own name space. A name of an object has to be unique within a
package but can be used more than once within the project.
These packages can be exported and imported for round-tripping with other tools also supporting the
packages.
Switch to package view
At the bottom of the Library you can select Type view or Package view. Select the Package.
You need a Root Package first. Create it via right-click in the empty Package view.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 91-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
New Child Package…
Then right-click the root (e.g. MyECU_PartA) and you will get to the context menu. Use New Child Pack-
age to nest the packages or you put the objects plain below the root package.
The context menu for the packages
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 92-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Add Objects
Via Add Objects you open a window to select and add already existing object to your package.
New …
The section New… of the context menu comprises all available objects which you can also create via
the Type view of the Library (explained in the following chapter).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 93-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
XML Export…, DCF Export…
Export your package as XML file or as DCF file.
Object Usage…
Shows dependencies between used objects in a tree-view.
Object Locking
Objects can be locked and unlocked. A locked object is displayed with a little lock. Locked objects can-
not be deleted without being unlocked before.
Define new Component Types in the Library
Right-click on Application Component Types in the Library and select New Application Component
Type.
6.3.2 New Application Components
Right-click on Application Component Types in the Library and select New Application Component
Type.
It is good to give a speaking name to see what kind of component it is. e.g. AP – Application, SA –
Sensor / Actuator
Enter a Name for the Application Component Type. Select Composition if the SWC should contain other
SWC or select Atomic. Select its Type and confirm with [OK]. All application software component types
are displayed in the library.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 94-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 95-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Note
To get fast information about any element in the library just select one and see its Prop-
erties, Port Prototypes (if available) and Description in the Properties view (bottom left).
Component types become component prototypes by being used.
Double-click Software Design in the ECU Projects view to open the Software Design view for your ECU
project (e.g. MyECU).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 96-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Note
In the graphical representation of an application component prototype you can change its
size using the little squares shown at the angles and in the middle of the sides.
An application component type becomes an application component prototype when it is used. It also
needs a name. Using drag’n’drop, both names are the same. Open the properties window from the con-
text menu for a component prototype to change the prototype name.
Define and use as many application software components as you need for your ECU.
Note
The notation of the software component starts with the software component prototype fol-
lowed by the software component type.
6.3.3 Understand Types, Prototypes and Interfaces
This illustration will help you to understand working with the DaVinci Developer. You have to deal with
> Prototype
> Type
> Interface
When is a software component a software component type, when a software component prototype?
When is a port a port interface, when a port prototype?
In the library, the software components are types, the ports are interfaces. As soon as you use them,
they become prototypes.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 97-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
> Port Interface used by a component type â Port Prototype
> Component Type in library used in software design view âComponent Prototype
Runnables are always connected to the component type.
6.4 Ports, Port Init Values and Data Elements
To communicate and to exchange information the components need so-called ports (S/R ports).
For communication between software component ports have to be defined.
There are different kinds of application/service ports,
> Sender Ports
to provide information
> Receiver Ports
to receive information
> Sender/Receiver Ports
to provide and receive information within one port
> Server Ports
to provide services (operations)
> Client Ports
to use services (operations)
The following ports are listed here for completeness.
> Calibration Ports to hand over calibration parameters
> Mode Ports to e.g. trigger or not trigger runnables within certain modes
Before you can use application ports you have to define application port interfaces. To completely
define the port interfaces you have to define data types first, if you don’t want to use the predefined
ones.
Predefined data types in library
Just right-click and select from the list.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 98-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Caution!
You can handle application port interfaces like application component types. Define the
application port interfaces in the library and then use them as application port prototypes
for each application component. The same applies for data types and data elements.
Create Port Interface
To define a new application port interface, right-click the Application Port Interface in the library and
select New S/R Port Interface….
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 99-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Then the window for the S/R Port Interface opens. Enter a name, select the tab Data Element Pro-
totypes and define the content of the port. In this case it is just one data element called OnOff with
the Data Type Boolean, use the button […] to select Data Type.
Note
Data elements are the contents of ports.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 100-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Note
A port interface can carry many data elements of different data types.
Provide software components with ports
> You have created your application software components.
> You have created necessary application ports interfaces and their content (data element pro-
totypes).
Now you have to define which application component needs which application ports.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 101-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Add ports to the application components via drag’n’drop
Select an application port interface from the library and place it onto the application component via
drag’n’drop. This transfers a port interface into a port prototype.
Note
Press <Ctrl> while drag’n’drop to change between sender or receiver port.
Interfaces
The ports are added to the components as graphical element together with the name of the port.
> Sender port
> Receiver port
Note
Ports need Init Values.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 102-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Port Init Values
You have to assign an initial value to every used application port.
6.5 Configure Service Ports within your Application Components
Your Service Components will be loaded automatically to the DaVinci Developer workspace .
Note
The DaVinci Configurator stores the service components within the folder <Project
Folder>\Config\ServiceComponents.
The content of the service components are not part of the DaVinci Developer workspace.
If you want to connect one of your Application Component to a Service Component, you have to define
a Service Port Prototype based on a Service Port Interface.
Service Port Interface name and content depend on the BSW configuration and version of the service
component within the DaVinci Configurator, so it is not stable. An Application Component shall always
define its own or a general Service Port Interface definition.
The Service Port Interface definition from the loaded Service Component is always in read-only status.
These Service Port Interfaces are marked with a read-only icon
within the library.
You have currently not defined your Service Port Interfaces?
Then copy and paste the definition from the Service Component. Assign the definition to an own pack-
age, so it is possible to use the same name as before. Therefore open the Service Port Interface,
select Package tab and choose a package via [...].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 103-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Assign your copied Service Port Interface to your Application Component. Therefore open your Applic-
ation Component Prototype, select Port Prototype List
, open Service Ports tab and add your
Service Port via [New] | From Port Interface. Now the Service Port used by your Application Com-
ponent is independent from the Service Component description.
Note
If incompatible changes apply these will be reported by RTE checks.
6.6 Define your Runnables
Now configure runnables that will carry your code.
There are four important topics for a runnable:
> SYMBOL and NAME – what the runnable skeleton is called in the template file
> TRIGGER – when is the runnable executed
> PORT ACCESS – what data can the runnable access
> MAPPING – in which task context does the runnables work?
Caution!
Runnables can only be defined for atomic application components types.
Note
The runnable skeletons are generated by the DaVinci Configurator Pro/the RTE and can
then be accomplished with your code. Find more details follow in the next chapters.
Check also later hints to template generation
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 104-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
1. Open a software component via the library or the software design view.
2. Click on the runnable icon [fx].
3. Click [New] and select Runnable.
4. Enter Name and Symbol for the new runnable on the Properties tab.
If you leave the Symbol field empty, the runnables (functions) will be named according to the entry in
the Name field.
Minimum Start Interval
Define the minimum time interval between the successive triggering of this runnable.
Can Be Invoked Concurrently
A runnable can be marked as Can be invoked concurrently if it can be executed while it is already
running. In other words it can be safely executed concurrently (re-entrant). There are a few criteria
for your implementation code:
> No static (or global) non-constant data
> No return of address to static (or global) non-constant data
> Only work on data provided by caller
> No modification of own code at runtime
> No call of non-re-entrant runnables
6.7 Triggers for the Runnables
The trigger decides when a runnable is executed.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 105-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Select the tab Trigger. On this tab you select when your runnable should be executed.
Note
A runnable can be triggered periodically or via an event.
Periodical: Select the checkbox and enter the cycle time.
On Data Reception: As soon as data is received at the appropriate port the runnable is
activated. (Indication)
The trigger On Operation Invocation belongs to service ports and will be explained
later.
The runnable of the demo application only needs to be called when the state of the doors is changed.
This can be realized via a cyclic polling or directly by a trigger from the doors. In the demo, Peri-
odical… is chosen.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 106-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Note
When experimenting with the demo, replace the cyclic trigger with two triggers On Data
Reception…, one for the left and one for the right front door.
6.8 Port Access of the Runnables
Define which port information each runnable should be able to read or write. Select the tab Port
Access. You only get displayed accessible ports.
You can define access to
> Read Data… and
> Write Data…
> and later when using client server port also to operations (Invoke Operations).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 107-

---

6 Software Component (SWC) Design
User Manual Startup with GM SLP2
Click e.g. Read Data… and the Port Access Definition:Read Data window will open.
Caution! Direct – Buffered
Direct Write: as soon as you write the information to the data, it is changed imme-
diately.
Buffered Write: the data information is changed at the end of the runnable runtime just
before leaving it.
Direct Read: if you access to the data multiple time, it could be changed in the mean-
time. You always read the current information.
Buffered Read: with the start of the runnable, the data is copied to a buffer. Every time
you access the data, it has the same value until the runnable is left.
Note
In the header of the runnable’s skeleton that will be generated by the DaVinci Developer,
you will find a list with all available API functions for this runnable. If any access is miss-
ing, go back to the DaVinci Developer and check whether the Port Access is set correctly.
Summary
Summary of the settings for your runnable MySWC_Code:
> The runnable is called MySWC_Code
> Its functional representation is called: MySWC_Code.
> It is triggered periodically
> The runnable has access to the state of the left and right door and to the data of the front interior
light. It also has access to the LightDimControl.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 108-

---

7 Mappings
User Manual Startup with GM SLP2
7 Mappings
Generally spoken Mapping stands for assignment of one object to another. There are different map-
pings in the context of AUTOSAR. What is meant here is:
> Data Mapping
> Task Mapping
> Service Mapping
> Memory Mapping
7.1 Data Mapping
Your ECU has to communicate with other ECUs, the external communication. Signals have to be sent
and received via the connected bus system. The signals and the types of data transported via the sig-
nals is defined in the data base like DBC, LDF, FIBEX, and also in the SYSEX.
From the view of software components, communication information is exchanged via ports that carry
so-called data elements. The definition of a port contains the assignment of data elements that can
pass the port. Via the Data Mapping you define, which data element belongs to which signal. For short,
you assign data element to bus signals. That’s called Data Mapping.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 109-

---

7 Mappings
User Manual Startup with GM SLP2
Note
Data Mapping can also be done in DaVinci Configurator Pro!
Data Mapping in DaVinci Developer has a higher priority than Data Mapping in the DaVinci
Configurator Pro.
Data Mappings done via DaVinci Developer cannot be overwritten by the ones doen via
DaVinci Configurator Pro.
7.2 Task Mapping
Tasks are means of the operating system. You can define as many tasks as you like and need. You
define the name of the tasks, its priority and its type like Auto, Basic or Extended. You can also
define the task as non- or full preemptive.
With Task Mapping, you have to map all runnables to tasks, expect On operation invocation
triggered runnables. Those are normally called only from one task and have no problem with reen-
trance.
A runnable has to be mapped to a task if it is not re-entrant but could be called re-entrantly during sys-
tem operation.
What happens if you do not map a runnable that should be mapped?
The Vector AUTOSAR Solution provides an intelligent RTE generator. The RTE generator checks neces-
sary conditions and will warn you if there are unmapped runnables that have to be mapped.
What happens if you map a runnable that does not have to be mapped?
Nothing will happen. It will still work. But the code efficiency and RAM consumption could be less good.
Is there a disadvantage of the RTE generator automatism?
It could be less comfortable to figure out the call context of the runnables and the stack consumption
could increase.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 110-

---

7 Mappings
User Manual Startup with GM SLP2
7.2.1 Information about Interaction between Runnable, Re-entrance and Task Mapping
Your goal is a configuration of the system that results in a highly centime-optimized and memory con-
sumption-optimizes code. Here is a little information to estimate what the RTE generator does.
This illustration shows a software component with four runnables. Only runnable 3 is set to Can be
invoked concurrently. On the right-hand side you see which runnable is mapped to which task and
the result of this mapping for the generated code. Here is the details.
Can be invoked concurrently is set and the runnable is not mapped to a task
Example: Runnable 3
Runnable 3 is called directly in the context of the calling BSW (DCM in this example – DCM_MainFunc-
tion, TASK B).
Caution
Make sure that your runnable is really re-entrant (see section Can Be Invoked Con-
currently). If not, errors can occur that are difficult to debug.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 111-

---

7 Mappings
User Manual Startup with GM SLP2
Can be invoked concurrently is NOT set and the runnable is not mapped to a task
Example Runnable 4
If the RTE generator finds out that the runnable is not called multiple times in parallel, Run-
nable 4 is called directly in the context of the caller BSW (DCM). Otherwise an error mes-
sage will be shown.
Can be invoked concurrently is NOT set and the runnable is mapped to a task different
from the task where the main function of the caller (e.g. Dcm_MainFunction) is mapped.
Example: Runnable 1
When the caller BSW now wants to activate the runnable via the RTE call, an event is set
and the temporary variables of the runnables are stored to RAM (context of calling BSW,
e.g. Task B). When the point in time has come, the WaitEvent in Task A is triggered by the
event and starts the Runnable1(A) and hands over the parameters previously stored to
RAM.
As you see, runtime is longer than using direct call and the RAM consumption is higher.
E.g. for diagnostics: DCM runnables always have array types that are completely stored to
RAM. For e.g. 100 DIDs à 4 bytes you need 400 bytes!
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 112-

---

7 Mappings
User Manual Startup with GM SLP2
7.3 Memory Mapping
Within ECUs there is data that has to be persistent during power-off. Therefore this data cannot be
stored simply to RAM, it must be stored to EEPROM or Flash, i.e. to non-volatile memory. As an
example for this data, think of the DEM information.
There are two possible ways how this non-volatile data will be used. Either your application always
accesses a RAM copy of the NV data where the data is copied at start-up. Or data can be read/written
directly from/to NV memory on request.
The Memory Mapping assigns your defined PIM, per instance memory to the memory blocks of the
NVM.
A per-instance memory object is mappable if it is referenced by a service need object. The definition
of per-instance memory objects or service needs is part of the component type definition and is not
yet editable by DaVinci Configurator Pro.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 113-

---

7 Mappings
User Manual Startup with GM SLP2
7.4 Service Mapping
The base for the service mapping is the theory about clients and servers. The client uses a service of
the server. The server itself provides the operation to the client. The client server communication
between your application software component and a service component is done via service ports – cli-
ent ports and server ports. A server port provides services (one or more operations) and a client port
uses these services.
A service component can have server ports and client ports.
> Service port of the service component is a server port
The service is provided by the service component and your application software component just
uses the operations (services, functions)
> Service port of the service component is a client port
Your application software component must be server and has to provide the operation (service,
function). In this case, you have to program code, i.e. a runnable. This runnable must be created
by you and it is triggered by the request of the service.
Besides the sender and receiver ports, there are also client and server ports. Sender and
receiver ports carry data elements, via client ports, you can access so-called operations
(or functions) of the servers.
Within one service port there could be n operations. Every single operation has to be assigned to a run-
nable.
The servers provide the runnables that contain the code. Here Runnable1, Runnable 2, Runnable 3 of
the service component and Runnable 4 and Runnable 5 of application component.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 114-

---

7 Mappings
User Manual Startup with GM SLP2
When performing the service mapping, it is almost the same as the data mapping – but now you deal
with services instead. To be able to access the services of a service component, you have to add this
service component to your software component.
Then you can use all services that are provided by the service component. In this case your application
is the client and the service component is the server.
But using a service component not only brings benefit – it also costs. Almost every service component
does not only provide services – there can also be client ports on the service component side. And if
you add this service component to your software component, you have to provide all the services
where the software component provides a client port interface.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 115-

---

8 Generation
User Manual Startup with GM SLP2
8 Generation
With the generation step DaVinci Configurator Pro generates the code for your project and also con-
cerns your settings in STEP2 Define Project Settings on page 24. DaVinci Configurator Pro clings to
your settings and works off the “to be generated” list.
The DaVinci Configurator Pro provides an automation interface for remote-controlled validation and
code generation.
8.1 MICROSAR Rte Gen
The RTE is generated by the MICROSAR Rte Gen. Its generation depends on many settings in the con-
figuration tools and how runnables are mapped to tasks. The files start with Rte_ or SchM_.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 116-

---

9 Runnable Code
User Manual Startup with GM SLP2
9 Runnable Code
Until now you don’t have written one line of C code. And that’s typical for the AUTOSAR concept of soft-
ware development. There is much more configuring work with tools than programming or imple-
menting as you are normally used to from previous ECU software projects with e.g. CANbedded.
Example
This is an example showing the runnable called MySWC_Code with the function name
(Symbol) MySWC_Code
This is the header of a runnable showing all necessary information about the runnable like:
> When it is triggered
> Input and output interfaces
> Service interfaces
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 117-

---

9 Runnable Code
User Manual Startup with GM SLP2
Note
If some access is missing, go back to the DaVinci Developer, add the necessary port
access for your runnable, go back to DaVinci Configurator Pro, synchronize the system
description and generate the component templates again.
Then the missing interface should be there and can be used.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 118-

---

10 Compile and Link
User Manual Startup with GM SLP2
10 Compile And Link
10.0.1 Using your "real" hardware
This step is highly dependent on your compiler / linker / project settings. Compile and link everything
together and create a file that can downloaded to your hardware.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 119-

---

III Additional Information
User Manual Startup with GM SLP2
III Additional Information
This section includes additional information dealing with special topics like e.g. multiple user concept
or support request package.
> Update Input File
> Update Project Settings
> Support Request via DaVinci Configurator
> Multiple User Concept
> Update Configuration
> Update DaVinci Tools
> Non-Volatile Memory Block
> CANoe osCANLibrary
> Basic Software Modules
> Command Line Parameters of the DaVinci Configurator
> Variant Handling
> Add Module Stubs from AUTOSAR definition
> TCP/IP stack migration of projects based on MICROSAR R11 and earlier (due to FEAT-261)
> SIP Update
> Platform Types
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 120-

---

1 Update Input Files
User Manual Startup with GM SLP2
1 Update Input Files
Open Input Files editor via Project | Input Files or Input Files icon
at DaVinci Configurator
Pro toolbar.
Note
Any change of the input files requires an update of the configuration. Update configuration
updates all input files, whether they are changed or not.
1.1 System Description Files
If necessary, replace your File at Input Files | System Description File.
Select the Input File, click Replace button
and choose the new Input File.
Note
Any change of the input files requires an update of the configuration. Update the con-
figuration via Update Configuration icon
.
1.2 Diagnostic Data Files
If necessary, update your Diagnostic Description file and select ECU and Variant.
In case of ODX 2.0.1 as Diagnostic Description file, it is necessary to update the state description.
Therefore click [Synchronize State Description…].
Note
Any change of the input files requires an update of the configuration. Update the con-
figuration via Update Configuration icon
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 121-

---

2 Update Project Settings
User Manual Startup with GM SLP2
2 Update Project Settings
Open Project Settings Editor via Project | Settings or Project Setting icon
at DaVinci
Configurator Pro toolbar. Select Project Settings to open the view.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 122-

---

3 Support Request via DaVinci Configurator Pro
User Manual Startup with GM SLP2
3 Support Request Via DaVinci Configurator Pro
If you request support for Vector products, you have to provide project and environment information.
Therefore, use the Support Request Package function of the DaVinci Configurator Pro.
The Support Request Package compiles the necessary project and environment information in a
ZIP-file. Send this file to the Vector Support via E-mail. Just follow the description below.
Note
The DaVinci Configurator Pro does not send any data automatically!
1. Open the Support Request Editor via Help | Create Support Request Package…
Note
The entry Create Support Request Package… is only enabled if a project is loaded.
2. Add your First Name, Last Name and E-Mail address.
3. Click [Next >]
4. Select project information which has to be added to the support request ZIP-file.
Note
PC Info, Tool Version Info and SIP Info are default and can not be deselected.
5. Click [Next >]
6. Enter the path where the created ZIP-file has to be stored.
7. Click [Finish]
3.1 Result
In addition to the Zip-File
, the Project Assistant creates the following folders and
files.
Folder/File
Description
The Project folder includes all defined project files
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 123-

---

3 Support Request via DaVinci Configurator Pro
User Manual Startup with GM SLP2
Folder/File
Description
The file includes all necessary project and system inform-
ation (e.g. version of tools)
The file includes all necessary project and system inform-
ation (e.g. version of tools)
Send <Target Path>.zip via e-mail to the Vector Support Address embed-
dedSupport@de.vector.com.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 124-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
4 Multiple User Concept
This concept helps you to realize the configuration management of the design and configuration data
on a fine-grained level in combination with a configuration management (CM) system. It is available
for software components as well as for BSW configurations. Split files also help you in multi-user pro-
jects: you can control the read/write access on fine-grained level. This helps you to prevent the users
from making unwanted changes and therefore reduce the necessary diffs and merges.
4.1 General
The decision whether to use a single configuration file or split configuration files is done in the Project
Assistant settings. The resulting split files are ideally managed through a central CM system. Each user
needs the full set of split files to work with the project.
The user has to obtain a rateable working copy to his local file system.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 125-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
The user has to obtain a read-only working copy to his local file system.
Caution!
After a SIP update, all configuration files may have to be updated. This requires all files to
be rateable while loading the configuration with a new SIP for the first time.
It is necessary to lock all files which will be edited during the configuration session. The DaVinci tools
load all working copy files. The locked files are rateable; all other files are write-protected.
Note
If you prevent parallel editing e.g. by according settings in the CM system you can ensure
that only one user can obtain a writable copy at a time. If you allow parallel editing in the
CM system, several users can get a rateable copy. When both users make changes, you
can use the Project Merge function to merge the modifications.
After finishing configuration, the locked files have to be checked in (commited) to the CM system.
4.2 Split Files for Software Component and ECU Project Configuration
The split of the DaVinci Developer workspace is necessary to enable working in parallel for soft-
ware component configuration.
Note
Workspace splitting is only supported by the DCF workspace format.
Result
Additionally to the workflow file the Project Assistant creates multiple files for each Software Com-
ponent Type and ECU Project in the Developer folder.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 126-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
File
Description
This file includes references to all single software component and
ECU Project files.
General software component file
This file includes the binary part of the software component.
This file includes the generic attributes of the software component.
General ECU project file
This file includes the binary part of the ECU Project.
Project-specific ECUC file
This file includes the generic attributes of the ECU Project.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 127-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
4.3 Configure Software Component Prototype
To configure a software component prototype it is necessary to lock all files, specific for this software
component. (<SWCNameA>.arxml, <SWCNameA>.dcb and <SWCNameA>_gen_attr.xml).
4.4 Configure ECU project
To configure an ECU project it is necessary to lock all files, specific for this ECU project. (<ECUPro-
jectA>.arxml, < ECUProjectA >.dcb, <ECUProjectA>_ecuc.arxml and <ECUProjectA>_
gen_attr.xml).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 128-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
4.5 Split Files in DaVinci Developer
Note
Parameters of write-protected files are greyed out in the DaVinci Developer.
If Parameters of write-protected modules are changed because of module dependencies, the DaVinci
Developer informs about the write-protection during the synchronization process.
You have the possibility to make the file rateable and repeat the synchronization process.
4.6 Split Files for BSW Configuration
The split of the ECUC is necessary to enable working in parallel for BSW configuration (one file per
module).
Note
Please note that further .arxml files are created when activating further modules.
Result
Additionally to the standard ECUC files and the AUTOSAR parameter definition file, the Project Assist-
ant creates multiple ECUC files <ProjectName>_<Module>_ecuc.arxml to the ECUC folder.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 129-

---

4 Multiple User Concept
User Manual Startup with GM SLP2
Note
Additionally to the module ECUC files the Project Assistant creates a <ProjectName>_
EcuC.ecuc.arxml file, containing references to all module ECUC files. This file is used as
project file for the DaVinci Developer and the DaVinci Configurator Pro.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 130-

---

5 Configuration Update
User Manual Startup with GM SLP2
5 Configuration Update
If you get a new delivery with Vector BSW Release x, it is necessary to update some parameter values
of your configuration to the new release. There are some steps, that are necessary for most of the
updates and there are special steps, that are only necessary for a certain update.
First there are described the necessary steps for any update followed by the special update steps
dependent on the release version.
5.1 Release x-1 to Release x (necessary steps for any update)
1. Install the latest DaVinci Developer
2. Open your configuration with the DaVinci Configurator of the new SIP .\DaVin-
ciConfigurator\Core\DaVinciCFG.exe and select the following option:
Note
The path within the *.DPA file will be updated to the new SIP.
3. Change the path to the new DaVinci Developer if it was installed to a different location than the
former DaVinci Developer version.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 131-

---

5 Configuration Update
User Manual Startup with GM SLP2
Note
C:\Program Files (x86)\Vector DaVinci Developer <version>\Bin\DaVinciDEV.exe
4. Click Solve All button
5. Handle remaining errors and warning. The following might occur for any update
Errors Invalide/Incorrect Definitions
> AR-ECUC02008 Invalid multiplicity
> AR-ECUC03019 Incorrect definition of configuration element
Solution
Delete parameter in ECUC file not existing in BSWMD file any more.
Example
Some parameters has been replaced. E.g.
/MICROSAR/Dem/DemGeneral/DemEventStorageTrigger has been
replaced by /MICROSAR/Dem/DemGen-
eral/DemEventMemoryEntryStorageTrigger
Errors Inconsistent Connector Prototypes
> RTE51027 Connector prototype inconsistent. (1 message)
> RTE51031 Connector prototype inconsistent. (1 message)
Solution
Due to changes within the Service Components the ports can be become incom-
patible Application Software Components. Adapt your Application Software Com-
ponents with the DaVinci Developer to match the new port definitions.
The changes are normally resulting from
> Correction (the old definition was wrong)
> Changed implementation based on AUTOSAR Bugzilla entries / RfC
> Changed implementation due to support of newer AUTOSAR Version (e.g.
AUTOSAR 4.0.3 to AUTOSAR 4.1.2)
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 132-

---

5 Configuration Update
User Manual Startup with GM SLP2
6. Process all further Errors and Warnings given within the Validation View of the DaVinci
Configurator
7. Check for updating of the input data base files.
Even though they might not have changed, the deriving of parameters might have improved. Thus
an update now would reduce the changes when receiving changed input data base files.
Cross Reference
Additional information about necessary configuration update steps are described within the
Release Notes (Category: Change).
The following describes what to do when updating especially from one release to another.
5.2 Release 8 to Release 9
Errors Invalid Baud Rate
> CAN02012 An invalid baud rate value is configured
> CAN02012 invalid baudrate settings:
[MANUAL ACTION]: change clock or baudrate.
/ActiveEcuC/Can/CanConfigSet/CT_CAN_e98c47e6/CanControllerBaudrateConfig
Solution
The tool now checks the values of the baud rate configuration, they might
have been wrong before.
Check valid settings of McuClockReferencePointFrequency referenced by
/MICROSAR/Can_Cano-
eemuCanoe/Can/CanConfigSet/CanController/CanCpuClockRef
Then select one of the offered baud rate configurations by clicking on ‘pos-
sible configurations’.
5.3 Release 7 to Release 8
If you get a new delivery with Vector BSW Release 8, it is necessary to update some parameter values
of your configuration to the new release.
After you have updated your project with the new SIP the following steps are necessary:
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 133-

---

5 Configuration Update
User Manual Startup with GM SLP2
1. Select ECUC parameter which is not defined by a BSWMD Parameter definition.
(Error number AR-ECUC03019)
2. Check whether additional parameters exist.
(Parameters without value definition or with default value)
3. Define value of the new parameter with value from the existing parameter
4. Delete existing parameter
Use the same steps for container updates.
Note
Select all VectorCommonData containers, which are marked with an error, use multi-
selection in the DaVinci Configurator Basic Editor and delete them via Delete Container.
All Use RTE switches and Production Error Detection switches can be deleted without
check.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 134-

---

6 Update DaVinci Tools
User Manual Startup with GM SLP2
6 Update DaVinci Tools
Cross Reference
The DaVinci service packs are located at the Vector Download Center.
https://vector.com/vi_downloadcenter_en.html
The Update of the DaVinci Tools is described within the installation guide.
Cross Reference
You will find the installation guide document at the Vector Knowledge Base:
https://vector.com/kbp/entry/640/
6.1 DaVinci Configurator Pro
If necessary , update DaVinci Configurator Pro service packs, therefore you have to download them
from the Vector Download Center and install them via DaVinci Configuration Service Pack Installer.
Select the installed SIPs which should be updated.
6.2 DaVinci Developer
Service Packs of DaVinci Developer are also available in the Vector Download Center. The service
packs include an installer to update your DaVinci Developer installation.
Note
Please note that compatibility is only granted for service packs provided for the same
major and minor version.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 135-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
7 Non-Volatile Memory Block
This is a description how to handle data that has to be stored to non-volatile memory like FLASH or
EEPROM.
The illustration below shows briefly the concept behind. Data is defined in a Non-Volatile Memory
Block. The application SWC has access to this data via the RTE. The data is stored and addressed in
RAM. At configuration time you can define which data in which format you need and when and how this
data is written to and read from the non-volatile memory. You can also trigger the immediate writing
of this data to the FLS or EEPROM.
7.1 Configure and use Non-Volatile Memory Block
The following description shows, how the Non-Volatile Memory Block is configured and used.
In the Library of DaVinci Developer, add a New Application Component Type, select Non-Volatile
Memory Block as type and give a Name to this new component type. Double-click the new Non-
Volative Memory Block in the Library and select NV Block Descriptors
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 136-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
Use [New] to define a new NV Block Descriptor. On the Properties tab define the data you want to
store to non-volatile memory and its type. This can be a single variable like integer or boolean. Also
complex data types like records or arrays can be defined.
Select the tab NV Block Need and define, when and how your data should be finally written to NV
memory (FLS or EEPROM).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 137-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
Now add New NV Data Interface… to define a port to access the data defined before. Select suitable
Data Element Prototypes.
Add the NV component type to your Software Design (drag’n’drop from Library), assign the NV Data
Interface to the NV component prototype and another NV Data Interface to your application SWC.
Draw the necessary connectors by hand. Define the Init Values of all ports.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 138-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
Double-click NV component prototype and perform the internal mapping on the NV Block Data Mapping
tab (right-click to open context menu).
7.2 Port Access of your Runnables
What is left now – the access of your application runnable to the NV Data Interface(s). Open your
application software component, select a runnable and then the tab Port Access. Use the [New] but-
ton to add a read or write data access to the Non-Volatile Memory Block.
Save your project and switch to DaVinci Configurator Pro.
7.3 Memory Mapping in DaVinci Configurator Pro
Synchronize the system using the synchronization message in the Validation area.
Open Runtime System. Click Add Memory Mapping.
1. Select Create new NV memory blocks for the memory objects.
2. Select the block created before in the DaVinci Developer
3. Get information about unmapped blocks and click [Finish].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 139-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 140-

---

7 Non-Volatile Memory Block
User Manual Startup with GM SLP2
7.4 Validate the RTE
1. Open the validation window via
2. Deactivate all boxes via
3. Select RTE and click [Validate].
When implementing you runnable code, you can now access the defined variables by using RTE read
and write macros.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 141-

---

8 CANoe osCAN Library
User Manual Startup with GM SLP2
8 CANoe OsCAN Library
8.1 Emulate your project with CANoe
You can use CANoe and the CANoe osCAN Library to simulate your project without any hardware but
your PC.
Make sure your project includes all files from:
> the BSW delivery (CAN, CANIF, CANNM, OS… )
> The configuration files of GENy
> The configuration files of DaVinci Configurator Pro
> The generated RTE (RTE_DEV)
> And the folder sources with the component templates filled with your code.
All generated code has to be compiled and linked
Right click your project and select Properties. Then click Debugging and fill in the following inform-
ation:
> Give the path to your CANoe in the Command line
> Select the CANoe project, here demo.cfg as Command Argument
> Set the Working Directory to ..\CANoe (i.e. to the path, where your demo.cfg is located)
> Set the Debugger Type to Native Only
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 142-

---

8 CANoe osCAN Library
User Manual Startup with GM SLP2
Now you can start the simulation via <F5>.
You can run your ECU together with other ECUs, programmed like this one and represented as DLL or
as remaining bus simulation. You can debug the system using breakpoints in Microsoft Visual Studio™.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 143-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
9 Basic Software Modules
This chapter deals with BSW modules, Basic Software Modules. First they are introduced theoretically
then configured with the DaVinci Configurator Pro.
9.1 Generic BSW Modules
Before you start to configure the BSW module with DaVinci Configurator Pro you have to know some-
thing about BSW modules.
This chapter introduces to you a generic BSW module and wants you to get a basic understanding of it:
> How it looks like
> Of what it is formed
> How it is configured
> How it works
> What is fix
> What is generated and
some special topics like
> Memory sections and
> Exclusive areas
Cross Reference
Find the detailed description of the BSW module in the folder Doc|TechnicalReferences
of your delivery.
9.2 What is a BSW Module?
A Basis Software Module (BSW module) consists of:
> Static BSW files (algorithms and functions)
> Generated files (data and sometime algorithms and functions)
To get it to work it has to be
> Included
> Initialized
> Its main function has to be called cyclically (in most of the cases)
The mapping of its code and variables can be configured as well as their exclusive areas, to protect the
module’s internal data.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 144-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
> Memory Mapping
> Exclusive Areas
Example
Examples for the short names: DEM, DCM, ECUM, etc.
9.3 What Forms a BSW Module? 
A BSW module is specified via its implementation files (<Msn>.c, <Msn>.h). They define the basic func-
tionality of the BSW module.
9.4 BSW Module Configuration
The amount and properties of configurable parameters is defined within the <Msn>.bswmd file.
BSWMD stands for Basic Software Module Description file. This file is read by the BSW configuration
tool (DaVinci Configurator Pro) and used to create the Basic Editor. The Basic Editor is the tool expres-
sion of all configurable parameters of the BSW module, displayed in a generic way.
Note
In addition to the Basic Editor, the Vector BSW configuration tool DaVinci Configurator Pro
provides comfortable views that make configuration of BSW modules very comfortable.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 145-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
The DaVinci Configurator Pro generates the configuration files for every used BSW module. These are
files like
> <Msn>_cfg.c/h,
> <Msn>_Lcfg.c/h,
> <Msn>_PBcfg.c/h
9.5 BSW Initialization
9.5.1 <Msn>_InitMemory()
Most BSW module needs variables that have to be initialized before the call of <Msn>_Init(). This can
be global or static variables. According AUTSOAR concept, all necessary variables will be initialized by
the start-up code. Where this is not done or not possible the function <MSN>_InitMemory has to be
called as an alternative.
9.5.2 <Msn>_Init()
Every BSW module has to be initialized at start-up. This is done with the start-up of the ECUM. The
function to initialize a BSW module is called: <Msn>_Init()
Note
Our modules and functions are protected against multiple initializations.
9.6 BSW Module Version (xxx_GetVersionInfo)
Each BSW module provides an API <MSN>_GetVersionInfo.This API returns the BSW published
information
> BSW version
> Module ID
> Vendor ID
The BSW versions are BCD-coded. The availability of this API can be individually configured for each
module.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 146-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
9.7 Cyclic Calls
9.7.1 <Msn>_MainFunction()
To run and to work, most of the BSW modules (except for those, that are triggered by interrupt), have
to be called cyclically with a configured call cycle. The module derives its time base from those cyclic
calls. This cyclically called function is called main function and its name is formed like: <MSN>_
MainFunction()
Note
In most of the cases it is mapped to a cyclic task that is called cyclically triggered by an
Alarm of the Operating System.
9.8 Service Functions
9.8.1 Client Server Theory
Besides the sender and receiver ports, there are also client and server ports. Sender and
receiver ports carry data elements, via client ports, you can access so-called operations
(or functions) of the servers.
The client uses a service of the server. The server itself provides the operation.
The client server communication between your application software component and a service com-
ponent is done via service ports – client ports and server ports. A server port provides services (one
or more operations) and a client port uses these services. A service component can have server ports
and client ports.
> Service port of the service component is a server port
The service is provided by the service component and your application software component just
uses the operations (services, functions)
> Service port of the service component is a client port
Your application software component must be server and has to provide the operation (service,
function). In this case, you have to program code, i.e. a runnable. This runnable must be created
by you and it is triggered by the request of the service.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 147-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
Within one service port there could be n operations. Every single operation has to be assigned to a run-
nable.
The servers provide the runnables that contain the code. That is Runnable1, Runnable 2, Runnable 3 of
service component and Runnable 4 and Runnable 5 of application component.
9.9 Critical Sections - Exclusive Areas
BSW modules use so-called exclusive areas to protect their resources (module internal data) from con-
currency. Each module defines its own exclusive areas, up to 5 can be defined per AUTOSAR definition.
Whether a critical section needs to be handled or not depends on the possibility of a concurrent access
onto a given resource of the BSW. It therefore depends on e.g. OS or hardware configuration con-
straints. If a critical section needs to be handled, different measurements are possible, ranging from a
global interrupt lock to the usage of OS semaphores.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 148-

---

9 Basic Software Modules
User Manual Startup with GM SLP2
Example
As an example, a definition of an exclusive area could look like:
SchM_Enter_Com_COM_EXCLUSIVE_AREA_2();
com_TxModeHdlr_DelayTimeCnt[i]--; /* Protected object */
SchM_Exit_Com_COM_EXCLUSIVE_AREA_2();
There are different locks available i.e. different interrupt sources could be locked. Global interrupt,
peripheral interrupt like CAN or no lock at all.
Cross Reference
Refer to the technical reference document of the BSW module to get information how
exclusive areas are defined and used.
9.9.1 Memory Section
Every generated code and variable of the <MSN> modules is enclosed by #defines. Via the template
file compiler_memMap.h you can define the mapping of each single section of a <MSN> module.
Cross Reference
See more about the memory mapping via memMap.h in the technical references of each
<MSN> module.
9.9.2 Switch <MSN> Modules Off
Most of the modules can be switched off via: <Msn>_Shutdown
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 149-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
10 Command Line Parameters Of The DaVinci Configurator
10.1 Common parameters
Option
Arguments
Mandatory
Description
-h, --help
-
no
Shows command line usage inform-
ation (use cases and available
options).
--verbose
n
no
Enables the verbose output of log-
<ERROR>
ging messages.
<WARN> <INFO>
Possible arguments: ERROR, WARN,
INFO Optional Argument: The Log-
Level for the verbose output.
Default: ERROR
-l, --logfile
1
yes
Set the file to log the Console output
into.
Mandatory parameters missing. Please choose a use case. E.g. specify a Project and --generate to
generate the Project.
10.2 Command Line Interface Use Cases
The DaVinci Configurator command line interface has different use cases:
10.3 Usecase With GUI (only DaVinciCFG.exe)
Opening the GUI is the default use case.
Option
Arguments
Mandatory
Description
-p, --project
1
no
Specifies the absolute
<DPA-FILE>
path to the DPA project
file to be opened in the
GUI immediately
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 150-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
10.4 Use Case DaVinci Configurator CodeGenerator
The identifying option for this use case is -g.
The DaVinci Configurator generates the BSW modules for a given ECU project.
Usage Example
DVCfgCmd --project Project.dpa --generate
DVCfgCmd --project Project.ecuc.arxml --generate --modulesToGenerate "/MICROSAR/Det
Option
Arguments
Mandatory
Description
-p, --project
1
yes
Specifies the absolute path to the DPA pro-
<DPA-FILE>
ject file or the ECUC
-g, --generate or -v
-
yes
Generate the given project specified in
if-v is not
<DPA_FILE>. The -g option also executes -
used
-validate
At least one of the options -g or -v must be
specified.
-v, --validate or -g
-
yes
Validate the given project specified in
if-g is not
<DPA_FILE>.
used
At least one of the options -g or -v must be
specified.
-m, --mod-
1
no
Specifies the module definition references,
ulesToGenerate
which should be generated by the -g
switch.
Separate multiple the modules by a ','.
Syntax: --modulesToGenerate "<iden-
tifier>,<identifier> ..." The identifier of a
module is the AUTOSAR Definition path.
E.g. /MICROSAR/Nm, /MICROSAR/CanIf --
modulesToGenerate
"/MICROSAR/Nm,/MICROSAR/CanIf".
You could also pass the shortname of the
module, like "Rte", but be aware, if mul-
tiple modules have the same shortname,
all modules will be generated!
-x, --modulesToExclude
1
no
Specifies the module definition references,
which should not be generated by the -g
switch.
Separate multiple the modules by a ','.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 151-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
Option
Arguments
Mandatory
Description
Syntax: --modulesToExclude "<iden-
tifier>,<identifier> ..." The identifier of a
module is the AUTOSAR Definition path.
E.g. /MICROSAR/Nm, /MICROSAR/CanIf --
modulesToExclude
"/MICROSAR/Nm,/MICROSAR/CanIf"
You could also pass the shortname of the
module, like "Rte", but be aware, if mul-
tiple modules have the same shortname,
all modules will be excluded!
--extGenStepsToGen-
1
no
Specifies the External Generation Steps,
erate
<GEN_
which should be generated by the -g
STEPS>
switch.
If empty (""), then no External Generation
Steps is executed.
Syntax: --extGenStepsToGenerate "<iden-
tifier>,<identifier> ..."
The identifier of a step is the step name.
Separate multiple steps by a ','. E.g.
MyStep,DioExtStep,SwcGenStep --
extGenStepsToGenerate "DioEx-
tStep,SwcGenStep"
--genArg
n
no
Passes arguments to the specified code gen-
<GEN_
erators.
ARGS>
Syntax --genArg <DEFINTION>:<Ar-
gument> or --genAr-
g="<DEFINTION>:<Argument>"
The Definition is the AUTOSAR Definition
path of the module to generate. E.g.
/MICROSAR/Nm, /MICROSAR/CanIf
You could also pass the shortname of the
module, like "Rte", but be aware, if mul-
tiple modules have the same shortname,
all modules will get the argument!
You can pass multiple --genArg para-
meters. E.g. --genArg
/MICROSAR/Nm:DoSomethingSpecial=true
--genArg="Rte:DoAnotherThing=true"
Multiple arguments for one definition can
be passed in one --genArg argument or in
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 152-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
Option
Arguments
Mandatory
Description
several.
If several --genArgs are used for the same
definition, the values are concatenated
with a blank as separator. E.g. --genArg
/MICROSAR/Nm:Arg1=true Arg2=false or -
-genArg /MICROSAR/Nm:Arg1=true --
genArg /MICROSAR/Nm:Arg2=false
--saveProject
-
no
Saves the project after validation or gen-
eration.
Generators may modify the project in the
calculation phase before the actual gen-
eration has started. This option will persist
these modifications.
--syn-
-
no
Performs the synchronization of the Sys-
cSystemDescription
tem Description after loading the project.
This might modify the project, so please
consider also the usage of the --savePro-
ject option.
--genType 
1
no
Specifies the generation process type
<GEN_
(""NORMAL"" => Real Target or ""VTT""
TYPE>
=> vVIRTUALtarget) Syntax: --genType
<GEN_TYPE> E.g. NORMAL
If no --genType is set, the default depends
on the <TargetType>-setting from dpa file.
The options --generate and --validate are mutual exclusive but one of them has to be specified.
10.5 Use Case DaVinci Configurator Execute Converter
The identifying option for this use case is -g.
The DaVinci Configurator converts the ECU configuration.
Usage Example
DVCfgCmd --project Project.dpa --convert
DVCfgCmd --project Project.ecuc.arxml --convert
Option
Arguments
Mandatory
Description
-p, --project
1
yes
Specifies the absolute path to the DPA project
<DPA-FILE>
file or the ECUC file.
-c, --convert
-
yes
Convert the given project specified in <DPA-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 153-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
Option
Arguments
Mandatory
Description
FILE>.
--convertArg
n
no
Passes arguments to the specified converter.
<CONVERT_
Syntax: --con-
ARGS>
vertArg=""<NAMESPACE>:<Argument>"".
The Namespace is the namespace defined by
the converter
10.6 Use Case BaseEcucGenerator (create initial empty project, without GUI)
The identifying option for this use case is -d.
Usage Example
DVCfgCmd -d D:\TEMP\MyProj -n MyProject --derivative Canoeemu
Option
Arguments
Mandatory
Description
-d, --projectDir
1
yes
The directory, the new pro-
<DIR>
ject shall be stored in
-n, --projectName
1
yes
The project name and name
<NAME>
of generated EcuC files
--derivative
1
yes
The derivative name
<DERIVATIVE>
--splitProject
-
no
Generates a project using
one file per module con-
figuration
--ecucGenArg
n
no
Passes additional arguments
<ECUC_ARGS>
to the BaseEcucGenerator.
Syntax: --ecucGenArgs
"<EcucOption>=<Value>" or
--genArg="<Ecuc
You can pass multiple --
ecucGenArgs parameters.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 154-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
10.7 Use Case EcucUpdater (without GUI)
The identifying option for this use case is -u.
Usage Example
DVCfgCmd -u D:\TEMP\MyProj\MyProject.dpa -e D:\SysExtract.arxml
Option
Arguments
Mandatory
Description
-u, --updateProject
1
yes
The DPA file of the project which
<DPA-FILE>
shall be updated
-e, --extract
1
no
The system extract file
<FILE>
--odx
4
no
Path to ODX file, ODX ECU, ODX
<ODX-FILE>
VARIANT, CSV file path
<ECU>
<VARIANT> <CSV-
FILE>
--cdd
2
no
Path to CDD file, CDD VARIANT
<CDD-FILE>
<VARIANT>
--onlyEcuc
-
no
If no argument is passed, the com-
plete update is performed (including
DaVinci Developer workspace). If --
onlyEcuc is set, only ECUC is
updated, without the DaVinci
Developer workspace.
--ecucGenArg
n
no
Passes additional arguments to the
<ECUC_ARGS>
BaseEcucGenerator. See
BaseEcucGenerator usecase for addi-
tional information.
The options --cdd and --odx are mutual exclusive.
At least one of --cdd, --odx and --extract must be specified.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 155-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
10.8 Use Case DaVinci Configurator Exporter (without GUI)
The identifying option for this use case is --exportDir.
The DaVinci Configurator exports different types of AUTOSAR arxml files. For example files per vari-
ant in a variant project.
Usage Example
DVCfgCmd --project Project.dpa --exportDir ./exportDir --exportPostbuildVariants
Option
Arguments
Mandatory
Description
-p, --project
1
yes
Specifies the absolute path
<DPA-File>
to the DPA project file
--exportDir
1
yes
Specifies the directory to
<DIR>
export the data into.
--exportPostbuildVariants
-
yes
Export the Post-build vari-
ants into.
This will export the Active-
Ecuc and miscellaneous
data
- Active Ecuc export into
one file (even for split
DPA-projects) per variant
<project-name>.<variant-
name>.ecuc.arxml
- Miscellaneous data into
one file per variant.
The files contain all data of
the project except:
* ModuleConfigurations,
ModuleDefinitions
* BswImplementations,
EcuConfigurations
* Variant information like
EvaluatedVariantSet
<project-name>.<variant-
name>.misc.arxml
--listAvailableExporterIds
-
no
--exportWithExporterId
1
no
Exports the loaded project
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 156-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
Option
Arguments
Mandatory
Description
<EXPORTER_ID>
with the selected exporter.
This will create a file
named Exported_
<EXPORTER_ID>.arxml in
the folder specified by --
exportDir.
An <EXPORTER_ID> could
be retrieved with the --
listAvailableExporterIds
argument.
All options starting with --export (except --exportDir) are mutual exclusive.
At least one --export option or --listAvailableExporterIds must be specified.
10.9 Use Case DaVinci Configurator Sign Script
The DaVinci Configurator creates a signature for workflow scripts.
Usage Example
DVCfgCmd --sign MyScript.py
Option
Arguments
Mandatory
Description
--sign
1
yes
Specifies the script file so sign.
<SCRIPT_FILE>
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 157-

---

10 Command Line Parameters of the DaVinci Configurator
User Manual Startup with GM SLP2
10.10 Return Codes
Name
Integer-Value
Description
EXIT_OK
0
ALL_OK in BaseEcuC,
Updater and Gen: Con-
figuration loaded
without errors, gen-
erated without errors.
EXIT_NOT_OK
1
Exit object indicating
abnormal termination
EXIT_NO_WORKSPACE_PATH
2
Indicating no work-
space path
EXIT_NO_ACTION
3
Indicating no action
specified
EXIT_INVALID_SIP
4
Configuration could not
be opened.
EXIT_NO_PARAMETERS
5
Indicating missing
parameters
EXIT_INVALID_COMMANDLINE_ARGS
6
Invalid generation
paths.
EXIT_UNHANDLED_EXCEPTION
7
Unexpected error
occured.
EXIT_BASE_ECUC_GENEARTOR_
10
ERROR
EXIT_UPDATER_ERROR
11
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 158-

---

11 Variant Handling
User Manual Startup with GM SLP2
11 Variant Handling
11.1 Define Criterion and Variants
If you use variant handling within your project you have to define your variants first.
After you setup your project, open the Project Settings Editor via settings icon
and select
Variants.
Select the Edit Variance icon
to add criterion, define criterion values and map criterion values to
variants.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 159-

---

11 Variant Handling
User Manual Startup with GM SLP2
1. Add [+] new Criterion.
Note
The DaVinci Configurator Pro is currently limited to a single criterion. This criterion can be
used for diagnostic and communication variance.
2. Add [+] one criterion value for each variant.
3. Go on with [Next >]
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 160-

---

11 Variant Handling
User Manual Startup with GM SLP2
4. Add [+] your Variants
5. Define Criteria Value for your Variants
6. Go on with [Next>] to see a summary of your definitions or [Finish] to come back to Variants
view.
After finishing variant definition, the tool enters to PENDING UPDATE project state.
Note
The DaVinci Configurator Pro is currently limited to a single criterion. This criterion can be
used for diagnostic and communication variance.
11.2 Add and Assign Input Files to Variants
Open Input Files editor via Project | Input Files or use the input file button
of DaVinci
Configurator Pro toolbar.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 161-

---

11 Variant Handling
User Manual Startup with GM SLP2
Select System Description Files and add your Input Files via Add File Sets icon
. The Add File
Set Assistant opens.
Note
The following step is necessary for each variant.
Select the Post-Build Criterion Value (Variant) your input file will be valid and go on with [Next
>]. Add [+] your input file(s), select your ECU Instance and confirm with [Finish].
After adding and assigning your input files our project is still in PENDING UPDATE state.
Select Update the configuration now to commit the project modifications to start update pro-
cess.
Cross Reference
What happens while Update Process? See section STEP2 Define Project Settings on page
28.
11.3 Define Variance for BSW Modules
Open Project Settings Editor via Project | Project Settings or use project settings icon
at
DaVinci Configurator Pro toolbar.
Select Modules to see all modules currently activated for your project.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 162-

---

11 Variant Handling
User Manual Startup with GM SLP2
For each BSW module define if it supports variance or not. Therefore choose Implementation Vari-
ant.
> VARIANT-POST-BUILD-SELECTABLE
No post-build loadable update of the configuration at post-build time. All variants are configured at
pre-compile time.
> VARIANT-POST-BUILD-LOADABLE-SELECTABLE
post-build loadable update of the configuration data is supported using MICROSAR Post-Build Load-
able. This feature required dedicated licensing.
Note
Multi selection is possible within module view of the DaVinci Configurator Pro, this enables
you to set variance for several BSW modules at the same time.
11.4 Configure and Validate BSW
The DaVinci Configurator Pro highlights variant parameter and container using a brown
. When chan-
ging the configuration it has to be considered whether the change shall be applied to all variants or if
the change shall be done only for one variant.
Note
You can select your Active Variant at the DaVinci Configurator toolbar.
To define a value for a single variant only, right-click on parameter, select Edit variance and define
variant (Value).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 163-

---

11 Variant Handling
User Manual Startup with GM SLP2
Note
The validation view includes views for each variant.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 164-

---

12 Add Module Stubs from AUTOSAR definition
User Manual Startup with GM SLP2
12 Add Module Stubs From AUTOSAR Definition
In some cases it is necessary to add a module, which is not delivered within your SIP, e.g. a delivered
module (DCM) needs references and interfaces to a not delivered module (NVM), otherwise the val-
idation fails.
To avoid validation and generation errors you have to add the required module according to AUTOSAR
standard definition. Therefore open Project Settings Editor, select Modules and open Modules
Assistant via add [+].
Choose Select from AUTOSAR Standard Definition and go on with [Next], select the required
module and confirm with [Finish].
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 165-

---

12 Add Module Stubs from AUTOSAR definition
User Manual Startup with GM SLP2
Now the module is available at the Basic Editor. The module based on AUTOSAR Standard definition
needs to be configured basically with all necessary definitions required by the MICROSAR modules
within your project.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 166-

---

13 TCP/IP stack migration of projects based on
MICROSAR R11 and earlier (due to FEAT-261)
User Manual Startup with GM SLP2
13 TCP/IP Stack Migration Of Projects Based On MICROSAR R11
And Earlier (due To FEAT-261)
The API between SOAD and TCPIP is now realized according to AUTOSAR 4.2.1.
13.1 SD – Service Discovery
The Service Discovery module delivered with MSR4-R12 is conforming to the AUTOSAR Release 4.2.1.
Due to changes of the configuration containers introduced with this AUTOSAR release, a legacy SD con-
figuration has to be adapted.
Main changes
> Removed possibility to configure a SdEventHandler with the “Auto Available” feature. The cor-
responding parameter can be removed without any impact to the configuration.
> Additional references SdMulticastEventSoConRef and SdConsumedEventGoupMulticastGroupRef.
These references simplify the validation and improve the traceability of the configuration.
> Each SdServerService and SdClientService contains additional references to SoAdSock-
etConnectionGroups (SdClientServiceXxxRef and SdServerServiceXxxRef). These references spe-
cify the UDP and TCP SoAdSocketConnections which shall be used for the communication of the
corresponding service. This implies, that in case of a SdServerService, the entire communication
of the service uses a single SoAdSocketConnectionGroup per communication protocol. The pre-
viously required additional SoAdSocketConnectionGroup to support provided methods can be
removed.
> The legacy SdClientServiceXxxRef and SdServerServiceXxxRef within the SdConsumedMethods
and SdProvidedMethods can be removed.
> Changed multiplicity of the SdEventHandlerXxx container. Due to additional APIs and configuration
possibilities within the SoAd module, the configuration of the SdEventHandler is simplified. In con-
trast to the legacy configuration, each SdEventHandler requires exactly one SoAdRoutingGroup per
communication protocol in order to enable and disable the transmission-paths of the corresponding
SomeIp messages. The configuration of independent SoAdRoutingGroups per used SoAdSock-
etConnection is not required anymore.
13.2 TCPIP - Transmission Control Protocol / Internet Protocol
The API of the module TCPIP has been adapted to be conform to AUTOSAR release 4.2.1. Also the con-
figuration interface between TCPIP and its upper layer (e.g. SOAD) has been adapted.
Main changes
> Sockets are not preconfigured to be used for a specific user or port / network-address combination
anymore. The sockets now have to be requested and bound during runtime, and rx and tx buffers
have to be requested (via TcpIp_ChangeParameter) before they can be used.
> TCPIP now implements the socket users according to AUTOSAR 4.2.1. In earlier AUTOSAR version
the only user of TCPIP has been the SOAD, while the Vector implementation of TCPIP always sup-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 167-

---

13 TCP/IP stack migration of projects based on
MICROSAR R11 and earlier (due to FEAT-261)
User Manual Startup with GM SLP2
ported a multi user concept. Socket users are now called socket owners (renamed according to
AUTOSAR)
> TCP server sockets now use a more BSD-like (Berkeley Software Distribution) behavior than
before. To accept multiple connections on one listen socket the maximum number of accepted con-
nections is now configured during runtime when calling TcpIp_TcpListen.
Configuration changes
> Most elements from TcpIpSockUser are transferred to TcpIpSocketOwnerConfig
> All existing TcpIpSockUser containers will be removed during the SIP update
> The new TcpIpSocketOwnerConfig container for the SOAD will be created automatically
> For each additional socket owner a TcpIpSocketOwnerConfig container has to be created manu-
ally
> TcpIpSockConfig is removed, so all old references to socket configurations have to be deleted
> The container TcpIpTcpSocketBuffer is added, here the required tx and rx buffers have to be con-
figured
> The number of listen sockets (server sockets) a socket owner wants to use has to be configured
using the parameter TcpIpSocketOwnerTcpListenSocketMax
13.3 SOAD - Socket Adapter
The API to the lower layer module TCPIP has been adapted to be conform to AUTOSAR release 4.2.1.
Now all sockets and their resources are assigned dynamically at runtime.
Configuration changes
> Container TcpIpSockConfig does not exist anymore. Tx and Rx buffer configuration for a TCP
socket is now located in SoAd. For UDP no adaptions are needed.
> TcpIp/TcpIpConfigSet/TcpIpSockConfig/TcpIpSockTxBufSize gSoAd/SoAdCon-
fig/SoAdSock-
etConnectionGroup/SoAdSocketProtocol/SoAdSocketTcp/SoAdSocketTcpTxBufferMin
> TcpIp/TcpIpConfigSet/TcpIpSockConfig/TcpIpSockRxBufSize g SoAd/SoAdCon-
fig/SoAdSocketConnectionGroup/SoAdSocketTpRxBufferMin
> Ressources for Tx and Rx buffer for TCP sockets are still located in the TcpIp module (container
TcpIpTcpSocketBuffer). It must be ensured that enough buffers with corresponding sizes are con-
figured for all sockets which are active at the same time at runtime. It must exist an exact value
match of the following parameter set:
> TcpIp/TcpIpConfigSet/TcpIpTcpSocketBuffer/TcpIpTcpSocketTxBufferSize n SoAd/SoAdCon-
fig/SoAdSock-
etConnectionGroup/SoAdSocketProtocol/SoAdSocketTcp/SoAdSocketTcpTxBufferMin
> TcpIp/TcpIpConfigSet/TcpIpTcpSocketBuffer/TcpIpTcpSocketRxBufferSize n SoAd/SoAdCon-
fig/SoAdSocketConnectionGroup/SoAdSocketTpRxBufferMin
All other changes and adaptions are done by the configuration tool automatically or additional solving
actions are provided to adapt the configuration manually.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 168-

---

14 SIP Update
User Manual Startup with GM SLP2
14 SIP Update
You received a newer version of your SIP. This requires a update of your current project. Therefore
open the project with the new version of the DaVinci Configurator Pro. The DaVinciCFG.exe is loc-
ated within the folder <UpdateSIP>\DaVinciConfigurator\Core.
The DaVinci Configurator Pro identifies that the project was created with an older SIP and displays the
following message. Select Update the project by opening the project within the SIP of this
DaVinci Configurator instance and click OK.
The update will performed. Wait until the DaVinci Developer project opens. Click [Accept] when the
warning message appears. Click [Import] in the next dialog.
The Signal Import Mode dialog opens, select Use import mode for all remaining objects and click
[OK]. The dialog proposing to Save and close now opens, confirm with [Yes].
The DaVinci Developer project is closed and the update of the DaVinci Configurator Pro project con-
tinues. Once the update finishes click [Ok].
The project is now migrated to the new SIP.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 169-

---

15 Platform Types
User Manual Startup with GM SLP2
15 Platform Types
DaVinci Configurator and DaVinci Developer use from Release 12 on a common definition of Platform
Types as defined by AUTOSAR. These types are defined in the package defined by AUTOSAR:
/AUTOSAR_Platform/.
15.1 Location of the common definition
The /Config folder of the project contains a new folder named /AUTOSAR
This folder contains the file PlatformTypes_AR4.arxml, which defines the AUTOSAR Platform
Types. This file is shared between DaVinci Configurator project and DaVinci Developer project. This
file shall not be modified manually.
15.2 Import/Export behavior
DaVinci Configurator and DaVinci Developer provide the definition of the Platform Types as seen
above. That means, the SWCs or Service Components do not have to provide this definition again, but
shall only reference the types via the package defined by AUTOSAR (/AUTOSAR_Platform/).
When a file is imported in the project, the references to the provided Platform Types (via /AUTOSAR_
Platform/ package) are automatically solved by DaVinci Configurator and DaVinci Developer.
In case an imported file contains the definition of a Platform Type already provided by DaVinci
Configurator and DaVinci Developer, this definition is not imported, and the one provided by DaVinci
Configurator and DaVinci Developer is used.
The Export Editor provides a new option Export AUTOSAR package (platform types, …)
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 170-

---

15 Platform Types
User Manual Startup with GM SLP2
When this option is selected, the objects from the /AUTOSAR_Platform/ package are exported from
the target file.
When this option is not selected, the objects from the /AUTOSAR_Platform/ package are not exported,
only the references are exported.
15.3 Service components use the new Platform Types
In the SWC description of the service components generated by DaVinci Configurator, the new Plat-
form Types are used instead of the ones generated in the previous SIP. The old types
15.3.1 Old types
15.3.2 New types
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 171-

---

15 Platform Types
User Manual Startup with GM SLP2
15.4 Replacement of old developer standard types (Replace legacy Data Types)
Standard Types were provided in previous versions of DaVinci Developer projects under the
/DataTypes/PlatformTypes/ package. These standard types are not provided anymore by DaVinci
Developer, but they may remain in the project after migration to the new SIP.
An option is available in DaVinci Developer to replace references to these old types by references to
the new provided Platform Types.
This option is available at Edit | Replace legacy Data Types
By clicking Replace legacy Data Types, the references are replaced.
This option is currently unavailable if the library is selected.
Note
The Data Types within the package /DataTypes/PlatformTypes/ are not removed from the
library. This action can be performed manually.
Example with uint8
> References to /DataTypes/PlatformTypes/uint8 are replaced by /AUTOSAR_Plat-
form/ImplementationDataTypes/uint8
> /DataTypes/PlatformTypes/uint8 is kept in the project.
The same option is available when a file is imported in the project. The Import from XML editor
provides the option Replace legacy Data Types”
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 172-

---

15 Platform Types
User Manual Startup with GM SLP2
When the box is checked, all references to the DataTypes within the /DataTypes/PlatformTypes/ pack-
age are replaced by the corresponding Platform Type from /AUTOSAR_Platform/ package.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 173-

---

16 Frequently Asked Questions
User Manual Startup with GM SLP2
16 Frequently Asked Questions
You have a certain question? You just want to know how to do e.g. a certain setting
without reading the whole document again? Then go on reading the following list and use
the links to get at the place in the document where your question will be answered. This
chapter will be extended continuously.
16.1 Annotations for any parameter
How to append an annotation to a parameter
For almost any parameter you can add individual annotations regardless whether you are in the Basic
Editor or in the Configuration Editor. Open the context menu of a parameter by clicking the little right-
pointing arrow and click Add annotation.
The annotation editor will open. You can enter one or more annotations each with a headline and float-
ing text.
Via Edit annotations you can open and edit an already written annotation.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 174-

---

16 Frequently Asked Questions
User Manual Startup with GM SLP2
To read you annotations you can either open it via the editor or just by touching the little letter icon
with the mouse, its content will be displayed like shown below as an example.
Via a report (Project|Report...) it is possible to see all your annotations. Make sure to activate the
checkbox Include annotations in report
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 175-

---

16 Frequently Asked Questions
User Manual Startup with GM SLP2
16.2 Find Reference Container
16.2.1 How to find references using the [Find] dialog
Open the Find dialog, type in value=="" and give a container name between the apostrophes.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 176-

---

17 Release Notes
User Manual Startup with GM SLP2
17 Release Notes
This section gives an overview of the changes which have been made on the MICROSAR Basic Soft-
ware Modules (BSW) within the last releases.
Listed changes are new features or the extension of existing functionality. Please note that this doc-
ument does not provide a list of fixed issues. Open issues are documented in the issue report doc-
ument IssueReport_<CBD-Number>.pdf, which is part of the deliveries documentation.
This section refers to Vector internal tracking numbers (ESCAN, EVAL tickets and Feature List num-
bers) which uniquely identify the changes.
Please refer also to the Technical References for more information on the changes, modifications or
extensions.
Changes to DaVinci Configurator Pro and DaVinci Developer are documented in Release Notes
provided along with the tools.
17.1 Release 12
17.1.1 Breaking Changes
Modification of existing functionality or APIs that can have an impact on existing applications (such as
SWCs, CDDs …).
Change ID
Affected Modules
Description
FEAT-254
DaVinci Configurator Pro 5
The location of the VTT (formerly VIP) modules
has changed in the SIP. They are now located in
MCAL
BSW\Vtt_<ShortName>.
Impact on existing projects:
The VTT environment that includes the VTT
source and header files will have to be recreated
or adapted in order to match the new naming con-
vention.
Old: BSW\Vip_<ShortName>
New: BSW\Vtt_<ShortName>
Beta Implementation. This feature shall
not be used for production.
FEAT-261
Base EcuC Converter
The API between SOAD and TCPIP is now real-
ized according to AUTOSAR 4.2.1.
SOAD
TCPIP
Impact on existing projects:
Please follow the instructions given in the fol-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 177-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
lowing chapter TCP/IP stack migration of pro-
jects based on MICROSAR R11 and earlier (due
to FEAT-261).
17.1.2 Extension
New APIs have been introduced or functionality has been added. There is no influence on existing
implementations.
Change ID
Affected Modules
Description
FEAT-1063
IP v6
Store a DHCP-assigned IPv6 address in NvM.
Defined by AUTOSAR concept CONC_600_
SwitchConfiguration.
FEAT-1210
DaVinci Configurator Pro 5
The RTE now supports Background Trigger (OS
background task) of SWC runnables and BSW
DaVinci Developer
main functions. Selected BSW modules can now
FEE
be configured to make use of the background
task scheduling.
RTE
FEAT-1268
TSYNC ETH
Support Timestamps from OS, GPT and applic-
ation callbacks.
FEAT-1280
DaVinci Developer
The data type UTF16 is now supported.
RTE
Beta Implementation. This feature shall
not be used for production.
SOMEIPXF
FEAT-1286
CRY
Support signature verification and RSA decryp-
tion in CSM and CRY.
CSM
FEAT-1348
IP v4
TcpIp_ChangeParameter() API can be used to
update/set the frame priority (VLAN-tag) and the
IP v6
TTL/HopLimit.
SOAD
TCPIP
FEAT-229
IPDUM
IPDUM now supports a selector field with a
length up to 16bits.
Beta Implementation. This feature shall
not be used for production.
FEAT-349
DaVinci Configurator Pro 5
DaVinci DEV and RTE now supports union data
types for intra ECU communication.
DaVinci Developer
RTE
SOMEIPXF
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 178-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
Transformer
FEAT-515
Base EcuC Converter
Implementation of further J1939 features:
ECUC
> J1939Nm performs now true random delay
calculations to avoid BusOff.
J1939NM
> J1939Rm features now a ServicePort inter-
J1939RM
face.
Legacy DB Converter
> Supported DBC attributes include now the
ProtocolType ISO11783 and the GenMs-
TechnicalReference_
gRequestable flag.
DBCRules (Vector)
Beta Implementation. This feature shall
not be used for production.
FEAT-516
CANIF
MICROSAR J1939 was extended to support
ISOBUS applications:
J1939NM
> J1939Nm provides full access to dynamic net-
J1939RM
work management related information.
> Address translation is now handled sep-
arately for each CAN channel.
> The timing of the initial AddressClaiming
sequence and the layout of the acknow-
ledgement message have been adapted to
conform to ISO 11783.
Beta Implementation. This feature shall
not be used for production.
FEAT-528
DaVinci Developer
The E2E profiles 5 and 6 are now supported and
can be used in combination with the MICROSAR
E2E Protection Lib
E2EXF. The library CRC Routines is provided up
RTE
to ASIL D.
SOMEIPXF
Beta Implementation. This feature shall
not be used for production.
Transformers_E2eXfTt-
techSub
FEAT-531
IP v6
Support local IPv6 multicast and broadcast
addresses which can be assigned to sockets sep-
arately.
Reception of SD multicast packets on separate
socket.
FEAT-63
Base EcuC Converter
CAN-FD Mode 2 for communication and dia-
gnostics is now supported.
CAN
Beta Implementation. This feature shall
CAN
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 179-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
CANIF
not be used for production.
CANTP
DaVinci Configurator Pro 5
PDUR
SOMEIPXF
FEAT-690
BSWM
At the end of each schedule table execution the
LINIF can now trigger a so called schedule end
LINIF
notification. This gives the application a better
LINSM
control over the LIN communication (e.g. by
being able to change the schedule table after a
fixed number of cycles).
FEAT-705
ETHIF
Ethernet wakeup based on Activation Line as
defined by AUTOSAR 4.2.1.
ETHTRCV
Beta Implementation. This feature shall
not be used for production.
FEAT-717
DaVinci Developer
The E2E profiles 4, 5 and 6 can now be used for
inter ECU C/S communication.
RTE
Beta Implementation. This feature shall
SOMEIPXF
not be used for production.
Transformers_E2eXfTt-
techSub
FEAT-728
DaVinci Configurator Pro 5
Data prototype mapping is now supported. This
allows e.g. a bitfield text table mapping.
DaVinci Developer
RTE
FEAT-947
DaVinci Configurator Pro 5
The DEM allows
DCM
> additional configuration data to be change-
able at post-build time (MICROSAR PBL
DEM
license required)
> some data to be variant using post-build
selectable (e.g. variant snapshot data) . This
feature requires licensing of MICROSAR IDM
17.1.3 Information
The internal behavior of the BSW has been improved without any change in the API. Only for inform-
ation purpose.
Change ID
Affected Modules
Description
FEAT-1001
Base EcuC Converter
Enhanced configuration of service-oriented com-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 180-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
SD
munication according to AUTOSAR 4.2.1 Sys-
temTemplate.
SOAD
FEAT-1311
DLT
Diagnostic Log and Trace (DLT) module available
according to AUTOSAR:
> Support of the AUTOSAR communication pro-
tocol via Ethernet (TCP/UDP)
> verbose and non- verbose communication
> VfB Tracing APIs using RTE hooks
> Context registration
The AUTOSAR DLT is an option that needs to be
licensed explicitly.
Beta Implementation. This feature shall
not be used for production.
FEAT-34
J1939TP
Improved validation rules during configuration.
17.1.4 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.10.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.2 Release 11.1
17.2.1 Breaking Changes
Modification of existing functionality or APIs that can have an impact on existing applications (such as
SWCs, CDDs …).
Change ID
Affected Modules
Description
FEAT-1317
General MCAL Feature
The location of 3rd party MCALs within the
MICROSAR SIP has changed. This change is
applicable for MCALs previously located in the
".\Supply" folder of the SIP.
The new structure is defined as follows:
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 181-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
> .\ThirdParty\<MCAL Name>\Supply <-- 3rd
party MCAL delivery in its original structure
(similar to the content of the former .\Supply
folder.
> .\ThirdParty\<MCAL Name>\Vect-
orIntegration <-- Optional folder that may
contain scripts and tools for the integration
of the MCAL the MICROSAR SIP
Impact to existing projects:
As the location of the "Supply" folder has
changed, make files referring 3rd party MCAL
components may have to be adapted.
17.2.2 Extension
New APIs have been introduced or functionality has been added. There is no influence on existing
implementations.
Change ID
Affected Modules
Description
FEAT-1129
DaVinci Configurator Pro 5
It is now possible to configure the diagnostic
stack based on ECUC files received e.g. by the
DCM
vehicle manufacturer. Use the DaVinci
DEM
Configurator Pro feature "Standard Configuration
Files" in the Input File editor to configure and
update such ECUC files.
Beta Implementation. This feature shall
not be used for production.
FEAT-1285
DaVinci Configurator Pro 5
The non-volatile data interface of the RTE now
also supports PR ports.
DaVinci Developer
Beta Implementation. This feature shall
RTE
not be used for production.
FEAT-1313
RTE
The RTE now supports an optimized way to copy
large data blocks in a runtime efficient manner
on 32bit CPUs.
FEAT-24
SD
Support Service Discovery extensions specified
in AUTOSAR 4.2.1:
> New Entry Format Type 2 (Counter field
added)
> New IPv4/IPv6 SD Endpoint Option
> New development and production errors
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 182-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
FEAT-264
DaVinci Configurator Pro 5
The RTE now supports CompuMethods for bit-
field data types
DaVinci Developer
(category BITFIELD_TEXTTABLE).
RTE
Beta Implementation. This feature shall
not be used for production.
FEAT-394
DaVinci Developer
The End-to-End Communication Protection pro-
file 1c is now supported.
E2E Protection Lib
FEAT-520
DCM
The DCM now supports the ModeDe-
clarationGroup DcmResponseOnEvent_
<RoeEventID>.
Beta Implementation. This feature shall
not be used for production.
FEAT-627
DaVinci Configurator Pro 5
DCM allows to forward ranges of DIDs to the
application.
DCM
Beta Implementation. This feature shall
not be used for production.
FEAT-742
CAL
The RSA-2048 (asymmetric algorithms)and
SHA256 (basic package) is now supported. This
CPL
allows SBA ticket validation in the application
FEAT-823
DaVinci Configurator Pro 5
PR port now also allow mode switch func-
tionality.
DaVinci Developer
Beta Implementation. This feature shall
RTE
not be used for production.
FEAT-971
FRIF
Completion of the realization of AUTOSAR
concept CONC_605_GlobalTimeSynchronization.
STBM
Beta Implementation. This feature shall
TSYNC CAN
not be used for production.
TSYNC ETH
TSYNC FR
17.2.3 Information
The internal behavior of the BSW has been improved without any change in the API. Only for inform-
ation purpose.
Change ID
Affected Modules
Description
FEAT-108
AN-ISC-8-1169_How_to_
New application note that describes how CAN
add_XCP_PDUs_in_DaVin-
XCP messages can be added to an existing con-
ciConfiguratorPro
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 183-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Modules
Description
figuration. This can be relevant if the vehicle
manufacturer does not describe XCP PDUs in his
databases (ARXML, DBC...).
FEAT-1282
AN-ISC-8-1166_BRE_
There is a new application note available that
without_AUTOSAR_OS
describes how BRE might be used without an
AUTOSAR OS.
FEAT-220
MSR_TechRef_DbcRules_
CAN-FD networks can be described using DBC
Vector
files. This includes the definition of 64byte mes-
sages and TP relations.
Beta Implementation. This feature shall
not be used for production.
17.2.4 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.9.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.2.5 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.8.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.3 Release 8
17.3.1 Modifications
Change ID
Affected Mod- Description
Category
ules
AR4-477
EthIf
Ethernet Stack according to AUTOSAR 4.1.1
Change
(BSWMD Schema 4.0.3). Support Nm User Data
AR4-478
SOME/IP
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 184-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
AR4-490
NmIf
for UdpNm.
AR4-516
UdpNm
AR4-486
ComM
AR4-492
EthSM
AR4-495
PduR
AR4-496
SoAd
AR4-502
DoIP
ESCAN00069048
Communication
Interface
ESCAN00069041
Complex
Driver
ESCAN00069042
ESCAN00069043
ESCAN00067480
ESCAN00067481
ESCAN00068226
ESCAN00067480
ESCAN00067842
ESCAN00067481
ESCAN00067816
ESCAN00067479
ESCAN00067843
ESCAN00067836
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 185-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068227
ESCAN00068230
ESCAN00068231
ESCAN00068229
AR4-346
All BSW Mod-
Remove vendor specific parameter Vect-
Change
ules
orCommonData/BswmdVersion as this inform-
ESCAN00068579
ation is no longer required. Change has no effect
DaVinci
on application or tool usage.
Configurator 5
ESCAN00068580
Impact on existing projects
ESCAN00068581
Removed container and parameter may have to
be deleted manually.
ESCAN00068582
Change has no effect on application.
ESCAN00068583
ESCAN00068584
ESCAN00068585
ESCAN00068586
ESCAN00068587
ESCAN00068588
ESCAN00068589
ESCAN00068590
ESCAN00068591
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 186-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068592
ESCAN00068593
ESCAN00068594
ESCAN00068595
ESCAN00068596
ESCAN00068597
ESCAN00068598
ESCAN00068599
ESCAN00068600
ESCAN00068601
ESCAN00068602
ESCAN00068603
ESCAN00068604
ESCAN00068605
ESCAN00068606
ESCAN00068607
ESCAN00068608
ESCAN00068609
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 187-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068610
ESCAN00068611
ESCAN00068612
ESCAN00068613
ESCAN00068614
ESCAN00068615
ESCAN00068616
ESCAN00068617
ESCAN00068618
ESCAN00068619
ESCAN00068620
ESCAN00068621
ESCAN00068622
ESCAN00068623
ESCAN00068624
ESCAN00068625
ESCAN00068626
ESCAN00068627
ESCAN00068628
ESCAN00068629
ESCAN00068630
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 188-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068631
ESCAN00068632
ESCAN00068633
ESCAN00068634
ESCAN00068636
ESCAN00068640
ESCAN00068641
ESCAN00068642
ESCAN00068643
ESCAN00068644
ESCAN00068645
AR4-260
All BSW Mod-
Remove vendor specific configuration switch
Change
ules
“ProdErrorDetection”. The switch is no longer
ESCAN00068296
required as AUTOSAR provides the same feature
ESCAN00068297
using references to the DEM event container.
ESCAN00068298
ESCAN00068299
ESCAN00068300
ESCAN00068301
ESCAN00068302
ESCAN00068303
ESCAN00068304
ESCAN00068306
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 189-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068307
ESCAN00068308
ESCAN00068310
ESCAN00068311
ESCAN00068313
ESCAN00068314
ESCAN00068315
ESCAN00068316
ESCAN00068317
ESCAN00068318
ESCAN00068319
ESCAN00068320
ESCAN00068322
ESCAN00068324
ESCAN00068325
ESCAN00068326
ESCAN00068328
ESCAN00068329
ESCAN00068330
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 190-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
AR4-549
Documentation
The generic and OEM specific startup manuals
Change
have been merged to one CHM based doc-
ESCAN00069555
umentation.
AR4-292
Dlt
Implementation of the module DLT based on XCP
Extension
communication as part of MICROSAR AMD.
ESCAN00068275
Dem
Reporting of DET and DEM errors. Custom noti-
ESCAN00068274
Det
fications and free text notifications.
ESCAN00068395
ESCAN00068394
AR4-379
WdgM
Provide Debug Data (DBG) for MICROSAR AMD.
Extension
ESCAN00067782
BswM
ESCAN00067785
ComM
ESCAN00067786
AR4-355
CANoe
Dual target support: Generate CANoe MCAL code
Extension
directly from the hardware specific BSW con-
ESCAN00068481
MCAL Modules
figuration. Enables parallel execution of a project
ESCAN00068482
on the hardware and the PC.
ESCAN00068483
ESCAN00068484
ESCAN00068485
ESCAN00068486
ESCAN00068487
ESCAN00068488
ESCAN00068489
ESCAN00068490
ESCAN00068491
ESCAN00068492
ESCAN00068493
ESCAN00068494
ESCAN00068495
ESCAN00068496
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 191-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00068497
AR4-406
Rte
Support use-case without RTE by generating con-
Extension
tract phase headers for Service-SWCs.
EVAL00107854
DaVinci
Configurator 5
ESCAN00068433
AR4-385
SoAd
VLAN support (multi home) Dual IP stack (IPv4
Extension
und IPv6) Support of multiple IPv4 IP address;
ESCAN00068222
DoIp
e.g. one static and one dynamic address
ESCAN00068223
EthIf
ESCAN00068224
TcpIp
IpV4
IpV6
AR4-497
SoAd
Support of PDU header option
Extension
ESCAN00068233
AR4-501
IpV4
IP address storage in NvM
Extension
ESCAN00068236
IpV6
ESCAN00068237
AR4-514
EcuM
Alarm clock handling (Cyclic wakeup based on
Extension
timer events)
ESCAN00069007
ESCAN00069008
ESCAN00069009
ESCAN00069010
EVAL00108066
AR4-397
Can
CANFD mode 1 (8 byte payload)
Extension
EVAL00107922
CanIf
ESCAN00069107
CanSm
ESCAN00069108
DaVinci
Configurator 5
ESCAN00069109
Base EcuC
ESCAN00069145
Converter
AR4-200
IpduM
Improved configuration support using validation
Extension
rules.
ESCAN00061790
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 192-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
AR4-205
Com
Support Tx timeout in Com
Extension
ESCAN00064077
AR4-520
Com
Support dynamic DLC
Extension
ESCAN00067585
AR4-89
PduR
Tx confirmation functions are now configurable
Extension
for not buffered I-PDUs
ESCAN00067863
All Com Stack
Modules
ESCAN00067862
ESCAN00067861
ESCAN00067860
ESCAN00067859
ESCAN00067858
ESCAN00067857
ESCAN00067856
AR4-231
Dcm
Support diagnostic service ResponseOnEvent
Extension
(86h)
ESCAN00068551
AR4-420
Dem
Allow post-build time update of selected fault
Extension
memory configuration data for legislative OBD
ESCAN00068416
DaVinci
use-cases.
Configurator 5
ESCAN00068205
Post-Build XML
ESCAN00068146
Generator
ESCAN00068414
EcuM EcuC
ESCAN00068415
AR4-81
Dcm
OBDII support
Extension
ESCAN00068082
DaVinci
Configurator 5
ESCAN00068083
AR4-307
DaVinci
Support for J1939 according to AUTOSAR 4.1.1
Extension
Configurator 5
(BSWMD Schema 4.0.3).
EVAL00107700
Base EcuC
EVAL00107759
Converter
EVAL00108857
Legacy Db
ESCAN00067978
Converter
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 193-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00067979
DaVinci
Developer
ESCAN00067980
Com
ESCAN00067981
Rte
ESCAN00067982
CanIf
ESCAN00068467
NmIf
ESCAN00068650
CanSm
ESCAN00068673
J1939Tp
ESCAN00068766
J1939Nm
ESCAN00068767
J1939Rm PduR
ESCAN00068768
ESCAN00068792
ESCAN00068793
ESCAN00068794
ESCAN00068795
ESCAN00068796
ESCAN00068797
ESCAN00068803
AR4-438
CanIf
Support ISO-Bus (fully dynamic CAN addresses).
Extension
ESCAN00068788
J1939Nm
ESCAN00068789
ESCAN00068790
AR4-389
LinIf
It is now possible to configure multiple LinTp con-
Extension
nections (TxNSdu and RxNSdu pairs) with the
ESCAN00067901
LinTp
same NAD. This feature allows accessing a LIN
slave from the internal diagnostics (of the mas-
ter node) and from an external tester tool.
AR4-316
Rte
Support standardized API for NVM access accord-
Extension
ing to AUTOSAR 4.
ESCAN00059347
DaVinci
Configurator 5
ESCAN00070195
DaVinci
EVAL00102792
Developer
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 194-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
EVAL00107657
AR4-318
Rte
SWC Multicore support for OS with SC1
Extension
ESCAN00068448
Os
ESCAN00053114
EcuM
ESCAN00070290
DaVinci
Configurator 5
ESCAN00070291
DaVinci
ESCAN00070292
Developer
AR4-332
BswM
Provision of standard rules that can simplify the
Extension
BSWM configuration process for BSW ini-
AR4-381
DaVinci
tialization and ECU state handling using a tool
Configurator 5
ESCAN00064988
assistant.
EVAL00108055
ESCAN0006904
AR4-428
BswM
Add support timer handling as BSWM event trig-
Extension
ger.
ESCAN00069021
DaVinci
Configurator 5
ESCAN00069022
ESCAN00069023
ESCAN00069024
EVAL00107734
AR4-429
BswM
Advance handling of Generic Mode Requests (add
Extension
support of symbolic Values). Support bottom up
EVAL00108064
DaVinci
configuration approach of SWC configuration
Configurator 5
ESCAN00069025
items
ESCAN00069026
ESCAN0006902
ESCAN00069028
AR4-432
BswM
Support of rule condition operators “XOR” and
Extension
“NAND”
ESCAN00069030
DaVinci
Configurator 5
ESCAN00069031
EVAL00108516
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 195-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
AR4-433
BswM
Support of User Conditions
Extension
EVAL00107733
DaVinci
Configurator 5
ESCAN00069033
ESCAN00069034
AR4-322
Xcp
Allow XCP Events to be forwarded to the Vx1000
Extension
Hardware to simplify switching between XCP
ESCAN00068263
based and Vx1000 based measurement.
ESCAN00068264
ESCAN00068265
AR4-328
Rtm
Predefined runtime measurement points for Rtm
Extension
(MICROSAR AMD).
EVAL00107660
Can
ESCAN00069020
Lin
ESCAN00067711
Fr
ESCAN00067708
DaVinci
Configurator 5
ESCAN00068809
ESCAN0006999
AR4-562
Fr
Support FlexRay Cycle Multiplexing. This feature
Extension
allows reducing the number of required FlexRay
ESCAN00070287
controller buffers.
AR4-363
Crypto
Production release of crypto
Information
ESCAN00068522
AR4-384
DaVinci
Rework of SipLicense.lic file schema.
Information
Configurator 5
EVAL00107894
Rte
ESCAN00067951
ESCAN00068367
ESCAN00069075
ESCAN00069076
ESCAN00069084
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 196-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00069078
ESCAN00069079
ESCAN00069080
ESCAN00069081
ESCAN00069082
ESCAN00069083
ESCAN00069077
AR4-267
Fee
Complete graphical representation of Flash/Fee
Information
Load in DaVinci Configurator memory domain.
EVAL00102611
ESCAN00064848
AR4-459
Rte
Runtime optimized handling of interrupt locks
Information
when using MICROSAR OS and MICROSAR RTE.
ESCAN00053014
Os
This extension is only activated if both modules
support that feature.
AR4-312
DaVinci
All BSW validation rules become part of the gen-
Information
Configurator 5
erator plugin and are now part of the active issue
EVAL00108032
tracking process (ESCAN).
All BSW
ESCAN00068276
ESCAN00068277
ESCAN00068278
ESCAN00068280
ESCAN00068281
ESCAN00068282
ESCAN00068283
ESCAN00068284
ESCAN00068285
ESCAN00068286
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 197-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
AR4-450
All BSW
From now on the memory section SEC_PBCFG is
Modification
used only for post-build loadable projects. Data
ESCAN00069125
will be mapped through other SWC_CONST_* sec-
ESCAN00069126
tions if post-build loadable is not used.
ESCAN00069193
ESCAN00069194
ESCAN00069205
ESCAN00069206
ESCAN00069207
ESCAN00069387
ESCAN00069571
ESCAN00069570
ESCAN00069569
ESCAN00069568
ESCAN00069566
ESCAN00069565
ESCAN00069564
ESCAN00069563
ESCAN00069562
ESCAN00069561
ESCAN00069559
ESCAN00069558
ESCAN00069546
ESCAN00069545
ESCAN00069544
ESCAN00069541
ESCAN00069540
ESCAN00069539
ESCAN00069538
ESCAN00069537
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 198-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod- Description
Category
ules
ESCAN00069536
ESCAN00069535
ESCAN00069534
ESCAN00069533
ESCAN00069532
ESCAN00069531
ESCAN00069530
ESCAN00069529
ESCAN00069528
ESCAN00069527
ESCAN00069526
ESCAN00069525
ESCAN00069524
ESCAN00069523
ESCAN00069522
ESCAN00069521
ESCAN00069520
ESCAN00069519
ESCAN00069518
ESCAN00069517
ESCAN00069516
ESCAN00069515
ESCAN00069514
ESCAN00069510
ESCAN00069509
ESCAN00069508
ESCAN00069693
ESCAN00069692
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 199-

---

17 Release Notes
User Manual Startup with GM SLP2
17.3.2 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.6.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.4 Release 7.1
17.4.1 Modifications
Change ID
Affected
Description
Category
Modules
AR4-421
Rte
Support of Inter- Runnable Variables for Complex
Extension
Data Types
EVAL00107372
DaVinci
Configurator
ESCAN00067665
DaVinci
Developer
AR4-527
Rte
Multi Core for OS SC1 supporting Sender/Receiver
Extension
Communication using the master core that runs the
ESCAN00067753
BSW.
AR4-532
CanSm
ECUs can be set to (CAN) passive mode by the applic-
Extension
ation. The required API extension of AUTOSAR used to
ESCAN00068036
be available in MICROSAR3. New APIs: CanSM_
ESCAN00068037
SetEcuPassive CanSM_PreventBusSleepAtStartUp
ESCAN00068038
ESCAN00068039
ESCAN00068040
ESCAN00068041
AR4-539
Legacy
Support of Fibex 2.0.1 files as exported by Network
Extension
Converter
Designer.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 200-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected
Description
Category
Modules
ESCAN00068074
17.4.2 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.5.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.5 Release 7
17.5.1 Modifications
Change ID
Affected Mod-
Description
Category
ules
AR4-279
BswM
Mode Request Ports with sender receiver inter-
Extension
face
ESCAN00062129
DaVinci
Configurator 5
ESCAN00062130
ESCAN00062131
AR4-240
Rte
Production release
Information
StbM
AR4-211
Com
Support Signal Gateway
Extension
ESCAN00064081
Base EcuC
ESCAN00064080
Converter
ESCAN00064079
ESCAN00064078
EVAL00095877
AR4-247
Dcm
Production release
Information
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 201-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
Dem
Fim
CanTp
AR4-246
SoAd
Production release
Information
ESCAN00064219
EthIf
EthSm
Eth
EthTrcv
AR4-241
ComM
Production release
Information
ESCAN00064988
EcuM
BswM
CanSm
FrSm
LinSm
FrNm
CanNm
NmIf
AR4-255
E2ELib
Production release
Information
E2EPW
SafeWdg
SafeWdgIf
SafeWdgM
AR4-242
Com
Production release
Information
ESCAN00064511
PduR
IpduM
ESCAN00060322
Communication
ESCAN00060324
Interface
Complex Driver
ESCAN00060323
Com Stack Lib
ESCAN00060320
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 202-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
ESCAN00056674
ESCAN00056673
ESCAN00060470
ESCAN00060467
ESCAN00060328
ESCAN00060327
ESCAN00060326
ESCAN00060325
AR4-243
CanIf
Production release
Information
CanTrcv
Can
AR4-244
LinIf
Production release
Information
ESCAN00060250
LinTp
ESCAN00060334
Generic LinTrcv
ESCAN00060243
DrvTrans_
Tle7259LindioAsr
Lin
AR4-245
FrIf
Production release
Information
ESCAN00064879
Fr
ESCAN00064880
Tja1080 Dio
FrTrcv
ESCAN00064881
Iso10681 FrTp
ESCAN00064882
ESCAN00064883
AR4-248
NvM
Production release
Information
MemIf
Fee
Ea
Eep XAt25128E
Basic Ea
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 203-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
AR4-249
IoHwAb
Production release
Information
AR4-251
Cal
Production release
Information
ESCAN00066036
AR4-252
DaVinci
Production release
Information
Configurator 5
EVAL00103830
Legacy Db
EVAL00103831
Converter
DaVinci
Developer
AR4-256
WdgM
Production release
Information
WdgIf
Crc
AR4-267
Xcp
Production release
Information
ESCAN00064884
XcpOnCan
ESCAN00064885
XcpOnFr
ESCAN00064886
AR4-358
Det
Production release
Information
AR4-315
Dcm
Support of the following AUTOSAR APIs:
Extension
CancelTransmit, TP CancelReceive, ChangePara-
ESCAN00064128
Dem
meter
ESCAN00064126
All TP Layer Mod-
ules
ESCAN00064127
All IF Layer Mod-
ESCAN00064125
ules
PduR
Communication
Interface Com-
plex Driver
AR4-58
DaVinci
CFG5 Feature Licensing for (COM and PDUR
Change
Configurator 5
Gateway, High-End CAN Driver Features and
ESCAN00063102
RTE Memory Protection Handling)
CanIf
ESCAN00064098
PduR
ESCAN00064099
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 204-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
ESCAN00064379
Com
ESCAN00064517
Rte
AR4-291
Rtm
Implement Runtime Measurement as part of
Extension
MICROSAR AMD. Communication via XCP using
ESCAN00064408
DaVinci
CANoe Test Feature Set
Configurator 5
ESCAN00064444
AR4-319
Rte
The calibration methods “Initialized RAM“ and
Change
“Single Pointered” have been optimized for the
AR4-373
calibration tool CANape.
ESCAN00064635
> New a2l fragment (Rte_MemSeg.a2l)
ESCAN00063013
defines the relationship between RAM and
Flash segments
ESCAN00063014
> Memory Segment definitions provided by
ESCAN00064868
Rte have been optimized to simplify the
integration of calibration tools
ESCAN00063401
> Calibration SWCs are now exported expli-
citly to the a2l file. Before the calibration
ports of SWC had been the only means to
access the calibration data.
AR4-282
Dbg
BSW Debugging based on XCP as part of
Extension
MICROSAR AMD.
ESCAN00064486
Can
Provision of a AMD User Manual: UserManual_
ESCAN00064488
CanIf
AMD.pdf
ESCAN00064489
CanTp
ESCAN00064492
CanSm
ESCAN00064491
ComM
ESCAN00064495
FrNm
ESCAN00064497
CanNm
ESCAN00064498
LinIf
ESCAN00064499
LinSm
ESCAN00064494
Lin
ESCAN00064500
EcuM
ESCAN00064490
Fr
ESCAN00064501
FrIf
ESCAN00064502
FrSm
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 205-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
ESCAN00064493
IpduM
ESCAN00064503
Iso10681 FrTp
ESCAN00064486
NmIf
ESCAN00064490
PduR
ESCAN00064496
Xcp
ESCAN00064485
Com
ESCAN00064504
DaVinci
Configurator 5
ESCAN00064484
ESCAN00065856
ESCAN00064646
ESCAN00064647
EVAL00103941
EVAL00103685
EVAL00103009
AR4-300
Xcp
MICROSAR XCP Improvements:
Extension
ESCAN00062626
DaVinci
> Support of up to 65k Events (used to be
Configurator 5
256)
ESCAN00062625
XcpOn<Bus>
> XCP Events configured in GENy are allowed
ESCAN00064846
to have gaps in order to keep the IDs con-
stant as required by CANape
> Parallel usage of internal and externally
defined XCP Events
> Provision of a master a2l file template in
.\Misc\McData\_Master.a2l
> New user manual for XCP based calibration
(UserManual_AUTOSAR_Calibration.pdf)
AR4-313
DaVinci
Evaluation and Prototype Bundles now evaluate
Extension
Configurator 5
the SIP Expiry Date.
ESCAN00064016
Rte
ESCAN00064021
ESCAN00062189
AR4-362
TcpIp
IETF RFCs Enhancements implemented: TcpIp
Extensions
Extensions: Congestion Control, SlowStart,
ESCAN00064223
IP v4
SelectiveAck, MulticastListenerDiscoveryV2
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 206-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
IP v6
AR4-351
OEM Vector Dbc
Rework of legacy database rules to comply with
Extensions
Rules TechRef
MICROSAR 4.
ESCAN00064008
Legacy Db
ESCAN00064009
Converter
AR4-375
Dem
Add Support of "Suppress DTC" functionality
Extensions
ESCAN00065209
AR4-284
Iso10681 FrTp
High-level TP-Routing using ring buffer now sup- Extensions
ported
ESCAN00064277
PduR
ESCAN00063356
ESCAN00060163
AR4-352
ComM
Support partial networking on CAN for the use
Extensions
case with legacy formats (dbc and Fibex).
ESCAN00065159
BswM
EVAL00092784
CanNm
EVAL00102893
NmIf
ESCAN00066283
CanTrcv
ESCAN00065289
CanIf
ESCAN00065274
Legacy Db
Converter
ESCAN00066249
DaVinci
ESCAN00066285
Configurator 5
ESCAN00065159
Base EcuC
Converter
AR4-327
Can
Support node status transition diagram (figure
Change
16) of ISO11898-1 for selected CAN drivers
(e.g. in case the hardware supports this).
Please refer to the technical reference of the
CAN driver.
AR4-296
Xcp
Support ASAM XCP specification version 1.1 as
Extension
specified in AUTOSAR 4.0.3 SWS XCP
ESCAN00064768
XcpOnCan
EVAL00102893
XcpOnFr
XcpOnTcpIp
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 207-

---

17 Release Notes
User Manual Startup with GM SLP2
17.5.2 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.5.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
17.6 Release 6
17.6.1 Modifications
Change ID
Affected Mod-
Description
Category
ules
AR4-131
CSM
CSM and CAL module added to MICROSAR 4
Extension
AR4-166
CAL
ESCAN00061819
ESCAN00061820
AR4-80
RTE, NVM
Pointer Data Type DATA_REFERENCE now sup-
Change
ported.
EVAL00097772
As a consequence the file NvM_VoidPtr.arxml is
ESCAN00062100
no longer delivered with the SIP.
ESCAN00063443
AR4-153
FR
FlexRay buffer reconfiguration supported
Extension
ESCAN00061822
ESCAN00061821
ESCAN00061422
AR4-154
FR
Runtime optimization: FlexRay driver is able to
Extension
filter IsoFrTp messages based on the TP
ESCAN00061824
addressing information.
AR4-169
OS
General OS implementation supporting the OS
Extension
features SC3, SC4 and MultiCore. Please check
AR4-168
for uC specific availability.
AR4-165
OS, STBM
STBM module added to MICROSAR 4
Extension
AR4-148
FIM
FIM added to MICROSAR 4
Extension
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 208-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
ESCAN00061742
AR4-91
FlexRay Stack
CancelTransmit API now supported
Extension
(Tp, Interface,
ESCAN00061826
Driver)
ESCAN00061825
AR4-192
MCAL, WDGM,
General parameters are now configured in the
Change
IOHWAB, NVM,
ECUC module and no longer in the MICROSAR
MEMIF, OS, RTE,
BOARD module. The BOARD module has been
CFG5, ECUC,
removed as a consequence.
BOARD
AR4-98
BSWM, NVM
Improved BSWM and NVM interaction. Now sup-
Extension
porting NVM-Job and NVM-Block mode noti-
ESCAN00062284
fications.
ESCAN00062430
AR4-197
IPDUM
Support BIG_ENDIAN Copy Segments
Extension
ESCAN00061788
ESCAN00061787
ESCAN00061786
ESCAN00061785
AR4-199
COM, Tooling
Signal Data Invalidation for Rx and Tx COM sig-
Extension
nals
ESCAN00061798
ESCAN00061797
ESCAN00061796
ESCAN00061795
ESCAN00061794
ESCAN00061792
AR4-204
COM, Tooling
Update Bits for COM signals now supported
Extension
ESCAN00061796
ESCAN00061801
ESCAN00061800
ESCAN00061803
ESCAN00061802
ESCAN00061799
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 209-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
AR4-212
COM
Filtering of signal receive events supported
Extension
ESCAN00061807
ESCAN00061800
ESCAN00061805
ESCAN00061806
AR4-225
PDUR
High-level TP Gateway added:
Extension
ESCAN00061808
> Ethernet <-> FlexRay
ESCAN00061809
> Ethernet <-> CAN
> CAN <-> CAN
ESCAN00061711
ESCAN00061810
AR4-228
COM, CANSM,
Realization of pending AUTOSAR RfCs:
Change
ECUM
ESCAN00062048
> Clarification of the return value and imple-
mentation of Com_TriggerTransmit API
ESCAN00062050
> Introduction of the API CanSM_Check-
ESCAN00062053
BorLevel to check the CAN bus-off recovery
> Avoid CAN Controller being online while
Tranceiver is in standby by changed CANIF
No-Communication State sequence
AR4-77
RTE, CFG5
Support of Component and Data Type symbol
Extension
names to avoid name clashes. If the symbol
AR4-78
name is not available, the component type short
EVAL00088196
name is used as symbol name.
ESCAN00057911
EVAL00088201
ESCAN00057912
AR4-257
RTE, tooling
Support Trigger On Transition
Extension
EVAL00097773
ESCAN00062102
AR4-278
COMM
ComM_CurrentChannelRequest available as port
Extension
interface
ESCAN00062059
AR4-279
BSWM
Mode Request Port API with S/R interface
Extension
ESCAN00062129
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 210-

---

17 Release Notes
User Manual Startup with GM SLP2
Change ID
Affected Mod-
Description
Category
ules
ESCAN00062130
ESCAN00062131
AR4-285
PDUR
Routing Path Groups supported
Extension
ESCAN00061831
ESCAN00062178
ESCAN00061832
ESCAN00062178
AR4-288
DCM
The “opStatus” function parameter of the C/S
Extension
API is either used for all operations or for none
ESCAN00062720
depending on the DcmDspDataUsePort con-
figuration (#54767)
17.6.2 Required AUTOSAR Tools
This MICROSAR release requires the usage of the following tools:
Tool
Version
DaVinci
3.4.x
Developer
Please use the latest service pack available from the Vector download center
DaVinci
The latest service pack version is delivered as part of the SIP. Upcoming service
Configurator
packs can be retrieved from the Vector download center
Pro
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 211-

---

IV What’s New, What’s Changed
User Manual Startup with GM SLP2
IV What’s New, What’s Changed
What’s new and what’s changed?
This section explains the changes within this document form the previous version to the one men-
tioned in the headline.
Version 1.x.x
Author
Date
Manuela Huber
2013-11-05
What’s new?
> First Version of Startup document
What’s changed?
> There has nothing changed
Version 2.x.x
Author
Date
Manuela Huber
2015-01-26
What’s new?
> Remove vVIRTUALtarget information from Startup. There is a separate User Manual available
(<Installed SIP Folder>\Doc\UserManuals\UserManual_vVIRTUALtarget_DualTarget.pdf).
What’s changed?
> Add necessary information for MICROSAR 4 release 11.x.
> Update section setup project. Name of DaVinci Configurator executable has changed.
> Update add input files section (System Description Files).
> Update service mapping description.
> Add new additional information section describing the command line parameters of the DaVinci
Configurator.
> Add Variant Handling description (Additional Information).
> Add new description about configuring service ports within application components (see Mappings
on page 109).
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 212-

---

IV What’s New, What’s Changed
User Manual Startup with GM SLP2
> New structure for release notes (see Release Notes on page 177).
> Update Command Line Parameter section (see ).
Version 3.x.x
Author
Date
Manuela Huber
2015-03-25
What’s new?
> New additional information section, describing the API between SoAd and TcpIp according to AR
4.2.1
> New additional information section, describing SIP Update
> New additional information section, describing new platform types according AUTOSAR
> New section Add ECUC File References
> Add release notes for MICROSAR Release 12
What’s changed?
> Update system description file view
> Update diagnostic data file view
> Change the update configuration process description
> Update tool synchronization description
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 213-

---

V Glossary
User Manual Startup with GM SLP2
V Glossary
Adc
(Analog Digital Converter Driver) The ADC driver abstracts hardware access to the analog-
digital converter. For every input, the conversion parameters are configured (e.g. resolution,
trigger source and trigger conditions).
AVTP
(Audio/Video Transport Protocol) The Audio/Video Transport Protocol is specified in IEEE
1722/1722a. In AVB networks it is responsible for the transport of audio/video data, including
the Presentation Time.
Bfx
(Bitfield functions for fixed point) Library for bit handling in fixed point arithmetic functions
BMCA
(Best Master Clock Algorithm) The Best Master Clock Algorithm is specified in IEEE 802.1AS
and is used to detect the device with the most precise time unit in an AVB network. After find-
ing the device with the most precise time unit, it is used as the time base for the entire sys-
tem.
BswM
(BSW Mode Manager) The BswM module contains vehicle mode management and application
mode management. It processes mode requests from SWCs or other BSW modules, and it per-
forms actions based on the arbitration, such as control of deadline monitoring, switching sched-
ule tables, and handling of IPDU groups. In conjunction with the EcuM, the BswM module is
responsible for starting up and shutting down the ECU. The BswM also coordinates the multi-
core partitions.
Cal (Cpl)
(Crypto Abstraction Library) The Cal library offers SWCs and other BSW modules access to
basic cryptographic functions. The individual cryptographic functions are implemented in soft-
ware via the Cpl module.
Can
(CAN Driver) The CAN Driver abstracts access to the CAN hardware for sending and receiving
messages and for switching between controller states (sleep, stop, etc.)
CanIf
(CAN Interface) The CAN Interface offers abstracted (PDU-based) access to the CAN Driver. It
controls the CAN Driver (( Can) as well as the transceiver driver (( CanTrcv).
CanNm
(CAN Network Management) Within a CAN network, CAN Network Management is responsible
for coordinated transitions between the wake up and sleep state.
CanSM
(CAN State Manager) The CAN State Manager is responsible for the bus-specific error hand-
ling.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 214-

---

V Glossary
User Manual Startup with GM SLP2
CanTp
(CAN Transport Layer) The CanTp module conforms to ISO standard 15765-2. As the transport
protocol for CAN, it is responsible for segmenting the data in the Tx direction, collecting data in
the Rx direction and monitoring the data stream.
CanTrcv
(CAN Transceiver Driver) This driver is responsible for controlling the operating states of an
external CAN transceiver. It contains control of wake up and sleep functions.
CanTSyn
(Time Sync Over CAN) This module realizes the CAN specific time synchronization protocol. An
access to the synchronized time base by the SWCs requires the Synchronized Time-Base Man-
ager (( StbM).
CanXcp / XCPonCan
(CAN XCP-Module) The CanXcp module contains CAN-specific contents of the XCP module (( 
Xcp).
CDD
(Complex Drivers) The Complex Drivers are software modules that are not standardized by
AUTOSAR. They have access to other BSW modules, the RTE and direct hardware access. For
example, these modules are not standardized communication drivers for SPI or legacy soft-
ware.
Com
(Communication) The Com module provides a signal-based data interface for the RTE. It
places signals in messages and sends them according to the defined send type. The module
contains various notification mechanisms for receiving signals. It also manages initial values,
update bits and timeouts on the signal level. In multi-channel ECUs, the integrated signal gate-
way offers the ability to route signals between the communication buses.
ComM
(Communication Manager) The ComM module coordinates the communication channels and
Partial Network Cluster with the communication requirements of the application.
ComXf
(COM Based Transformer) The COM based transformer optimizes for signal groups the inter-
action between RTE and the COM module, because you can avoid the shadow buffer in the COM
module. It de-/serializes the data identical to the COM module.
CorTst
(Core Test Driver) The CorTst module contains configuration and control of the test capabilities
included in the microcontroller core. In addition, it offers a framework for extending these test
capabilities. Specifically for safety-related software, the CorTst module tests critical units such
as the ALU and the registers.
Crc
(CRC Routines) The Cyclic Redundancy Check library calculates CRC checksums.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 215-

---

V Glossary
User Manual Startup with GM SLP2
Csm (Cry)
(Crypto Service Manager) The Csm module offers SWCs access to basic cryptographic func-
tions. The individual cryptographic functions are implemented by the Cry module in software
or hardware (access via ( She).
Dbg
(Debugging) The debugging module enables external access to internal information of the
basic software. It is also possible to modify memory data.
Dcm
(Diagnostic Communication Manager ) The Dcm module implements diagnostic communication
according to ISO 14229-1:2006 (UDS). Some diagnostic requests are processed directly in the
Dcm (management of diagnostic sessions, reading of error codes, EcuReset, etc.) and some
are routed to the SWCs via port interfaces (reading, writing and controlling of data elements
within a data identifier, execution of routines, etc.). Legal requirements of OBDII / SAE J1979
are also supported.
Dem
(Diagnostic Event Manager ) The Dem module implements a fault memory. The standardized
interface for "DiagnosticMonitors" enables uniform development of manufacturer-independent
SWCs. The Dem module is responsible for administering the DiagnosticTroubleCode states,
environmental data, and for storing the data in NVRAM. The legal requirements of OBDII / SAE
J1979 are also supported.
Det
(Development Error Tracer ) The Det module supports error debugging during software devel-
opment. It provides an interface for error notification, which is called by the individual BSW
modules in case of error.
Dio
(Digital Input Output Driver) The Digital Input Output Driver provides read and write services
for the DIO channels (pins), DIO ports and DIO channel groups.
Dlt
(Diagnostic Log and Trace) The Dlt module provides generic “Logging and Tracing” func-
tionality for SWCs and for the BSW modules ( Rte, ( Det and ( Dem.
DNS
(Domain Name System) The DNS module contains a DNS resolver. It is responsible for resolv-
ing a domain, e.g. vector.com, into a valid IP address.
DoIP
(Diagnostics over IP) Since AR 4.1.1 the DoIP module contains diagnostic functionality accord-
ing to ISO 13400-2 like vehicle discovery. Up to and including AR 4.0.3, this functionality is
part of the Socket Adaptor (( SoAd).
DrvExt
(External Driver) Upon request, you can obtain the implementation of drivers for externally
connected components. They are already available for plenty of external devices, e.g. for driv-
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 216-

---

V Glossary
User Manual Startup with GM SLP2
ing certain EEPROMs (EEPEXT), flash chips (FLSEXT), watchdogs (WDGEXT), analog-digital con-
verters (ADCEXT) and communication controllers (CANEXT, LINEXT, ETHSWTEXT).
E2E
(End-to-End Communication Protection Library) Library for secure data exchange according to
ISO 26262 for safety-related ECUs. It is responsible for calculating the checksum and provid-
ing the message counter.
E2EPW
(End-to-End Protection Wrapper) The E2E Protection Wrapper extends the RTE by adding veri-
fication of safety-related signals.
E2EXf
(E2E Transformer) With the E2E Transformer, you integrate the protection of safety-relevant
signals according to ISO 26262 in the RTE interface. In contrast to the E2E protection wrapper,
the standard interfaces of the RTE are used.
Ea
(EEPROM Abstraction ) The Ea module offers a hardware-independent interface for accessing
EEPROM data and uses an EEPROM driver (( Eep) for this. In addition to reading, writing and
clearing data, the Ea module also distributes write accesses to different areas of the EEPROM,
so that all EEPROM cells are uniformly stressed, which increases their life-time.
EcuM
(ECU State Manager) The ECU State Manager is responsible for starting up and shutting down
the ECU as well as waking it up. It is available in two variants: flexible and fixed. The EcuM Fix
manages a number of defined, fixed operating states. Using the EcuM Flex, the user defines all
operating states flexibly in the ( BswM module. This lets you implement special energy-saving
states and various types of startup. In a multi-core system, the EcuM coordinates the various
cores.
Eep
(EEPROM Driver) The EEPROM driver enables hardware-independent access to EEPROM
memory. It provides services for reading, writing and comparing data.
Efx
(Extended Fixed Point Routines) Library with extended mathematical functions for fixed-point
values
Eth
(Ethernet Driver) The Ethernet Driver abstracts access to the Ethernet hardware for sending
and receiving data and for switching between controller states.
EthIf
(Ethernet Interface) The Ethernet Interface enables bus-independent control of the Ethernet
driver (( Eth) and Ethernet transceiver driver (( EthTrcv). Since AR 4.1, this module is also
responsible for VLAN handling.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 217-

---

V Glossary
User Manual Startup with GM SLP2
EthSM
(Ethernet State Manager) The Ethernet State Manager provides the Communication Manager (( 
ComM) with an abstract interface for starting up or shutting down communications in Ethernet
clusters. EthSM accesses the Ethernet hardware via ( EthIf.
EthSwt
(Ethernet Switch Driver) The module EthSwt provides a uniform and hardware independent
interface for controlling and configuring Ethernet switches. It also coordinates the MAC learn-
ing when using multiple identical ECUs like cameras for the surround view.
EthTrcv
(Ethernet Transceiver Driver) EthTrcv offers a uniform and hardware-independent interface
for driving multiple transceivers of the same kind. Configuration of EthTrcv is transceiver-spe-
cific and considers the properties of the physical network that is used.
EthTSyn
(Time Sync Over Ethernet) This module realizes the Ethernet specific time synchronization pro-
tocol and references to IEEE Standard 802.1AS (( PTP). An access to the synchronized time
base by the SWCs requires the Synchronized Time-Base Manager (( StbM).
EthXcp/ XCPonEth
(Ethernet XCP-Module) The EthXcp module contains Ethernet-specific contents of the XCP mod-
ule (( Xcp).
EXI
(Efficient XML Interchange) The EXI module is used to interpret XML document and to convert
them to a binary format. This makes it more efficient to process the files and to transmit
them, in order to economize on communication bandwidth. It is used in the Vehicle2Grid envir-
onment.
Fee
(Flash EEPROM Emulation) The Fee module offers a hardware-independent interface for access-
ing flash data and uses a flash driver (( Fls) for this. In addition to reading, writing and clear-
ing data, the Fee module also distributes write accesses to different areas of flash memory, so
that all flash cells are uniformly stressed, which increases their life-time.
FiM
(Function Inhibition Manager ) Based on the active errors managed by the ( Dem module, the
FiM offers the ability to prevent execution of functionalities in SWCs.
Fls
(Flash Driver) The flash driver enables hardware-independent and uniform access to flash
memory. It provides services for reading, writing and comparing data, and for deleting blocks
(sectors).
FlsTst
(Flash Test) The Flash Test module offers algorithms for testing nonvolatile memory such as
data or program flash, SRAM and protected cache.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 218-

---

V Glossary
User Manual Startup with GM SLP2
Fr
(FlexRay Driver ) The FlexRay Driver abstracts access to the FlexRay hardware for sending
and receiving data and for switching between controller states.
FrArTp
(FlexRay AUTOSAR Transport Layer ) FrArTp is a FlexRay transport protocol. Based on ISO
15765-2 (( CanTp), it contains a frame compatibility with the CAN bus.
FrIf
(FlexRay Interface) The FlexRay Interface offers abstracted (PDU-based) access to the
FlexRay hardware. In addition, it offers support for synchronization with the global FlexRay
time.
FrNm
(FlexRay Network Management ) This module is responsible for network management in
FlexRay. It synchronizes the transition to the bus sleep state.
FrSM
(FlexRay State Manager) The FlexRay State Manager controls and monitors the wake up and
startup of nodes in the FlexRay cluster.
FrTp
(FlexRay ISO Transport Layer) FrTp is a FlexRay transport protocol and is based on the ISO
10681-2 standard.
FrTrcv
(FlexRay Transceiver Driver ) The driver for an external FlexRay transceiver is responsible for
switching the transceiver on and off.
FrTSyn
(Time Sync Over FlexRay) This module realizes the FlexRay specific time synchronization pro-
tocol. An access to the synchronized time base by the SWCs requires the Synchronized Time-
Base Manager (( StbM).
FrXcp/ XCPonFr
(FlexRay XCP-Module) The FrXcp module contains FlexRay-specific contents of the XCP module
(( Xcp).
Gpt
(General Purpose Timer Driver ) The General Purpose Timer Driver provides an interface for
accessing internal timers of the microcontroller. It is used for controlling periodic and singular
events, for example.
HTTP
(Hypertext Transfer Protocol) The Hypertext Transfer Protocol, for instance, routes browser
requests to a server. The module contains a HTTP client. It is used in the Vehicle2Grid envir-
onment.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 219-

---

V Glossary
User Manual Startup with GM SLP2
Icu
(Input Capture Unit Driver ) The Icu driver provides services for edge detection, measurement
of periodic signals, assignment of edge time stamps and control of wake up interrupts.
Ifl
(Interpolation Floating Point) Library with interpolation functions for floating point values
Ifx
(Interpolation Fixed Point) Library with interpolation functions for fixed point values
IicDrv
(I²C Driver) The I²C Driver provides services for communication with external I2C chips.
IoHwAb
(I/O Hardware Abstraction ) The I/O Hardware Abstraction represents the connection between
the RTE and the ECU's I/O channels. It encapsulates access to the I/O drivers such as ( Adc, ( 
Dio or ( Pwm and thereby makes the I/O signals of the ECU available to the SWCs.
IpduM
(I-PDU Multiplexer) This module is responsible for multiple use of fixed PDUs with different
data contents.
J1939Dcm
(SAE J1939 Diagnostic Communication Manager) The module implements Diagnostic Messages
of the SAE J1939-73 protocol, e.g. for reading out the fault memory.
J1939Nm
(SAE J1939 Network Management) J1939 supports adding ECUs to networks on-the-fly. The
J1939Nm module is responsible for negotiating a unique ECU address ("AddressClaim") and
unlike other NM modules for handling the wake-up or going to sleep of the bus.
J1939Rm
(SAE J1939 Request Manager) The J1939Rm module implements requesting of data via
Request Handling that is defined in the SAE J1939 protocol.
J1939Tp
(SAE J1939 Transport Layer) The J1939TP module contains the transport protocols BAM (Broad-
cast Announce Message) and CMDT (Connection Mode Data Transfer) of the SAE J1939 stand-
ard.
LdCom
(Large Data COM) The LdCom module is optimized for routing large signals. Thereby it avoids
an unnecessary copying of data. The LdCom is typically used together with (SomeIpXf as a seri-
alization transformer.
Lin
(LIN Driver) The LIN Driver provides services for initiating frame transmission (header,
response, sleep-mode and wake up), and for receiving responses, checking the current state
and validating wake up events.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 220-

---

V Glossary
User Manual Startup with GM SLP2
LinIf
(LIN Interface ) The LIN Interface offers abstracted (PDU-based) access to the LIN hardware.
It also handles schedule table processing and contains the LIN transport protocol (( LinTp).
LinNm
(LIN Network Management) The LinNm module contains a hardware-independent protocol,
which coordinates the transition between normal operation and the bus sleep mode of the LIN
network.
LinSM
(LIN State Manager) The LIN State Manager switches between schedule tables and PDU groups
in the ( Com module and services the LIN interface with regard to sleep and wake up.
LinTp
(LIN Transport Layer) The LIN transport protocol is responsible for segmenting data in the Tx
direction, collecting data in the Rx direction and monitoring the data stream. According to the
AUTOSAR specification, LinTp is part of ( LinIf.
LinTrcv
(LIN Transceiver Driver ) The module for an external LIN transceiver is responsible for mon-
itoring and driving the wake up and sleep functions.
LinXcp
(LIN XCP-Module) The LinXcp module contains LIN-specific contents of the XCP module (( Xcp).
Mcu
(Micro Controller Unit Driver) The MCU driver provides the services for: - A microcontroller
reset triggered by software - Selecting microcontroller states (STOP, SLEEP, HALT, etc.) - Con-
figuring wake up behavior - Managing the internal PLL clock unit - Initializing RAM areas with
predefined values.
MemIf
(Memory Abstraction Interface ) This module provides uniform access to the services of ( Ea
and ( Fee. This lets you use multiple instances of these modules.
Mfl
(Mathematical Floating Point) Library with arithmetic functions for floating point values
Mfx
(Mathematical Fixed Point) Library with arithmetic functions for fixed point values
Nm
(Generic Network Management Interface ) The Nm module offers a general and network-inde-
pendent interface for accessing the bus-dependent network management modules (( CanNm,
(LinNm, ( UdpNm and ( FrNm). In addition, the module handles synchronous, inter-network
shutdown of the communication system in coordination with the other ECUs.
NvM
(Non Volatile RAM Manager ) The NvM module manages, reads and writes data to a nonvolatile
memory (( Ea or ( Fee). At system start and at shutdown, it synchronizes the data in the RAM
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 221-

---

V Glossary
User Manual Startup with GM SLP2
areas of the application. The module provides services such as saving of redundant blocks for
a higher level of data protection. Since AR 4.0.3, the ( RTE also provides a simpler and more
flexible interface to Nv data (NvDataInterfaces).
Ocu
(Output Compare Unit Driver) The OCU driver standardizes initialization and access to the Out-
put Compare Unit.
Os
(Operating System) This module is the operating system of an AUTOSAR ECU. It is actually an
extended OSEK operating system. Extensions are divided into so-called Scalability Classes
(SC1-SC4). They cover the following functionalities: - SC1: schedule tables - SC2: timing pro-
tection + schedule tables - SC3: memory protection + schedule tables - SC4: memory pro-
tection + timing protection + schedule tables In safety-related ECUs, the OS is one of the
safety-related modules. The operating system also supports multi-core microcontrollers.
PduR
(PDU Router ) The PDU Router handles distribution of the communication packets (PDUs)
between the bus systems and the various BSW modules. In addition it offers gateway mech-
anisms for routing PDUs (FIFO) and TP-PDUs (on-the-fly) between the bus systems.
Port
(Port Driver ) This module is responsible for initialization of the entire port structure of the
microcontroller.
PTP
(Precision Time Protocol) The PTP module is used to distribute a precise system time to all
devices participating in an AVB network. It is implemented according to IEEE 802.1AS. The
implementation consists of microprocessor-dependent and independent parts.
Pwm
(Pulse Width Modulation Driver ) The Pwm driver provides services for initialization and con-
trol of the PWM (pulse-width modulation) channels of the microcontroller.
RamTst
(Ram Test) This module tests internal microcontroller RAM cells. A complete test is triggered
during startup and shutdown of the ECU or by a diagnostic command. During normal operation,
a periodic test is performed (block-by-block or cell-by-cell).
Rte
(Runtime Environment ) The RTE implements the Virtual Functional Bus and the execution of
the SWCs. It also ensures consistent data exchange between the SWCs themselves and
between the SWCs and the basic software. The execution of the basic software is realized by
the integrated ( SchM. The RTE also supports communication beyond partition boundaries
(multi-core/trusted/untrusted). In addition, it offers simplified access to NVRAM data and cal-
ibration data. In safety-related ECUs, the RTE is one of the safety-related modules.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 222-

---

V Glossary
User Manual Startup with GM SLP2
Rtm
(Runtime Measurement) You use the Rtm module to determine the runtime and CPU load of
BSW modules and of application code. The module is typically used during development.
SCC
(Smart Charge Communication) This module is responsible for smart charge communication
according to ISO 15118 or DIN 70121 and contains the V2GTP transport protocol that is used
for this protocol. It supports DC and AC charging and the associated profiles Plug-and-Charge
(PnC) and External Identification Means (EIM).
SchM
(BSW Scheduler) The SchM module is integrated in the ( RTE, calls the periodic “main” function
of the individual BSW modules, and provides functions for critical sections. For the distribution
of the BSW (master satellite concept) via partitions and core boundaries, the SchM provides
nearly identical communication interfaces like the ( RTE.
Sd
(Service Discovery) Service Discovery was first specified in AR 4.1.1. An ECU communicates
the availability of its services to communication partners via the publish-subscribe protocol
implemented in this module. In addition, ECUs can register to receive automatic notifications,
e.g. on a signal update.
SecOC
(Secure Onboard Communication) The SecOC is used to send or receive authenticated mes-
sages. Unauthorized, repeated or manipulated messages are detected. The SecOC is part of
the AUTOSAR security solution.
She
(Secure Hardware Extension) The She driver implements the cryptographic hardware func-
tions of a Hardware Security Module (HSM). This functionality is used by the ( Csm module, for
instance.
SoAd
(Socket Adaptor) The socket adaptor converts the communication via PDUs as it is defined in
AUTOSAR into a socket-based communication. In AR 4.0, the SoAd also contains the diagnostic
functionality defined in ISO 13400-2 ((DoIP). Since AR 4.1, this plug-in is removed and spe-
cified as a stand-alone module (( DoIP).
SomeIpXf
(SOME/IP Transformer) The module SOME/IP Transformer is an RPC and serialization protocol.
It is used to call methods on other ECUs, which for example were made known in the system
beforehand via Service Discovery (( Sd).
Spi
(SPI Handler/ Driver) The SPI Driver handles data exchange over the SPI interface. It is
primarily used in conjunction with external hardware such as EEPROM, Watchdog, etc.
StbM
(Synchronized Time-Base Manager) The Synchronized Time-Base Manager enables time syn-
chronization. Since AR 4.2 a time base prescribed by the Time Master can be synchronized
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 223-

---

V Glossary
User Manual Startup with GM SLP2
with other ECUs via bus systems.
TcpIp
(TCP/IP Stack) This module contains all protocols for UDP and TCP-based communication. It
supports the versions IPv4 and IPv6 as well as parallel operation of IPv4 and IPv6 in one ECU.
It contains the following protocols: - IPv4, ICMPv4 and ARP - IPv6, ICMPv6 and NDP - UDP,
TCP, DHCPv4 (client) and DHCPv6 (client)
TLS
(Transport Layer Security) This module contains a Transport Layer Security client. The TCP-
based communication is encrypted with TLS. The encryption algorithm used can be selected.
Tm
(Time Services) The Tm module is used for such tasks as measuring execution times and func-
tions and implementing active waiting. It offers a resolution from 1µs to 4.9 days.
Ttcan
(TTCAN Driver) The TTCAN Driver offers the same functionality for a TTCAN controller (ISO
11898-4) as the CAN Driver (( Can) does for a CAN controller.
TtcanIf
(TTCAN Interface) The TTCAN Interface offers the same functionality for a TTCAN controller
(ISO 11898-4) as the CAN Interface (( CanIf) does for a CAN controller.
UdpNm
(UDP Network Management) You use network management over UDP to implement syn-
chronous transition to sleep mode for Ethernet ECUs.
Wdg
(Watchdog Driver) This module provides services for controlling and triggering the watchdog
hardware. The trigger routine is called by the Watchdog Manager (( WdgM). For safety-related
ECUs, the Wdg module must be developed according to ISO 26262.
WdgIf
(Watchdog Interface) This module enables uniform access to services of the Watchdog Driver
(( Wdg), such as mode switching and triggering. For safety-related ECUs, the WdgIf module
must be developed according to ISO 26262.
WdgM
(Watchdog Manager ) The Watchdog Manager monitors the reliability and functional safety of
the applications in an ECU. This includes monitoring for correct execution of SWCs and BSW
modules and triggering of the watchdogs at the required time intervals. The WdgM module
reacts to potential faulty behavior with multiple escalation stages. An important fact for
safety-related functions according to ISO 26262 is the monitoring of correct flow sequences of
critical tasks (logical supervision). For safety-related ECUs, the WdgM must be developed
according to ISO 26262.
Xcp
(Universal Measurement and Calibration Protocol) XCP is a protocol for communication
between a master (PC tool) and a slave (ECU). It is standardized by ASAM and is used
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 224-

---

V Glossary
User Manual Startup with GM SLP2
primarily for measuring, calibrating, flashing and testing ECUs. XCP supports the bus systems
CAN (( CanXcp), FlexRay (( FrXcp), Ethernet (( EthXcp) and LIN (( LinXcp).
XML Security
(XML Security) You use this module to generate and validate XML signatures to EXI-encoded
data based on the W3C XML security standard. It is used in the Vehicle2Grid environment.
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 225-

---

VI Index
User Manual Startup with GM SLP2
VI Index
E
A
ECU Instance 162
Alarm 147, 192
Event 38
Assistant
I
Component Connection Assistant 56
Installation Guide 19
Data Mapping Assistant 58
Project Assistant 52, 56, 78, 123, 125
P
Task Mapping Assistant 60
Project folder 123
B
R
Basic Editor 49, 86-87, 134, 145, 166, 174
Runnables 61, 71, 88, 139
BSW Modules
S
CANIF 38, 142, 179
Start Menu 23
C
T
Configuration Editors 36, 87
Task 48, 60, 109
Base Services 36
Communication 20, 37, 73, 83, 183
Diagnostics 38, 73
Memory 40, 71, 109, 120, 136, 144, 204
Mode Management 41
Network Management 46
Runtime System 47, 56, 139
D
DaVinci Configurator
Input Files 24, 121, 161
On-demand Validation 49
Project Settings 18, 24, 80, 83, 120, 122,
159, 165
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 226-

---

User Manual Startup with GM SLP2
Get more Information!
Visit our Website for:
> News
> Products
> Demo Software
> Support
> Training Classes
> Addresses
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 227-

---

User Manual Startup with GM SLP2
www.vector.com
© Vector Informatik GmbH
Version 3.0.0 for Release 12
- 228-

---

Document Outline

• 1 About This Manual
  • 1.1 History Information
  • 1.2 Finding Information Quickly
  • 1.3 Conventions
  • 1.4 Certification
  • 1.5 Warranty
  • 1.6 Support
  • 1.7 Registered Trademarks
  • 1.8 Errata Sheet of Hardware Manufacturers
  • 1.9 Example Code
• 2 Introduction
  • 2.1 What Do You Learn from This Manual
  • 2.2 An Overall View
  • 2.3 MICROSAR - Vector's AUTOSAR Solution
  • 2.4 AUTOSAR Layer Model GM SLP2
  • 2.5 Configuration Workflow GM SLP2
• I STEPbySTEP
• 1 STEP1 Setup Your Project
  • 1.1 Situation after Installation Guide
  • 1.2 Setup Project via DaVinci Configurator Pro
  • 1.3 Result Project Folder - result of the project set-up
  • 1.4 Start Menu - Result of the Project Set-up
  • 1.5 DaVinci Configurator Pro Project
• 2 STEP2 Define Project Settings
  • 2.1 Add Input Files
    • 2.1.1 Add System Description Files
    • 2.1.2 Add Diagnostic Data Files
    • 2.1.3 Add Standard Configuration Files
    • 2.1.4 Update Configuration
  • 2.2 Define Custom Workflow Steps and External Generation Steps
    • 2.2.1 Custom Workflow Steps
    • 2.2.2 External Generation Steps
  • 2.3 Activate Your BSW Modules
  • 2.4 Add ECUC File References
• 3 STEP3 Validation
  • 3.1 Start Solve All Mechanism
  • 3.2 Live Validation - Solving Actions
• 4 STEP4 Start BSW Configuration
  • 4.1 Start Configuration with Configuration Editors
  • 4.2 Base Services
  • 4.3 Communication
  • 4.4 Diagnostics
  • 4.5 I/O
  • 4.6 Memory
  • 4.7 Mode Management Editors
  • 4.8 Network Management
  • 4.9 Runtime System
    • 4.9.4 Create Tasks
  • 4.10 Go on with Basic Editor
  • 4.11 Start Solving Actions
  • 4.12 Start On-demand Validation
  • 4.13 BSW Configuration finished
• 5 STEP5 Design Software Components
  • 5.1 Switch to DaVinci Developer
  • 5.2 Design Software Components
• 6 STEP6 Mappings
  • 6.1 Perform Data Mapping within DaVinci Developer or DaVinci Configurator?
  • 6.2 Data Mapping within the DaVinci Developer
    • 6.2.3 DaVinci Developer - Save and close
  • 6.3 Switch (back) to DaVinci Configurator
  • 6.4  Synchronize System Description
  • 6.5 Add Component Connection
  • 6.6 Service Mapping
  • 6.7 Add Data Mapping
  • 6.8 Add Memory Mapping
  • 6.9 Add Task Mapping
• 7 STEP7 Code Generation
  • 7.1 Start Custom Workflow Steps
  • 7.2 Start Code Generation
  • 7.3 Generation Process finished!
• 8 STEP8 Add Runnable Code
  • 8.1 Component Template
  • 8.2 Implement Code
• 9 STEP9 Compile and Link Your Project
  • 9.1 Finish your project with compiling and linking
  • 9.2 Congratulations, that’s it!
• II Concept
• 1 General Overview
  • 1.1 Software Component
    • 1.1.1 Atomic components
    • 1.1.2 Compositions
  • 1.2 Runnables
  • 1.3 Ports
    • 1.3.1 Application Port Interfaces
    • 1.3.2  Service Port Interfaces
  • 1.4 Data Element Types
  • 1.5 Connections
  • 1.6 RTE
  • 1.7 BSW – Basic Software Modules
  • 1.8 Software, Tools and Files
  • 1.9 Structure of the SIP Folder
• 2 Set-Up New Project
  • 2.1 DaVinci Configurator
• 3 Define Project Settings
  • 3.1  Input files
    • 3.1.1 System Description Files
    • 3.1.5 Diagnostic Data Files
    • 3.1.8 Standard Configuration Files
  • 3.2 Custom Workflow Steps / External Generation Steps
  • 3.3 Activate BSW
• 4 Validation
  • 4.1 Validation Concept
• 5 BSW Configuration with Configuration Editors
  • 5.1 DaVinci Configurator Pro Editors
• 6 Software Component (SWC) Design
  • 6.1 Data Exchange between DaVinci Developer and DaVinci Configurator Pro
  • 6.2 About Application Components, Ports, Connections, Runnables and More…
  • 6.3 Application Components
  • 6.4 Ports, Port Init Values and Data Elements
  • 6.5 Configure Service Ports within your Application Components
  • 6.6  Define your Runnables
  • 6.7 Triggers for the Runnables
  • 6.8 Port Access of the Runnables
• 7 Mappings
  • 7.1 Data Mapping
  • 7.2 Task Mapping
    • 7.2.1 Information about Interaction between Runnable, Re-entrance and Task Mapping
  • 7.3 Memory Mapping
  • 7.4 Service Mapping
• 8 Generation
  • 8.1 MICROSAR Rte Gen
• 9 Runnable Code
• 10 Compile and Link
  • 10.0.1 Using your real hardware
• III Additional Information
• 1 Update Input Files
  • 1.1 System Description Files
  • 1.2 Diagnostic Data Files
• 2 Update Project Settings
• 3 Support Request via DaVinci Configurator Pro
  • 3.1 Result
• 4 Multiple User Concept
  • 4.1 General
  • 4.2 Split Files for Software Component and ECU Project Configuration
  • 4.3 Configure Software Component Prototype
  • 4.4 Configure ECU project
  • 4.5 Split Files in DaVinci Developer
  • 4.6 Split Files for BSW Configuration
• 5 Configuration Update
  • 5.1 Release x-1 to Release x (necessary steps for any update)
  • 5.2 Release 8 to Release 9
  • 5.3 Release 7 to Release 8
• 6 Update DaVinci Tools
  • 6.1 DaVinci Configurator Pro
  • 6.2 DaVinci Developer
• 7 Non-Volatile Memory Block
  • 7.1 Configure and use Non-Volatile Memory Block
  • 7.2 Port Access of your Runnables
  • 7.3 Memory Mapping in DaVinci Configurator Pro
  • 7.4 Validate the RTE
• 8  CANoe osCAN Library
  • 8.1 Emulate your project with CANoe
• 9 Basic Software Modules
  • 9.1 Generic BSW Modules
  • 9.2 What is a BSW Module?
  • 9.3 What Forms a BSW Module?
  • 9.4 BSW Module Configuration
  • 9.5 BSW Initialization
    • 9.5.1 <Msn>_InitMemory()
    • 9.5.2 <Msn>_Init()
  • 9.6 BSW Module Version (xxx_GetVersionInfo)
  • 9.7 Cyclic Calls
    • 9.7.1 <Msn>_MainFunction()
  • 9.8 Service Functions
    • 9.8.1 Client Server Theory
  • 9.9 Critical Sections - Exclusive Areas
    • 9.9.1 Memory Section
    • 9.9.2 Switch <MSN> Modules Off
• 10 Command Line Parameters of the DaVinci Configurator
  • 10.1 Common parameters
  • 10.2 Command Line Interface Use Cases
  • 10.3 Usecase With GUI (only DaVinciCFG.exe)
  • 10.4 Use Case DaVinci Configurator CodeGenerator
  • 10.5 Use Case DaVinci Configurator Execute Converter
  • 10.6 Use Case BaseEcucGenerator (create initial empty project, without GUI)
  • 10.7 Use Case EcucUpdater (without GUI)
  • 10.8 Use Case DaVinci Configurator Exporter (without GUI)
  • 10.9 Use Case DaVinci Configurator Sign Script
  • 10.10 Return Codes
• 11 Variant Handling
  • 11.1 Define Criterion and Variants
  • 11.2 Add and Assign Input Files to Variants
  • 11.3 Define Variance for BSW Modules
  • 11.4 Configure and Validate BSW
• 12 Add Module Stubs from AUTOSAR definition
• 13 TCP/IP stack migration of projects based on MICROSAR R11 and earlier (due to FEAT-261)
  • 13.1 SD – Service Discovery
  • 13.2 TCPIP - Transmission Control Protocol / Internet Protocol
  • 13.3 SOAD - Socket Adapter
• 14 SIP Update
• 15 Platform Types
  • 15.1 Location of the common definition
  • 15.2 Import/Export behavior
  • 15.3 Service components use the new Platform Types
    • 15.3.1 Old types
    • 15.3.2 New types
  • 15.4 Replacement of old developer standard types (Replace legacy Data Types)
• 16 Frequently Asked Questions
  • 16.1 Annotations for any parameter
  • 16.2 Find Reference Container
    • 16.2.1 How to find references using the [Find] dialog
• 17 Release Notes
  • 17.1 Release 12
  • 17.2 Release 11.1
  • 17.3 Release 8
  • 17.4 Release 7.1
  • 17.5 Release 7
  • 17.6 Release 6
• IV What’s New, What’s Changed
• V Glossary
• VI Index
• Lesezeichen
  • Add
  • Update
  • Custom
  • Activate
  • Start
  • Perform
  • Switch

---