Embedded Software and Motor Control Libraries for PXR40xx

Function MLIB_MulSat_F32
Equation MLIB_MulSat_Eq1
Fractional multiplication of two fractional 32-bit values. The input values as well as
output value are considered as 32-bit fractional data type. The output saturation is
implemented in this function, thus in case the multiplication of input values is outside the
(-1, 1) interval, the output value is limited to the boundary value.
Note
Overflow is detected. The functions saturates the return value if
it cannot fit into the return type.
4.153.5 Re-entrancy
The function is re-entrant.
4.153.6 Code Example
#include "mlib.h"
tFrac32 f32In1;
tFrac32 f32In2;
tFrac32 f32Out;
void main(void)
{
// first input = 0.8
f32In1 = FRAC32 (0.8);
}
// second input = 0.75
f32In2 = FRAC32 (0.75);
// output should be 0x4ccccccc = FRAC32(0.6)
f32Out = MLIB_MulSat_F32(f32In1,f32In2);
// output should be 0x4ccccccc = FRAC32(0.6)
f32Out = MLIB_MulSat (f32In1,f32In2,Define F32);
// ##############################################################
// Available only if 32-bit fractional implementation selected
// as default
// ##############################################################
// output should be 0x4ccccccc = FRAC32(0.6)
f32Out = MLIB_MulSat (f32In1,f32In2);
The output of the function is defined by the following simple equation:
Embedded Software and Motor Control Libraries for PXR40xx, Rev. 1.0
624 Freescale Semiconductor, Inc.