Merge branch 'add-mchp-fpga-2025-1-tools-setup' into 'main'

Add setup steps and scripts for Libero SoC 2025.1 FPGA Tools

See merge request docs/docs.beagleboard.io!204

Author: lorforlinux

boards/beaglev/fire/02-quick-start.rst

@@ -121,6 +121,7 @@ Demos and Tutorials
 * :ref:`beaglev-fire-upgrade-gateware`
 * :ref:`beaglev-fire-flashing-board`
 * :ref:`beaglev-fire-gateware-design`
-* :ref:`beaglev-fire-mchp-fpga-tools-installation-guide`
+* :ref:`beaglev-fire-mchp-fpga-2024-2-and-older-tools-installation-guide`
+* :ref:`beaglev-fire-mchp-fpga-2025-1-tools-installation-guide`
 * :ref:`beagleV-fire-gateware-builder`
 

boards/beaglev/fire/demos-and-tutorials/gateware/exploring-gateware-design-libero.rst

@@ -12,7 +12,7 @@ Prerequisites
 
 The prerequisites required for creating the Libero project locally are:
 
-1. Microchip design tools: Refer to the document here for :ref:`installation instructions<beaglev-fire-mchp-fpga-tools-installation-guide>` of microchip FPGA tools.
+1. Microchip design tools: Refer to the document here for :ref:`installation instructions<beaglev-fire-mchp-fpga-2025-1-tools-installation-guide>` of microchip FPGA tools.
 2. Python requirements for gateware build scripts:
 
 .. code-block:: shell
@@ -43,7 +43,7 @@ The prerequisites required for creating the Libero project locally are:
     - ``LIBERO_INSTALL_DIR``
     - ``LM_LICENSE_FILE``
 
-    | A script is provided for setting up these variables in the :ref:`fpga tools installation <beaglev-fire-mchp-fpga-tools-installation-guide>` section.
+    | A script is provided for setting up these variables in the :ref:`fpga tools installation <beaglev-fire-mchp-fpga-2025-1-tools-installation-guide>` section.
     | An example script for setting up the environment is available `here <https://openbeagle.org/beaglev-fire/Microchip-FPGA-Tools-Setup>`_.
 
 5. It is highly recommended to go through the :ref:`beaglev-fire-customize-cape-gateware-verilog` tutorial

boards/beaglev/fire/demos-and-tutorials/gateware/gateware-design-simulation-libero.rst

@@ -11,7 +11,7 @@ which is integrated with Libero. The gateware design that we will simulate is th
 Prerequisites
 *************
 
-#. Libero SoC 2022 or later. You can follow this guide to install Libero SoC: :ref:`beaglev-fire-mchp-fpga-tools-installation-guide`.
+#. Libero SoC 2022 or later. You can follow this guide to install Libero SoC: :ref:`beaglev-fire-mchp-fpga-2025-1-tools-installation-guide`.
 #. A copy of the `gateware repository <https://openbeagle.org/beaglev-fire/gateware/>`_.
 #. The ``setup_microchip_tools.sh`` file, to start the license server and set the environment variables. The setup of this script is also covered in the installation guide.
 

boards/beaglev/fire/demos-and-tutorials/gateware/gateware-tcl-scripts-structure.rst

@@ -93,5 +93,5 @@ following command in the gateware directory:
     python build-bitstream.py ./build-options/default.yaml # build option depending on the gateware
 
 You will need to have all microchip tools installed and the environment variables set up correctly. Refer 
-to the :ref:`Microchip tools installation guide <beaglev-fire-mchp-fpga-tools-installation-guide>` for information on how to install these tools.
+to the :ref:`Microchip tools installation guide <beaglev-fire-mchp-fpga-2025-1-tools-installation-guide>` for information on how to install these tools.
 

…s/mchp-fpga-tools-installation-guide.rst …mchp-fpga-2024-2-tools-install-guide.rstboards/beaglev/fire/demos-and-tutorials/mchp-fpga-tools-installation-guide.rst renamed to boards/beaglev/fire/demos-and-tutorials/setup-mchp-fpga-tools-2024-2-and-older/mchp-fpga-2024-2-tools-install-guide.rst boards/beaglev/fire/demos-and-tutorials/mchp-fpga-tools-installation-guide.rst renamed to boards/beaglev/fire/demos-and-tutorials/setup-mchp-fpga-tools-2024-2-and-older/mchp-fpga-2024-2-tools-install-guide.rst

@@ -1,7 +1,7 @@
-.. _beaglev-fire-mchp-fpga-tools-installation-guide:
+.. _beaglev-fire-mchp-fpga-2024-2-and-older-tools-installation-guide:
 
-Microchip FPGA Tools Installation Guide
-#########################################
+Microchip 2024.2 and Older FPGA Tools Installation Guide
+#########################################################
 
 Instructions for installing the Microchip FPGA tools on a Ubuntu 20.04 or Ubuntu 22.04 desktop.
 
@@ -128,11 +128,11 @@ Execute tool setup script
 
 Download the script:
 
-.. literalinclude:: ./setup-microchip-tools.sh
+.. literalinclude:: ./setup-microchip-2024-2-and-older-tools.sh
     :caption: Libero environment and license setup script
     :language: bash
 
-:download:`setup-microchip-tools.sh <./setup-microchip-tools.sh>`
+:download:`setup-microchip-2024-2-and-older-tools.sh <./setup-microchip-2024-2-and-older-tools.sh>`
 
 Details: