From 16712da332f53f613557d6759451e26d4c70fd18 Mon Sep 17 00:00:00 2001 From: Stanca Pop Date: Fri, 12 Dec 2025 17:26:36 +0200 Subject: [PATCH] eval_ad902x: Doc review & update Signed-off-by: Stanca Pop --- .../reference-designs/eval-adrv902x/index.rst | 8 +-- .../eval-adrv902x/quickstart/index.rst | 16 ++--- .../quickstart/{versal.rst => vck190.rst} | 68 +++++++++---------- .../quickstart/{zynqmp.rst => zcu102.rst} | 47 +++++++------ 4 files changed, 67 insertions(+), 72 deletions(-) rename docs/solutions/reference-designs/eval-adrv902x/quickstart/{versal.rst => vck190.rst} (96%) rename docs/solutions/reference-designs/eval-adrv902x/quickstart/{zynqmp.rst => zcu102.rst} (99%) diff --git a/docs/solutions/reference-designs/eval-adrv902x/index.rst b/docs/solutions/reference-designs/eval-adrv902x/index.rst index 8b2a5148e..d96c3d759 100644 --- a/docs/solutions/reference-designs/eval-adrv902x/index.rst +++ b/docs/solutions/reference-designs/eval-adrv902x/index.rst @@ -1,6 +1,6 @@ .. _adrv902x: -ADRV902X +EVAL-ADRV902X =============================================================================== .. image:: ../images/adrv9026.webp @@ -81,9 +81,9 @@ Table of contents #. :ref:`Prerequisites ` - what you need to get started #. :ref:`Quick start guides `: - #. Using the :ref:`ZCU102/Zynq UltraScale MP SoC ` - #. Using the :ref:`VCK190/Versal ` - + #. Using the :ref:`VCK190/Versal ` + #. Using the :ref:`ZCU102/Zynq UltraScale+ MP SoC ` + #. Configure an SD Card with :external+adi-kuiper-gen:doc:`Kuiper ` #. Linux Applications diff --git a/docs/solutions/reference-designs/eval-adrv902x/quickstart/index.rst b/docs/solutions/reference-designs/eval-adrv902x/quickstart/index.rst index 73a47e2cf..10f63ed02 100644 --- a/docs/solutions/reference-designs/eval-adrv902x/quickstart/index.rst +++ b/docs/solutions/reference-designs/eval-adrv902x/quickstart/index.rst @@ -10,8 +10,8 @@ to program the bitstream, run a no-OS program or boot a Linux distribution. .. toctree:: - On VCK190 - On ZCU102 + On VCK190 + On ZCU102 .. _adrv902x carriers: @@ -80,11 +80,10 @@ connects to the HPC1 connector (unless otherwise noted). The carrier setup requires power, UART (115200), Ethernet (Linux), HDMI (if available) and/or JTAG (no-OS) connections. A few typical setups are shown below. -ZCU102 + EVAL-ADRV9026/ADRV9029 +A10SoC + EVAL-ADRV9026/ADRV9029 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. image:: ../../images/adrv9026_zcu102_setup.jpg - :width: 800 +TO BE ADDED VCK190 + EVAL-ADRV9026/ADRV9029 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -92,15 +91,16 @@ VCK190 + EVAL-ADRV9026/ADRV9029 .. image:: ../../images/adrv9026_vck190_setup.jpg :width: 800 -A10SoC + EVAL-ADRV9026/ADRV9029 +VCU118 + EVAL-ADRV9026/ADRV9029 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ TO BE ADDED -VCU118 + EVAL-ADRV9026/ADRV9029 +ZCU102 + EVAL-ADRV9026/ADRV9029 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -TO BE ADDED +.. image:: ../../images/adrv9026_zcu102_setup.jpg + :width: 800 Unboxing guide ------------------------------------------------------------------------------- diff --git a/docs/solutions/reference-designs/eval-adrv902x/quickstart/versal.rst b/docs/solutions/reference-designs/eval-adrv902x/quickstart/vck190.rst similarity index 96% rename from docs/solutions/reference-designs/eval-adrv902x/quickstart/versal.rst rename to docs/solutions/reference-designs/eval-adrv902x/quickstart/vck190.rst index 61373c6eb..0b4ffb4ae 100644 --- a/docs/solutions/reference-designs/eval-adrv902x/quickstart/versal.rst +++ b/docs/solutions/reference-designs/eval-adrv902x/quickstart/vck190.rst @@ -1,4 +1,4 @@ -.. _adrv902x quickstart versal: +.. _adrv902x quickstart vck190: VCK190 Quick start =============================================================================== @@ -78,46 +78,46 @@ Creating the setup Follow the steps in this order, to avoid damaging the components: -- Connect the :adi:`EVAL-ADRV9026/ADRV9029 ` FMC board to the - FPGA carrier FMC+ FMCP1 socket -- Connect USB UART J207 (Type-C USB) to your host PC -- Insert SD card with ADI Kuiper image into socket J302 -- Insert System Controller SD card into socket J206 -- Configure ACAP for SD boot (mode SW1[4:1] switch in the position - **OFF,OFF,OFF,ON** as seen in the below picture) +#. Connect the :adi:`EVAL-ADRV9026/ADRV9029 ` FMC board to the + FPGA carrier FMC+ FMCP1 socket +#. Connect USB UART J207 (Type-C USB) to your host PC +#. Insert SD card with ADI Kuiper image into socket J302 +#. Insert System Controller SD card into socket J206 +#. Configure ACAP for SD boot (mode SW1[4:1] switch in the position + **OFF,OFF,OFF,ON** as seen in the below picture) -.. image:: ../../images/vck190_sw1.jpg - :width: 200 + .. image:: ../../images/vck190_sw1.jpg + :width: 200 -- Configure System Controller for SD card boot (mode SW11[4:1] switch in the +#. Configure System Controller for SD card boot (mode SW11[4:1] switch in the position **OFF,OFF,OFF,ON** as seen in the below picture). -.. image:: ../../images/vck190_sw11.jpg - :width: 200 + .. image:: ../../images/vck190_sw11.jpg + :width: 200 -- Connect an Ethernet cable to J307 and also to SYSCTL Ethernet port to access - Board Evaluation & Management Tool (BEAM); -- Turn on the power switch on the FPGA board; -- Observe kernel and serial console messages on your terminal, both the ACAP - UART interface and the System controller. (use the first ttyUSB or COM port - registered for the ACAP UART interface, and try the other 2 to find the one - for System Controller); -- On the System Controller console, a BEAM Tool Web Address should be assigned. - Go to this web address to set VADJ_FMC to 1.5V; -- To change VADJ_FMC On BEAM, click 'Test The Board'>'Board Settings'>'FMC'. - Then on 'Set VADJ_FMC', select 1.5V and click 'Set'. +#. Connect an Ethernet cable to J307 and also to SYSCTL Ethernet port to access + Board Evaluation & Management Tool (BEAM); +#. Turn on the power switch on the FPGA board; +#. Observe kernel and serial console messages on your terminal, both the ACAP + UART interface and the System controller. (use the first ttyUSB or COM port + registered for the ACAP UART interface, and try the other 2 to find the one + for System Controller); +#. On the System Controller console, a BEAM Tool Web Address should be assigned. + Go to this web address to set VADJ_FMC to 1.5V; +#. To change VADJ_FMC On BEAM, click 'Test The Board'>'Board Settings'>'FMC'. + Then on 'Set VADJ_FMC', select 1.5V and click 'Set'. -.. image:: beam-home.jpg - :width: 1000 + .. image:: beam-home.jpg + :width: 1000 -.. image:: beam-board-settings.jpg - :width: 1000 + .. image:: beam-board-settings.jpg + :width: 1000 -.. image:: beam-set-vadj.jpg - :width: 1000 + .. image:: beam-set-vadj.jpg + :width: 1000 -- On the ACAP UART interface console, reboot the system. After reboot, - adrv9026 devices should be present. +#. On the ACAP UART interface console, reboot the system. After reboot, + ADRV9026 devices should be present. .. note:: @@ -895,10 +895,6 @@ To reboot the system, run: About the IIO devices ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. - This section is with ^^^ because the last section from using-iio-osc.rst which - is included previously, has the last section as ^^^. - Main receivers RX1, RX2, RX3, and RX4 are handled by the axi-adrv9025-rx-hpc IIO device. Channels: diff --git a/docs/solutions/reference-designs/eval-adrv902x/quickstart/zynqmp.rst b/docs/solutions/reference-designs/eval-adrv902x/quickstart/zcu102.rst similarity index 99% rename from docs/solutions/reference-designs/eval-adrv902x/quickstart/zynqmp.rst rename to docs/solutions/reference-designs/eval-adrv902x/quickstart/zcu102.rst index a0f1312d0..f42c6bb2b 100644 --- a/docs/solutions/reference-designs/eval-adrv902x/quickstart/zynqmp.rst +++ b/docs/solutions/reference-designs/eval-adrv902x/quickstart/zcu102.rst @@ -1,10 +1,12 @@ -.. _adrv902x quickstart zynqmp: +.. _adrv902x quickstart zcu102: ZCU102 Quick start =============================================================================== -.. image:: ../../images/adrv9026_zcu102_setup.jpg - :width: 800 +.. image:: ../../images/zcu102.jpg + :width: 900 + +.. esd-warning:: This guide provides quick instructions on how to setup the :adi:`EVAL-ADRV9026/ADRV9029 ` on: @@ -61,29 +63,28 @@ Testing Creating the setup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. image:: ../../images/zcu102.jpg - :width: 900 - -.. esd-warning:: +.. image:: ../../images/adrv9026_zcu102_setup.jpg + :width: 800 Follow the steps in this order, to avoid damaging the components: #. Connect the :adi:`EVAL-ADRV9026/ADRV9029 ` FMC board to the - FPGA carrier **HPC1** FMC1 socket + ZCU102 **HPC1** FMC1 socket #. Insert SD card into the SD card socket on the FPGA #. Configure :xilinx:`ZCU102` for SD card boot mode (mode SW6[4:1] switch in the position **OFF,OFF,OFF,ON** as seen in the below picture) + + .. image:: ../../images/zcu102_1p0_bootmode.jpg + :width: 400 + #. Plug-in an Ethernet cable from your router/switch to the Ethernet port on the FPGA board -#. Connect USB UART J83 (Micro USB) to your host PC +#. Connect USB UART J83 (Micro-USB) to your host PC #. (Optional) Connect a monitor to the FPGA by HDMI, and a mouse and a keyboard #. Turn on the power switch on the FPGA board #. Observe Kernel and serial console output messages on your terminal (use the first ttyUSB or COM port registered) -.. image:: ../../images/zcu102_1p0_bootmode.jpg - :width: 400 - Boot messages ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -1009,17 +1010,14 @@ To reboot the system, run: 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. + :code:`sudo shutdown -h now` or the above-mentioned command for powering + off. .. include:: ../../common/using-iio-osc.rst About the IIO devices ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. - This section is with ^^^ because the last section from using-iio-osc.rst which - is included previously, has the last section as ^^^. - Main receivers RX1, RX2, RX3, and RX4 are handled by the axi-adrv9025-rx-hpc IIO device. Channels: @@ -1075,19 +1073,17 @@ Testing Creating the setup ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. image:: ../../images/zcu102.jpg - :width: 900 - -.. esd-warning:: +.. image:: ../../images/adrv9026_zcu102_setup.jpg + :width: 800 Follow the steps in this order, to avoid damaging the components: #. Connect the :adi:`EVAL-ADRV9026/ADRV9029 ` FMC board to the - FPGA carrier **HPC1** FMC1 socket + ZCU102 **HPC1** FMC1 socket #. Configure :xilinx:`ZCU102` for JTAG boot mode (mode SW6[4:1] switch in the position **ON,ON,ON,ON**) -#. Connect USB UART J83 (Micro USB) to your host PC -#. Connecy USB JTAG (Micro USB) to your host PC +#. Connect USB UART J83 (Micro-USB) to your host PC +#. Connect USB JTAG (Micro-USB) to your host PC #. (Optional) Connect a monitor to the FPGA by HDMI, and a mouse and a keyboard #. Turn on the power switch on the FPGA board #. Observe console output messages on your terminal (use the first ttyUSB or @@ -1104,3 +1100,6 @@ connected to the proper ttyUSB or COM port: :: Xilinx Zynq MP First Stage Boot Loader + +.. + TBD \ No newline at end of file