TMS320C6000 Chip Support Library API Reference Guide Literature Number SPRU401J August 2004 Printed on Recycled Paper 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 the 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. Following are URLs where you can obtain information on other Texas Instruments products and application solutions: Products Applications Amplifiers amplifier.ti.com Audio www.ti.com/audio Data Converters dataconverter.ti.com Automotive www.ti.com/automotive DSP dsp.ti.com Broadband www.ti.com/broadband Interface interface.ti.com Digital Control www.ti.com/digitalcontrol Logic logic.ti.com Military www.ti.com/military Power Mgmt power.ti.com Optical Networking www.ti.com/opticalnetwork Microcontrollers microcontroller.ti.com Security www.ti.com/security Telephony www.ti.com/telephony Video & Imaging www.ti.com/video Wireless www.ti.com/wireless Mailing Address: Texas Instruments Post Office Box 655303 Dallas, Texas 75265 Copyright © 2004, Texas Instruments Incorporated Preface Read This First About This Manual The Chip Support Library (CSL) provides an application programming inter- face (API) used for configuring and controlling the DSP on--chip peripherals for ease of use, compatibility between various C6000 devices and hardware abstraction. This will shorten development time by providing standardization and portability. The C6000 Chip Support Library (SPRC090) supports the fol- lowing devices: C6201, C6202, C6203, C6204, C6205, C6211, C6410, C6412, C6413, C6414, C6415, C6416, C6418, C6701, C6711, C6712, C6713, DA610, DM640, DM641 and DM642. Some of the advantages offered by the CSL include: peripheral ease of use, a level of compatibility between devices, shortened development time, porta- bility, and standardization. A version of the CSL is available for all TMS320C6000 devices. This document is organized as follows: - Introduction -- a high level overview of the CSL - 27 CSL API module chapters - HAL macro chapter - Using CSL APIs Without DSP/BIOS - Register description - HowtoUsetheCSL - Cache register comparison - Glossary How to Use This Manual The information in this document describes the contents of the TMS320C6000 chip support library (CSL) as follows: - Chapter 1 provides an overview of the CSL, includes a table showing CSL API module support for various C6000 devices, and lists the API modules. Read This First iii Notational Conventions - Each additional chapter discusses an individual CSL API module and provides: J A description of the API module J A table showing the APIs within the module and a page reference for more specific information J A table showing the macros within the module and a page reference for more specific information J A module API Reference section in alphabetical order listing the CSL API functions, enumerations, type definitions, structures, constants, and global variables. Examples are given to show how these elements are used. - Chapter 28 describes the hardware abstraction layer (HAL) and provides a HAL macro reference section. - Appendix A provides an example of using CSL independently of DSP/BIOS. - Appendix B provides a list of the registers associated with current TMS320C6000 DSP devices. - Appendix C provides a comparison of the old and new CACHE register names, as they have recently been changed. - Appendix D provides a glossary. 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 a syntax that are within parentheses describe the type of information that should be entered. - Macro names are written in uppercase text; function names are written in lowercase. - TMS320C6000 devices are referred to throughout this reference guide as C6201, C6202, etc. iv Related Documentation From Texas Instruments Related Documentation From Texas Instruments The following books describe the TMS320C6000 devices and related support tools. To obtain a copy of any of these TI documents, call the Texas Instru- ments Literature Response Center at (800) 477−8924. 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 number SPRU189) describes the TMS320C6000™ CPU architecture, instruction set, pipeline, and interrupts for these digital signal proces- sors. TMS320C6x C Source Debugger User’s Guide (literature number SPRU188) tells you how to invoke the TMS320C6x™ simulator and emulator versions of the C source debugger interface. This book discusses various aspects of the debugger, including command entry, code execution, data management, breakpoints, profiling, and analysis. TMS320C6000 DSP Peripherals Overview Reference Guide (literature number SPRU190) describes the peripherals available on the C6000 platform of devices. TMS320C6000 Programmer’s Guide (literature number SPRU198) describes 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 other tools used to develop assembly language code), assembler directives, macros, common object file format, and symbolic debugging directives for the TMS320C6000™ generation of devices. TMS320C6000 Optimizing Compiler User’s Guide (literature number SPRU187) describes the TMS320C6000™ C compiler and the assembly optimizer. This C compiler accepts ANSI standard C source code and produces assembly language source code for the TMS320C6000 gen- eration of devices. The assembly optimizer helps you optimize your assembly code. TMS320C62x DSP Library (literature number SPRU402) describes the 32 high-level, C-callable, optimized DSP functions for general signal proc- essing, math, and vector operations. Read This First v Related Documentation From Texas Instruments TMS320C64x Technical Overview (SPRU395) The TMS320C64x technical overview gives an introduction to the TMS320C64x™ digital signal proc- essor, and discusses the application areas that are enhanced by the TMS320C64x VelociTI™. TMS320C62x Image/Video Processing Library (literature number SPRU400) describes the optimized image/video processing functions including many C-callable, assembly-optimized, general-purpose image/video processing routines. TMS320C6000 DSP External Memory Interface (EMIF) Reference Guide (literature number SPRU266) describes the operation of the external memory interface (EMIF) in the digital signal processors of the TMS320C6000 DSP family. TMS320C6000 DSP Enhanced Direct Memory Access (EDMA) Controller Reference Guide (literature