MICROSAR Adaptive r2.

x
Installation Guide

Version 2.00.02
Content Installation Guide MICROSAR Adaptive

Content

1 Introduction 3

1.1 Delivery Overview 3

1.2 Used Placeholders 3

2 Installation 4

2.1 System Requirements 4

2.2 Decrypt and Extract Delivery 4

2.3 Build Components 5

3 DaVinci Adaptive IDE 7

3.1 System Requirements 7

3.2 Install DaVinci Adaptive IDE on Linux 7

3.2.1 Extract DaVinci Adaptive IDE 7

3.2.2 Open DaVinci Adaptive IDE 7

3.2.3 Set Preferences 8

3.2.4 Add Project 8

3.2.5 Activate DaVinci Adaptive Support 8

3.3 Activate Tool License 8

3.3.1 License Activation on Windows 8

3.3.2 License Activation on Linux/Virtual Machines 9

4 Contact 10

© Vector Informatik GmbH Version 2.00.02 - 2-

Introduction Installation Guide MICROSAR Adaptive

1 Introduction

This document gives a short overview of the first steps after you have received your MICROSAR
Adaptive delivery and how to update.

1.1 Delivery Overview

The MICROSAR Adaptive SIP is delivered via e- mail as a packed and encrypted archive file
(*.tar.gz.enc). You have received two e-mails from Vector:

1. One e-mail with the download link and

2. one e-mail with the password to decrypt the MICROSAR Adaptive SIP delivery.

Refer to chapter Installation for a description of the installation steps.

If the DaVinci Adaptive IDE is part of your delivery, it is delivered as ZIP file together with the first
delivery of your MICROSAR Adaptive SIP. Refer to DaVinci Adaptive IDE for the installation.

1.2 Used Placeholders

This document uses the following placeholders:

> <username>
Replace <username> with your Linux user name. You can find out your Linux user name by entering
the command whoami in the Terminal.
> <CBDyyxxxxx>
Replace <CBDyyxxxxx> with the license number of your MICROSAR Adaptive SIP.
> <Dzz>
Replace <Dzz> with the delivery number of your MICROSAR Adaptive SIP.

Note

The stated placeholders are examples and can be adapted.

© Vector Informatik GmbH Version 2.00.02 - 3-

Installation Installation Guide MICROSAR Adaptive

2 Installation

This section describes the system requirements and the installation of your MICROSAR Adaptive SIP.

2.1 System Requirements

The following system requirements apply:

Operating System: Ubuntu (recommended)

Additional Software: > OpenSSL (required for decryption)
> CMake version 3.15.5 or higher
> gcc, gdb
> Zsh, oh-my-zsh, ssh, minicom, screen
> Eclipse, atom, emacs, nano, vi/m, vim-gnome
> Python
> Git, gitk
> Cloc
> Doxygen
> Valgrind, smem, massif-visualizer
> Yocto build system

2.2 Decrypt and Extract Delivery

To decrypt and extract the delivery, proceed as follows:

1. Create a new folder /home/<username>/SIP/<CBDyyxxxx>

2. Copy the delivered MICROSAR Adaptive SIP file (<CBDyyxxxx>_<Dzz>.tar.gz.enc) into this
folder.
3. Open a Terminal and navigate to the created <CBDyyxxxx> folder.
4. Note that in the following command the placeholders for the file name <CBDyyxxxx>_<Dzz> and the
password that you have received with the second delivery e-mail <ArchivePassword> must be
adapted. Decrypt the delivery with the following command:
openssl aes-256-cbc -d -md sha256 -pbkdf2 -iter 1000 -salt -in <CBDyyxxxx>_
<Dzz>.tar.gz.enc -out <CBDyyxxxx>_<Dzz>.tar.gz -pass pass:<ArchivePassword>
5. Extract the delivery with the following command:
tar -xvzf <CBDyyxxxx>_<Dzz>.tar.gz -C /home/<username>/SIP/<CBDyyxxxx>

The MICROSAR Adaptive SIP with the following content was extracted to the subfolder
/home/<username>/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>:

> BSW
This folder contains the MICROSAR Adaptive basic software (BSW).
> BuildHelper
This folder contains the BuildHelper that builds the components of the MICROSAR Adaptive stack.

© Vector Informatik GmbH Version 2.00.02 - 4-

Installation Installation Guide MICROSAR Adaptive

> CMakeSupport
This folder contains the CMake files that are used e.g. to compile, link libraries and create archives.
> DaVinci Configurator
This folder contains the DaVinci Adaptive Configurator command line tool that is used to run the
MICROSAR Adaptive code generators.
> Doc
This folder contains the documentation of the delivery.
> Examples
This folder contains an example project.
> Generators
This folder contains all applied code generators used by the MICROSAR Adaptive components.
> VersionInfo
This folder contains the versions of the components.
> ThirdPartySrc
This folder contains the source code of third party software, which is applied by the MICROSAR
Adaptive.

Note

Depending on the scope of your delivery, the content may differ.

2.3 Build Components

To compile and install all components into default directories, proceed as follows:

1. Open the Terminal and navigate to the SIP folder (e.g.

/home/<username>/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>).
2. Build the components by entering the following command:
> Linux users:
./BuildHelper/BuildHelper -s . -b build --cmake-options-file
./BuildHelper/config/development.json --install --model-dir
./Examples/amsr-vector-example-configurations/VectorDeliveryDefaultModel/
> QNX or other build systems (note that the placeholder for the toolchain <toolchain_
path> must be adapted, e.g. ./CMakeSupport/toolchain/qcc/qcc-5/aarch64/qnx-7.0_
release.toolchain):
./BuildHelper/BuildHelper -s . -b build --cmake-options-file
./BuildHelper/config/development.json --cmake-toolchain-file <toolchain_
path> --install --model-dir ./Examples/amsr-vector-example-
configurations/VectorDeliveryDefaultModel/

The compiled modules are built into the builds/native-gcc directory. The artifacts of the
components required for the execution of the MICROSAR Adaptive stack are installed to the
builds/install directory.

© Vector Informatik GmbH Version 2.00.02 - 5-

Installation Installation Guide MICROSAR Adaptive

Cross Reference

Refer to TechnicalReference_BuildHelper.pdf that is stored in the SIP folder

/Doc/TechnicalReferences.

© Vector Informatik GmbH Version 2.00.02 - 6-

DaVinci Adaptive IDE Installation Guide MICROSAR Adaptive

3 DaVinci Adaptive IDE

The DaVinci Adaptive IDE is part of the DaVinci Adaptive Tool Suite. This section describes the system
requirements, the installation and the license activation of the DaVinci Adaptive IDE.

3.1 System Requirements

The following system requirements apply:

Operating System: Linux, Windows

(To use the full basic software features the Linux platform is currently
necessary.)

3.2 Install DaVinci Adaptive IDE on Linux

3.2.1 Extract DaVinci Adaptive IDE

To unzip the DaVinci Adaptive IDE proceed as follows:

1. Create a new folder for the DaVinci Eclipse IDE (for example: /home/<username>/DvAIDE)
2. Create an IDE folder with the license and delivery number in the DaVinci Eclipse IDE directory (for
example: /home/<username>/DvAIDE/ide_<CBDyyxxxx>-<Dzz>)

3. Copy the DaVinci Adaptive IDE ZIP file (see Delivery Overview) into this directory.
4. Open the context menu of the DaVinci Adaptive IDE ZIP file and click Extract to....
5. In the Extract dialog, navigate to the ide_<Dzz> folder and click [Extract].

The DaVinci Adaptive IDE is extracted to your specified folder (for example:
/home/<username>/DvAIDE/ide_<CBDyyxxxx>-<Dzz>).

3.2.2 Open DaVinci Adaptive IDE

Note

Do not execute Eclipse directly. The DaVinci Adaptive IDE must be called through the
script start_DvAIDE.

If you have received the start_DvAIDE script file separately (not contained in the ZIP file, see
Delivery Overview), copy the start_DvAIDE script file into the created IDE directory (for example:
/home/<username>/DvAIDE/ide_<CBDyyxxxx>-<Dzz>).

To open the DaVinci Adaptive IDE proceed as follows:

1. Open the Terminal and navigate to the ide_<CBDyyxxxx>-<Dzz> folder.

2. Open the DaVinci Adaptive IDE by entering the following command:
./start_DvAIDE -g ~/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>/Generators -S

© Vector Informatik GmbH Version 2.00.02 - 7-

DaVinci Adaptive IDE Installation Guide MICROSAR Adaptive

~/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>
Note: You can add -w <workspace-directory> to the command to specify the workspace
directory.

The DaVinci Adaptive IDE opens.

3.2.3 Set Preferences

To set the Eclipse preferences proceed as follows:

1. Open DaVinci Adaptive IDE (refer to Open DaVinci Adaptive IDE on page 7).
2. Open the Window menu and click Preferences.
3. Select DaVinci Adaptive|SIP in the Preferences dialog.
4. Check if the path to your MICROSAR Adaptive SIP (for example:
/home/<username>/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>) is listed in the Available
SIPs area. If not, click [Add...] and browse to the path of your MICROSAR Adaptive SIP.
5. Click [OK] to confirm.

The path of your MICROSAR Adaptive SIP is added to the list of available SIPs in the Eclipse
preferences settings.

3.2.4 Add Project

To add a project to the Project Explorer proceed as follows:

1. Open DaVinci Adaptive IDE (refer to Open DaVinci Adaptive IDE on page 7).
2. Open the menu path File|Import. The Import dialog appears.
3. Select the import wizard Projects from Folder or Archive and click [Next].
4. Click [Directory...] and navigate to the project folder of the project you want to add. Click
[Finish] to confirm.

Your project is added to the environment and is shown in the Project Explorer.

3.2.5 Activate DaVinci Adaptive Support

To activate the DaVinci Adaptive Support for a project proceed as follows:

1. Open the context menu of the project in the Project Explorer.

2. Click Configure|Activate DaVinci Adaptive Support.

The status bar of Eclipse shows the starting of the DaVinci Adaptive Support.

3.3 Activate Tool License

3.3.1 License Activation on Windows

You have received an e-mail with all information about how to activate your tool licenses. Please follow
these instructions.

© Vector Informatik GmbH Version 2.00.02 - 8-

DaVinci Adaptive IDE Installation Guide MICROSAR Adaptive

3.3.2 License Activation on Linux/Virtual Machines

License activation on Linux and Virtual Machines is not yet supported due to technical limitations.
Therefore, the license check in the DaVinci Adaptive IDE is temporary disabled. The tool can be started
even if no license is activated.

Vector reserves the right to enable the license check in future version of the tool.

Cross Reference

Refer to UserManual_DaVinciAdaptiveToolSuite.pdf located in the IDE/doc/ for

more information.

© Vector Informatik GmbH Version 2.00.02 - 9-

Contact Installation Guide MICROSAR Adaptive

4 Contact

Visit our website for more information on

> News
> Products
> Demo software
> Support
> Training data
> Addresses

www.vector.com

© Vector Informatik GmbH Version 2.00.02 - 10-