From a4b31dad95220ff99bb84b5ae54901a1f64c1c36 Mon Sep 17 00:00:00 2001 From: Iulia Moldovan Date: Tue, 16 Sep 2025 14:01:16 +0300 Subject: [PATCH] docs/user_guide/porting_project: Add more info to adding FPGAs Signed-off-by: Iulia Moldovan --- docs/user_guide/porting_project.rst | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/docs/user_guide/porting_project.rst b/docs/user_guide/porting_project.rst index f743f5c24fa..95318b06191 100644 --- a/docs/user_guide/porting_project.rst +++ b/docs/user_guide/porting_project.rst @@ -20,7 +20,7 @@ maintainability and simplify portability. The result of these design goals is that porting a given project to another carrier is fairly simple if the user respects a couple of guidelines. -The main scope of this wiki page is to discuss these guidelines and provide +The main purpose of this page is to discuss these guidelines and provide simple indications for users who wants to port a project to a non-supported carrier. @@ -31,7 +31,7 @@ Quick Compatibility Check All ADI's FPGA Mezzanine Cards (FMC) are designed to respect all the specifications and requirements defined in the ANSI/VITA 57.1/57.4 FPGA - Mezzanine Card Standard (if not otherwise stated on board's wiki page). + Mezzanine Card Standard (if not otherwise stated on board's page). If the new FPGA carrier is fully compliant with this standard, there will be no obstacles preventing the user to port the project to the required @@ -156,6 +156,24 @@ The **sys_zynq** constant variable should be set in the following way: with the note that you need to manually enable all the functions needed in the system. +You need to populate the following lists with information regarding your FPGA +in the file :git-hdl:`library/scripts/adi_xilinx_device_info_enc.tcl`; +but keep in mind, if some of the information already exists in a list, +do not duplicate it! + +- fpga_technology_list: we added ``{ ultrascale+ 3 }`` for ZCU102 +- fpga_family_list: we added ``{ zynq 4 }`` for ZCU102 +- speed_grade_list: we added ``{ -2 20 }`` for ZCU102 +- dev_package_list: we added ``{ ff 3 }`` for ZCU102 + +Then, in the same file, under the ``adi_device_spec`` procedure, you'd need to +add a regular expression containing the part name (``^xc.u`` in our example, +to match other UltraScale+ boards that fit, as well) under the FPGA_TECHNOLOGY +case. + +Project flow +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + The entry point for project creation is ``system_project.tcl``. Some support scripts are first loaded (:git-hdl:`scripts/adi_env.tcl`) then the project is created (