Texas Instruments TMS320C67 DSP Series User manual

TMS320C67x DSP Library
Programmer’s Reference Guide
Literature Number: SPRU657
February 2003

IMPORTANT NOTICE
Texas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections,
modifications, enhancements, improvements, and other changes to its products and services at
any time and to discontinue any product or service without notice. Customers should obtain the
latest relevant information before placing orders and should verify that such information is current
and complete. All products are sold subject to TI’s terms and conditions of sale supplied at the
time of order acknowledgment.
TI warrants performance of its hardware products to the specifications applicable at the time of
sale in accordance with TI’s standard warranty. Testing and other quality control techniques are
used to the extent TI deems necessary to support this warranty. Except where mandated by
government requirements, testing of all parameters of each product is not necessarily performed.
TI assumes no liability for applications assistance or customer product design. Customers are
responsible for their products and applications using TI components. To minimize the risks
associated with customer products and applications, customers should provide adequate design
and operating safeguards.
TI does not warrant or represent that any license, either express or implied, is granted under any
TI patent right, copyright, mask work right, or other TI intellectual property right relating to any
combination, machine, or process in which TI products or services are used. Information
published by TI regarding third party products or services does not constitute a license from TI
to use such products or services or a warranty or endorsement thereof. Use of such information
may require a license from a third party under the patents or other intellectual property of that third
party, or a license from TI under the patents or other intellectual property of TI.
Reproduction of information in TI data books or data sheets is permissible only if reproduction
is without alteration and is accompanied by all associated warranties, conditions, limitations, and
notices. Reproduction of this information with alteration is an unfair and deceptive business
practice. TI is not responsible or liable for such altered documentation.
Resale of TI products or services with statements different from or beyond the parameters stated
by TI for that product or service voids all express and any implied warranties for the associated
TI product or service and is an unfair and deceptive business practice. TI is not responsible or
liable for any such statements.
Mailing Address:
Texas Instruments
Post Office Box 655303
Dallas, Texas 75265
Copyright 2003, Texas Instruments Incorporated

iiiRead This First
Preface
Read This First
About This Manual
Welcome to the TMS320C67x digital signal processor (DSP) Library or
DSPLIB, for short. The DSPLIB is a collection of 36 high-level optimized DSP
functions for the TMS320C67x device. This source code library includes C-
callable functions (ANSI-C language compatible) for general signal process-
ing math and vector functions.
This document contains a reference for the DSPLIB functions and is organized
as follows:
-Overview - an introduction to the TI C67x DSPLIB
-Installation - information on how to install and rebuild DSPLIB
-DSPLIB Functions - a quick reference table listing of routines in the library
-DSPLIB Reference - a description of all DSPLIB functions complete with
calling convention, algorithm details, special requirements and imple-
mentation notes
-Information about performance, fractional Q format and customer support
How to Use This Manual
The information in this document describes the contents of the TMS320C67x
DSPLIB in several different ways.
-Chapter 1 provides a brief introduction to the TI C67x DSPLIB, shows the
organization of the routines contained in the library, and lists the features
and benefits of the DSPLIB.
-Chapter 2 provides information on how to install, use, and rebuild the TI
C67x DSPLIB
-Chapter 3 provides a quick overview of all DSPLIB functions in table for-
mat for easy reference. The information shown for each function includes
the syntax, a brief description, and a page reference for obtaining more
detailed information.

Notational Conventions
iv
-Chapter 4 provides a list of the routines within the DSPLIB organized into
functional categories. The functions within each category are listed in al-
phabetical order and include arguments, descriptions, algorithms, bench-
marks, and special requirements.
-Appendix A describes performance considerations related to the C67x
DSPLIB and provides information about the Q format used by DSPLIB
functions.
-Appendix B provides information about software updates and customer
support.
Notational Conventions
This document uses the following conventions:
-Program listings, program examples, and interactive displays are shown
in a special typeface.
-In syntax descriptions, the function or macro appears in a bold typeface
and the parameters appear in plainface within parentheses. Portions of a
syntax that are in bold should be entered as shown; portions of syntax that
are within parentheses describe the type of information that should be en-
tered.
-Macro names are written in uppercase text; function names are written in
lowercase.
-The TMS320C67x is also referred to in this reference guide as the C67x.
Related Documentation From Texas Instruments
The following books describe the TMS320C6x devices and related support
tools. To obtain a copy of any of these TI documents, call the Texas Instru-
ments Literature Response Center at [phone]. When ordering, please
identify the book by its title and literature number. Many of these documents
can be found on the Internet at http://www.ti.com.
TMS320C62x/C67x Technical Brief (literature number SPRU197) gives an
introduction to the ’C62x/C67x digital signal processors, development tools,
and third-party support.
TMS320C6000 CPU and Instruction Set Reference Guide (literature num-
ber SPRU189) describes the C6000 CPU architecture, instruction set, pipe-
line, and interrupts for these digital signal processors.

Trademarks
vRead This First
TMS320C6000 Peripherals Reference Guide (literature number SPRU190)
describes common peripherals available on the TMS320C6000 digital signal
processors. This book includes information on the internal data and program
memories, the external memory interface (EMIF), the host port interface (HPI),
multichannel buffered serial ports (McBSPs), direct memory access (DMA),
enhanced DMA (EDMA), expansion bus, clocking and phase-locked loop
(PLL), and the power-down modes.
TMS320C6000 Programmer’s Guide (literature number SPRU198) de-
scribes ways to optimize C and assembly code for the TMS320C6000 DSPs
and includes application program examples.
TMS320C6000 Assembly Language Tools User’s Guide (literature number
SPRU186) describes the assembly language tools (assembler, linker, and oth-
er tools used to develop assembly language code), assembler directives,
macros, common object file format, and symbolic debugging directives for the
C6000 generation of devices.
TMS320C6000 Optimizing C Compiler User’s Guide (literature number
SPRU187) describes the C6000 C compiler and the assembly optimizer. This
C compiler accepts ANSI standard C source code and produces assembly lan-
guage source code for the C6000 generation of devices. The assembly opti-
mizer helps you optimize your assembly code.
TMS320C6000 Chip Support Library (literature number SPRU401) de-
scribes the application programming interfaces (APIs) used to configure and
control all on-chip peripherals.
TMS320C62x Image/Video Processing Library (literature number
SPRU400) describes the optimized image/video processing functions includ-
ing many C-callable, assembly-optimized, general-purpose image/video
processing routines.
Trademarks
TMS320C6000, TMS320C62x, TMS320C67x, and Code Composer Studio
are trademarks of Texas Instruments.
Other trademarks are the property of their respective owners.

Contents
vii
Contents
1 Introduction 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides a brief introduction to the TI C67x DSPLIB, shows the organization of the routines con-
tained in the library, and lists the features and benefits of the DSPLIB.
1.1 Introduction to the TI C67x DSPLIB 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Features and Benefits 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 Installing and Using DSPLIB 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides information on how to install, use, and rebuild the TI C67x DSPLIB.
2.1 DSP Library Contents 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 How to Install the DSP Library 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Using DSPLIB 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.1 DSPLIB Arguments and Data Types 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.2 Calling a DSPLIB Function From C 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.3 Calling a DSP Function From Assembly 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.4 How DSPLIB is Tested - Allowable Error 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3.5 How DSPLIB Deals With Overflow and Scaling Issues 2-6. . . . . . . . . . . . . . . . . . . .
2.3.6 Interrupt Behavior of DSPLIB Functions 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 How to Rebuild DSPLIB 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 DSPLIB Function Tables 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides tables containing all DSPLIB functions, a brief description of each, and a page refer-
ence for more detailed information.
3.1 Arguments and Conventions Used 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 DSPLIB Functions 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 DSPLIB Function Tables 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 DSPLIB Reference 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides a list of the functions within the DSPLIB organized into functional categories.
4.1 Adaptive Filtering 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_lms 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Correlation 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_autocor 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 FFT 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_bitrev_cplx 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_cfftr4_dif 4-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_cfftr2_dit 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_fftSPxSP 4-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_ifftSPxSP 4-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_icfftr2_dif 4-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
viii
4.4 Filtering and Convolution 4-38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_fir_cplx 4-38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_fir_gen 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_fir_r2 4-41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_fircirc 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_biquad 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_iir 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_iirlat 4-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_convol 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.5 Math 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_dotp_sqr 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_dotprod 4-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_dotp_cplx 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_maxval 4-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_maxidx 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_minval 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_vecrecip 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_vecsum_sq 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_w_vec 4-61. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_vecmul 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.6 Matrix 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_mat_mul 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_mat_trans 4-65. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_mat_mul_cplx 4-66. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.7 Miscellaneous 4-69. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_blk_move 4-69. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_blk_eswap16 4-70. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_blk_eswap32 4-71. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_blk_eswap64 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_fltoq15 4-75. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_sp_minerr 4-76. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DSPF_q15tofl 4-78. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A Performance/Fractional Q Formats A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Describes performance considerations related to the C67x DSPLIB and provides information
about the Q format used by DSPLIB functions.
A.1 Performance Considerations A-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A.2 Fractional Q Formats A-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A.2.1 Q.15 Format A-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B Software Updates and Customer Support B-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Provides information about software updates and customer support.
B.1 DSPLIB Software Updates B-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
B.2 DSPLIB Customer Support B-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C Glossary C-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Tables
ixContents
Tables
2-1 DSPLIB Data Types 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-1 Argument Conventions 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-2 Adaptive Filtering 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-3 Correlation 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-4 FFT 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-5 Filtering and Convolution 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-6 Math 3-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-7 Matrix 3-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-8 Miscellaneous 3-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A-1 Q.15 Bit Fields A-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-1
Introduction
This chapter provides a brief introduction to the TI C67xDSP Library
(DSPLIB), shows the organization of the routines contained in the library, and
lists the features and benefits of the DSPLIB.
Topic Page
1.1 Introduction to the TI C67x DSPLIB 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 Features and Benefits 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 1

Introduction to the TI C67x DSPLIB
1-2
1.1 Introduction to the TI C67x DSPLIB
The TI C67x DSPLIB is an optimized DSP Function Library for C programmers
using TMS320C67x devices. It includes C-callable, assembly-optimized gen-
eral-purpose signal-processing routines. These routines are typically used in
computationally intensive real-time applications where optimal execution
speed is critical. By using these routines, you can achieve execution speeds
considerably faster than equivalent code written in standard ANSI C language.
In addition, by providing ready-to-use DSP functions, TI DSPLIB can signifi-
cantly shorten your DSP application development time.
The TI DSPLIB includes commonly used DSP routines. Source code is pro-
vided that allows you to modify functions to match your specific needs.
The routines contained in the library are organized into the following seven dif-
ferent functional categories:
-Adaptive filtering
JDSPF_sp_lms
-Correlation
JDSPF_sp_autocor
-FFT
JDSPF_sp_bitrev_cplx
JDSPF_sp_cfftr4_dif
JDSPF_sp_cfftr2_dit
JDSPF_sp_fftSPxSP
JDSPF_sp_ifftSPxSP
JDSPF_sp_icfftr2_dif
-Filtering and convolution
JDSPF_sp_fir_cplx
JDSPF_sp_fir_gen
JDSPF_sp_fir_r2
JDSPF_sp_fircirc
JDSPF_sp_biquad
JDSPF_sp_iir
JDSPF_sp_iirlat
JDSPF_sp_convol

Introduction to the TI C67x DSPLIB
1-3Introduction
-Math
JDSPF_sp_dotp_sqr
JDSPF_sp_dotprod
JDSPF_sp_dotp_cplx
JDSPF_sp_maxval
JDSPF_sp_maxidx
JDSPF_sp_minval
JDSPF_sp_vecrecip
JDSPF_sp_vecsum_sq
JDSPF_sp_w_vec
JDSPF_sp_vecmul
-Matrix
JDSPF_sp_mat_mul
JDSPF_sp_mat_trans
JDSPF_sp_mat_mul_cplx
-Miscellaneous
JDSPF_sp_blk_move
JDSPF_sp_blk_eswap16
JDSPF_sp_blk_eswap32
JDSPF_sp_blk_eswap64
JDSPF_fltoq15
JDSPF_sp_minerr
JDSPF_q15tofl

Features and Benefits
1-4
1.2 Features and Benefits
-Hand-coded assembly-optimized routines
-C and linear assembly source code
-C-callable routines, fully compatible with the TI C6x compiler
-Fractional Q.15-format operands supported on some benchmarks
-Benchmarks (time and code)
-Tested against the C model

2-1
Installing and Using DSPLIB
This chapter provides information on how to install, use, and rebuild the TI
C67x DSPLIB.
Topic Page
2.1 DSP Library Contents 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 How to Install the DSP Library 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Using DSPLIB 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 How to Rebuild DSPLIB 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 2

DSP Library Contents
2-2
2.1 DSP Library Contents
The C67xDSPLIB.exe installs the following file structure:
bin Directory containing FFT twiddle factor generators
lib
dsp67x.lib
dsp67x.src
dsp67x_c.src
dsp67x_sa.src
Dirctory containing the following library files:
Little-endian C67x library file
Assembly source archive file
C-source archive file
Linear assembly source archive file
include
h header files
h67 header files
Directory containing the following include files:
C header files
Assembly header files
support Directory containing support files.
docs†
pdf
spru657.pdf
Directory containing the following document files:
PDF document of API - this document
†This installs into the Code Composer Studio docs directory.

How to Install the DSP Library
2-3Installing and Using DSPLIB
2.2 How to Install the DSP Library
To install the DSP libary, follow these steps:
Step 1: Open the file, C67xDSPLIB.exe.
Step 2: Click Yes to install the library.
Step 3: Click Next to continue with the Install Shield Wizard.
Step 4: Read the Software Licenses, and choose either “I accept”or “I don’t
accept.”
Step 5: Click Next to continue.
If you selected “I accept,”the installation will continue.
If you selected “I don’t accept,”the installation cancels.
Step 6: Choose the location where you would like to install the library. The
wizard will install the library into the c6700 sub-directory of the direc-
tory you choose.
The default location is c:\ti.
Step 7: Click Next.
Step 8: If the library has already been installed, you will be prompted to de-
cide whether to replace the files or not. Click Yes to update the library.
Step 9: The Install Shield will complete the installation. When the installation
is complete, click Finish.

Using DSPLIB
2-4
2.3 Using DSPLIB
2.3.1 DSPLIB Arguments and Data Types
DSPLIB Types
Table 2-1 shows the data types handled by the DSPLIB.
Table 2-1. DSPLIB Data Types
Name Size
(bits) Type Minimum Maximum
short 16 Integer -32768 32767
int 32 Integer -2147483648 2147483647
long 40 Integer -549755813888 549755813887
pointer 32 Address 0000:0000h FFFF:FFFFh
Q.15 16 Fraction -1.0 0.9999694824...
IEEE float 32 floating point 1.17549435e-38 3.40282347e+38
IEEE double 64 floating point 2.2250738585072014e-308 1.7976931348623157e+308
Unless specifically noted, DSPLIB operates on single-precision IEEE float
data type elements.
DSPLIB Arguments
TI DSPLIB functions typically operate over vector operands for greater effi-
ciency. Even though these routines can be used to process smaller arrays, or
even scalars (unless a minimum size requirement is noted), they will be slower
for these cases.
-Vector stride is always equal to 1: Vector operands are composed of vector
elements held in consecutive memory locations (vector stride equal to 1).
-Complex elements are assumed to be stored in consecutive memory loca-
tions with Real data followed by Imaginary data.
-In-place computation is not allowed, unless specifically noted: Source and
destination arrays should not overlap.

Using DSPLIB
2-5Installing and Using DSPLIB
2.3.2 Calling a DSPLIB Function From C
In addition to correctly installing the DSPLIB software, you must follow these
steps to include a DSPLIB function in your code:
-Include the function header file corresponding to the DSPLIB function
-Link your code with dsp67x.lib
-Use a correct linker command file for the platform you use. Remember
most functions in dsp67x.lib are written assuming little-endian mode of op-
eration.
For example, if you want to call the Autocorrelation DSPLIB function, you
would add:
#include <dspf_sp_autocor.h>
in your C file and compile and link using
cl6x main.c –z –o autocor_drv.out –lrts6700.lib -
ldsp67x.lib
Code Composer Studio Users
Assuming your C_DIR environment is correctly set up (as mentioned in
section 2.2), you would have to add DSPLIB under the Code Composer Studio
environment by choosing dsp67x.lib from the menu Project →Add Files to
Project. Also, you should make sure that you link with the run-time support li-
brary, rts6700.lib.
2.3.3 Calling a DSP Function From Assembly
The C67x DSPLIB functions were written to be used from C. Calling the func-
tions from assembly language source code is possible as long as the calling
function conforms to the Texas Instruments C6x C compiler calling conven-
tions. Here, the corresponding .h67 header files located in the ‘include’directo-
ry must be included using the ‘.include’directive. For more information, refer to
section 8 (Runtime Environment) of the TMS320C6000 Optimizing C Compil-
er User’s Guide (SPRU187).
2.3.4 How DSPLIB is Tested - Allowable Error
DSPLIB is tested under the Code Composer Studio environment against a ref-
erence C implementation. Because of floating point calculation order change
for these two implementations, they differ in the results with an allowable toler-
ance for that particular kernel. Thus every kernel’s test routine (in the driver
file) has error tolerance variable defined that gives the maximum value that is
acceptable as the error difference.

How to Rebuild DSPLIB
2-6
For example:
#define R_TOL (1e-05)
Here, the maximum difference allowed between the output reference array
from the C implementation and all other implementations (linear asm, hand
asm) is 1e-05 (0.00001).
The error tolerance is therefore different for different functions.
2.3.5 How DSPLIB Deals With Overflow and Scaling Issues
The DSPLIB functions implement the same functionality of the reference C
code. The user is expected to conform to the range requirements specified in
the API function, and in addition, take care to restrict the input range in such a
way that the outputs do not overflow.
2.3.6 Interrupt Behavior of DSPLIB Functions
Most DSPLIB functions are interrupt-tolerant but not interruptible. The cycle
count formula provided for each function can be used to estimate the number
of cycles during which interrupts cannot be taken.
2.4 How to Rebuild DSPLIB
If you would like to rebuild DSPLIB (for example, because you modified the
source file contained in the archive), you will have to use the mk6x utility as
follows:
mk6x dsp67x.src -mv6700 -l dsp67x.lib

3-1
DSPLIB Function Tables
This chapter provides tables containing all DSPLIB functions, a brief descrip-
tion of each, and a page reference for more detailed information.
Topic Page
3.1 Arguments and Conventions Used 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 DSPLIB Functions 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 DSPLIB Function Tables 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 3

Arguments and Conventions Used
3-2
3.1 Arguments and Conventions Used
The following convention has been followed when describing the arguments
for each individual function:
Table 3-1. Argument Conventions
Argument Description
x,y Argument reflecting input data vector
rArgument reflecting output data vector
nx,ny,nr Arguments reflecting the size of vectors x,y, and r, respectively. For
functions in the case nx = ny = nr, only nx has been used across.
hArgument reflecting filter coefficient vector (filter routines only)
nh Argument reflecting the size of vector h
wArgument reflecting FFT coefficient vector (FFT routines only)