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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

4.137.4 Description<br />

This inline function returns the division of two input values. The first input value is<br />

numerator <strong>and</strong> the second input value is denominator. The input values as well as output<br />

value is considered as 32-bit fractional data type. The output saturation is not<br />

implemented in this function, thus in case the numerator is greater or equal to<br />

denominator, the output value is undefined <strong>and</strong> will overflow without any detection. As<br />

the division by zero can be h<strong>and</strong>led differently on each plat<strong>for</strong>m <strong>and</strong> potentially can cause<br />

the core exception, the division by zero is h<strong>and</strong>led separately.<br />

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

Equation MLIB_Div_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 />

CAUTION<br />

Due to effectivity reason the division is held in 16-bit precision.<br />

4.137.5 Re-entrancy<br />

The function is re-entrant.<br />

4.137.6 Code Example<br />

#include "mlib.h"<br />

tFrac32 f32In1, f32In2;<br />

tFrac32 f32Out;<br />

void main(void)<br />

{<br />

// input value 1 = 0.25<br />

f32In1 = FRAC32 (0.25);<br />

// input value 2 = 0.5<br />

f32In2 = FRAC32 (0.5);<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. 587

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

Saved successfully!

Ooh no, something went wrong!