This version (27 Dec 2022 10:57) was approved by Mahesh Phalke.The Previously approved version (27 Dec 2022 10:18) is available.
Table of Contents
AD5933 Console Application
Introduction
The AD5933 Mbed support software (also supports AD5934) can be used as a starting point for developing your own code for Analog Devices AD5933 products in your own environment utilizing the benefits of the Mbed platform. Analog Devices is an MBED Partner and develops code on the platform for multiple products. The Analog Devices Mbed code-repo can be found in the links below.
This guide will focus on the Analog Devices SDP-K1 controller board, as it is directly compatible with the AD5933 family of evaluation boards and is an MBED-Enabled device. Customers are of course, not limited to using the SDP-K1 board for code development, given that any ARM-based, MBED-enabled board that satisfies a small set of requirements can use the provided code and it will work with only minor changes to the source (see below).
This guide uses the Pmod IA evaluation board. This is a convenient, inexpensive path to evaluating the AD5933.
Useful links
Hardware Connections
The SDP-K1 board has two ways to connect to most ADI evaluation boards, it can use the 120-pin SDP connector on the underside of the board, or the Arduino connector can be used together with jumper wires as described below. Currently an ADI evaluation board with an SDP connector does not exist for the AD5933. As such, it is necessary to connect to the Arduino headers using short jumper wires.
The Getting Started with Mbed page describes the Arduino Uno Header, the SDP connector, pinouts and other information related to understanding the SDP-K1 controller board.
The SDP-K1 can operate with the 120-pin SDP connector of the evaluation board supports it, or, as in this case, it can also use the Arduino header pins (or indeed any available I2C port on the controller board) using wires to the evaluation board. This is shown here for the SDP-K1 board connected to the Digilent Pmod IA evaluation board using the Arduino Header, but different boards might have their SPI/I2C/GPIO ports exposed differently. The pins on the Arduino header must be shorted to the evaluation board as follows. The pin mappings for these are controlled in the app_config.h file and should match your controller board.
| Arduino PIN | MBED NAME | Pmod IA PIN |
|---|---|---|
| D15 | I2C_SCL | SCLK/A0 |
| D14 | I2C_SDA | SDO/SDA |
* Map these pins to any spare I2C peripheral - shown here according to ADI's app_config.h mapping
If using the Arduino header pins, compile the software only after adding the #define ARDUINO to app_config.h (set by default) - see below
One thing to note here is that power and ground for the evaluation need to be provided and can be conveniently taken from the Arduino header as shown above. If using a different evaluation board to the DIGILENT PMOD IA, then consult the relevant evaluation board guides available through the product-page for your selected board.
AD5933 Mbed Software
For developing firmware code for controller boards on the Mbed platform visit the link below.
Source code is hosted here:
Build Guide for Precision Converters MBED firmware (Use below link):
At this time Analog Devices supports Mbed code development through Keil Studio. See here for instructions on setting up an account and using the compiler. Analog Devices may, at a later date support other offline-IDE's. This guide focuses on the SDP-K1, connected to the Pmod IA evaluation board, but it should be general enough to cover any compatible controller board (the controller board should be Mbed-enabled, and expose I2C and some GPIO's).
The software described below allows for an Mbed enabled controller board to be connected with the Pmod IA. Unmodified, the code will communicate over any serial terminal emulator (CoolTerm, putty, etc) using the UART provided by the controller board over USB.
The software provides a basic user-interface for interacting with the evaluation-board. A simple example is provided for calculating the gain-factor and calculating an unknown impedance. This code is provided in the application-code in abstracted form and the user is free to customize the software to suit their own needs for working with the AD5933/34.
Quick Start
If you have some familiarity with the Mbed platform, the following is a basic list of steps required to start running the code, see below for more detail.
- Connect the evaluation-board to the Mbed-enabled controller board.
- Fly-wires will be required as shown below.
- Connect the controller board to your computer over USB.
- Follow the build guide and import code into Keil Studio Wed IDE (Edit app_config.h file (defaults to SDP connector and AD5686R device) if evaluating any other device).
- Ensure your controller board is selected (top right of online-compiler page)
- Edit app_config.h to (defaults to SDP connector)
- Enable the Arduino Header if you are not using the SDP connector, connect pins as shown below.
- Select your evaluation-board you are using
- Compile the code.
- After a successful compile a binary will be downloaded to your computer - store this somewhere.
- Drag and drop this binary to the USB drive hosted by your controller board.
- Start up a terminal emulator,
- Find the com-port your controller board is connected on and select it.
- Set the baud-rate for 230400 - other defaults should be fine.
- Reset the controller board and connect.
- Use the menu provided over the terminal window to access the evaluation board.
Using the Software
The firmware is delivered as a basic, text-based user-interface that operates through a UART on the controller board using the same USB cable that is used to flash the firmware to the boards. Any terminal-emulator should work, but it is not possible for Analog Devices to test everyone. It is necessary to connect a serial terminal-emulator to interact with the running firmware.
Here CoolTerm is used as an example, Analog Devices does not endorse any particular program for this, but CoolTerm works well and is made freely available, other terminals such as Tera Term, or PuTTY will work just as well. Set the baud-rate for 115200 and keep the defaults for everything else. The actual values used can be found by looking at the source code in main.cpp
The software is provided as a demo. The demo covers the essential operation of the AD5933 and it is hoped to be a good starting point for developing your own firmware. The code is also written with a view to keeping things simple, you do not have to be a coding-ninja to understand and expand upon the delivered functions.
It is hoped that the most common functions of the AD5933 family are coded, but it's likely that some special functionality is not implemented.
Feel free to consult Analog Devices Engineer-Zone for feature requests, feedback, bug-reports etc.
The software comes with an app_config.h file which allows the pins for the I2C interface to be selected.
- Configure the pins you want to use to connect the controller board to the evaluation board.
- They default to the I2C exposed on the Arduino header.
The product page for the AD5933 contains extensive material to help understand the operation of the AD5933. This page should be consulted as your firmware is developed.
AD5933 DEMO
This demo will keep things simple by only using resistances. The AD5933 operates is a ratiometric device and because of this it requires a calibration gain-factor to be calculated. This demo will use a 200KΩ calibration and will test the operation of the impedance calculation with a different resistance (300KΩ is arbitrarily chosen).
Use Command option 1 to read the temperature from the AD5933. This ensures basic connectivity is established. The firmware does a temperature read following a board reset.
Step 1: Configure System
- Place a 200KΩ resistance between the 2 SMB connectors on the PMOD IA
- Select Option 2 and provide the data will prompted, example for 200KΩ is done here.
- Select option 3: 1Vpp typical (to ensure amplifiers are not saturated)
- Select PGA gain of X1
- Select Internal Clock
- Enter start frequency of 10Khz (this is arbitrary, as we are using only resistances for the demo)
- Enter frequency increment of 10 (again arbitrary)
- Give the number of increments (20 for example)
- Let the number of settling sample = 5
- Settling-time multiplier = X1
- The software will report the values chosen - this configuration only has to be done once, the values are stored, both in the software and on the AD5933.
Step 2: Calculate the Gain Factor
The gain factor is the calibration for the signal path and only needs to be set once.
- Select option 3 from the main-menu
- Enter your calibration resistance, in Ohms - e.g 200000
- The calculated gain-factor will be returned and stored in software and on-chip
Step 3: Calculate unknown impedance
Any impedance can now be placed between the SMB connectors on the PMOD IA board and option 4 from the main-menu will perform a sweep according to the settings configured in Step 1. The results will be displayed on the terminal. For this demo the 200KΩ was replaced with a 300KΩ and an impedance sweep performed. It returned the results shown below. Consult the extensive documentation available on the product page to help understand the process.
resources/tools-software/product-support-software/ad5933-mbed.txt · Last modified: 27 Dec 2022 10:57 by Mahesh Phalke