MICROSAR Adaptive r3.

x
Installation Guide

Document Version 3.01.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 and Install Components 6

3 Update 8

3.1 MICROSAR Adaptive SIP 8

3.2 DaVinci Adaptive Command Line Interface 8

3.2.1 Access to the Vector Portal 8

3.2.2 Download and Update 8

4 Reference Documents 10

5 Contact 11

© Vector Informatik GmbH Version 3.01.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.

If you have also ordered the DaVinci Adaptive Tool Suite, the MICROSAR Adaptive SIP is delivered
seperately.

Cross Reference

Refer to the Vector KnowledgeBase for the installation of the DaVinci Adaptive Tool
Suite: https://support.vector.com/kb/?id=kb_article_view&sysparm_
article=KB0012477.

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.

Note

The mentioned placeholders are only examples. If you use a different structure, you
must adapt the commands in this document accordingly.

© Vector Informatik GmbH Version 3.01.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 1.1.1 (required for decryption)
> CMake version 3.19 or higher
> gcc, gdb
> Zsh, oh-my-zsh, ssh, minicom, screen
> Eclipse, atom, emacs, nano, vi/m, vim-gnome
> Python 3.x
> Git, gitk
> Valgrind, smem, massif-visualizer
> Yocto build system version 2.6.4
Optional: Docker Docker CE for Ubuntu version 18.06.01 or higher (e.g. 19.03.01).

Refer to the Docker documentation for the installation of Docker CE for

Ubuntu Reference Documents on page 10 and the configuration of
Docker to use a proxy server Reference Documents on page 10 in
section Reference Documents.

2.2 Decrypt and Extract Delivery

The decryption and extraction of your delivery is described in the first delivery e-mail that you have
received from Vector. If not already done, you can decrypt and extract the delivery as follows:

1. Please ensure that OpenSSL is installed as it is required for decryption. As an alternative to

OpenSSL, you can use Vector's Delivery Decryption Tool as described here:
https://support.vector.com/kb/?id=kb_article_view&sysparm_article=KB0012476.

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

3. Copy the delivered MICROSAR Adaptive SIP file (<CBDyyxxxx>_<Dzz>.tar.gz.enc) into this
folder.
4. Open a Terminal in the created <CBDyyxxxx> folder.
5. Note that in the following commands 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:
sudo 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>
6. Extract the delivery with the following command:
sudo tar -xzf <CBDyyxxxx>_<Dzz>.tar.gz

© Vector Informatik GmbH Version 3.01.02 - 4-

Installation Installation Guide MICROSAR Adaptive

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

> 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.
> 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. The subfolder amsr-vector-docker contains the Docker
files and shell scripts to build and run the example project with Docker.
> Generators
This folder contains all applied code generators used by the MICROSAR Adaptive 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.

© Vector Informatik GmbH Version 3.01.02 - 5-

Installation Installation Guide MICROSAR Adaptive

2.3 Build and Install 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>/).

2. Build the components by entering the following command:

> General build command:

Note that the placeholders in the following command must be adapted.

./BuildHelper/BuildHelper -s . -b <build directory path> --cmake-

optionsfile <configuration json> --cmake-toolchain-file <toolchain_path>
--install <installation path> –-model-dir <model path>

The SIP folder ./Examples/amsr-vector-example-configurations/ contains sample

model configurations for different operating systems, such as for QNX7.0, QNX7.1 or a
default model for Linux.

These models are samples only and may need to be adapted to meet your requirements,
such as setting the network interface parameters of your target system.

> Linux:

./BuildHelper/BuildHelper -s . -b build/native-gcc --cmake-options-file

./BuildHelper/config/development.json --install install/install_linux
--model-dir ./Examples/amsr-vector-example-configurations/
VectorDeliveryDefaultModel/

> QNX:

Note that the placeholder for the toolchain <toolchain_path> must be adapted depending
on the applied QNX version, e.g. QNX 7.0 uses ./CMakeSupport/toolchain/qcc/qcc-
5/aarch64/qnx-7.0_release.toolchain.

The same has to be taken into account for the applied models, e.g. QNX7.0 uses the
VectorDeliveryQNX7_0Model.

Command for QNX7.0, qcc-5:

./BuildHelper/BuildHelper -s . -b build/qnx-qcc --cmake-options-file

./BuildHelper/config/development.json --cmake-toolchain-file
./CMakeSupport/toolchain/qcc/qcc-5/aarch64/qnx-7.0_release.toolchain
--install install/install_qnx --model-dir ./Examples/amsr-vector-
exampleconfigurations/VectorDeliveryQNX7_0Model

The artifacts of the components required for the execution of the MICROSAR Adaptive stack are
installed to the install directory.

© Vector Informatik GmbH Version 3.01.02 - 6-

Installation Installation Guide MICROSAR Adaptive

Cross Reference

Refer to the TechnicalReference_BuildHelper.pdf that is stored in the MICROSAR

Adaptive SIP folder /Doc/TechnicalReferences for more information.

© Vector Informatik GmbH Version 3.01.02 - 7-

Update Installation Guide MICROSAR Adaptive

3 Update

This section describes the update of your MICROSAR Adaptive SIP andthe DaVinci Adaptive Command
Line Interface.

3.1 MICROSAR Adaptive SIP

To update your MICROSAR Adaptive SIP, delete the content of the existing SIP folder and proceed as
described in section Decrypt and Extract Delivery.

3.2 DaVinci Adaptive Command Line Interface

If you have already access to the DaVinci Eclipse IDE Integrations member of the Vector Portal, refer
to section Download and Update on page 8. Otherwise, start with section Update on page 8 first.

3.2.1 Access to the Vector Portal

To download the DaVinci Adaptive Configurator command line tool, an account at the Vector Portal and
access to the DaVinci Eclipse IDE Integrations member area are required. If not yet existing, you can
acquire access to the member area as follows:

1. If you do not have an account at the Vector Portal yet, please register at
https://portal.vector.com/en_US/register.

2. To get access to the DaVinci Eclipse IDE Integrations member area, use the support request
form at https://vector.com/vi_support-request_en.html and enter the following data:

> E-Mail Address: <please enter the e-mail address of your account at the Vector
Portal>

> First Name: <please enter your first name>

> Last Name: <please enter your last name>

> Subject: Portal User Account

> Description:
Please give me access to the „DaVinci Eclipse IDE Integrations“ Member Area.
My license/serial number: <please add the CBD number of your MICROSAR
Adaptive SIP here>

> Affected Products: Vector Products

3. Wait for the confirmation from the Vector Support.

After receiving the confirmation from the Vector Support, you can sign in at the Vector Portal
https://portal.vector.com and you have access to the DaVinci Eclipse IDE Integrations member area.
Then you can download and update the DaVinci Adaptive Configurator command line tool as described
in the following section Download and Update on page 8.

3.2.2 Download and Update

To update the DaVinci Adaptive Command Line Interface, proceed as follows:

© Vector Informatik GmbH Version 3.01.02 - 8-

Update Installation Guide MICROSAR Adaptive

1. Navigate to the Vector Portal site: https://portal.vector.com/web/davinci-eclipse-ide-

integrations#/DaVinci%20Adaptive/DaVinci%20Adaptive%20CLI.
2. Use the Compatibility Matrix (refer to https://support.vector.com/kb/?id=kb_article_
view&sysparm_article=KB0012181) to find out the compatible version of the DaVinci Adaptive
Configurator.
3. Open the DaVinci Adaptive CLI folder with the same version number as specified in the
compatibility matrix for the DaVinci Adaptive Configurator.
4. Download the ZIP file for Linux or for Windows.
5. Extract the downloaded ZIP file.
6. Open a terminal in the folder where you have extrated the ZIP file. To update one or more
MICROSAR Adaptive SIPs, enter the following command (adapt the placeholders):
sudo ./DvACfgInstaller.sh -cfg <path to the /DaVinciConfigurator/Core/ folder in
your MICROSAR Adaptive SIP> -sip <path to your MICROSAR Adaptive SIP>

The DaVinci Adaptive Command Line Interface of your SIP is now updated.

© Vector Informatik GmbH Version 3.01.02 - 9-

Reference Documents Installation Guide MICROSAR Adaptive

4 Reference Documents

No. Source Title and Description

[1] Docker Install Docker Engine on Ubuntu
https://docs.docker.com/install/linux/docker-ce/ubuntu/
[2] Docker Configure Docker to use a proxy server
https://docs.docker.com/network/proxy/

© Vector Informatik GmbH Version 3.01.02 - 10-

Contact Installation Guide MICROSAR Adaptive

5 Contact

Visit our website for more information on

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

www.vector.com

© Vector Informatik GmbH Version 3.01.02 - 11-