Texas Instruments TMS320 DSP manual TI C-Language Run-Time Support Library

www.ti.com

TI C-Language Run-Time Support Library

Recall that only a subset of the DSP/BIOS and the TI C run-time support library functions are allowed to be referenced from an eXpressDSP-compliant algorithm.

B.1 TI C-Language Run-Time Support Library

In the future, this list of allowable APIs will grow to include a rich set of DSP math function calls; e.g., functions for computing a DCT, FFT, dot product, etc.

The following table summarizes the TI C-Language Run-time Support Library functions that may be referenced by eXpressDSP-compliant algorithms.

Allowed or
Disallowed	Category	Typical Functions in Category
allowed	String functions	strcpy, strchr, etc
allowed	Memory-moving functions	memcpy, memmove, memset, etc.
allowed	Integer math support	_divi, _divu, _remi, _remu, etc.
allowed	Floating point support	_addf, _subf, _mpyf, _divf, _addd, _subd, _mpyd, _divd,
		log10, cosh, etc.
allowed	Conversion functions	atoi, ftoi, itof, etc.
disallowed	Heap management functions	malloc, free, realloc, alloc, …
disallowed	I/O functions	printf, open, read, write, etc
disallowed	misc. non-reentrant functions	printf, sprintf, ctime, etc.

Notes

(1)

(2)

(2)

(2)(3)

(2)

(4)

(5)

(4)(6)

(1)Exceptions: strtok is not reentrant, and strdup allocates memory with malloc.

(2)Some of these are issued by the compiler automatically for certain C operators.

(3)The errno paradigm is not reentrant. Thus, errno must not be used by eXpressDSP-compliant algorithms.

(4)Algorithms must not allocate memory.

(5)Algorithms are not allowed to perform I/O.

(6)Algorithms must be reentrant and must, therefore, only reference reentrant functions.

B.2 DSP/BIOS Run-time Support Library

The HWI module'sHWI disable, HWI enable, and HWI restore are the only allowed DSP/BIOS functions. These operations can be used to create critical sections within an algorithm and provide a processor-independent way of controlling preemption when used in a DSP/BIOS framework.

82 Core Run-Time APIs SPRU352G –June 2005 –Revised February 2007

Submit Documentation Feedback