User’s Manual, V 1.2, Jan. 2001 TriLib A DSP Library for TriCoreTM IP Cores Never stop thinking. Edition 2000-01 Published by Infineon Technologies AG, St.-Martin-Strasse 53, D-81541 München, Germany © Infineon Technologies AG 2002. All Rights Reserved. Attention please! The information herein is given to describe certain components and shall not be considered as warranted characteristics. Terms of delivery and rights to technical change reserved. We hereby disclaim any and all warranties, including but not limited to warranties of non-infringement, regarding circuits, descriptions and charts stated herein. Infineon Technologies is an approved CECC manufacturer. Information For further information on technology, delivery terms and conditions and prices please contact your nearest Infineon Technologies Office in Germany or our Infineon Technologies Representatives worldwide (see address list). Warnings Due to technical requirements components may contain dangerous substances. For information on the types in question please contact your nearest Infineon Technologies Office. Infineon Technologies Components may only be used in life-support devices or systems with the express written approval of Infineon Technologies, if a failure of such components can reasonably be expected to cause the failure of that life-support device or system, or to affect the safety or effectiveness of that device or system. Life support devices or systems are intended to be implanted in the human body, or to support and/or maintain and sustain and/or protect human life. If they fail, it is reasonable to assume that the health of the user or other persons may be endangered. User’s Manual, V 1.1, Sept. 2000 TriLib A DSP Library for TriCoreTM Never stop thinking. TriLib Revision History: 2000-01 V 1.2 Previous Version: - V 1.1 Page Subjects (major changes since last revision) New functions (Mathematical, Statistical, FFT) Current Version - V 1.2 All the functions are ported to GNU Compiler New functions (Random number, Mixed Adaptive, Mixed FFT, Multirate FIR) Page 407 Applications GUI on the host side to provide the visual control for two embedded target applications Page 425 FAQs Page 435 Appendix Page 459 Glossary We Listen to Your Comments Any information within this document that you feel is wrong, unclear or missing at all? Your feedback will help us to continuously improve the quality of this document. Please send your proposal (including a reference to this document) to: [email protected] "Microcontrollers" Template for Technical Documentation 1 Introduction . 15 1.1 Introduction to TriLib, a DSP Library for TriCore . 15 1.2 Features . 15 1.3 Future of the TriLib . 16 1.4 Support Information . 16 2 Installation and Build . 17 2.1 TriLib Content . 17 2.2 Installing TriLib . 18 2.3 Building TriLib . 18 2.4 Source Files List . 19 3 DSP Library Notations . 23 3.1 TriLib Data Types . 23 3.2 Calling a DSP Library Function from C Code . 23 3.3 Calling a DSP Library Function from Assembly Code . 23 3.4 TriLib Example Implementation . 23 3.5 TriLib Implementation - A Technical Note . 24 4 Function Descriptions . 29 4.1 Conventions . 29 4.2 Complex Arithmetic Functions . 31 Addition . 32 Subtraction . 32 Multiplication . 32 Conjugate . 33 Magnitude . 33 Phase . 33 Shift . 33 4.3 Vector Arithmetic Functions . 85 4.4 FIR Filters . 106 4.5 IIR Filters . 173 4.6 Adaptive Digital Filters . 197 4.7 Fast Fourier Transforms . 241 4.8 TriCore Implementation Note . 248 First Stage . 250 Butterfly Loop . 251 Method adapted in the TriLib FFT implementation . 254 Group Loop . 254 Stage Loop . 254 Post Processing . 254 Important Note: . 259 4.9 Discrete Cosine Transform (DCT) . 309 4.10 Inverse Discrete Cosine Transform (IDCT) . 314 User’s Manual 5 V 1.1, 2000-01 "Microcontrollers" Template for Technical Documentation 4.11 Multidimensional DCT (General Information) . 315 4.12 Mathematical Functions . 329 4.13 Matrix Operations . 363 4.14 Statistical Functions . 379 5 Applications . 401 5.1 Spectrum Analyzer . 401 A simple example showing functioning of Spectrum Analyzer. 401 5.2 Sweep Oscillator . 404 5.3 Equalizer . 406 5.4 Hardware Setup for Applications . 408 6 References . 417 7 Frequently Asked Questions . 419 7.1 FIR Basics . 419 Linear Phase . 420 Frequency Response . 421 Numeric Properties . 422 7.2 IIR Basics . 424 7.3 FFT . 425 8 Appendix . 429 8.1 Introduction . 429 8.2 File Organization . 430 8.3 Coding Rules and Conventions for ’C’ and ’C++’ . 433 8.4 Coding Rules and Conventions for Assembly Language . 436 8.5 Testing . 444 8.6 Compiler Support . 445 9 Glossary . 453 User’s Manual 6 V 1.1, 2000-01 "Microcontrollers" Template for Technical Documentation Table 2-1 Directory Structure . 17 Table 2-2 Source files . 19 Table 3-1 TriLib Data Types. 23 Table 3-2 FIR Filter Implementations. 25 Table 3-3 Compiler Selection. 26 Table 3-4 Tasking Special Data Types . 26 Table 3-5 GHS Special Data Types . ..