03.08.2013 Views

Embedded Software and Motor Control Libraries for PXR40xx

Embedded Software and Motor Control Libraries for PXR40xx

Embedded Software and Motor Control Libraries for PXR40xx

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

4.125.3 Return<br />

Converted input value in 32-bit fractional <strong>for</strong>mat.<br />

4.125.4 Description<br />

This inline function returns converted input value. The input value is considered as 16-bit<br />

fractional data type <strong>and</strong> output value is considered as 32-bit fractional data type thus both<br />

values represent the values in unity model. The second value represents the scale factor<br />

<strong>and</strong> is considered as 16-bit fractional data type. The sign of the second value represents<br />

the scale mechanism. In case the second value is positive the first input value is<br />

multiplied with the second one <strong>and</strong> converted to the output <strong>for</strong>mat. In case the second<br />

value is negative, the first input value is divided by absolute value of second input value<br />

<strong>and</strong> converted to the output <strong>for</strong>mat. The output saturation is not implemented in this<br />

function, thus in case the input value is outside the (-1, 1) interval, the output value will<br />

overflow without any detection.<br />

The output of the function is defined by the following simple equation:<br />

Equation MLIB_Convert_Eq1<br />

Note<br />

Due to effectivity reason this function is implemented as inline<br />

<strong>and</strong> thus is not ANSI-C compliant.<br />

4.125.5 Re-entrancy<br />

The function is re-entrant.<br />

4.125.6 Code Example<br />

#include "mlib.h"<br />

tFrac16 f16In1, f16In2;<br />

tFrac32 f32Out;<br />

void main(void)<br />

{<br />

<strong>Embedded</strong> <strong>Software</strong> <strong>and</strong> <strong>Motor</strong> <strong>Control</strong> <strong>Libraries</strong> <strong>for</strong> <strong>PXR40xx</strong>, Rev. 1.0<br />

Chapter 4 API References<br />

Freescale Semiconductor, Inc. 567

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!