Skip to content

Commit 9943a13

Browse files
Carlian275Carlian275
committed
project:ad6676ebz: Added README documentation for AD6676-EBZ
Added the README file for the AD6676-EBZ project. Modified the sphinx project_doc.rst file to add the corresponding source. Added doxygen directive Signed-off-by: Carl Ian Gamutan <[email protected]>
1 parent 1cc7551 commit 9943a13

File tree

2 files changed

+187
-0
lines changed

2 files changed

+187
-0
lines changed

‎doc/sphinx/source/projects/adc/ad6676-ebz.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.. include:: ../../../../../projects/ad6676-ebz/README.rst

‎projects/ad6676-ebz/README.rst‎

Lines changed: 186 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,186 @@
1+
AD6676-EBZ no-OS Example Project
2+
================================
3+
4+
.. no-os-doxygen::
5+
.. contents::
6+
:depth: 3
7+
8+
Supported Evaluation Boards
9+
---------------------------
10+
11+
- :adi:`EVAL-AD6676`
12+
13+
Overview
14+
--------
15+
16+
The EVAL-AD6676 is an evaluation board for the AD6676 high dynamic
17+
range, wideband IF receiver. It supports frequencies from 70 MHz to
18+
450 MHz with an IF signal bandwidth of up to 160 MHz. The board features
19+
digital signal processing, on-chip NCOs, and a quadrature digital
20+
downconverter with decimation factors of 12, 16, 24, and 32. High-speed
21+
data transfer is facilitated by JESD204B single or dual-lane outputs.
22+
The board operates with supply voltages of 1.1V and 2.5V, consuming as
23+
little as 1.20W. It includes an integrated attenuator with a 27 dB
24+
range, adjustable in 1 dB increments, and supports automatic gain
25+
control (AGC) via an AGC data port. Connection options include FMC
26+
connectors and a SPI interface for ADC setup and control.
27+
28+
Applications
29+
------------
30+
31+
- Wideband cellular infrastructure equipment and repeaters
32+
- Point-to-point microwave equipment
33+
- Instrumentation
34+
- Spectrum and communication analyzers
35+
- Software defined radio
36+
37+
Hardware Specifications
38+
-----------------------
39+
40+
Power Supply Requirements
41+
~~~~~~~~~~~~~~~~~~~~~~~~~
42+
43+
The EVAL-AD6676 evaluation board for the AD6676 wideband IF receiver
44+
utilizes onboard low-dropout (LDO) regulators powered via the FMC
45+
interface for efficient power supply management. The board requires a
46+
reference clock of 200 MHz, with ADC frequencies reaching up to 3200
47+
MHz. High-speed sampling necessitates careful power considerations to
48+
ensure stability and low noise, although specific current and voltage
49+
requirements are not provided.
50+
51+
Connectors and Interfaces
52+
~~~~~~~~~~~~~~~~~~~~~~~~~
53+
54+
+-----------------------------------+-----------------------------------+
55+
| Connector Name | Description |
56+
+-----------------------------------+-----------------------------------+
57+
| FMC Connector | Used for interfacing with the |
58+
| | evaluation platform for the |
59+
| | AD6676, enabling high-speed data |
60+
| | transfer. |
61+
+-----------------------------------+-----------------------------------+
62+
| SPI Interface | Provides setup and control |
63+
| | functionalities for the ADC |
64+
| | through SPI communication. |
65+
+-----------------------------------+-----------------------------------+
66+
| JESD204B Interface Outputs | Facilitates high-speed data |
67+
| | outputs through a single or |
68+
| | dual-lane configuration. |
69+
+-----------------------------------+-----------------------------------+
70+
| Clock Inputs (CLK+ and CLK–) | Differential clock inputs for |
71+
| | synchronizing the ADC operation. |
72+
+-----------------------------------+-----------------------------------+
73+
| Analog Inputs (VIN+ and VIN–) | Differential inputs for analog |
74+
| | signals. |
75+
+-----------------------------------+-----------------------------------+
76+
| GPIO (General-Purpose | Used for configuration and |
77+
| Input/Output) | monitoring purposes within the |
78+
| | system. |
79+
+-----------------------------------+-----------------------------------+
80+
| AGC Pins | Used in the automatic gain |
81+
| | control loop for signal |
82+
| | optimization. |
83+
+-----------------------------------+-----------------------------------+
84+
| Power Supply Connectors | Supply power to various parts of |
85+
| | the evaluation board, such as |
86+
| | VDD1, VDDL, VDDQ, etc. |
87+
+-----------------------------------+-----------------------------------+
88+
89+
No-OS Build Setup
90+
-----------------
91+
92+
Please see: `https://wiki.analog.com/resources/no-os/build`
93+
94+
No-OS Supported Examples
95+
------------------------
96+
97+
The initialization data used in the examples is taken out from the
98+
`Project Source Data Path <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ad6676-ebz/src>`__.
99+
100+
Basic example
101+
~~~~~~~~~~~~~
102+
103+
The basic example for the AD6676 in the no-OS framework requires
104+
initializing the hardware components of the board to facilitate its
105+
operation. It configures the GPIO and SPI interfaces for communication
106+
with the AD6676 and sets up the JESD204 transport protocol using AXI
107+
cores to ensure effective data transmission. Additionally, the example
108+
configures ADC core parameters. The code primarily executes
109+
initialization routines for the JESD, XCVR cores, and DMAC to support
110+
data transfers.
111+
112+
In order to build the basic example, make sure you have the following
113+
configuration in the Makefile:
114+
115+
.. code-block:: bash
116+
117+
# Select the example you want to enable by choosing y for enabling and n for disabling
118+
BASIC_EXAMPLE = y
119+
IIOD = n
120+
121+
IIO example
122+
~~~~~~~~~~~
123+
124+
The IIO example in the AD6676 no-OS project configures the AD6676 device
125+
to interact with an IIO client for data capture and processing. The
126+
process involves initializing necessary platform resources, including
127+
GPIO and SPI, for device configuration. Key operations include setting
128+
up the JESD204 interface and configuring the AD6676 for data
129+
acquisition. The IIO application is set up with parameters such as
130+
device descriptors and buffer settings, which are essential for data
131+
transfer. An IIO daemon runs, enabling real-time data capture through
132+
the IIO client interface, allowing manipulation of device settings such
133+
as frequency and offset for effective data management.
134+
135+
If you are not familiar with ADI IIO Application, please take a look at:
136+
`IIO No-OS <https://wiki.analog.com/resources/tools-software/no-os-software/iio>`__
137+
138+
If you are not familiar with ADI IIO Oscilloscope Client, please take a
139+
look at:
140+
`IIO Oscilloscope <https://wiki.analog.com/resources/tools-software/linux-software/iio_oscilloscope>`__
141+
142+
To build the IIOD demo, add the following flag when invoking make. This
143+
will build the IIOD server and the IIO section of the driver:
144+
145+
.. code-block:: bash
146+
147+
# Configure the example you want to enable by setting 'y' for enable and 'n' for disable
148+
BASIC_EXAMPLE = n
149+
IIOD = y
150+
151+
No-OS Supported Platforms
152+
-------------------------
153+
154+
Xilinx
155+
~~~~~~
156+
157+
Hardware Used
158+
^^^^^^^^^^^^^
159+
160+
- EVAL-AD6676
161+
- AMD Zynq™ 7000 SoC ZC706 Evaluation Kit
162+
163+
Connections
164+
^^^^^^^^^^^
165+
166+
- Plug the AD6676EBZ FMC connector into the HPC (J37) connector on the
167+
ZC706 board. The connector and board are keyed to ensure correct
168+
orientation; the evaluation board should face away from the main ZC706
169+
PCB.
170+
171+
- The AD6676EBZ receives its power directly via the FMC connector from
172+
the ZC706 board. No additional external power is needed if correctly
173+
mounted.
174+
175+
Build Command
176+
^^^^^^^^^^^^^
177+
178+
.. code-block:: bash
179+
180+
cp <SOME_PATH>/system_top.xsa .
181+
# to delete current build
182+
make reset
183+
# to build the project
184+
make
185+
# to flash the code
186+
make run

0 commit comments

Comments
 (0)