Texas Instruments TMS320 DSP Computer Hardware User Manual


 
www.ti.com
B.1TIC-LanguageRun-TimeSupportLibrary
B.2DSP/BIOSRun-timeSupportLibrary
TIC-LanguageRun-TimeSupportLibrary
RecallthatonlyasubsetoftheDSP/BIOSandtheTICrun-timesupportlibraryfunctionsareallowedto
bereferencedfromaneXpressDSP-compliantalgorithm.
Inthefuture,thislistofallowableAPIswillgrowtoincludearichsetofDSPmathfunctioncalls;e.g.,
functionsforcomputingaDCT,FFT,dotproduct,etc.
ThefollowingtablesummarizestheTIC-LanguageRun-timeSupportLibraryfunctionsthatmaybe
referencedbyeXpressDSP-compliantalgorithms.
Allowedor
DisallowedCategoryTypicalFunctionsinCategoryNotes
allowedStringfunctionsstrcpy,strchr,etc
(1)
allowedMemory-movingfunctionsmemcpy,memmove,memset,etc.
(2)
allowedIntegermathsupport_divi,_divu,_remi,_remu,etc.
(2)
allowedFloatingpointsupport_addf,_subf,_mpyf,_divf,_addd,_subd,_mpyd,_divd,
(2)(3)
log10,cosh,etc.
allowedConversionfunctionsatoi,ftoi,itof,etc.
(2)
disallowedHeapmanagementfunctionsmalloc,free,realloc,alloc,
(4)
disallowedI/Ofunctionsprintf,open,read,write,etc
(5)
disallowedmisc.non-reentrantfunctionsprintf,sprintf,ctime,etc.
(4)(6)
(1)
Exceptions:strtokisnotreentrant,andstrdupallocatesmemorywithmalloc.
(2)
SomeoftheseareissuedbythecompilerautomaticallyforcertainCoperators.
(3)
Theerrnoparadigmisnotreentrant.Thus,errnomustnotbeusedbyeXpressDSP-compliantalgorithms.
(4)
Algorithmsmustnotallocatememory.
(5)
AlgorithmsarenotallowedtoperformI/O.
(6)
Algorithmsmustbereentrantandmust,therefore,onlyreferencereentrantfunctions.
TheHWImodule'sHWIdisable,HWIenable,andHWIrestorearetheonlyallowedDSP/BIOSfunctions.
Theseoperationscanbeusedtocreatecriticalsectionswithinanalgorithmandprovidea
processor-independentwayofcontrollingpreemptionwhenusedinaDSP/BIOSframework.
82CoreRun-TimeAPIsSPRU352GJune2005RevisedFebruary2007
SubmitDocumentationFeedback