Tags:

Transcription

Code Composer StudioUser’s GuideLiterature Number: SPRU328BFebruary 2000Printed on Recycled Paper

IMPORTANT NOTICETexas Instruments and its subsidiaries (TI) reserve the right to make changes to their products or todiscontinue any product or service without notice, and advise customers to obtain the latest version ofrelevant information to verify, before placing orders, that the information being relied on is current andcomplete. All products are sold subject to the terms and conditions of sale supplied at the time of orderacknowledgment, including those pertaining to warranty, patent infringement, and limitation of liability.TI warrants performance of its semiconductor products to the specifications applicable at the time ofsale in accordance with TI’s standard warranty. Testing and other quality control techniques are utilizedto the extent TI deems necessary to support this warranty. Specific testing of all parameters of eachdevice is not necessarily performed, except those mandated by government requirements.CERTAIN APPLICATIONS USING SEMICONDUCTOR PRODUCTS MAY INVOLVE POTENTIALRISKS OF DEATH, PERSONAL INJURY, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE(“CRITICAL APPLICATIONS”). TI SEMICONDUCTOR PRODUCTS ARE NOT DESIGNED,AUTHORIZED, OR WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORT DEVICES ORSYSTEMS OR OTHER CRITICAL APPLICATIONS. INCLUSION OF TI PRODUCTS IN SUCHAPPLICATIONS IS UNDERSTOOD TO BE FULLY AT THE CUSTOMER’S RISK.In order to minimize risks associated with the customer’s applications, adequate design and operatingsafeguards must be provided by the customer to minimize inherent or procedural hazards.TI assumes no liability for applications assistance or customer product design. TI does not warrant orrepresent that any license, either express or implied, is granted under any patent right, copyright, maskwork right, or other intellectual property right of TI covering or relating to any combination, machine, orprocess in which such semiconductor products or services might be or are used. TI’s publication ofinformation regarding any third party’s products or services does not constitute TI’s approval, warrantyor endorsement thereof.Copyright 1999-2000, Texas Instruments Incorporated

This is a draft version printed from file: preface.fm on 1/14/00PrefaceRead This FirstAbout This ManualThis book explains how to use the Code Composer Studio developmentenvironment to build and debug embedded real-time software applications.Notational ConventionsThis document uses the following conventions: Program listings, program examples, and interactive displays are shownin a special typeface. Examples use a bold version of the specialtypeface for emphasis; interactive displays use a bold version of thespecial typeface to distinguish commands that you enter from items thatthe system displays (such as prompts, command output, error messages,etc.).Here is a sample of C code:#include stdio.h main(){printf("hello, world\n");} In syntax descriptions, the instruction, command, or directive is in a boldtypeface and parameters are in an italic typeface. Portions of a syntaxthat are in bold should be entered as shown; portions of a syntax that arein italics describe the type of information that should be entered. Syntaxthat is entered on a command line is centered. Syntax that is used in atext file is left-justified. Square brackets ( [ and ] ) identify an optional parameter. If you use anoptional parameter, you specify the information within the brackets.Unless the square brackets are in a bold typeface, do not enter thebrackets themselves.iii

Related Documentation From Texas InstrumentsRelated Documentation From Texas InstrumentsFor additional information on your target processor and related support tools,see Related Documentation in Code Composer Studio’s online help.Related DocumentationYou can use the following books to supplement this user's guide:American National Standard for Information Systems-ProgrammingLanguage C X3.159-1989, American National Standards Institute (ANSIstandard for C)The C Programming Language (second edition), by Brian W. Kernighanand Dennis M. Ritchie, published by Prentice-Hall, Englewood Cliffs, NewJersey, 1988Programming in C, Kochan, Steve G., Hayden Book CompanyTrademarksCode Composer Studio, DSP/BIOS, Probe Point(s), and RTDX aretrademarks of Texas Instruments Incorporated.Pentium is a registered trademark of Intel Corporation.Windows and Windows NT are registered trademarks of MicrosoftCorporation.To Help Us Improve Our Documentation . . .If you would like to make suggestions or report errors in documentation,please send us mail or email. Be sure to include the following information thatis on the title page: the full title of the book, the publication date, and theliterature number.ivMail:Texas Instruments IncorporatedTechnical Documentation Services, MS 702P.O. Box 1443Houston, Texas 77251-1443Email:[email protected]

This is a draft version printed from file: cctoc.doc on 1/14/00Contents1Setting Up Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-11.1System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21.2Installing Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.3Setting Up Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.4Getting Started with Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-41.5Using Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-42The Basics of Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-12.1Using Code Composer Studio Windows and Toolbars . . . . . . . . . . . . . . . . . . . . . . . . .2-22.1.1Context-Sensitive Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-22.2Using the Dis-Assembly Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-32.2.1Opening More Than One Dis-Assembly Window . . . . . . . . . . . . . . . . . . . . . .2-32.2.2Changing the Start Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-32.2.3Managing Breakpoints, Probe Points, and Profile Points from theDis-Assembly Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-42.2.4Changing Color Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-42.2.5Setting Dis-Assembly Style Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-42.2.6Viewing Mixed C Source and Assembly Code . . . . . . . . . . . . . . . . . . . . . . . .2-52.3Using the Memory Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-62.3.1Setting Memory Window Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-72.3.2Editing a Memory Location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-92.3.3C Expression Input Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-92.4CPU Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-112.4.1Viewing Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-112.4.2Editing Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-112.5Loading a COFF File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-122.5.1Loading Symbol Information Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-122.5.2Reloading a COFF File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-122.5.3Setting Program Load Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-132.6Single Stepping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-142.6.1Multiple Stepping Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-152.7Run, Halt, Animate, Run Free . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-162.7.1Setting Animation Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-172.8Resetting Your Target Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-182.9Copying Data Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-182.10 Filling Memory Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-19v

Contents2.112.122.132.142.15Editing Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Editing the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Refreshing Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Viewing the Call Stack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.14.1Observing Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Saving and Restoring Your Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.15.1Automatically Loading Your Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . .2.15.2The Default Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-192-202-212-212-212-222-242-243Multiprocessing With Code Composer Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.1The Parallel Debug Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.2Opening an Individual Parent Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.3Grouping Processors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.4Multiprocessor Broadcast Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.5Broadcasting GEL Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.6Auto-Executing GEL Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3.7Global Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Breakpoints and Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14.1Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.1Designer Notes (Kernel-Based Code Composer Studio Debugger) . . . . . . . 4-24.1.2Adding and Deleting Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.1.3Enabling and Disabling Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44.2Conditional Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64.3Hardware Breakpoints. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74.4Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84.4.1Adding and Deleting Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-84.4.2Connecting Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-94.4.3Enabling and Disabling Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-104.5Conditional Probe Points. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-124.6Hardware Probe Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-135Using the File Input/Output Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1File Input/Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.1File I/O Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.2Data File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2Loading a Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.3Storing a Data File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vi3-13-23-23-33-53-63-73-95-15-25-55-55-75-7

Contents6The Graph Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-16.1Time/Frequency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-26.1.1How the Time/Frequency Graph Works . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-26.1.2Display Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-36.1.3Graph Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-136.1.4Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-136.1.5Start Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-136.1.6Acquisition Buffer Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-146.1.7Display Data Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-146.1.8DSP Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-156.1.9Q-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-156.1.10Sampling Rate (Hz) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-156.1.11Plot Data From . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-166.1.12Left-Shifted Data Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-166.1.13Display Peak and Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-166.1.14Autoscale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-176.1.15DC Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-176.1.16Axes Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-176.1.17Status Bar Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-176.1.18Magnitude Display Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-176.1.19Data Plot Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-186.1.20Grid Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-186.1.21Cursor Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-186.2Constellation Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-196.2.1How the Constellation Diagram Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-196.2.2Display Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-206.2.3Graph Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-206.2.4Interleaved Data Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-206.2.5Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-216.2.6Acquisition Buffer Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-216.2.7Index Increment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-226.2.8Constellation Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-226.2.9DSP Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-226.2.10Q-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.11Minimum X-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.12Maximum X-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.13Minimum Y-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.14Maximum Y-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.15Symbol Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.16Axes Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-236.2.17Status Bar Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-246.2.18Grid Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-246.2.19Cursor Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-24Contentsvii

Contents6.36.4Eye Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.1How the Eye Diagram Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.2Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.3Graph Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.4Trigger Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.5Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.6Acquisition Buffer Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.7Index Increment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.8Persistence Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.9Display Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.10Minimum Interval Between Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.11Pre-Trigger (in samples) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.12DSP Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.13Q-Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.14Sampling Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.15Trigger Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.16Maximum Y-Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.17Axes Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.18Time Display Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.19Status Bar Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.20Grid Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.21Cursor Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.1How the Image Graph Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.2Graph Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.3Color Space Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.4Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.5Lines Per Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.6Pixels Per Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.7Byte Packing to Fill 32 Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.8Image Origin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.9Uniform Quantization to 256 Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.10Status Bar Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4.11Cursor Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46-346-366-376-376-376-376-386-386-387The Memory Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.1Accessing Memory Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.2Defining the Memory Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7.3Using GEL to Define Your Memory Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-17-27-37-58Using the Watch Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.1Adding and Deleting Expressions in the Watch Window . . . . . . . . . . . . . . . . . . . . . . .8.1.1Expanding and Collapsing Watch Variables . . . . . . . . . . . . . . . . . . . . . . . . .8.2Editing Variables in the Watch Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.3Watch Window Display Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8.4Quick Watch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-18-28-38-48-58-6viii

Contents9The Integrated Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-19.1Overview of Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-29.1.1Standard Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-39.1.2Edit Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-49.2Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-59.2.1Customizing Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-89.3File Manipulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-99.3.1Creating a New File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-99.3.2Opening a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-109.3.3Duplicating File Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-109.3.4Saving Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-109.3.5Printing Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-119.3.6Cutting, Copying, and Pasting Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-129.3.7Deleting Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-129.3.8Editing Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-129.3.9Undo/Redo Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-139.3.10Tabbing Multiple Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-139.3.11Go To Source Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-139.3.12Changing Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-149.4Finding and Replacing Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-159.4.1Finding Text in the Current File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-159.4.2Setting Find/Replace Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-169.4.3Finding and Replacing Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-169.4.4Finding Text in Multiple Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-179.5Setting Editor Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-189.6Using Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-199.6.1Managing Your Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-209.6.2Editing Bookmark Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2010 The Project Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-110.1 Creating, Opening, and Closing Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-210.2 Using the Project View Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-310.2.1Using the Project View Context Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-410.2.2Drag-and-Drop Capabilities (Windows 95/98/NT) . . . . . . . . . . . . . . . . . . . .10-410.3 Adding Files to the Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-510.3.1File Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-610.4 Scanning Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-710.5 Setting Build Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-910.6 Building Your Progam. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-10Contentsix

Contents11 Profiling Code Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-111.1 Profile Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.1.1Profile Clock Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-311.1.2Profile Clock Accuracy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.2 Profile Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-611.2.1Enabling and Disabling Profile Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-711.3 Hardware Profile Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-911.4 Viewing Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1011.5 Divide And Conquer Using Profile Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-1212 The General Extension Language (GEL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-112.1 GEL Grammar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-212.2 GEL Function Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-312.3 GEL Function Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-512.4 Calling GEL Functions and Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-712.4.1GEL Return Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-712.4.2GEL If-Else Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-712.4.3GEL While Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-812.4.4GEL Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-812.4

IMPORTANT NOTICE Texas Instruments and its subsidiaries (TI) reserve the right to make changes to their products or to discontinue any product or service without not