2.0. C/C++ Compiler and Library. Manual for ADSP-21xxx DSPs. Third Revision, September, Part Number

Transcription

1 2.0 C/C++ Compiler and Library Manual for ADSP-21xxx DSPs Third Revision, September, 2001 Analog Devices, Inc. Digital Signal Processor Division One Technology Way Norwood, Mass Part Number

2 Copyright Information Analog Devices, Inc., ALL RIGHTS RESERVED. This document may not be reproduced in any form without prior, express written consent from Analog Devices, Inc. Printed in the USA. Disclaimer Analog Devices, Inc. reserves the right to change this product without prior notice. Information furnished by Analog Devices is believed to be accurate and reliable. However, no responsibility is assumed by Analog Devices for its use; nor for any infringement of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under the patent rights of Analog Devices, Inc. Trademark and Service Mark Notice he Analog Devices logo, VisualDSP, the VisualDSP logo, SHARC, and the SHARC logo are registered trademarks; VisualDSP++, the VisualDSP++ logo, and EZ-KIT Lite are trademarks of Analog Devices, Inc. Adobe and Acrobat are registered trademarks of Adobe Corporation. Intel is registered trademark of Intel Corporation. Microsoft and Windows are registered trademarks and Windows NT is a trademark of Microsoft Corporation. All other brand and product names are trademarks or service marks of their respective owners. Rev. 3.0

3 INTRODUCTION Supported Processors For Additional Product Information For Technical or Customer Support Purpose of This Manual Intended Audience Manual Contents Description What s New in This Manual Related Documents Conventions COMPILER Overview Compiler Command-Line Interface Running the Compiler C/C++ Compiler Switches C/C++ Compiler Switch Summaries C/C++ Mode Selection Switch Descriptions iii

4 C/C++ Compiler Common Switch Descriptions C++ Mode Compiler Switch Descriptions Data Type Sizes Integer Floating Point Optimization Control Inlining Control Interprocedural Analysis C/C++ Compiler Language Extensions Inline Function Support Keyword (inline) Inline Assembly Language Support Keyword (asm) Assembly Construct Template Assembly Construct Operand Description Assembly Constructs With Multiple Instructions Assembly Construct Reordering and Optimization Restrictions on the Use of the asm Construct Assembly Constructs with Input and Output Operands Assembly Constructs and Macros Dual Memory Support Keywords (pm dm) Memory Keywords and Assignments/Type Conversions Memory Keywords and Function Declarations/Pointers Memory Keywords and Function Arguments Memory Keywords and Macros Placement Support Keyword (section) iv

5 Boolean Type Support Keywords (bool, true, false) Pointer Class Support Keyword (restrict) Variable-Length Array Support Non-Constant Initializer Support Indexed Initializer Support Aggregate Constructor Expression Support Preprocessor Generated Warnings C++ Style Comments Compiler intrinsic Functions Access to System Registers C++ Fractional Type Support Format of Fractional Literals Conversions Involving Fractional Values Fractional Arithmetic Operations Mixed Mode Operations Saturated Arithmetic SIMD Support Annotation (#pragma SIMD_for) Using SIMD Mode with Multichannel Data Using SIMD Mode with Single Channel Data Pitfalls in Using SIMD C/C SIMD_for Syntax Constraints on Using SIMD C/C Impact of Anomaly #40 on SIMD Examples Using SIMD C (Problem Cases Data Increments) v

6 Examples Using SIMD C (Problem Cases Data Alignment) Performance When Using SIMD C/C Preprocessing a Program Predefined Macros Header Files Writing Macros Support for Multiple Heaps Heap Identifiers Using Alternate Heaps with the Standard Interface Using the Alternate Heap Interface Re-initializing Heaps Creating Heap Descriptor Records Allocating Heap Storage Areas Initializing Heaps Example C program C/C++ Run-Time Model C/C++ Run-Time Environment Memory Usage Compiler Registers User Registers Call Preserved Registers Scratch Registers Stack Registers Alternate Registers vi

7 Managing the Stack Transferring Function Arguments and Return Value Using Data Storage Formats Using the Run-Time Header C/C++ and Assembly Interface Calling Assembly Language Subroutines from C/C++ Programs Calling C/C++ Functions from Assembly Language Programs Using Mixed C/C++ and Assembly Support Macros Interface Support Macros, Defined Using Mixed C/C++ and Assembly Naming Conventions Implementing C++ Member Functions in Assembly Writing C/C++ Callable SIMD Subroutines C++ Programming Examples Using Fract Support Using Complex Support Mixed C/C++/Assembly Programming Examples Using Inline Assembly (Add) Using Macros to Manage the Stack Using Scratch Registers (Dot Product) Using Void Functions (Delay) Using the Stack for Arguments and Return (Add 5) Using Registers for Arguments and Return (Add 2) vii

8 Using Non-leaf Routines That Make Calls (RMS) Using Call Preserved Registers (Pass Array) C/C++ Compiler Glossary C/C++ RUN-TIME LIBRARY Overview C and C++ Run-Time Libraries Guide Calling Library Functions Linking Library Functions Working with Library Header Files Standard C Library Header Files Standard C Library Header File Descriptions Using the Compiler s Built-In C library Functions Abridged C++ Library Support Embedded C++ Library Header Files C++ Header Files for C Library Facilities Embedded Standard Template Library Header Files C Run-Time Library Reference abort abs acos, acosf asin, asinf atan, atanf atan2, atan2f atexit viii

9 atof atoi atol avg bsearch calloc ceil, ceilf clear_interrupt clip cos, cosf cosh, coshf div exit exp, expf fabs, fabsf floor, floorf fmod, fmodf free frexp, frexpf getenv heap_calloc heap_free heap_init heap_lookup ix

10 heap_malloc heap_realloc heap_switch interrupt isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs lavg lclip ldexp, ldexpf ldiv lmax lmin localeconv log, logf x

11 log10, log10f longjmp malloc max memchr memcmp memcpy memmove memset min modf, modff pow, powf qsort raise rand realloc setjmp setlocale signal sin, sinf sinh, sinhf sqrt, sqrtf srand strcat xi

12 strchr strcmp strcoll strcpy strcspn strerror strlen strncat strncmp strncpy strpbrk strrchr strspn strstr strtod strtok strtol strtoul strxfrm system tan, tanf tanh, tanhf tolower toupper xii

13 va_arg va_end va_start DSP LIBRARY FOR ADSP-2106X PROCESSORS Overview DSP Run-Time Library Guide Linking DSP Library Functions Working With Library Source Code DSP Header Files Built-In DSP Functions DSP Run-Time Library Reference a_compress a_expand autocoh autocorr biquad cabsf cexpf cfftn copysign, copysignf cot, cotf crosscoh crosscorr favg, favgf xiii

14 fclip, fclipf fir fmax, fmaxf fmin, fminf gen_bartlett gen_blackman gen_gaussian gen_hamming gen_hanning gen_harris gen_kaiser gen_rectangular gen_triangle histogram idle ifftn iir matadd matmul matscalmult matsub mean mu_compress mu_expand xiv

15 poll_flag_in rfftn rms rsqrt, rsqrtf set_flag set_semaphore timer_off timer0_off, timer1_off timer_on timer0_on, timer1_on timer_set timer0_set, timer1_set var zero_cross DSP LIBRARY FOR ADSP-2116X PROCESSORS Overview DSP Run-Time Library Guide Linking DSP Library Functions Working With Library Source Code DSP Header Files Built-In DSP Functions Pitfalls Using SIMD Mode DSP Run-Time Library Reference a_compress xv

16 a_expand autocoh autocorr cabsf cexpf cfftn copysign, copysignf cot, cotf crosscoh crosscorr cvecdot cvecsadd cvecsmlt cvecssub cvecvadd cvecvmlt cvecvsub favg, favgf fclip, fclipf fft_mag fir fmax, fmaxf fmin, fminf gen_bartlett xvi

17 gen_blackman gen_gaussian gen_hamming gen_hanning gen_harris gen_kaiser gen_rectangular gen_triangle histogram idle ifftn iir matadd matmul matscalmult matsub mean mu_compress mu_expand poll_flag_in rfftn rfft2_n rms rsqrt, rsqrtf xvii

18 INDEX set_flag set_semaphore timer_off timer_on timer_set var vecdot vecsadd vecsmlt vecssub vecvadd vecvmlt vecvsub zero_cross xviii