====== AD5781 FMC-SDP Interposer & Evaluation Board / Xilinx KC705 Reference Design ======


===== Supported Devices =====

  * [[adi>AD5781]]

===== Evaluation Boards =====

  * [[adi>EVAL-AD5781SDZ]]

====== Overview ======

This document presents the steps to setup an environment for using the **[[adi>AD5781|EVAL-AD5781SDZ]]** evaluation board together with the Xilinx KC705 FPGA board and the Xilinx Embedded Development Kit (EDK). Below is presented a picture of the EVAL-AD5781SDZ Evaluation Board with the Xilinx KC705 board.

{{ :resources:fpga:xilinx:interposer:img_ad5781.jpg }}

{{page>common_sdp}}

Below is presented a picture of **SDP-B** Controller Board with the **EVAL-AD5781SDZ** Evaluation Board.

{{ :resources:fpga:altera:bemicro:ad5781_sdp1z.png?400 }}

The **EVAL-AD5781SDZ** is a full-featured evaluation board, designed to allow the user to easily evaluate all features of the AD5781 voltage output, 18-bit DAC. The AD5781 pins are accessible at on-board connectors for external connection. The board can be controlled by two means, via the on-board connector (J6) or via the system development platform connector (J3).

The [[adi>AD5781]] is a high precision, 18-bit digital-to-analog converter (DAC), designed to meet the requirements of precision control applications. The output range of the AD5781 is configured by two reference voltage inputs. The device is specified to operate with a dual power supply of up to 33 V.

===== More information =====
  * [[adi>AD5781|AD5781 Product Info]] - pricing, samples, datasheet
  * [[adi>/static/imported-files/user_guides/UG-184.pdf|EVAL-AD5781SDZ evaluation board user guide]]
  * [[xilinx>products/boards-and-kits/EK-K7-KC705-G.htm | Xilinx KC705 FPGA board]]

====== Getting Started ======

The first objective is to ensure that you have all of the items needed and to install the software tools so that you are ready to create and run the evaluation project.

===== Required Hardware =====

  * [[xilinx>products/boards-and-kits/EK-K7-KC705-G.htm | Xilinx KC705 FPGA board]]
  * FMC-SDP adapter board
  * **EVAL-AD5781** evaluation board

===== Required Software =====

  * Xilinx ISE 14.6.
  * UART Terminal (Termite/Tera Term/Hyperterminal), baud rate 115200.
  * The EVAL-AD5781 reference project for Xilinx KC705 FPGA.

===== Downloads =====
<WRAP round download 80%>
\\
  * **AD5781 Driver:** https://github.com/analogdevicesinc/no-OS/tree/master/device_drivers/AD5791
  * **AD5781 Commands:** https://github.com/analogdevicesinc/no-OS/tree/master/device_commands/AD5791
  * **Xilinx Boards Common Drivers:** https://github.com/analogdevicesinc/no-OS/tree/master/platform_drivers/Xilinx/SDP_Common
  * **EDK KC705 Reference project:** https://github.com/analogdevicesinc/fpgahdl_xilinx/tree/master/cf_sdp_kc705
\\
</WRAP>
====== Run the Demonstration Project ======

===== Hardware setup =====

<WRAP round important 80%>
\\
Before connecting the ADI evaluation board to the Xilinx KC705 make sure that the VADJ_FPGA voltage of the KC705 is set to 3.3V. For more details on how to change the setting for VADJ_FPGA visit the Xilinx KC705 product page.
</WRAP>

  * Use the FMC-SDP interposer to connect the ADI evaluation board to the Xilinx KC705 board on the FMC LPC connector.
  * Connect the JTAG and UART cables to the KC705 and power up the FPGA board.

<WRAP round important 80%>
\\
To power on the EVAL-AD5781 evaluation board, you need to provide external differential supply voltage to J1 connector(for more information see: [[adi>/static/imported-files/user_guides/UG-184.pdf|EVAL-AD5781SDZ evaluation board user guide]]) and a 5V reference voltage to VREF connector on the evaluation board. VREFN will be connected to AGND (LK8 option=A and LK9 option=B).
</WRAP>

===== Reference Project Overview =====
The following commands were implemented in this version of EVAL-AD5781 reference project for Xilinx KC705 FPGA board.
^ Command ^ Description ^
| **help?** | Displays all available commands. |
| **reset!** | Resets the device. |
| **coding=** | Selects the coding style. Accepted values:\\ 0 - Two's complement coding.(default)\\ 1 - Offset binary coding. |
| **coding?** | Display the current coding style. |
| **register=** | Writes to the DAC register. Accepted values:\\ 0..262143 - the value written to the DAC. |
| **register?** | Displays last written value to the DAC register. |
| **voltage=** | Sets the DAC output voltage. Accepted values:\\ -10 .. +10 - desired output voltage in volts. |
| **voltage?** | Displays the output voltage. |
| **output=** | Selects the DAC output state. Accepted values:\\ 0 - Normal state.\\ 1 - Clamped via 6KOhm to AGND.(default)\\ 2 - Tristate. |
| **output?** | Displays the DAC output state. |
| **rbuf=** | Sets/resets the RBUF bit from control register. Accepted values:\\ 0 - RBUF is reset.\\ 1 - RBUF is set.(default) |
| **rbuf?** | Displays the value of RBUF bit from control register. |


Commands can be executed using a serial terminal connected to the UART peripheral of Xilinx KC705 FPGA.

The following image shows a generic list of commands in a serial terminal connected to Xilinx KC705 FPGA's UART peripheral.
{{ :resources:fpga:xilinx:interposer:Terminal_KC705.jpg? }}

===== Software Project Setup =====
{{page>import_workspace}}

====== More information ======
  * [[resources:tools-software:linux-drivers:iio-dac:ad5791|AD5781 IIO DAC Linux Driver]]
{{page>ez_common}}