Texas Instruments TMS320C6000 DSP Manuale utente

TMS320C6000 DSK

Board Support Library

API User’s Guide

Literature Number: SPRU432A

October 2001

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 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

iii

Read This First

Preface

Read This First

About This Manual

The TMS320C6000tDSK Board Support Library (BSL) is a set of application

programming interfaces (APIs) used to configure and control all on-board de-

vices. It is intended to make it easier for developers by eliminating much of the

tedious grunt-work usually needed to get algorithms up and running in a real

system.

Some of the advantages offered by the BSL include: device ease of use, a level

of compatibility between devices, shortened development time, portability,

some standardization, and hardware abstraction. A version of the BSL is avail-

able for the TMS320C6711tDevelopers Starter Kit (DSK).

This document is organized as follows:

-Introduction – a high level overview of the BSL

-Six BSL API module chapters

-Glossary

How to Use This Manual

The information in this document describes the contents of the

TMS320C6000tboard support library (BSL) as follows:

-Chapter 1 provides an overview of the BSL, includes a table showing BSL

API module support for various C6000 devices, and lists the API modules.

-Each additional chapter discusses an individual BSL API module and pro-

vides:

JA description of the API module

JA table showing the APIs within the module and a page reference for

more specific information

JA module API Reference section in alphabetical order listing the BSL

API functions, enumerations, type definitions, structures, constants,

and global variables. Examples are given to show how these elements

are used.

How to Use This Manual

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.

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 (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 Chip Support Library API User’s Guide (literature number

SPRU401) describes the chip support library (CSL), a library dedicated

for initialization and control of the on-chip peripherals.

TMS320C6000 CPU and Instruction Set Reference Guide (literature

number SPRU189) describes the ’C6000 CPU architecture, instruction

set, pipeline, and interrupts for these digital signal processors.

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, clock-

ing and phase-locked loop (PLL), and the power-down modes.

Notational Conventions / Related Documentation From Texas Instruments

How to Use This Manual

Read This First

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 ’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 as-

sembly language source code for the ’C6000 generation 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.

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.

Contents

vii

Contents

1 BSL Overview 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides an overview of the board support library (BSL), describes its beneficial features, and

lists each of its API modules.

1.1 BSL Introduction 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2 BSL API Modules 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2.1 BSL API Module Support 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2.2 Using BSL Handles 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3 BSL Project Settings 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3.1 User’s Program Setting 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3.2 Compiler Options 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3.3 Linker Options 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 AD535 API Module 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the AD535 API module, lists the individual APIs within the module,

and includes a reference section with the API functions, structures, and constants that are ap-

plicable to this module.

2.1 AD535 API Module Description 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2.2 AD535 API Reference 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 BOARD API Module 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the BOARD API module, lists the individual APIs within the module,

and includes a reference section showing the API functions and constants that are applicable

to this module.

3.1 BOARD API Module Description 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3.2 BOARD API Reference 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4 BSL API Module 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the BSL API module and includes a reference section showing the

single API function within this module.

4.1 BSL API Module Description 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4.2 BSL API Reference 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents

viii

5 DIP API Module 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the DIP API module, lists the individual APIs within the module, and

includes a reference section showing the single API function and constant within this module.

5.1 DIP API Module Description 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5.2 DIP API Reference 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6 FLASH API Module 6-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the FLASH API module, lists the individual APIs within the module,

and includes a reference section showing the API functions and constants that are applicable

to this module.

6.1 FLASH API Module Description 6-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6.2 FLASH API Reference 6-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7 LED API Module 7-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Provides a description of the LED API module, lists the individual APIs within the module, and

includes a reference section showing the API functions and constants that are applicable to this

module.

7.1 LED API Module Description 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7.2 LED API Reference 7-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A Glossary A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Tables

Contents

Tables

1–1. BSL Modules and Include Files 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1–2. BSL Support Library Name and Symbol Conventions 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1–3. BSL API Module Support for 6711 DSK 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2–1. AD535 API Summary 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3–1. BOARD API Summary 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4–1. BSL API Function 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5–1. DIP API Summary 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6–1. FLASH API Summary 6-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7–1. LED API Summary 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1-1

BSL Overview

This chapter provides an overview of the board support library (BSL), de-

scribes its beneficial features, and lists each of its API modules.

Topic Page

1.1 BSL Introduction 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.2 BSL API Modules 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1.3 BSL Project Settings 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 1

BSL Introduction

1-2

1.1 BSL Introduction

The BSL provides a C-language interface for configuring and controlling all on-

board devices. The library consists of discrete modules that are built and ar-

chived into a library file. Each module represents an individual API and is re-

ferred to simply as an API module. The module granularity is architected such

that each device is covered by a single API module except the I/O Port Module,

which is divided into two API modules: LED and DIP.

How The BSL Benefits You

The BSL’s beneficial features include device ease of use, shortened develop-

ment time, portability, hardware abstraction, and a level of standardization and

compatibility among devices. In general, the BSL makes it easier for you to get

your algorithms up and running in the shortest length of time.

Altri manuali per TMS320C6000 DSP

Indice

Altri manuali Texas Instruments Scheda di rete

Texas Instruments

Texas Instruments MSOP-8EVM Manuale utente

Texas Instruments

Texas Instruments TIDA-010046 Guida

Texas Instruments

Texas Instruments SPRU938B Manuale utente

Texas Instruments

Texas Instruments TPS6120 EVM-179 Series Manuale utente

Texas Instruments

Texas Instruments TMS320TCI648x Manuale utente

Texas Instruments

Texas Instruments TLV320DAC3202EVM Manuale utente

Texas Instruments

Texas Instruments ADS867 Series Manuale utente

Texas Instruments

Texas Instruments DAC3282 Manuale utente

Texas Instruments

Texas Instruments DAC7741EVM Manuale utente

Texas Instruments

Texas Instruments TLV320AIC3107EVM-K Manuale utente

Texas Instruments

Texas Instruments CC2511 Manuale utente

Texas Instruments

Texas Instruments TMS320DM646 Series Manuale utente

Texas Instruments

Texas Instruments ADS42 EVM Series Manuale utente

Texas Instruments

Texas Instruments CDCM7005 Manuale utente

Texas Instruments

Texas Instruments TMS320C645X Manuale utente

Texas Instruments

Texas Instruments VCA8500BOARD Manuale utente

Texas Instruments

Texas Instruments TNETE2201 Manuale utente

Texas Instruments

Texas Instruments TPS62730 Manuale utente

Texas Instruments

Texas Instruments TRF3762 EVM Manuale utente

Texas Instruments

Texas Instruments bq24070 Manuale utente

Texas Instruments

Texas Instruments TSW14J10 Manuale utente

Texas Instruments

Texas Instruments SLAU245 Manuale utente

Texas Instruments

Texas Instruments VLYNQ Port Manuale utente

Texas Instruments

Texas Instruments TPS2330 Manuale utente

Manuali Scheda di rete popolari di altre marche

FirstComm

FirstComm OBiWiFi5G Manuale utente

Sun Microsystems

Sun Microsystems Interface Adapter Manuale utente

TRENDnet

TRENDnet TU2-ETG Manuale utente

YASKAWA

YASKAWA SI-EN3 Manuale utente

Paradyne

Paradyne BitStorm 2600 IP DSLAM Manuale utente

Belkin

Belkin F5D7050 Manuale utente

3Com

3Com EtherLink 3C509B Manuale utente

TRENDnet

TRENDnet TEG-PCITX Manuale utente

Cisco

Cisco MC16E Manuale utente

Delta Electronics

Delta Electronics Braking Modules VFDB Series Manuale utente

TwinMOS

TwinMOS Booming Manuale utente

Dialogic

Dialogic Media Board DM/V1200BTEPEQ Manuale utente

Buffalo

Buffalo AirStation WLI-PCM-L11GP Manuale utente

National Instruments

National Instruments NI 9234 Manuale utente

Hama

Hama 49276 Manuale utente

Linksys

Linksys WCF54G - Wireless-G Compact Flash Card Manuale operativo

Compaq

Compaq Wireless LAN 100 Manuale utente

Bose

Bose PowerMatch Dante Manuale utente