mfr.h

用freescale公司的DSP56F8013芯片实现的PMSM的SVPWM 驱动

**
**     Description :
**         The L_shr_r function arithmetically shifts the input
**         variable x right n positions, sign extending the result.
**         If n is negative, the L_shr_r function arithmetically
**         shifts x left by -n bits, zero filling the least
**         significant bits. L_shr_r differs from L_shr in that
**         L_shr_r rounds the 32-bit fractional result.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The input data value.
**         n               - The number of bits to right shift x; n is
**                           signed and, if negative, implies a right
**                           shift.
**     Returns     :
**         ---             - The function returns the value x
**                           arithmetically shifted by n bits.
** ===================================================================
*/

//Frac32 MFR_L_deposit_h(Frac16 x);
/*
** ===================================================================
**     Method      :  MFR_L_deposit_h (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_deposit_h"
**
**     Description :
**         The L_deposit_h function places a 16-bit fractional value
**         into the most significant 16-bits of the 32-bit
**         fractional output value and zeroes the least significant
**         16 bits.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The input data value.
**     Returns     :
**         ---             - The function returns a 32-bit
**                           fractional value.
** ===================================================================
*/

//Frac32 MFR_L_deposit_l(Frac16 x);
/*
** ===================================================================
**     Method      :  MFR_L_deposit_l (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_deposit_l"
**
**     Description :
**         The L_deposit_l function places a 16-bit fractional value
**         into the least significant 16 bits of the 32-bit
**         fractional output value and sign extends the most
**         significant 16 bits.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The input data value.
**     Returns     :
**         ---             - The function returns a 32-bit
**                           fractional value.
** ===================================================================
*/

//Frac16 MFR_extract_l(Frac32 x);
/*
** ===================================================================
**     Method      :  MFR_extract_l (bean DSP_Func_MFR)
**
**     This method can be used also under name "extract_l"
**
**     Description :
**         The extract_l function extracts the least significant 16
**         bits from the 32-bit fractional value.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The input data value.
**     Returns     :
**         ---             - The extract_l function returns the
**                           extracted value as a 16-bit fractional
**                           number.
** ===================================================================
*/

//Frac16 MFR_extract_h(Frac32 x);
/*
** ===================================================================
**     Method      :  MFR_extract_h (bean DSP_Func_MFR)
**
**     This method can be used also under name "extract_h"
**
**     Description :
**         The extract_h function extracts the most significant 16
**         bits from the 32-bit fractional value.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The input data value.
**     Returns     :
**         ---             - The extract_h function returns the
**                           extracted value as a 16-bit fractional
**                           number.
** ===================================================================
*/

//Frac16 MFR_mac_r(Frac32 w,Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_mac_r (bean DSP_Func_MFR)
**
**     This method can be used also under name "mac_r"
**
**     Description :
**         The mac function multiplies two 16-bit fractional input
**         values (x * y) and adds the 32-bit result to w.
**     Parameters  :
**         NAME            - DESCRIPTION
**         w               - The input value used with the addition.
**         x               - The first input data value for the
**                           multiplication.
**         y               - The second input data value for the
**                           multiplication.
**     Returns     :
**         ---             - The function returns the result of the
**                           calculation (x * y) + w.
** ===================================================================
*/

//Frac16 MFR_msu_r(Frac32 w,Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_msu_r (bean DSP_Func_MFR)
**
**     This method can be used also under name "msu_r"
**
**     Description :
**         The msu function multiplies x by y and subtracts the
**         32-bit result from w.
**     Parameters  :
**         NAME            - DESCRIPTION
**         w               - The input value used with the
**                           subtraction.
**         x               - The first input data value for the
**                           addition.
**         y               - The second input data value for the
**                           addition.
**     Returns     :
**         ---             - The function returns the result of the
**                           calculation w - (x + y).
** ===================================================================
*/

//Frac16 MFR_mult(Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_mult (bean DSP_Func_MFR)
**
**     This method can be used also under name "mult"
**
**     Description :
**         This multiplication function multiply two fractional
**         input values and return the result.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The first input data value.
**         y               - The second input data value.
**     Returns     :
**         ---             - The mult function returns returns the
**                           result of the fractional multiplication.
** ===================================================================
*/

//Frac16 MFR_mult_r(Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_mult_r (bean DSP_Func_MFR)
**
**     This method can be used also under name "mult_r"
**
**     Description :
**         This multiplication function multiply two fractional
**         input values and return the result. The function differs
**         from mult in that function rounds the result, whereas
**         mult truncates the result to 16bits.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The first input data value.
**         y               - The second input data value.
**     Returns     :
**         ---             - The mult function returns returns the
**                           result of the fractional multiplication.
** ===================================================================
*/

//Frac32 MFR_L_mac(Frac32 w,Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_L_mac (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_mac"
**
**     Description :
**         The mac function multiplies two 16-bit fractional input
**         values (x * y) and adds the 32-bit result to w.
**     Parameters  :
**         NAME            - DESCRIPTION
**         w               - The input value used with the addition.
**         x               - The first input data value for the
**                           multiplication.
**         y               - The second input data value for the
**                           multiplication.
**     Returns     :
**         ---             - The function returns the result of the
**                           calculation (x * y) + w.
** ===================================================================
*/

//Frac32 MFR_L_msu(Frac32 w,Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_L_msu (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_msu"
**
**     Description :
**         The msu function multiplies x by y and subtracts the
**         32-bit result from w.
**     Parameters  :
**         NAME            - DESCRIPTION
**         w               - The input value used with the addition.
**         x               - The first input data value for the
**                           addition.
**         y               - The second input data value for the
**                           addition.
**     Returns     :
**         ---             - The function returns the result of the
**                           calculation w - (x + y).
** ===================================================================
*/

//Frac32 MFR_L_mult(Frac16 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_L_mult (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_mult"
**
**     Description :
**         This multiplication function multiply two fractional
**         input values and return the result.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The first input data value.
**         y               - The second input data value.
**     Returns     :
**         ---             - The mult function returns returns the
**                           result of the fractional multiplication.
** ===================================================================
*/

//Frac32 MFR_L_mult_ls(Frac32 x,Frac16 y);
/*
** ===================================================================
**     Method      :  MFR_L_mult_ls (bean DSP_Func_MFR)
**
**     This method can be used also under name "L_mult_ls"
**
**     Description :
**         This multiplication function multiply two fractional
**         input values and return the result. The function differs
**         from mult in that function rounds the result, whereas
**         mult truncates the result to 16bits.
**     Parameters  :
**         NAME            - DESCRIPTION
**         x               - The first input data value.
**         y               - The second input data value.
**     Returns     :
**         ---             - The mult function returns returns the
**                           result of the fractional multiplication.