Adaptive MICROSAR

Installation Guide

Version 3.00.00
Content Installation Guide Adaptive MICROSAR

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 5

2.3 Build Components 6

3 Update 7

3.1 Adaptive MICROSAR SIP 7

3.2 DaVinci Adaptive Configurator 7

3.2.1 Access to the Vector Portal 7

3.2.2 Download and Update 8

4 Reference Documents 9

5 Contact 10

© Vector Informatik GmbH Version 3.00.00 - 2-

Introduction Installation Guide Adaptive MICROSAR

1 Introduction

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

1.1 Delivery Overview

The Adaptive MICROSAR 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 Adaptive MICROSAR SIP delivery.

Refer to chapter Installation for the installation.

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

Cross Reference

Refer to the Vector KnowledgeBase for the installation of the DaVinci Adaptive Tool Suite:
https://kb.vector.com/entry/1667/.

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 Adaptive MICROSAR SIP.
> <Dzz>
Replace <Dzz> with the delivery number of your Adaptive MICROSAR SIP.

Note

The stated placeholders are examples and can be adapted.

© Vector Informatik GmbH Version 3.00.00 - 3-

Adaptive MICROSAR SIP Installation Guide Adaptive MICROSAR

2 Installation

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

2.1 System Requirements

The following system requirements apply:

Operating System: Ubuntu (recommended)

Additional Software: > OpenSSL (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
> Git, gitk
> Cloc
> Doxygen
> Valgrind, smem, massif-visualizer
> Yocto build system version 2.6.4
Docker: Docker CE for Ubuntu version 18.06.01

Cross Reference

Refer to the Docker documentation for the installation of

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

© Vector Informatik GmbH Version 3.00.00 - 4-

Adaptive MICROSAR SIP Installation Guide Adaptive MICROSAR

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 Adaptive MICROSAR 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 Adaptive MICROSAR SIP with the following content was extracted to the subfolder
/home/<username>/SIP/<CBDyyxxxx>/delivery-<CBDyyxxxx>-<Dzz>:

> BSW
This folder contains the Adaptive MICROSAR basic software (BSW).
> BuildHelper
This folder contains the BuildHelper that builds the components of the Adaptive MICROSAR 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
Adaptive MICROSAR 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 Adaptive MICROSAR 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 Adaptive
MICROSAR.

Note

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

© Vector Informatik GmbH Version 3.00.00 - 5-

Adaptive MICROSAR SIP Installation Guide Adaptive MICROSAR

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 Adaptive MICROSAR stack are installed to the
builds/install directory.

Cross Reference

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

/Doc/TechnicalReferences.

© Vector Informatik GmbH Version 3.00.00 - 6-

Update Installation Guide Adaptive MICROSAR

3 Update

This section describes the update of your Adaptive MICROSAR SIP and DaVinci Adaptive Configurator.

3.1 Adaptive MICROSAR SIP

To update your Adaptive MICROSAR SIP, proceed as described in section Decrypt and Extract Delivery.

Note

It is highly recommended to create a new folder! Therefore, as described in section

Adaptive MICROSAR SIP on page 5, a new subfolder with the new delivery number <Dzz> is
created automatically (/delivery-<CBDyyxxxx>-<Dzz>).

3.2 DaVinci Adaptive Configurator

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 7 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 Adaptive
MICROSAR 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.

© Vector Informatik GmbH Version 3.00.00 - 7-

Update Installation Guide Adaptive MICROSAR

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 Configurator command-line tool, proceed as follows:

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://kb.vector.com/entry/1365/) 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
Adaptive MICROSAR SIPs, enter the following command (adapt the placeholders):
./DvACfgInstaller.sh -cfg <path to the Core folder in your Adaptive MICROSAR SIP>
-sip <path to your Adaptive MICROSAR SIP>

The DaVinci Adaptive Configurator command-line tool of your SIP is now updated.

© Vector Informatik GmbH Version 3.00.00 - 8-

Reference Documents Installation Guide Adaptive MICROSAR

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.00.00 - 9-

Contact Installation Guide Adaptive MICROSAR

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.00.00 - 10-