Core Run-Time APIs | Texas Instruments TMS320 DSP instruction

Appendix B

SPRU352G – June 2005 – Revised February 2007

Core Run-Time APIs

This appendix enumerates all acceptable core run-time APIs that may be referenced by an eXpressDSP-compliant algorithm.

Topic		Page
B.1	TI C-Language Run-Time Support Library	82
B.2	DSP/BIOS Run-time Support Library	82

SPRU352G –June 2005 –Revised February 2007

Core Run-Time APIs

81

Submit Documentation Feedback

Image 81

Texas Instruments TMS320 DSP manual Core Run-Time APIs, DSP/BIOS Run-time Support Library

Contents

Rules and Guidelines Users Guide Submit Documentation Feedback Contents Use of the DMA Resource Urls List of Figures Read This First Intended AudienceDocument Overview Text Conventions Related DocumentationRule n Guideline n Overview Rules for TMS320C5x Rules for TMS320C6x Scope of the Standard Requirements of the Standard Rules and Guidelines Intentional Omissions Goals of the Standard Frameworks System Architecture Core Run-Time Support Algorithms General Programming Guidelines Threads and Reentrancy Use of C LanguageThreads Rule Reentrancy Preemptive vs. Non-Preemptive Multitasking Example Data Memory Data Memory Scratch versus Persistent Memory Spaces Scratch vs Persistent Memory Allocation Guideline Algorithm versus Application Program Memory ROM-abilitySection Name Purpose Use of Peripherals Use of Peripherals Interfaces and Modules Algorithms Packaging Algorithm Component Model Implementation Fir.h Interfaces and Modules External Identifiers Naming Conventions Module Initialization and FinalizationModule Instance Objects Run-Time Object Creation and Deletion Design-Time Object Creation Example Module Module Configuration Multiple Interface Support Summary Interface InheritanceElement Description Required Algorithms Algorithms Object Code Packaging Debug Verses Release Header Files Moduleversvendorvariant.1arch Data Memory Program Memory Interrupt Latency Execution Time Algorithm Performance Characterization Heap Memory ExternalSize Static Local and Global Data Memory Stack Memory Data Bss Object files Size Execution Time Interrupt LatencyMips Is Not Enough Operation Execution Timeline for Two Periodic Tasks Execution Time Model Process 19800059000 198000 Submit Documentation Feedback DSP-Specific Guidelines Register Types CPU Register Types TMS320C6xxx Rules and Guidelines Use of Floating PointEndian Byte Ordering Data Models Status Register Register ConventionsRegister Use Type CSR Field Use Type Interrupt Latency TMS320C54xx Rules and GuidelinesProgram Models TMS320C54xx Rules and Guidelines Status Registers ST0 Field Name Use TypeST1 Field Name Use Type TMS320C55x Rules and Guidelines Stack ArchitecturePmst Field Name Use Type Example Relocatability SSP Status Bits ST2 Field Name Use TypeST3 Field Name Use Type Homy General TMS320C24xx Guidelines TMS320C28x Rules and Guidelines TMS320C28x Rules and Guidelines XAR0 M0M1MAP Submitting DMA Transfer Requests Use of the DMA Resource Algorithm and Framework Overview Logical Channel Requirements for the Use of the DMA Resource Data Transfer Synchronization Data Transfer Properties Abstract Interface DMA GuidelineDMA Rule Resource Characterization Data Transfers bytes FrequencyAverage Maximum Strong Ordering of DMA Transfer Requests Runtime APIs Device Independent DMA Optimization Guideline Submitting DMA Transfer Requests 13 C6xxx Specific DMA Rules and Guidelines Cache Coherency Issues for Algorithm Producers 14 C55x Specific DMA Rules and Guidelines Supporting Packed/Burst Mode DMA Transfers Addressing Automatic Endianism Conversion Issues Minimizing Logical Channel Reconfiguration OverheadInter-Algorithm Synchronization Non-Preemptive System Preemptive System Algorithm B Algorithm a Inter-Algorithm Synchronization Appendix a General Rules DMA Rules Performance Characterization Rules General Guidelines DMA Guidelines Submit Documentation Feedback Core Run-Time APIs DSP/BIOS Run-time Support Library TI C-Language Run-Time Support Library DSP/BIOS Run-time Support Library Books Bibliography Submit Documentation Feedback Glossary of Terms Glossary Glossary of Terms Glossary of Terms Important Notice