RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each...

33
RTA-BSW Installation and Getting Started Guide

Transcript of RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each...

Page 1: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW

Installation and Getting Started Guide

Page 2: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

2

Copyright

The data in this document may not be altered or amended without special notification

from ETAS GmbH. ETAS GmbH undertakes no further obligation in relation to this docu-ment. The software described in it can only be used if the customer is in possession of a

general license agreement or single license. Using and copying is only allowed in concur-rence with the specifications stipulated in the contract.

Under no circumstances may any part of this document be copied, reproduced, transmit-

ted, stored in a retrieval system or translated into another language without the express written permission of ETAS GmbH.

© Copyright 2018 ETAS GmbH, Stuttgart

The names and designations used in this document are trademarks or brands belonging

to the respective owners.

Document RTA-BSW Installation and Getting Started Guide v2.1.1 R01 EN – 02.2018

Page 3: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 3

Contents

Contents ........................................................................................................................................ 3

1 Introduction ............................................................................................................................ 4

1.1. Applicable Versions .......................................................................................................... 4

1.2. Safety Notice ................................................................................................................... 4

1.3. Definitions and Abbreviations ............................................................................................ 4

1.4. Bibliography ..................................................................................................................... 6

1.5. Conventions ..................................................................................................................... 6

2 How to use this User Guide ...................................................................................................... 7

3 Installation.............................................................................................................................. 8

3.1. RTA-BSW Installation ....................................................................................................... 8

3.2. How to Check Installed RTA-BSW Version .......................................................................... 9

3.3. Software Licensing ......................................................................................................... 10

4 Getting Started ..................................................................................................................... 13

4.1. How to use the RTA-BSW plugins .................................................................................... 13

4.2. Importing an Example Application into ISOLAR-A ............................................................. 17

5 Example Project Tutorial ........................................................................................................ 21

5.1. Project Creation ............................................................................................................. 21

5.2. System Description Creation ........................................................................................... 21

5.3. ASW Configuration ......................................................................................................... 21

5.4. ECU Extract ................................................................................................................... 24

5.5. BSW Configuration and Generation .................................................................................. 25

5.6. OS and RTE ................................................................................................................... 25

5.7. ASW Templates .............................................................................................................. 26

6 BSW Module List ................................................................................................................... 28

7 ETAS Contact Addresses ........................................................................................................ 31

7.1. ETAS HQ ....................................................................................................................... 31

7.2. ETAS Subsidiaries and Technical Support ......................................................................... 31

Index........................................................................................................................................... 32

Page 4: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 4

1 Introduction

The RTA-BSW Installation and Getting Started Guide describes how to install RTA-BSW and what how to start using the product.

RTA-BSW is realized as a plug-in to ETAS’s AUTOSAR Authoring Tool, ISOLAR-A.

1.1. Applicable Versions

At the time of writing the applicable SW versions are:

RTA-BSW v2.1

RTA-OS v5.5

RTA-RTE v5.10.0

ISOLAR-A v9.3

As far as is possible the configuration of RTA-BSW and RTA-RTE uses standard ARXML and therefore the configuration aspects described in this User Guide are also applicable to later

versions of the software.

1.2. Safety Notice

CAUTION!

Any configuration(s) described in this User Guide are provided as an example only and must be reviewed and adapted for specific project requirements before use.

1.3. Definitions and Abbreviations

ARXML

AUTOSAR XML used to describe SWCs, Systems and ECU configurations.

ASW

AUTOSAR Application Software. In AUTOSAR the application consists of multiple communicating SWCs including service, application and complex device driver SWCs.

BSW

AUTOSAR Basic Software module. AUTOSAR defines a comprehensive BSW architecture consisting of service, interface and driver BSW modules that provide a device independent ECU abstraction to ASW and thus promote SWC reuse and relocation. See Section for a list of AUTOSAR BSW modules.

BSW Stack

A slice through the AUTOSAR Layered SW Architecture that comprises functionally related BSW modules from the Service, ECU Abstraction and Microcontroller Abstraction layers.

CAN

Controller Area Network – peer-to-peer message protocol designed for automotive use.

CDD

Complex Device Driver – a custom BSW module for accessing hardware for which AUTOSAR defines no standardized access. The form of the upper interface of a CDD is standardized – ports – and therefore accessible to ASW using the Rte. However, the

Page 5: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 5

functionality provided by the CDD, for example how it accesses hardware, is implementation specific.

DTC

Diagnostic Trouble Code.

ECU

Electronic Control Unit. In the context of AUTOSAR, an ECU comprises one microcontroller/peripherals and associated ASW and AUTOSAR configuration. In particular, AUTOSAR does not consider the mechanical design in the definition of an ECU and thus if a single housing contains multiple microcontrollers each requires its own AUTOSAR configuration and BSW stack.

E/E

Electrical and Electronic.

FlexRay

Automotive bus supporting high data rate communication with a static, time-sliced, segment providing real-time messages and a dynamic segment for event-triggered communication.

EEPROM

Electronically Erasable Programmable Read-only memory.

I-PDU

Interaction Layer PDU.

IOC

Inter-OsApplication Communication – Os API for sending and receiving data between OsApplications.

MCAL

Microcontroller Abstraction Layer – the lowest software layer of the Basic Software within the AUTOSAR SW architecture. The MCAL contains internal drivers (BSW with direct access to the microcontroller and its internal peripherals) and serves to make higher layers independent or the microcontroller.

OSEK

Offene Systeme und deren Schnittstellen für die Elektronik im Kraftfahrzeug (Open Systems and their Interfaces for the Electronics in Motor Vehicles). OSEK include the specification of OSEK-OS and OSEK-COM which were use as the basis for the AUTOSAR Os and Com BSW modules

PDU

Protocol Data Unit – a set of messages sent/received over a network as a coherent entity.

PIM

Per-Instance Memory – provides instance-specific state accessed through an Rte generated API.

Schema

A XML file that describes the permitted structure and content type of another XML file including data types, available elements and their permitted order as well as more specialized rules such as multiplicity constraints. An ARXML file is defined using an AUTOSAR supplied schema.

SPI

Serial Peripheral Interface – synchronous serial interface using a master-slave architecture and widely used in automotive embedded systems.

SWC

AUTOSAR Software Component – A functional unit within ASW. An AUTOSAR application consists of multiple SWCs.

Page 6: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 6

TP

Transmission Protocol – A transport mechanism used to transmit and receive I-PDUs larger than a single bus frame.

UDS

Unified Diagnostic Services – A standardized set of diagnostic services defined by ISO—15765 and supported by the AUTOSAR Dcm module.

VFB

AUTOSAR Virtual Function Bus. The VFB is an abstract composition of the ASW including all SWCs in the system their connections but not the mapping to particular ECUs. The VFB enables integration of ASW to occur early in the development phase and permits verification of the consistency of the communication relationship between SWCs.

1.4. Bibliography

[1] AUTOSAR Motivation and Goals, AUTOSAR

http://www.autosar.org/about/basics/motivation-goals/

[2] RTA-RTE User Guide, v5.10, ETAS GmbH

[3] RTA-OS User Guide, v5.5, ETAS GmbH

[4] RTA-BSW User Guide, v2.1.1, ETAS GmbH

1.5. Conventions

The following typographical conventions are used in this document:

Mod AUTOSAR BSW Module

OCI_CANTxMessage msg0 = Code snippets are presented on a gray background and in

the Courier font.

Meaning and usage of each command are explained by

means of comments. The comments are enclosed by the

usual syntax for comments.

Choose File Open. Menu commands are shown in boldface with connecting

arrow showing sub-menu / commands.

Click [OK]. GUI Buttons, e.g. those on dialog boxes, are shown in

boldface with square brackets.

Press <ENTER>. Keyboard commands are shown in angled brackets.

The "Open File" dialog box is

displayed.

Names of program windows, dialog boxes, fields, etc. are

shown in quotation marks.

Select the file setup.exe Text in drop-down lists on the screen, program code, as

well as path- and file names are shown in the Courier font.

A distribution is always a one-

dimensional table of sample

points.

General emphasis and new terms are set in boldface.

Page 7: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 7

2 How to use this User Guide

The RTA-BSW Installation and Getting Started Guide describes how to install RTA-BSW

Page 8: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 8

3 Installation

3.1. RTA-BSW Installation

The RTA-BSW Plugin package is contained in the zip file “RTA_BSW_Plugin_2_1_1.zip”

provided. You may require local admin rights for installation. To install, unpack the zip file

into your chosen location. The following section will describe the installation process and prerequisites.

3.1.1 Prerequisites

ISOLAR-A 9.1 is required for this plugin to function correctly. It is expected that the

computer meet the requirements for the version of ISOLAR-A installed.

3.1.2 Automated Installation

RTA-BSW includes an automated install process to first uninstall previous version(s) of the

RTA-BSW plugin before adding the current version.

To start the install process start the install.bat file included with RTA-BSW.

The installer requires admin access to run. If admin access is not available,

use the manual process described below.

If multiple versions of ISOLAR-A are installed, the installer prompts selection of a version to install RTA-BSW into. If the installer cannot locate ISOLAR-A,

use the manual process described below.

See Section 3.2 for information on how to check the installed RTA-BSW version.

3.1.3 Manual Installation

To install the RTA-BSW plugin, first open ISOLAR-A and from the menu select Help

Install New Software.

Screenshot 1: ISOLAR-A Install New Software Menu

Page 9: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 9

The menu will open a new window titled “Install” that enables selection from the available

software. From here select the [ADD…] button, you now have the option to select the installation source repository; this can be either the update site or from a local copy of the plugin:

Screenshot 2: ISOLAR-A JAR Repository Selection Dialog

Click the [LOCAL…] button and browse your file space for the folder containing the plugin. RTA-BSW plugin is a Java Archive file and therefore has a .jar extension.

Give the repository an appropriate name and click [OK] to add the installation source

Next you must select the plugins you wish to install from the “Install” menu, check all of the plugins contained in the site (All of the plugins listed are required for proper functionality of this tool).

Click [NEXT] to start the eclipse installer which will begin extracting the information it requires and installing any dependencies, once this completes.

Click [FINISH] and restart ISOLAR-A when prompted.

When ISOLAR-A has restarted you should notice additional toolbar icons, and

Inside the Licensing folder are xml license descriptors. These are used to populate the

license fields in ETAS License Manager, and are descriptive only. All license descriptors

should be copied into the LicenseConfigurationInfo folder in the ISOLAR-A installation directory, overwriting as necessary. For a standard installation this will be:

{Program Files}\ETAS\ISOLAR-A9.1\LicenseConfigurationInfo

In ETAS License Manager the licenses will be under product ISOLAR-A with feature names of LD_RTA_BSW*.

If the ETAS License Manager or any ETAS-licensed products are running

when the license descriptors are copied, the ETAS License Manager may not

update its list of licenses until the next time it is launched,

3.2. How to Check Installed RTA-BSW Version

Page 10: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 10

After installation of the RTA-BSW

plug-in new icons for RTA-BSW’s

ConfGen and CodeGen processes,

and , appear in ISOLAR-A toolbar.

To check the installed version of

RTA-BSW use the “Installation Details” dialog from the help menu.

Screenshot 3: ISOLAR-A Help Menu

The “Installation Details” dialog shows the installed version of RTA_BSW_Feature:

Screenshot 4: Installation Details showing RTA-BSW 1.0.7.03

3.3. Software Licensing

To be able to work with an ETAS software product, you require a license. This section contains basic details on ETAS License.

Details concerning the scope of the licenses and other legal aspects can be found in "Terms

and Conditions".

3.3.1 ETAS License Models

There are three different license models available for licensing your ETAS software:

Machine-Named License, Local

A license of this type is managed by the user himself/herself.

Page 11: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 11

As it is linked to a particular PC (more precisely: to the MAC address of the Ethernet

adapter), it is valid wherever the PC is used.

When you change your PC, you require a new license

User-Named License, Server-Based

The licenses (of a department or company) are managed centrally on a server by a

designated person.

The license is linked to the user name with which the user is registered in the network

and is available on every PC in the network.

If the relevant PC is disconnected from the network, the license can be "borrowed."

Concurrent (or Floating) License, Server-Based

The licenses are provided for the specific user names. Several users share a limited

number of licenses.

3.3.2 How to get a License

Contact the responsible person, if your company has a tool coordinator and server-based

license management for ETAS software. Otherwise (in case of a machine-named license) you obtain your license from the ETAS license-portal (the URL is shown on your Entitlement

Certificate).

There are three ways of logging in on the welcome page:

Activation ID

Once you have logged in, a specific activation is visible and can be managed – the

activation ID is shown on your Entitlement Certificate.

Entitlement ID

All activations of the entitlement are visible and can be managed (e.g. for a company

with just one entitlement).

E-mail and password

All activations of the entitlements assigned to the user account are visible and can be

managed (e.g. for a tool coordinator responsible for several entitlements).

If you need help in the portal, click Help link.

What Information is required?:

Information on the hosts must be entered to activate licenses:

Machine-named license

The MAC address of the Ethernet adapter to which the license is to be bound is

required.

User-named license

You need a server host or a server triad as well as a user name.

Concurrent (floating) license

You need a server host or a server triad.

Page 12: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 12

If this data changes (e.g. due to changes in the hardware or a change of user), the license must be given a "rehost". This procedure is also described

in the portal help file.

3.3.3 License File

The result of your activities is the provision of a file <name >.lic with which you can license

your software in the ETAS License Manager.

Open ETAS License Manager:

Click All Programs®ETAS®License Management®ETAS License Manager on

Windows 7 Start menu.

<or>

Click ETAS License Manager directly on "Apps" view in the Windows 8 / Windows 8.1

Start menu.

Check License Status:

Open the ETAS License Manager.

Check the "Status" column.

The ETAS License Manager contains one entry for each installed product. The symbol at the beginning of the entry and the "Status" column entry indicate if a valid license has already

been obtained or not.

To add a License file:

Open the ETAS License Manager.

Select the menu, FileAdd Licensing File.

The "Install License" window opens.

Next to the "Select License File" field, click ... Button to select the .lic file.

Click OK.

The "ETAS License Manager" window shows information on the selected license. The

"Feature Version" column shows the version number of the license, not the version number

of the software.

If the green symbol is not displayed, there might be a problem with the

license file or the license relates to another product. Additional information on ETAS License Manager can be found in the Online Help" of the ETAS

License Manager.

Page 13: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 13

4 Getting Started

4.1. How to use the RTA-BSW plugins

The RTA-BSW plugin is split into two tools

ConfGen runs a set of scripts which will read the AUTOSAR System Template

(EcuInstance, SystemSignal, etc.) and create an equivalent configuration in

EcucValueDescription format, which allows specific parameterisation and is the

input for BSW code generation tools.

CodeGen is an AUTOSAR BSW code generation tool, consuming configuration in

EcucValueDescription format to create source code equivalent in .c/.h format

using the RTA-BSW generator.

The following section will provide information on navigating these two tools focusing on the different options that presented in the tools GUI.

For an explanation on how these tools can be used in a development

workflow please see the RTA-BSW User Guide [2].

4.1.1 ConfGen

The ConfGen process parses the System Description to produce an equivalent configuration using the AUTOSAR EcucValueDescription.

To start ConfGen, click on the ISOLAR-A toolbar icon (see Screenshot 5) with an

AUTOSAR System Template project selected.

Screenshot 5: ISOLAR-A Toolbar

This will start the ConfGen process.

Page 14: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 14

The selected project should contain at least the System Template

description but to make full use of this tool it is recommended that the complete Virtual Functional Bus (VFB) configuration is present.

The first step in the process is to select the EcuInstance for which you wish to generate

EcucValueDescription:

Screenshot 6: ECU Instance Selection

Click [OK] to run the ConfGen process, and report the results to the console:

Page 15: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 15

Screenshot 7: RTA-BSW ConfGen Process

4.1.2 CodeGen

The RTA-BSW CodeGen process creates BSW source code (.c/.h files) from the an

EcucValueDescription.

The BSW CodeGen process is activated by either creating a new “run

configuration” (see the the “play” button diagram) which allows the configuration

of the generation process. Alternatively

the process can be run by clicking the toolbar icon, which will run an existing

configuration, or create a default if one cannot be found. The following section

will describe this tool in greater detail.

To control the execution of this process you must enter the run configuration menu (click the arrow next to the “play” button and select “Run Configurations…”)

This will open the run configuration menu showed on the following page, the sections of this

GUI are as follows (numbers marked in red on Screenshot 8) :

Page 16: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 16

Screenshot 8: ISOLAR-A Run Configurations Dialog

1. List of run configuration instances: each item listed here is a configuration; you

could have a run configuration per project, or create custom configurations for different use cases. (e.g. Validate only and only run the Com module)

2. Select RTA-BSW: presents a list of installed RTA-BSW versions and prompts for a

selection, this will control the available modules (5) as long as a valid project is selected.

3. Select Project: prompts for a selection of a workspace project. If this is a valid

AUTOSAR project and an RTA-BSW version has been selected, then the list of modules (5) will be populated with available modules.

4. Select Output Path: by default the path will be set to “{ProjectPath}/src/BSW/Gen”,

but can be set to any directory, the process will then organise the generated files by module in the selected directory

5. Module List: this contains the list of available modules for generation/validation this

is populated by seeing which modules have been configured in the selected project and comparing that to the available modules in the selected RTA-BSW. You can then

turn a module or stack on/off by clicking the check button.

6. Misc options: contains other options for controlling the process such as turning code

generation off (validate only) or instruct the process to not produce SWCD ARXML (to avoid overwriting manual configuration)

Page 17: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 17

Once the generation plugin has been run, the source code (.c/.h) implementation of the

AUTOSAR BSW system configured by the above process will be found in the specified output directory.

4.2. Importing an Example Application into ISOLAR-A

The RTA-BSW example applications are ISOLAR-A projects. To work with the example application, e.g. to generate the BSW source, import it into the ISOLAR-A workspace.

In an ISOLAR-A workspace, select the File Import… menu

Page 18: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 18

Screenshot 9: ISOLAR-A Import Menu Selection

From the “Import Dialog”, select Existing Projects into Workspace.

Screenshot 10: Import Existing Project into ISOLAR-A

From the “Import Projects”, choose the appropriate location of the projects. For RTA-BSW

example applications, choose Select root directory. Alternatively, select Select archive file when the existing project is distributed as a compressed archive file. Click the associated

[BROWSE] button to locate the directory or file containing the projects.

Under Projects, select the project(s) to import.

When importing from a root directory, the “Import Projects” dialog includes options to search for projects in directories below the selected root directory and to copy the project(s)

into the workspace.

Page 19: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 19

Screenshot 11: ISOLAR-A Import Projects Dialog

Click [FINISH] to start the import. The result of the import is viewed in the AR Explorer:

Page 20: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 20

Screenshot 12: AR Explorer view of RTA-BSW Starter Kit import

Page 21: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 21

5 Example Project Tutorial

This section will outline an example application for the RTA-BSW Plugins starting from a blank ISOLAR-A project and moving to generated BSW and ASW.

5.1. Project Creation

First create a new AUTOSAR project, named Example, in ISOLAR-A by clicking File New

AUTOSAR Project, choose the name of the project and click “finish”.

Screenshot 13: ISOLAR-A AUTOSAR Project Creation

5.2. System Description Creation

Next, the System template must be configured, ISOLAR-A provides a number of import tools

for legacy file formats (LDF, DBC and FIBEX) which can be used to complete this step automatically. Alternatively, manually configure/use an example ISOLAR-A project.

5.2.1 DBC Import

Run the ISOLAR-A DBC importer by clicking on the icon in ISOLAR-A’s toolbar.

In the import screen select the simple.dbc from the RTA-BSW Example folder.

Any name can be used for the ARPackage file, and it is good practice to give it a real

name, however to keep things simple they will be called ARPackage_0 for the example

(Please do not use these names in any real projects).

5.3. ASW Configuration

Following the system template configuration, we need to define the VFB/ASW configuration

before running the RTA-BSW plugins to fully take advantage of the BSW ConfGen process.

Doing so will allow the import process to use the ASW configuration for assigning EcuC values, alternatively default values and assumptions will be made about the system.

To achieve this, we will import pre-made configurations from the Example folder.

Page 22: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 22

Firstly, import the "Import ASW" files into your project. Right click on the project and select

Import:

Screenshot 14: Project Context Menu Import

Then choose File System from the selection menu:

Page 23: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 23

Screenshot 15: ISOLAR-A Import Wizard

Navigate to the Example\Import folder and select "ASW". Select all files and import them

into the project root by clicking [FINISH]:

Page 24: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 24

Screenshot 16: File System Import Dialog

Refresh the project, and there should now be a basic ASW configuration.

5.4. ECU Extract

The next step is to create the ECUExtract for which ISOLAR-A provides a tool to generate

this element automatically. In the context menu of an ECU Instance select “Create ECU

Extract”, select the default settings and navigate to the “finish” button, the project will now contain the complete set of information needed for the BSW Import step.

Page 25: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 25

Screenshot 14: ISOLAR-A Create ECU Extract menu

5.5. BSW Configuration and Generation

Run BSW ConfGen process by selecting the icon in the ISOLAR-A toolbar, the plugin will prompt you to select the RTA-BSW version and ECU Instance to generate for, and then

create the EcucValueConfiguration.

Now you may run the BSW Generate plugin by selecting the icon for source code generation which will result in the configuration and implementation of your BSW, no

additional configuration is required between Import and Generate in order to run the basic

EVE example.

5.6. OS and RTE

Now that the BSW has been generated you can create the OS and RTE configuration for scheduling BSW and ASW runnables, for the EVE example project a second ISOLAR-A pre-

made configuration is included. Import Example\Import\ECUC into the project, overwriting

all files:

Page 26: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 26

Screenshot 18: File System Import Overwrite Dialog

5.7. ASW Templates

This process will generate a software component named after the extracted ECU Instance. Right click on this component Generate Component Code-Frame.

Page 27: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 27

Screenshot 15: ISOLAR-A Generate

In the window that opens you will need to uncheck “Use default templates” and then select

Templates\template\MainTemplate.xpt as the template to use in the box that appears.

Click “Next” then choose an output directory before finally selecting [FINISH].

Page 28: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 28

6 BSW Module List

The following AUTOSAR BSW modules are referenced within this document. Please consult

the RTA-BSW Release Notes for details on inclusion within a particular RTA-BSW product.

BswM

AUTOSAR BSW Mode Manager – supports those aspects of Vehicle Mode Management and Application Mode Management that are applicable for BSW

Can

AUTOSAR CAN Driver - performs the hardware access to the CAN peripheral and offers a hardware independent API to the upper layer.

CanIf

AUTOSAR CAN Interface – provides a standardized interface to the services of the CAN Driver for the upper communication layers.

CanNm

AUTOSAR CAN Network Management - provides an adaptation between Nm and CanIf modules.

CanSm

AUTOSAR CAN State Machine – implements the control flow for the CAN bus.

CanTp

AUTOSAR CAN Transport Layer – implements segmentation and reassembly support for CAN PDUs longer than 8 bytes.

Com

AUTOSAR Communication module – provides a signal oriented data interface for the Rte and also performs signal gatewaying between SWCs on the same ECU.

ComM

AUTOSAR Communication Manager – provides the control of the underlying communication services

Dbg

AUTOSAR Debugging module – provides support for the collection and storage of run-time information about BSW for tracing and later transmission to a host system for analysis.

Dcm

AUTOSAR Diagnostic Communication Manager – provides a common API for diagnostics to ASW and external diagnostic tools.

Dem

AUTOSAR Diagnostic Event Manager – provides a standardized store for diagnostic events.

Det

AUTOSAR Default Error Tracer – provides trace support for detected development and runtime errors in the BSW.

Dio

AUTOSAR Digital Input & Output Driver - provides services for reading and writing Digital Input and Output channels.

Ea

AUTOSAR EEPROM Abstraction – provides the upper layer a virtual addressing scheme and segmentation of the EEPROM.

Eep

AUTOSAR EEPROM Driver

Page 29: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 29

EcuM-Fixed

AUTOSAR ECU State Manager (Fixed) – manages common ECU states including start-

up/shut-down of Os and BswM. The EcuM-Fixed variant of the EcuM supports pre-

defined ECU states and the transitions between them.

EcuM

AUTOSAR ECU State Manager – manages common ECU states including start-up/shut-down of Os and BswM. To distinguish the EcuM from EcuM-Fixed this module is

referred to as EcuM-Flex.

Fee

AUTOSAR Flash EEPROM Emulation – responsible for providing a virtual flash addressing/segmentation scheme to upper layers of AUTOSAR layered SW

architecture.

FiM

AUTOSAR Function Inhibition Manager – provides a control mechanism for software components and the functionality therein

Fls

AUTOSAR Flash Driver module – responsible for flash memory HW access.

Gpt

AUTOSAR General Purpose Timer – controls the internal General Purpose Timer of the microcontroller.

Icu

AUTOSAR Input Capture Unit Driver - demodulates a PWM signal, counting pulses, measuring of frequency and duty cycle, etc.

IpduM

AUTOSAR PDU Multiplexer - responsible for the combination of appropriate I-PDUs from COM to new, multiplexed I-PDUs and then to send the PDU back to the PduR.

LdCom

AUTOSAR Large Data Com – provides a signal based interface to the Rte supporting dynamic and large (>1 PDU) data types.

Mcu

AUTOSAR Microcontroller Unit driver - driver provides services for basic microcontroller initialization, power down functionality, reset, etc.

MemIf

AUTOSAR Memory Abstraction Interface – provides the NvM access to several memory abstraction modules, i.e. Fee or EA.

NM

AUTOSAR Network Management Interface – responsible for coordinated ECU network access, in particular, the transition to sleep mode.

NvM

AUTOSAR NVRAM Manager – responsible for presentation of ECU independent non-volatile memory abstraction to ASW.

Ocu

AUTOSAR Output Compare Unit drive – responsible for the initialization and control of the microcontroller internal OCU as well as triggering a defined action when the value of a counter matches a pre-defined compare value.

Page 30: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 30

Os

Operating System. The AUTOSAR Os is an event-driven operating system that supports fixed-priority scheduling of tasks and interrupts for multi-core ECUs. The API of the AUTOSAR Os is backwards compatible with OSEK Os API.

PduR

AUTOSAR PDU Router – responsible for routing PDUs between communication modules and/or transport protocol modules.

Rte

AUTOSAR Run-Time Environment - implements the AUTOSAR Virtual Functional Bus interfaces and thereby realizes the communication between SWCs

SchM

AUTOSAR BSW scheduler responsible for the invocation of BSW main functions and generation of data consistency APIs used by BSW. The Rte generates scheduling for BSW modules and SWCs thus main functions and runnable entities to be mapped to the same Os task.

Wdg

AUTOSAR Watch Dog Driver - provides services for initialization, changing the operation mode and setting the trigger condition

WdgIf

AUTOSAR Watch Dog Interface – provides the upper layer a standardize interface to the Wdg devices

WdgM

AUTOSAR Watch Dog Manager – supervises the program execution abstracting from the triggering of hardware watchdog entities

Page 31: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

RTA-BSW Installation and Getting Started Guide 31

7 ETAS Contact Addresses

7.1. ETAS HQ

ETAS GmbH

Borsigstraße 14 Phone: +49 711 3423-0

70469 Stuttgart Fax: +49 711 3423-2106

Germany WWW: www.etas.com

7.2. ETAS Subsidiaries and Technical Support

For details of your local sales office as well as your local technical support team and product hotlines, take a look at the ETAS website:

ETAS subsidiaries WWW: www.etas.com/en/contact.php

ETAS technical support WWW: www.etas.com/en/hotlines.php

7.2.1 RTA Hotline

The RTA hotline is available to all RTA users with a valid support contract.

[email protected]

+44 (0)1904 562624. (0900-1730 GMT/BST)

Please provide support with the following information:

Your support contract number.

Your AUTOSAR XML and/or OS configuration files.

The command line that results in an error message.

The version of the ETAS tools you are using.

Page 32: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

ETAS Index

RTA-BSW Installation and Getting Started Guide 32

Index

D

Dialog

Import, 18 Import Projects, 18

Installation Details, 10

Repository Selection, 9

E

Example Application

Import, 17

I

Installation

Automatic, 8

Manual, 8

Version Check, 10 ISOLAR-A

Import Project, 17 Installation Details, 10

R

RTA-BSW

SW Versions, 4

S

Safety Notice, 4

Page 33: RTA-BSW Installaiton and Getting Started Guide - etas.com · PDF fileMeaning and usage of each ... Installation Details showing RTA-BSW 1.0.7.03 3.3. Software ... your software in

ETAS

RTA-BSW Installation and Getting Started Guide 33