Wiki

Below is the source of this page. To edit this source as well as other pages on the wiki, you must login.
====== EVAL-AD5592R-PMDZ Overview ======

The EVAL-AD5592R-PMDZ is a minimalist 8-channel, 12-Bit, configurable ADC/DAC/GPIO with on-chip reference, SPI interface PMOD module. This board serves as a low-cost alternative to the full-featured product evaluation boards, with terminal block connections and no extra signal conditioning.

{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:eval-ad5592r-pmdz-angle-web.png?nolink&300 |}}

This user guide will focus on the hardware aspect of the EVAL-AD5592R-PMDZ including the connectors, indicators, and different configurations a user would require in order to use the hardware. There is also a link to the design files as well as software reference designs that use the hardware with example embedded firmware for a real demo.
 
====== Simplified functional block diagram ======

{{ :resources:eval:user-guides:circuits-from-the-lab:eval_ad5592r-pmod:ad5592r_block_diagram.png?nolink&500 |}}


===== Connectors and Configuration =====

The following section reviews all the hardware connectors and how to interface with them.  It also reviews configuration options and well as important onboard indicators.

==== Analog/Digital I/O Connector (P2 & P3) ====

^Connector ^ Pin No. ^ Pin Name ^ Pin Description ^
|P3        |1        |CH3  	| Channel 3 Input/Output |
|          |2        |CH2  	| Channel 2 Input/Output |
|          |3        |CH1	| Channel 1 Input/Output |
|          |4        |CH0	| Channel 0 Input/Output |
|          |5        |GND	| Ground		 |
|          |6        |VDD	| Power Supply 		 |
|P2        |1        |VREF      | Voltage Reference      |
|          |2        |GND	| Ground		 |
|          |3        |CH7	| Channel 7 Input/Output |
|          |4        |CH6	| Channel 6 Input/Output |
|          |5        |CH5	| Channel 5 Input/Output |
|          |6        |CH4	| Channel 4 Input/Output |

==== SPI PMOD Connector (P1) ====

^ Connector	^ Pin No. ^ Pin Name	^ ADuCM3029 Pin Function	^ ADuCM3029 Port No. ^
|SPI_PMOD      | 1       |CS		| SPI1_CS0/GPIO25               | P1_09              |
| :::			| 2 |MOSI	| SPI1_MOSI/GPIO23                      | P1_07 |
| :::			| 3 |MISO  	| SPI1_MISO/GPIO24                      | P1_08 |
| :::			| 4 |SCLK	| SPI1_SCLK/GPIO22                      | P1_06 |
| :::			| 5 |DGND	| DGND          			||
| :::			| 6 |3.3V       | +3.3V         			||
| :::			| 7 |IO16	| XINT1_WAKE2/GPIO16	        	| P1_00 |
| :::			| 8 |RESET	| SYS_HWRST_N   			||
| :::			| 9 |RDY	 	| SPI1_RDY/TMR0_OUT/GPIO14		| P0_14 |
| :::			|10 |IO12	| SPT0_AD0/GPIO12               	| P0_12	|
| :::			|11|DGND	| DGND          			||
| :::			|12|3.3V        | +3.3V         			||


==== Test Points ====
Users can also check the SPI signal quality, supply, and reference voltage of the board using test points labeled SS, MOSI, MISO, VLOGIC, and VREF
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592-1.png?nolink&550 |}}

==== Voltage reference configuration====
The default connection of the AD5592R **Vref** pin is shorted at pin 1 of JP1 solder jumper where you can easily configure your voltage reference input at pin 1 of terminal block P2, either from an external source or internal 2.5V.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592-2.png?nolink&400 |}}

==== LED Indicator ====
The DS1 is the power green LED indicator of the board.
{{ :resources:eval:user-guides:circuits-from-the-lab:eval_ad5592r-pmod:power_led_indicator.png?nolink&350 |}}

==== Power Supply Considerations and Configuration ====

When using the AD5592R PMOD board, the 3.3V power for the PMOD comes directly from the host board it is connected to.  The power from the host is generally capable of providing up to 100 mA at 3.3V, but for complete PMOD power specifications please click[[https://www.digilentinc.com/Pmods/Digilent-Pmod_%20Interface_Specification.pdf|here]].


===== Device Driver Support =====

There are two device driver solutions that are provided for controlling the **EVAL-AD5592R-PMDZ**:
  - **AD5592R no-OS Driver**
      * The **[[:resources:tools-software:uc-drivers:ad5592r|AD5592R no-OS driver]]** is used in bare-metal applications, typically running on low-power, embedded microcontrollers. 
  - **AD5592R Linux Driver**
      * The **[[:resources:tools-software:linux-drivers:iio-dac:ad5592r| AD5592R Linux driver]]** is used in applications running the Linux operating system, typically on larger processors and SoC devices.
      * The AD5592R Linux driver uses the Industrial Input/Output (IIO) framework, greatly simplifying the development of application code via the cross-platform Libiio library, which is written in C and includes bindings for Python, MATLAB, C#, and other languages. Application code can run directly on the platform board, communicating with the device over the local backend, or from a remote host over the network or USB backends.\\

===== System Setup Using ADICUP3029 =====

The ** EVAL-AD5592R-PMDZ ** can be used with [[/resources/eval/user-guides/eval-adicup3029|ADICUP3029]].

==== Demo Requirements ====

The following is the list of items needed in order to replicate this demo.

  * ** Hardware **
    * [[ADI>EVAL-ADICUP3029|EVAL-ADICUP3029]]
    * [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/eval-ad5592r-pmdz.html | EVAL-AD5592R-PMDZ]] 
    * Micro-USB to USB Cable
    * PC or Laptop with USB Port

  * ** Software **
    * PuTTY or other similar software
    * [[repo>EVAL-ADICUP3029/releases/download/Latest/ADuCM3029_demo_ad5592r_ad5593r.hex|ADuCM3029_demo_AD5592R.hex]]

<WRAP center round info 80%>

There are two basic ways to program the ADICUP3029 with the software for the AD5592R.
  - Dragging and Dropping the Hex to the Daplink drive
    - Using the drag and drop method, the software is going to be a version that Analog Devices creates for testing and evaluation purposes.  This is the **EASIEST** way to get started with the reference design.
  - Building, Compiling, and Debugging using CCES
    - Importing the project into [[adi>en/design-center/evaluation-hardware-and-software/software/adswt-cces.html|CrossCore Embedded Studio]] is going to allow you to change parameters and customize the software to your application, but will a bit more advanced and will require you to download the CrossCore toolchain.
</WRAP>

<WRAP center round 80% download>

The software for the **ADICUP3029_AD5592R** demo can be found here:

Prebuilt AD5592R Hex File
  * [[repo>EVAL-ADICUP3029/releases/download/Latest/ADuCM3029_demo_ad5592r_ad5593r.hex|ADuCM3029_demo_AD5592R.hex]]

Complete AD5592R Source Files
  * [[repo>EVAL-ADICUP3029/tree/master/projects/ADuCM3029_demo_ad5592r_ad5593r | ADuCM3029_demo_AD5592R Source Code]]
</WRAP>

==== Setting up the Hardware ====

1. Connect **EVAL-AD5592R-PMDZ** board at connector **P8** of the **EVAL-ADICUP3029**.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:img_2996.jpg?nolink&400 |}}

2. Connect a micro-USB cable to the P8 connector of the EVAL-ADICUP3029 and connect it to a computer. The final setup should look similar to the picture below.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:img_2994.jpg?nolink&400 |}}

3. Make sure the following switches are as shown in the table below.
{{ :resources:eval:user-guides:circuits-from-the-lab:cn0552:switch_config.png?900 }} <wrap center 30%> 

4. From your PC, open My Computer and look for the DAPLINK drive, if you see this then the drivers are complete and correct. {{ :resources:eval:user-guides:circuits-from-the-lab:cn0552:daplink.jpg?300 | }} 

3. Simply extract the provided zip file. Once extracted, you will see the pre-built hex file for the AD5592R demo. Then drag and drop this Hex file to the DAPLINK drive and your ADICUP3029 board will be programmed. The DS2 (red) LED will blink rapidly.

4. The DS2 will stop blinking and will stay ON once the programming is done.

5. Open PuTTY or other similar software. Check the Device Manager to set the correct COM port for the ADICUP3029. Set the baud rate to 115200.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:putty_5592.png?nolink&300 |}}

6. The expected output viewed in the PuTTY is shown below.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:adicup_5592.png?nolink&500 |}}

===== System Setup Using Raspberry Pi =====

The ** EVAL-AD5592R-PMDZ ** can be used with a Raspberry Pi.

==== Demo Requirements ====

The following is a list of items needed in order to replicate this demo.
  * **Hardware**
    * [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/eval-ad5592r-pmdz.html | EVAL-AD5592R-PMDZ]]
    * [[ADI>PMD-RPI-INTZ|PMOD to Raspberry Pi Adapter (PMD-RPI-INTZ)]]
    * Raspberry PI Zero, Zero W, 3B+, or 4
    * 16GB (or larger) Class 10 (or faster) micro-SD card
    * 5Vdc, 2.5A power supply with micro USB connector (USB-C power supply for Raspberry Pi 4)
    * User interface setup (choose one):
      * HDMI monitor, keyboard, and mouse plugged directly into Raspberry Pi
      * Host Windows/Linux/Mac computer on the same network as Raspberry Pi

  * **Software**
    * [[:resources:tools-software:linux-software:kuiper-linux|Kuiper Linux Image]]

==== Loading Image on SD Card ====

In order to boot the Raspberry Pi and control the **EVAL-AD5592R-PMDZ**, you will need to install ADI Kuiper Linux on an SD card. Complete instructions, including where to download the SD card image, how to write it to the SD card, and how to configure the system are provided on the **[[:resources:tools-software:linux-software:kuiper-linux|Kuiper Linux page]]**.

==== Configuring the SD Card ====

Follow the configuration procedure under **Configuring the SD Card for Raspberry Pi Projects** on the [[:resources:tools-software:linux-software:kuiper-linux|Kuiper Linux]] page, substituting the following lines in **config.txt**:

<code>
dtoverlay=rpi-ad5592r
</code>

==== Setting up the Hardware ====

To set up the circuit for evaluation, consider the following steps:
  - Connect the P9 of the **PMOD to Raspberry Pi Interposer** board at the male header GPIO pin connector of the **Raspberry Pi** as shown below. {{ :resources:eval:user-guides:circuits-from-the-lab:cn0552:interposer.png?400 | }}
  - Connect the ** [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/eval-ad5592r-pmdz.html | EVAL-AD5592R-PMDZ]] ** on the PMOD to Raspberry Pi Interposer board either via Port P1 or P2. {{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592_rpi.jpg?nolink&400 |}}
  - Burn the SD card with the proper ADI Kuiper Linux image. Insert the burned SD card into the designated slot on the RPi.
  - Connect the system to a monitor using an HDMI cable through the mini HDMI connector on the RPi.
  - Connect a USB keyboard and mouse to the RPi through the USB ports.
  - Power on the RPi board by plugging in a 5V power supply with a micro-USB connector. The final setup should look similar to the picture below. {{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:setup_5592.png?nolink&500 |}}
  
===== Application Software (All Platforms) =====

==== Hardware Connection ====

The Libiio is a library used for interfacing with IIO devices and is required to be installed on your computer.

<WRAP center round download 60%>
Download and Install the latest [[https://github.com/analogdevicesinc/libiio/releases|Libiio package]] on your machine. 
</WRAP>

To be able to connect your device, the software must be able to create a context. The context creation in the software depends on the backend used to connect to the device as well as the platform where the EVAL-AD5592R-PMDZ is attached. Two platforms are currently supported for the AD5592R: Raspberry Pi using the ADI Kuiper Linux and the ADICUP3029 running the no-OS AD5592R demo project. The user needs to supply a **URI** which will be used in the context creation.

The [[/resources/tools-software/linux-software/libiio/iio_info|iio_info]] command is a part of the libIIO package that reports all IIO attributes. 

Upon installation, simply enter the command on the terminal command line to access it.
\\ 

=== For RPI Direct Local Access: ===

<code>
iio_info
</code>

=== For Windows machine connected to Raspberry Pi: ===

<code>
iio_info -u ip:<ip address of your ip>
</code>
Example:
      * If your Raspberry Pi has the IP address 192.168.1.7, you have to use //iio_info -u ip::192.168.1.7// as your URI
<note>
Do note that the Windows machine and the RPI board should be connected to the same network in order for the machine to detect the device.
</note>

==== IIO Commands ====

There are different commands that can be used to manage and control the device being used. The [[/resources/tools-software/linux-software/libiio/iio_attr|iio_attr]] command reads and writes IIO attributes.

<code>
analog@analog:~$ iio_attr [OPTION]...
</code>
Example:
      * To look at the context attributes, enter this code on the terminal:

<code>
analog@analog:~$ iio_attr -a -C
</code>

\\

The [[/resources/tools-software/linux-software/libiio/iio_reg|iio_reg]] command reads or writes SPI or I2C registers in an IIO device. This is generally not needed for end applications but can be useful in debugging drivers. Note that you need to specify a context using the //-u// qualifier when you are not directly accessing the device via RPI or when you are using the ADICUP3029 platform.

<code>
analog@analog:~$ iio_reg -u <context> <device> <register> [<value>]
</code>

Example:
      * To read the device ID (register = 0x02) of an AD5592R interfaced via RPI from a Windows machine, enter the following code on the terminal:

<code>
iio_reg -u ip:<ip address> ad5592r 0x02
</code>

\\

==== IIO Oscilloscope ====

<note important>Make sure to download/update to the latest version of IIO-Oscilloscope found on this link[[https://github.com/analogdevicesinc/iio-oscilloscope/releases]]</note>
  - Once done with the installation or an update of the latest IIO-Oscilloscope, open the application.  The user needs to supply a URI which will be used in the context creation of the IIO Oscilloscope and the instructions can be seen in the previous section.
  - Press refresh to display available IIO Devices, once ad5592r appeared, press connect.
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592_osc.png?400 |AD5592R Oscilloscope Configuration}}

=== Debug Panel ===

Below is the Debug panel of AD5592R wherein you can directly access the attributes of the device. 
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592_debug.png?400 |AD5592R Debug Panel}}

=== DMM Panel ===

Access the DMM panel to see the instantaneous reading of the device temperature and voltages. 
{{ :resources:eval:user-guides:circuits-from-the-lab:ad5592r-pmod:5592_dmm.png?400 |AD5592R DMM Panel}}

==== PyADI-IIO ====

[[/resources/tools-software/linux-software/pyadi-iio|PyADI-IIO]] is a Python abstraction module for ADI hardware with IIO drivers to make them easier to use. This module provides device-specific APIs built on top of the current libIIO Python bindings. These interfaces try to match the driver naming as much as possible without the need to understand the complexities of libIIO and IIO.\\

Follow the step-by-step procedure on how to install, configure, and set up PYADI-IIO and install the necessary packages/modules needed by referring to this [[/resources/tools-software/linux-software/pyadi-iio|link]].

=== Running the example ===

After installing and configuring PYADI-IIO in your machine, you are now ready to run Python script examples. In our case, run the [[https://github.com/analogdevicesinc/pyadi-iio/blob/master/examples/ad5592r_example.py|ad5592r_example.py]] found in the examples folder.

<code> D:\pyadi-iio\examples>python ad5592r_example.py </code>

Press enter. Input desired voltage levels and you will get these readings.
{{ :resources:eval:user-guides:circuits-from-the-lab:eval_ad5592r-pmod:5592_example.png?700 | ad5592r_example.py }}


<WRAP round 80% download>
Github link for the Python sample script: 
[[https://github.com/analogdevicesinc/pyadi-iio/blob/master/examples/ad5592r_example.py|AD5592R Python Example]]

</WRAP>

===== More Information and Useful Links =====

  * [[ADI>AD5592R|AD5592R Product Page]]
  * [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/eval-ad5592r-pmdz.html | EVAL-AD5592R-PMDZ]]
  * [[:resources:eval:user-guides:eval-adicup3029:reference_designs:demo_ad5592r_ad5593r | AD5592/AD5593 PMOD ADICUP3029 Demo]]
 
====== Schematic, PCB Layout, Bill of Materials ======
<WRAP round 80% download>
[[adi>media/en/evaluation-documentation/evaluation-design-files/eval-ad5592r-pmdz-designsupport.zip|EVAL-AD5592R-PMDZ Design & Integration Files]]
  * Schematic
  * PCB Layout
  * Bill of Materials
  * Allegro Project

</WRAP>
===== Additional Information =====
  * [[https://github.com/analogdevicesinc/pyadi-iio|pyADI-IIO]]
  * [[:resources:tools-software:linux-software:pyadi-iio|PyADI-IIO Installation Guide]]
  * [[:resources:tools-software:linux-software:iio_oscilloscope|IIO Oscilloscope Installation Guide]]
  * [[:resources:tools-software:linux-software:kuiper-linux|Kuiper Linux]]
 
=====Registration===== 
<WRAP round tip 80% >
Receive software update notifications, documentation updates, view the latest videos, and more when you register your hardware.  [[reg>EVAL-AD5592R-PMDZ?&v=RevC|Register]] to receive all these great benefits and more!</WRAP>

// End of Document //
Analog Devices Wiki

Page Tools
