From 8bca0f007189d8ebb3edd32732dbf77fa5ac506c Mon Sep 17 00:00:00 2001 From: Reymond Olmedo Date: Thu, 16 Jul 2026 15:23:58 +0800 Subject: [PATCH 1/2] ad57xx docs --- .../images/ad57xx_setup_hardware_coraz7s.jpeg | 3 + .../images/ad57xx_setup_hardware_de10nano.jpg | 3 + .../images/eval_ad5780ardz_top.jpg | 3 + .../images/eval_ad5781ardz_angle.jpg | 3 + .../reference-designs/ad57xx-ardz/index.rst | 155 +++++++ .../ad57xx-ardz/prerequisites.rst | 61 +++ .../ad57xx-ardz/quickstart/coraz7s.rst | 390 ++++++++++++++++++ .../ad57xx-ardz/quickstart/de10nano.rst | 271 ++++++++++++ .../ad57xx-ardz/quickstart/index.rst | 88 ++++ .../ad57xx-ardz/user-guide.rst | 120 ++++++ 10 files changed, 1097 insertions(+) create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_coraz7s.jpeg create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_de10nano.jpg create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5780ardz_top.jpg create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5781ardz_angle.jpg create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/index.rst create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/quickstart/index.rst create mode 100644 docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst diff --git a/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_coraz7s.jpeg b/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_coraz7s.jpeg new file mode 100644 index 00000000000..1de101dfb57 --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_coraz7s.jpeg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:64346fe112f22a9f6a4ffb1c2c3a9210d1fd1e4070dd4e3f82764e8b2f7492b9 +size 15915851 diff --git a/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_de10nano.jpg b/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_de10nano.jpg new file mode 100644 index 00000000000..3a31ef9db2b --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/images/ad57xx_setup_hardware_de10nano.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:28361cb40706bc837872fa46d286e985babb17adc4f096e553a214414ddfdd14 +size 17586771 diff --git a/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5780ardz_top.jpg b/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5780ardz_top.jpg new file mode 100644 index 00000000000..2da11a84845 --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5780ardz_top.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b881112a65918835a39ae2b96322e0573b0a7cd17e941e3c5d6579773fdaf538 +size 829992 diff --git a/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5781ardz_angle.jpg b/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5781ardz_angle.jpg new file mode 100644 index 00000000000..e3605901a0f --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/images/eval_ad5781ardz_angle.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:596c6013dcb69fc77a4893b09a78376f8bbe88abcf895c0b37cb199dcba5c029 +size 361578 diff --git a/docs/solutions/reference-designs/ad57xx-ardz/index.rst b/docs/solutions/reference-designs/ad57xx-ardz/index.rst new file mode 100644 index 00000000000..99790317b5e --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/index.rst @@ -0,0 +1,155 @@ +.. _ad57xx: + +EVAL-AD57XXARDZ +=============== + +Family of Precision, Single-Channel output DACs + +.. .. image:: images/ad57xx_chip.png + :align: left + :width: 150 + +Overview +------------------------------------------------------------------------------- + +The :adi:`EVAL-AD5780ARDZ` facilitates fast prototyping of the +:adi:`AD5780` circuit, and can be substituted with either the +:adi:`AD5760` or :adi:`AD5790`, which must be ordered separately. +Similarly, the :adi:`EVAL-AD5781ARDZ` and :adi:`EVAL-AD5791ARDZ` +come with the :adi:`AD5781` and :adi:`AD5791` respectively. + +The :adi:`AD5790`, :adi:`AD5791`, :adi:`AD5760`, :adi:`AD5780` +and :adi:`AD5781` are a family of precision, single-channel +voltage output DACs, with resolutions from 16-bits up to 20-bits. +They offer guaranteed monotonic operation, and low nonlinearity +(down to 0.5 LSB INL and DNL) + +The evaluation boards provide an on-board -14 V and +14 V dual +power supply. These evaluation boards also utilize external +reference boards with an output voltage of +10 V and -10 V. The +eval boards are connected to the carrier board through the +Arduino Shield connector. + +Features: + +- Precision, single-channel voltage output DACs +- Resolution options from 16 bits to 20 bits +- Guaranteed monotonic operation +- Low integral and differential nonlinearity + (down to 0.5 LSB INL and DNL, device dependent) +- Buffered voltage outputs +- Wide bipolar output voltage range support +- External precision reference input +- SPI-compatible serial interface +- Low noise and low glitch performance +- Industrial temperature range operation + +Applications: + +- Medical instrumentation +- Test and measurement equipment +- Industrial control systems +- Scientific instrumentation +- Aerospace and defense instrumentation +- Data acquisition systems +- Precision DC sources +- Digital gain and offset adjustment +- Power supply control and calibration + + .. grid:: + :widths: 50% 50% + + .. figure:: images/eval_ad5781ardz_angle.jpg + :width: 300 + + EVAL-AD5781ARDZ + + .. figure:: images/eval_ad5780ardz_top.jpg + :width: 400 + + EVAL-AD5780ARDZ + +.. toctree:: + :hidden: + + user-guide + prerequisites + quickstart/index + +Recommendations +------------------------------------------------------------------------------- + +People who follow the flow that is outlined, have a much better +experience with things. However, like many things, documentation +is never as complete as it should be. If you have any questions, +feel free to ask on our +:ref:`EngineerZone forums `, but before that, +please make sure you read our documentation thoroughly. + +To better understand the :adi:`AD5790` /:adi:`AD5791` +/:adi:`AD5760` /:adi:`AD5780` /:adi:`AD5781`, we recommend to +use the :adi:`EVAL-AD5780ARDZ` /:adi:`EVAL-AD5781ARDZ` +/:adi:`EVAL-AD5791ARDZ` evaluation boards. + +Table of contents +------------------------------------------------------------------------------- + +#. Using the evaluation board/full stack reference design that + we offer: + + #. :ref:`AD57xx user-guide ` - what you + need to know about the evaluation board + #. :ref:`Prerequisites ` - what you + need to get started + #. :ref:`Quick start guides `: + + #. Using the :ref:`AD57xx on Cora Z7S ` + #. Using the :ref:`AD57xx on DE10-Nano ` + + #. Configure an SD Card with + :external+kuiper:doc:`Kuiper ` + + #. Linux Applications + + #. :ref:`iio-oscilloscope` + +#. Design with the :adi:`AD5790` /:adi:`AD5791` /:adi:`AD5760` + /:adi:`AD5780` /:adi:`AD5781`: + + - :ref:`ad57xx block-diagrams` + #. :adi:`AD5780 product page ` + #. :adi:`AD5781 product page ` + #. :adi:`AD5790 product page ` + #. :adi:`AD5791 product page ` + #. :adi:`AD5760 product page ` + + - Resources for designing a custom AD57xx-based platform + + #. For Linux software: + + - About the device driver: + + - :git-linux:`AD5791 IIO DAC Linux Driver ` + + #. For no-OS software: + + - About the no-OS driver: + + - :git-no-os:`AD5791 no-OS driver source code ` + +.. _ad57xx block-diagrams: + +Block diagrams +------------------------------------------------------------------------------- + +The HDL block diagrams for this project are maintained in the +HDL repository: + +- :external+hdl:ref:`ad57xx_ardz` + +More Information and Useful Links +------------------------------------------------------------------------------- + +- :adi:`EVAL-AD5780ARDZ` +- :adi:`EVAL-AD5781ARDZ` +- :adi:`EVAL-AD5791ARDZ` diff --git a/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst b/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst new file mode 100644 index 00000000000..d078244a3fc --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst @@ -0,0 +1,61 @@ +.. _ad57xx prerequisites: + +Prerequisites +=============================================================================== + +What you need, depends on what you are trying to do. As a +minimum, you need to start out with: + +Hardware prerequisites +------------------------------------------------------------------------------- + +#. The AD57xx-based evaluation boards: + :adi:`EVAL-AD5780ARDZ`, :adi:`EVAL-AD5781ARDZ`, + or :adi:`EVAL-AD5791ARDZ`. +#. A voltage reference daughter board (EV-ADR445-REFZ is + included with each evaluation kit; EV-LTC6655-REFZ, + EV-LTZ1000-REFZ, or EV-ADR1001-REFZ are available + separately for improved performance). +#. An FPGA carrier platform. Our recommended ones can be found + :ref:`here `. + + - There are a few more boards, which do work, but are + currently not supported by us. The experience with the + fabric-only solutions is very close to the ARM/FPGA SoC + based solutions, but the GUI runs on a host PC (Windows + or Linux). + +#. Some way to interact with the FPGA platform: + + #. for the ARM/FPGA SoC platforms, this normally includes: + + - HDMI or DisplayPort monitor + - USB Keyboard + - USB Mouse + + #. for the FPGA only solutions, this includes: + + - LAN cable (Ethernet) + - Host PC (Windows or Linux) + +#. Internet connection (without proxies makes things much + easier) to update the scripts/binaries on the SD card + (firewalls are OK, proxies make things a pain). +#. An SD card with at least 16GB of memory (in case you're + using Linux). You should have received one when purchasing + the evaluation board. + +Software prerequisites +------------------------------------------------------------------------------- + +Normally, for basic functionalities regarding controlling the +DAC output and interfacing with the FPGA, we use the following: + +#. :external+scopy:doc:`Scopy ` v2.0 or later (must + contain the IIO plugin) + +.. note:: + + :adi:`ADI <>` does not offer FPGA carrier platforms for sale + or loan; getting one yourself is the normal part of + development or evaluation. diff --git a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst new file mode 100644 index 00000000000..65c8b76a83f --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst @@ -0,0 +1,390 @@ +.. _ad57xx-ardz quickstart coraz7s: + +CoraZ7-07S Quickstart +=============================================================================== + +This guide provides quick instructions on how to set up the +AD57xx on: + +- `Cora Z7S + `__ + on Arduino shield connector + +.. image:: ../../images/coraz7s.webp + :align: center + :width: 500 + +.. esd-warning:: + +Using Linux as software +------------------------------------------------------------------------------- + +Necessary files +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following files are needed to boot the system: + +- ``BOOT.BIN``, built from the HDL project; + follow :external+hdl:ref:`Build an HDL project ` +- ``devicetree.dtb``, compiled from the device tree source +- ``uImage``, the Linux kernel image; + follow :ref:`linux-kernel zynq` + +.. note:: + + Pre-built files for this reference design are not yet + available. The files must be built manually using the links + above. + For the HDL project, see :external+hdl:ref:`ad57xx_ardz` + build documentation. + For general HDL build instructions, see + :external+hdl:ref:`build_hdl`. + + HDL source: :git-hdl:`/projects/ad57xx_ardz/coraz7s` + +Copy ``BOOT.BIN``, ``devicetree.dtb``, and ``uImage`` to the +``BOOT`` partition of the SD card before inserting it. + +Required Software +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- SD Card 16GB imaged with + :external+kuiper:doc:`Kuiper ` (provides the root + filesystem; the HDL bitstream must be built separately as + described above) +- A UART terminal (Putty/Tera Term/Minicom, etc.) with baud + rate 115200 (8N1) + +Required Hardware +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- `Cora Z7S + `__ + FPGA board +- :adi:`EVAL-AD5780ARDZ`/ :adi:`EVAL-AD5781ARDZ`/ + :adi:`EVAL-AD5791ARDZ` evaluation board +- Voltage reference daughter board (EV-ADR445-REFZ included + with evaluation kit) +- Class 10 16GB SD Card +- Micro-USB cable (UART / Power) +- LAN cable (Ethernet) +- DMM or oscilloscope for measuring DAC output voltage + +More details as to why you need these can be found at +:ref:`ad57xx prerequisites`. + +Testing +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Creating the setup +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +AD57xx/CoraZ7-07S +""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +.. figure:: ../images/ad57xx_setup_hardware_coraz7s.jpeg + :align: center + :width: 800 + + AD57xx/CoraZ7-07S hardware setup for Linux. + +In the following example, we will prepare the evaluation setup +by connecting the AD57xx board to the CoraZ7-07S and configuring +it to produce a DAC output. + +Follow the steps in this order, to avoid damaging the +components: + +#. Get the `Cora Z7S + `__ +#. Configure CoraZ7-07S jumpers: + + .. figure:: ../../images/cora_hw_config.jpg + :align: center + :width: 500 + + CoraZ7-07S jumper configuration. + + .. list-table:: + :header-rows: 1 + :widths: 20 60 20 + + * - Jumper Location + - Description + - Shunt Placement + * - JP2 + - Selects how the CoraZ7-07s board boots. We want to + boot from the microSD card. + - Across Pins 1 & 2 + * - JP3 + - Selects how the CoraZ7-07s board is powered. We are + powering from the USB port. + - Across Pins 3 & 2 (labeled USB) + +#. Prepare the SD card: + + #. Validate, Format, and Flash the SD Card following the + :external+kuiper:doc:`Use Kuiper Image ` + guide. + #. Copy the built ``BOOT.BIN``, ``devicetree.dtb``, and + ``uImage`` to the ``BOOT`` partition of the SD card. + +#. Insert the microSD card into the CoraZ7-07S card slot + + .. grid:: + :widths: 50% 50% + + .. figure:: ../../images/cora_sdcard_insert.jpg + :width: 400 + + Insert SD card + + .. figure:: ../../images/cora_sdcard_connected.jpg + :width: 400 + + SD card connected + +#. Plug-in an Ethernet cable from your router/switch to the + Ethernet port on the FPGA board + + .. admonition:: Info + + If you don't have a network available and want to stream + data directly from the Ethernet port of the CoraZ7-07s to + the Ethernet port of your PC, that is still possible, but + requires some extra configuration. Please see the + :dokuwiki:`[Wiki] Network Configuration + ` + page for complete details. + +#. Ensure the voltage reference daughter board (EV-ADR445-REFZ + or equivalent) is connected to the J1, J4, and J9 connectors + on the evaluation board. +#. Using the Arduino pins, plug the :adi:`EVAL-AD5780ARDZ`/ + :adi:`EVAL-AD5781ARDZ`/ :adi:`EVAL-AD5791ARDZ` on top of + the CoraZ7-07S +#. Connect a DMM or oscilloscope to the VOUT or VOUT_BUFF + connector on the evaluation board to measure the DAC output + voltage. +#. Connect the UART port of CoraZ7-07S to a PC via Micro-USB + cable (DO NOT power on the device yet) +#. Power up the setup by plugging the Micro-USB cable into your + PC's USB port +#. Observe Kernel and serial console output messages on your + terminal + +Boot messages +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The following is what is printed in the serial console, after +you have connected to the proper ttyUSB or COM port: + +.. collapsible:: Complete boot log + + .. Add boot log output once available. + +Useful commands for the serial terminal +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The below commands are to be run in the serial terminal +connected to the FPGA. + +**Login Information** + +user: analog + +password: analog + +To find out the IP of the FPGA board, run the following command +and take the IP specified at "eth0 inet": + +.. shell:: + + $ifconfig + +To see the IIO devices detected, run: + +.. shell:: + + $iio_info | grep iio:device + +.. collapsible:: Complete iio_info output + + Add full iio_info output once available. + +To power off the system, run the following command, and wait for +the final message to be printed, then power off the FPGA board +from the switch as well. + +.. shell:: + + $poweroff + +To reboot the system, run: + +.. shell:: + + $reboot + +.. important:: + + Even though this is Linux, this is a persistent file system. + Care should be taken not to corrupt the file system -- please + shut down things, don't just turn off the power switch. + Depending on your monitor, the standard power off could be + hiding. You can do this from the terminal as well with + :code:`sudo shutdown -h now` or the above-mentioned command + for powering off. + +Scopy +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. important:: + Make sure to download/update to the latest version of + :external+scopy:doc:`Scopy `. + +:external+scopy:doc:`Scopy ` can be used to control the +DAC output voltage through the IIO plugin. Connect to the board +via its IP address, then use the DAC channel controls to set the +desired output code or voltage. + +.. Add Scopy DAC control screenshot. + +IIO Oscilloscope +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. important:: + Make sure to download/update to the latest version of + :git-iio-oscilloscope:`IIO Oscilloscope `. + +#. 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. +#. Press ``Refresh`` to display available IIO Devices and press + ``Connect``. + + .. Add IIO Oscilloscope connect screenshot. + +#. After the board is connected and a channel is enabled, hit + the play button. Then the data capture window can be seen + like in the shown picture. + + .. Add IIO Oscilloscope data capture screenshot. + +Using no-OS as software +------------------------------------------------------------------------------- + +Necessary files +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following files are needed for the system to boot: + +- HDL boot file: ``system_top.xsa`` +- no-OS project: + :git-no-os:`No-OS AD5791 driver ` + +Instructions on how to build the boot files from source can be +found here: + +- :git-no-os:`No-OS AD5791 driver source `. + More no-OS build details at + :external+no-OS:doc:`build_guide`. +- :external+hdl:ref:`ad57xx_ardz`. More HDL build details at + :external+hdl:ref:`build_hdl`. + +Required Software +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- AMD Xilinx Vivado and Vitis (downloading Vitis from `here + `_ + will include Vivado as well) +- An UART terminal (Putty/Tera Term/Minicom, etc.), Baud rate + 115200 (8N1) + +Required Hardware +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- `Cora Z7S + `__ + FPGA board +- :adi:`EVAL-AD5780ARDZ`/ :adi:`EVAL-AD5781ARDZ`/ + :adi:`EVAL-AD5791ARDZ` evaluation board +- Voltage reference daughter board (EV-ADR445-REFZ included + with evaluation kit) +- Micro-USB cable (UART / Power / JTAG) +- DMM or oscilloscope for measuring DAC output voltage + +More details as to why you need these can be found at +:ref:`ad57xx prerequisites`. + +Testing +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Creating the setup +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +AD57xx/CoraZ7-07S +""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + +.. figure:: ../images/ad57xx_setup_hardware_coraz7s.jpeg + :align: center + :width: 500 + + AD57xx/CoraZ7-07S hardware setup for no-OS. + +In the following example, we will prepare the evaluation setup +by connecting the :adi:`EVAL-AD5780ARDZ`/ +:adi:`EVAL-AD5781ARDZ`/ :adi:`EVAL-AD5791ARDZ` board to the +CoraZ7-07S and configuring the board for JTAG boot. + +Follow the steps in this order, to avoid damaging the +components: + +#. Get the `Cora Z7S + `__ +#. Configure CoraZ7-07S for JTAG boot. Remove jumper JP2 to set + JTAG boot mode. JP3 should remain set to USB power + (Pins 3 & 2). + + .. figure:: ../../images/cora_hw_config.jpg + :align: center + :width: 500 + + CoraZ7-07S jumper configuration for JTAG boot mode. + + .. important:: + + You can keep the JP2 jumper in place, but it is important + to make sure no SD card is inserted in the CoraZ7-07S + when booting in JTAG mode. + +#. Ensure the voltage reference daughter board is connected to + the evaluation board. +#. Using the Arduino pins, plug the :adi:`EVAL-AD5780ARDZ`/ + :adi:`EVAL-AD5781ARDZ`/ :adi:`EVAL-AD5791ARDZ` on top of + the CoraZ7-07S. +#. Connect a DMM or oscilloscope to the VOUT or VOUT_BUFF + connector to measure the DAC output. +#. Connect the UART port of CoraZ7-07S to a PC via Micro-USB + cable. +#. Power up the setup by plugging the Micro-USB cable into your + PC's USB port. +#. Observe serial console output messages on your terminal. + +Console output +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The following is what is printed in the serial console, after +you have connected to the proper ttyUSB or COM port: + +.. collapsible:: Complete boot log + + .. To be added once available. + +.. note:: + + The DAC configuration output will print in the console + showing the register writes and voltage output status. The + program will complete once the DAC is configured with the + target output value. diff --git a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst new file mode 100644 index 00000000000..0a2094daa9b --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst @@ -0,0 +1,271 @@ +.. _ad57xx-ardz quickstart de10nano: + +DE10-Nano Quickstart +=============================================================================== + +This guide provides quick instructions on how to set up the +AD57xx on: + +- :intel:`DE10-Nano ` + on Arduino shield connector + +.. image:: ../../images/de10nano.jpg + :align: center + :width: 500 + +.. esd-warning:: + +Using Linux as software +------------------------------------------------------------------------------- + +Necessary files +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following files are needed to boot the system: + +- ``system_top.rbf``, HDL bitstream built from + :external+hdl:ref:`Build an HDL project ` +- ``u-boot-with-spl.sfp``, SPL and U-Boot bootloader +- ``socfpga.dtb``, compiled device tree blob +- ``zImage``, the Linux kernel image + +.. note:: + + Pre-built files for this reference design are not yet + available. The bitstream must be built manually following the + :external+hdl:ref:`ad57xx_ardz` build documentation. + For general HDL build instructions, see + :external+hdl:ref:`build_hdl`. + + HDL source: :git-hdl:`/projects/ad57xx_ardz/de10nano` + +Copy the built files to the ``BOOT`` partition of the SD card. +The Kuiper boot flow loads the bitstream automatically via the +extlinux boot sequence. + +Required Software +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- SD Card 16GB imaged with + :external+kuiper:doc:`Kuiper ` (provides the root + filesystem; the HDL bitstream must be built separately as + described above) +- A UART terminal (Putty/Tera Term/Minicom, etc.) with baud + rate 115200 (8N1) + +Required Hardware +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- :intel:`DE10-Nano ` + FPGA board + + - 5V/2A wall power supply with barrel jack (comes with + DE10-Nano) + - Mini-USB to USB Type A cable (comes with DE10-Nano) + +- :adi:`EVAL-AD5780ARDZ`/ :adi:`EVAL-AD5781ARDZ`/ + :adi:`EVAL-AD5791ARDZ` evaluation board +- Voltage reference daughter board (EV-ADR445-REFZ included + with evaluation kit) +- Class 10 16GB SD Card +- LAN cable (Ethernet) +- DMM or oscilloscope for measuring DAC output voltage + +More details as to why you need these can be found at +:ref:`ad57xx prerequisites`. + +Testing +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Creating the setup +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +AD57xx/DE10-Nano +""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" + + .. figure:: ../images/ad57xx_setup_hardware_de10nano.jpg + :align: center + :width: 500 + + AD57xx/DE10-Nano hardware setup. + +In the following example, we will prepare the evaluation setup +by connecting the AD57xx board to the DE10-Nano and configuring +it to produce a DAC output. + +Follow the steps in this order, to avoid damaging the +components: + +#. Get the + :intel:`DE10-Nano ` +#. Verify the FPGA Configuration Mode Switch (S10) is + configured properly: + + .. image:: ../../images/de10-nano_fpga_switch_matrix.png + :align: center + :width: 800 + + The DE10-Nano comes ready to use out of the box, but it is + important to double check that the FPGA Configuration Mode + Switch (S10) is set correctly. If more information is + needed, check out the + `DE10-Nano Getting Started Guide `__. + +#. Prepare the SD card: + + #. Validate, Format, and Flash the SD Card following the + :external+kuiper:doc:`Use Kuiper Image ` + guide. + #. Copy the built ``system_top.rbf``, ``socfpga.dtb``, and + ``zImage`` to the ``BOOT`` partition of the SD card. + +#. Insert the microSD card into the DE10-Nano card slot + + .. grid:: + :widths: 50% 50% + + .. figure:: ../../images/de10-nano_sdcard_insert.jpg + :width: 400 + + Insert SD card + + .. figure:: ../../images/de10-nano_sdcard_connected.jpg + :width: 400 + + SD card connected + +#. Plug-in an Ethernet cable from your router/switch to the + Ethernet port on the FPGA board + + .. admonition:: Info + + If you don't have a network available and want to stream + data directly from the Ethernet port of the DE10-Nano to + the Ethernet port of your PC, that is still possible, but + requires some extra configuration. Please see the + :dokuwiki:`[Wiki] Network Configuration + ` + page for complete details. + +#. Ensure the voltage reference daughter board (EV-ADR445-REFZ + or equivalent) is connected to the J1, J4, and J9 connectors + on the evaluation board. +#. Using the Arduino pins, plug the :adi:`EVAL-AD5780ARDZ`/ + :adi:`EVAL-AD5781ARDZ`/ :adi:`EVAL-AD5791ARDZ` on top of + the DE10-Nano +#. Connect a DMM or oscilloscope to the VOUT or VOUT_BUFF + connector on the evaluation board to measure the DAC output + voltage. +#. Connect the UART port of DE10-Nano to a PC via Mini-USB + cable (DO NOT power on the device yet) + + .. note:: + + A driver for the board should automatically be detected + and installed on your PC. If this does not happen, you + may need to manually install the driver. Here is a link + to the + `UART Serial Driver `__. + +#. Plug the 5V/2A power supply into the wall outlet and power + up the setup +#. Observe Kernel and serial console output messages on your + terminal + +Boot messages +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The following is what is printed in the serial console, after +you have connected to the proper ttyUSB or COM port: + +.. collapsible:: Complete boot log + + .. Add boot log output once available. + +Useful commands for the serial terminal +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The below commands are to be run in the serial terminal +connected to the FPGA. + +**Login Information** + +user: analog +password: analog + +To find out the IP of the FPGA board, run the following command +and take the IP specified at "eth0 inet": + +.. shell:: + + $ifconfig + +To see the IIO devices detected, run: + +.. shell:: + + $iio_info | grep iio:device + +.. collapsible:: Complete iio_info output + + .. Add full iio_info output once available. + +To power off the system, run the following command, and wait for +the final message to be printed, then power off the FPGA board +from the switch as well. + +.. shell:: + + $poweroff + +To reboot the system, run: + +.. shell:: + + $reboot + +.. important:: + + Even though this is Linux, this is a persistent file system. + Care should be taken not to corrupt the file system -- please + shut down things, don't just turn off the power switch. + Depending on your monitor, the standard power off could be + hiding. You can do this from the terminal as well with + :code:`sudo shutdown -h now` or the above-mentioned command + for powering off. + +Scopy +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. important:: + Make sure to download/update to the latest version of + :external+scopy:doc:`Scopy `. + +:external+scopy:doc:`Scopy ` can be used to control the +DAC output voltage through the IIO plugin. Connect to the board +via its IP address, then use the DAC channel controls to set the +desired output code or voltage. + +.. Add Scopy DAC control screenshot. + +IIO Oscilloscope +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. important:: + Make sure to download/update to the latest version of + :git-iio-oscilloscope:`IIO Oscilloscope `. + +#. 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. +#. Press ``Refresh`` to display available IIO Devices and press + ``Connect``. + + .. Add IIO Oscilloscope connect screenshot. + +#. After the board is connected and a channel is enabled, hit + the play button. Then the data capture window can be seen + like in the shown picture. + + .. Add IIO Oscilloscope data capture screenshot. diff --git a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/index.rst b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/index.rst new file mode 100644 index 00000000000..bd2c60a8d19 --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/index.rst @@ -0,0 +1,88 @@ +.. _ad57xx-ardz quickstart: + +Quickstart +=============================================================================== + +The Quick start guides provide simple step by step instructions +on how to do an initial system setup for the AD57xx evaluation +boards (EVAL-AD5780ARDZ, EVAL-AD5781ARDZ, EVAL-AD5791ARDZ) on +various FPGA development boards. In these guides, we will discuss +how to program the bitstream, run a no-OS program or boot a +Linux distribution. + +.. toctree:: + + CoraZ7-07s + DE10-Nano + +.. _ad57xx-ardz carriers: + +Supported carriers +------------------------------------------------------------------------------- + +The AD57xx evaluation boards support precision, single-channel +voltage output DACs with various resolution and range options. +These compact evaluation boards are designed to work with +multiple FPGA development platforms via Arduino shield +connectors. + +The carriers we support are: + +.. list-table:: + :header-rows: 1 + + - - FPGA board + - AD57xx evaluation boards + - - `Cora Z7S `__ + - Arduino shield connector + - - :intel:`DE10-Nano ` + - Arduino shield connector + +Supported Environments +------------------------------------------------------------------------------- + +The supported OS are: + +.. list-table:: + :header-rows: 1 + + - - FPGA board + - HDL + - Linux software + - No-OS software + - - `Cora Z7S `__ + - Yes + - Yes + - Yes + - - :intel:`DE10-Nano ` + - Yes + - Yes + - No + +Hardware Setup +------------------------------------------------------------------------------- + +The AD57xx evaluation boards connect to the Arduino Shield +connector (unless otherwise noted). The carrier setup requires +power, UART (115200), ethernet (Linux), and/or JTAG (no-OS) +connections. + +A few typical setups are shown below. + +CoraZ7-07s + AD57xx +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. figure:: ../images/ad57xx_setup_hardware_coraz7s.jpeg + :align: center + :width: 600 + + CoraZ7-07s + AD57xx hardware setup. + +DE10-Nano + AD57xx +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. figure:: ../images/ad57xx_setup_hardware_de10nano.jpg + :align: center + :width: 600 + + DE10-Nano + AD57xx hardware setup. diff --git a/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst b/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst new file mode 100644 index 00000000000..345240d3edd --- /dev/null +++ b/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst @@ -0,0 +1,120 @@ +.. _ad57xx user-guide: + +User guide +=============================================================================== + +Hardware guide +------------------------------------------------------------------------------- + +Hardware configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The AD57xx evaluation boards (EVAL-AD5780ARDZ, EVAL-AD5781ARDZ, +or EVAL-AD5791ARDZ) connect to FPGA carrier boards through an +Arduino shield connector. These evaluation boards provide the +necessary connections for interfacing the precision, +high-resolution DACs (:adi:`AD5780`, :adi:`AD5781`, +:adi:`AD5790`, :adi:`AD5791`, :adi:`AD5760`) to various FPGA +platforms. + +Refer to the respective quickstart guides for the exact jumper +and switch settings corresponding to your selected FPGA carrier +and boot mode: + +- :ref:`ad57xx-ardz quickstart coraz7s` for CoraZ7-07S + configuration +- :ref:`ad57xx-ardz quickstart de10nano` for DE10-Nano + configuration + +Power supply +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The AD57xx evaluation boards feature on-board dual power supplies +generated by ADP5070-based power circuits. Each board can also +accept external linear power supplies through dedicated on-board +connectors. + +Refer to the specific evaluation board user guide for detailed +power supply specifications, connector pinouts, and +configuration options: + +- `UG-2209 `_ + for the EVAL-AD5780ARDZ +- `UG-2225 `_ + for the EVAL-AD5781ARDZ and EVAL-AD5791ARDZ + +Analog outputs +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The AD57xx evaluation boards provide buffered analog output +connections for the DAC through on-board output connectors. The +DAC output signals are routed directly to external connectors, +allowing connection to measurement equipment or downstream signal +processing circuits. + +Each evaluation board supports a wide bipolar output voltage +range. Link options and jumper settings are provided for signal +routing configuration. Refer to the evaluation board user guide +and schematic for detailed information on output signal +conditioning and optional filtering networks. + +Digital interface +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The digital interface uses the SPI serial protocol for device +control and data transfer: + +- SPI (Serial Peripheral Interface) for DAC register + configuration and data loading (SDIN, SDO, SCLK, SYNC + signals) +- GPIO signals for LDAC, CLR, and RESET control + +The Arduino shield connector provides access to all digital +interface signals required for FPGA integration and system +control. + +Schematic, PCB Layout, Bill of Materials +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Design files (schematics, PCB layout, and BOM) are available +from the respective product pages: + +- :adi:`EVAL-AD5780ARDZ` +- :adi:`EVAL-AD5781ARDZ` +- :adi:`EVAL-AD5791ARDZ` + +Software guide +------------------------------------------------------------------------------- + +The evaluation board is supported by multiple software +environments: + +**Linux Software** + The AD57xx evaluation board is supported on FPGA carriers + running Linux distributions. The board integrates with the IIO + (Industrial I/O) subsystem, providing user-space applications + for device control and data capture through standard Linux + interfaces. + +**No-OS Software** + For bare-metal or embedded applications, the AD57xx evaluation + board can be controlled using the no-OS embedded software + framework. This approach provides direct hardware control with + minimal overhead, suitable for real-time applications and + resource-constrained systems. + +**PC-Based Tools** + The AD57xx can be evaluated using PC-based software tools + including: + + - :external+scopy:doc:`Scopy ` - graphical waveform + generator and oscilloscope application + - :git-iio-oscilloscope:`IIO Oscilloscope ` - + advanced data acquisition and analysis tool + +For a step-by-step walkthrough of connecting and using these +tools with the AD57xx on various FPGA carriers, see the +quickstart guides: + +- :ref:`ad57xx-ardz quickstart coraz7s` for CoraZ7-07S setup +- :ref:`ad57xx-ardz quickstart de10nano` for DE10-Nano setup From 4020d81f304214fc66f70c44e5889489f4f557ef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mr=2E=20Codepr=C3=BCfer?= Date: Fri, 17 Jul 2026 15:16:52 +0000 Subject: [PATCH 2/2] fixup! ad57xx docs Signed-off-by: github-actions[bot] --- .../reference-designs/ad57xx-ardz/index.rst | 24 +++++++++---------- .../ad57xx-ardz/prerequisites.rst | 6 ++--- .../ad57xx-ardz/quickstart/coraz7s.rst | 8 +++---- .../ad57xx-ardz/quickstart/de10nano.rst | 10 ++++---- .../ad57xx-ardz/user-guide.rst | 4 ++-- 5 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/solutions/reference-designs/ad57xx-ardz/index.rst b/docs/solutions/reference-designs/ad57xx-ardz/index.rst index 99790317b5e..d6acb3af139 100644 --- a/docs/solutions/reference-designs/ad57xx-ardz/index.rst +++ b/docs/solutions/reference-designs/ad57xx-ardz/index.rst @@ -1,4 +1,4 @@ -.. _ad57xx: +.. _ad57xx: EVAL-AD57XXARDZ =============== @@ -56,18 +56,18 @@ Applications: - Digital gain and offset adjustment - Power supply control and calibration - .. grid:: - :widths: 50% 50% +.. grid:: + :widths: 50% 50% - .. figure:: images/eval_ad5781ardz_angle.jpg - :width: 300 + .. figure:: images/eval_ad5781ardz_angle.jpg + :width: 300 - EVAL-AD5781ARDZ + EVAL-AD5781ARDZ - .. figure:: images/eval_ad5780ardz_top.jpg - :width: 400 + .. figure:: images/eval_ad5780ardz_top.jpg + :width: 400 - EVAL-AD5780ARDZ + EVAL-AD5780ARDZ .. toctree:: :hidden: @@ -109,7 +109,7 @@ Table of contents #. Configure an SD Card with :external+kuiper:doc:`Kuiper ` - #. Linux Applications + #. linux Applications #. :ref:`iio-oscilloscope` @@ -125,11 +125,11 @@ Table of contents - Resources for designing a custom AD57xx-based platform - #. For Linux software: + #. For linux software: - About the device driver: - - :git-linux:`AD5791 IIO DAC Linux Driver ` + - :git-linux:`AD5791 IIO DAC linux Driver ` #. For no-OS software: diff --git a/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst b/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst index d078244a3fc..4ad5388e474 100644 --- a/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst +++ b/docs/solutions/reference-designs/ad57xx-ardz/prerequisites.rst @@ -23,7 +23,7 @@ Hardware prerequisites currently not supported by us. The experience with the fabric-only solutions is very close to the ARM/FPGA SoC based solutions, but the GUI runs on a host PC (Windows - or Linux). + or linux). #. Some way to interact with the FPGA platform: @@ -36,13 +36,13 @@ Hardware prerequisites #. for the FPGA only solutions, this includes: - LAN cable (Ethernet) - - Host PC (Windows or Linux) + - Host PC (Windows or linux) #. Internet connection (without proxies makes things much easier) to update the scripts/binaries on the SD card (firewalls are OK, proxies make things a pain). #. An SD card with at least 16GB of memory (in case you're - using Linux). You should have received one when purchasing + using linux). You should have received one when purchasing the evaluation board. Software prerequisites diff --git a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst index 65c8b76a83f..638654a8f33 100644 --- a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst +++ b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/coraz7s.rst @@ -16,7 +16,7 @@ AD57xx on: .. esd-warning:: -Using Linux as software +Using linux as software ------------------------------------------------------------------------------- Necessary files @@ -25,9 +25,9 @@ Necessary files The following files are needed to boot the system: - ``BOOT.BIN``, built from the HDL project; - follow :external+hdl:ref:`Build an HDL project ` + follow :external+hdl:ref:`build_hdl` - ``devicetree.dtb``, compiled from the device tree source -- ``uImage``, the Linux kernel image; +- ``uImage``, the linux kernel image; follow :ref:`linux-kernel zynq` .. note:: @@ -86,7 +86,7 @@ AD57xx/CoraZ7-07S :align: center :width: 800 - AD57xx/CoraZ7-07S hardware setup for Linux. + AD57xx/CoraZ7-07S hardware setup for linux. In the following example, we will prepare the evaluation setup by connecting the AD57xx board to the CoraZ7-07S and configuring diff --git a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst index 0a2094daa9b..420d2adf03e 100644 --- a/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst +++ b/docs/solutions/reference-designs/ad57xx-ardz/quickstart/de10nano.rst @@ -24,7 +24,7 @@ Necessary files The following files are needed to boot the system: - ``system_top.rbf``, HDL bitstream built from - :external+hdl:ref:`Build an HDL project ` + :external+hdl:ref:`build_hdl` - ``u-boot-with-spl.sfp``, SPL and U-Boot bootloader - ``socfpga.dtb``, compiled device tree blob - ``zImage``, the Linux kernel image @@ -83,11 +83,11 @@ Creating the setup AD57xx/DE10-Nano """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - .. figure:: ../images/ad57xx_setup_hardware_de10nano.jpg - :align: center - :width: 500 +.. figure:: ../images/ad57xx_setup_hardware_de10nano.jpg + :align: center + :width: 500 - AD57xx/DE10-Nano hardware setup. + AD57xx/DE10-Nano hardware setup. In the following example, we will prepare the evaluation setup by connecting the AD57xx board to the DE10-Nano and configuring diff --git a/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst b/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst index 345240d3edd..74403db8fb8 100644 --- a/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst +++ b/docs/solutions/reference-designs/ad57xx-ardz/user-guide.rst @@ -38,9 +38,9 @@ Refer to the specific evaluation board user guide for detailed power supply specifications, connector pinouts, and configuration options: -- `UG-2209 `_ +- :adi:`UG-2209 ` for the EVAL-AD5780ARDZ -- `UG-2225 `_ +- :adi:`UG-2225 ` for the EVAL-AD5781ARDZ and EVAL-AD5791ARDZ Analog outputs