feat: Update Buildroot doc for AM62L 11.0 release

paresh-bhagat · jsuhaas22 · commit 4beb09b1da6d · 2025-03-03T14:38:53.000+05:30
Update build steps for Buildroot for AM62L 11.0 release.

Signed-off-by: Paresh Bhagat &lt;p-bhagat@ti.com&gt;
diff --git a/source/buildroot/Building_Buildroot_Image.rst b/source/buildroot/Building_Buildroot_Image.rst
@@ -17,7 +17,7 @@ the following command:
 
 .. code-block:: console
 
-    $ sudo apt install debianutils sed make binutils build-essential gcc g++ bash patch gzip bzip2 perl tar cpio unzip rsync file bc git
+   $ sudo apt install debianutils sed make binutils build-essential gcc g++ bash patch gzip bzip2 perl tar cpio unzip rsync file bc git
 
 ************************
 Steps to Build the Image
@@ -34,18 +34,18 @@ To set up and use the `buildroot-external-ti` external tree, follow these steps:
 
 .. code-block:: console
 
-    $ git clone -b 2024.05.3 https://github.com/buildroot/buildroot
-    $ git clone -b 10.01.10.04 https://github.com/TexasInstruments/buildroot-external-TI.git
+   $ git clone -b 2024.11.1 https://github.com/buildroot/buildroot
+   $ git clone -b 11.00.05.02 https://github.com/TexasInstruments/buildroot-external-TI.git
  
 2. Configure Buildroot to use the external tree and choose a configuration file
 
 .. code-block:: console
 
-    $ cd buildroot
-    During configuration
-    $ make BR2_EXTERNAL=<path to external tree>/buildroot-external-TI <configuration file>
-    OR
-    export BR2_EXTERNAL=<path to external tree>/buildroot-external-TI
+   $ cd buildroot
+   During configuration
+   $ make BR2_EXTERNAL=<path to external tree>/buildroot-external-TI <configuration file>
+   OR
+   export BR2_EXTERNAL=<path to external tree>/buildroot-external-TI
 
 Select the Build Configuration
 ==============================
@@ -57,10 +57,10 @@ configuration file for your target device.
 
 .. code-block:: console
 
-    $ cd buildroot
-    $ make <defconfig>
-    For example, for AM62X-SK Linux build use ti_release_am62x_sk_defconfig
-    $ make ti_release_am62x_sk_defconfig
+   $ cd buildroot
+   $ make <defconfig>
+   For example, for AM62LX-evm Linux build use ti_release_am62lx_evm_defconfig
+   $ make ti_release_am62lx_evm_defconfig
 
 Customize the Configuration
 ===========================
@@ -70,7 +70,7 @@ interface. This step is optional but useful if you need to make specific adjustm
 
 .. code-block:: console
 
-    $ make menuconfig
+   $ make menuconfig
 
 Build the Image
 ===============
@@ -80,7 +80,7 @@ the necessary components and creates the root filesystem, kernel, and bootloader
 
 .. code-block:: console
 
-    $ make TI_K3_BOOT_FIRMWARE_VERSION=10.01.10
+   $ make TI_K3_BOOT_FIRMWARE_VERSION=11.00.05
 
 The build process can take some time, depending on your system's resources and
 the complexity of the configuration.
@@ -107,9 +107,9 @@ Example for SD card:
 
 .. code-block:: console
 
-    $ sudo dd if=output/images/sdcard.img of=/dev/sdX
-    $ sync
-    Replace /dev/sdX with the appropriate device identifier for your SD card.
+   $ sudo dd if=output/images/sdcard.img of=/dev/sdX
+   $ sync
+   Replace /dev/sdX with the appropriate device identifier for your SD card.
 
 Booting the SD Card Image
 =========================
@@ -119,7 +119,7 @@ After the image is flashed to SD Card. Change the boot mode pins in
 
 .. code-block:: console
 
-    SW1[1:8] = 11000010 and SW2[1:8] = 01000000
+   SW1[1:8] = 11000010 and SW2[1:8] = 01000000
 
 Insert the SD Card in SD Card slot in |__PART_FAMILY_DEVICE_NAMES__| board. Use a
 USB Micro-B cable to connect the host PC to the USB Micro-B interface for UART
@@ -128,28 +128,25 @@ terminal window:
 
 .. code-block:: console
 
-    Trying to boot from MMC2
-    Authentication passed
-    Authentication passed
-    Authentication passed
-    ...
-    ...
-    ...
-    Starting network: [    2.823578] am65-cpsw-nuss 8000000.ethernet eth0: PHY [8000f00.mdio:00] driver [TI DP83867] (irq=POLL)
-    [    2.823635] am65-cpsw-nuss 8000000.ethernet eth0: configuring for phy/rgmii-rxid link mode
-    udhcpc: started, v1.36.1
-    udhcpc: broadcasting discover
-    udhcpc: no lease, forking to background
-    [    5.944022] am65-cpsw-nuss 8000000.ethernet eth1: PHY [8000f00.mdio:01] driver [TI DP83867] (irq=POLL)
-    [    5.944130] am65-cpsw-nuss 8000000.ethernet eth1: configuring for phy/rgmii-rxid link mode
-    udhcpc: started, v1.36.1
-    udhcpc: broadcasting discover
-    udhcpc: no lease, forking to background
-    OK
-
-    Welcome to Buildroot
-    buildroot login: root
-    #
+   Trying to boot from MMC2
+   ...
+   ...
+   ...
+   Starting network: [    2.823578] am65-cpsw-nuss 8000000.ethernet eth0: PHY [8000f00.mdio:00] driver [TI DP83867] (irq=POLL)
+   [    2.823635] am65-cpsw-nuss 8000000.ethernet eth0: configuring for phy/rgmii-rxid link mode
+   udhcpc: started, v1.36.1
+   udhcpc: broadcasting discover
+   udhcpc: no lease, forking to background
+   [    5.944022] am65-cpsw-nuss 8000000.ethernet eth1: PHY [8000f00.mdio:01] driver [TI DP83867] (irq=POLL)
+   [    5.944130] am65-cpsw-nuss 8000000.ethernet eth1: configuring for phy/rgmii-rxid link mode
+   udhcpc: started, v1.36.1
+   udhcpc: broadcasting discover
+   udhcpc: no lease, forking to background
+   OK
+
+   Welcome to Buildroot
+   buildroot login: root
+   #
 
 *************
 Going further
diff --git a/source/buildroot/Building_Buildroot_Packages.rst b/source/buildroot/Building_Buildroot_Packages.rst
@@ -25,11 +25,11 @@ Run make menuconfig to enable the packages you have added in the Buildroot confi
 
 .. code-block:: console
 
-    $ make menuconfig
+   $ make menuconfig
 
 .. figure:: /images/buildroot_menuconfig.png
-    :height: 600
-    :width: 800
+   :height: 600
+   :width: 800
 
 Navigate to the relevant package categories and enable the desired packages.
 For **nano** and :command:`htop`, you would typically find them under the Target packages menu.
@@ -47,7 +47,7 @@ compile, and include the specified packages in the build process.
 
 .. code-block:: console
 
-    $ make
+   $ make
 
 The build process can take some time, depending on your system's resources and
 the complexity of the configuration.
@@ -61,8 +61,8 @@ filesystem.
 
 .. code-block:: console
 
-    $ find output/target -name nano
-    $ find output/target -name htop
+   $ find output/target -name nano
+   $ find output/target -name htop
 
 You should see the paths to your package binaries, indicating that they were
 successfully included in the build.
@@ -95,8 +95,8 @@ For example, if you want to add a package named myapp:
 
 .. code-block:: console
 
-    $ cd buildroot-external-TI/
-    $ mkdir -p package/myapp
+   $ cd buildroot-external-TI/
+   $ mkdir -p package/myapp
 
 Create the Package Files
 ========================
@@ -110,28 +110,28 @@ Example Config.in:
 
 .. code-block:: console
 
-    config BR2_PACKAGE_MYAPP
-    bool "myapp"
-    help
-      MyApp is an example application.
+   config BR2_PACKAGE_MYAPP
+   bool "myapp"
+   help
+    MyApp is an example application.
 
 Example myapp.mk
 
 .. code-block:: console
 
-    MYAPP_VERSION = 1.0
-    MYAPP_SITE = http://example.com/downloads
-    MYAPP_SOURCE = myapp-$(MYAPP_VERSION).tar.gz
+   MYAPP_VERSION = 1.0
+   MYAPP_SITE = http://example.com/downloads
+   MYAPP_SOURCE = myapp-$(MYAPP_VERSION).tar.gz
 
-    define MYAPP_BUILD_CMDS
-    $(MAKE) -C $(@D)
-    endef
+   define MYAPP_BUILD_CMDS
+   $(MAKE) -C $(@D)
+   endef
 
-    define MYAPP_INSTALL_TARGET_CMDS
-    $(INSTALL) -D -m 0755 $(@D)/myapp $(TARGET_DIR)/usr/bin/myapp
-    endef
+   define MYAPP_INSTALL_TARGET_CMDS
+   $(INSTALL) -D -m 0755 $(@D)/myapp $(TARGET_DIR)/usr/bin/myapp
+   endef
 
-    $(eval $(generic-package))
+   $(eval $(generic-package))
 
 Add the Package to Buildroot Configuration
 ==========================================
@@ -141,7 +141,7 @@ new package. Add the following line:
 
 .. code-block:: console
 
-    $ source "$BR2_EXTERNAL_TI_PATH/package/myapp/Config.in"
+   $ source "$BR2_EXTERNAL_TI_PATH/package/myapp/Config.in"
 
 Also edit external.mk to include package mk file
 
@@ -157,15 +157,15 @@ Buildroot configuration.
 
 .. code-block:: console
 
-    $ cd buildroot/
-    $ make menuconfig
+   $ cd buildroot/
+   $ make menuconfig
 
 Navigate to your package in the External Options menu and enable it. Save and exit
 the menuconfig interface.
 
 .. figure:: /images/buildroot_custom_package.png
-    :height: 600
-    :width: 800
+   :height: 600
+   :width: 800
 
 Build the Package
 =================
@@ -175,7 +175,7 @@ compile, and include your new package in the build process.
 
 .. code-block:: console
 
-    $ make
+   $ make
 
 Verify the Package
 ==================
@@ -186,7 +186,7 @@ filesystem.
 
 .. code-block:: console
 
-    $ find output/target -name myapp
+   $ find output/target -name myapp
 
 You should see the path to your package's binary, indicating that it was
 successfully included in the build.
diff --git a/source/buildroot/Overview.rst b/source/buildroot/Overview.rst
@@ -46,19 +46,23 @@ Repository structure
 
 .. code-block::
 
-    buildroot-external-TI
-    ├── external.desc
-    ├── external.mk
-    ├── Config.in 
-    ├── board
-    │   ├── ti
-    │   │   ├── am62x-sk
-    │   │   ├── common
-    ├── COPYING
-    ├── README.md
-    ├── configs
-    │   ├── ti_release_am62x_sk_defconfig
-    │   └── ti_release_am62x_sk_rt_defconfig
+   buildroot-external-TI
+   ├── external.desc
+   ├── external.mk
+   ├── Config.in
+   ├── board
+   │   ├── ti
+   │   │   ├── am62x-sk
+   │   │   ├── am62lx-evm
+   │   │   ├── common
+   ├── COPYING
+   ├── README.md
+   ├── configs
+   │   ├─ ti_release_am62x_sk_defconfig
+   │   ├─ ti_release_am62x_sk_rt_defconfig
+   │   ├─ ti_release_am62lx_evm_defconfig
+   │   ├─ ti_release_am62lx_evm_rt_defconfig
+   ├── package
 
 :file:`external.desc`: contains name and description of br2-external tree.
 
@@ -70,6 +74,8 @@ Repository structure
 
 :file:`Config.in`: used to define package recipes.
 
+:file:`package`: used to add package.
+
 .. _technical-support:
 
 *****************
diff --git a/source/devices/AM62LX/buildroot/Getting_Started_Guide.rst b/source/devices/AM62LX/buildroot/Getting_Started_Guide.rst
@@ -46,22 +46,22 @@ Create SD Card using balenaEtcher
         Etcher will decompress the image and write it to the SD card, as shown below:
 
 .. figure:: /images/balena_etcher.png
-    :height: 600
-    :width: 800
+   :height: 600
+   :width: 800
 
 ********************************
 Set the EVM to SD card Boot mode
 ********************************
 
 The simplest way to run Linux on the EVM is through an SD card. For that, the
 EVM will need to be configured for SD card boot.
-Refer to `AM62L EVM User's Guide <https://www.ti.com/tool/EVM-AM62L>`__ for
+Refer to `AM62L EVM User's Guide <https://www.ti.com/tool/TMDS62LEVM>`__ for
 detailed information about boot mode configurations. For quick reference,
 the figure below shows the boot mode switch setting for SD card boot.
 
-.. figure:: /images/AM62x_SD_boot.jpg
-    :height: 600
-    :width: 800
+.. figure:: /images/AM62LX_SD_boot.jpg
+   :height: 600
+   :width: 800
 
 ***************************
 Boot and Validate Buildroot
@@ -73,7 +73,7 @@ Insert the SD Card in the board and Power ON the EVM.
 After few seconds the booting prompt will appear.
 
 .. figure:: /images/buildroot_homescreen.png
-    :height: 600
-    :width: 800
+   :height: 600
+   :width: 800
 
 You've successfully booted Buildroot on AM62L.
