fix: Update SDK Top Level Makefile Build Instructions for AM62A

The current top level makefile instructions are incorrect.
So, add AM62A specific instructions in the common Top level Makefile
instructions and point toc to it.

Also common setup scripts are used for AM62A. Hence point to common
setup scripts instructions in toc.

Signed-off-by: Telukula Jeevan Kumar Sahu <j-sahu@ti.com>

Author: jeevantelukula

configs/AM62AX/AM62AX_linux_toc.txt

@@ -4,7 +4,7 @@ devices/AM62AX/linux/Overview
 devices/AM62AX/linux/Overview_Getting_Started_Guide
 devices/AM62AX/linux/Overview/Build_and_Run_the_Demos
 devices/AM62AX/linux/Overview/Download_and_Install_the_SDK
-devices/AM62AX/linux/Overview/Run_Setup_Scripts
+linux/Overview/Run_Setup_Scripts
 devices/AM62AX/linux/Release_Specific
 devices/AM62AX/linux/Release_Specific_Release_Notes
 devices/AM62AX/linux/Release_Specific_Yocto_layer_Configuration
@@ -15,7 +15,7 @@ devices/AM62AX/linux/RT_Linux_Performance_Guide
 devices/AM62AX/linux/Release_Specific_Supported_Platforms_and_Versions
 
 linux/Overview_Building_the_SDK
-linux/Overview_Top_Level_Makefile
+linux/Overview/Top_Level_Makefile
 linux/Overview_Directory_Structure_Overview
 linux/Overview_Technical_Support
 linux/Overview_GPLv3_Disclaimer

source/devices/AM62AX/linux/Overview.rst

@@ -13,7 +13,6 @@ solutions.
 
    Overview_Getting_Started_Guide
    /linux/Overview_Building_the_SDK
-   /linux/Overview_Top_Level_Makefile
    /linux/Overview_Directory_Structure_Overview
    /linux/Overview_Software_Stack
    /linux/Overview_Technical_Support

source/devices/AM62AX/linux/Overview_Getting_Started_Guide.rst

@@ -9,7 +9,7 @@ Getting Started Guide
    :maxdepth: 5
 
    Overview/Download_and_Install_the_SDK
-   /linux/Overview/Top_Level_Makefile
    /linux/Overview/Processor_SDK_Linux_create_SD_card
-   Overview/Run_Setup_Scripts
-   /linux/Overview/GCC_ToolChain
+   /linux/Overview/Run_Setup_Scripts
+   /linux/Overview/Top_Level_Makefile
+   /linux/Overview/GCC_ToolChain

source/linux/Overview/Top_Level_Makefile.rst

@@ -102,23 +102,23 @@ makefile targets.
         * AM62x installer supports ``am62xx-evm`` and ``am62xx-lp-evm`` platforms. ``am62xx-evm`` is the default platform for the Toplevel Makefile. To build for ``am62xx-lp-evm``, pass ``PLATFORM=am62xx-lp-evm`` as argument to make.
         * No special arguments are needed to build for ``am62xxsip-evm`` in AM62xSIP Installer.
 
-.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'AM64X', 'AM62PX', 'AM335X', 'AM437X', 'AM65X', 'AM57X')
+.. ifconfig:: CONFIG_part_variant not in ('AM62X', 'AM64X', 'AM62PX', 'AM335X', 'AM437X', 'AM65X', 'AM57X', 'AM62AX')
 
-    .. code-block:: console
+   .. code-block:: console
 
-        host# sudo apt-get install build-essential autoconf automake bison flex libssl-dev bc u-boot-tools swig
+      host# sudo apt-get install build-essential autoconf automake bison flex libssl-dev bc u-boot-tools swig
 
-.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM335X', 'AM437X', 'AM65X', 'AM57X')
+.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM335X', 'AM437X', 'AM65X', 'AM57X', 'AM62AX')
 
-    .. code-block:: console
+   .. code-block:: console
 
-        host# sudo apt-get install build-essential autoconf automake bison flex libgnutls28-dev libmpc-dev libmpcdec6 libmpc3 libmpcdec-dev libssl-dev bc u-boot-tools swig python3 python3-pip
+      host# sudo apt-get install build-essential autoconf automake bison flex libgnutls28-dev libmpc-dev libmpcdec6 libmpc3 libmpcdec-dev libssl-dev bc u-boot-tools swig python3 python3-pip
 
-    Following pip packages are also needed for jailhouse & binman in u-boot targets
+   Following pip packages are also needed for jailhouse & binman in u-boot targets
 
-    .. code-block:: console
+   .. code-block:: console
 
-        host# pip3 install jsonschema pyelftools PyYAML Mako yamllint
+      host# pip3 install jsonschema pyelftools PyYAML Mako yamllint
 
 .. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
 
@@ -204,11 +204,11 @@ devices will have following additional targets:
      jailhouse tools and cell configs. Applicable for only platforms with
      Hypervisor support enabled.
 
-.. ifconfig:: CONFIG_part_variant in ('AM64X', 'AM62X', 'AM62PX')
+.. ifconfig:: CONFIG_part_variant in ('AM64X', 'AM62X', 'AM62PX', 'AM62AX')
 
-    - ``arm-benchmarks`` - Build the ARM Benchmarks
+   - ``arm-benchmarks`` - Build the ARM Benchmarks
 
-    - ``cryptodev`` - Build module for cryptographic hardware accelerators.
+   - ``cryptodev`` - Build module for cryptographic hardware accelerators.
 
 .. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X')
 
@@ -354,25 +354,25 @@ the Makefile from the top-level of the SDK.
 
     host# make am-benchmarks_install
 
-.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X' )
+.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
 
-    -  Build the ARM Benchmarks
+   -  Build the ARM Benchmarks
 
-       .. code-block:: console
+      .. code-block:: console
 
-           host# make arm-benchmarks
+         host# make arm-benchmarks
 
-    -  Clean the ARM Benchmarks
+   -  Clean the ARM Benchmarks
 
-       .. code-block:: console
+      .. code-block:: console
 
-           host# make arm-benchmarks_clean
+         host# make arm-benchmarks_clean
 
-    -  Install the ARM Benchmarks
+   -  Install the ARM Benchmarks
 
-       .. code-block:: console
+      .. code-block:: console
 
-           host# sudo make arm-benchmarks_install
+         host# sudo make arm-benchmarks_install
 
 .. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational') or CONFIG_part_variant in ('AM65X')
 
@@ -427,57 +427,57 @@ the Makefile from the top-level of the SDK.
 
       host# make sysfw-image_install
 
-.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM64X', 'AM62X')
+.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM64X', 'AM62X', 'AM62AX')
 
-    -  Build u-boot
+   -  Build u-boot
 
-    .. code-block:: console
+   .. code-block:: console
 
-        host# make u-boot
+      host# make u-boot
 
-    -  Clean u-boot
+   -  Clean u-boot
 
-    .. code-block:: console
+   .. code-block:: console
 
-        host# make u-boot_clean
+      host# make u-boot_clean
 
-.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM64X', 'AM62X')
+.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM64X', 'AM62X', 'AM62AX')
 
-    -  Build u-boot
+   -  Build u-boot
 
-       .. code-block:: console
+      .. code-block:: console
 
-           host# make u-boot
+         host# make u-boot
 
-    - Build A53
+   - Build A53
 
       .. code-block:: console
 
-          host# make u-boot-a53
+         host# make u-boot-a53
 
-    - Build R5
+   - Build R5
 
       .. code-block:: console
 
-          host# make u-boot-r5
+         host# make u-boot-r5
 
-    - Copy boot-binaries to built-images folder
+   - Copy boot-binaries to built-images folder
 
       .. code-block:: console
 
-          host# make u-boot_stage
+         host# make u-boot_stage
 
-    - Install boot-binaries to SD card boot partition
+   - Install boot-binaries to SD card boot partition
 
       .. code-block:: console
 
-          host# sudo DESTDIR=/media/$USER/boot make u-boot_install
+         host# sudo DESTDIR=/media/$USER/boot make u-boot_install
 
-    - Clean u-boot
+   - Clean u-boot
 
       .. code-block:: console
 
-          host# make u-boot_clean
+         host# make u-boot_clean
 
 .. ifconfig:: CONFIG_part_variant in ('AM62X')
 
@@ -498,53 +498,6 @@ the Makefile from the top-level of the SDK.
 
     Similar argument can be added to all u-boot targets discussed above.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62AX')
-
-    -  Build the combined boot image (tiboot3.bin)
-
-    This requires first building the R5 boot image. This will generate the u-boot-spl.bin. Then build sysfw-image to generate combined boot image.
-
-    **For GP**
-
-    .. code-block:: console
-
-        host# make u-boot
-        host# make sysfw-image DEVICE_TYPE=gp
-
-    The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-gp-evm.bin
-
-    **For HS-FS**
-
-    .. code-block:: console
-
-        host# make u-boot
-        host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
-        host# make sysfw-image DEVICE_TYPE=hs-fs
-
-    The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-hs-fs-evm.bin
-
-    **For HS-SE**
-
-    .. code-block:: console
-
-        host# make u-boot
-        host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
-        host# make sysfw-image DEVICE_TYPE=hs
-
-    The combined boot image will be at <TI_SDK_PATH>/board-support/k3-image-gen*/tiboot3-am6*-hs-evm.bin
-
-    .. note:: If TI_SECURE_DEV_PKG environment variable is not defined, tiboot3.bin can still be built for GP devices. The following errors will occur in K3-Image-Gen build logs when building for HS-FS or HS-SE devices without the TI_SECURE_DEV_PKG environment variable defined and K3-Image-Gen build may fail:
-
-    .. code-block:: console
-
-       TI_SECURE_DEV_PKG must be set for HS, defaults will not work.  Stop.
-
-    To fix the above issue, do the following and rebuild the `sysfw-image`.
-
-    .. code-block:: console
-
-       host# export TI_SECURE_DEV_PKG=<path-to-board-support>/core-secdev-k3
-
 .. ifconfig:: CONFIG_sdk in ('JACINTO','j7_foundational')
 
   .. ifconfig:: CONFIG_part_variant in ('J7200')
@@ -579,14 +532,14 @@ the Makefile from the top-level of the SDK.
 .. rubric:: Installing boot binaries
    :name: installing-boot-binaries
 
-.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM62X', 'AM64X')
+.. ifconfig:: CONFIG_part_variant not in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
 
-    All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
-    *make install* command only copies the files in rootfs. If you have built either of
-    system firmware or u-boot, you should copy these binaries in the boot partition of
-    the SD card. e.g. run following to copy boot binaries in SD card boot partition.
+   All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
+   *make install* command only copies the files in rootfs. If you have built either of
+   system firmware or u-boot, you should copy these binaries in the boot partition of
+   the SD card. e.g. run following to copy boot binaries in SD card boot partition.
 
-.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X')
+.. ifconfig:: CONFIG_part_variant in ('AM62PX', 'AM62X', 'AM64X', 'AM62AX')
 
    All the install targets copy the files in the rootfs pointed by the DESTDIR variable.
    Run following commands to copy boot binaries in SD card boot partition.
@@ -608,27 +561,19 @@ the Makefile from the top-level of the SDK.
 
 .. ifconfig:: CONFIG_part_variant in ('AM62AX')
 
-    **For GP**
-
-    .. code-block:: console
-
-        host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-gp-evm.bin /media/$USER/boot/tiboot3.bin
-        host# sudo cp board-support/u-boot_build/a53/u-boot.img board-support/u-boot_build/a53/tispl.bin /media/$USER/boot
+   **For HS-FS**
 
-    **For HS-FS**
+   .. code-block:: console
 
-    .. code-block:: console
+      host# sudo cp board-support/built-images/tiboot3-am62a*-hs-fs-evm.bin /media/$USER/boot/tiboot3.bin
+      host# sudo cp board-support/built-images/u-boot.img board-support/built-images/tispl.bin /media/$USER/boot
 
-        host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-hs-fs-evm.bin /media/$USER/boot/tiboot3.bin
-        host# sudo cp board-support/u-boot_build/a53/u-boot.img board-support/u-boot_build/a53/tispl.bin /media/$USER/boot
+   **For HS-SE**
 
-    **For HS-SE**
-
-    .. code-block:: console
+   .. code-block:: console
 
-        host# sudo cp board-support/k3-image-gen*/tiboot3-am62*-hs-evm.bin /media/$USER/boot/tiboot3.bin
-        host# sudo cp board-support/u-boot_build/a53/tispl.bin_HS /media/$USER/boot/tispl.bin
-        host# sudo cp board-support/u-boot_build/a53/u-boot.img_HS /media/$USER/boot/u-boot.img
+      host# sudo cp board-support/built-images/tiboot3-am62a*-hs-evm.bin /media/$USER/boot/tiboot3.bin
+      host# sudo cp board-support/built-images/tispl.bin board-support/built-images/u-boot.img /media/$USER/boot
 
 .. ifconfig:: CONFIG_part_variant in ('AM62X')