!TMS320C6000 Code Composer Studio Tutorial

PrintedonRecycledPaperTMS320C6000CodeComposerStudioTutorialLiteratureNumber:SPRU301CFebruary2000IMPORTANTNOTICETexasInstrumentsanditssubsidiaries(TI)reservestherighttomakechangestotheirproductsortodiscontinueanyproductorservicewithoutnotice,andadvisescustomerstoobtainthelatestversionofrelevantinformationtoverify,beforeplacingorders,thattheinformationbeingreliedoniscurrentandcomplete.Allproductsaresoldsubjecttothetermsandconditionsofsaleatthetimeoforderacknowledgment,includingthosepertainingtowarranty,patentinfringement,andlimitationofliability.TIwarrantsperformanceofitssemiconductorproductstothespecificationsapplicableatthetimeofsaleinaccordancewithTI’sstandardwarranty.TestingandotherqualitycontroltechniquesareutilizedtotheextentTIdeemsnecessarytosupportthiswarranty.Specifictestingofallparametersofeachdeviceisnotnecessarilyperformed,exceptthosemandatedbygovernmentrequirements.CERTAINAPPLICATIONSUSINGSEMICONDUCTORPRODUCTSMAYINVOLVEPOTENTIALRISKSOFDEATH,PERSONALINJURY,ORSEVEREPROPERTYORENVIRONMENTALDAMAGE(“CRITICALAPPLICATIONS”).TISEMICONDUCTORPRODUCTSARENOTDESIGNED,AUTHORIZED,ORWARRANTEDTOBESUITABLEFORUSEINLIFE-SUPPORTDEVICESORSYSTEMSOROTHERCRITICALAPPLICATIONS.INCLUSIONOFTIPRODUCTSINSUCHAPPLICATIONSISUNDERSTOODTOBEFULLYATTHECUSTOMER’SRISK.Inordertominimizerisksassociatedwiththecustomer’sapplications,adequatedesignandoperatingsafeguardsmustbeprovidedbythecustomertominimizeinherentorproceduralhazards.TIassumesnoliabilityforapplicationsassistanceorcustomerproductdesign.TIdoesnotwarrantorrepresentthatanylicense,eitherexpressorimplied,isgrantedunderanypatentright,copyright,maskworkright,orotherintellectualpropertyrightofTIcoveringorrelatingtoanycombination,machine,orprocessinwhichsuchsemiconductorproductsorservicesmightbeorareused.TI’spublicationofinformationregardinganythirdparty’sproductsorservicesdoesnotconstituteTI’sapproval,warrantyorendorsementthereof.Copyright©2000,TexasInstrumentsIncorporatediiiThisisadraftversionprintedfromfile:tut_pref.fmon2/26/0PrefaceReadThisFirstAboutThisManualCodeComposerStudiospeedsandenhancesthedevelopmentprocessforprogrammerswhocreateandtestreal-time,embeddedsignalprocessingapplications.CodeComposerStudioextendsthecapabilitiesoftheCodeComposerIntegratedDevelopmentEnvironment(IDE)toincludefullawarenessoftheDSPtargetbythehostandreal-timeanalysistools.ThistutorialassumesthatyouhaveCodeComposerStudio,whichincludestheTMS320C6000codegenerationtoolsalongwiththeAPIsandplug-insforbothDSP/BIOSandRTDX.ThismanualalsoassumesthatyouhaveinstalledatargetboardinyourPCcontainingtheDSPdevice.IfyouonlyhaveCodeComposerStudioSimulatorandthecodegenerationtools,butnotthecompleteCodeComposerStudio,youcanperformthestepsinChapter2andChapter4.IfyouareusingtheDSPsimulatorinsteadofaboard,youarealsolimitedtoperformingthestepsinChapter2andChapter4.ThistutorialintroducesyoutosomeofthekeyfeaturesofCodeComposerStudio.Theintentionisnottoprovideanexhaustivedescriptionofeveryfeature.Instead,theobjectiveistoprepareyoutobeginDSPdevelopmentwithCodeComposerStudio.ivNotationalConventionsNotationalConventionsThisdocumentusesthefollowingconventions:❏TheTMS320C6000coreisalsoreferredtoas’C6000.❏CodeComposerStudiogeneratesfileswithextensionsof.s62and.h62.ThesefilescanalsobeusedwithboththeTMS320C6201andtheTMS320C6701.DSP/BIOSdoesnotusethefloating-pointinstructionsthataresupportedbytheTMS320C6701.❏Programlistings,programexamples,andinteractivedisplaysareshowninaspecialtypeface.Examplesuseaboldversionofthespecialtypefaceforemphasis;interactivedisplaysuseaboldversionofthespecialtypefacetodistinguishcommandsthatyouenterfromitemsthatthesystemdisplays(suchasprompts,commandoutput,errormessages,etc.).Hereisasampleprogramlisting:Voidcopy(HST_Obj*input,HST_Obj*output){PIP_Obj*in,*out;Uns*src,*dst;Unssize;❏Insyntaxdescriptions,theinstruction,command,ordirectiveisinaboldtypefaceandparametersareinanitalictypeface.Portionsofasyntaxthatareinboldshouldbeenteredasshown;portionsofasyntaxthatareinitalicsdescribethetypeofinformationthatshouldbeentered.Syntaxthatisenteredonacommandlineiscentered.Syntaxthatisusedinatextfileisleft-justified.❏Squarebrackets([])identifyanoptionalparameter.Ifyouuseanoptionalparameter,youspecifytheinformationwithinthebrackets.Unlessthesquarebracketsareinaboldtypeface,donotenterthebracketsthemselves.ReadThisFirstvRelatedDocumentationfromTexasInstrumentsRelatedDocumentationfromTexasInstrumentsThefollowingbooksdescribethedevices,relatedsupporttools,andCodeComposerStudio.MostofthesedocumentsareavailableinAdobeAcrobatformatafteryouinstallCodeComposerStudio.Toopenadocument,fromtheWindowsStartmenu,choosePrograms-CodeComposerStudio’C6000-Documentation.Toobtainaprintedcopyofanyofthesedocuments,calltheTexasInstrumentsLiteratureResponseCenterat(800)477-8924.Whenordering,pleaseidentifythebookbyitstitleandliteraturenumber.CodeComposerStudioUser’sGuide(literaturenumberSPRU328)explainshowtousetheCodeComposerStudiodevelopmentenvironmenttobuildanddebugembeddedreal-timeDSPapplications.TMS320C6000DSP/BIOSUser’sGuide(literaturenumberSPRU