LIBML  Version 3.2.4
LIBML DSP Software Library
Functions
Vector Park Transform
Collaboration diagram for Vector Park Transform:

Functions

static void tpt_park_f32 (f32_t *pId, f32_t *pIq, f32_t Ialpha, f32_t Ibeta, f32_t aSinVal, f32_t aCosVal)
 Floating-point Park transform. More...
 
static void tpt_park_q31 (q31_t *pId, q31_t *pIq, q31_t Ialpha, q31_t Ibeta, q31_t aSinVal, q31_t aCosVal)
 Q31 Park transform. More...
 

Detailed Description

Forward Park transform converts the input two-coordinate vector to flux and torque components. The Park transform can be used to realize the transformation of the Ialpha and the Ibeta currents from the stationary to the moving reference frame and control the spatial relationship between the stator vector current and rotor flux vector. If we consider the d axis aligned with the rotor flux, the diagram below shows the current vector and the relationship from the two reference frames:

The function operates on a single sample of data and each call to the function returns the processed output. The library provides separate functions for Q31 and floating-point data types.

Algorithm
where Ialpha and Ibeta are the stator vector components, pId and pIq are rotor vector components and cosVal and sinVal are the cosine and sine values of theta (rotor flux position).
Fixed-Point Behavior
Care must be taken when using the Q31 version of the Park transform. In particular, the overflow and saturation behavior of the accumulator used must be considered. Refer to the function specific documentation below for usage guidelines.

Function Documentation

◆ tpt_park_f32()

static void tpt_park_f32 ( f32_t pId,
f32_t pIq,
f32_t  Ialpha,
f32_t  Ibeta,
f32_t  aSinVal,
f32_t  aCosVal 
)
inlinestatic

Floating-point Park transform.

Parameters
[out]pIdpoints to output rotor reference frame d.
[out]pIqpoints to output rotor reference frame q.
[in]Ialphainput two-phase vector coordinate alpha
[in]Ibetainput two-phase vector coordinate beta
[in]aSinValsine value of rotation angle theta
[in]aCosValcosine value of rotation angle theta
Returns
none

The function implements the forward Park transform.

◆ tpt_park_q31()

static void tpt_park_q31 ( q31_t pId,
q31_t pIq,
q31_t  Ialpha,
q31_t  Ibeta,
q31_t  aSinVal,
q31_t  aCosVal 
)
inlinestatic

Q31 Park transform.

Parameters
[out]pIdpoints to output rotor reference frame d.
[out]pIqpoints to output rotor reference frame q.
[in]Ialphainput two-phase vector coordinate alpha
[in]Ibetainput two-phase vector coordinate beta
[in]aSinValsine value of rotation angle theta
[in]aCosValcosine value of rotation angle theta
Returns
none
Scaling and Overflow Behavior
The function is implemented using an internal 32-bit accumulator. The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. There is saturation on the addition and subtraction, hence there is no risk of overflow.