SPRUIK4A September   2018  – June 2019 TMS320F280021 , TMS320F280021-Q1 , TMS320F280023 , TMS320F280023-Q1 , TMS320F280023C , TMS320F280025 , TMS320F280025-Q1 , TMS320F280025C , TMS320F280025C-Q1 , TMS320F280040-Q1 , TMS320F280040C-Q1 , TMS320F280041 , TMS320F280041-Q1 , TMS320F280041C , TMS320F280041C-Q1 , TMS320F280045 , TMS320F280048-Q1 , TMS320F280048C-Q1 , TMS320F280049 , TMS320F280049-Q1 , TMS320F280049C , TMS320F280049C-Q1 , TMS320F28075 , TMS320F28075-Q1 , TMS320F28076 , TMS320F28374D , TMS320F28374S , TMS320F28375D , TMS320F28375S , TMS320F28375S-Q1 , TMS320F28376D , TMS320F28376S , TMS320F28377D , TMS320F28377D-Q1 , TMS320F28377S , TMS320F28377S-Q1 , TMS320F28378D , TMS320F28378S , TMS320F28379D , TMS320F28379D-Q1 , TMS320F28379S

 

  1.   C2000 Software Frequency Response Analyzer (SFRA) Library and Compensation Designer in SDK Framework
    1.     Trademarks
    2. 1 Introduction
    3. 2 Installing the SFRA Library
      1. 2.1 SFRA Library Package Contents
      2. 2.2 How to Install the SFRA Library
    4. 3 Module Summary
      1. 3.1 SFRA Library Function Summary
      2. 3.2 Principle of Operation
      3. 3.3 Per Unit Format
      4. 3.4 Floating Point (Singe Precision)
        1. 3.4.1 Object Definition
        2. 3.4.2 Module Interface Definition
        3. 3.4.3 Adding SFRA Library to the Project
        4. 3.4.4 Adding Support for SFRA GUI
      5. 3.5 Script for Importing Frequency Response and Designing Compensation
      6. 3.6 SFRA GUI Options and How to Run
    5. 4 Compensation Designer
      1. 4.1 Launching Compensation Designer
        1. 4.1.1 Standalone From SFRA GUI Folder
        2. 4.1.2 From Solution Adapter Page
      2. 4.2 Compensation Style and Number
    6. 5 Case Study
      1. 5.1 Plant TF Extraction
      2. 5.2 Designing Compensator Using Compensation Designer
      3. 5.3 OL Measurement
      4. 5.4 Comparing SFRA Measured Frequency Response Versus Modeled
    7. 6 Running Software Test Bench Example for SFRA
    8. 7 Using SFRA Without SFRA GUI Integration
    9. 8 FAQ
  2.   Revision History

3.4.2 Module Interface Definition

Table 3. Floating Point Module Interface Definition

Module Element Name Type Description Acceptable Range
h_magVect,gh_magVect, cl_magVect Input Pointer to the array that stores the magnitude of H, GH and CL measurements by SFRA . Pass NULL if you do not want SFRA to save that vector. Pointer to 32 bit location, the location stores the value of the magnitude vectors in single precision (32-bit) floating point
h_phaseVect,gh_phaseVect, cl_phaseVect Input Pointer to the array that stores the phase of H, GH and CL measurements by SFRA . Pass NULL if you do not want SFRA to save that vector. Pointer to 32 bit location, the location stores the value of the phase vectors in single precision (32-bit) floating point
freqVect Input Pointer to array of frequency values at which SFRA is performed. Pointer to 32 bit location, the location stores the value of the frequency vectors in single precision (32-bit) floating point
amplitude Input Amplitude of small signal injection in pu. Single precision (32-bit) floating point(-1,1)
isrFreq Input Frequency at which SFRA routine is called. Single precision (32-bit) floating point
freqStart Input Frequency of the first frequency sweep data point. Single precision (32-bit) floating point
freqStep Input 10^(1/(no of steps per decade)). Single precision (32-bit) floating point
start Input Command to start SFRA. int16_t
state Output SFRA state. Non zero when SFRA injection is in progress, '0' if SFRA injection is not active/ in progress. int16_t
status Output SFRA status. '1' is SFRA injection is in progress, '0' if SFRA injection is not active/ in progress. int16_t
vecLength Input No of points for which SFRA is performed. int16_t
freqIndex Output Frequency index number of freqVect at which SFRA is being performed. int16_t (0-vecLength)
storeH Output Reflects the SFRA configuration, If one, H vector is stored If zero, H vector is not stored this happens when a NULL vector is passed for H mag or phase vector during SFRA configuration. int16_t (0 or 1)
storeGH Output Reflects the SFRA configuration, If one, GH vector is stored If zero, GH vector is not stored this happens when a NULL vector is passed for GH mag or phase vector during SFRA configuration. int16_t (0 or 1)
storeCL Output Reflects the SFRA configuration, If one, CL vector is stored If zero, CL vector is not stored this happens when a NULL vector is passed for CL mag or phase vector during SFRA configuration. int16_t (0 or 1)
speed Input Used to change the speed of the sweep, need to be greater than 1. With 1 the STB example template sweep takes ~58 seconds. Actual speed in the system will depend on the frequency point being measured and the ISR rate used for calling the SFRA module. Higher the speed number the slower the sweep. int16_t (Greater than 1)