32b/traj.h

Go to the documentation of this file.

/* --COPYRIGHT--,BSD
 * Copyright (c) 2012, 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 _TRAJ_H_
#define _TRAJ_H_



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

#include "sw/modules/types/src/types.h"
#include "sw/modules/iqmath/src/32b/IQmathLib.h"



// Include the algorithm overview defined in modules/<module>/docs/doxygen/doxygen.h

#ifdef __cplusplus
extern "C" {
#endif


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

typedef struct _TRAJ_Obj_
{
  _iq   targetValue;   
  _iq   intValue;      
  _iq   minValue;      
  _iq   maxValue;      
  _iq   maxDelta;      
} TRAJ_Obj;


typedef struct _TRAJ_Obj_ *TRAJ_Handle;


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


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

static inline _iq TRAJ_getIntValue(TRAJ_Handle handle)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  return(obj->intValue);
} // end of TRAJ_getIntValue() function


static inline _iq TRAJ_getMaxDelta(TRAJ_Handle handle)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  return(obj->maxDelta);
} // end of TRAJ_getMaxDelta() function


static inline _iq TRAJ_getMaxValue(TRAJ_Handle handle)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  return(obj->maxValue);
} // end of TRAJ_getMaxValue() function


static inline _iq TRAJ_getMinValue(TRAJ_Handle handle)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  return(obj->minValue);
} // end of TRAJ_getMinValue() function


static inline _iq TRAJ_getTargetValue(TRAJ_Handle handle)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  return(obj->targetValue);
} // end of TRAJ_getTargetValue() function


extern TRAJ_Handle TRAJ_init(void *pMemory,const size_t numBytes);


static inline void TRAJ_setIntValue(TRAJ_Handle handle,const _iq intValue)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  obj->intValue = intValue;

  return;
} // end of TRAJ_setIntValue() function


static inline void TRAJ_setMaxDelta(TRAJ_Handle handle,const _iq maxDelta)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  obj->maxDelta = maxDelta;

  return;
} // end of TRAJ_setMaxDelta() function


static inline void TRAJ_setMaxValue(TRAJ_Handle handle,const _iq maxValue)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  obj->maxValue = maxValue;

  return;
} // end of TRAJ_setMaxValue() function


static inline void TRAJ_setMinValue(TRAJ_Handle handle,const _iq minValue)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  obj->minValue = minValue;

  return;
} // end of TRAJ_setMinValue() function


static inline void TRAJ_setTargetValue(TRAJ_Handle handle,const _iq targetValue)
{
  TRAJ_Obj *obj = (TRAJ_Obj *)handle;

  obj->targetValue = targetValue;

  return;
} // end of TRAJ_setTargetValue() function


static inline void TRAJ_run(TRAJ_Handle handle)
{
  _iq targetValue = TRAJ_getTargetValue(handle);
  _iq intValue = TRAJ_getIntValue(handle);
  _iq error = targetValue - intValue;
  _iq maxDelta = TRAJ_getMaxDelta(handle);
  _iq minValue = TRAJ_getMinValue(handle);
  _iq maxValue = TRAJ_getMaxValue(handle);

    // increment the value
    intValue += _IQsat(error,maxDelta,-maxDelta);

    // bound the value
    intValue = _IQsat(intValue,maxValue,minValue);

  // store the value
  TRAJ_setIntValue(handle,intValue);

  return;
} // end of TRAJ_run() function


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

#endif // end of _TRAJ_H_ definition