TMS320C28xDSP/BIOS5.xApplicationProgrammingInterface(API)ReferenceGuideLiteratureNumber:SPRU625LAugust2012SPRU625L—August2012ReadThisFirst2SubmitDocumentationFeedbackPrefaceSPRU625L—August2012ReadThisFirstAboutThisManualDSP/BIOSgivesdevelopersofmainstreamapplicationsonTexasInstrumentsTMS320C28xTMDSPdevicestheabilitytodevelopembeddedreal-timesoftware.DSP/BIOSprovidesasmallfirmwarereal-timelibraryandeasy-to-usetoolsforreal-timetracingandanalysis.YoushouldreadandbecomefamiliarwiththeTMS320DSP/BIOSUser’sGuide,acompanionvolumetothisAPIreferenceguide.Beforeyoureadthismanual,youmayusetheCodeComposerStudioonlinetutorialandtheDSP/BIOSsectionoftheonlinehelptogetanoverviewofDSP/BIOS.ThismanualdiscussesvariousaspectsofDSP/BIOSindepthandassumesthatyouhaveatleastabasicunderstandingofDSP/BIOS.NotationalConventionsThisdocumentusesthefollowingconventions:•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;}•Squarebrackets([and])identifyanoptionalparameter.Ifyouuseanoptionalparameter,youspecifytheinformationwithinthebrackets.Unlessthesquarebracketsareinaboldtypeface,donotenterthebracketsthemselves.•Throughoutthismanual,28representsthetwo-digitnumericappropriatetoyourspecificDSPplatform.Forexample,DSP/BIOSassemblylanguageAPIheaderfilesfortheC28xplatformaredescribedashavingasuffixof.h28.FortheC64xorC67xDSPplatform,substituteeither64or67foreachoccurrenceof62.RelatedDocumentationFromTexasInstrumentsThefollowingbooksdescribeTMS320devicesandrelatedsupporttools.ToobtainacopyofanyoftheseTIdocuments,calltheTexasInstrumentsLiteratureResponseCenterat(800)477-8924.Whenordering,pleaseidentifythebookbyitstitleandliteraturenumber.3ReadThisFi...