float/filter_fo.h

Go to the documentation of this file.

/* --COPYRIGHT--,BSD
 * Copyright (c) 2014, Texas Instruments Incorporated
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * *  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * *  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * *  Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * --/COPYRIGHT--*/
#ifndef _FILTER_FO_H_
#define _FILTER_FO_H_



// **************************************************************************
// the includes

#include "sw/modules/types/src/types.h"





#ifdef __cplusplus
extern "C" {
#endif


// **************************************************************************
// the defines


// **************************************************************************
// the typedefs
 
typedef struct _FILTER_FO_Obj_
{    
  float_t  a1;          

  float_t  b0;          
  float_t  b1;          

  float_t  x1;          

  float_t  y1;          
} FILTER_FO_Obj;


typedef struct _FILTER_FO_Obj_ *FILTER_FO_Handle;
                                                         

// **************************************************************************
// the globals


// **************************************************************************
// the globals


// **************************************************************************
// the function prototypes


static inline float_t FILTER_FO_get_a1(FILTER_FO_Handle handle)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  return(obj->a1);
} // end of FILTER_FO_get_a1() function


static inline float_t FILTER_FO_get_b0(FILTER_FO_Handle handle)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  return(obj->b0);
} // end of FILTER_FO_get_b0() function


static inline float_t FILTER_FO_get_b1(FILTER_FO_Handle handle)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  return(obj->b1);
} // end of FILTER_FO_get_b1() function


static inline float_t FILTER_FO_get_x1(FILTER_FO_Handle handle)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  return(obj->x1);
} // end of FILTER_FO_get_x1() function


static inline float_t FILTER_FO_get_y1(FILTER_FO_Handle handle)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  return(obj->y1);
} // end of FILTER_FO_get_y1() function


extern void FILTER_FO_getDenCoeffs(FILTER_FO_Handle handle,float_t *pa1);


extern void FILTER_FO_getInitialConditions(FILTER_FO_Handle handle,float_t *px1,float_t *py1);


extern void FILTER_FO_getNumCoeffs(FILTER_FO_Handle handle,float_t *pb0,float_t *pb1);


extern FILTER_FO_Handle FILTER_FO_init(void *pMemory,const size_t numBytes);


#ifdef __TMS320C28XX_CLA__
#pragma FUNC_ALWAYS_INLINE(FILTER_FO_run)
#endif
static inline float_t FILTER_FO_run(FILTER_FO_Handle handle,const float_t inputValue)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  float_t a1 = obj->a1;
  float_t b0 = obj->b0;
  float_t b1 = obj->b1;
  float_t x1 = obj->x1;
  float_t y1 = obj->y1;


  // compute the output
  float_t y0 = (b0 * inputValue) + (b1 * x1) - (a1 * y1);


  // store values for next time
  obj->x1 = inputValue;
  obj->y1 = y0;

  return(y0);
} // end of FILTER_FO_run() function


static inline float_t FILTER_FO_run_form_0(FILTER_FO_Handle handle,const float_t inputValue)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  float_t a1 = obj->a1;
  float_t b0 = obj->b0;
  float_t y1 = obj->y1;


  // compute the output
  float_t y0 = (b0 * inputValue) - (a1 * y1);


  // store values for next time
  obj->y1 = y0;

  return(y0);
} // end of FILTER_FO_run_form_0() function


static inline void FILTER_FO_set_a1(FILTER_FO_Handle handle,const float_t a1)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  obj->a1 = a1;

  return;
} // end of FILTER_FO_set_a1() function


static inline void FILTER_FO_set_b0(FILTER_FO_Handle handle,const float_t b0)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  obj->b0 = b0;

  return;
} // end of FILTER_FO_set_b0() function


static inline void FILTER_FO_set_b1(FILTER_FO_Handle handle,const float_t b1)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  obj->b1 = b1;

  return;
} // end of FILTER_FO_set_b1() function


static inline void FILTER_FO_set_x1(FILTER_FO_Handle handle,const float_t x1)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  obj->x1 = x1;

  return;
} // end of FILTER_FO_set_x1() function


static inline void FILTER_FO_set_y1(FILTER_FO_Handle handle,const float_t y1)
{
  FILTER_FO_Obj *obj = (FILTER_FO_Obj *)handle;

  obj->y1 = y1;

  return;
} // end of FILTER_FO_set_y1() function


extern void FILTER_FO_setDenCoeffs(FILTER_FO_Handle handle,const float_t a1);


extern void FILTER_FO_setInitialConditions(FILTER_FO_Handle handle,const float_t x1,const float_t y1);


extern void FILTER_FO_setNumCoeffs(FILTER_FO_Handle handle,const float_t b0,const float_t b1);


#ifdef __cplusplus
}
#endif // extern "C"

#endif // end of _FILTER_FO_H_ definition