d5344646bb6ae05415323a9b12d7fd56d4d487e2
[ep-processor-libraries/dsplib.git] / ti / dsplib / src / DSPF_sp_iir / c66 / DSPF_sp_iir.h
1 /* ======================================================================= */
2 /* DSPF_sp_iir.h -- IIR Filter                                             */
3 /*              Optimized C Implementation (w/ Intrinsics)                 */
4 /*                                                                         */
5 /* Rev 0.0.1                                                               */
6 /*                                                                         */
7 /* Copyright (C) 2011 Texas Instruments Incorporated - http://www.ti.com/  */ 
8 /*                                                                         */
9 /*                                                                         */
10 /*  Redistribution and use in source and binary forms, with or without     */
11 /*  modification, are permitted provided that the following conditions     */
12 /*  are met:                                                               */
13 /*                                                                         */
14 /*    Redistributions of source code must retain the above copyright       */
15 /*    notice, this list of conditions and the following disclaimer.        */
16 /*                                                                         */
17 /*    Redistributions in binary form must reproduce the above copyright    */
18 /*    notice, this list of conditions and the following disclaimer in the  */
19 /*    documentation and/or other materials provided with the               */
20 /*    distribution.                                                        */
21 /*                                                                         */
22 /*    Neither the name of Texas Instruments Incorporated nor the names of  */
23 /*    its contributors may be used to endorse or promote products derived  */
24 /*    from this software without specific prior written permission.        */
25 /*                                                                         */
26 /*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS    */
27 /*  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT      */
28 /*  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR  */
29 /*  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT   */
30 /*  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,  */
31 /*  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT       */
32 /*  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,  */
33 /*  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY  */
34 /*  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT    */
35 /*  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE  */
36 /*  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.   */
37 /*                                                                         */
38 /* ======================================================================= */
40 #ifndef DSPF_SP_IIR_H_
41 #define DSPF_SP_IIR_H_
43 #ifndef __TI_COMPILER_VERSION__           // for non TI compiler
44 #include "assert.h"                       // intrinsics prototypes
45 #include "C6xSimulator.h"                 // intrinsics prototypes
46 #include "C6xSimulator_type_modifiers.h"  // define/undefine typing keywords
47 #endif
49 /** @ingroup FILTCONV */
50 /* @{ */
52 /** @defgroup  DSPF_sp_iir */
53 /** @ingroup DSPF_sp_iir */
54 /* @{ */
56 /**
57  *   The IIR performs an auto-regressive moving-average (ARMA) filter with 4
58  *   auto-regressive filter coefficients and 5 moving-average filter coefficients
59  *   for nr output samples. The output vector is stored in two locations. This
60  *   routine is used as a high pass filter in the VSELP vocoder. The 4 values 
61  *   in the r1 vector store the initial values of the delays.
62  *                                                                           
63  *     @param y1[nr+4]  Delay element values (i/p and o/p).
64  *     @param x[nr]     Pointer to the input array.
65  *     @param y2[nr+4]  Pointer to the output array.
66  *     @param hb[5]     Auto-regressive filter coefficients.
67  *     @param ha[5]     Moving average filter coefficients.
68  *     @param nr        Number of output samples.
69  *
70  * @par Algorithm:
71  * DSPF_sp_iir_cn.c is the natural C equivalent of the optimized
72  * linear assembly code without restrictions. Note that the linear
73  * assembly code is optimized and restrictions may apply.  
74  * 
75  * @par Assumptions:
76  *    The value of \91nr\92 must be a multiple of 2. <BR>
77  *    Extraneous loads are allowed in the program. <BR>
78  *
79  * @par Implementation Notes:
80  * @b Interruptibility: The code is interruptible.
81  * @b Endian Support: The code supports both big and little endian modes. 
82  *
83  */
85 void DSPF_sp_iir (float* restrict y1,
86     const float* x,
87     float* restrict y2,
88     const float* hb,
89     const float* ha,
90     int nr);
92 #endif /* DSPF_SP_IIR_H_ */
94 /* ======================================================================= */
95 /*  End of file:  DSPF_sp_iir.h                                            */
96 /* ----------------------------------------------------------------------- */
97 /*            Copyright (c) 2011 Texas Instruments, Incorporated.          */
98 /*                           All Rights Reserved.                          */
99 /* ======================================================================= */