"TMS320C55x DSP Library DSPLIB Programmer's Reference"

More documents

Recommendations

Info

Calling a DSPLIB Function from CIn this example, the q15tofl DSPLIB function is used to convert Q15 fractionalvalues to floating point fractional values. However, in many applications, yourdata is always maintained in Q15 format so that the conversion between floatand Q15 is not required.The above code, ug.c, is available to you in the /doc/code subdirectory. Tocompile and link this code with 55xdsp.lib, issue the following command:cl55 –pk –g –o3 –i. ug.c –z –v0 ld3.cmd 55xdsp.lib –m ug.map –oug.outThe examples presented in this document have been tested using the TexasInstruments C55x Simulator. Customization may be required to use it with adifferent simulator or development board.Refer to the TMS320C55x Optimizing C Compiler User’s Guide (SPRU281).3-4
Calling a DSPLIB Function from Assembly Language Source Code3.3 Calling a DSPLIB Function from Assembly Language Source CodeThe TMS320C55x DSPLIB functions were written to be used from C. Callingthe functions from assembly language source code is possible as long as thecalling-function conforms with the Texas Instruments C55x C compiler callingconventions. Refer to the TMS320C55x Optimizing C Compiler User’s Guide,if a more in-depth explanation is required.Realize that the TI DSPLIB is not an optimal solution for assembly-onlyprogrammers. Even though DSPLIB functions can be invoked from anassembly program, the result may not be optimal due to unnecessary C-callingoverhead.3.4 Where to Find Sample CodeYou can find examples on how to use every single function in DSPLIB, in theexamples subdirectory. This subdirectory contains one subdirectory for eachfunction. For example, the examples/araw subdirectory contains the followingfiles:araw_t.c: main driver for testing the DSPLIB acorr (raw) function.test.h: contains input data(a) and expected output data(yraw) for the acorr(raw) function as. This test.h file is generated by using Matlab scripts.test.c: contains function used to compare the output of araw function withthe expected output data.ftest.c: contains function used to compare two arrays of float data types.ltest.c: contains function used to compare two arrays of long data types.ld3.cmd: an example of a linker command you can use for this function.Using DSPLIB3-5
Page 1 and 2: TMS320C55x DSP LibraryProgrammer’
Page 3 and 4: PrefaceRead This FirstAbout This Ma
Page 5: Contentsatan16 . . . . . . . . . .
Page 9 and 10: DSP Routines1.1 DSP RoutinesThe TI
Page 11 and 12: DSPLIB Content / How to Install DSP
Page 13 and 14: Chapter 3Using DSPLIBThis chapter d
Page 15: Calling a DSPLIB Function from C3.2
Page 19 and 20: How DSPLIB Deals with Overflow and
Page 21 and 22: Chapter 4Function DescriptionsThis
Page 23 and 24: DSPLIB Functions4.2 DSPLIB Function
Page 25 and 26: DSPLIB FunctionsTable 4-2. Summary
Page 27 and 28: acorracorrFunctionArgumentsAutocorr
Page 29 and 30: addCycles †Code size(in bytes)Aub
Page 31 and 32: atan16Description This function cal
Page 33 and 34: expbexpFunctionBlock Exponent Imple
Page 35 and 36: cfftBenchmarks(preliminary)Cycles
Page 37 and 38: cfirCFFT - NOSCALEFFT Size Cycles
Page 39 and 40: cfirImplementation Notes The first
Page 41 and 42: cifftcifftFunctionInverse Complex F
Page 43 and 44: convolCIFFT - NOSCALEFFT Size Cycle
Page 45 and 46: convol1Figure 4-6. h Array in Memor
Page 47 and 48: convol2Figure 4-8. r Array in Memor
Page 49 and 50: convol2Figure 4-10. x Array in Memo
Page 51 and 52: dlmsImplementation NotesSpecial deb
Page 53 and 54: expnImplementation NotesDelayed ver
Page 55 and 56: firr[nx]Pointer to output vector of
Page 57 and 58: fir2Figure 4-14. x Array in Memoryo
Page 59 and 60: fir2Special Requirementsnh must be
Page 61 and 62: firdecr[nx/D]dbuffer[nh+1]nxnhDofla
Page 63 and 64: firinterpIoflagInterpolation factor
Page 65 and 66: firlatpbuffer [nh]nxnhoflagDelay bu
Page 67 and 68:
firsnh2oflagHalf the number of coef
Page 69 and 70:
fltoq15Figure 4-21. r Array in Memo
Page 71 and 72:
hilb16dbuffer[nh + 2] Pointer to de
Page 73 and 74:
iir32Figure 4-23. x Array in Memory
Page 75 and 76:
iir32In the case of multiple-buffer
Page 77 and 78:
iircas4nxoflagNumber of elements of
Page 79 and 80:
iircas51This function retains the a
Page 81 and 82:
iirlatBenchmarks(preliminary)Cycles
Page 83 and 84:
ldiv16ldiv16Function32-bit by 16-bi
Page 85 and 86:
log_10Special Requirements noneImpl
Page 87 and 88:
lognThe coefficients Bi used in the
Page 89 and 90:
maxidxmaxidxFunctionIndex of the Ma
Page 91 and 92:
maxvecDescription Returns the maxim
Page 93 and 94:
minvecminvalFunctionMinimum Value o
Page 95 and 96:
mmulDescriptionAlgorithmThis functi
Page 97 and 98:
negr[nx]Pointer to output data vect
Page 99 and 100:
powernxoflagNumber of elements of i
Page 101 and 102:
and16AlgorithmNot applicableOverflo
Page 103 and 104:
and16initBenchmarksCycles Core: 13
Page 105 and 106:
fftThe initial estimate can be obta
Page 107 and 108:
ifftrifftFunctionInverse Real FFT (
Page 109 and 110:
sqrt_16DescriptionComputes the sine
Page 111 and 112:
subr[nx]nxscaleoflagPointer to outp
Page 113 and 114:
What DSPLIB Benchmarks are Provided
Page 115 and 116:
DSPLIB Software Updates6.1 DSPLIB S
Page 117 and 118:
Q3.12 Format / Q.15 Format / Q.31 F
Page 119 and 120:
Calculating the Reciprocal of a Q15
Page 121 and 122:
IndexIndex16-bit reciprocal functio
Page 123:
Indexmmul 4-74mtrans 4-76mul32 4-76
show all

"TMS320C55x DSP Library DSPLIB Programmer's Reference"

Create successful ePaper yourself

Delete template?

Save as template?