analogdevicesinc · hadarauelena · May 7, 2025 · May 8, 2025
@@ -0,0 +1,15 @@
+# ARDV904x HDL Project
+
+- Evaluation board product page: [EVAL-ADRV904x](https://www.analog.com/eval-adrv904x)
+- System documentation: https://wiki.analog.com/resources/eval/user-guides/adrv904x/quickstart/zynqmp
+- HDL project documentation: https://analogdevicesinc.github.io/hdl/projects/adrv904x/index.html
+
+## Supported parts
+
+| Part name                                    | Description                                   |
+|----------------------------------------------|-----------------------------------------------|
+| [ADRV9040](https://www.analog.com/adrv9040) | 8T8R SoC with DFE, 400 MHz iBW RF Transceiver |
+
+## Building the project
+
+Please enter the folder for the FPGA carrier you want to use and read the README.md.
@@ -0,0 +1,50 @@
+# ARDV904x/ZCU102 HDL Project
+
+## Building the project
+
+The parameters configurable through the `make` command, can be found below, as well as in the **system_project.tcl** file; it contains the default configuration.
+
+```
+cd projects/adrv904x/zcu102
+make
+```
+
+All of the RX/TX link modes can be found in the [ADRV9040 data sheet](https://www.analog.com/media/en/technical-documentation/data-sheets/adrv9040.pdf). We offer support for only a few of them.
+
+If other configurations are desired, then the parameters from the HDL project (see below) need to be changed, as well as the Linux/no-OS project configurations.
+
+**Warning**: The JESD link mode is configured using the ADRV904x plugin from [ACE](https://wiki.analog.com/resources/tools-software/ace) application. The device tree is the same, regardless of the configuration: [zynqmp-zcu102-rev10-adrv904x.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-adrv904x.dts)
+
+The overwritable parameters from the environment:
+
+- JESD_MODE - link layer encoder mode used;
+  - 8B10B - 8b10b link layer defined in JESD204B, uses ADI IP as Physical layer
+  - 64B66B - 64b66b link layer defined in JESD204C, uses Xilinx IP as Physical layer
+- [RX/TX]_LANE_RATE - lane rate of the [RX/TX] link (RX: MxFE to FPGA/TX: FPGA to MxFE)
+- [RX/TX]_JESD_M - [RX/TX] number of converters per link
+- [RX/TX]_JESD_L - [RX/TX] number of lanes per link
+- [RX/TX]_JESD_S - [RX/TX] number of samples per converter per frame
+- [RX/TX]_JESD_NP - [RX/TX] number of bits per sample, only 16 is supported
+- [RX/TX]_NUM_LINKS - [RX/TX] number of links, which matches the number of MxFE devices
+
+### Example configurations
+
+#### Default configuration
+
+This specific command is equivalent to running `make` only:
+
+```
+make JESD_MODE=64B66B \
+RX_LANE_RATE=16.22 \
+TX_LANE_RATE=16.22 \
+RX_NUM_LINKS=1 \
+TX_NUM_LINK=1 \
+RX_JESD_M=16 \
+RX_JESD_L=8 \
+RX_JESD_S=1 \
+TX_JESD_M=16 \
+TX_JESD_L=8 \
+TX_JESD_S=1
+```
+
+Corresponding device tree: [zynqmp-zcu102-rev10-adrv904x.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-adrv904x.dts)
@@ -13,10 +13,15 @@ source $ad_hdl_dir/projects/scripts/adi_board.tcl
 #   Use over-writable parameters from the environment.
 #
 # Parameter description:
-#   [TX/RX/RX_OS]_JESD_M : Number of converters per link
-#   [TX/RX/RX_OS]_JESD_L : Number of lanes per link
-#   [TX/RX/RX_OS]_JESD_S : Number of samples per frame
-#   [TX/RX/RX_OS]_JESD_NP : Number of bits per sample
+#   JESD_MODE: link layer encoder mode used;
+#      64B66B - 64b66b link layer defined in JESD 204C, uses Xilinx IP as Physical layer
+#      8B10B - 8b10b link layer defined in JESD 204B, uses ADI IP as Physical layer
+#   [RX/TX]_LANE_RATE - lane rate of the [RX/TX] link (RX: MxFE to FPGA/TX: FPGA to MxFE)
+#   [RX/TX]_JESD_M - [RX/TX] number of converters per link
+#   [RX/TX]_JESD_L - [RX/TX] number of lanes per link
+#   [RX/TX]_JESD_S - [RX/TX] number of samples per converter per frame
+#   [RX/TX]_JESD_NP - [RX/TX] number of bits per sample
+#   [RX/TX]_NUM_LINKS - [RX/TX] number of links, which matches the number of MxFE devices
 
 adi_project adrv904x_zcu102 0 [list \
   JESD_MODE       [get_env_param JESD_MODE     64B66B] \