Code Composer Studio User's Guide

1 Printed on Recycled PaperCode Composer StudioUser s GuideLiterature Number: SPRU328 BFebruary 2000 IMPORTANT NOTICET exas 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 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 APPLICATIONS USING SEMICONDUCTOR PRODUCTS MAY INVOLVE POTENTIALRISKS OF DEATH, PERSONAL INJURY, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE( CRITICAL APPLICATIONS ).

2 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 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 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 1999-2000, texas instruments IncorporatediiiThis is a draft version printed from file: on 1/14/00 PrefaceRead This FirstAbout This ManualThis book explains how to use the Code Composer Studio developmentenvironment to build and debug embedded real-time software ConventionsThis document uses the following conventions:oProgram listings, program examples, and interactive displays are shownin aspecial typeface.

3 Examples use abold versionof the specialtypeface for emphasis; interactive displays use abold versionof 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 < >main(){ printf("hello, world\n");}oIn syntax descriptions, the instruction, command, or directive is in aboldtypefaceand parameters are in anitalic 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 brackets ( [ and ] ) identify an optional parameter. If you use anoptional parameter, you specify the information within the the square brackets are in aboldtypeface, do not enter thebrackets Related Documentation From texas InstrumentsRelated Documentation From texas InstrumentsFor additional information on your target processor and related support tools,seeRelated Documentation in Code Composer Studio s online DocumentationYou can use the following books to supplement this User's Guide :American National Standard for Information Systems-ProgrammingLanguage C , American National Standards Institute (ANSI standard for C)The C Programming Language (second edition), by Brian W.

4 Kernighanand Dennis M. Ritchie, published by Prentice-Hall, Englewood Cliffs, NewJersey, 1988 Programming in C, Kochan, Steve G., Hayden Book CompanyTrademarksCode Composer Studio , DSP/BIOS, Probe Point(s), and RTDX aretrademarks of texas instruments is a registered trademark of Intel and Windows NT are registered trademarks of 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 : texas instruments IncorporatedTechnical Documentation Services, MS Box 1443 Houston, texas is a draft version printed from file: on 1/14/00 Contents1 Setting Up Code Composer Studio .. Requirements .. Code Composer Studio .. Up Code Composer Studio .. Started with Code Composer Studio .

5 Online Help..1-42 The Basics of Code Composer Studio .. Code Composer Studio Windows and Toolbars .. Menus .. the Dis-Assembly Window .. More Than One Dis-Assembly Window .. the Start Address .. Breakpoints, Probe Points, and Profile Points from theDis-Assembly Window .. Color Highlights .. Dis-Assembly Style Options .. Mixed C Source and Assembly Code .. the Memory Window.. Memory Window Options .. a Memory Location .. Expression Input Fields .. Registers .. Registers.. Registers .. a COFF File .. Symbol Information Only .. a COFF File.. Program Load Options .. Stepping .. Stepping Operations .. , Halt, Animate, Run Free .. Animation Speed .. Your Target Processor .. Data Values .. Memory Locations ..2-19vi Variables .. the Command Line .. Windows .. the Call Stack .. Local Variables .. and Restoring Your Workspace .. Loading Your Workspace .. Default Workspace .. 2-243 Multiprocessing With Code Composer Studio .

6 Parallel Debug Manager .. an Individual Parent Window .. Processors .. Broadcast Commands .. GEL Commands .. GEL Functions .. Breakpoints .. 3-94 Breakpoints and Probe Points .. Notes (Kernel-Based Code Composer Studio Debugger) .. and Deleting Breakpoints .. and Disabling Breakpoints .. Breakpoints .. Breakpoints.. Points .. and Deleting Probe Points .. Probe Points .. and Disabling Probe Points .. Probe Points.. Probe Points .. 4-135 Using the File Input/Output Capabilities .. Input/Output .. I/O Controls .. File Formats .. a Data File .. a Data File .. 5-7 ContentsviiContents6 The Graph Window .. How the Time/Frequency Graph Works .. Type.. Title .. Page .. Address .. Buffer Size .. Data Size .. Data Type .. Rate (Hz) .. Data From .. Data Display .. Peak and Hold .. Value .. Display.. Bar Display .. Display Scale .. Plot Style .. Style .. Mode.. Diagram.

7 The Constellation Diagram Works.. Type.. Title .. Data Sources .. Page .. Buffer Size .. Increment .. Points .. Data Type .. X-Value .. X-Value .. Y-Value .. Y-Value .. Size .. Display.. Bar Display .. Style .. Mode..6-24viii Diagram .. the Eye Diagram Works .. Type .. Title .. Source .. Page .. Buffer Size .. Increment .. Size .. Length .. Interval Between Triggers .. (in samples) .. Data Type .. Rate .. Level .. Y-Value.. Display .. Display Unit .. Bar Display .. Style .. Mode .. the Image Graph Works .. Title .. Space Operations .. Page .. Per Display .. Per Line .. Packing to Fill 32 Bits .. Origin .. Quantization to 256 Colors .. Bar Display .. Mode .. 6-387 The Memory Map .. Memory Maps .. the Memory Map .. GEL to Define Your Memory Map .. 7-58 Using the Watch Window .. and Deleting Expressions in the Watch Window .. and Collapsing Watch Variables.

8 Variables in the Watch Window .. Window Display Formats .. Watch .. 8-6 ContentsixContents9 The Integrated Editor .. of Features .. Toolbar .. Toolbar .. Shortcuts .. Keyboard Shortcuts .. Manipulation .. a New File .. a File .. File Views .. Files .. Files.. , Copying, and Pasting Text .. Text .. Columns .. Actions .. Multiple Lines .. To Source Line .. Fonts .. and Replacing Text .. Text in the Current File .. Find/Replace Properties.. and Replacing Text .. Text in Multiple Files .. Editor Properties.. Bookmarks .. Your Bookmarks .. Bookmark Properties ..9-2010 The Project Environment .. , Opening, and Closing Projects .. the Project View Window .. the Project View Context Menus .. Capabilities (Windows 95/98/NT) .. Files to the Project .. Extensions .. Dependencies.. Build Options .. Your Progam..10-10x Contents11 Profiling Code Execution .. Clock .. Clock Setup.

9 Clock Accuracy .. Points .. and Disabling Profile Points .. Profile Points .. Statistics .. And Conquer Using Profile Points .. 11-1212 The General Extension Language (GEL) .. Grammar .. Function Definition .. Function Parameters.. GEL Functions and Statements .. Return Statement .. If-Else Statement .. While Statement .. Comments .. Preprocessing Statements .. GEL Functions .. GEL Functions to the GEL Menu Using Keywords .. hotmenu Keyword .. dialog Keyword .. slider Keyword .. the Output Window .. GEL Functions Upon Startup .. the Expression Queue .. Built-In GEL Functions .. 12-19A Frequently Asked Questions .. Code Composer Studio .. Project Management System .. Debugging .. Window .. Extension Language GEL .. Window .. A-12B Glossary.. B-11-1 Chapter 1 Setting Up Code Composer StudioThis chapter describes how to install and set up Code Composer Studio onyour System Requirements.

10 1 Installing Code Composer Studio .. 1 Setting Up Code Composer Studio .. 1 Getting Started with Code Composer Studio .. 1 Using Online Help .. 1 4 TopicPageSystem RequirementsTo use Code Composer Studio , your operating platform must meet thefollowing minimum requirements:oIBM PC (or compatible)oMicrosoft Windows 95, Windows 98, or Windows NT Mbytes RAM, 100 Mbytes of hard disk space, Pentium processor,SVGA display (800x600)Installing Code Composer StudioSetting Up Code Composer Code Composer StudioThe complete installation process consists of two phases:1) Install the Code Composer Studio software onto your ) Run the Code Composer Studio Setup application to configure theinterface that enables Code Composer Studio to communicate with yourtarget board or rest of this section describes how to install the software onto yoursystem. Section ,Setting Up Code Composer Studio , describes how torun the Code Composer Studio Setup Code Composer Studio for Windows 95/98/NTUse the following procedure to install Code Composer Studio for Windows95/98/NT:1) While in Windows, insert the installation CD into the CD-ROM ) In Windows Explorer, switch to the CD-ROM drive and run Youmust install Code Composer Studio using administrator privileges forWindows installation creates CCStudio and Setup CCStudio program icons onthe Up Code Composer StudioCode Composer Studio Setup establishes the interface that allows CodeComposer Studio to communicate with your target board or simulator.