TRC File Changes with dspace Release 2014-A and Later. Migration Guide

Similar documents
ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

ConfigurationDesk/RTI. Compatibility with Toolboxes and Blocksets Provided by MathWorks

Using Dynamic Links in AutomationDesk

New Features and Migration

dspace GmbH Rathenaustr Paderborn Germany

Support of the DS6335-CS Ethernet Board

SYNECT

dspace Release New Features and Migration

FMI Kit for Simulink version by Dassault Systèmes

Automation Desk 3.3 Tool Set - Test Automation Software. P.BALAJI Software Engineer L&T IES, Mumbai

Cluster Simulation with Integrated Workflow and Test Management. Chandu Puliroju dspace Inc.

Real and Virtual Development with SystemDesk

MicroLabBox

dspace System Requirements for dspace CalDesk Release 6.1 Display Additional Requirements for License Handling Host PC Hardware Host Processor

MicroLabBox

TargetLink AUTOSAR Guidelines

Host PC Hardware You can use x86-compatible personal computers as host PCs for your dspace applications.

Python 3.6. Migration Guide

Feaser

DS1006 Processor Board 1)

ControlDesk Next Generation

Quick Start Guide for OP4200 Thank you for choosing RT-LAB as your real-time simulation platform.

Testing TargetLink. Models and C Code with Reactis

HANcoder STM32 Target Getting Started


Generating ASAP2 Files

Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment

EHOOKS V4.3 User Guide

SystemDesk - EB tresos Studio - TargetLink Workflow Descriptions

Mobile Application Workbench. SAP Mobile Platform 3.0 SP02

Decoupling Test Cases from Real and Virtual Test Systems with ASAM HIL API

LABCAR-OPERATOR V5.4.2 User s Guide

What s New in MATLAB and Simulink

EHOOKS V4.0 PRE-RELEASE

A Model-Based Reference Workflow for the Development of Safety-Related Software

DEVELOPMENT OF DISTRIBUTED AUTOMOTIVE SOFTWARE The DaVinci Methodology

dspace Prototyping Systems and Tools Developing, validating, and experiencing new functionalities in real environments

Collaborating in California Dynamic Skip Fire Development Using HIL API

QuaRC 2.0. Installation Guide. Single-User and Network Installations/License Configuration (Windows, QNX, and Gumstix Verdex)

Model Based Design Development Environment for Simulink /Stateflow Product Specification

Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment

MATLAB 7 Getting Started Guide

SCALEXIO. New technologies for HIL simulation.

MotionDesk D online animation of simulated mechanical systems in real time Intuitive graphical scene design

SIMATIC. PCS 7 Licenses and configuration limits (V9.0) Security information 1. Preface 2. Selecting the correct license keys 3

MicroAutoBox II

II. RTW BUILD METHODS In order to understand how RTW generates C code and produces an executable image, the build process can be divided into three st

What s New in Simulink Release R2016a and R2016b

PRM Synchronization Tool

What s New In Simulink: Fraser Macmillen

Quick Start Guide. Thank you for choosing RT-LAB as your real-time simulation platform.

Model-Based Design Using Simulink, HDL Coder, and DSP Builder for Intel FPGAs By Kiran Kintali, Yongfeng Gu, and Eric Cigan

Importing Models from Physical Modeling. Tools Using the FMI Standard

Multi-Target Modelling for Embedded Software Development for Automotive Applications

Offline Shader Compiler. Mali. User Guide. Version: 3.0. Copyright ARM. All rights reserved. ARM DUI 0513B (ID032912)

Best Practices for Organizing Electronic Records

SCALEXIO

embos Real-Time Operating System embos plug-in for IAR C-Spy Debugger Document: UM01025 Software Version: 3.1 Revision: 0 Date: May 3, 2018

Release Notes TPT 10 TPT 10U3 TPT 10U2 TPT 10U1. Declaration Editor. Bug Fixes

Release Notes. PREEvision. Version 6.5 SP11 English

Real-Time Workshop Embedded Coder 4

dspace Simulator Full-Size 1)

ECU Testing with dspace Simulator

Release Notes INCA-FLOW V4.6. Release Notes. Page 1 of 12

Model Diversity and Variability

embos Real-Time Operating System embos plug-in for IAR C-Spy Debugger Document: UM01025 Software Version: 3.0 Revision: 0 Date: September 18, 2017

DS1005 PPC Board. Hardware core for real-time systems PowerPC 750GX running at 1 GHz

SIMATIC. Process control system PCS 7 Operator Station (V9.0 SP1) Security information 1. Preface 2

Global Model Workstation Release Log

Guidelines for deployment of MathWorks R2010a toolset within a DO-178B-compliant process

Control System Design and Rapid Prototyping Using Simulink Chirag Patel Sr. Application Engineer Modeling and Simulink MathWorks India

DSP Builder Release Notes and Errata

Machine Controller MP900/MP2000 Series MPE720 Software for Programming Device USER'S MANUAL

MultiCash Fundamental Notes. April Omikron Systemhaus GmbH & Co. KG Von-Hünefeld-Str. 55 D Cologne (Germany)

Quick Installation Guide: QUARC TM on NI ELVIS III

Release Notes Release (December 4, 2017)... 4 Release (November 27, 2017)... 5 Release

Exclusive Offers for Academia 2011

DX200 OPTIONS INSTRUCTIONS

Silex SD-320AN-03 Serial Server

Real-Time Windows Target

FMI Toolbox User's Guide 2.3

GPU Offline Shader Compiler. Mali. User Guide. Version: 2.2. Copyright 2009 ARM. All rights reserved. ARM DUI 0513A (ID101409)

Machine Automation Controller NJ-series. EtherNet/IP TM. Connection Guide. OMRON Corporation. CJ2-series Controller P568-E1-01

Practices Guide. Programmable Terminal NB-series. - Disable/Enable communication with PLCs in Run -time

Guido Sandmann MathWorks GmbH. Michael Seibt Mentor Graphics GmbH ABSTRACT INTRODUCTION - WORKFLOW OVERVIEW

Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment

This product may require export authorization from the U.S. Department of Commerce prior to exporting from the U.S. or Canada.

SIMATIC. Process Control System PCS 7 SIMATIC Management Console (V9.0) Security information 1. Preface 2. Basics 3

Database Toolbox Getting Started Guide. R2013a

Systems Alliance. VPP-2: System Frameworks Specification

Device Management Basic HART DTM 6.0 Installation

Systems Alliance. VPP-2: System Frameworks Specification

Concept Manual vteststudio. Version 2.2 English

What s New in MATLAB and Simulink Young Joon Lee Principal Application Engineer

Sparqube Lookup Column

Transcription:

TRC File Changes with dspace Release 2014-A and Later Migration Guide October 2015

How to Contact dspace Mail: dspace GmbH Rathenaustraße 26 33102 Paderborn Germany Tel.: ++49 5251 1638-0 Fax: ++49 5251 16198-0 E-mail: info@dspace.de Web: http://www.dspace.com How to Contact dspace Support To contact dspace if you have problems and questions, fill out the support request form provided on the website at http://www.dspace.com/go/supportrequest. The request form helps the support team handle your difficulties quickly and efficiently. In urgent cases contact dspace via phone: General Technical Support: +49 5251 1638-941 TargetLink Support: +49 5251 1638-700 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.de/goto?support for software updates and patches. Important Notice This document contains proprietary information that is protected by copyright. All rights are reserved. The document may be printed for personal or internal use provided all the proprietary markings are retained on all printed copies. In all other cases, the document must not 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 2015 by: dspace GmbH Rathenaustraße 26 33102 Paderborn Germany This publication and the contents hereof are subject to change without notice. CalDesk, ConfigurationDesk, ControlDesk, SCALEXIO, SYNECT, SystemDesk, TargetLink and VEOS 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

Contents Contents About This Document... 4 Document Symbols and Conventions... 4 TRC File Changes with dspace Release 2014-A and Later... 5 Introduction and Technical Background... 6 Simulink Coder Core Enhancements... 6 Tunable Structured Parameters... 8 Model Referencing... 8 Summary of Resulting Advantages... 10 Overview of Planned dspace Support... 12 Features and Compatibility Considerations... 14 Step A (Support for R2014a)... 14 Step B (Support for R2014b and R2015a)... 15 Step C (Support for R2015b and Higher)... 17 Change History... 27 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 3

TRC File Changes with dspace Release 2014-A and Later About This Document 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. 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_PYTHON25% is the folder containing the Python installation. < > Angle brackets contain wildcard characters or placeholders for variable file and path names, etc. 4 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

TRC File Changes with dspace Release 2014-A and Later TRC File Changes with dspace Release 2014-A and Later The information in this document lets you plan your next steps for migrating to new MATLAB and dspace Releases. Study this document carefully and analyze your projects accordingly in order to plan resources and allocate time for migration and testing activities. The information is subject to changes without further notice. The last update was on October 13, 2015. If you have any questions about the planned steps for MATLAB R2014a and later outlined in this document, contact trc-changes@dspace.de. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 5

Introduction and Technical Background Introduction and Technical Background Variable description (TRC) files are used by ControlDesk Next Generation, AutomationDesk, ModelDesk, Real-Time Testing, HIL API, and RTPLIB2. The TRC files include information on all signals and parameters of the application, which lets you observe and manipulate the signals and parameters of the simulation. Real-Time Interface (RTI), ConfigurationDesk, and VEOS generate the TRC files and an SDF file that references the relevant TRC files for the application. When ControlDesk Next Generation loads the SDF file, it loads the TRC files at the same time. MATLAB Release R2014a provides enhanced code generation with Simulink Coder TM, which is used when the Inline Parameters option is set to Off. It is the most commonly used setting for this option in models for dspace HIL and RCP systems. The enhancements are explained in the subsequent sections. The aforementioned Simulink Coder enhancements require extensions to and changes of the TRC file. The sections Overview of Planned dspace Support and Features and Compatibility Considerations provide an overview of the planned dspace support for these features for each Release, and compatibility considerations. Simulink Coder Core Enhancements The following table provides an overview of the most important characteristics of these Simulink Coder enhancements. For more details, refer to the Simulink Coder release notes and the Simulink Coder documentation. Description Example Model Generated Code (Principle) Previous: When block parameters are defined with expressions referencing one or more MATLAB workspace variables (e.g., K*L+1 with K=2.0 and L=4.5 in MATLAB workspace), the expressions are now preserved in the generated code, and the used variables become global tunable variables. real_t Gain_Gain = 10; y = Gain_Gain * u; New: 6 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Introduction and Technical Background Description Example Model Generated Code (Principle) real_t K = 2.0; real_t L = 4.5; Multiple blocks referencing a common MATLAB workspace variable (e.g., S=1.5) now also share a common variable in the generated code. y = (K * L + 1.0) * u; Previous: real_t Gain_Gain = 1.5; real_t Gain1_Gain = 4.5; y1 = Gain_Gain * u; y2 = Gain1_Gain * u; New: real_t S = 1.5; When blocks reference a mask parameter of a masked subsystem (MP in the example), the code preserves the expressions and uses the mask parameter variable for several blocks. y1 = S * u; y2 = (S + 3.0) * u; Previous: real_t Gain_Gain = 3.22; real_t Gain1_Gain = 6.22; y1 = Gain_Gain * u; TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 7

Introduction and Technical Background Description Example Model Generated Code (Principle) y2 = Gain1_Gain * u; New: real_t Subsys_MP = 3.22; y1 = Subsys_MP * u; y2 = (Subsys_MP + 3.0) * u; Tunable Structured Parameters If the block parameters, mask parameters, or model arguments reference MATLAB structures, Simulink Coder generates the structure as a tunable structured parameter in the model code (if the conditions for this are fulfilled; see Structure Parameters in the Simulink and Simulink Coder documentation for details). In these cases, the following basic principles remain in place, as shown in Simulink Coder Core Enhancements: Preserving the expressions Using the same parameter variable for several blocks Restrictions apply to specific cases, see Simulink and Simulink Coder documentation for details. Model Referencing Up to R2013b, Simulink Coder forced the Inline Parameters option to be set to On for referenced models. Therefore, the block parameters were not available in the TRC file, unless you explicitly configured selected parameters to remain tunable. This was a major disadvantage when Simulink model referencing was used for large-scale modeling use cases, such as HIL simulations. 8 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Introduction and Technical Background To resolve this disadvantage, Simulink Coder supports the Inline Parameters option with the value Off for referenced models as of R2014a. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 9

Introduction and Technical Background Summary of Resulting Advantages The advantages of the enhancements described earlier can be summarized as follows: Same behavior of Simulink offline and dspace simulation In future dspace Releases, the parameter change behavior in real-time simulations (generated with RTI or ConfigurationDesk) and in VEOS simulations will be the same as in Simulink offline simulations. Consistent parameter tuning of multiple blocks in a model will be possible for dspace simulations in the same way as for Simulink offline simulations. Same view on model parameters in MATLAB workspace and TRC file Most models are parameterized by MATLAB workspace variables that are entered in the Simulink block dialogs. These variables are now tunable in the generated code. All tunable model parameters defined by MATLAB workspace variables are consistently present in the TRC file within the top-level Tunable Parameters group and under the same name. You no longer have to search for parameters defined by MATLAB workspace variables in the model hierarchy. It also enables you to modify the model hierarchy without affecting parameter access of ControlDesk Next Generation layouts and test scripts. Working with MATLAB structures If you use MATLAB structures to define the parameters of a model, the parameter structure is preserved in the generated code, including the names of the structure levels and structure fields (provided the structure is tunable according to Simulink Coder rules). The parameter structure can therefore be presented in an identical manner in the TRC file in future dspace Releases, i.e., you have the same view on parameters in the MATLAB workspace and in ControlDesk Next Generation. More compact models by using tunable parameter expressions In future dspace Releases, you will no longer have to model tunable parameter expressions by using several interconnected Simulink blocks. Models will therefore be more compact and easier to read. With the new modeling principle shown in the following example, the two parameters K and L are also available in the TRC file: 10 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Introduction and Technical Background Before New Tunable parameters identical for Inline Parameters options Off and On It is possible to retain the mapping between tunable workspace variables and variables in generated code, irrespective of the Inline Parameters setting. In future dspace Releases, this will enable you to configure your model and parameters in a way to get the same global tunable parameters in the TRC file (in the Tunable Parameters group) for both settings of the Inline Parameters option. Significant improvement of model referencing support In the past, the Inline Parameters option was forced to be On. This was a major disadvantage when you used Simulink model referencing for large-scale modeling use cases, such as HIL simulations. To resolve this limitation in future dspace Releases, Simulink Coder now supports the Inline Parameters option with the value Off for referenced models. This is a significant benefit for modeling and building large applications. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 11

Overview of Planned dspace Support Overview of Planned dspace Support Significant development work is required to integrate the Simulink Coder enhancements described in Introduction and Technical Background into the dspace tool chain. The generation of variable description files (TRC files) by RTI, ConfigurationDesk, and VEOS has to be extended accordingly to support these enhancements. Furthermore, the dspace products ControlDesk Next Generation, AutomationDesk, ModelDesk, Automotive Simulation Models, HIL API, RTPLIB2, and Real-Time Testing (RTT) have to support the new TRC file features. The letters A, B, and C stand for different basic characteristics or features of the support. These basic characteristics are kept unchanged across the dspace Releases for a specific MATLAB Release. dspace Releases Release 2014-A Release 2014-B Release 2015-A Release 2015-B Release 2016-A Release 2016-B Release 2017-A MATLAB Releases R2012b as known - - - - - - R2013a as known as known - - - - - R2013b as known as known as known - - - - R2014a Step A (*) (**) Step A (**) Step A (**) Step A (**) - - - R2014b - Step B (**) Step B (**) Step B (**) Step B - - R2015a - - Step B (**) Step B (**) Step B Step B - R2015b - - - Step C Step C Step C Step C R2016a - - - - Step C Step C Step C R2016b - - - - - Step C Step C R2017a - - - - - - Step C Step A (for R2014a) The behavior of Simulink Coder code generation and dspace TRC file generation is the same as with R2013b, i.e., as known. This means that none of the advantages described in Introduction and Technical Background are available. The support is based on the revertinlineparametersofftor2013b Simulink command, which you must execute before using RTI, ConfigurationDesk, or VEOS. (*) For official support of MATLAB R2014a with dspace Release 2014-A, Service Pack 2 must be installed. See http://www.dspace.com/go/matlabr2014a for more details. (**) Setting the Inline Parameters option to Off for referenced models is not supported for dspace Releases 2014-A up to 2015-B. 12 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Overview of Planned dspace Support Step B (for R2014b and R2015a) Using the same parameter variable for several blocks is supported for block parameters that are defined with an unstructured MATLAB workspace variable and without expressions. Other cases of block parameter definitions still have the previous behavior, i.e., they lead to block-specific independent parameter variables in the generated code and mask parameters are not available in the generated code. (**) Setting the Inline Parameters option to Off for referenced models is not supported for dspace Releases 2014-B, 2015-A and 2015-B with R2014b and R2015a. Support for dspace Release 2016-A is planned. Step C (for R2015b and higher) Full support of the new Simulink Coder features and advantages described in Introduction and Technical Background is provided, including new TRC file generation and new dspace experiment software features. (**) Setting the Inline Parameters option to Off for referenced models is not supported for dspace Release 2015-B with R2014a, R2014b and R2015a, but support for R2015b is planned. Support for dspace Release 2016-A is also planned. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 13

Features and Compatibility Considerations Features and Compatibility Considerations This section provides information on features and compatibility considerations relevant for Steps A to C. Step A (Support for R2014a) Features If you use MATLAB R2014a, you have to execute the revertinlineparametersofftor2013b command. This command activates the Simulink Coder behavior in MATLAB R2014a and dspace TRC file generation, which is similar to that in MATLAB R2013b and ealier. Therefore, none of the advantages described in Introduction and Technical Background are available. The revertinlineparametersofftor2013b command is shipped with MATLAB R2014a as part of the Simulink Coder product. For more details, see the Simulink Coder release notes here: http://www.mathworks.de/de/help/rtw/releasenotes.html (MathWorks Account required). Handling of revertinlineparame tersofftor2013b command If you use MATLAB R2014a, you have to execute the revertinlineparametersofftor2013b command before using RTI, ConfigurationDesk, or VEOS. You have the following options to do this: Execute the command manually after MATLAB started Add a call to your startup.m script (see MATLAB documentation for more details on the startup.m script) Add a call to your dsstartup.m script (see dspace documentation for more details on the dsstartup.m script) Compatibility considerations For dspace Release 2014-A, support is unofficial. Known issues of R2014a support are described here: http://www.dspace.com/go/matlabr2014a. For official support of R2014a with dspace Release 2014-A, Service Pack 2 must be installed. 14 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations The following minor changes generally apply for dspace Release 2014-B and later: For R2014a and later: The TRC file no longer contains entries for output signals of a Bus Selector block connected to a nonvirtual bus and for other virtual blocks connected to these signals. This is due to a change in the behavior of the Simulink Bus Selector block. ControlDesk layout instrument connections and test scripts accessing such signals must be updated. The TRC file generation option Apply subsystem read/write permissions is discontinued. This affects only the TRC file generation option. You can still configure the Simulink subsystem read/write permissions in the Simulink editor as you like. For R2014a support, we do not expect any other compatibility issues related to TRC file generation and migration of existing ControlDesk layouts or test scripts. Step B (Support for R2014b and R2015a) Features In this step, using the same parameter variable for several blocks is supported for block parameters that are defined with an unstructured MATLAB workspace variable and without expressions. The following table gives you an example of the above: Description Example Model Generated Code (Principle) An unstructured variable is defined in the MATLAB workspace: >> P = 2.0; Two blocks in the model use this variable. The variable is used without an expression. Previous: real_t Gain_Gain = 2.0; real_t Constant_Value = 2.0; y1 = Gain_Gain * u; y2 = Constant_Value; New: real_t P = 2.0; y1 = P * u1; y2 = P; The following table shows the resulting TRC file: TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 15

Features and Compatibility Considerations TRC File up to R2014a (up to Step A) TRC file has: A Gain parameter for the Gain block (as in Step A and earlier) A Value parameter for the Constant block (as in Step A and earlier) The two TRC parameters point to different variables in the code (i.e., to different addresses). Therefore, writing a new value to one of these TRC parameters changes the parameter for only one of the blocks. TRC File for R2014b and R2015a (Step B) TRC file has: A Gain parameter for the Gain block (as in Step A and earlier) A Value parameter for the Constant block (as in Step A and earlier) A P parameter in the Tunable Parameters group (new) All three TRC parameters point to the same variable in the code (i.e., to the same address). Therefore, writing a new value to any of these TRC parameters changes the parameter for both blocks. All other cases of block parameter definition still have the previous behavior (as in Step A and earlier), i.e., they lead to block-specific independent parameter variables in the generated code. This applies to: Block parameters defined with expressions (e.g., K+1) Block parameters defined from structured MATLAB workspace variables (e.g., mystruct.a.b.c.myparam) Block parameters defined by mask parameters Compatibility considerations We do not expect major compatibility issues during TRC file generation and migration of existing ControlDesk layouts or test scripts. However, because of the wide variety of modeling variants, there may be rare cases requiring some minor adjustments when you migrate your models or projects. The following minor changes generally apply for dspace Release 2014-B and later: For R2014a and later: The TRC file no longer contains entries for output signals of a Bus Selector block connected to a nonvirtual bus and for other virtual blocks connected to these signals. This is due to a change in the behavior of the Simulink Bus Selector block. ControlDesk layout instrument connections and test scripts accessing such signals must be updated. The TRC file generation option Apply subsystem read/write permissions is discontinued. This affects only the TRC file generation option. You can still 16 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations configure the Simulink subsystem read/write permissions in the Simulink editor as you like. The most important issue that you should be aware of: In a modeling and parameter situation as described in the example above (Step B (Support for R2014b and R2015a) Features), changing the parameter value effectively changes the parameter for several blocks. This results in a consistent simulation behavior on different execution platforms according to the original Simulink model. Step C (Support for R2015b and Higher) Features In this step, the new Simulink Coder behavior as described in Introduction and Technical Background is planned to be fully adopted and supported for dspace systems, resulting in the benefits described in Summary of Resulting Advantages under Introduction and Technical Background. Besides these new features, it is planned to redesign and streamline some functionalities of TRC file generation in order to improve usability and performance. However, this means that some TRC file features will be discontinued or behave differently than in the past. Although we strive to reduce migration issues as much as possible, you should be prepared for major adjustment work when you migrate your model or projects. The possible issues are described in the following table. Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary TRC file generation options Include only Simulink.Parameter and Simulink.Signal objects with global storage class TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 17

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Include signal labels Include virtual blocks Include states Planned to also be available for ConfigurationDesk and VEOS. Include derivatives Planned to also be available for ConfigurationDesk and VEOS. Apply subsystem read/write permissions This TRC file generation option is discontinued. This affects only the TRC file generation option. You can still configure the Simulink subsystem read/write permissions in the Simulink editor as you like. Include initial parameter values Apply subsystem omission tags Block parameters in Tunable Parameters group, if Inline Parameters option is set to On Parameters in the top-level Tunable Parameters group 18 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Parameters in Tunable Parameters groups of referenced models (i.e., Tunable Parameters groups in the model hierarchy below the Model Root group) These additional groups are no longer generated. All tunable parameters of the top-level model and of all referenced models are generated only into the top-level Tunable Parameters group. This improves performance and usability. ControlDesk layout instrument connections and test scripts accessing tunable parameters of referenced models must be updated to access the parameters available in the toplevel Tunable Parameters group. Tip: You can already carry out this change with dspace Release 2014-A and earlier. Block parameters below Model Root group, if Inline Parameters option is set to Off Block parameters specified with numbers (e.g., 2.71 or [1, 6, 7]) or with expressions only involving numbers (e.g., 2.71+4) Block parameter is local to the block as in Step A and earlier. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 19

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Block parameters defined with an unstructured MATLAB workspace variable and without expressions (e.g., P=2.71 in MATLAB workspace and P used as block parameter). Same case if P is a Simulink.Parameter object. Several blocks can share the same parameter P, which now is a model-wide parameter; see description of Step B (section 0). The dspace tools and the TRC file ensure that ControlDesk Next Generation layouts and test scripts work without requiring manual adjustments. Block parameters defined with references to fields of a MATLAB structure (e.g., mystruct.p=2.71 in MATLAB workspace and mystruct.p used as block parameter. For MATLAB structures that fulfill the Simulink Coder conditions for a tunable structured parameter, the complete mystruct structure is planned to be available as one structured variable in the TRC file. So the same view on parameters is available in the MATLAB workspace and in ControlDesk Next Generation. The dspace tools and the TRC file ensure that ControlDesk Next Generation layouts and test scripts accessing block parameters, which reference fields of structured variables, work without requiring manual adjustments. 20 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Block parameters depending on a mask parameter of a masked subsystem, if the mask parameter is used without expressions (e.g., MP=2.71 defined in the mask, several blocks below the mask using MP). Several blocks can share the same mask parameter MP. The dspace tools and the TRC file ensure that ControlDesk Next Generation layouts and test scripts accessing block parameters, which reference mask parameters, work without requiring manual adjustments. Block parameters defined with one or more MATLAB workspace variables using expressions (e.g., P=2.71 in MATLAB workspace and P+4 used as block parameter). The original parameter local to the block is no longer available in the TRC file. Parameter P is available as a model-wide parameter instead. Same case if P is a Simulink.Parameter object. ControlDesk layout instrument connections and test scripts accessing such a block local parameter must be updated. However, simply changing the connection to the model-wide parameter P is most probably not what is desired. Block signals below Model Root group TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 21

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Virtual Simulink buses The TRC file no longer contains entries for virtual buses (e.g., Out1{SubArray1}). This improves performance and usability. ControlDesk layout instrument connections and test scripts accessing signals within virtual Simulink buses must be updated to directly access the signal source block. Nonvirtual Simulink buses The representation of nonvirtual Simulink buses in the TRC file has changed. Instead of multiple entries (one for each bus signal), the complete Simulink bus is planned to be available as one structured variable in the TRC file. This improves performance and usability and is consistent with the representation of tunable structured parameters (see above). ControlDesk layout instrument connections and test scripts accessing signals within nonvirtual Simulink buses must be updated to access the corresponding leaf element of this structured variable. 22 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Signals downstream of a Bus Selector block The TRC file no longer contains entries for output signals of a Bus Selector block connected to a nonvirtual bus and for other virtual blocks connected to these signals. This is due to a change in the behavior of the Simulink Bus Selector block. ControlDesk layout instrument connections and test scripts accessing such signals must be updated to access the corresponding leaf struct component of the structured variable generated for a nonvirtual bus. Input signals of signal sink blocks Planned to also be available for ConfigurationDesk and VEOS. All other block output signals Other Labels group (Simulink block signals with labels) Labels for virtual and nonvirtual Simulink buses are affected in the same way as described above. TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 23

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Data Stores group The Data Stores group is no longer generated. The feature is discontinued to improve performance and consistency with other blocks. ControlDesk layout instrument connections and test scripts accessing TRC variables of the Data Stores group must be updated to access a corresponding Data Store Read block in the Model Root hierarchy. If write access is required, the model must use a Constant block connected to a Data Store Write block and the parameter of the Constant Block must be accessed. Tip: You can already carry out these changes with dspace Release 2014-A and earlier. State Machine Data group (variables of Stateflow charts) RTI Simulation control variables (e.g., simstate) Task Info group (RTI task information variables, e.g., turnaround Time) 24 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Simulation and RTOS group (ConfigurationDesk simulation control and task information variables, e.g., simstate and Task Turnaround Time) RTT Dynamic Variables group (Real-Time Testing) BusSystems group (RTI CAN MultiMessage Blockset, RTI LIN MultiMessage Blockset, FlexRay Configuration Tool; Ethernet Configuration Tool) Signal Chain group (variables for I/O signal chain configured in ConfigurationDesk) Diagnostics group (variables for diagnostics of a SCALEXIO system) TRC variable rtiassertionmode The feature is discontinued. This control variable is no longer available. TRC variables for Functional Mock-up Units (ConfigurationDesk FMI support) TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 25

Features and Compatibility Considerations Feature Explanations Unchanged Changes + Automatic Migration Provided Incompatible Changes + Manual Adjustments Necessary Two-dimensional slices of parameters with three or more dimensions The TRC file no longer contains additional slices for parameters with three or more dimensions. This was previously the case for Lookup Table blocks and if Inline Parameters was selected for entries the Tunable Parameters group. ControlDesk layout instrument connections and test scripts accessing these slices of a parameter must be updated to access the corresponding elements of the parameter itself instead. 26 TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015

Change History Change History October 13, 2015 Minor linguistic corrections September 3, 2015 Corrections Time schedule for supporting Inline Parameters option set to Off for referenced models on page 13 August 27, 2015 Corrections Additions Typo "searing" corrected to "searching" Step A (for RLS 2014-A) corrected to Step A (for R2014a) Step B (for RLS 2014-B and RLS 2015-A) corrected to Step B (for R2014b and R2015a) Step C (for RLS 2015-B and beyond) corrected to Step C (for R2015b and beyond) Added "Step B" in Overview table at RLS 2016-A/R2014b. August 13, 2015 Additions Feature added for Step C: "2-dimensional slices" of parameters with three or more dimensions January 31, 2015 Initial Revision TRC File Changes with dspace Release 2014-A and Later Migration Guide - October 2015 27