ADE9430 ADSW-PQ-CLS Power Quality Library Frequently Asked Questions

Question

ADE9430 ADSW-PQ-CLS Power Quality Library Frequently Asked Questions

Accepted Answer

Q: What is the difference between the Evaluation version and Production version of the Power Quality Library? 
 A: The Evaluation version is intended for use with EVAL-ADE9430 . The Library is provided in compiled form. The Evaluation version should always be requested first. The Production version provides the library in source form so it can be ported to other platforms. All the other content is identical between the two versions. 
 Q: How should I request the Evaluation version of the Power Quality Library ? 
 A: The Power Quality Library Evaluation can be requested by raising a software request at SRF . Select 'Power Quality Monitoring' in the Target Technology dropdown to review the license agreement and download the software. Click "Evaluation" in " Do you require Evaluation or Production Code at this stage?" under "Software requested" tab first time and we will be able to consider for "Production" version once the evaluation is over. 
 Q: What is the production version of the Power Quality Library? How can I request it? 
 A: Once your evaluation is over and you are happy with the results, you can raise a new software request for the library asking for a production version at SRF . For a production version, the Power Quality Library will be provided as source code so that it can be built into the code of the compatible MCU of your choice. 
 
 Q: How do I get the documentation for Power Quality Library? 
 A: Power Quality Library User&rsquo;s Guide and API documents are part of the pack file. It goes to "documentation" folder of the pack installation folder. The pack installation path varies with tool chain. For example, for Keil toolchain, RTEPATH variable TOOLS.ini is C:\Keil_v5 gives the pack installation folder. If you are using a tool chain which doesn't support CMSIS packs, pack file can be renamed to a zip file and extracted using appropriate tools. 
 Q. Is there a prebuilt executable present for evaluation? 
 A: Yes. For quick evaluation, a prebuild hex file of the example is provided along with the package. The hex file is compatible with EVAL-ADE9430 . 
 Q: What are the prerequisites to run Power Quality Library Software example? 
 A: A Power Quality Library example is provided as a Keil project and requires a licensed version of the Keil tool chain. It also requires the EVAL-ADE9430 board. Please refer to the Release Notes for an exact version and hardware requirements. 
 Q: Can I run Power Quality Library example using IAR or GCC tool chain? 
 A: Power Quality Library is provided as a CMSIS pack file. The example project provided along with the package is a Keil project and works only with licensed Keil tool chain. If you are using a tool chain which doesn't support Keil pack, pack file can be renamed to a zip file and extracted using appropriate tools. The sources of the examples are provided along with the pack and libraries are provided for Keil, IAR and GCC compilers. You have to create your own project using the sources and library if you are using a toolchain other than Keil. 
 Q: Does Power Quality Library Evaluation version work with GCC (arm-none-eabi-none) toolchain? 
 A: Yes. Power Quality Library Evaluation version works with gcc toolchain from release 1.2.0 onwards. The package contains a library(libadi_pqlib_cm4_gcc.a) built using gcc. However there are no example projects provided. The user's may create their own makefiles /projects to building the example. Use following additional settings for gcc while building the examples. 
 compiler : -u _printf_float 
 linker : -specs=nosys.specs 
 Q: Can adi_pqlib_cm4_keil.lib present evaluation pack be used with IAR or GCC toolchain? 
 A: No, the adi_pqlib_cm4_keil.lib is built with the keil toolchain. From release 1.2.0 onwards adi_pqlib_cm4_iar.a is provided for IAR tool chain and libadi_pqlib_cm4_gcc.a is provided for GCC tool chain. 
 Q: Can I use the power quality library for processors other than ST32F4 micro controller present in evaluation board? 
 A: Yes. Power Quality Library is written as processor agnostic. However it uses CMSIS DSP library and the application has to provide implementation of those APIs for the targeted processor. Also the library is licensed only to use along with ADE9430 AFE. 
 Q: How do I calibrate the ADE9430? 
 A: Gain and offset registers of ADE9430 are same as ADE9000. So calibration tools present for ADE9000 can be used for ADE9430 as well. 
 Q: Why does the harmonic detection need separate correction? How can I calculate the correction coefficients for harmonic analysis? 
 A: Various filters in the signal chain comes with frequency dependent attenuation which affects harmonic magnitudes. Refer to an-1483.pdf for detailed information. The Power Quality Library comes with correction coefficients for the components present in the evaluation board. If the components are different, it needs to be recalculated for the board. Refer to section 5.11 of User's Guide for procedures on how to calculate correction factors . 
 
 Q: Where can I find the MIPS and memory details for the Power Quality library? 
 A: MIPS and memory details are mentioned in the Specification section of Power Quality Library User&rsquo;s Guide. 
 Q: How do I get the cycle count for adi_pqlib_ProcessOneCycle/adi_pqlib_Process1012Cycles/adi_pqlib_ProcessWaveform API's? 
 A: The Power Quality Library is designed as processor agnostic. All micro controllers provide ways to measure the cycle counts of a module. For example, it can be measured using DWT->CYCCNT or Systick register for ARM Cortex processors. 
 Q: Are there any CLI commands to print the cycle count? 
 A: No. There are no CLI commands provided to print cycle count. 
 Q: What are all the registers that need to be modified for getting the waveform samples? 
 A: Refer to Power Quality Library User&rsquo;s Guide, "AFE Configuration" page "User configuration" section. 
 Q: What is the CMSIS version used in the library? 
 A: Refer to Power Quality Library User&rsquo;s Guide, Installation Components section. 
 Q: How do I adjust the harmonic coefficients provided in the library? 
 A: Refer to Power Quality Library User&rsquo;s Guide, "Power Quality Library Software Description" page, "Gain Correction" section. 
 Q: What is the significance of 'voltagescale 1001' used in the example? 
 A: This configuration is based on the potential divider present in the evaluation board. 
 Q: Why is there a factor of sqrt2 in the ConvertRMSType() function in example? 
 A: The AFE and library are expected to give MAX_RMS_VALUE for full scale ADC signals. The factor of sqrt(2) is just a convention followed in the example for displaying the RMS values. 
 As you can see from the comments in that function, we wanted to display 1/sqrt(2) for the max RMS output when user scale is 1. 
 Q: What might be the reason for ADI_PQLIB_RESULT_WAVEFORM_NOT_READY error? 
 A: ADI_PQLIB_RESULT_WAVEFORM_NOT_READY is returned if number adi_pqlib_ProcessWaveform calls is less than 4 between 2 adi_pqlib_Process1012Cycles API calls. It can happen if some interrupts are missed. 
 Q: What is the speed of SPI used on the evaluation kit? 
 A: The SPI is configured to run at 6.25MHz. 
 Q: When trying to request software, I'm not able to select "Hardware Platform" which is a mandatory field. I'm getting error message "We are experiencing a problem finding the page you're looking for" after submitting the request. 
 A: These issues are mostly due to server issues and are intermittent . So checking couple of times might solve the issue. Also try logging into myAnalog first and then use the link https://www.analog.com/sr 
 Q: Can ADSW-PQ-CLS Power Quality Library be used for ADE9000 also? 
 A: No. Some features needed for the Class S Power Quality library to be compliant with the IEC 61000-4-30 standard are not supported by ADE9000. 
 Q: Does Power Quality Library work with Rogowski coil input and ADE9430 internal digital integrator? 
 A: No. The digital integrator in ADE9430 is not present in the resampler path. So a discrete integrator is needed if you want to use Rogowski coils. 
 Q: Can I replace the ADE9000 with the ADE9430 in my design without any changes? 
 A: The ADE9430 is pin to pin compatible with ADE9000 however there are small differences to consider when doing a swap, please see the following list to check if your application is using any of ADE9000 features not present on ADE9430. 
 
 The following features have changed in ADE9430:
 
 &frac12; Cycle RMS is replaced with 1 Cycle RMS 
 ADE9430 adds a averaging feature to the period measurement configured at CONFIG0<17:16>
 
 00: do nothing 
 01: average-by-8 
 10: average-by-16 
 11: average-by-32

The following new mode is added to the re-sampled waveform feature:
 
 The re-sampled waveforms now run continuously. 
 The re-sampled waveforms are 1024 points per 10/12 line cycles. This gives a sample rate of ~5.12ksps. 
 Gain correction is added to the re-sampled waveform path to enable calibration. 
 The 10/12 cycle window is synchronous with the 10/12 cycle RMS feature. 
 This means there could be a delay before the waveforms start as it will wait for the start of the next 10/12 cycle RMS window. 
 Added PERIOD_FORRMS register. 
 Gain compensation now effects resampled data. 
 VCONSEL/ICONSEL now effect resampled data. 
 The waveform buffer is split into 2 pages, there is a register to indicate which page is full.

The following features are removed on ADE9430 from ADE9000:
 
 THD is calculated by the PQ library and is not available directly from ADE9430. 
 The integrator on the current channels is not present in ADE9430. For di/dt sensors (Rogowski Coil) an external integrator is required.

Q: Does Power Quality Library contain proprietary codes? 
 A: Yes. Power Quality Library contains proprietary codes and it is licensed to use only with ADE9430. 
 Q: What about licensing and fees for production version? 
 A: There are no additional licensing fees for the production version now. Software License as described in the Software License Agreement (SLA) to be signed via clickthrough download and it is licensed to use only with ADE9430 AFE. 
 Q: How can I get the latest version of the Power Quality Library if I have access for the older version? 
 A: All those who had access for the older version would automatically have access to latest version as well. It will be available in the resources section of myAnalog account. 
 You have to login to myAnalog account (with the same id used to access older version) for downloading it.

Partner Forums

Partner Libraries

ADE9xxx