targetlink new features and migration - · pdf file11targetlink new features and migration...

dS

TargetLink

New Features and Migration

TargetLink 2.3 – March 2008

How to Contact dSPACE

How to Contact dSPACE Support

There are different ways to contact dSPACE Support:• Visit our Web site at http://www.dspace.com/goto?support• Send an e-mail or phone:

• General Technical Support:[email protected]+49 5251 1638-941

• TargetLink Support:[email protected]+49 5251 1638-700

• Use the dSPACE Support Wizard:• On your dSPACE DVD at \Diag\Tools\dSPACESupportWizard.exe• Via Start – Programs – dSPACE Tools (after installation of the dSPACE software)• At http://www.dspace.com/goto?supportwizard

You can always find the latest version of the dSPACE Support Wizard here.dSPACE recommends that you use the dSPACE Support Wizard to contact dSPACE Support.

Software Updates and Patches

dSPACE strongly recommends that you download and install the most recent patches for your current dSPACE installation. Visit http://www.dspace.com/goto?support for software updates and patches.

Mail: dSPACE GmbHTechnologiepark 2533100 PaderbornGermany

Tel.: +49 5251 1638-0

Fax: +49 5251 66529

E-mail: [email protected]

Web: http://www.dspace.com

Important Notice

This document contains proprietary information that is protected by copyright. All rights are reserved. Neither the documentation nor software may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or in part, without the prior written consent of dSPACE GmbH.

© Copyright 2008 by:dSPACE GmbHTechnologiepark 2533100 PaderbornGermany

This publication and the contents hereof are subject to change without notice.

AutomationDesk, CalDesk, ConfigurationDesk, ControlDesk and TargetLink are registered trademarks of dSPACE GmbH in the United States or other countries, or both. Other brand names or product names are trademarks or registered trademarks of their respective companies or organizations.

mailto:[email protected]

http://www.dspace.com

http://www.dspace.com/goto?support



http://www.dspace.com/goto?supportwizard

http://www.dspace.com/goto?support

I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

Contents

About This Document 5Accessing Online Help and PDF Files .........................................5Document Symbols and Conventions .......................................6Related Documents ..................................................................7

New Features of TargetLink 2.3 11General New Features .....................................................................12

Supported MATLAB Platforms ................................................12Combination of dSPACE Products ...........................................13TargetLink 2.3 Compatibility with MATLAB, and RCP and HIL Software ................................................................................14Supported Operating Systems ................................................15New Key Features ..................................................................16General Enhancements and Changes .....................................17

New Production Code Generation Features .....................................18

Optimized Vector Processing ..................................................18New Code Generator Options ................................................20Generated Code for Lookup Tables.........................................23Tables in the Generated Documentation .................................23Target Support .......................................................................23New and Enhanced API Commands........................................25AUTOSAR Version 2.1 Support ...............................................25AUTOSAR-Compliant Measurement and Calibration ...............25Enhanced AUTOSAR Software Component Description File Import and Export ..................................................................26Generating TargetLink Subsystems from AUTOSAR Software Component Description Files ..................................................27

New Features of dSPACE Data Dictionary 1.5 29New Key Features ..................................................................29New and Modified DD MATLAB API Commands .....................31

Points to Note 33Points to Note When Using Different Character Sets...............33

3 ▲■■■■■■■■■■■■■■■■■■■

TargetLink New Features and Migration March 2008

Contents ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

4 ■■■■■■■■■■■■■■■■

Migrating to TargetLink 2.3 35Upgrading TargetLink Models ................................................ 35Discontinued Features............................................................ 36Unsupported MATLAB and Simulink Features......................... 37Changes to Code Generated with TargetLink 2.3 ................... 37

Migrating to dSPACE Data Dictionary 1.5 39Upgrading Data Dictionary Project Files .................................. 40How to Upgrade DD Project Files via the Data Dictionary Manager................................................................................ 42Changed or Obsolete DD API Commands............................... 44Updating DD Project Files for Use with AUTOSAR................... 44

Index 45

TargetLink New Features and Migration March 2008■■▼

I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

About This Document

Objective This document provides you with a brief overview of the major new features of TargetLink 2.3 since the previous release.

dSPACE Release 6.1 contains all the software from dSPACE on one DVD:

n RCP and HIL software

n CalDesk 2.0

n TargetLink 2.3

This document does not describe the new features of RCP and HIL software and CalDesk 2.0.

Where to go from here Information in this section

Accessing Online Help and PDF Files

Objective After you install your dSPACE software, the documentation for the

installed products is available as online help and Adobe® PDF files.

Online help You can access the online help – dSPACE HelpDesk – as follows:

Windows Start menu Click Start – Programs – dSPACE Tools – dSPACE HelpDesk.

Accessing Online Help and PDF Files 5

Document Symbols and Conventions 6

Related Documents 7

5 ▲■■■■■■■■■■■■■■■■■■■


About This Document ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

6 ■■■■■■■■■■■■■■■■

Context-sensitive Press the F1 key or click the Help button in the dSPACE software.

Local installation on your host PC Double-click the dSPACEHelpDesk.chm file in %DSPACE_ROOT%\Doc\Online.

PDF Files You can access the PDF files as follows:

dSPACE HelpDesk Click the PDF link at the beginning of a document:

Local installation on your host PC Double-click the PDF file in %DSPACE_ROOT%\Doc\Print.

Document Symbols and Conventions

Symbols The following symbols may be used in this document.

Indicates a general hazard that may cause personal injury of any kind if you do not avoid it by following the instructions given.

Indicates the danger of electric shock which may cause death or serious injury if you do not avoid it by following the instructions given.

Indicates a hazard that may cause material damage if you do not avoid it by following the instructions given.

Indicates important information that should be kept in mind, for example, to avoid malfunctions.

Indicates tips containing useful information to make your work easier.


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ About This Document ▲■■■■■■■■■■■■■■■■■■I

Naming conventions The following abbreviations and formats are used in this document:

%name% Names enclosed in percent signs refer to environment variables for file and path names, for example, %DSPACE_ROOT% specifies the location of your dSPACE installation in the file system.

< > Angle brackets contain wildcard characters or placeholders for variable file and path names, etc.

Precedes the document title in a link that refers to another document.

Indicates that a link refers to another document, which is available in dSPACE HelpDesk.

Related Documents

Recommended reading You are recommended to read the following documents when working with TargetLink:

Information in other documents

ST M

TargetLink guides

Software Installation and Management GuideProvides detailed instructions on installing and handling the dSPACE software. It also shows you how to manage dSPACE licenses.

TargetLink Production Code Generation GuideOutlines the typical code generation workflow and introduces you to the basic features provided by TargetLink. It also describes how DD objects (dSPACE Data Dictionary objects) are used at TargetLink blocks.

TargetLink Advanced Practices GuideDescribes advanced features and blocks you can use to optimize the generated code, embed user-defined code and adapt company-specific coding styles.

TargetLink Blockset GuideExplains how to use the TargetLink Blockset in stand-alone mode.

TargetLink Multirate Modeling GuideProvides information on the concepts and techniques that you can apply to generate code for multirate systems and explains how to develop OSEK-compliant multitasking applications.

TargetLink New Features and Migration March 2008 7 ▲■■■■■■■■■■■■■■■■■■■


8 ■■■■■■■■■■■■■■■■

TargetLink AUTOSAR Modeling GuideExplains how to model and generate code for AUTOSAR-compliant software components.

TargetLink references

TargetLink Block and Object ReferenceDescribes TargetLink blocks, supported Simulink blocks and Stateflow objects.

TargetLink Tool and Utility ReferenceProvides information on the TargetLink tools and utilities.

TargetLink API ReferenceDescribes the available API commands and provides information on custom look-up functions.

TargetLink Target ReferenceProvides concise information on the target boards and compilers supported by TargetLink.

TargetLink File ReferenceLists all the files used in a production code target application.

TargetLink MessagesAll TargetLink error messages are categorized according to cause and additionally classified by severity level, i.e., fatal (F), error (E) and warning (W).

dSPACE Data Dictionary

dSPACE Data Dictionary Basic Concepts GuideIntroduces you to the features provided by the dSPACE Data Dictionary.

dSPACE Data Dictionary Manager ReferenceProvides detailed information on the menus, context menus, and dialogs contained in the Data Dictionary Manager.

dSPACE Data Dictionary XML Import and ExportIntroduces you to the XML import and export module of the dSPACE Data Dictionary.

dSPACE Data Dictionary ASAM-MCD 2MC Import and ExportIntroduces you to the ASAM-MCD 2MC import and export module of the dSPACE Data Dictionary.

dSPACE Data Dictionary OIL Import and ExportIntroduces you to the OIL import and export module of the dSPACE Data Dictionary.


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ About This Document ▲■■■■■■■■■■■■■■■■■■I

dSPACE Data Dictionary AUTOSAR SWC Description File Import and ExportIntroduces you to the AUTOSAR file import and export module of the dSPACE Data Dictionary.

dSPACE Data Dictionary Data Model ReferenceProvides detailed information on the data model of the dSPACE Data Dictionary.

dSPACE Data Dictionary MATLAB API ReferenceProvides detailed information on the features of the Data Dictionary MATLAB API.

dSPACE Data Dictionary MessagesAll Data Dictionary error messages are categorized according to cause and additionally classified by severity level, i.e., fatal (F), error (E) and warning (W).



10 ■■■■■■■■■■■■■■■■


I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

New Features of TargetLink 2.3

Objective TargetLink 2.3 has the following new features, enhancements and changes.


General New Features 12

New Production Code Generation Features 18

11 ▲■■■■■■■■■■■■■■■■■■■


New Features of TargetLink 2.3 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

12 ■■■■■■■■■■■■■■■■

General New Features

Objective Information on general new features of TargetLink 2.3 is provided below.


Supported MATLAB Platforms

MATLAB support TargetLink 2.3 supports the following MATLAB releases:

For information on how to install TargetLink and a detailed description

of its requirements, refer to Installation Overview ( Software Installation and Management Guide).

Related topics

Supported MATLAB Platforms 12

Combination of dSPACE Products 13

TargetLink 2.3 Compatibility with MATLAB, and RCP and HIL Software

14

Supported Operating Systems 15

New Key Features 16

General Enhancements and Changes 17

MATLAB Release... Is Supported by dSPACE Release 6.1 Software Item...

RCP and HIL Software TargetLink 2.3 Model Compare 1.0

MATLAB R2007b Yes Yes Yes

MATLAB R2007a+ Yes Yes Yes

MATLAB R2006b Yes Yes Yes

MATLAB R2006a+ Yes Yes Yes

ST M

Basics

• MATLAB Compatibility Information ( Software Installation and Management Guide)ST M


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ New Features of TargetLink 2.3 ▲■■■■■■■■■■■■■■■■■■I

Combination of dSPACE Products

Installation order To install the RCP and HIL software of a dSPACE Release together with CalDesk or TargetLink in the same folder, you have to install the products in a certain order.

n Only combinations that comply with these installation orders will work properly.

n The installations are listed in the dSPACE Installation Manager and the Add/Remove Programs list of the Windows Control Panel. Since installations are listed alphabetically and not chronologically, do not forget to make a note of the order in which you installed the dSPACE software. Otherwise, it will be difficult to reconstruct the installation order later on.

Combination Is PossibleWhen Installing dSPACE Software ...

After dSPACE Software ...

RCP and HIL Software of dSPACE Release

TargetLink CalDesk ModelCompare

5.3 5.4 6.0 6.1 2.1.6 2.2 2.2.1 2.3 1.3 1.4 1.4.1 2.0 1.0

RCP and HIL Software of dSPACE Release 5.3

–

Yes1) Yes No No Yes1)2) Yes2) Yes No No


Yes3) Yes Yes No Yes Yes Yes No No


Yes Yes Yes No Yes Yes Yes No Yes


No Yes Yes Yes No No Yes Yes Yes

TargetLink 2.1.6 No No No No

–

No No No No No

TargetLink 2.2 No No No No Yes Yes No No No

TargetLink 2.2.1 Yes Yes No No Yes Yes Yes No No

TargetLink 2.3 Yes Yes Yes Yes No No Yes Yes Yes

CalDesk 1.3 No No No No Yes No No No

–

No

CalDesk 1.4 No No No No Yes Yes No No No

CalDesk 1.4.1 Yes No No No Yes Yes No No No

CalDesk 2.0 Yes4) Yes4) Yes Yes No Yes Yes Yes Yes



14 ■■■■■■■■■■■■■■■■

TargetLink 2.3 Compatibility with MATLAB, and RCP and HIL Software

Objective TargetLink has special requirements regarding compatibility with MATLAB, and with RCP and HIL software.

CalDesk is not dealt with here as it does not require MATLAB.

RCP and HIL software and MATLAB dependencies

The table below shows you which MATLAB releases, and RCP and HIL software, you can install TargetLink 2.3 with.

Model Compare 1.0 Yes Yes Yes No Yes Yes Yes No Yes No –1) Limitation: With this software combination, dSPACE HelpDesk cannot display the table of contents if you access it from an application.2) Limitation: ConfigurationDesk 1.2 is not compatible with CalDesk versions < 1.4.1. For details, see below.3) Due to compatibility problems between the RCP and HIL software of dSPACE Release 5.4 and TargetLink 2.1.6, the installation programm automatically updates %DSPACE_ROOT%\MATLAB\Tl\codegen\tl_generate_mk_file.m and renames <MATLAB_ROOT>\toolbox\local\finish.bak to <MATLAB_ROOT>\toolbox\local\dsfinish.m4) Limitation: CalDesk 2.0 is not compatible with AutomationDesk versions < 2.0 when using the Remote Calibration (COM) Library or Remote Diagnostics (COM) Library. To access CalDesk 2.0 via the Remote Calibration (COM) Library or the Remote Diagnostics (COM) Library, you must use AutomationDesk 2.0 or later.

Combination Is PossibleWhen Installing dSPACE Software ...

After dSPACE Software ...

RCP and HIL Software of dSPACE Release

TargetLink CalDesk ModelCompare

5.3 5.4 6.0 6.1 2.1.6 2.2 2.2.1 2.3 1.3 1.4 1.4.1 2.0 1.0

For the latest information on combining dSPACE software, visit http://www.dspace.com/goto?ds_sw_combi.

TargetLink 2.3 can be installed only in the combinations shown in the table.


http://www.dspace.com/goto?ds_sw_combi


The same applies to the TargetLink Blockset 2.3 (stand-alone).

dSPACE Data Dictionary Manager

You can install TargetLink 2.3 with dSPACE Data Dictionary Manager version 1.5.

Supported Operating Systems

Supported operating systems

TargetLink 2.3 supports the following operating systems:

n Windows 2000 with Service Pack 4

n Windows XP (32-bit version) with Service Pack 2

n Windows Vista (32-bit version)

Some limitations apply to Windows Vista as the operating system when you use it in combination with TargetLink 2.3. For details,

refer to Limitations for Windows Vista ( Software Installation and Management Guide).

Not-supported operating systems

Installing TargetLink 2.3 Is PossibleWith MATLAB Release...

In Combination with RCP and HIL Software Contained in...

dSPACE Release 5.2

dSPACE Release 5.3

dSPACE Release 5.4

dSPACE Release 6.0

dSPACE Release 6.1

R2007b No No No No Yes

R2007a+ No No Yes Yes Yes

R2006b Yes Yes Yes Yes Yes

R2006a+ Yes Yes Yes Yes Yes

ST M

Windows XP Professional x64 Edition and Windows Vista (64-bit version) are not supported by TargetLink 2.3.



16 ■■■■■■■■■■■■■■■■

New Key Features

Objective Information on the new key features of TargetLink 2.3 is provided below.

Optimized vector processing

Optimized vector processing is an optimization feature that enables TargetLink to generate loops for blocks with vector signals instead of individual statements for each vector component. For further information, refer to Optimized Vector Processing on page 18.

Weak atomic subsystems As of TargetLink 2.3, the optimization of generated production code with respect to weak atomic subsystems is improved. For further information, refer to New Code Generator Options on page 20.

For further information, refer to New Code Generator Options on page 20.

Moving code into conditional branches

To avoid superfluous calculations, TargetLink’s Code Generator moves code into conditional branches whenever possible. As of TargetLink 2.3, even functions can be moved into conditional branches. For further information, refer to New Code Generator Options on page 20.

TargetLink AUTOSAR Module

AUTOSAR version 2.1 support TargetLink supports AUTOSAR version 2.1 and continues support for AUTOSAR version 2.0 SP3. For further information, refer to AUTOSAR Version 2.1 Support on page 25.

AUTOSAR-compliant measurement and calibration TargetLink lets you prepare software components for measurement and calibration as defined by the AUTOSAR 2.1 standard. For further information, refer to AUTOSAR-Compliant Measurement and Calibration on page 25.

Enhanced AUTOSAR software component description file import and export TargetLink's import/export tool now additionally supports software component description file export directly from the Data Dictionary Pool area, AUTOSAR packages, and UUIDs for AUTOSAR elements. For further information, refer to Enhanced AUTOSAR Software Component Description File Import and Export on page 26.



Generating TargetLink subsystems from AUTOSAR software component description files TargetLink supports the generation of TargetLink subsystems from software component description files. For further information, refer to Generating TargetLink Subsystems from AUTOSAR Software Component Description Files on page 27.

Improved code efficiency TargetLink now generates more efficient code for implicit sender-receiver and interrunnable communication.

General Enhancements and Changes

White spaces in path names

You can use white spaces in the installation and work paths of TargetLink 2.3 and in the installation path of MATLAB. TargetLink (and all other products from Release 6.1) can now be installed in folders such as C:\Program Files\dSPACE Tools.

Release update The printed user documentation is not delivered with dSPACE Release 6.1 if you receive the release as an update for your existing dSPACE release. Use the digital user documentation, for example, dSPACE HelpDesk, to obtain information about new features, enhancements, and the current safety precautions of your products.



18 ■■■■■■■■■■■■■■■■

New Production Code Generation Features


Optimized Vector Processing

Loop generation In optimized vector processing,TargetLink generates loops for blocks with vector signals instead of individual statements for each vector component. This reduces code size.

Operations applied to vector signals are processed in a for loop whenever possible and beneficial. TargetLink first weighs the advantages of less ROM consumption against losses in execution time. TargetLink creates loops if the vector size exceeds a specified threshold. You can use this threshold to optimize the code size.

If loop generation is not beneficial, not possible or disabled, TargetLink creates individual statements for each vector operation.

Loop generation is controlled by the EfficientVectorHandling Code Generator option. For further information, refer to Enabling/Disabling

Loop Generation ( TargetLink Advanced Practices Guide).

Optimized Vector Processing 18

New Code Generator Options 20

Generated Code for Lookup Tables 23

Tables in the Generated Documentation 23

Target Support 23

New and Enhanced API Commands 25

AUTOSAR Version 2.1 Support 25

AUTOSAR-Compliant Measurement and Calibration 25

Enhanced AUTOSAR Software Component Description File Import and Export

26

Generating TargetLink Subsystems from AUTOSAR Software Component Description Files

27

ST M



Example To illustrate vector processing, the following example (processing bus signals) shows a model and the corresponding production code processed in individual statements as well as processed in loop statements.

Loop merging In addition, TargetLink merges several consecutive loops in the same control flow branch to make one loop, which increases code efficiency in terms of execution time and code size. This feature is especially useful if vector operations are processed in loops.

As a precondition for merging, the loops must be compatible and the loop variables must be suitable for sharing as a common loop variable.

Individual Statements Loop Statements 1)2)

Sa1_Product1[0] = Sa1_a[0] * Sa1_c[0]; Sa1_Product1[1] = Sa1_a[1] * Sa1_c[1];Sa1_Product1[2] = Sa1_a[2] * Sa1_c[2];Sa1_Product1[3] = Sa1_a[3] * Sa1_c[3];Sa1_Product1[4] = Sa1_a[4] * Sa1_c[4];Sa1_Product1[5] = Sa1_b[0] * Sa1_d[0];Sa1_Product1[6] = Sa1_b[1] * Sa1_d[1];Sa1_Product1[7] = Sa1_b[2] * Sa1_d[2];Sa1_Product1[8] = Sa1_b[3] * Sa1_d[3];Sa1_Product1[9] = Sa1_b[4] * Sa1_d[4];

for(i = 0; i <= 4; i++){ Sa1_Product1[i] = Sa1_a[i] * Sa1_c[i];}

for(i = 0; i <= 4; i++){ Sa1_Product1[i+5] = Sa1_b[i] * Sa1_d[i];}

1) Only possible as of TargetLink 2.3.2) The code fragment inserted is the initial version. No further optimization (e.g. loop merging) has taken place.



20 ■■■■■■■■■■■■■■■■

Loop merging is controlled by the LoopUnrollThreshold Code Generator option. For further information, refer to Enabling/Disabling

Loop Generation ( TargetLink Advanced Practices Guide).

Example To illustrate the loop merging feature, the following table shows simple code fragments with and without merged loops:

For more examples, refer to Code Examples ( TargetLink Advanced Practices Guide).

Further information For details on this new feature, refer to Optimized Vector Processing

( TargetLink Advanced Practices Guide).

New Code Generator Options

New options for the Code Generator

TargetLink 2.3 provides important new Code Generator Options.

You can set Code Generator Options easily by clicking the All Options button on the Advanced Page of the TargetLink Main Dialog.

Code Without Loop Merging Code With Loop Merging

for (i = 0; i <= 300; i++){ /* Comment */ a[i] = a[i] + 3;}for (j = 0; j <= 300; j++){ /* Another Comment */ b[j] = b[j] + 4;}

for (i = 0; i <= 300; i++){ /* Comment */ a[i] = a[i] + 3; /* Another Comment */ b[i] = b[i] + 4;}

ST M

ST M

ST M

Code Generator Option TargetLink 2.3 Default

Setting for Previous TargetLink 2.x Behavior

AllowInterleavingCodeForAllSubsystems OFF OFF

ConsiderStateflowAuxiliariesForVariableSharing ON OFF

DisableFunctionsAsAnalysisBoundaries ON OFF

EnableBlockDiagramBasedSwitchOptimization ON OFF

AllowMovingOfCustomCodeForBlockDiagramBasedSwitchOptimization ON –

ConsiderAllVariablesForBlockDiagramBasedSwitchOptimization OFF –

ConsiderFunctionClassesForBlockDiagramBasedSwitchOptimization ON –

ConsiderMergeableForBlockDiagramBasedSwitchOptimization ON –

EfficientVectorHandling ON OFF

LoopUnrollThreshold 5 –

ExploitRangesIndependentOfErasable ON OFF



Weak atomic subsystems TargetLink now allows you to work with subsystems whose code can be mixed across subsystem borders by the Code Generator. These subsystems are called weak atomic subsystems. You can make all subsystems for which the MATLAB/Simulink option "Treat as Atomic Unit" is activated weak atomic by enabling the new Code Generator option AllowInterleavingCodeForAllSubsystems.

For further information, refer to Basics on Optimization


Example To illustrate weak atomic subsystems, the following example shows a model and the corresponding production code.

Moving code into conditional branches

TargetLink’s Code Generator moves code into conditional branches whenever possible to avoid superfluous calculations. As of TargetLink 2.3, even functions can be moved into conditional branches, if the respective function class is specified als SIDE_EFFECT_FREE.

ReduceScopeOfVariablesOnlyDownToFunctionLevel OFF OFF

SideEffectFreeAnalysisThreshold 10 0

TreatAllForcedAtomicSubsystemsAsWeakAtomic ON OFF

TreatAllStateflowFunctionsAsWeakAtomic ON ON

Code Generator Option TargetLink 2.3 Default

Setting for Previous TargetLink 2.x Behavior

< TargetLink 2.3 TargetLink 2.3

/* Sum: WeakAtomic/Sum */Sa1_Sum = Sa1_InPort + Sa1_InPort1;

/* BEGIN ATOMIC SUBSYSTEM *//* Gain: WeakAtomic/Atomic/Gain */Sa2_Gain = Sa1_Sum * 5;....

/* BEGIN WEAK ATOMIC SUBSYSTEM *//* Gain: WeakAtomic/Atomic/Gain # combined # Sum: WeakAtomic/Sum */

Sa2_Gain = (Sa1_InPort + Sa1_InPort1) * 5;....

ST M



22 ■■■■■■■■■■■■■■■■

For further information, refer to Optimizing the Control Flow


Example To illustrate how code is moved into conditional branches, the following example shows a model and the corresponding production code.

ST M

< TargetLink 2.3 TargetLink 2.3

act_foo_ret = foo(in_foo);GlobalGain = act_foo_ret * 3;act_bar_ret = bar(in_bar);

if (trigger >= 0) { out = GlobalGain;} else { out = act_bar_ret;}

if (trigger >= 0) { GlobalGain = foo(in_foo) * 3; out = GlobalGain;} else { out = bar(in_bar);}



Generated Code for Lookup Tables

Code for look-up tables without map structures

When used with data pages or variant coding, structs representing look-up tables lead to structs of structs in the generated code. This is error-prone and might cause problems in calibrating data and switching pages. Clearing the Generate map structure option in the block dialogs of 1-D and 2-D Look-Up Table blocks lets you generate code for look-up tables without map structures. For further information, refer to Table Maps (1-D and 2-D Look-Up Tables), Coding Styles for Data Variants and Example of Changing Parameter

Values on the ECU ( TargetLink Advanced Practices Guide).

Tables in the Generated Documentation

Excluding tables from the generated documentation

It is possible to hide complete tables that are not required in the generated documentation. To exclude a table from the generated documentation, append <table>.column = []; at the end of the function that contains the layout settings of the table that you want to hide in the tldoc_layout.m file, where <table> stands for the respective table, for example, fcnInputTable for the table of function input signals.

For further information, refer to How to Customize Tables in the

Documentation ( TargetLink Production Code Generation Guide)

Target Support

(New) evaluation boards, microcontrollers, and compilers

The following table shows the combinations of evaluation boards, microcontrollers, and compilers supported by TargetLink 2.3 (TargetLink abbreviations). New evaluation boards, microcontrollers, and compiler versions are underscored. For details, refer to TargetLink Target Reference.

ST M

ST M

For Evaluation Board... With a Processor from Microcontroller Family...

A Target-Specific Compiler...

56F8367EVM Freescale 56F8xxx Metrowerks81

Promo167 C16x Task60, Task75, Task80, Task85, Task86

EVB2633F H8S/26xx Hit30, Hit60, Hit62



24 ■■■■■■■■■■■■■■■■

Discontinued boards and compiler versions

The following boards are no longer distributed by dSPACE:

n DI_V850F3239

n MSA2114

The following boards are no longer supported by TargetLink:

n –

The following compiler versions are no longer supported by TargetLink:

n Hit41 for SH2eEVB and EVB7058 evaluation boards (SH2 microcontroller family)



HCS12EVB HCS12DP512EVB

HCS12 • Cosmic44, Cosmic45, Cosmic46, Cosmic47• Met12, Met20, Met31

S12XEVB S12XEVB_USB

S12X • Cosmic46, Cosmic47• Met41, Met45, Met46

MSA2114 M3A2154

M32R • Mcc32r20, Mcc32r43, Mcc32r50• Gaio9, Gaio10

CME555 MPC5xx • Diab43, Diab44, Diab50, Diab52, Diab53, Diab55• GHS30, GHS35, GHS36, GHS40, GHS42, GHS50• Met60, Met81, Met85, Met87

CMD565 Diab50, Diab52, Diab53, Diab55

MPC5554DEMO MPC55xx • Diab52, Diab53, Diab55• GHS40, GHS42, GHS50• Met15, Met22• GNU34

dSPACE RapidPro Control Unit with MPC55541)

• Diab53, Diab55• MRI32, MRI33

DI_V850F3239 NEC V850ES • GHS35, GHS40, GHS42• NEC25, NEC27, NEC31CI_V850F3377

SH2eEVBEVB7058

SH2 Hit60, Hit70, Hit80, Hit90, Hit91

SDK72513 SH2AFPU Renesas90, Renesas91

START276 ST10F276 Task75, Task80, Task85, Task86

EVB470R1 TI TMS470R1x TIccs13, TIccs21, TIccs221

TBTC1775 TriCore1775 Task11, Task13, Task14, Task15, Task22, Task23, Task25

TBTC1766 TriCore1766 Task22, Task23, Task25

TBTC1796 TriCore1796 • Task22, Task23, Task25• GNU33, GNU34

SK-EB XC2287 XC2200 TaskingVX211) Formerly documented as DS1603.

For Evaluation Board... With a Processor from Microcontroller Family...

A Target-Specific Compiler...



New and Enhanced API Commands

tl_adapt_dd_references If a DD object which is referenced by a TargetLink block via a DD path is renamed or moved to a different hierarchy level of the Data Dictionary, the reference becomes invalid. The new tl_adapt_dd_references command allows you to keep references via DD path valid.

Example tl_adapt_dd_references('Model','MyModel', ... 'Old','/Pool/Variables/MyOldVariable', ... 'New','/Pool/Variables/MyNewVariable');

For further information, refer to tl_adapt_dd_references

( TargetLink API Reference).

tl_generate_swc_model The new tl_generate_swc_model command lets you generate a TargetLink subsystem from an AUTOSAR software component description file.

For further information, refer to tl_generate_swc_model

( TargetLink API Reference).

AUTOSAR Version 2.1 Support

Supported AUTOSAR versions

TargetLink 2.3 supports AUTOSAR version 2.1 and continues support for AUTOSAR version 2.0 SP3.

Support of AUTOSAR version 2.1 adds the following features:

n AUTOSAR-compliant measurement and calibration.

n Import and export of AUTOSAR-compliant software component description files for AUTOSAR version 2.1.

AUTOSAR-Compliant Measurement and Calibration

Preparing software components for measurement and calibration

TargetLink lets you prepare software components for measurement and calibration as defined by the AUTOSAR 2.1 standard.

n You can prepare block parameters and Look-Up Tables that are required in only one software component for calibration.

ST M

ST M



26 ■■■■■■■■■■■■■■■■

n You can prepare block parameters and Look-Up Tables that are required in several software components for calibration. You can specify calprm require ports, calprm provide ports, and calprm interfaces with calprm elements for this purpose.

n You can prepare interrunnable variables for measurement.

For further information, refer to Preparing SWCs for Measurement and

Calibration According to AUTOSAR ( TargetLink AUTOSAR Modeling Guide).

Enhanced AUTOSAR Software Component Description File Import and Export

Export from DD Pool area TargetLink lets you additionally export DD objects directly from the DD Pool area without code generation. You can export objects below the following DD group objects:

n Interfaces

n Scalings

n SWRecordLayouts

n Typedefs

AUTOSAR packages AUTOSAR packages are structuring elements in software component description files. TargetLink lets you import package information that is specified in software component description files to the Data Dictionary. You can also export package information that is specified in the Data Dictionary to software component description files. Package information is supported for the following AUTOSAR elements:

n Software components

n Mode declaration groups

n Interfaces such as sender-receiver and client-server interfaces

n Typedefs

n Scalings

UUIDs UUID is short for Universally Unique Identifier. UUIDs are strings that you can use for merging AUTOSAR-compliant models. TargetLink supports importing UUIDs that are specified in software component description files to the Data Dictionary.

ST M



When software component description files are exported, TargetLink generates UUIDs for the exported elements. The UUIDs are written to the software component description files and additionally to the related Data Dictionary objects.

Generating TargetLink Subsystems from AUTOSAR Software Component Description Files

TargetLink subsystem generation

TartgetLink supports generation of TargetLink subsystems from software component description files. You can use this feature to easily integtrate software components in your Simulink model or to start software component modeling using TargetLink. You can use software component description files created by AUTOSAR-compliant tools such as dSPACE's SystemDesk or TargetLink.

For further information, refer to Generating a TargetLink Subsystem

from an SWC Description File ( TargetLink AUTOSAR Modeling Guide).

ST M



28 ■■■■■■■■■■■■■■■■


I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

New Features of dSPACE Data Dictionary 1.5

Objective dSPACE Data Dictionary 1.5 (DD) has the following new features, enhancements and changes:


New Key Features

Objective Information on the new key features of dSPACE Data Dictionary 1.5 is provided below.

Duplicate command The new Duplicate ( dSPACE Data Dictionary Manager Reference) command lets you copy and paste a selected DD object with all its properties in one step.

New Key Features 29

New and Modified DD MATLAB API Commands 31

ST M

29 ▲■■■■■■■■■■■■■■■■■■■


New Features of dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

30 ■■■■■■■■■■■■■■■■

Improved reference handling

If a DD object which is referenced by a TargetLink block or another DD

object via a DD path is renamed via the Rename ( dSPACE Data Dictionary Manager Reference) command or moved to a different hierarchy level via drag and drop or cut and paste, the reference

becomes invalid. The new Rename and Adapt ( dSPACE Data

Dictionary Manager Reference) and Move and Adapt ( dSPACE Data Dictionary Manager Reference) commands allow you to keep references via DD path valid.

For further information, refer to How to Reference Data Dictionary

Objects ( dSPACE Data Dictionary Basic Concepts Guide).

Enhanced DD data model TargetLink now supports AUTOSAR version 2.1. The Data Dictionary data model has been adapted for this purpose. You can create additional DD objects such as:

n /Pool/Autosar/SoftwareComponents/<SoftwareComponent>/Ports/RequireCalPrmPort

n /Pool/Interfaces/CalprmInterface

n /Pool/Interfaces/<CalPrmInterface>/CalPrmElements/CalPrmElement

ST M

ST M

ST M

ST M


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ New Features of dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■I

Creating DD variable objects for AUTOSAR-compliant calibration

AUTOSAR-compliant calibration parameters must be represented by variable objects in the Data Dictionary. To prepare block parameters for calibration you have to reference the variable objects at the block. The

new Update CalPrmInterface Variables ( dSPACE Data Dictionary Manager Reference) command from the Tools menu of the DD Manager allows you to create/update all the variable objects that represent AUTOSAR calprm interface elements.

New and Modified DD MATLAB API Commands

New restoreRefProps attribute of Move command

If a DD object which is referenced by another DD object via a DD path is moved to a different hierarchy level, the reference becomes invalid. The new restoreRefProps attribute of the Move command allows you to keep references via DD path valid.

Example dsdd('Move', 'Source','/Pool/Typedefs/new_Typedef',...'destination','/Pool/Typedefs/new_TypedefGroup', ...'restoreRefProps','on');

For further information, refer to Move ( dSPACE Data Dictionary MATLAB API Reference).

New restoreRefProps attribute of SetAttribute command

If a DD object which is referenced by another DD object via a DD path is renamed, the reference becomes invalid. The new restoreRefProps attribute of the SetAttribute command allows you to keep references via DD path valid.

Example dsdd('SetAttribute','/Pool/Typedefs/new_Typedef',...'name','My_Typedef','restoreRefProps','on');

For further information, refer to SetAttribute ( dSPACE Data Dictionary MATLAB API Reference).

Import command for AUTOSAR SWC description (SWC-D) files

The Import command for AUTOSAR SWC description (SWC-D) files has been changed. You can now additionally import package and UUID information from SWC-D files.

For further information, refer to How to Import AUTOSAR SWC

Description Files via MATLAB API ( TargetLink AUTOSAR Modeling Guide).

ST M

ST M

ST M

ST M


New Features of dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

32 ■■■■■■■■■■■■■■■■

Export command for AUTOSAR SWC description (SWC-D) files

The Export command for AUTOSAR SWC description (SWC-D) files has been changed. You can now additionally export from the DD Pool area and import package and UUID information from SWC-D files.

For further information, refer to How to Export AUTOSAR SWC

Description Files via MATLAB API ( TargetLink AUTOSAR Modeling Guide).

ST M


I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

Points to Note

Points to Note When Using Different Character Sets

ASCII characters for C identifiers only

All names that result in C identifiers, like variables, types and functions, must be specified in ASCII characters, since this is required by the C language specification. Using non-ASCII characters in such names results in problems when code is generated.

For further information, refer to Using Different Character Sets


Especially if you use a Japanese version of Windows XP as the operating system, you must use the ASCII input mode to specify variables, types and functions, for example, in the Data Dictionary Manager.

ST M

33 ▲■■■■■■■■■■■■■■■■■■■


Points to Note ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

34 ■■■■■■■■■■■■■■■■


I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

Migrating to TargetLink 2.3


Upgrading TargetLink Models

Migrating from TargetLink 2.x

To migrate from any TargetLink 2.x release, for example, from TargetLink 2.2 to 2.3, it is not necessary to upgrade models or libraries.

As there have been changes to the data model of the dSPACE Data Dictionary, you have to upgrade the respective DD project files. For further information, refer to Upgrading Data Dictionary Project Files on page 40.

Migrating from TargetLink 1.3 or earlier

To migrate from former TargetLink releases, for example, from TargetLink Release 1.3 to 2.3, you also have to perform the migration steps of the intervening TargetLink versions. All of the required migration steps can be done with TargetLink 2.3 installed.

Example For example, if you want to migrate from TargetLink version 1.1 to TargetLink version 2.3, you have to follow the migration steps described in:

n New Features and Migration of TargetLink version 1.2


Upgrading TargetLink Models 35

Discontinued Features 36

Unsupported MATLAB and Simulink Features 37

Changes to Code Generated with TargetLink 2.3 37

35 ▲■■■■■■■■■■■■■■■■■■■


Migrating to TargetLink 2.3 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

36 ■■■■■■■■■■■■■■■■


n Finally, the migration steps described in New Features and Migration of TargetLink version 2.3.

Previous release documents The TargetLink New Features and Migration documents for previous TargetLink versions are available via Internet and on the dSPACE DVD:

n Download them from http://www.dspace.de/goto?migration_tl.

n Read them from the dSPACE DVD (see the \Doc folder). The PDF files are called TLNewFeaturesAndMigrationVer.x.y.pdf, where x.y stands for the release number.

Migrating AUTOSAR-related DD project files from TargetLink Version 2.2 to 2.3

To import and export AUTOSAR SWC descriptions properly, the DD project file used by your TargetLink model must be up-to-date. For further information, refer to Updating DD Project Files for Use with AUTOSAR on page 44.

Discontinued Features

Discontinuation of the dSPACE Code Editor

The dSPACE Code Editor has been discontinued. The new default editor after installation is MATLAB's M-File Editor, which is available for every user. You can choose your default editor via the TargetLink Preferences Dialog.

Discontinued TargetLink info file

As of TargetLink 2.3, TargetLink does not generate <model>_info.m files anymor, which were used in combination with TargetLink 1.x versions.


http://www.dspace.de/goto?migration_tl

■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ Migrating to TargetLink 2.3 ▲■■■■■■■■■■■■■■■■■■I

Unsupported MATLAB and Simulink Features

Unsupported new blocks The new Simulink Prelookup and Interpolation Using Prelookup blocks that where introduced with MATLAB Release 2006b are not supported by TargetLink 2.3. To ensure compatibility with TargetLink 2.3, use the PreLookup Index Search and Interpolation (n-D) using PreLookup blocks that reside in Simulink's simulink_need_slupdate library.

Changes to Code Generated with TargetLink 2.3

Code Changes TargetLink 2.3 provides enhanced and new optimization features, that all affect the generated code. The new features and optimizations can be switched on or off by Code Generator options. The table in New Code Generator Options on page 20 shows the options and their old and new values. To obtain code that is as close as possible to TargetLink 2.2, set the options' values according to the right column.


Migrating to TargetLink 2.3 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

38 ■■■■■■■■■■■■■■■■


I■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

Migrating to dSPACE Data Dictionary 1.5

Upgrading DD project files When migrating from an earlier dSPACE Data Dictionary version to dSPACE Data Dictionary1.5, you must note the following points:


Upgrading Data Dictionary Project Files 40

How to Upgrade DD Project Files via the Data Dictionary Manager

42

Changed or Obsolete DD API Commands 44

Updating DD Project Files for Use with AUTOSAR 44

39 ▲■■■■■■■■■■■■■■■■■■■


Migrating to dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

40 ■■■■■■■■■■■■■■■■

Upgrading Data Dictionary Project Files

Changes in the data model Changes have been made to the data model of the dSPACE Data Dictionary. For example, some objects have additional properties or child objects, and some object properties have been left out. You therefore have to upgrade DD project files you created with an earlier dSPACE Data Dictionary 1.x version. The dSPACE Data Dictionary provides an upgrade tool for this. When you invoke the upgrade tool, it checks the DataModelRevision property in the DD/Config/General subnode.

If the value of this property is less than 133, the DD project file must be upgraded.

If you upgrade your DD project file, the following problems can occur:

n If you have insufficient access rights, the DD project file might not be upgraded. In this case you should change to the admin mode via the Extras menu of the Data Dictionary Manager. For further

information, refer to User Modes and Access Rights ( dSPACE Data Dictionary Basic Concepts Guide).

ST M


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ Migrating to dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■I

Repeat the DD project file upgrade afterwards using the Upgrade Current DD File option from the Tools menu of the Data Dictionary Manager.

n Changes in objects which reside in DD files to be included are not saved automatically. To prevent the changes from being lost, open the DD Manager and set the AutoSave property for the DD include files to 'PromptIfModified'.

Save the DD project file afterwards.

For more information, refer to How to Upgrade DD Project Files via the Data Dictionary Manager on page 42.

After the upgrade, set the AutoSave property back to "off", if necessary.



42 ■■■■■■■■■■■■■■■■

How to Upgrade DD Project Files via the Data Dictionary Manager

Objective You can upgrade a DD project file by opening it via the Data Dictionary Manager.

Precondition To perform the steps described below, the following preconditions must be fulfilled:

n You have write acces to all the DD objects.

n The AutoSave property for all the DD include files is set to "PromptIfModified".

Method To upgrade DD project files via the Data Dictionary Manager

1 From the File menu in the Data Dictionary Manager, select Open DD Project File.

2 In the Open dialog, select the DD project file and click Open. You are prompted to specify whether the DD project file should be upgraded or not.

3 Click Yes.


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ Migrating to dSPACE Data Dictionary 1.5 ▲■■■■■■■■■■■■■■■■■■I

Result The selected DD project file is opened and upgraded.

The following table shows the parameters and their possible values:

Related topics

Alternatively, you can choose one of the following ways of upgrading a DD project file:

n Load a DD project file and enter

errorCode = dsdd('Upgrade');

in the MATLAB Command Window.

n In the MATLAB Command Window, entererrorCode = dsdd('Open','file',<DDFile>,'Upgrade',<upgrade>);

For details, refer to Open and Upgrade ( dSPACE Data Dictionary MATLAB API Reference).

Parameter Possible Values

DDFile Name of DD file to open (string)

upgrade "on", "off", or "ask" (default = 'ask')

If upgrading the DD project file has failed, you can open the Message Browser to show error messages in the Message Browser by the following command:

if errorCode ~= 0 ds_error_register(dsdd('GetMessageList')); ds_msgdlg;end

ST M

References

• Open DD Project File ( dSPACE Data Dictionary Manager Reference)ST M



44 ■■■■■■■■■■■■■■■■

Changed or Obsolete DD API Commands

Adapting your scripts to changed DD API commands

Since several DD API commands have been modified or are obsolete, you may have to adapt your scripts. For details on changes to the DD API commands, refer to New and Modified DD MATLAB API Commands on page 31.

Updating DD Project Files for Use with AUTOSAR

Migrating AUTOSAR-related DD project files from TargetLink Version 2.2 to 2.3

To import and export AUTOSAR SWC descriptions properly, your TargetLink model must use a DD project file that is based on the %DSPACE_ROOT%\Dsdd\Config\dsdd_master_autosar.dd DD project file template which comes with TargetLink version 2.2.1 or later. To migrate your model, merge the contents of this DD project file template with your DD project file. For instructions on merging DD

project files, refer to How to Merge DD Files ( dSPACE Data Dictionary Basic Concepts Guide).

Before you export AUTOSAR SWC descriptions, you have to generate code again.

ST M


■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■▼ Index ▲■■■■■■■■■■■■■■■■■■I

Index

A

ASCII charactersfor C identifiers 33

ASCII input mode 33AUTOSAR packages 26AUTOSAR support 25

C

changed API commandsdSPACE Data Dictionary 44

code changes 37combination of dSPACE products 13compatibility

MATLAB 14RCP and HIL software 14

conditional branchesmoving code 20

creating DD variable objectsAUTOSAR-compliant calibration 29

D

DD project fileupgrading 40

discontinuation<model>_info.m 36code editor 36info file 36

discontinued compiler versions 23discontinued evaluation boards 23discontinued features 36dSPACE Data Dictionary API commands

changes 44dSPACE products

combination of 13

E

enhanced DD data model 29enhancements and changes 17excluding tables

from the generated documentation 23

G

generatemap structure 23

generated codefor lookup tables 23

generated documentationexcluding tables 23

I

import and exportsoftware component description file 26

improved reference handling 29info file

discontinuation 36installation folder 13installation order 13

J

Japanese versionWindows XP 33

K

key featuresdSPACE Data Dictionary 29TargetLink 16

L

look-up tableswithout map structures 23

loop generation 18loop merging 18

M

MATLAB compatibility 14MATLAB platforms

supported 12MATLAB support 12migrating

AUTOSAR-related DD project files 35, 44from TargetLink 1.x 35from TargetLink 2.x 35

moving codeinto conditional branches 20

N

new API commandsdSPACE Data Dictionary 31TargetLink 25

new Code Generator options 20new evaluation boards 23new evaluation compiler versions 23

O

operating systemsWindows 2000 SP4 15Windows Vista (32-bit version) 15Windows XP (32-bit version) 15

optimized vector processing 18

P

printed user documentation 17

S

software component description fileimport and export 26

supportedMATLAB platforms 12

supported AUTOSAR versions 25supported MATLAB platforms 12supported operating systems 15supported targets 23SWC export from DD Pool area 26

T

target support 23TargetLink models

upgrading 35

U

universally unique identifierUUIDs 26

unsupportedMATLAB features 37Simulink features 37

upgradingData Dictionary project files 40TargetLink models 35

W

weak atomic subsystem 20white space support 17Windows XP

Japanese version 33


Index ▲■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■I■■■■■■■■■■■■■■■■■■■■■■▼

46 ■■■■■■■■■■■■■■■■
