[spru424c]TMS320 DSP Algorithm Standard Developer’

TMS320DSPAlgorithmStandardDeveloper’sGuideLiteratureNumber:SPRU424COctober2002PrintedonRecycledPaperIMPORTANTNOTICETexasInstrumentsIncorporatedanditssubsidiaries(TI)reservetherighttomakecorrections,modifications,enhancements,improvements,andotherchangestoitsproductsandservicesatanytimeandtodiscontinueanyproductorservicewithoutnotice.Customersshouldobtainthelatestrelevantinformationbeforeplacingordersandshouldverifythatsuchinformationiscurrentandcomplete.AllproductsaresoldsubjecttoTI’stermsandconditionsofsalesuppliedatthetimeoforderacknowledgment.TIwarrantsperformanceofitshardwareproductstothespecificationsapplicableatthetimeofsaleinaccordancewithTI’sstandardwarranty.TestingandotherqualitycontroltechniquesareusedtotheextentTIdeemsnecessarytosupportthiswarranty.Exceptwheremandatedbygovernmentrequirements,testingofallparametersofeachproductisnotnecessarilyperformed.TIassumesnoliabilityforapplicationsassistanceorcustomerproductdesign.CustomersareresponsiblefortheirproductsandapplicationsusingTIcomponents.Tominimizetherisksassociatedwithcustomerproductsandapplications,customersshouldprovideadequatedesignandoperatingsafeguards.TIdoesnotwarrantorrepresentthatanylicense,eitherexpressorimplied,isgrantedunderanyTIpatentright,copyright,maskworkright,orotherTIintellectualpropertyrightrelatingtoanycombination,machine,orprocessinwhichTIproductsorservicesareused.InformationpublishedbyTIregardingthirdpartyproductsorservicesdoesnotconstitutealicensefromTItousesuchproductsorservicesorawarrantyorendorsementthereof.Useofsuchinformationmayrequirealicensefromathirdpartyunderthepatentsorotherintellectualpropertyofthatthirdparty,oralicensefromTIunderthepatentsorotherintellectualpropertyofTI.ReproductionofinformationinTIdatabooksordatasheetsispermissibleonlyifreproductioniswithoutalterationandisaccompaniedbyallassociatedwarranties,conditions,limitations,andnotices.Reproductionofthisinformationwithalterationisanunfairanddeceptivebusinesspractice.TIisnotresponsibleorliableforsuchaltereddocumentation.ResaleofTIproductsorserviceswithstatementsdifferentfromorbeyondtheparametersstatedbyTIforthatproductorservicevoidsallexpressandanyimpliedwarrantiesfortheassociatedTIproductorserviceandisanunfairanddeceptivebusinesspractice.TIisnotresponsibleorliableforanysuchstatements.MailingAddress:TexasInstrumentsPostOfficeBox655303Dallas,Texas75265Copyright2002,TexasInstrumentsIncorporatediiiReadThisFirstPrefaceReadThisFirstAboutThisManualThisdocumentisintendedforDSPalgorithmproducerswhowanttotakeanexistingalgorithmsoftwaremoduleandmakeitcomplianttotheTMS320DSPAlgorithmStandard(referredtoasXDAISthroughouttherestofthisdocu-ment).Theproceduresoutlinedwillshowthealgorithmproducerhowtopre-pareand/orreworktheexistingalgorithm,createthestandardinterfacefilesrequiredforcomplianceusingaCodeComposerStudioplug-intool,andthenrunthefinaldeliverablesthroughanotherpre-complianceCodeCompos-erStudioplug-intoolforimmediatefeedback.DSPsystemintegratorsorXDAISconsumersshouldnotfollowtheproce-duresoutlinedinthisdocument,asitonlyappliestoproducersofalgorithmsoftwarecomponents.XDAISconsumersshouldrefertotheapplicationnote,AConsumer’sGuidetoUsingeXpressDSP-CompliantAlgorithms(SPRA810),insteadofthisuser’sguide.CodeComposerStudioisatrademarkofTexasInstruments.ContentsvContents1PreliminaryXDAISWorkandPreparation2............................................2DefiningtheModule-SpecificAbstractInterface3.....................................3TheeXpressDSPComponentWizard6................................................3.1WhyusetheeXpressDSPComponentWizard?6...........................3.2eXpressDSPComponentWizardInitialScreen7............................3.3SelectingaDSPTargetPlatform8.........................................3.4ChoosinganAlgorithmandVendorName9................................3.5DeterminetheNumberofInputandOutputArraysandParametersVariablesUsedbyYourAlgorithm11.......................................3.6DefiningLocalArraysorBuffers(memTabMemoryDescriptors)UsedbyanInstanceofYourAlgorithm14..................................3.7Algorithm’sExtendedMethod(s)15........................................3.8VABSpecificInformation19..............................................3.9GeneratingtheSourceCodeTemplate21..................................3.10LaunchingtheCompiler23...............................................3.11AddingYourAlgorithmtotheXDAISSourceCodeTemplate24...............4TestingtheAlgorithmandtheNewlyGeneratedXDAISInterfaceCode26...............5XDAISLibraryCreation28...........................................................5.1CreatingtheXDAISLibraryFile28........................................5.2TestingtheXDAISLibraryFile28..........................................6Pre-ValidationofAlgorithmsUsingQualiTI(Pre-complianceTool)29....................6.1InvokingthePlug-In29...................................................6.2EnteringtheDatatoCreateanAlgorithmInformationFile30..................6.3ExecutingtheTest31....................................................6.4TheDo