Wiki

This version (16 Feb 2024 06:39) was approved by Michelle Claire So.The Previously approved version (16 Feb 2024 06:33) is available.Diff

EVAL-CN0565-ARDZ User Guide

Overview

The EVAL-CN0565-ARDZ is an electrical impedance tomography (EIT) measurement system for characterizing and computing interior impedance of surfaces. The platform allows a conductivity map to be reconstructed using several repeating measurements from electrodes placed at different locations. It supports impedance measurement setups with up to 24 electrodes. The design uses a pair 8×12 analog crosspoint switches, which enables the excitation signal to be applied to one pair of electrodes at a time. The implementation of crosspoint switches allows the circuit to maximize the impedance measurements, which consequently improves the resolution of the constructed images.

The design also features a complete power and signal isolation to the host controller, which can be used as reference for bioimpedance applications.

The board comes in an Arduino-compatible form factor and includes an industry-standard software interface, allowing easy integration to end-user systems as well to connect up to external development platforms such as the EVAL-ADICUP3029.



Simplified Block Diagram

Figure 2. EVAL-CN0565-ARDZ Simplified Block Diagram

Features

  • supports 24 impedance input, arbitrarily assignable to quadrupole impedance measurement channels
  • supports impedance measurement setups with up to 24 electrode pairs
  • accepts measurement frequency range from 0.015 Hz up to 200 kHz
  • provides measurement ground that is fully isolated from host computer, with 0.47 µF isolation capacitance

Hardware Configuration

Connectors and Jumpers

  • P7 (Chip Select Mapping) - leave this at default for the provided firmware

Figure 3. EVAL-CN0565-ARDZ P7 Pin Location

  • P1 (DUT Connections) - shows the pin mapping diagram

Figure 4. EVAL-CN0565-ARDZ P1 Pin Location


System Setup

Documents Needed

Demo Requirements

Hardware Setup

Figure 5. EVAL-CN0565-ARDZ Test Setup

Getting Started

Follow below steps to set up the hardware for testing:

  1. Check visually if Pins 1 and 2 on the P7 of EVAL-CN0565-ARDZ are shorted by default.
  2. Connect the EVAL-CN0565-ARDZ (via male header pins) to the EVAL-ADICUP3029 (via female header pins). Ensure that the header pins between the two boards fit properly together.
  3. Connect the EVAL-ADICUP3029 to the host PC using a micro-USB cable. The DS2 LED in the EVAL-CN565-ARDZ should turn green, this indicates power.
  4. Upload the CN0565 firmware to the EVAL-ADICUP3029 by copying the prebuilt .HEX file directly into the DAPLINK drive.
  5. Drag and drop the CN0565.HEX file to the DAPLINK. The DAPLINK will automatically disconnect and connect again, this indicates successful uploading.
Ensure that the DAPLINK is visible in the file explorer, this indicates a proper connection between the EVAL-ADICUP3029 and the host PC.

Software Setup

Python Installation Guide

Assumes a fresh installation of all required software

  1. Download Python Latest Version. Choose the latest available version depending on the operating system.
  2. Run installer as Administrator. During installation, check “Add Python version to PATH” before clicking “Install Now”
  3. To check if the download is successful, go to command prompt and type the command line below:
     python --version 


Installing Libiio

Libiio is a library that has been developed by Analog Devices to ease the development of software interfacing Linux Industrial I/O (IIO) devices.

  1. Download and install the latest release of libIIO
  2. Install the libIIO bindings through pip
     pip install pylibiio 
  3. Install the PyADI-IIO through pip
     pip install pyadi-iio 
    1. If you need to update/overwrite your PyADI-IIO through pip, use the command below:
       pip install -U pyadi-iio 


Uploading the HEX File

In order to use the EVAL-CN0565-ARDZ with the EVAL-ADICUP3029, you must upload the CN0565 HEX file. The procedure is as follows:

  1. Open the file explorer in the Host PC (Windows)
  2. Open the folder where the CN0565.HEX file is located. If you don't have the HEX file, download this file: CN0565 Embedded Firmware
  3. Launch another file explorer, and then open the DAPLINK folder.
  4. Drag and drop the CN0565.HEX file into the DAPLINK folder. The window will automatically close and temporarily disconnect the EVAL-ADICUP3029, and then reconnect again. This is an indication that the HEX file is properly installed.


Installing Software Requirements

  • Clone the example firmware from GitHub EVAL-CN0565-ARDZ Python Scripts. This includes the .txt file that contains the required modules and libraries to run the example scripts.
  • In Windows, open a command terminal. Point the current working directory to the cloned pyadi-iio repository by changing the directory using this command:
     cd <folder address> 
  • Navigate inside the pyadi-iio folder and install the following requirements using these commands:
     pip install -r requirements.txt 
     pip install -r requirements_dev.txt 
     pip install -r requirements_doc.txt 
     pip install -r requirements_prod_test.txt 
  • To test the source as a standalone module, enter this command:
     pip install -e . 
  • After installing the required modules and libraries, launch the device manager and check for the active COM port where the board is connected. In the pyadi-iio folder > examples > cn0565, this is where the script is saved. Change the COM port in the script.
  • To run the test script, copy the address where the script is saved then enter this command:
     cd <folder address> 
     python <file name>.py 
Check the active port where the board is connected in your device manager.
  • cn0565_example.py edit on line 122
  • cn0565_example_single.py edit on line 24

Python Example Scripts

Two sample scripts have been created to execute EIT measurements in the EVAL-CN0565-ARDZ. The Specific Electrode Pair script allows the user to measure the impedance on a specific electrode pair, whereas the Electrode Tomography script examines the impedance of the entire test board across all electrodes.

Using the Specific Electrode Pair Script

  • Open the command terminal and direct the current working directory to where the example script is saved.
  • Run the script by entering this command:
     python cn0565_example_single.py 0 1 1 0 

Prompting these commands in the terminal will give you the Amplitude, Frequency and Baud Rate, Electrode Pair, Rectangular and Polar Form Impedance, and the Real and Imaginary Impedance for the specific electrode pair.

The numbers 0, 1, 1, 0 indicate the electrode positions for Force Leads: F+, F-, and Sense Leads: S+, and S-

Using the Electrode Tomography Script

  • Open the command terminal and direct the current working directory to where the example script is saved.
  • Run the script by entering this command:
     python cn0565_example.py 

Prompting these commands in the terminal will give you the Amplitude, Frequency and Baud Rate, Electrode Pair, Rectangular and Polar form impedance. Then, the Electrode Pair followed by the Rectangular and Polar Form Impedance and the Real and Imaginary Impedance for each electrode pair that is being measured will display.
After running the sample script, the program will prompt a question whether you like to generate a csv file that contains the raw data.

Enter this command if you want to generate a .csv file:

 Y 

Enter this command if you don't need to generate a .csv file:

 N 


All python scripts used in performing this test are uploaded in the git repository. You may access the repository using this link: EVAL-CN0565-ARDZ Python Scripts


CN0565 Graphical User Interface (GUI) Test Example

  1. Connect the EVAL-CN0565-ARDZ to the EVAL-ADICUP3029 via the Arduino headers.
  2. Connect to the EVAL-ADICUP3029 to the host PC via a micro-USB cable.
    • The DS2 in the EVAL-CN0565-ARDZ must turn green to indicate power.
  3. Upload the CN0565 demo firmware to the EVAL-ADICUP3029 by copying the pre-built .HEX file directly into the DAPLINK drive (see the ADICUP3029 User Guide).
    • Make sure that the DAPLINK is visible in the file explorer, indicating a proper connection between the two boards.
    • Drag and drop the CN0565.HEX file to the DAPLINK. The DAPLINK will automatically disconnect and connect again, which indicates successful uploading.
  4. Open the command prompt in the Host PC (Windows).
  5. Assuming all requirements have been installed, open a command terminal and direct to the current working directory to where the example script is saved by entering cd <folder address>.
  6. Prompt the CN0565 Realtime EIT GUI by entering this command: main.py
  7. Select the type of dataset, type of image reconstruction, number of electrodes, and set the frequency.
  8. Once all the parameters are set, connect the board to the GUI by selecting Active Comport, and then click Connect. When the board is already connected, the image will automatically display.
Disconnecting the board is necessary to run the GUI for another set of measurement. Once disconnected, proceed to Step 6.

Figure 6. Results Displayed in the CN0565 GUI


Schematic, PCB Layout, Bill of Materials

EVAL-CN0565-ARDZ Design & Integration Files

  • Schematic
  • PCB Layout
  • Bill of Materials
  • Allegro Project

Registration

Receive software update notifications, documentation updates, view the latest videos, and more when you register your hardware. Register to receive all these great benefits and more!

End of Document

resources/eval/user-guides/circuits-from-the-lab/cn0565.txt · Last modified: 16 Feb 2024 06:38 by Michelle Claire So