Mathworks EMBEDDED IDE LINK RELEASE NOTES

Embedded IDE Link™ Release Notes
How to Contact The MathWorks
www.mathworks. comp.soft-sys.matlab Newsgroup www.mathworks.com/contact_TS.html Technical Support
bugs@mathwo doc@mathworks.com Documentation error reports service@mathworks.com Order status, license renewals, passcodes
info@mathwo
com
rks.com
rks.com
Web
Bug reports
Sales, prici
ng, and general information
508-647-7000 (Phone)
508-647-7001 (Fax)
The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site.
Embedded IDE Link™ Release Notes
© COPYRIGHT 2004–20 10 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathW orks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern theuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramand Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the government’s needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Docu mentation, unused, to The MathWorks, Inc.
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See
www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand
names may be trademarks or registered trademarks of their respective holders.
Patents
The MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.
Summary by Version ............................... 1
Contents
Version 4.1 (R2010a) Embedded IDE Link
Version 4.0 (R2009b) Embedded IDE Link
Compatibility Sum mary for E mbedded IDE Link
............ 3
............ 9
..... 15
iii
iv Contents
SummarybyVersion
This table provides quick access to what’s new in each version. For clarification, see “Using Release Notes” on page 1 .
Embedded IDE Link™ Release Notes
Version (Release)
Latest Versi V4.1 (R2010a
New Produc V4.0 (R200
t
9b)
New Features and Changes
on
Yes
)
Details
Yes Details
Version Compatibilit Consideratio
No Bug Reports
Yes Summary
Fixed Bugs
y
and Known
ns
Problems
Bug Reports No
Related Documentation at Web Site
Printable R elease Notes: PDF
Current product documentation
Using Release Notes
Use release notes when upgrading to a newer version to learn about:
New features
Changes
Potential impact on your existing files and practices
Review the release notes for other MathWorks™ products required for this product (for example, MATLAB bugs, or compatibility considerations in other products impact you.
®
or Simulink®). Determine if enhancements,
If you are upgrading from a software version other than the m ost recent one, review the current release notes and all interim versions. For example, when you upg rade from V1.0 to V1.2, review the release notes for V1.1 and V1.2.
What Is in the Release Notes
New Features and Changes
New functionality
1
Embedded IDE Link™ Release Notes
Changes to existing functionality
Version Compatibility Con si derations
When a new feature or change introduces a reported incompatibility between versions, the Compatibility Considerations subsection explains the impact.
Compatibility issues reported after the product release appear under Bug Reports at The MathWorks™ Web site. Bug fixes can sometimes result in incompatibilities, so review the fixed bugs in Bug Reports for any compatibility impact.
Fixed Bugs and Known Problems
The MathWorks offers a user-searchable Bug Reports database so you can view Bug Reports. The development team updates this database at release time and as more information becomes available. Bug Reports include provisions for any known workarounds or file replacem ents. Information is available for bugs existing in or fixed in Release 14SP2 or later. Information is not avail able for all bugs in earlier releases.
Access Bug Reports using y our MathWorks Account.
2
Version 4.1 (R2010a) Embedded IDE Link™
Version 4.1 (R2010a) Embedded IDE Link
This table summarizes what is new in V4.1 (R2010a):
New Features and Changes
Yes Details belo
w
Version Compatibility Consideratio
ns
Fixed Bugs an d Known Problems
No Bug Reports
New featur
“Embedded
“Support
“New Demo
“Automa
“New Dem
“Suppo
“Optim
“Opti
for Bl
“Supp
“New
es and changes introduced in this version are
IDE Link Software Runs on Linux” on page 4
for Eclips e IDE for C/C++ Developers Package” on page 4
s for Using Embedded IDE Link with Eclipse” on page 4
tically Create and Use Makefiles” on page 5
o for Using Makefiles” on page 5
rt for Top-Model Processor-in-the-Loop” on page 5
izations for Fixed-point Code on ARM Processors” on page 6
mizations for 32-bit to 16-bit Data Type Conversions with Saturation
ackfin Processors” on page 6
ort for Analog Devices
Configuration Utility for Analog Devices
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
VisualDSP++ 5.0 with Update 6” on page 6
VisualDSP++” on page 6
“Sup
“De
“Ne
“C
port for Texas Instruments’ Code Composer Studio 3.3 with SR12”
ge 7
on pa
mo: Project Generator Tutorial for IAR Embedded Workbench and TI
430 Platform” on page 7
MSP
wandUpdatedDemos”onpage7
hanges to the Stack Size Parameter” on page 7
3
Embedded IDE Link™ Release Notes
Embedded IDE Link S oftware Runs on Linux
YoucanruntheEmbeddedIDELink™productona32-bitx86 compatible workstation running Linux see the System Re quirements for Embe dded IDE Link at www.mathworks.com/products/ide-link/requirements.html.
If you use the Embedded IDE Link product on a Linux development workstation:
®
. For more information,
For the Eclipse™ and MULTI
®
IDEs, all of the main features in the
Embedded IDE Link product are available .
For the Code Composer Studio™, TASKING
®
,andVisualDSP++®IDEs, you can create models and run all simulations in the Embedded IDE Link product. However, you cannot generate code or automate code generation.
Support for Eclipse IDE for C/C++ Developers Package
You can now use the Embedded IDE Link product with the Eclipse IDE for C/C++ Developers package and GNU development tools. Works on development workstations running Linux, MontaVista Windows
®
. For more information, see the Embedded IDE Link User’s Guide .
®
Linux 6, and
Note Ensure you have the correct versions of the Eclipse packages and GNU build tools before you use Embedded IDE Link software with the Eclipse IDE. Follow the instructions in the “Getting Started” topic.
New Demos for Using Embedded IDE Link with Eclipse
New demos for using Embedded IDE Link with the Eclipse IDE:
Getting Started — Automation Interface Tutorial
Getting Started — Project Generator Tutorial
Control Applications — Verifying the Fixed-Point Fuel Control System
Workflows — Getting Started with Application Development
4
Version 4.1 (R2010a) Embedded IDE Link™
Automatically Create and Use Makefiles
You can configure Embedded IDE Link to automatically generate makefiles, and build applications using makefiles with the fol lowing toolchain and processor combinations:
Toolchains
Analog Devices VisualDSP++
®
Green Hills®MULTI
Processor Families/Target OSs
Blackfin™, SHARC™, and TigerSHA RC™
®
ARM®,Analog Devices PowerPC
Blackfin®,
®
,andNEC
Development Platforms
Windows
Linux, W indows
®
V850
GNU development tools
GNU development tools ARM
MinGW development
Linux Linux
MontaVis
Windows Windows
ta Linux
tools
Texas Instruments™ Code Composer Studio
Texas Instruments C2000™, C5500™, and
Window
s
C6000™
For more information, see “Generating Makefiles” in the Embedded IDE Link User’s Guide.
New Demo for Using Makefiles
This release provides a new Makefile Generator tutorial which you can use to learn about the makefile generator in Embedded IDE Link software.
Support for Top-Model Processor-in-the-Loop
Embedded IDE Link software now supports the Top-Model Processor-in-the-Loop (PIL) feature. Use top-model PIL if you want to:
Verify code generated for a top model (standalone code interface).
5
Embedded IDE Link™ Release Notes
Load test vectors or stimulus inputs from the MATLAB workspace.
Switch the entire model between normal and Software-in-the-Loop (SIL) or
PIL simulation modes.
For more information, see “Using the Top-Model PIL Approach” in the Embedded IDE Link User’s Guide.
Optimizations for Fixed-point Code on ARM Processors
Effective this release, Embedded IDE Link software prov ides ARM fixed-point intrinsics that the MontaVista Linux compiler uses to gene rate optimized fixed-point code for ARM processors.
Optimizations for 32-bit to 16-bit Data Type Conversions with Saturation for Blackfin Processors
Embedded IDE Link software now provides target function libraries that optimize 32-bit to 16-bit data type conversions with saturation for Blackfin Processors.
Support for Analog Devices V isualDSP++ 5.0 w ith Update 6
Embedded IDE Link software now supports Analog Devices VisualDSP++ version 5.0 with Update 6.
New Configuration Utility for Analog Devices VisualDSP++
Use the new configuration utility, adivdspsetup,toinstallan EmbeddedEmbedded IDE Link plug-in in the appropriate folder for Analog Devices VisualDSP++. For more information, see “Getting Started” in the Embedded IDE Link User’s Guide for Use with Analog Devices VisualDSP++.
6
Version 4.1 (R2010a) Embedded IDE Link™
Support for Texas Instrum ents’ Code Composer Studio 3.3 with SR12
Embedded IDE Link software now supports Texas Instruments’ Code Composer Studio™ with Service Release 12 (SR12).
Demo: Project Generator Tutorial for IAR Embedded Workbench and TI MSP430 Platform
This release provides a new tutorial that demonstrates the Project Generator component of Embedded IDE Link. The tutorial uses a simple Simulink model to show you how to generate a working algorithmic project and execute it on the TI MSP430™ F2013™ processor. For more information, see the Project Generator Tutorial demo.
New and Updated Demos
Optimizing Embedded Code via Target Function Library
Getting Started with Application Development
Changes to the Stack Size Parameter
The Real-Time Workshop®product (RTW ) has changed the way it performs stack analysis and control. For more information, see “Improved Stack Analysis and Control”in the RTW release notes.
In Embedded IDE Link models, when you set the System target file parameter on the Real-Time Workshop pane to
idelink_grt.tlc, the software sets the Maximum stack size pa ra m eter on
the Optimization pane to In that case, the Maximum stack size parameter compares the value of (System stack size/2) with 200,000 bytes and uses the smaller of the two values.
Inherit from target and makes it non-editable.
Avoiding Linker Errors Related to Stack Size
If RTW estimates the stack size is large enough, it redefines global variables and buffers from model_output and model_step functions as local variables. This optimization typically increases execution speed, and migh t also increase thesizeofthegeneratedcode. Ifthe generated code does not fit in the
idelink_ert.tlc or
7
Embedded IDE Link™ Release Notes
memory allocated for code, the linker generates an error message during the build process. You can avoid this errorbyperformingeitherorbothofthe following steps:
Decrease the stack size for you r m od el. Press Ctrl+E to open the
Configuration Parameters dialog box for your model. Then select Real-Time Workshop > Embedded IDE Link and decrease the System stack size (MAUs) value.
Open the target preferences block in your model and, under the Section
tab, assign the memory.
.text or program section to a placem en t that has more
8
Version 4.0 (R2009b) Embedded IDE Link™
Version 4.0 (R2009b) Embedded IDE Link
This table summarizes what is new in V4.0 (R2009b):
New Features and Changes
Yes Details belo
w
Version Compatibility Consideratio
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New featur
es and changes introduced in this version are
“New Embed
“Unified
“Enhance
“Suppor
“Suppor
5.0.5)
“Suppo
“Supp
“Impr
Proce
Idle Task, Memory Allocate, and Memory Copy Blocks” on page 10
d Target Preference and Custom B oard Blocks” on page 11
t for Analog Devices
t for Update 5 of Analog Devices
”onpage11
rt for Free-running ARM with Green Hills
ort for Green Hills
oved Handling of Asynchronous Hardware Interrupts for Blackfin
ssors” on page 11
Fixed Bugs an d Known Problems
ns
Bug Reports No
ded IDE Link Product” on page 10
Blackfin 52x Processor Family” on page 11
VisualDSP++ (VisualDSP++
®
MULTI 5.0.5 and 5.1.2” on page 11
Related Documentation at Web Site
®
MULTI” on page 11
“Rem
“Emb
“Li
“Li
oved "Inline run-time library functions" From Configuration
meters” on page 12
Para
edded IDE Link Build Directory and Target Preferences” on page 12
mitation: XDS100 Emulator Does Not Support RTDX” on page 13
mitation: Simulink Does Not Support Custom Scheduler Priorities for
edded IDE Link Platforms” on page 13
Emb
9
Embedded IDE Link™ Release Notes
New Embedded IDE
As of R2009b, the Embedded IDE Lin
Embedded IDE Li
Embedded IDE L
Embedded IDE L
Embedded IDE
following products have been merged into a new product,
k
nk CC
ink MU
ink TS
Link VS
Link Product
Compatibility Considerations
The merged p To access Em menu, ente TASKING Ut IDE Link Ut see “Acce
You must u prefere TASKING either a you u se t produc reset. Target
nce fields when setting up your product for use with Altium
t could cause a compatibility issue if the target preferences are not
To avoid problems, click Reset to Default in the Embedded IDE Link
Preferences dialog box before setting up your instal lation.
roduct structure has changed the Start menu functionality.
beddedIDELinkTSfeaturesthatusedtobeintheStart
r taskingutils in the Command Window or double-click Launch
ilities in the Simulink block library. This opens the Embedded
ilities for Use with TASKING dialog box. For more information,
ssing Utilities for TASKING” in the documentation.
se a c lea n build directory and the latest values for the target
. To avoid problems when upgrading from a previous version, use
new build directory, or clean up your existing build directory that
o build models. A previous installation of the Embedded IDE Link
®
10
Note R entr
Unif Cop
Uni wit An
esetting your target preferences overwrites any previously saved
ies for the current MATLAB release.
ied Idle Task, Memory Allocate, and Memory
y Blocks
fied the Idle Task, Memory Allocate, and Memory Copy blocks to work
h Texas Instruments’ Code Composer Studio, Green Hills MULTI, and
alog Devices VisualDSP++.
Version 4.0 (R2009b) Embedded IDE Link™
Enhanced Target Preference and Custom Board Blocks
Improved the responsiveness of the dialog boxes for the Target Preferences blocks and Custom Board blocks.
Support for Analog Devices Blackfin 52x Processor Family
Added support for the Analog Devices Blackfin 52x family of processors.
Support for Update 5 of Analog Devices VisualDSP++ (VisualDSP++ 5.0.5)
Added support for Update 5 of Analog Devices Visua lDSP++ (VisualDSP++
5.0.5). Installing Update 5 significantly improves the performance of code you generate for embedded applications on Blackfin.
Support for Free-running ARM with Green Hills MULTI
Added support for free-running ARM processors with the Green Hills MULTI IDE.
Support for Green Hills MULTI 5.0.5 and 5.1.2
Added support for Green Hills MULTI 5.0.5 and 5.1.2.
Improved Handling of Asynchronous Hardware Interrupts for Blackfin Processors
For Analog Devices VisualDSP++ and Green Hills MULTI, Embedded IDE Link has changed the Blackfin base rate interrupt scheme to reduce latency for asynchronous hardware interrupts of various priorities.
In previous releases, the core timer generated a high-priority base rate interrupt (higher than any of the peripheral interrupts) and it’s interrupt service routine (ISR) executed the rtOneStep() function directly. As a consequence, any peripheral interrupts had to wait until the completion of the core timer ISR before they could execute.
11
Embedded IDE Link™ Release Notes
In 9b, instead of executing the rtOneStep() function, the high priority core timer interrupt raises a low priority software interrupt and exits. The low priority software interrupt, in turn, executes rtOneStep(). Because the priority of the software interrupt is lower than the priorities of any of the peripheral interrupts, the peripheral interrupts are now able to preempt the execution of rtOneStep() and thus get serviced with a smaller latency.
Removed "Inline run-time library functions" From Configuration Parameters
Removed the Inline run-time library functions parameter from the Configuration Parameters dialog box under
Embedded IDE Link.
Embedded IDE Link Build Directory and Target Preferences
You must use a clean build directory and the latest values for the target preference fields when setting up your installation.
Real Time Workshop >
12
Compatibility Considerations
To avoid problems when upgrading from a previous version, use either a new build directory, or clean up your existing build directory that you use to build models with the Embedded IDE Link product.
A previous installation of the Embedded IDE Link product could cause a compatibility issue if the target preferences are not reset. To avoid problems, click Reset to Default in the Embedded IDE Link Targ et Preferences dialog box before setting up your installation.
Note Resetting your target preferences overwrites any previously saved entries for the current MATLAB release.
Version 4.0 (R2009b) Embedded IDE Link™
Limitation: XDS
The XDS100 emula Series of C2802x the Target Supp
For more infor
mation, see this Texas Instruments wiki topic.
100 Emulator Does Not Support RTDX
tor does not support RTDX™. If you connect to TI’s Piccolo
processors using XDS100 emulator you will b e unable to use
ort Package™ support for RTDX.
Compatibility Considerations
You cannot us
Target Supp
The Real-Ti
processors
Limitatio Scheduler
Simulink
properti
one of th
ccslink
generat
e
ort Package C2802x blocks with RTDX
me Data Exchange (RTDX) Tutorial demo with C2802x
n: Simulink Does Not Support Custom
Priorities for Embedded IDE Link Platforms
does not support custom scheduler priorities in the Sample time
es parameter when the System target file parameter is set to
efollowing:
_ert.tlc (Description: Embedded IDE Link (ERT) code
ion for TMS320(TM) DSP platforms)
ccslin
genera
multi
gener
multi
gene
vdsp
gene
vds
gen
For
nores the custom scheduler priorities
ig
k_grt.tlc (Description: Embedd ed IDE Link (GRT) code
tion for TMS320(TM) DSP platforms)
link_ert.tlc (Description: Embedded IDE Link (ERT) code
ation for many supported processors)
link_grt.tlc (Description: Embedded IDE Link (GRT) code
ration for all supported platforms)
link_ert.tlc (Description: Embedded IDE Link (ERT) code ration for ADI DSP platforms)
plink_grt.tlc (Description: E mbedded IDE Link (GRT) code
eration for ADI DSP platforms)
example, if you set System target file to ccslink_ert.tlc, Simulink
10, 20,and30 in the following Sample
13
Embedded IDE Link™ Release Notes
time properties parameter [[0.001,0,10];[0.01,0,20];[0.1,0,30];] and uses the default scheduler priorities instead.
Note Note: The Sample time properties parameter is located in the Configuration Parameters > Solver pane under Tasking and sample time options.TheSystem target file param eter is located in the Configuration Parameters > Real Time Workshop pane under Target selection.
14
Compatibility Summary for Embedded IDE Link™
Compatibility Summary for Embedded IDE Link
This table summarizes new features and changes that might cause incompatibilities when you upgrade from an earlier version, or wh en you use files on multiple versions. Details are provided in the description of the new feature or change.
Version (Release) New Features and Changes with
Version Compatib ility Impact
Latest Version V4.1 (R2010a)
V4.0 (R2009b) See the Compatibility
No
Considerations subheading for this new feature or change:
“New Embedded IDE Link
Product” on page 10
“Embedded ID E Link Build
Directory and Target Preferences” on page 12
“Limitation: XDS100 Emulator
DoesNotSupportRTDX”onpage 13
15
Loading...