Texas Instruments Codec Engine Server User Manual
Size:
206.37 Kb
Download

Codec Engine Server Integrator

User's Guide

Literature Number: SPRUED5B

September 2007

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-partyproducts 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 TI 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. Information of third parties may be subject to additional restrictions.

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.

TI products are not authorized for use in safety-criticalapplications (such as life support) where a failure of the TI product would reasonably be expected to cause severe personal injury or death, unless officers of the parties have executed an agreement specifically governing such use. Buyers represent that they have all necessary expertise in the safety and regulatory ramifications of their applications, and acknowledge and agree that they are solely responsible for all legal, regulatory andsafety-relatedrequirements concerning their products and any use of TI products in suchsafety-criticalapplications, notwithstanding anyapplications-relatedinformation or support that may be provided by TI. Further, Buyers must fully indemnify TI and its representatives against any damages arising out of the use of TI products in suchsafety-criticalapplications.

TI products are neither designed nor intended for use in military/aerospace applications or environments unless the TI products are specifically designated by TI as military-gradeor "enhanced plastic." Only products designated by TI asmilitary-grademeet military specifications. Buyers acknowledge and agree that any such use of TI products which TI has not designated asmilitary-gradeis solely at the Buyer's risk, and that they are solely responsible for compliance with all legal and regulatory requirements in connection with such use.

TI products are neither designed nor intended for use in automotive applications or environments unless the specific TI products are designated by TI as compliant with ISO/TS 16949 requirements. Buyers acknowledge and agree that, if they use any non-designatedproducts in automotive applications, TI will not be responsible for any failure to meet such requirements.

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

RFID

www.ti-rfid.com

Telephony

www.ti.com/telephony

Low Power Wireless

www.ti.com/lpw

Video & Imaging

www.ti.com/video

 

 

Wireless

www.ti.com/wireless

Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265

Copyright © 2007, Texas Instruments Incorporated

Preface

About This Book

The intended audience for this document is the Server Integrator, who creates a Codec Server for use by the Engine Integrator and thus the Application Author.

This manual tells what steps the Server Integrator should take to configure DSP/BIOS and other components to create a Codec Server.

Additional Documents and Resources

You can use the following sources to supplement this user’s guide:

Codec Engine API Reference. CE_INSTALL_DIR/docs/html/index.html

Codec Engine SPI Reference Guide. CE_INSTALL_DIR/docs/spi/html/index.html

Configuration Reference. CE_INSTALL_DIR/packages/xdoc/index.html

Example Build and Run Instructions. CE_INSTALL_DIR/examples/build_instructions.html

Codec Engine Application Developer’s Guide (SPRUE67)

Codec Engine Algorithm Creator User’s Guide (SPRUED6)

xDAIS-DM(Digital Media) User Guide(SPRUEC8)

TMS320 DSP Algorithm Standard Rules and Guidelines (SPRU352)

TMS320 DSP Algorithm Standard API Reference (SPRU360)

TMS320 DSP Algorithm Standard Developer’s Guide (SPRU424)

TMS320 DSP Algorithm Standard Demonstration Application

(SPRU361)

XDC User’s Guide and other XDC documents.

XDC_INSTALL_DIR/doc/index.html

iii

Notational Conventions

Notational Conventions

 

 

 

 

 

P

 

 

 

 

S

 

 

 

D

 

 

 

+

 

 

 

P

 

 

 

P

 

 

 

 

G

 

 

 

 

 

This document uses the following conventions:

Program listings, program examples, and interactive displays are shown in a special typeface. Examples use abold version of the special typeface for emphasis; interactive displays use abold version of the special typeface to distinguish commands that you enter from items that the system displays (such as prompts, command output, error messages, etc.).

Square brackets ( [ and ] ) identify an optional parameter. If you use an optional parameter, you specify the information within the brackets. Unless the square brackets are in a bold typeface, do not enter the brackets themselves.

This manual uses an icon like the one to the left to identify information that is specific to a particular type of system. For example, this icon identifies information that applies if you are using Codec Engine on a dual-processorGPP+DSP system.

Trademarks

The Texas Instruments logo and Texas Instruments are registered trademarks of Texas Instruments. Trademarks of Texas Instruments include: TI, DaVinci, XDS, Code Composer, Code Composer Studio, Probe Point, Code Explorer, DSP/BIOS, RTDX, Online DSP Lab, DaVinci, TMS320, TMS320C54x, TMS320C55x, TMS320C62x, TMS320C64x, TMS320C67x, TMS320C5000, and TMS320C6000.

MS-DOS,Windows, and Windows NT are trademarks of Microsoft

Corporation.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Linux is a registered trademark of Linus Torvalds.

Solaris, SunOS, and Java are trademarks or registered trademarks of

Sun Microsystems, Inc.

All other brand, product names, and service names are trademarks or registered trademarks of their respective companies or organizations.

iv

Contents

1 Codec Engine Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1

This chapter introduces the Codec Engine.

1.1 What is the Codec Engine? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21.2 Why Should I UseIt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.3 Where Does the Codec Engine Fit into MyArchitecture? . . . . . . . . . . . . . . . . . . . . . . .1-41.4 What Are the UserRoles? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-61.4.1 AlgorithmCreator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-61.4.2 ServerIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-71.4.3 EngineIntegrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-81.4.4 ApplicationAuthor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-8

1.5 Where Can I Get More Information? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-9

2 Configuring a Codec Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1

This chapter describes how the Server Integrator should configure a Codec Server for use by the Engine Integrator.

2.1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-22.1.1 What is a CodecServer? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-32.1.2 What is the ExecutionFlow? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-32.1.3 What AboutSingle-ProcessorSystems? . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-52.1.4 What Algorithms Can a Codec ServerIntegrate? . . . . . . . . . . . . . . . . . . . . .2-62.1.5 What ExamplesExist? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-62.1.6 What is the ConfigKit?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6

2.2 Creating a Codec Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-72.2.1 Creating aPackage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-72.2.2 Editing the PackageDefinition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-82.2.3 Editing the Codec Server ConfigurationScript. . . . . . . . . . . . . . . . . . . . . . . .2-82.2.4 Editing the DSP/BIOS ConfigurationScript . . . . . . . . . . . . . . . . . . . . . . . . .2-142.2.5 Editing the BuildScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-152.2.6 Editing the Linker CommandFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-162.2.7 Editing the main.cFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-162.2.8 Editing themakefile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-16

2.3 Delivering a Codec Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-162.3.1 Delivering Server Packages for Servers Built withXDC . . . . . . . . . . . . . . .2-17

2.3.2Delivering Server Packages for Servers Built with Configuro-basedmakefiles .2-17

v

-vi