TMS320C55x DSP/BIOS 5.32 Application Programming

2y ago
29 Views
2 Downloads
4.47 MB
599 Pages
Last View : 15d ago
Last Download : 2m ago
Upload by : Kian Swinton
Transcription

TMS320C55x DSP/BIOS 5.32Application Programming Interface(API) Reference GuideLiterature Number: SPRU404NSeptember 2007

IMPORTANT NOTICETexas 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. Customersshould obtain the latest relevant information before placing orders and should verify that such information is current and complete. Allproducts 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 standardwarranty. Testing and other quality control techniques are used to the extent TI deems necessary to support this warranty. Except wheremandated 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 adequatedesign 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 workright, 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 servicesor a warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectualproperty 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 accompaniedby all associated warranties, conditions, limitations, and notices. Reproduction of this information with alteration is an unfair and deceptivebusiness practice. TI is not responsible or liable for such altered documentation. Information of third parties may be subject to additionalrestrictions.Resale of TI products or services with statements different from or beyond the parameters stated by TI for that product or service voidsall express and any implied warranties for the associated TI product or service and is an unfair and deceptive business practice. TI is notresponsible or liable for any such statements.TI products are not authorized for use in safety-critical applications (such as life support) where a failure of the TI product would reasonablybe expected to cause severe personal injury or death, unless officers of the parties have executed an agreement specifically governingsuch use. Buyers represent that they have all necessary expertise in the safety and regulatory ramifications of their applications, andacknowledge and agree that they are solely responsible for all legal, regulatory and safety-related requirements concerning their productsand any use of TI products in such safety-critical applications, notwithstanding any applications-related information or support that maybe provided by TI. Further, Buyers must fully indemnify TI and its representatives against any damages arising out of the use of TI productsin such safety-critical applications.TI products are neither designed nor intended for use in military/aerospace applications or environments unless the TI products arespecifically designated by TI as military-grade or "enhanced plastic." Only products designated by TI as military-grade meet militaryspecifications. Buyers acknowledge and agree that any such use of TI products which TI has not designated as military-grade is solelyat 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 aredesignated 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 ti.comAudiowww.ti.com/audioData andInterfaceinterface.ti.comDigital ilitarywww.ti.com/militaryPower Mgmtpower.ti.comOptical w Power Wirelesswww.ti.com/lpwVideo & Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265Copyright 2007, Texas Instruments Incorporated

This is a draft version printed from file: apipref.fm on 9/27/07PrefaceRead This FirstAbout This ManualDSP/BIOS gives developers of mainstream applications on TexasInstruments TMS320C5000TM DSP devices the ability to develop embeddedreal-time software. DSP/BIOS provides a small firmware real-time library andeasy-to-use tools for real-time tracing and analysis.You should read and become familiar with the TMS320 DSP/BIOS User’sGuide, a companion volume to this API reference guide.Before you read this manual, you may use the Code Composer Studio onlinetutorial and the DSP/BIOS section of the online help to get an overview ofDSP/BIOS. This manual discusses various aspects of DSP/BIOS in depthand assumes that you have at least a basic understanding of DSP/BIOS.Notational ConventionsThis document uses the following conventions: Program listings, program examples, and interactive displays are shownin a special typeface. Examples use a bold version of thespecial typeface for emphasis; interactive displays use a bold versionof the special typeface to distinguish commands that you enter from itemsthat the system displays (such as prompts, command output, errormessages, etc.).Here is a sample program listing:Void copy(HST Obj *input, HST Obj *output){PIP Obj*in, *out;Uns*src, *dst;Unssize;}iii

Related Documentation From Texas Instruments Square brackets ( [ and ] ) identify an optional parameter. If you use anoptional parameter, you specify the information within the brackets.Unless the square brackets are in a bold typeface, do not enter thebrackets themselves.Related Documentation From Texas InstrumentsThe following books describe TMS320 devices and related support tools. Toobtain a copy of any of these TI documents, call the Texas InstrumentsLiterature Response Center at (800) 477-8924. When ordering, pleaseidentify the book by its title and literature number.TMS320 DSP/BIOS User's Guide (literature number SPRU423) provides an overview and description of the DSP/BIOS real-time operating system.TMS320C55x Optimizing C Compiler User’s Guide (literature numberSPRU281) describes the C55x C compiler. This C compiler accepts ANSIstandard C source code and produces TMS320 assembly language sourcecode for the C55x generation of devices.TMS320C55x Programmer's Guide (literature number SPRU376) describesways to optimize C and assembly code for the TMS320C55x DSPs andincludes application program examples.TMS320C55x Code Composer Studio Tutorial Online Help (literature numberSPRH097) introduces the Code Composer Studio integrated developmentenvironment and software tools. Of special interest to DSP/BIOS users arethe Using DSP/BIOS lessons.Related DocumentationYou can use the following books to supplement this reference guide:The C Programming Language (second edition), by Brian W. Kernighanand Dennis M. Ritchie, published by Prentice-Hall, Englewood Cliffs, NewJersey, 1988Programming in C, Kochan, Steve G., Hayden Book CompanyProgramming Embedded Systems in C and C , by Michael Barr, AndyOram (Editor), published by O'Reilly & Associates; ISBN: 1565923545,February 1999Real-Time Systems, by Jane W. S. Liu, published by Prentice Hall; ISBN:013099651, June 2000iv

TrademarksPrinciples of Concurrent and Distributed Programming (Prentice HallInternational Series in Computer Science), by M. Ben-Ari, published byPrentice Hall; ISBN: 013711821X, May 1990American National Standard for Information Systems-ProgrammingLanguage C X3.159-1989, American National Standards Institute (ANSIstandard for C); (out of print)TrademarksMS-DOS, Windows, and Windows NT are trademarks of MicrosoftCorporation.The Texas Instruments logo and Texas Instruments are registeredtrademarks of Texas Instruments. Trademarks of Texas Instruments include:TI, XDS, Code Composer, Code Composer Studio, Probe Point, CodeExplorer, DSP/BIOS, RTDX, Online DSP Lab, BIOSuite, SPOX, TMS320,TMS320C28x, TMS320C54x, TMS320C55x, TMS320C62x, TMS320C64x,TMS320C67x, TMS320C5000, and TMS320C6000.All other brand or product names are trademarks or registered trademarks oftheir respective companies or organizations.Read This Firstv

vi

This is a draft version printed from file: apirefTOC.fm on 9/27/07Contents1API Functional Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-1This chapter provides an overview to the TMS320C55x DSP/BIOS API functions.1.1DSP/BIOS Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21.2Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.3Assembly Language Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.4DSP/BIOS Tconf Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-31.5List of Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-52Application Program Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1This chapter describes the DSP/BIOS API modules and functions.2.1ATM Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-22.2BUF Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-152.3C55 Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-262.4CLK Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-392.5DEV Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-582.6GBL Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1082.7GIO Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1182.8HOOK Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1372.9HST Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1432.10 HWI Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1482.11 IDL Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1722.12 LCK Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1762.13 LOG Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1832.14 MBX Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1952.15 MEM Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2012.16 MSGQ Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2292.17 PIP Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2652.18 POOL Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2852.19 PRD Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2902.20 PWRM Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2982.21 QUE Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3362.22 RTDX Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3532.23 SEM Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3692.24 SIO Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3822.25 STS Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4122.26 SWI Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-422vii

Contents2.272.282.292.30SYS Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .TRC Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .TSK Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .std.h and stdlib.h functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4512-4672-4722-511AFunction Callability and Error Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1This appendix provides tables describing TMS320C55x errors and function callability.A.1Function Callability Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2A.2DSP/BIOS Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11BC55x DSP/BIOS Register Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1This appendix provides tables describing the TMS320C55x register conventions in terms of preservation across multi-threaded context switching and preconditions.B.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2B.2Register Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2B.3Status Register Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-4CDSP/BIOS for OMAP 2320 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1This appendix describes things you need to know about DSP/BIOS in order to use it with theOMAP 2320 platform.C.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2C.2OMAP 2320 and the CLK Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-2C.3OMAP 2320 and the HWI Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-4C.4OMAP 2320 and the C55 Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8C.5Building DSP/BIOS Applications for OMAP 2320 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-8C.6Usage Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-9DDSP/BIOS for OMAP 2420 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1This appendix describes things you need to know about DSP/BIOS in order to use it with theOMAP 2420 platform.D.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2D.2OMAP 2420 and the CLK Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2D.3OMAP 2420 and the HWI Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-5D.4OMAP 2420 and the C55 Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-9D.5Building DSP/BIOS Applications for OMAP 2420 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-9D.6Usage Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-10viii

This is a draft version printed from file: apireflof.fm on YSEG Heap Initial Memory Map . 2-215MYSEG Memory Map After Allocation. 2-216MYSEG Memory Map After Modified Allocation . 2-217Writers and Reader of a Message Queue . 2-232Components of the MSGQ Architecture . 2-233MSGQ Function Calling Sequence . 2-233Pipe Schematic . 2-267Allocators and Message Pools. 2-286Buffer Layout as Defined by STATICPOOL Params . 2-288PRD Tick Cycles . 2-295Statistics Accumulation on the Host. 2-415ix

This is a draft version printed from file: apireflot.fm on 2-11A-1A-2A-3xDSP/BIOS Modules . 1-2DSP/BIOS Operations . 1-5Timer Counter Rates, Targets, and Resets . 2-41High-Resolution Time Determination . 2-42HWI interrupts for the ‘C55x. 2-158Conversion Characters for LOG printf . 2-191Typical Memory Segments for C5000 Boards . 2-213Statistics Units for HWI, PIP, PRD, and SWI Modules . 2-413Conversion Characte

Literature Response Center at (800) 477-8924. When ordering, please identify the book by its title and literature number. TMS320 DSP/BIOS User's Guide (teril ature number SPRU423) provides an over-view and description of the DSP/BIOS real-time operating system. TMS320C

Related Documents:

Component Dsp codec wrapper Component Dsp render. HIFI4 Core. Dsp codecs. SAI/ESAI/DMA DAC. Figure 2. Software architecture for DSP processor The DSP-related code includes the DSP framework, DSP remoteproc driver, DSP wrapper, unit test, DSP codec wrapper, and DSP codec. The DSP framework is a firmware code which runs on the DSP core.

Checks for the latest BIOS release revision on the network, and lets the user decide whether to download the BIOS image and update System. 2. Lock BIOS Version If not selected, then BIOS updates are al-lowed, if selected then updates to BIOS are not allowed. 3. Click on the field to see the options. 4. Allow BIOS Updates Using a Network

– The BIOS stored on the ROM chip attached to the motherboard is called the system BIOS – The ROM chip that stores the system BIOS is called the system ROM BIOS Core Group of Hardware Hardware that is common, necessary and never changes – Keyboard, speaker Stored on the system BIOS chip BIOS is a group of programs.

HP Computer Setup Item Specific Help 1. Check HP.com for BIOS Updates Checks for the latest BIOS release revision on the network, and lets the user decide whether to download the BIOS image and update System. 2. Lock BIOS Version If not selected, then BIOS updates are al-lowed, if selected then updates to BIOS are not allowed. 3.

Linux DSP Tools provides the following foundational target content for DSP development. DSP/BIOS Real time kernel. Configurable, scalable, deterministic task scheduling with API’s for real time analysis. DSP/BIOS Link Program load, memory read write, shared memory channel driver for int

Nov 29, 2013 · Title Chip Mega Man X3/ Rockman X3 CX4 Mega Man X2/ Rockman X2 CX4 Suzuka 8 Hours DSP-1 Super F1 Circus Gaiden DSP-1 Super Bases Loaded 2 / Super 3D Baseball DSP-1 Super Air Diver 2 DSP-1 Shutokō Battle 2: Drift King Keichii Tsuchiya & Masaaki Bandoh DSP-1 Shutokō Battle '94: Keichii Tsuchiya Drift King DSP-1 Pilotwings DSP-1 Mic

BIOS Converter User Guide for X79 series DE 3 BIOS Converter User Guide for X79 series The BIOS Converter is an ASUS-exclusive utility that allows you to convert the BIOS structure from .ROM to .CAP for Windows 8 full-functionality. The BIOS converters only apply to selected X79 series motherboards.

STM32 and ultra‑low‑power. 4 9 product series – more than 40 product lines . proliferation of hardware IPs and higher‑level programming languages greatly facilitates the work of developers. High‑ performance Cortex‑M STM32 F7 Ultra‑ low‑power Mainstream Cortex‑M3 STM32 F2 STM32 L1 STM32 F1 Cortex‑M STM32 F4 STM32 L4 STM32 F3 Cortex‑M M STM32 L0 STM32 F0 STM32 H7 ST .