2. MCAL Configurator And EB Tresos User Guide

2.1. Introduction

The purpose of this User Guide is to provide detailed information regarding the usage of MCAL configurator/generator package. Each MCAL driver has a driver implementation portion and a configurator/generator portion. The configurator portion is described in this user guide.

The TI MCAL uses Elektrobit Tresos for configuration of MCAL modules.
MCAL module’s ECU parameter definition is captured in Elektrobit xdm format. MCAL modules are delivered in the form of EB Tresos plugins. The configuration of the MCAL modules can be done using the Elektrobit Tresos Configuration Editor. Once the configuration is complete, code can be generated for supported variants of the drivers.

2.2. Software Dependencies

2.2.1. Access to EB Tresos Tool and License

All required configurator installer are packaged with the configurator package. These installers are present at MCAL Configuration Install Directory

Document

Description

EB_Tresos_ACG8.5.0_Installer.zip

EB Tresos Studio 24.x Installer.

EB_Tresos_ACG8.8.10_Installer.zip

EB Tresos Studio 29.x Installer.

EB_Client_License_Administrator_1_5_1_Setup.exe

EB Tresos License Administrator.

EB_Tresos_Activation_Customer_License_TexasInstruments.pdf

Activation Key for License Administrator Setup

Note

Refer Release Notes or Getting Started section for more details on EB Tresos version related information.

2.3. Tool Installation and Activation

EB Tresos Installation can be segregated into three major steps:

  • Installation of Client License Administrator as it requires an activation key for machine where EB would be installed.

  • Installation of EB Tresos installer

  • Elektrobit Tresos License Troubleshooting ( Optional step in case of any license related issues )

2.3.1. Client License Administrator Installation

  • EB_Client_License_Administrator_1_5_1_Setup.exe

    1. Install the executable as an administrator. On successful installation you should see icon “EB Client License Administrator X.Y.Z” on your desktop.

    2. Launch EB Client License Administrator

    3. Enter the activation key provided.

    4. Click “Activate” button

    5. Check the status of the license activation sequence. If successful your license is ready to use.

EB Tresos License Activation

Fig. 2.1 EB Tresos License Activation

Note

For details refer LicensingUsersGuide.pdf Chapter 5 ({Installation Drive}/EB/EB_Client_License_Administrator/Doc/LicensingUsersGuide.pdf)

2.3.2. EB Tresos Tool Installation

  • EB_Tresos_ACGX.X.X_Installer.zip

    • Contains an self installing exe

    • Ensure to install as an administrator

    • On successful installation, an icon “Tresos Studio XX” would be created.

EB Tresos Tool Installation

Fig. 2.2 EB Tresos Tool Installation

Note

Post installation, launch “Tresos Studio XX.X” and confirm no license errors are seen.

2.3.3. Elektrobit Tresos License Troubleshooting

In cases where License Error are seen (post successful installation of Client License Administrator Client License Administrator), please try following steps

  1. Check if “Flexnet Licensing Service” service is started in the Windows Service Manager Panel (Control Panel -> Administrative Tools -> Services). If it is not started, please start it manually.

  2. Disable any “Anti Virus” software on the machine

  3. In cases where “Anti Virus” software cannot be disabled, please add user defined exceptions in “Anti Virus” software to the following folders (With the assumption that EB is installed in C Drive):

    • C:\ProgramData\Flexnet\

    • C:\EB\

  4. If license issues are still not resolved, contact EB support via Help->EB tresos support in EB tresos tool.

2.4. Getting started with EB Tresos

2.4.1. Create an EB project

Follow the below steps to Create EB Tresos project

  • Launch the EB Tresos tool. On the Welcome Screen, Click on Start Icon

EB Tresos Launch

Fig. 2.3 EB Tresos Launch - Welcome Screen

  • Now Click on File->New->Configuration Project to create a new project in the workspace

New Configuration Project

Fig. 2.4 New Configuration Project

  • Enter the Project name and select the location. Then Click on Next > Button

Use Default Location checkbox can be unchecked and custom location for the project can be provided

Project Wizard Window

Fig. 2.5 Project Wizard Window

  • In the Configuration Project Data Window, Enter the appropriate name for the ECU instance for the configuration.

  • Select the Target from the list as F29H85x and then Click on Next > Button

EB Project Configuration Data

Fig. 2.6 EB Project Configuration Data

2.4.2. Load plugins

  • In the Module Configuration Window, Select all the required plugins listed and add to module configuration.

EB Module Configuration

Fig. 2.7 EB Module Configuration

Note

If any Default configuration is present for the selected module, Ensure that Default Recommended Configuration is selected in Recommended Configuration section

  • Once All the required modules are added, click on next and then click on Finish Button to create the project.

  • Created project and Modules can be seen in Project Explorer tab once the project created is completed

EB Project Created

Fig. 2.8 EB Project Created

2.4.3. Generate plugins

  • Load the Modules and configure according to the requirement and save the project.

  • Click on Settings button down arrow button -> Unattended wizard configurations.

EB Unattended Wizard Configuration

Fig. 2.9 EB Unattended Wizard Configuration

  • Check AutoCalc (Calculate Derivable Values) checkbox and select default values and calculated values checkbox and click on Run to auto-calculate derivable values.

EB Unattended Wizard Config Dialog

Fig. 2.10 EB Unattended Wizard Config Dialog

Note

Unattended wizard configurations settings needs to be configured once during configuration of project where AutoCalc (Calculate Derivable Values) checkbox needs to be set. Post settings are done just clicking on the settings icon->AutoCalc will auto calculate all the values and any other configuration updates in the project.

  • Right Click on the project in the Project explorer and choose Verify Project to see any errors or warnings in the configuration.

EB Generate Configuration

Fig. 2.11 EB Generate Configuration

  • Next Right Click on the project in the Project explorer and choose Generate Project to generate the Output Files.

  • Generated Files will be present in output folder.

For more details on how to configure AUTOSAR modules using EB tresos studio, Refer 2.1_Studio_documentation_users_guide.

2.4.4. Generate BSWMD

  • To generate BSWMD file, right click on on the Project created/ or the module for which you want to generate the file, and click on Build Project->Generate_SWC-T

Generate BSWMD File

Fig. 2.12 Generate BSWMD File

  • Make sure the pop-up appears indicating 0 errors and 0 warnings.

  • The generated BSWMD.arxml file will be present in the output folder in swcd folder.

Output Files

Fig. 2.13 Output Files

2.4.5. Module Plugin Directory Structure

A typical module plugin would contain following files:

📦ModuleName_TI_DeviceName
┣ 📂config
┃ ┣ 📜ModuleName.arxml : Vendor Specific Module Description : ECU Configuration and ECU Parameter definitions for the MCAL module
┃ ┗ 📜ModuleName.xdm : ECU Parameter definition for the MCAL module.
┣ 📂config_ext
┃ ┣ 📜ModuleName_PreConfiguration.xdm : Pre-Configured values of ECU Configuration Description for the MCAL module.
┃ ┗ 📜ModuleName_Rec.xdm : Recommended values of ECU Configuration Description for the MCAL module.
┣ 📂generate
┃ ┣ 📂include
┃ ┃ ┗ 📜ModuleName_Cfg.h : Provides template to generate header file
┃ ┗ 📂src
┃ ┃ ┣ 📜ModuleName_Cfg.c : Provides template to generate Compile Time module configurations
┃ ┃ ┣ 📜Module_Lcfg.c : Provides template to generate Link Time module configurations
┃ ┃ ┗ 📜ModuleName_PBcfg.c : Provides template to generate Post Build module configurations
┣ 📂generate_swcd
┃ ┗ 📂swcd
┃ ┃ ┗ 📜ModuleName_BSWMD.arxml : Base Software Module Description : Contains details such exclusive area, Module Entries, Interrupts, MemMap etc…
┣ 📂META-INF
┃ ┣ 📜MANIFEST.MF : Licensing and module include information
┃ ┣ 📜CRYPTOMANIFEST.MF : Contains Signature for the files in Plugin
┃ ┗ 📜CRYPTOMANIFESTSIG.MF : Contains Signature for complete Plugin
┗ 📜plugin.xml : XML file used to register resources with EB Tresos Studio

2.5. Reference EB Documentation

Document

Description

Link

2.1_Studio_documentation_users_guide.pdf

EB Tresos user guide. This document can be used to understand how to use EB tresos for configuration and code generation.

{Installation Drive}/EB/tresos/doc/2.0_EB_tresos_Studio/2.1_Studio_documentation_users_guide.pdf

LicensingUsersGuide.pdf

Details activation of EB license and use of EB Client License Administrator tool

{Installation Drive}/EB/EB_Client_License_Administrator/Doc/LicensingUsersGuide.pdf

fnp_LicAdmin.pdf

Document from Flexnet explaining usage of Flexnet licensing tools

{Installation Drive}/EB/EB_Client_License_Administrator/Doc/fnp_LicAdmin.pdf

2.6. Run Export

The Configurations generated in EB Tresos can be exported to other configuration tools like DaVinci Configurator, ETAS ISOLAR-AB etc.

To export the configuration from EB to AUTOSAR XML (ARXML) format, following steps can be followed :

  • Right-Click the EB Project from the workspace which needs to be exported

  • Click on Im- and Exporters…

Export configurations

Fig. 2.14 Export configurations

  • Click on Create new Im- or Exporter button (+ Symbol)

Create New Exporter

Fig. 2.15 Create New Exporter

  • Fill the Name and select Mode as Export Only and Click on Next Button.

Exporter Name

Fig. 2.16 Exporter Name

  • In the next window, click on browse and select the file

Exporter Select File

Fig. 2.17 Exporter Select File

  • Select Autosar version as 4.3.1, and Click Finish.

AS Version Select

Fig. 2.18 AS Version Select

  • Select the exporter and click on Run Exporter button.

EB Run Exporter

Fig. 2.19 EB Run Exporter

Note

Once the Exporter run is successful, the generated arxml file can be used as the input file to the other configurator tools.