Skip to content

Commit 19ba81e

Browse files
deploy: e2b7b89
1 parent 1e7b02b commit 19ba81e

File tree

221 files changed

+4549
-674
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

221 files changed

+4549
-674
lines changed

_sources/solutions/reference-designs/eval-ad9081/index.rst.txt

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,8 +94,11 @@ Table of contents
9494
#. :ref:`ad9081 quickstart`:
9595

9696
#. Using the :ref:`Arria 10 SX SoC <ad9081 quickstart a10soc>`
97-
#. Using the :ref:`VCK190 & VPK180/Versal <ad9081 quickstart versal>`
98-
#. Using the :ref:`ZCU102/Zynq UltraScale MP SoC <ad9081 quickstart zynqmp>`
97+
#. Using the :ref:`VCK190 & VPK180/Versal <ad9081 quickstart vck190>`
98+
#. Using the :ref:`VCU118/ Virtex UltraScale+ <ad9081 quickstart vcu118>`
99+
#. Using the :ref:`ZC706/ Zynq-7000 SoC <ad9081 quickstart zc706>`
100+
#. Using the :ref:`ZCU102/Zynq UltraScale+ MP SoC <ad9081 quickstart zcu102>`
101+
99102

100103
#. Configure an SD Card with :external+adi-kuiper-gen:doc:`Kuiper <index>`
101104

_sources/solutions/reference-designs/eval-ad9081/prerequisites.rst.txt

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ Hardware prerequisites
3232
- LAN cable (Ethernet)
3333
- Host PC (Windows or Linux)
3434

35-
#. Internet connection (without proxies makes things much easier) to update the
36-
scripts/binaries on the SD card that came with the ADI FMC Card (firewalls
37-
are OK, proxies make things a pain).
35+
#. Internet connection (without proxies makes things much easier) to update
36+
the scripts/binaries on the SD card that came with the ADI FMC Card
37+
(firewalls are OK, proxies make things a pain).
3838
#. RF Test equipment
3939
#. An SD card with at least 16GB of memory (in case you're using Linux). You
4040
should have received one when purchasing the evaluation board.
@@ -45,9 +45,10 @@ Software prerequisites
4545
Normally, for basic functionalities regarding visualizing the data received
4646
from the FPGA, we use the following:
4747

48-
#. :external+scopy:doc:`Scopy <index>` v2.0 or later (must contain the IIO plugin)
48+
#. :external+scopy:doc:`Scopy <index>` v2.0 or later (must contain the IIO
49+
plugin)
4950

5051
.. note::
5152

52-
:adi:`ADI <>` does not offer FPGA carrier platforms for sale or loan; getting
53-
one yourself is the normal part of development or evaluation.
53+
:adi:`ADI <>` does not offer FPGA carrier platforms for sale or loan;
54+
getting one yourself is the normal part of development or evaluation.

_sources/solutions/reference-designs/eval-ad9081/quickstart/a10soc.rst.txt

Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,17 @@
33
Arria 10 SoC Quick start
44
===============================================================================
55

6-
.. image:: ../../images/ad9081_a10soc_setup.jpg
7-
:width: 800
8-
96
This guide provides quick instructions on how to setup the
107
:adi:`EVAL-AD9081` on:
118

129
- :intel:`Arria 10 SoC <content/www/us/en/products/details/fpga/arria/10.html>`
1310
(Rev. C or later) on FMCA
1411

12+
.. image:: ../../images/a10soc.jpg
13+
:width: 900
14+
15+
.. esd-warning::
16+
1517
.. warning::
1618

1719
:adi:`EVAL-AD9082` is not supported on
@@ -55,8 +57,8 @@ Instructions on how to manually build the boot files from source can be found
5557
here:
5658

5759
- :dokuwiki:`Building the Intel SoC-FPGA kernel and devicetrees from source <resources/tools-software/linux-build/generic/socfpga>`
58-
- :external+hdl:ref:`ad9081_fmca_ebz` build documentation. More HDL build details at
59-
:external+hdl:ref:`build_hdl`.
60+
- :external+hdl:ref:`ad9081_fmca_ebz` build documentation. More HDL build
61+
details at :external+hdl:ref:`build_hdl`.
6062

6163
Required software
6264
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -115,26 +117,28 @@ These resistors can be found on the backside of the A10SoC, underneath the
115117
FMCA connector (J29). The following picture shows the required configuration
116118
to be compatible with the :adi:`EVAL-AD9081`.
117119

120+
.. image:: ../../images/a10soc_fmc_rework.jpg
121+
:width: 400
122+
118123
Testing
119124
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
120125

121126
Creating the setup
122127
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
123128

124-
.. image:: ../../images/a10soc.jpg
125-
:width: 900
126-
127-
.. esd-warning::
129+
.. image:: ../../images/ad9081_a10soc_setup.jpg
130+
:width: 800
128131

129132
In the following example, we will make a physical loopback between the ADC
130133
and the DAC channels on the evaluation board, using SMA cables.
131134

132135
Follow the steps in this order, to avoid damaging the components:
133136

134137
#. Connect the SMA cables ADC0-DAC0, ADC1-DAC1, ADC2-DAC2, ADC3-DAC3
135-
#. Connect the :adi:`EVAL-AD9081` / :adi:`EVAL-AD9082` FMC board to the
136-
FPGA carrier **HPC1** FMCA (J29) socket
137-
#. Both the HPS (J26) and FPGA (J27) memory module must be installed on the A10SoC
138+
#. Connect the :adi:`EVAL-AD9081` / :adi:`EVAL-AD9082` FMC board to the A10SOC
139+
**HPC1** FMCA (J29) socket
140+
#. Both the HPS (J26) and FPGA (J27) memory module must be installed on the
141+
A10SoC
138142
#. Insert microSD card into the card socket on the FPGA
139143
#. Configure the FPGA for SD card boot mode. That is the
140144
:intel:`default position <content/www/us/en/docs/programmable/683735/current/boot-select.html>`
@@ -147,9 +151,6 @@ Follow the steps in this order, to avoid damaging the components:
147151
#. Observe Kernel and serial console output messages on your terminal (use
148152
the first ttyUSB or COM port registered)
149153

150-
.. image:: ../../images/a10soc_fmc_rework.jpg
151-
:width: 400
152-
153154
Boot messages
154155
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
155156

@@ -677,6 +678,13 @@ To reboot the system, run:
677678
be taken not to corrupt the file system -- please shut down things, don't
678679
just turn off the power switch. Depending on your monitor, the standard
679680
power off could be hiding. You can do this from the terminal as well with
680-
:code:`sudo shutdown -h now` or the above-mentioned command for powering off.
681+
:code:`sudo shutdown -h now` or the above-mentioned command for powering
682+
off.
681683

682684
.. include:: ../../common/using-iio-osc.rst
685+
686+
..
687+
About the IIO devices
688+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
689+
690+
TBD

_sources/solutions/reference-designs/eval-ad9081/quickstart/index.rst.txt

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,16 @@ Quick start guides
55

66
The Quick start guides provide simple step by step instructions on how to do
77
an initial system setup for the :adi:`EVAL-AD9081` / :adi:`EVAL-AD9082`
8-
boards on various FPGA development boards. In these guides, we will discuss how
9-
to program the bitstream, run a no-OS program or boot a Linux distribution.
8+
boards on various FPGA development boards. In these guides, we will discuss
9+
how to program the bitstream, run a no-OS program or boot a Linux distribution.
1010

1111
.. toctree::
1212

1313
On A10SoC <a10soc>
14-
On VCK190 <versal>
15-
On ZCU102 <zynqmp>
14+
On VCK190 <vck190>
15+
On ZC706 <zc706>
16+
On VCU118 <vcu118>
17+
On ZCU102 <zcu102>
1618

1719
.. _ad9081 carriers:
1820

_sources/solutions/reference-designs/eval-ad9081/quickstart/versal.rst.txt renamed to _sources/solutions/reference-designs/eval-ad9081/quickstart/vck190.rst.txt

Lines changed: 58 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,18 @@
1-
.. _ad9081 quickstart versal:
1+
.. _ad9081 quickstart vck190:
22

33
VCK190 Quick start
44
===============================================================================
55

6-
.. image:: ../../images/ad9081_vck190_setup.jpg
7-
:width: 800
8-
96
This guide provides some quick instructions on how to setup the
107
:adi:`EVAL-AD9081` / :adi:`EVAL-AD9082` on:
118

129
- :xilinx:`VCK190` FMCP1 (J51) port
1310

11+
.. image:: ../../images/vck190.jpg
12+
:width: 900
13+
14+
.. esd-warning::
15+
1416
Using Linux as software
1517
-------------------------------------------------------------------------------
1618

@@ -37,8 +39,8 @@ here:
3739
- :ref:`linux-kernel zynqmp` (the only difference compared to the ZynqMP is
3840
that instead of running ``make adi_zynqmp_defconfig``,
3941
you must run ``make adi_versal_defconfig``)
40-
- :external+hdl:ref:`ad9081_fmca_ebz` build documentation. More HDL build details at
41-
:external+hdl:ref:`build_hdl`.
42+
- :external+hdl:ref:`ad9081_fmca_ebz` build documentation. More HDL build
43+
details at :external+hdl:ref:`build_hdl`.
4244

4345
Required Software
4446
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -64,72 +66,69 @@ Required Hardware
6466
Testing
6567
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6668

67-
.. image:: ../../images/vck190.jpg
68-
:width: 900
69-
7069
Creating the setup
7170
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
7271

73-
.. esd-warning::
72+
.. image:: ../../images/ad9081_vck190_setup.jpg
73+
:width: 800
7474

7575
Follow the steps in this order, to avoid damaging the components:
7676

77-
- Connect the :adi:`EVAL-AD9081` / :adi:`EVAL-AD9082` FMC board to the
78-
FPGA carrier FMC+ FMCP1 socket
79-
- Connect USB UART J207 (Type-C USB) to your host PC
80-
- Insert SD card with ADI Kuiper image into socket J302
81-
- Insert System Controller SD card into socket J206
82-
- Configure ACAP for SD boot (mode SW1[4:1] switch in the position
83-
**OFF,OFF,OFF,ON** as seen in the below picture)
8477

85-
.. image:: ../../images/vck190_sw1.jpg
86-
:width: 200
78+
#. Connect the :adi:`EVAL-AD9081` / :adi:`EVAL-AD9082` FMC board to the
79+
VCK190 FMCP1 socket
80+
#. Connect USB UART J207 (Type-C USB) to your host PC
81+
#. Insert SD card with ADI Kuiper image into socket J302
82+
#. Insert System Controller micro SD card into socket J206
83+
#. Configure ACAP for SD boot (mode SW1[4:1] switch in the position
84+
**OFF,OFF,OFF,ON** as seen in the below picture)
85+
86+
.. image:: ../../images/vck190_sw1.jpg
87+
:width: 200
8788

88-
- Configure System Controller for SD card boot (mode SW11[4:1] switch in the
89+
#. Configure System Controller for SD card boot (mode SW11[4:1] switch in the
8990
position **OFF,OFF,OFF,ON** as seen in the below picture).
9091

91-
.. image:: ../../images/vck190_sw11.jpg
92-
:width: 200
92+
.. image:: ../../images/vck190_sw11.jpg
93+
:width: 200
9394

94-
- Connect an Ethernet cable to J307 and also to SYSCTL Ethernet port to access
95-
Board Evaluation & Management Tool (BEAM);
96-
- Turn on the power switch on the FPGA board;
97-
- Observe kernel and serial console messages on your terminal, both the ACAP
98-
UART interface and the System controller. (use the first ttyUSB or COM port
99-
registered for the ACAP UART interface, and try the other 2 to find the one
100-
for System Controller);
101-
- On the System Controller console, a BEAM Tool Web Address should be assigned.
102-
Go to this web address to set VADJ_FMC to 1.5V;
103-
- To change VADJ_FMC On BEAM, click 'Test The Board'>'Board Settings'>'FMC'.
104-
Then on 'Set VADJ_FMC', select 1.5V and click 'Set'.
95+
#. Connect an Ethernet cable to J307 and also to SYSCTL Ethernet port to access
96+
Board Evaluation & Management Tool (BEAM);
97+
#. Turn on the power switch on the FPGA board;
98+
#. Observe kernel and serial console messages on your terminal, both the ACAP
99+
UART interface and the System controller. (use the first ttyUSB or COM port
100+
registered for the ACAP UART interface, and try the other 2 to find the one
101+
for System Controller);
102+
#. On the System Controller console, a BEAM Tool Web Address should be assigned.
103+
Go to this web address to set VADJ_FMC to 1.5V;
105104

106-
.. image:: beam-home.jpg
107-
:width: 1000
105+
.. image:: beam-home.jpg
106+
:width: 1000
108107

109-
.. image:: beam-board-settings.jpg
110-
:width: 1000
108+
.. image:: beam-board-settings.jpg
109+
:width: 1000
111110

112-
.. image:: beam-set-vadj.jpg
113-
:width: 1000
111+
.. image:: beam-set-vadj.jpg
112+
:width: 1000
114113

115-
- On the ACAP UART interface console, reboot the system. After reboot,
116-
ad9081 devices should be present.
114+
#. On the ACAP UART interface console, reboot the system. After reboot,
115+
AD9081 devices should be present.
117116

118-
.. note::
117+
.. note::
119118

120-
Versal-based carriers (:xilinx:`VCK190`) might not boot with released image.
119+
Versal-based carriers (:xilinx:`VCK190`) might not boot with released image.
121120

122-
The problem appears because some revisions of :xilinx:`VCK190` or
123-
:xilinx:`VPK180` may have the date/time set randomly or in 64bit format.
124-
To make them boot, it is enough to overwrite the date, following next steps:
121+
The problem appears because some revisions of :xilinx:`VCK190` or
122+
:xilinx:`VPK180` may have the date/time set randomly or in 64bit format.
123+
To make them boot, it is enough to overwrite the date, following next steps:
125124

126-
- when booting the board, hit any key to go into u-boot menu
127-
- type ``mw F12A0000 6613DE3D`` (this value is hexa of the date from Unix
128-
Converter webpage)
129-
- continue booting
125+
- when booting the board, hit any key to go into u-boot menu
126+
- type ``mw F12A0000 6613DE3D`` (this value is hexa of the date from Unix
127+
Converter webpage)
128+
- continue booting
130129

131130
ACAP SD card boot files
132-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
133132

134133
The files that need to be present on the SD card BOOT partition are:
135134

@@ -143,13 +142,13 @@ Copy the BOOT.BIN, boot.scr and system.dtb from the
143142
ADI Kuiper image. Then, copy the Image from the ``versal-common`` folder.
144143

145144
Setting up UART
146-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
145+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
147146

148147
When setting up the UART make sure you connect to the ACAP UART interface and
149148
not the System controller.
150149

151150
Boot messages
152-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
153152

154153
Login Information required for the System Controller:
155154

@@ -868,13 +867,13 @@ To reboot the system, run:
868867
be taken not to corrupt the file system -- please shut down things, don't
869868
just turn off the power switch. Depending on your monitor, the standard
870869
power off could be hiding. You can do this from the terminal as well with
871-
:code:`sudo shutdown -h now` or the above-mentioned command for powering off.
870+
:code:`sudo shutdown -h now` or the above-mentioned command for powering
871+
off.
872872

873873
.. include:: ../../common/using-iio-osc.rst
874874

875-
About the IIO devices
876-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
877-
878875
..
879-
This section is with ^^^ because the last section from using-iio-osc.rst which
880-
is included previously, has the last section as ^^^.
876+
About the IIO devices
877+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
878+
879+
TBD

0 commit comments

Comments
 (0)