Texas Instruments TMS320C6 Series User manual

TMS320C6x
C Source Debugger
User’s Guide
For SPARCstations
Preliminary
Literature Number: SPRU224
Manufacturing Part Number: D426029-9761 revision *
January 1997
Printed on Recycled Paper

Running Title—Attribute Reference
ii
IMPORTANT NOTICE
Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any
semiconductor product or service without notice, and advises its customers to obtain the latest
version of relevant information to verify, before placing orders, that the information being relied
on is current.
TIwarrantsperformanceofitssemiconductorproductsandrelatedsoftwaretothespecifications
applicableatthetimeofsaleinaccordancewithTI’sstandardwarranty.Testingandotherquality
control techniques are utilized to the extent TI deems necessary to support this warranty.
Specific testing of all parameters of each device is not necessarily performed, except those
mandated by government requirements.
Certain applications using semiconductor products may involve potential risks of death,
personal injury, or severe property or environmental damage (“Critical Applications”).
TI SEMICONDUCTOR PRODUCTS ARE NOT DESIGNED, INTENDED, AUTHORIZED, OR
WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORT APPLICATIONS, DEVICES
OR SYSTEMS OR OTHER CRITICAL APPLICATIONS.
Inclusion of TI products in such applications is understood to be fully at the risk of the customer.
UseofTIproducts in such applications requires the written approval ofanappropriateTI officer.
Questions concerning potential risk applications should be directed to TI through a local SC
sales office.
In order to minimize risks associated with the customer’s applications, adequate design and
operating safeguards should be provided by the customer to minimize inherent or procedural
hazards.
TI assumes no liability for applications assistance, customer product design, software
performance, or infringement of patents or services described herein. Nor does TI warrant or
representthatanylicense,eitherexpressorimplied,isgrantedunderanypatentright,copyright,
mask work right, or other intellectual property right of TI covering or relating to any combination,
machine, or process in which such semiconductor products or services might be or are used.
Copyright 1997, Texas Instruments Incorporated

iii Read This First
Preface
Read This First
What Is This Book About?
This book tells you how to use the TMS320C6x C source debugger with the
simulator.
There are two debugger environments: the basic debugger environment and
the profiling environment. The basic debugger environment is a general-pur-
pose debugging environment. The profiling environment is a special environ-
ment for collecting statistics about code execution.
Before you use this book, you should use the appropriate installation guide to
install the C source debugger and any necessary hardware.
How to Use This Manual
ThegoalofthisbookistohelpyoulearntousetheTexasInstrumentsstandard
programmer’s interface for debugging. This book is divided into three parts:
- Part I: Hands-On Information is presented first so that you can start
using your debugger the same day you receive it.
J Chapter 1 lists the key features of the debugger, describes additional
’C6x software tools, tells you how to prepare a ’C6x program for de-
bugging, and provides instructions and options for invoking the de-
bugger.
J Chapter2isatutorialthatintroducesyoutomanyofthedebuggerfea-
tures.
- Part II: Debugger Description containsdetailedinformationabout using
the debugger.
ThechaptersinPartIIdetailtheindividualtopicsthatareintroducedinthe
tutorial. For example, Chapter 3 describes all of the debugger’s windows
and tells you how to move and size them; Chapter 4 describes everything
you need to know about entering commands.

How to Use This Manual
iv
- Part III: Reference Material provides supplementary information.
J Chapter 11 gives a complete summary of all the tasks introduced in
PartsI andII. Thisincludes afunctionaland analphabetical summary
ofthedebuggercommandsandatopical summaryoffunctionkeyac-
tions.
J Chapter 12 provides information about C expressions. The debugger
commands are powerful because they accept C expressions as
parameters; however, you can also use the debugger to debug as-
sembly language programs. The information about C expressions
aids assembly language programmers who are unfamiliar with C.
J Part III also includes a glossary and an index.
Theway you use this book depends on your experience with similarproducts.
As with any book, it would be best for you to begin on page 1 and read to the
end. Because most people don’t read technical manuals from cover to cover,
here are some suggestions for choosing what to read.
- IfyouhaveusedTIdevelopmenttoolsorotherdebuggersbefore,youmay
want to:
J Read the introductory material in Chapter 1.
J Complete the tutorial in Chapter 2.
J Read the alphabetical command reference in Chapter 11.
- If this is the first time that you have used a debugger or similar tool, you
may want to:
J Read the introductory material in Chapter 1.
J Complete the tutorial in Chapter 2.
J Read all of the chapters in Part II.

Notational Conventions
v Read This First
Notational Conventions
This document uses the following conventions.
- The TMS320C6x family of devices is referred to as ’C6x.
- The C source debugger has a very flexible command-entry system; there
are usually a variety of ways to perform any specific action. For example,
youmaybeabletoperformthesameactionbytypinginacommand,using
the mouse, or using function keys. This document uses three symbols to
identify the methods that you can use to perform an action:
Symbol Description
Identifies an action that you perform by using the mouse
Identifies an action that you perform by using function keys
Identifiesanactionthatyouperformbytypinginacommand
- The following symbols identify mouse actions. For simplicity, these sym-
bols represent a mouse with two buttons. However, you can use a mouse
with only one button or a mouse with more than two buttons.
Symbol Action
Point . Without pressing a mouse button, move the mouse to
point the cursor at a window or field on the display. (Note that
themousecursordisplayedonthescreenisnotshapedlikean
arrow; it’s shaped like a block.)
Press and hold. Press a mouse button. If your mouse has only
one button, press it. If your mouse has more than one button,
press the left button.
Release. Release the mouse button that you pressed.
Click . Press a mouse button and, without moving the mouse,
release the button.
Drag. While pressing the left mouse button, move the mouse.
- Debuggercommandsarenotcasesensitive;youcanenter theminlower-
case,uppercase,oracombination.Toemphasizethisfact,commandsare
shown throughout this user’s guide in both uppercase and lowercase.

Notational Conventions
vi
- Programlistingsandexamples,interactivedisplays,andwindowcontents
are shown in a special font. Some examples use a bold version to identify
code, commands, or portions of an example that
you enter. Here is an
example:
Command Result displayed in the COMMAND window
whatis aai int aai[10][5];
whatis xxx struct xxx {
int a;
int b;
int c;
int f1 : 2;
int f2 : 4;
struct xxx *f3;
int f4[10];
}
In this example, the left column identifies debugger commands that you
typein. The rightcolumnidentifies the resultthatthe debuggerdisplays in
the display area of the COMMAND window.
- In syntax descriptions, the instruction or command is in a bold face font,
and parameters are in italics . Portions of a syntax that are in bold face
should be entered as shown; portions of a syntax that are in italics
describe the kind of information to be entered. Here is an example of a
command syntax:
load
object filename
load is the command. This command has one required parameter, indi-
cated by object filename .
- Square brackets ( [and ]) identify an optional parameter. If you use an
optional parameter, you specify the information within the brackets; you
don’t enter the brackets themselves. Here’s an example of a command
that has an optional parameter:
run [
expression ]
The RUN command has one parameter, expression , which is optional.
- Braces( {and} )indicatealist.Thesymbol|(readas or )separatesitems
within the list. Here’s an example of a list:
sound {on | off}
This provides two choices: sound on or sound off.
Unless the list is enclosed in square brackets, you must choose one item
from the list.

Related Documentation From Texas Instruments
vii Read This First
Related Documentation From Texas Instruments
The following books describe the TMS320C6x DSPs and related support
tools. To obtain a copy of any of these TI documents, call the Texas Instru-
mentsLiteratureResponseCenterat(800)477–8924.Whenordering,please
identify the book by its title and literature number.
TMS320C6x Assembly Language Tools User’s Guide (literature number
SPRU186) describes the assembly language tools (assembler, linker,
and other tools used to develop assembly language code), assembler
directives, macros, common object file format, and symbolic debugging
directives for the ’C6x generation of devices.
TMS320C6x Optimizing C Compiler User’s Guide (literature number
SPRU187)describesthe’C6xCcompiler.ThisCcompileracceptsANSI
standard C source code and produces assembly language source code
for the ’C6x generation of devices. This book also describes the
assembly optimizer, which helps you optimize your assembly code.
TMS320C6x Software Tools Getting Started Guide (literature number
SPRU185)describeshowtoinstalltheTMS320C6xassemblylanguage
tools,the C compiler, thesimulator, andthe C sourcedebugger.Installa-
tion instructions for SunOS, Solaris, Windows95, and Windows
NTsystems are given.
TMS320C62xx CPU and Instruction Set Reference Guide (literature
number SPRU189) describes the ’C62xx CPU architecture, instruction
set, pipeline, and interrupts for the TMS320C62xx digital signal proces-
sors.
TMS320C62xx Peripherals Reference Guide (literature number SPRU190)
describes common peripherals available on the TMS320C62xx digital
signal processors. This book includes information on the internal data
and program memories, the external memory interface (EMIF), the host
port, serial ports, direct memory access (DMA), clocking and phase-
locked loop (PLL), and the power-down modes.
TMS320C62xx Programmer’s Guide (literature number SPRU198)
describes ways to optimize C and assembly code and includes applica-
tion program examples.
TMS320C62xx Technical Brief (literature number SPRU197) gives an
introduction to the ’C62xx digital signal processor, development tools,
and third-party support.

Related Documentation / Trademarks
viii
Related Documentation
Ifyouareanassemblylanguageprogrammerandwouldlikemoreinformation
about C or C expressions, you may find these books useful:
American National Standard for Information Systems—Programming
Language C X3.159-1989
, American National Standards Institute
(ANSI standard for C)
Programming in C, Kochan, Steve G., Hayden Book Company
The C Programming Language (second edition, 1988), by Brian W. Kernig-
hanandDennisM.Ritchie,publishedbyPrentice-Hall,EnglewoodCliffs,
New Jersey
Trademarks
OpenWindows,Solaris,andSunOSaretrademarksofSunMicrosystems,Inc.
UNIX is a registered trademark in the United States and other countries,
licensed exclusively through X/Open Company Limited.
X Window System is a trademark of the Massachusetts Institute of Technolo-
gy.

If You Need Assistance
ix Read This First
If You Need Assistance . . .
- World-Wide Web Sites
TI Online http://www.ti.com
Semiconductor Product Information Center (PIC) http://www.ti.com/sc/docs/pic/home.htm
DSP Solutions http://www.ti.com/dsps
320 Hotline On-line t http://www.ti.com/sc/docs/dsps/support.htm
- North America, South America, Central America
Product Information Center (PIC) [phone]
TI Literature Response Center U.S.A. [phone]
Software Registration/Upgrades [phone] Fax: [phone]
U.S.A. Factory Repair/Hardware Upgrades [phone]
U.S. Technical Training Organization [phone]
DSP Hotline [phone] Fax: [phone] Email: [email protected]
DSP Modem BBS [phone]
DSP Internet BBS via anonymous ftp to ftp://ftp.ti.com/mirrors/tms320bbs
- Europe, Middle East, Africa
European Product Information Center (EPIC) Hotlines:
Multi-Language Support [phone] Fax: [phone] Email: [email protected]
Deutsch [phone] or [phone]
English [phone]
Francais [phone]
Italiano [phone]
EPIC Modem BBS [phone]
European Factory Repair [phone]
Europe Customer Training Helpline Fax: [phone]
- Asia-Pacific
Literature Response Center [phone] Fax: [phone]
Hong Kong DSP Hotline [phone] Fax: [phone]
Korea DSP Hotline [phone] Fax: [phone]
Korea DSP Modem BBS [phone]
Singapore DSP Hotline Fax: [phone]
Taiwan DSP Hotline [phone] Fax: [phone]
Taiwan DSP Modem BBS [phone]
Taiwan DSP Internet BBS via anonymous ftp to ftp://dsp.ee.tit.edu.tw/pub/TI/
- Japan
Product Information Center +0120-81-0026 (in Japan) Fax: [phone] (in Japan)
+03-3457-0972 or (INTL) 813-3457-0972 Fax: [phone] or (INTL) 813-3457-1259
DSP Hotline [phone] or (INTL) 813-3769-8735 Fax: [phone] or (INTL) 813-3457-7071
DSP BBS via Nifty-Serve Type “Go TIASP”
- Documentation
Whenmakingsuggestions orreportingerrors indocumentation,please includethefollowing informationthatis onthetitle
page: the full title of the book, the publication date, and the literature number.
Mail: Texas Instruments Incorporated Email: [email protected]
Technical Documentation Services, MS 702
P.O. Box 1443
Houston, Texas 77251-1443
Note: When calling a Literature Response Center to order documentation, please specify the literature number of the
book.

x

Contents
xi
Contents
Part I: Hands-On Information
1 Overview of a Code Development and Debugging System 1-1. . . . . . . . . . . . . . . . . . . . . . . . . .
Discusses features of the debugger, describes additional software tools, and tells you how to
invoke the debugger.
1.1 Description of the C Source Debugger 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key features of the debugger 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Description of the Profiling Environment 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key features of the profiling environment 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3 Developing Code for the TMS320C6x 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.4 Preparing Your Program for Debugging 1-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.5 Invoking the Debugger 1-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting the screen size (–b, –bb options) 1-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clearing the .bss section (–c option) 1-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying the debugger on a different machine (–d option) 1-13. . . . . . . . . . . . . . . . . . . . .
Identifying additional directories (–i option) 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting the minimal debugging mode (–min option) 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . .
Entering the profiling environment (–profile option) 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loading the symbol table only (–s option) 1-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Identifying a new initialization file (–t option) 1-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loading without the symbol table (–v option) 1-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ignoring D_OPTIONS (–x option) 1-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.6 Exiting the Debugger 1-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.7 Debugging Your Programs 1-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 An Introductory Tutorial to the C Source Debugger 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
This chapter provides a step-by-step introduction to the debugger and its features.
How to use this tutorial 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A note about entering commands 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
An escape route (just in case) 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Invoke the debugger and load the sample program’s object code 2-3. . . . . . . . . . . . . . . . . . . . . . .
Take a look at the display 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What’s in the DISASSEMBLY window? 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Select the active window 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Resize the active window 2-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
xii
Zoom the active window 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Move the active window 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scroll through a window’s contents 2-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display the C source version of the sample file 2-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Execute some code 2-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Become familiar with the four debugging modes 2-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Open another text file, then redisplay a C source file 2-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Use the basic RUN command 2-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set some breakpoints 2-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Watch some values and single-step through code 2-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Run code conditionally 2-20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
WHATIS that? 2-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clear the COMMAND window display area 2-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display the contents of an aggregate data type 2-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Display data in another format 2-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change some values 2-28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Define a memory map 2-29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Define your own command string 2-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Close the debugger 2-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Part II: Debugger Description
3 The Debugger Display 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes the default displays, tells you how to switch between assembly language and C
debugging, describes the various types of windows on the display, and tells you how to move
and size the windows.
3.1 Debugging Modes and Default Displays 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Auto mode 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Assembly mode 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mixed mode 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Minimal mode 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions associated with debugging modes 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Descriptions of the Different Kinds of Windows and Their Contents 3-6. . . . . . . . . . . . . . . .
COMMAND window 3-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DISASSEMBLY window 3-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FILE window 3-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CALLS window 3-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PROFILE window 3-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MEMORY windows 3-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CPU window 3-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DISP windows 3-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
WATCH windows 3-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 Cursors 3-20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
xiii Contents
3.4 The Active Window 3-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Identifying the active window 3-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting the active window 3-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.5 Manipulating a Window 3-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Resizing a window 3-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Zooming a window 3-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Moving a window 3-27. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.6 Manipulating a Window’s Contents 3-29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scrolling through a window’s contents 3-29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing the data displayed in windows 3-31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.7 Closing a Window 3-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 Entering and Using Commands 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes the rules for entering commands from the command line, tells you how to use the
pulldown menus and dialog boxes (for entering parameter values), and describes general
information about entering commands from batch files.
4.1 Entering Commands From the Command Line 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Typing in and entering commands 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sometimes, you can’t type a command 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the command history 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Clearing the display area 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Recording information from the display area 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Using the Menu Bar and the Pulldown Menus 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pulldown menus in the profiling environment 4-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the pulldown menus 4-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Escaping from the pulldown menus 4-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using menu bar selections that don’t have pulldown menus 4-10. . . . . . . . . . . . . . . . . . . . .
4.3 Using Dialog Boxes 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Entering text in a dialog box 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.4 Entering Commands From a Batch File 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Echoing strings in a batch file 4-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling command execution in a batch file 4-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.5 Defining Your Own Command Strings 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5 Defining a Memory Map 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contains instructions for setting up a memory map that enables the debugger to correctly
access target memory and includes hints about using batch files.
5.1 The Memory Map: What It Is and Why You Must Define It 5-2. . . . . . . . . . . . . . . . . . . . . . . .
Defining the memory map in a batch file 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Potential memory map problems 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.2 A Sample Memory Map 5-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3 Identifying Usable Memory Ranges 5-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Memory mapping with the simulator 5-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.4 Enabling Memory Mapping 5-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.5 Checking the Memory Map 5-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.6 Modifying the Memory Map During a Debugging Session 5-10. . . . . . . . . . . . . . . . . . . . . . .
Returning to the original memory map 5-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
xiv
6 Loading, Displaying, and Running Code 6-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tells you how to use the three debugger modes to view the type of source files that you’d like
to see, how to load source files and object files, how to run your programs, and how to halt
program execution.
6.1 Code-Display Windows: Viewing Assembly Language Code, C Code, or Both 6-2. . . . . .
Selecting a debugging mode 6-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2 Displaying Your Source Programs (or Other Text Files) 6-4. . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying assembly language code 6-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying C code 6-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying other text files 6-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3 Loading Object Code 6-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loading code while invoking the debugger 6-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loading code after invoking the debugger 6-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4 Where the Debugger Looks for Source Files 6-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.5 Running Your Programs 6-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining the starting point for program execution 6-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running code 6-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Single-stepping through code 6-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running code while disconnected from the target system 6-14. . . . . . . . . . . . . . . . . . . . . . .
Running code conditionally 6-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.6 Halting Program Execution 6-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7 Managing Data 7-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes the data-display windows and tells you how to edit data (memory contents, register
contents, and individual variables).
7.1 Where Data Is Displayed 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2 Basic Commands for Managing Data 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3 Basic Methods for Changing Data Values 7-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing data displayed in a window 7-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Advanced “editing”—using expressions with side effects 7-5. . . . . . . . . . . . . . . . . . . . . . . . .
7.4 Managing Data in Memory 7-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying memory contents 7-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying memory contents while you’re debugging C 7-8. . . . . . . . . . . . . . . . . . . . . . . . . .
Saving memory values to a file 7-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Filling a block of memory 7-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.5 Managing Register Data 7-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying register contents 7-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.6 Managing Data in a DISP (Display) Window 7-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying data in a DISP window 7-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Closing a DISP window 7-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.7 Managing Data in a WATCH Window 7-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying data in the WATCH window 7-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deleting watched values and closing the WATCH window 7-16. . . . . . . . . . . . . . . . . . . . . . .
7.8 Displaying Data in Alternative Formats 7-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the default format for specific data types 7-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the default format with ?, MEM, DISP, and WA 7-19. . . . . . . . . . . . . . . . . . . . . . .

Contents
xv Contents
8 Using Software Breakpoints 8-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes the use of software breakpoints to halt code execution.
8.1 Setting a Software Breakpoint 8-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2 Clearing a Software Breakpoint 8-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3 Finding the Software Breakpoints That Are Set 8-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9 Customizing the Debugger Display 9-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contains information about the commands that you can use for customizing the display and
identifies the display areas that you can modify.
9.1 Changing the Colors of the Debugger Display 9-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: common display areas 9-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: window borders 9-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: COMMAND window 9-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: DISASSEMBLY and FILE windows 9-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: data-display windows 9-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Area names: menu bar and pulldown menus 9-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2 Changing the Border Styles of the Windows 9-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3 Saving and Using Custom Displays 9-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the default display for monochrome monitors 9-9. . . . . . . . . . . . . . . . . . . . . . . . . .
Saving a custom display 9-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Loading a custom display 9-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Invoking the debugger with a custom display 9-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Returning to the default display 9-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.4 Changing the Prompt 9-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10 Profiling Code Execution 10-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describestheprofilingenvironmentandtellsyouhowtocollectstatisticsaboutcodeexecution.
10.1 An Overview of the Profiling Process 10-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A profiling strategy 10-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.2 Entering the Profiling Environment 10-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions of the profiling environment 10-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using pulldown menus in the profiling environment 10-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.3 Defining Areas for Profiling 10-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Marking an area 10-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Disabling an area 10-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reenabling a disabled area 10-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unmarking an area 10-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions on profiling areas 10-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.4 Defining a Stopping Point 10-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.5 Running a Profiling Session 10-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.6 Viewing Profile Data 10-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing different profile data 10-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data accuracy 10-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sorting profile data 10-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing different profile areas 10-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interpreting session data 10-20. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing code associated with a profile area 10-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10.7 Saving Profile Data to a File 10-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
xvi
Part III: Reference Material
11 Summary of Commands and Special Keys 11-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides a functional summary of the debugger commands, profiling commands, and function
keys; also provides a complete alphabetical summary of all commands.
11.1 Functional Summary of Debugger Commands 11-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing modes 11-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Managing windows 11-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying and changing data 11-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Performing system tasks 11-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Managing breakpoints 11-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying files and loading programs 11-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing the screen 11-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Memory mapping 11-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running programs 11-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Profiling commands 11-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.2 How the Menu Selections Correspond to Commands 11-8. . . . . . . . . . . . . . . . . . . . . . . . . . .
Program-execution commands 11-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File/load commands 11-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Breakpoint commands 11-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Watch commands 11-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Memory commands 11-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Screen-configuration commands 11-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mode commands 11-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.3 Alphabetical Summary of Debugger Commands 11-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.4 Summary of Profiling Commands 11-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11.5 Summary of Special Keys 11-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing text on the command line 11-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the command history 11-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Switching modes 11-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Halting or escaping from an action 11-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying pulldown menus 11-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running code 11-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting or closing a window 11-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Moving or sizing a window 11-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scrolling a window’s contents 11-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing data or selecting the active field 11-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12 Basic Information About C Expressions 12-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Manyofthe debugger commands accept C expressions asparameters. This chapter provides
general information about the rules governing C expressions and describes specific
implementation features related to using C expressions as command parameters.
12.1 C Expressions for Assembly Language Programmers 12-2. . . . . . . . . . . . . . . . . . . . . . . . . .
12.2 Using Expression Analysis in the Debugger 12-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Restrictions 12-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Additional features 12-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
xvii Contents
A What the Debugger Does During Invocation A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
In some circumstances, you may find it helpful to know the steps that the debugger goes
through during the invocation process; this appendix lists these steps.
B Debugger Messages B-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes progress and error messages that the debugger may display.
B.1 Associating Sound With Error Messages B-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.2 Alphabetical Summary of Debugger Messages B-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.3 Additional Instructions for Expression Errors B-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C Glossary C-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defines acronyms and key terms used in this book.

Figures
xviii
Figures
1–1 The Basic Debugger Display 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1–2 The Profiling-Environment Display 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1–3 TMS320C6x Software Development Flow 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1–4 Steps You Go Through to Prepare a Program 1-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3–1 Typical Assembly Display (for Auto Mode and Assembly Mode) 3-3. . . . . . . . . . . . . . . . . . . . .
3–2 Typical C Display (for Auto Mode Only) 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3–3 Typical Mixed Display (for Mixed Mode Only) 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3–4 Default and Additional MEMORY Windows 3-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3–5 Default Appearance of an Active and an Inactive Window 3-21. . . . . . . . . . . . . . . . . . . . . . . . .
4–1 The COMMAND Window 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–2 The Menu Bar in the Basic Debugger Display 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–3 All of the Pulldown Menus (Basic Debugger Display) 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5–1 Sample Memory Map for Use With a TMS320C6x Simulator 5-4. . . . . . . . . . . . . . . . . . . . . . . .
10–1 An Example of the PROFILE Window 10-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Tables
xix Contents
Tables
1–1 Summary of Debugger Options 1-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–1 Predefined Constants for Use With Conditional Commands 4-15. . . . . . . . . . . . . . . . . . . . . . . .
7–1 Display Formats for Debugger Data 7-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7–2 Data Types for Displaying Debugger Data 7-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9–1 Colors and Other Attributes for the COLOR and SCOLOR Commands 9-2. . . . . . . . . . . . . . .
9–2 Summary of Area Names for the COLOR and SCOLOR Commands 9-3. . . . . . . . . . . . . . . . .
10–1 Debugger Commands That Can/Can’t Be Used in the Profiling Environment 10-3. . . . . . . .
10–2 Menu Selections for Marking Areas 10-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–3 Menu Selections for Disabling Areas 10-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–4 Menu Selections for Enabling Areas 10-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–5 Menu Selections for Unmarking Areas 10-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–6 Types of Data Shown in the PROFILE Window 10-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–7 Menu Selections for Displaying Areas in the PROFILE Window 10-20. . . . . . . . . . . . . . . . . . .
11–1 Marking Areas 11-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11–2 Disabling Marked Areas 11-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11–3 Enabling Disabled Areas 11-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11–4 Unmarking Areas 11-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11–5 Changing the PROFILE Window Display 11-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xx