Académique Documents
Professionnel Documents
Culture Documents
Users Guide
Web
Newsgroup
www.mathworks.com/contact_TS.html Technical Support
www.mathworks.com
comp.soft-sys.matlab
suggest@mathworks.com
bugs@mathworks.com
doc@mathworks.com
service@mathworks.com
info@mathworks.com
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 CC Users Guide
COPYRIGHT 20022009 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 MathWorks, 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
the use, modification, reproduction, release, performance, display, and disclosure of the Program and
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
governments needs or is inconsistent in any respect with federal procurement law, the government agrees
to return the Program and Documentation, 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.
Revision History
July 2002
October 2002
May 2003
September 2003
June 2004
October 2004
December 2004
March 2005
September 2005
March 2006
April 2006
September 2006
March 2007
September 2007
March 2008
October 2008
March 2009
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Online only
Contents
Getting Started
1
Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Components of Embedded IDE Link CC Software . . . . . . .
Automation Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Project Generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Product Features Supported for Each Processor Family . .
1-2
1-3
1-3
1-4
1-5
1-5
Configuration Information . . . . . . . . . . . . . . . . . . . . . . . . .
Verifying Your Code Composer Studio Installation . . . . . .
1-6
1-8
1-10
Automation Interface
2
Getting Started with Automation Interface . . . . . . . . . .
Introducing the Automation Interface Tutorial . . . . . . . . .
Selecting Your Processor . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating and Querying Objects for CCS IDE . . . . . . . . . . .
Loading Files into CCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Working with Projects and Data . . . . . . . . . . . . . . . . . . . . .
Closing the Links or Cleaning Up CCS IDE . . . . . . . . . . . .
2-2
2-2
2-7
2-8
2-10
2-13
2-19
2-21
2-22
2-27
2-30
2-32
2-39
2-43
2-46
2-46
2-48
2-49
2-50
2-50
2-52
2-58
2-60
Project Generator
vi
Contents
3-2
3-3
3-5
3-12
3-12
3-14
3-39
3-40
3-40
3-44
3-16
3-18
3-19
3-24
3-48
3-51
3-52
3-53
3-53
3-53
3-54
3-55
3-57
3-65
3-64
3-65
3-67
3-70
3-70
3-72
3-73
3-74
3-76
3-76
3-77
3-77
3-78
3-80
vii
Verification
4
What Is Verification? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4-2
4-3
4-3
4-6
4-6
4-8
4-11
4-11
4-12
4-14
4-19
4-19
4-21
5
About FDATool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5-2
5-4
5-4
5-5
5-6
viii
Contents
5-15
5-15
5-15
5-16
5-17
Function Reference
6
Operations on Objects for CCS IDE . . . . . . . . . . . . . . . . . .
6-2
6-4
7
Block Reference
8
C280x/C28x3x DSP Chip Support (ccslinklib_c280x) . . .
8-2
8-2
8-2
8-2
ix
8-3
8-3
9
Embedded IDE Link CC Configuration
Parameters
10
Embedded IDE Link CC Pane . . . . . . . . . . . . . . . . . . . . . . .
Embedded IDE Link CC Overview . . . . . . . . . . . . . . . . . . .
Export IDE link handle to base workspace . . . . . . . . . . . . .
IDE link handle name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Profile real-time execution . . . . . . . . . . . . . . . . . . . . . . . . . .
Profile by . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Number of profiling samples to collect . . . . . . . . . . . . . . . . .
Inline run-time library functions . . . . . . . . . . . . . . . . . . . . .
Project options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Compiler options string . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Linker options string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System stack size (MAUs) . . . . . . . . . . . . . . . . . . . . . . . . . .
Build action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interrupt overrun notification method . . . . . . . . . . . . . . . . .
Interrupt overrun notification function . . . . . . . . . . . . . . . .
PIL block action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Maximum time allowed to build project (s) . . . . . . . . . . . . .
Maximum time to complete IDE operations (s) . . . . . . . . . .
Source file replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents
10-2
10-4
10-5
10-7
10-8
10-10
10-12
10-14
10-16
10-18
10-20
10-22
10-23
10-26
10-28
10-29
10-31
10-33
10-35
Supported Hardware
A
Supported Platforms for Embedded IDE Link CC . . . . .
Supported Hardware and Simulators . . . . . . . . . . . . . . . . .
Product Features Supported by Each Processor or
Family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OMAP Coemulation Support . . . . . . . . . . . . . . . . . . . . . . . .
Custom Hardware Support . . . . . . . . . . . . . . . . . . . . . . . . . .
A-2
A-2
A-8
A-4
A-7
A-7
B
Reported Issues Using Embedded IDE Link CC
Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Demonstration Programs Do Not Run Properly Without
Correct GEL Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Issues Using USB-Based RTDX Emulators and the C6416
DSK and C6713 DSK . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Error Accessing type Property of ticcs Object Having Size
Greater Then 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the represent Property of an Object . . . . . . . . . .
Changing Values of Local Variables Does Not Take
Effect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Code Composer Studio Cannot Find a File After You Halt a
Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C54x XPC Register Can Be Modified Only Through the PC
Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Working with More Than One Installed Version of Code
Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing CCS Versions During a MATLAB Session . . . . .
MATLAB Hangs When Code Composer Studio Cannot Find
a Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Different Read Techniques Appear to Return Different
Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Function Call with C28x Processors . . . . . . . . . . . . .
RTDX Demos Do Not Run on C6727 PADK . . . . . . . . . . . .
B-2
B-3
B-4
B-5
B-6
B-7
B-7
B-9
B-9
B-10
B-10
B-12
B-13
B-13
xi
B-14
Index
xii
Contents
1
Getting Started
Product Overview on page 1-2
Configuration Information on page 1-6
Requirements for Embedded IDE Link CC Software on page 1-10
Getting Started
Product Overview
In this section...
Components of Embedded IDE Link CC Software on page 1-3
Automation Interface on page 1-3
Project Generator on page 1-4
Verification on page 1-5
Product Features Supported for Each Processor Family on page 1-5
Embedded IDE Link CC software enables you to use MATLAB functions
to communicate with Code Composer Studio software and with information
stored in memory and registers on a processor. With the ticcs objects, you
can transfer information to and from Code Composer Studio software and
with the embedded objects you get information about data and functions
stored in your signal processor memory and registers, as well as information
about functions in your project.
Embedded IDE Link CC lets you build, test, and verify automatically
generated code using MATLAB, Simulink, Real-Time Workshop, and the
Code Composer Studio integrated development environment. Embedded IDE
Link CC makes it easy to verify code executing within the Code Composer
Studio software environment using a model in Simulink software. This
processor-in-the-loop testing environment uses code automatically generated
from Simulink models by Real-Time Workshop Embedded Coder software.
A wide range of Texas Instruments DSPs are supported:
TIs C2000
TIs C5000
TIs C6000
With Embedded IDE Link CC , you can use MATLAB software and Simulink
software to interactively analyze, profile and debug processor-specific code
execution behavior within CCS. In this way, Embedded IDE Link CC
automates deployment of the complete embedded software application and
makes it easy for you to assess possible differences between the model
simulation and processor code execution results.
1-2
Product Overview
Automation Interface
The automation interface component is a collection of methods that use the
Code Composer Studio API to communicate between MATLAB software and
Code Composer Studio. With the interface, you can do the following:
Automate complex tasks in the development environment by writing
MATLAB software scripts to communicate with the IDE, or debug and
analyze interactively in a live MATLAB software session.
Automate debugging by executing commands from the powerful Code
Composer Studio software command language.
Exchange data between MATLAB software and the processor running
in Code Composer Studio software.
Set breakpoints, step through code, set parameters and retrieve profiling
reports.
1-3
Getting Started
Automate project creation, including adding source files, include paths, and
preprocessor defines.
Configure batch building of projects.
Debug projects and code.
Execute API Library commands.
The automation interface provides an application program interface (API)
between MATLAB software and Code Composer Studio. Using the API, you
can create new projects, open projects, transfer data to and from memory on
the processor, add files to projects, and debug your code.
Project Generator
The Project Generator component is a collection of methods that use the Code
Composer Studio API to create projects in Code Composer Studio and generate
code with Real-Time Workshop. With the interface, you can do the following:
Automated project-based build process
Automatically create and build projects for code generated by Real-Time
Workshop or Real-Time Workshop Embedded Coder.
Customize code generation
Use Embedded IDE Link CC with any Real-Time Workshop system target
file (STF) to generate processor-specific and optimized code.
Customize the build process
Automate code download and debugging
Rapidly and effortlessly debug generated code in the Code Composer
Studio software debugger, using either the instruction set simulator or
real hardware.
Create and build CCS projects from Simulink software models. Project
Generator uses Real-Time Workshop software or Real-Time Workshop
Embedded Coder software to build projects that work with C2000
software, C5000 software, and C6000 software processors.
1-4
Product Overview
Verification
Verifying your processes and algorithms is an essential part of developing
applications. The components of Embedded IDE Link CC combine to provide
the following verification tools for you to apply as you develop your code:
Execution Profiling
Gather execution profiling timing measurements with Code Composer
Studio instruction set simulator to establish the timing requirements of
your algorithm.
1-5
Getting Started
Configuration Information
To determine whether Embedded IDE Link CC is installed on your system,
type this command at the MATLAB software prompt.
ver
When you enter this command, MATLAB software displays a list of the
installed products. Look for a line similar to the following:
Embedded IDE Link CC
Version 3.x
(Release Specifier)
To get a bit more information about the software, such as the functions
provided and where to find demos and help, enter the following command at
the prompt:
help ticcs
Embedded IDE Link CC
Version 3.1 (R2007b Prerelease) DD-MMM-YYYY
==============================
Automation Interface Component
==============================
-----------------Debug Subcomponent
------------------
ticcs
ccsboardinfo
1-6
ccsdebug/add
ccsdebug/activate
ccsdebug/address
ccsdebug/animate
ccsdebug/build
ccsdebug/cd
ccsdebug/dir
ccsdebug/disp
Configuration Information
ccsdebug/display
ccsdebug/halt
ccsdebug/info
ccsdebug/insert
ccsdebug/isreadable
ccsdebug/isvisible
ccsdebug/iswritable
ccsdebug/list
ccsdebug/load
ccsdebug/new
ccsdebug/open
ccsdebug/profile
ccsdebug/read
ccsdebug/regread
ccsdebug/regwrite
ccsdebug/reload
ccsdebug/remove
ccsdebug/reset
ccsdebug/restart
ccsdebug/run
ccsdebug/save
ccsdebug/symbol
ccsdebug/visible
ccsdebug/write