-By Lluis Beltran Gil, Product Applications Engineer, Analog Devices
Evaluation boards (EVBs), along with their accompanying software, can easily evaluate the performance of Analog Devices products with their plug and play capability. Their graphical user interface (GUI) provides an intuitive means to manually configure and communicate with the device. However, in more complex products, sweeping across all the product’s bells and whistles while evaluating all the available features may become time consuming if these repetitive tasks are not automated.
This article explains how to record a macro and how to use it within Python® and MATLAB® environments to automate certain evaluation tasks without having to develop any complex software controller code. The AD7380 and AD7606C-16 examples used in this article automate all the user interaction such that they sweep through many different configurations and launch conversions, then export the results. These examples are used in the article to automate the evaluation of the performance benefits that an oversampling digital filter brings to an analog-to-digital converter (ADC). While this article focuses on the AD7380 and AD7606C-16, the information in this article can also apply to other ADI products and applications.
ADI provides the means to easily evaluate every new product release, its achievable performance, as its features. Firstly, our evaluation boards consist of a printed circuit board (PCB) that houses the main devices—for example, an ADC—along with the required companion products such as voltage reference, driver amplifier, clock source, power solution, etc. Secondly, these boards come with software that showcases the actual performance the solution can achieve. It displays real data that can be acquired with this platform. For the past couple of years, ACE software1 has been the platform used for this purpose.
Within the ACE platform, each product features a plug-in that eases the device configuration by accessing the device register map through clean, easily navigable GUI.
Following the ADC example, ACE normally displays the raw data in the form of a waveform or histogram and calculates AC performance metrics like SNR or THD through FFTs. This article shows how to automate all these procedures without the need for software development.
Figure 2 shows the AD7380 plug-in chip view where several buttons are offered to easily configure the device:
- REF allows for the selection of either the internal or external reference
- OSC can enable oversampling and set the oversampling ratio
Figure 3 shows the AD7606C-16 plug-in chip view where several buttons, highlighted with darker blue color, can be used among others to:
- Select the analog input range, per channel, by clicking the PGA symbol
- Select the reference source, whether internal or external
- Select the oversampling ratio
- Configure the offset/gain/phase calibration features
- Configure the diagnostics
While the previous examples use the AD7380 and AD7606C-16, the scope of this article is not just these products, but everything related to working with ACE and automating repetitive tasks. Every ACE plug-in will have its own GUI layout. However, as the products grow in complexity and more features are added (for example, diagnostics, calibrations, etc.), the more complex and tedious it becomes to test all these features manually. ACE remote control offers the ability to set or sweep parameters to, for example, sweep the oversampling ratio and measure how the noise performance improves.
Setting Up ACE Remote Control
Before starting to create code to control ACE remotely, the communication with ACE needs to be established by following these steps:
- Open ACE and go to Settings
- Go to the IPC Server tab and ensure it is enabled
- Make sure a port is allocated, preferably 2357
Recording a Macro and Generating Scripts
ACE has a Macro Tools menu to record configuration and device interaction steps by putting them into a macro file. Once a macro is generated, it can then be used to automatically repeat all the steps at once. The following steps explain how to generate a macro:
- Open ACE then go to Tools >> Macro Tools.
- Hit the record macro commands button, on the right-hand side of the icon within the blue area highlighted in Figure
- Start performing device interaction such as changing parameters, inputting values to registers on the memory map, capturing data, etc. The Command window will fill up as the GUI is navigated and interacted with.
- Once all actions/settings to be entered are recorded, hit the stop recording macro commands Same location as above. The Command window will automatically pop up then.
As an example, while recording the macro, the user configures the oversampling ratio and the resolution mode, just by using the buttons explained in Figure 2. The Command window will look like Figure 5.
In this window, all the steps recorded can be reviewed and even skip/break any unwanted autogenerated step, before exporting the whole program into a selectable language script, as highlighted in red in Figure 5.
Once a macro file has been recorded, it can then be saved and played again to repeat the previously performed steps. ACE has a built-in feature to generate scripts that perform the recorded actions in a supported language of choice. So, following the previous list, the next steps will be:
- Click on the Generate icon, at the right-hand side of the blue area highlighted in Figure 5, to open the script generator window.
- Select the desired language among C#, MATLAB, or Python, and hit Export.
This code can then be imported into an IDE for execution. Using this code as the base, add additional features like instrument control to have an automated test bench for measurements.2 Visual Studio Code or MATLAB is used on the examples displayed in the next sections, and the examples will just use the product evaluation board to perform noise analysis, without any extra piece of equipment. In order to find code examples for manipulating, storing, or plotting the data gathered, as shown in the next couple of sections, visit wiki.analog.com and search for the evaluation board of interest.
Automate Evaluation Tasks with Python
The .py file generated in the previous section allows for easily launching and repeating a series of previously recorded actions. Furthermore, even greater benefits come by editing these scripts and automating certain tasks. Following the previous example where the oversampling ratio and resolution were set in the AD7380 ACE plug-in, the generated macro is edited to allow input parameters, as shown in Figure 7. Note that, by default, these macros are called execute_macro(), but this name can be changed to a more descriptive name.
This macro can now be called inside for a loop, sweeping the oversampling ratio values and seeing how the noise performance improves as the oversampling ratio increases, as well as seeing the benefits of enabling two extra bits of resolution.
As a result, the Python example code accesses the exported data files, reads the SNR data measured by the ACE plug-in, and reports it through the serial monitor. As shown in Table 1, oversampling improves noise performance3 but, at a certain point, two extra bits of resolution are needed in order to see the real benefit where AD7380 is shown as an 18-bit word instead of 16-bit.
Automate Evaluation Tasks with MATLAB
Like the Python example, the autogenerated code can be exported also for MATLAB, generating an .m file in this case. Here, macros are defined as a function, but these can also be edited to allow input parameters. The following MATLAB examples use the AD7606C-16 board instead.
Again, the benefits of AD7606C-16’s oversampling can easily be evaluated through automating ACE. Figure 9 shows a MATLAB function, edited to accept parameters like the throughput, number of samples, interface type (serial or parallel), the reference source (internal or external), oversampling ratio, number of digital lines, or the analog input range.
This particular function could be used within the main code in order to quickly launch the data capture different configurations to easily perform several AD7606C-16 comparisons like:
- Noise performance oversampling ratio
- Performance throughput
- Performance analog input range
- Internal external reference
- Serial interface parallel interface
And many more. Note that this is just the AD7606C-16 example; depending on the product under evaluation, many different performance evaluation needs may arise.
A good hand of AD7606C-16 can be found at wiki.analog.com,4 with the source code available. This shows how to code the macros and also gives examples to postprocess the data. The OversamplingSweep.m example sweeps the oversampling ratio and plots a histogram of codes for each value. As shown in Figure 10, the larger the oversampling ratio, the narrower the histogram of codes. Table 2 also shows how the peak-to-peak distribution of codes reduces with oversampling.
The newer ACE platform, the framework for the latest evaluation board’s software, is an advantageous tool for any hardware designer eager to speed up the ADI product’s evaluation work because of the capability of recording macros. These macros enable test automation, through industry-known programming languages such as Python or MATLAB. Automating these tasks, in turn, enables faster product evaluation and selection phase, resulting on an improvement in time to market and shortening hardware design cycles. Further support can always be found, for this and other topics, in EngineerZone™, and more remote control examples can be found at wiki.analog.com.
1 “Analysis | Control | Evaluation (ACE) Software.” Analog Devices, Inc.
2 “AD5791 ACE Remote Control.” Analog Devices, Inc., February 2020.
3 Jonathan Colao. “Fast Reacting Optical Encoder Feedback System for Miniature Motor Driven Applications.” Analog Dialogue, Vo. 54, No. 2, April 2020.
4 “AD7606B/C ACE Remote Control.” Analog Devices, Inc., February 2021.
About the Author
Lluis Beltran Gil received his B.S. degree in electronics engineering in 2009 and in industrial engineering in 2012, both from the Universitat Politècnica de València, UPV (Technical University of Valencia). After graduation, Lluis joined Analog Devices in 2013 as an applications engineer in the Precision Converter Group in Limerick. Currently, Lluis is working on the SAR ADC Applications Team within the Instrumentation BU, and he is based in Valencia, Spain, where he also received his M.Sc. degree in electronics engineering from Universitat de València, UV (University of Valencia).