deploy: ec1ee77 #210 (synchronize)

Author: github-actions[bot]

pull/210/_sources/configuration.rst.txt

@@ -236,10 +236,10 @@ These options control which non-ADI applications are included in the image:
 
 ----
 
-Boot Configuration
-------------------
+Boot Files Configuration
+------------------------
 
-These options control boot files and configurations:
+These options control which boot files are included in your image:
 
 .. list-table::
    :header-rows: 1
@@ -252,29 +252,66 @@ These options control boot files and configurations:
      - ``y``
      - Include Raspberry Pi boot files (``y``/``n``) - 
        **Enabled by default**
-   * - ``BRANCH_RPI_BOOT_FILES``
-     - ``rpi-6.1.y``
-     - Git branch for Raspberry Pi boot files
-   * - ``USE_ADI_REPO_RPI_BOOT``
+   * - ``CONFIG_CARRIERS_ALL``
      - ``y``
-     - Install Raspberry Pi boot files from ADI repository (``y``/``n``)
-   * - ``CONFIG_XILINX_INTEL_BOOT_FILES``
-     - ``y``
-     - Include Xilinx and Intel boot files (``y``/``n``) - 
-       **Enabled by default**
-   * - ``RELEASE_XILINX_INTEL_BOOT_FILES``
-     - ``2022_r2``
-     - Release version of Xilinx/Intel boot files
-   * - ``USE_ADI_REPO_CARRIERS_BOOT``
-     - ``y``
-     - Install carriers boot files from ADI repository (``y``/``n``)
+     - Install boot files for all supported carrier architectures (``y``/``n``).
+       When enabled, includes boot files for Zynq, ZynqMP, Versal, Arria10, 
+       and Cyclone5 platforms - **Enabled by default**
+   * - ``CONFIG_ARCH_ZYNQ``
+     - ``n``
+     - Install Zynq architecture boot files only (``y``/``n``). 
+       Only used when ``CONFIG_CARRIERS_ALL=n``
+   * - ``CONFIG_ARCH_ZYNQMP``
+     - ``n``
+     - Install ZynqMP architecture boot files only (``y``/``n``). 
+       Only used when ``CONFIG_CARRIERS_ALL=n``
+   * - ``CONFIG_ARCH_VERSAL``
+     - ``n``
+     - Install Versal architecture boot files only (``y``/``n``). 
+       Only used when ``CONFIG_CARRIERS_ALL=n``
+   * - ``CONFIG_ARCH_ARRIA10``
+     - ``n``
+     - Install Arria10 architecture boot files only (``y``/``n``). 
+       Only used when ``CONFIG_CARRIERS_ALL=n``
+   * - ``CONFIG_ARCH_CYCLONE5``
+     - ``n``
+     - Install Cyclone5 architecture boot files only (``y``/``n``). 
+       Only used when ``CONFIG_CARRIERS_ALL=n``
+
+**Choosing Boot Files Strategy:**
+
+For most users, the default settings (``CONFIG_RPI_BOOT_FILES=y`` and 
+``CONFIG_CARRIERS_ALL=y``) provide comprehensive hardware support. If you want 
+to reduce image size and only need specific architectures, set 
+``CONFIG_CARRIERS_ALL=n`` and enable only the ``CONFIG_ARCH_*`` options you 
+need.
+
+**Architecture to Hardware Mapping:**
+
+.. list-table::
+   :header-rows: 1
+   :class: bold-header
+
+   * - Architecture
+     - Hardware Platform Examples
+   * - ``zynq``
+     - ZedBoard, ZC702, ZC706, Cora Z7s, ADRV9361-Z7035, ADRV9364-Z7020
+   * - ``zynqmp``
+     - ZCU102, ADRV9009-ZU11EG, Jupiter SDR
+   * - ``versal``
+     - VCK190, VPK180
+   * - ``arria10``
+     - Arria10 SoC Development Kit
+   * - ``cyclone5``
+     - Cyclone 5 SoC Kit, DE10-Nano, Arradio board
 
 ----
 
-Platform-Specific Configuration
--------------------------------
+Hardware Targeting Configuration
+--------------------------------
 
-These options configure the target board and project:
+These options configure your image for specific hardware during the build 
+process:
 
 .. list-table::
    :header-rows: 1
@@ -286,11 +323,32 @@ These options configure the target board and project:
    * - ``ADI_EVAL_BOARD``
      - *(empty)*
      - Configure which ADI evaluation board project the image will run. 
-       Requires ``CONFIG_XILINX_INTEL_BOOT_FILES=y``
+       When set, the image will be pre-configured for this specific project. 
    * - ``CARRIER``
      - *(empty)*
-     - Configure which board the image will boot on. Used together 
-       with ``ADI_EVAL_BOARD``
+     - Configure which carrier board the image will boot on. Used together 
+       with ``ADI_EVAL_BOARD`` to create a ready-to-use hardware configuration
+
+**Note:** Setting ``ADI_EVAL_BOARD`` and ``CARRIER`` is optional. You can leave 
+these empty and configure your hardware later using the runtime 
+``configure-setup.sh`` script. See :doc:`Hardware Configuration 
+<hardware-configuration>` for details.
+
+----
+
+Platform-Specific Packages
+--------------------------
+
+These options add platform-specific software packages beyond the basic boot 
+files:
+
+.. list-table::
+   :header-rows: 1
+   :class: bold-header
+
+   * - Option
+     - Default
+     - Description
    * - ``INSTALL_RPI_PACKAGES``
      - ``n``
      - Install Raspberry Pi specific packages (``y``/``n``) including: 
@@ -346,6 +404,16 @@ Building for a specific ADI evaluation board
    ADI_EVAL_BOARD=ad9361-fmcomms2
    CARRIER=zedboard
 
+Building with specific architecture boot files only
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+   :caption: config file settings
+
+   CONFIG_CARRIERS_ALL=n
+   CONFIG_ARCH_ZYNQ=y        # Only include Zynq boot files
+   CONFIG_ARCH_ZYNQMP=y      # Only include ZynqMP boot files
+
 Complete development environment with GNU Radio
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~