11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal...

37
11 - 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812

Transcript of 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal...

Page 1: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 11

Texas Instruments Incorporated

Module 11 : IQ – Math Library C28xModule 11 : IQ – Math Library C28x

32-Bit-Digital Signal ControllerTMS320F2812

Page 2: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 22

Floating Point, Integer and Fixed PointFloating Point, Integer and Fixed Point Two basic categories of processors:Two basic categories of processors:

Floating Point Floating Point Integer/Fixed PointInteger/Fixed Point

What is the difference?What is the difference? What are advantages / disadvantages ?What are advantages / disadvantages ? Real – Time Control : Fixed Point ! Real – Time Control : Fixed Point ! Discuss fixed-point math development Discuss fixed-point math development

limitationslimitations

Compare/contrast floating-point and IQ Compare/contrast floating-point and IQ representationrepresentation

Texas Instruments IQ-Math approach Texas Instruments IQ-Math approach

Page 3: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 33

Processor TypesProcessor Types Floating Point ProcessorsFloating Point Processors

Internal Hardware Unit to support Floating Point Internal Hardware Unit to support Floating Point Operations Operations

Examples : Intel’s Pentium Series , Texas Examples : Intel’s Pentium Series , Texas Instruments C 6000 DSPInstruments C 6000 DSP

High dynamic range for numeric calculationHigh dynamic range for numeric calculation Rather expensiveRather expensive

Integer / Fixed – Point ProcessorsInteger / Fixed – Point Processors Fixed Point Arithmetic UnitFixed Point Arithmetic Unit Almost all embedded controllers are fixed point Almost all embedded controllers are fixed point

machinesmachines Examples: all microcontroller families, e.g. Examples: all microcontroller families, e.g.

Motorola HC68x, Infineon C166, Texas Motorola HC68x, Infineon C166, Texas Instruments TMS430, TMS320C5000, C2000Instruments TMS430, TMS320C5000, C2000

Lowest price per MIPSLowest price per MIPS

Page 4: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 44

IEEE Standard 754 Single PrecisionIEEE Standard 754 Single PrecisionFloating-PointFloating-Point

s eeeeeeee fffffffffffffffffffffff031 30 23 22

23 bit mantissa (fraction)8 bit exponent1 bit sign

Advantage Advantage Exponent gives large dynamic range Exponent gives large dynamic rangeDisadvantage Disadvantage Precision of a number depends on its exponent Precision of a number depends on its exponent

Case 1: if e = 255 and f = 0, then v = NaN

Case 2: if e = 255 and f = 0, then v = [(-1)s]*infinity

Case 3:Case 3: if 0 < e < 255,if 0 < e < 255, then v = [(-1)then v = [(-1)ss]*[2]*[2(e-127)(e-127)]*(1.f)]*(1.f)

Case 4:Case 4: if e = 0 and f = 0,if e = 0 and f = 0, then v = [(-1)then v = [(-1)ss]*[2]*[2(-126)(-126)]*(0.f)]*(0.f)

Case 5: if e = 0 and f = 0, then v = [(-1)s]*0

//

/

Page 5: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 55

Floating - Point does not solve everything!Floating - Point does not solve everything!

Example: x = 10.0 (0x41200000)+ y = 0.000000238 (0x347F8CF1)

z = 10.000000238 RIGHT?WRONG!

You cannot represent 10.000000238 withsingle-precision floating point

0x412000000 = 10.00000000010.000000238 can’t represent!

0x412000001 = 10.000000950

So z gets rounded down to 10.000000000

Page 6: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 66

Integer Numbering System BasicsInteger Numbering System Basics

Binary NumbersBinary Numbers

011001102 2 = (0*8)+(1*4)+(1*2)+(0*1) = 6= (0*8)+(1*4)+(1*2)+(0*1) = 610 10

111101111022 = (1*16)+(1*8)+(1*4)+(1*2)+(0*1) = 30 = (1*16)+(1*8)+(1*4)+(1*2)+(0*1) = 301010

Two’s Complement NumbersTwo’s Complement Numbers

011001102 2 = (0*-8)+(1*4)+(1*2)+(0*1) = 6= (0*-8)+(1*4)+(1*2)+(0*1) = 610 10

111101111022 = (1*-16)+(1*8)+(1*4)+(1*2)+(0*1) = -2 = (1*-16)+(1*8)+(1*4)+(1*2)+(0*1) = -21010

Page 7: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 77

Four-Bit Integer MultiplicationFour-Bit Integer Multiplication

01000100 x 1101x 110100000000010001000000000000 0000 00000100 0100 111100 1100 1111101001110100

AccumulatorAccumulator

Data MemoryData Memory

11110100111101001111010011110100

4 4 x -3 x -3

4 4 x -3 x -3

-12-12 -12-12

??

Is there another (superior) numbering system?Is there another (superior) numbering system?

Page 8: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 88

Yes: Binary FractionsYes: Binary Fractions

1111 0000 1111 1111

••-1-1 1/21/2 1/41/4 1/81/8

= -1 + 1/4 + 1/8 = -5/8= -1 + 1/4 + 1/8 = -5/8

Fractions have the nice property that

fraction x fraction = fraction

Page 9: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 99

Four-Bit MultiplicationFour-Bit Multiplication

01000100 x 1101x 110100000000010001000000000000 0000 00000100 0100 111100 1100 1111101001110100

11110100111101001111010011110100

1/21/2x - 3/8x - 3/8

-3/16-3/16

AccumulatorAccumulator

..

..

Data MemoryData Memory -1/4-1/411101110..

Page 10: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1010

Fractional RepresentationFractional Representation

S IIIIIIII fffffffffffffffffffffff031

32 bit mantissa

Advantage Advantage Precision same for all numbers in an IQ format Precision same for all numbers in an IQ formatDisadvantage Disadvantage Limited dynamic range compared to floating point Limited dynamic range compared to floating point

-2I + 2I-1 + … + 21 + 20 . 2-1 + 2-2 + … + 2-Q

““IQ” – Format IQ” – Format ““I” I” INTEGER – Fraction INTEGER – Fraction

““Q” Q” QUOTIENT – Fraction QUOTIENT – Fraction

Page 11: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1111

IQ - ExamplesIQ - Examples

S fff

03

Most negative decimal number: -1.0 = 1.000 B

Most positive decimal number: + 0.875 = 0.111 B

Smallest negative decimal number: -1*2-3 (0.125) = 1.111 B

Smallest positive decimal number: 2-3 ( 0.125) = 0. 001 B

I1Q3 – Format: I1Q3 – Format:

Range: Range: -1.0 …. 0.875 (-1.0 …. 0.875 ( + 1.0) + 1.0)Resolution:Resolution: 22-3-3

Page 12: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1212

IQ - ExamplesIQ - Examples

SII f03

Most negative decimal number: -4.0 = 100.0 B

Most positive decimal number: + 3.5 = 011.1 B

Smallest negative decimal number: -1 * 2-1 = 111.1 B

Smallest positive decimal number: 2-1 = 000.1 B

I3Q1 – Format: I3Q1 – Format:

Range: Range: -4.0 …. +3.5 (-4.0 …. +3.5 ( + 4.0) + 4.0)Resolution:Resolution: 22-1-1

Page 13: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1313

IQ - ExamplesIQ - Examples

S fff ffff ffff ffff ffff ffff ffff ffff031

Most negative decimal number: -1.01.000 0000 0000 0000 0000 0000 0000 0000 B

Most positive decimal number: + 1.00.111 1111 1111 1111 1111 1111 1111 1111 B

Smallest negative decimal number: -1*2-31

1.111 1111 1111 1111 1111 1111 1111 1111 B

Smallest positive decimal number: 2-31

0.000 0000 0000 0000 0000 0000 0000 0001 B

I1Q31 – Format: I1Q31 – Format:

Range: Range: -1.0 …. (+1.0)-1.0 …. (+1.0)Resolution:Resolution: 22-31-31

Page 14: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1414

IQ - ExamplesIQ - Examples

S III IIII ffff ffff ffff ffff ffff031

Most negative decimal number: -1281000 0000. 0000 0000 0000 0000 0000 0000 B

Most positive decimal number: + 1280111 1111. 1111 1111 1111 1111 1111 1111 B

Smallest negative decimal number: -1*2-24

1111 1111. 1111 1111 1111 1111 1111 1111 B

Smallest positive decimal number: 2-24

0000 0000. 0000 0000 0000 0000 0000 0001 B

I8Q24 – Format: I8Q24 – Format:

Range: Range: -128 …. (+128)-128 …. (+128)Resolution:Resolution: 22-24-24

Page 15: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1515

IQ-Math can do better!IQ-Math can do better!

I8Q24 Example: x = 10.0 (0x0A000000)+ y = 0.000000238 (0x00000004)

z = 10.000000238 (0x0A000004)

Exact Result (this example)

Page 16: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1616

What is Sign Extension?What is Sign Extension? When moving a value from a narrowed width location to a When moving a value from a narrowed width location to a

wider width location, the sign bit is extended to fill the width wider width location, the sign bit is extended to fill the width of the destinationof the destination

Sign extension applies to signed numbers onlySign extension applies to signed numbers only It keeps negative numbers negative!It keeps negative numbers negative! Sign extension controlled by SXM bit in ST0 register; When Sign extension controlled by SXM bit in ST0 register; When

SXM = 1, sign extension happens automaticallySXM = 1, sign extension happens automatically

4 bit Example: Load a memory value into the ACC4 bit Example: Load a memory value into the ACC

11011101memorymemory = -2= -233 + 2 + 222 + 2 + 200 = -3 = -3

11111111 11011101ACCACC = -2= -277 + 2 + 26 6 + 2+ 255 + 2 + 244 + 2 + 233 + 2 + 222 + 2 + 200

= -128 + 64 + 32 + 16 + 8 + 4 + = -128 + 64 + 32 + 16 + 8 + 4 + 11

= -3= -3

Load and sign extendLoad and sign extend

Page 17: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1717

Correcting Redundant Sign BitCorrecting Redundant Sign Bit

Correcting Redundant Sign BitCorrecting Redundant Sign Bit IQmath: automatically handled IQmath: automatically handled (next topic)(next topic) Q math in “C”, shift in software:Q math in “C”, shift in software:

int x,y,z;int x,y,z;

z = ((long)x * (long)y) >> z = ((long)x * (long)y) >> 15;15;

AccumulatorAccumulator 1 1 1 1 1 1 0 1 0 01 1 0 1 0 01 1 1 1 1 1 0 1 0 01 1 0 1 0 0RedundantRedundantSign BitSign Bit

Page 18: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1818

How is a fraction coded?How is a fraction coded?

~ 1~ 1

00

––½½

––11

½½

FractionsFractions

~ 32K~ 32K

00

––16K16K

––32K32K

16K16K

IntegersIntegers

7FFF7FFF

00000000

C000C000

80008000

40004000

HexHex

void main(void) {void main(void) {

int coef = 32768 * 707 / 1000;int coef = 32768 * 707 / 1000;

}}

*32768*32768

Example: represent the fraction number 0.707Example: represent the fraction number 0.707

Page 19: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 1919

Fractional vs. Integer Fractional vs. Integer

RangeRange Integers have a maximum range determined Integers have a maximum range determined

by the number of bitsby the number of bits Fractions have a maximum range of ±1Fractions have a maximum range of ±1

PrecisionPrecision Integers have a maximum precision of 1Integers have a maximum precision of 1 Fractional precision is determined by the Fractional precision is determined by the

number of bitsnumber of bits

Page 20: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2020

So how do we really use all this fraction stuff?So how do we really use all this fraction stuff?

Takes many days/weeks to convert (one way

process)

Fixed-Point Algorithm

(ASM, C, C++)

Fix-Point DSP

Can be easily ported to floating-point

device

Floating-Point DSP

Floating-PointAlgorithm(C or C++)

Natural development starts with simulation in floating-

point

SimulationPlatform

(i.e. MatLab)

The Fix-Point Development DilemmaThe Fix-Point Development Dilemma

Page 21: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2121

Traditional 16-bit “Q” Math ApproachTraditional 16-bit “Q” Math Approachy = mx + by = mx + b

s Q15ss Q30

sssssssssssss Q15

s Q15

s Q15

s Q15

ss Q30

sI Q30

ssssssssssssI Q15

M

X

B

Y

<< 15Align Binary Point For Add

Y = ((i32) M * (i32) X + (i32) B << Q) >> Q;in C:

>> 15Align Binary

Point For Store

Page 22: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2222

Traditional 32-bit “Q” Math ApproachTraditional 32-bit “Q” Math Approachy = mx + by = mx + b

Y = ((i64) M * (i64) X + (i64) B << Q) >> Q;in C:

Note: Requires support for 64-bit integer data type in compiler

<< 24Align DecimalPoint for Add

I8 Q24 M

X

B

Y

I8 Q24

I8 Q24

I16 Q48

ssssssssssssssssssI8 Q24

ssssI8 Q48

I16 Q48

sssssssssssssssssI16 Q24 I8 Q24

>> 24Align DecimalPoint for Store

Page 23: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2323

32-bit IQmath Approach32-bit IQmath Approachy = mx + by = mx + b

I8 Q24I16 Q48

M

X

B

Y

>> 24Align DecimalPoint Of Multiply

I8 Q24

I8 Q24

sssssssssssssssssI16 Q24

I8 Q24I8 Q24

Y = ((i64) M * (i64) X) >> Q + B;in C:

Page 24: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2424

IQmath ApproachIQmath ApproachMultiply OperationMultiply Operation

Y = ((i64) M * (i64) X) >> Q + B;

_IQmpy(M,X) == ((i64) M * (i64) X) >> Q

Redefine the multiply operation as follows:Redefine the multiply operation as follows:

Y = _IQmpy(M,X) + B;

This simplifies the equation as follows:This simplifies the equation as follows:

MOVL XT,@MIMPYL P,XT,@X ; P = low 32-bits of M*X QMPYL ACC,XT,@X ; ACC = high 32-bits of M*XLSL64 ACC:P,#(32-Q) ; ACC = ACC:P << 32-Q ; (same as P = ACC:P >> Q)ADDL ACC,@B ; Add BMOVL @Y,ACC ; Result = Y = _IQmpy(M*X) + B; 7 Cycles

C28x compiler supports “_IQmpy” intrinsic; assembly code generated:C28x compiler supports “_IQmpy” intrinsic; assembly code generated:

Page 25: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2525

IQmath ApproachIQmath ApproachIt looks like floating-point!It looks like floating-point!

float Y, M, X, B;

Y = M * X + B;

Floating-Point

long Y, M, X, B;

Y = ((i64) M * (i64) X + (i64) B << Q)) >> Q;

TraditionalFix-Point Q

_iq Y, M, X, B; Y = _IQmpy(M, X) + B;

“IQmath”In C

iq Y, M, X, B; Y = M * X + B;

“IQmath”In C++

Taking advantage of operator overloading feature in C++,Taking advantage of operator overloading feature in C++,““IQmath” looks like floating-point math (looks natural!)IQmath” looks like floating-point math (looks natural!)

Page 26: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2626

IQmath ApproachIQmath ApproachGLOBAL_Q simplificationGLOBAL_Q simplification

#define GLOBAL_Q 18 // set in “IQmathLib.h” file

_iq Y, M, X, B;

Y = _IQmpy(M,X) + B; // all values are in Q = 18

GLOBAL_QGLOBAL_Q

User selects “Global Q” value for the whole applicationUser selects “Global Q” value for the whole application

based on the required dynamic range or resolution, for example:based on the required dynamic range or resolution, for example:

The user can also explicitly specify the Q value to use:The user can also explicitly specify the Q value to use:_iq20 Y, M, X, B;

Y = _IQ20mpy(M,X) + B; // all values are in Q = 20

0.000 000 060.000 000 06 -128.000 000 00-128.000 000 00 127.999 999 94127.999 999 942424

0.000 0010.000 001-2048.000 000-2048.000 0002047.999 9992047.999 9992020

0.000 000 0040.000 000 004 -8.000 000 000-8.000 000 000 7.999 999 9967.999 999 9962828ResolutionResolutionMin ValMin ValMax ValMax ValGLOBAL_QGLOBAL_Q

Page 27: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2727

All “IQmath” operations have an equivalent floating-point operation

IQmath ApproachIQmath ApproachTargeting Fixed-Point or Floating-Point deviceTargeting Fixed-Point or Floating-Point device

Compile & Runusing floating-point math on

C3x, C67x,C28x (RTS), PC,..

Compile & Runusing “IQmath” on

C28x

User selects target math type(in “IQmathLib.h” file)

Y = _IQmpy(M, X) + B;

#if MATH_TYPE == IQ_MATH #if MATH_TYPE == FLOAT_MATH

Y = (float)M * (float)X + (float)B;

Page 28: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2828

IQmath Library: IQmath Library: math & trig functions (v1.4)math & trig functions (v1.4)

Accuracy of functions/operations approx ~28 to ~31 bits

IQsin(A),IQcos(A)IQsin(A),IQcos(A)

IQsinPU(A),IQcosPU(A)IQsinPU(A),IQcosPU(A)

IQatan(A),IQatan2(A,B)IQatan(A),IQatan2(A,B)

IQatan2PU(A,B)IQatan2PU(A,B)

IQsqrt(A),IQisqrt(A)IQsqrt(A),IQisqrt(A)

IQmag(A,B)IQmag(A,B)

_IQsin(A), _IQcos(A)_IQsin(A), _IQcos(A)

_IQsinPU(A), _IQcosPU(A)_IQsinPU(A), _IQcosPU(A)

_IQatan(A), _IQatan2(A,B)_IQatan(A), _IQatan2(A,B)

_IQatan2PU(A,B)_IQatan2PU(A,B)

_IQsqrt(A), _IQisqrt(A)_IQsqrt(A), _IQisqrt(A)

_IQmag(A,B)_IQmag(A,B)

sin(A),cos(A) sin(A),cos(A)

sin(A*2pi),cos(A*2pi)sin(A*2pi),cos(A*2pi)

atan(A),atan2(A,B)atan(A),atan2(A,B)

atan2(A,B)/2piatan2(A,B)/2pi

sqrt(A),1/sqrt(A)sqrt(A),1/sqrt(A)

sqrt(A*A + B*B)sqrt(A*A + B*B)

trigtrig

functionsfunctions

IQsat(A,Pos,Neg)IQsat(A,Pos,Neg)_IQsat(A,Pos,Neg)_IQsat(A,Pos,Neg)if(A > Pos) A = Posif(A > Pos) A = Pos

if(A < Neg) A = Negif(A < Neg) A = Neg

saturationsaturation

A – BA – BA - BA - BA - BA - Bsubstractsubstract

>, >=, <, <=, ==, |=, &&, || >, >=, <, <=, ==, |=, &&, || >, >=, <, <=, ==, |=, &&, ||>, >=, <, <=, ==, |=, &&, ||>, >=, <, <=, ==, |=, &&, ||>, >=, <, <=, ==, |=, &&, ||booleanboolean

A + BA + BA + BA + B A + BA + Baddadd

A / BA / B_IQdiv (A , B)_IQdiv (A , B)A / B A / B dividedivide

A * BA * B_IQmpy(A , B)_IQmpy(A , B)A * BA * Bmultiplymultiply

A = IQ(1.2345)A = IQ(1.2345)A = _IQ(1.2345)A = _IQ(1.2345)A = 1.2345A = 1.2345constantconstant

iq A, B;iq A, B;_iq A, B;_iq A, B;float A, B;float A, B;typetype““IQmath” in C++IQmath” in C++““IQmath” in CIQmath” in CFloating-PointFloating-PointOperationOperation

Page 29: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 2929

IQmath Library:IQmath Library: Conversion Functions (v1.4) Conversion Functions (v1.4)

IQmath.lib > contains library of math functions IQmathLib.h > C header fileIQmathCPP.h > C++ header file

atoIQ(char)atoIQ(char)_atoIQ(char)_atoIQ(char)atof(char)atof(char)string to iqstring to iq

IQtoQN(A)IQtoQN(A)_IQtoQN(A)_IQtoQN(A)AAiq to qNiq to qN

QNtoIQ(A)QNtoIQ(A)_QNtoIQ(A)_QNtoIQ(A)AAqN to iqqN to iq

IQmpyI32int(A,B)IQmpyI32int(A,B)_IQmpyI32int(A,B)_IQmpyI32int(A,B)(long) (A * (float) B)(long) (A * (float) B)integer(iq*long)integer(iq*long)

IQmpyI32frac(A,B)IQmpyI32frac(A,B)_IQmpyI32frac(A,B)_IQmpyI32frac(A,B)A - (long) (A * (float) B)A - (long) (A * (float) B)fraction(iq*long)fraction(iq*long)

IQtoF(A)IQtoF(A)_IQtoF(A)_IQtoF(A)AAIQ to floatIQ to float

IQmpyI32(A,B)IQmpyI32(A,B)_IQmpyI32(A,B)_IQmpyI32(A,B)A * (float) BA * (float) B iq = iq*longiq = iq*long

IQfrac(A)IQfrac(A)_IQfrac(A)_IQfrac(A)A – (long) AA – (long) Afraction(iq)fraction(iq)

IQint(A)IQint(A)_IQint(A)_IQint(A)(long) A(long) Ainteger(iq)integer(iq)

IQNtoIQ(A)IQNtoIQ(A)_IQNtoIQ(A)_IQNtoIQ(A)AAiqN to iqiqN to iq

IQtoIQN(A)IQtoIQN(A)_IQtoIQN(A)_IQtoIQN(A)AAiq to iqNiq to iqN““IQmath” in C++IQmath” in C++““IQmath” in CIQmath” in CFloating-PointFloating-PointOperationOperation

Page 30: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3030

AC Induction Motor ExampleAC Induction Motor ExampleOne of the more complex motor control algorithmsOne of the more complex motor control algorithms

Sensorless, ACI induction machine direct rotor flux controlSensorless, ACI induction machine direct rotor flux control Goal: motor speed estimation & alpha-axis stator current estimationGoal: motor speed estimation & alpha-axis stator current estimation

Page 31: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3131

AC Induction Motor ExampleAC Induction Motor ExamplePark Transform - floating-point C codePark Transform - floating-point C code

#include#include “math.h”“math.h”

#define TWO_PI 6.28318530717959#define TWO_PI 6.28318530717959

  void park_calc(PARK *v)void park_calc(PARK *v)

{{

float cos_ang , sin_ang;float cos_ang , sin_ang;

sin_ang = sin(TWO_PI * v->ang);sin_ang = sin(TWO_PI * v->ang);

cos_ang = cos(TWO_PI * v->ang);cos_ang = cos(TWO_PI * v->ang);

  

v->de = (v->ds * cos_ang) + (v->qs * sin_ang);v->de = (v->ds * cos_ang) + (v->qs * sin_ang);

v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);

}}

Page 32: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3232

AC Induction Motor ExampleAC Induction Motor ExamplePark Transform - converting to “IQmath” C codePark Transform - converting to “IQmath” C code

#include#include “math.h”“math.h”

#define TWO_PI 6.28318530717959#define TWO_PI 6.28318530717959

void park_calc(PARK *v)void park_calc(PARK *v)

{{

float cos_ang , sin_ang;float cos_ang , sin_ang;

sin_ang = sin(TWO_PI * v->ang);sin_ang = sin(TWO_PI * v->ang);

cos_ang = cos(TWO_PI * v->ang);cos_ang = cos(TWO_PI * v->ang);

  

v->de = (v->ds * cos_ang) + (v->qs * sin_ang);v->de = (v->ds * cos_ang) + (v->qs * sin_ang);

v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);

}}

#include “IQmathLib.h”

_IQ(6.28318530717959)

_iq

_IQsin(_IQmpy(TWO_PI , v->ang));

_IQcos(_IQmpy(TWO_PI , v->ang));

_IQmpy(v->ds , cos_ang) + _IQmpy(v->qs , sin_ang);

_IQmpy(v->qs , cos_ang) - _IQmpy(v->ds , sin_ang);

Page 33: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3333

AC Induction Motor ExampleAC Induction Motor ExamplePark Transform - converting to “IQmath” C++ codePark Transform - converting to “IQmath” C++ code

#include#include “math.h”“math.h”

#define TWO_PI 6.28318530717959#define TWO_PI 6.28318530717959

void park_calc(PARK *v)void park_calc(PARK *v)

{{

float cos_ang , sin_ang;float cos_ang , sin_ang;

sin_ang = sin(TWO_PI * v->ang);sin_ang = sin(TWO_PI * v->ang);

cos_ang = cos(TWO_PI * v->ang);cos_ang = cos(TWO_PI * v->ang);

  

v->de = (v->ds * cos_ang) + (v->qs * sin_ang);v->de = (v->ds * cos_ang) + (v->qs * sin_ang);

v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);v->qe = (v->qs * cos_ang) - (v->ds * sin_ang);

}}

extern “C” { #include “IQmathLib.h” }

#include “IQmathCPP.h”

IQ(6.28318530717959)

iq

IQsin(TWO_PI * v->ang);

IQcos(TWO_PI * v->ang);

Page 34: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3434

AC Induction Motor ExampleAC Induction Motor ExampleQ stability rangeQ stability range

The developer must pick the right GLOBAL_Q value!The developer must pick the right GLOBAL_Q value!

UnstableUnstable(not enough resolution, quantization problems)(not enough resolution, quantization problems)

Q18 to Q0Q18 to Q0

StableStableQ26 to Q19Q26 to Q19

UnstableUnstable(not enough dynamic range)(not enough dynamic range)Q31 to Q27Q31 to Q27

Stability RangeStability RangeQ rangeQ range

Page 35: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3535

Where Is IQmath Applicable?Where Is IQmath Applicable?

Motor Control (PID, State Estimator, Kalman,...)Servo Control

ModemsAudio (MP3, etc.)

Imaging (JPEG, etc.)Any application using 16/32-bit fixed-point Q math

Where it is not applicable

Anywhere a large dynamic range is not required

Graphical applications (3D rotation, etc.)

When trying to squeeze every last cycle

Page 36: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.

11 - 11 - 3636

IQmath Approach SummaryIQmath Approach Summary

Seamless portability of code between fixed and floating-point Seamless portability of code between fixed and floating-point devicesdevices User selects target math type in “IQmathLib.h” fileUser selects target math type in “IQmathLib.h” file

#if MATH_TYPE == IQ_MATH#if MATH_TYPE == IQ_MATH #if MATH_TYPE == FLOAT_MATH#if MATH_TYPE == FLOAT_MATH

One source code set for simulation vs. target deviceOne source code set for simulation vs. target device Numerical resolution adjustability based on application Numerical resolution adjustability based on application

requirementrequirement Set in “IQmathLib.h” fileSet in “IQmathLib.h” file

#define GLOBAL_Q 18#define GLOBAL_Q 18 Explicitly specify Q valueExplicitly specify Q value

_iq20 X, Y, Z;_iq20 X, Y, Z;

Numerical accuracy without sacrificing time and cyclesNumerical accuracy without sacrificing time and cycles Rapid conversion/porting and implementation of algorithmsRapid conversion/porting and implementation of algorithms

IQmath library is freeware - available from TI DSP websiteIQmath library is freeware - available from TI DSP websitehttp://www.dspvillage.ti.comhttp://www.dspvillage.ti.com (follow C2000 DSP links) (follow C2000 DSP links)

““IQmath” + fixed-point processor with 32-bit capabilities =IQmath” + fixed-point processor with 32-bit capabilities =

Page 37: 11 - 1 Texas Instruments Incorporated Module 11 : IQ – Math Library C28x 32-Bit-Digital Signal Controller TMS320F2812.