Wiki

This version (14 Jan 2021 05:44) was approved by Robin Getz.The Previously approved version (03 Jan 2021 21:46) is available.Diff

AD7606 Mbed IIO Application

Introduction

This page gives an overview of using the ARM Mbed platform supported firmware example with Analog Devices AD7606 Evaluation board and SDP-K1 controller board. This example code leverage the ADI developed IIO (Industrial Input Output) ecosystem to evaluate the AD7606 family devices by providing a device debug and data capture support.

The overview of an entire system is shown below:

IIO oscilloscope is used as client application running on windows-os, which is ADI developed GUI for ADC data visualization and device debug. The interface used for communicating client application with firmware application (IIO device) is UART. The firmware application communicates with IIO device (AD7606) using ADI No-OS drivers and platform drivers low level software layers. SDP-K1 is used as controller board, on which IIO firmware application runs and using above software libraries, the IIO firmware communicates with AD7606 IIO device. The AD7606B eval board is used for development and testing of this application.

This code has been developed and tested on SDP-K1 Controller Board using the on-board Arduino Headers. However, same code can be used without or with little modifications on any Mbed enabled board which has Arduino Header Support on it, such as STM32-Discovery, STM32-Nucleo, etc.

Hardware Connections

SDP-K1:
  • Connect the VIO_ADJUST jumper on the SDP-K1 board to 3.3V position to drive SDP-K1 GPIOs at 3.3V
EVAL-AD7606B-FMCZ:

Arduino Connections:

The AD7606 device is configured in “Serial Software” mode in the firmware. AD7606 uses SPI communication for device register access and data capture.

SDP-K1 is powered through USB connection from the computer. SDP-K1 acts as a Serial device when connected to PC, which creates a COM Port to connect to IIO Oscilloscope GUI running on windows-os. The COM port assigned to a device can be seen through the device manager for windows based OS.


Software Downloads

Mbed Firmware

Latest firmware (Use below link):

Quick Start to use Mbed IIO Firmware

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 AD7606 EVAL-board to the SDP-K1 controller board as specified in hardware connections section.
  • Connect the SDP-K1 controller board to your computer over USB provided along with SDP-K1 board.
  • Go to the link of the code provided above in the 'Downloads' section and import code into Mbed online compiler (Edit app_config.h file (defaults to AD7606B device) if evaluating any other device).
  • Ensure SDP-K1 controller board is selected (top right of online-compiler page).
  • Compile the code.
  • After a successful compile a binary will be downloaded to your computer - store this on your drive.
  • Drag and drop this binary to the USB drive hosted by your controller board.

Libiio: IIO Library

This library provides an abstracted library interface to communicate IIO device (AD7606) and IIO client application (IIO Oscilloscope) without worrying about the low level hardware details. Download and install below Libiio windows installer in your computer.

Libiio installer for Windows (Use below link):

IIO Oscilloscope (Client)

This is a GUI (Graphical User Interface) based IIO client application for data visualization and device configuration/debugging. The data from IIO devices (ADCs/DACs) is transmitted over Serial/Ethernet/USB link to IIO Oscilloscope client through the abstracted layer of “libiio”. Download and install below IIO Oscilloscope windows installer in your computer.

IIO Oscilloscope installer for Windows (Use below link):


Evaluating AD7606 Using IIO Ecosystem

Ensure that hardware connection has been made properly in between Mbed Controller Board (SDP-K1) and AD7606 Eval board. Also ensure all software's (IIO firmware, Libiio windows installer and IIO Oscilloscope windows installer) are downloaded and installed in your computer before trying to communicate with AD7606 device.

Running IIO Oscilloscope (Client)

Open the IIO Oscilloscope application from start menu and configure the serial (UART) settings as shown below. Click on refresh button and AD7606 device should pop-up in IIO devices list.

Click 'Connect' and select the AD7606 device from the drop down menu list of 'Device Selection'. It should display below screen after selecting available device.

Configure/Access Device Attributes (Parameters)

The IIO Oscilloscope allows user to access and configure different device parameters, called as 'Device Attributes“. There are 2 types of attributes:

  1. Device Attributes (Global): Access/Configure common device parameters e.g. oversampling rate, operating mode
  2. Channel Attributes (Specific to channels): Access/Configure channel specific device parameters e.g. channel range, offset, calibration, open circuit detection, etc.

How to read and write attribute:

  • To 'Read' an attribute, simply select the attribute from a list or press 'Read' button on left side.
  • To 'Write' an attribute, write a attribute value in the 'value field' and press 'Write' button. The value to be written corresponds to expected bit-field for that parameter, specified in the datasheet. For example, below figure shows how to write a “Oversampling” value.

Using DMM Tab to Read DC Voltage on Input Channels

DMM tab can be used read the instantaneous voltage applied on analog input channels. Simply select the device and channels to read and press start button.

*Note: The voltage is just instantaneous, so it is not possible to get RMS AC voltage or averaged DC voltage. Also, when using DMM tab, it is not encouraged to use Data Capture or Debug tab as this could impact data capturing.

Data Capture from IIO Device

To capture the data from AD7606 IIO device, simply select the device and channels to read/capture data. The data is plotted as “ADC Raw Value” Vs “Number of Samples” and is just used for Visualization. The data is read as is from device without any processing. If user wants to process the data, it must be done externally by capturing data from the Serial link on controller board.

*Note: It is not encouraged to use DMM or Debug tab when capturing data as this could impact data capturing.

More info here: https://wiki.analog.com/resources/tools-software/product-support-software/data-capture-using-iio-app


Calibrating AD7606B/C Devices

ADC Gain Calibration:

ADC gain calibration can be done in 3 easy steps as mentioned below. The gain calibration needs to be done for selected gain filter register as specified in the datasheet (refer 'System Gain Calibration' section from the AD7606B/C datasheet). The gain calibration can be done for each channel depending upon the filter resistor placed in series with each channel analog input.

Reference: File: iio_ad7606.c, Function: get_chn_calibrate_adc_gain()

ADC Offset Calibration:

ADC offset calibration should only be done when ADC input is 0V. The purpose is to reduce any offset error from the input when analog input is at 0V level. The ADC offset calibration can be done for each input channel.

To perform ADC offset calibration, select the 'calibrate_adc_offset' attribute. It should automatically perform the calibration. Also, if 'Read' button is pressed, the calibration should happen one more time.

Reference: File: iio_ad7606.c, Function: get_chn_calibrate_adc_offset()


Open Circuit Detection on AD7606B Device

AD7606B device provides an open circuit detection feature for detecting the open circuit on each analog input channel of ADC.

There are 2 modes to detect open circuit on analog inputs (Refer AD7606B datasheet for more details):

  1. Manual Mode
  2. Auto Mode

Manual Mode Open Circuit Detect:

The manual open circuit detection needs 'Rpd' to be placed at analog input as shown in figure below. The firmware is written to perform the open circuit detection @50Kohm of Rpd value. The common mode change threshold has been defined as 15 ADC count in the firmware at above specified configurations (as specified in the datasheet).

Reference: File: iio_ad7606.c, Function: get_chn_open_circuit_detect_manual()

Auto Mode Open Circuit Detect:

The auto open circuit detection on each individual ADC channel can be done by performing 3 easy steps mentioned in below screenshot.

Reference: File: iio_ad7606.c, Function: get_chn_open_circuit_detect_auto()


Diagnostic Multiplexer on AD7606B/C Devices

Using diagnostic multiplexer on AD7606B/C devices, the internal analog inputs can be sampled to provide a diagnostic voltages and parameters on IIO client application such as reference voltage (vref), DLO voltage (ALDO/DLDO), temperature and drive voltage (vdrive).

*Note: The diagnostic mux control must operate when input range is +/-10V


Modifying Firmware

The below block diagram shows the AD7606 IIO firmware layer.

app_config.h

This file can be used to:

  1. Select the 'Active Device' to evaluate by changing '#define DEV_AD7606B' macro. Default active device is AD7606B.
  2. Configure the pin mapping of AD7606 w.r.t Arduino Header on Controller Board.

ad7606_user_config.c

This file defines the user configurations for the AD7606, such as SPI parameters (frequency, mode, etc) and other init parameters used by No-OS drivers to initialize AD7606 device (e.g. required GPIOs, software/hardware mode, etc). These are the parameters loaded into device when device is powered-up or power-cycled.

iio_ad7606.c

This file defines getter/setter functions for all the device and channel specific attributes (related to AD7606 devices) to read/write the device parameters. The majority of device specific functionality is present in this module.

No-OS Drivers for AD7606

The no-os drivers provide the high level abstracted layer for digital interface of AD7606 devices. The complete digital interface (to access memory map and perform data read) is done in integration with platform drivers.

The functionality related with no-os drivers is covered in below 2 files:

  1. ad7606.c
  2. ad7606.h
It is hoped that the most common functions of the AD7606 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.
resources/tools-software/product-support-software/ad7606_mbed_iio_application.txt · Last modified: 14 Jan 2021 05:38 by Robin Getz