Skip to content

feat(buildroot): add configs and sources for AM62PX and AM64X #766

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sadik-smd wants to merge 2 commits into
base: master
Choose a base branch
from
Open

feat(buildroot): add configs and sources for AM62PX and AM64X #766

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dbba612
feat(buildroot): add configs and sources for am62px
sadik-smd Jul 30, 2026
8f7d930
feat(buildroot): add configs and sources for am64x
sadik-smd Jul 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions configs/AM62PX/AM62PX_buildroot_config.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# General family replacement variables and configuration values for Buildroot build

# This file is processed by Python scripts to define both replacement
# variable and configuration values for a device family build.
# For replacement variables, all variables should be listed on a single
# line, and all the variables should be listed on consecutive lines
# (i.e. no additional blank lines between the replacement variables).
# Similarly, all the configuration values should be listed on individual,
# consecutive lines (with no blank linues between the configuration values).
#
# Note that neither replacement variables nor configuration values may contain
# a colon (i.e. ":") in their name. However, values may contain colons.

Replacement Variables
---------------------
'__PART_FAMILY_NAME__' : 'AM62Px'
'__PART_FAMILY_DEVICE_NAMES__' : 'AM62Px'
'__PRODUCT_LINE_NAME__' : 'Sitara MPU'
'__SDK_BUILD_MACHINE__' : 'am62pxx-evm'
'__SDK_FULL_NAME__' : 'Buildroot for AM62Px'
'__SDK_SHORT_NAME__' : 'Buildroot'
'__SDK_DOWNLOAD_URL__' : '`AM62Px-SDK-Download-page <https://www.ti.com/tool/PROCESSOR-SDK-AM62PX>`__'
'__LINUX_UBUNTU_VERSION_LONG__' : '22.04 (64-bit)'
'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'

Configuration Values
--------------------
'CONFIG_part_family' : 'AM62PX_family'
'CONFIG_part_variant' : 'AM62PX'
'CONFIG_sdk' : 'BuildrootSDK'
6 changes: 6 additions & 0 deletions configs/AM62PX/AM62PX_buildroot_tags.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Project name and HTML title
project = u'Buildroot for AM62Px'
html_title = 'Buildroot AM62Px Documentation'

# The master toctree document.
master_doc = 'devices/AM62PX/buildroot/index'
8 changes: 8 additions & 0 deletions configs/AM62PX/AM62PX_buildroot_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
devices/AM62PX/buildroot/index
devices/AM62PX/buildroot/Getting_Started_Guide

buildroot/Overview
devices/AM62PX/linux/Release_Specific
devices/AM62PX/linux/Release_Specific_Release_Notes
buildroot/Building_Buildroot_Image
buildroot/Building_Buildroot_Packages
30 changes: 30 additions & 0 deletions configs/AM64X/AM64X_buildroot_config.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# General family replacement variables and configuration values for Buildroot build

# This file is processed by Python scripts to define both replacement
# variable and configuration values for a device family build.
# For replacement variables, all variables should be listed on a single
# line, and all the variables should be listed on consecutive lines
# (i.e. no additional blank lines between the replacement variables).
# Similarly, all the configuration values should be listed on individual,
# consecutive lines (with no blank linues between the configuration values).
#
# Note that neither replacement variables nor configuration values may contain
# a colon (i.e. ":") in their name. However, values may contain colons.

Replacement Variables
---------------------
'__PART_FAMILY_NAME__' : 'AM64x'
'__PART_FAMILY_DEVICE_NAMES__' : 'AM64x'
'__PRODUCT_LINE_NAME__' : 'Sitara MPU'
'__SDK_BUILD_MACHINE__' : 'am64xx-evm'
'__SDK_FULL_NAME__' : 'Buildroot for AM64x'
'__SDK_SHORT_NAME__' : 'Buildroot'
'__SDK_DOWNLOAD_URL__' : '`AM64x-SDK-Download-page <https://www.ti.com/tool/PROCESSOR-SDK-AM64X>`__'
'__LINUX_UBUNTU_VERSION_LONG__' : '22.04 (64-bit)'
'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'

Configuration Values
--------------------
'CONFIG_part_family' : 'AM64X_family'
'CONFIG_part_variant' : 'AM64X'
'CONFIG_sdk' : 'BuildrootSDK'
6 changes: 6 additions & 0 deletions configs/AM64X/AM64X_buildroot_tags.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Project name and HTML title
project = u'Buildroot for AM64x'
html_title = 'Buildroot AM64x Documentation'

# The master toctree document.
master_doc = 'devices/AM64X/buildroot/index'
8 changes: 8 additions & 0 deletions configs/AM64X/AM64X_buildroot_toc.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
devices/AM64X/buildroot/index
devices/AM64X/buildroot/Getting_Started_Guide

buildroot/Overview
devices/AM64X/linux/Release_Specific
devices/AM64X/linux/Release_Specific_Release_Notes
buildroot/Building_Buildroot_Image
buildroot/Building_Buildroot_Packages
79 changes: 79 additions & 0 deletions source/devices/AM62PX/buildroot/Getting_Started_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
##################################
Get started with Buildroot

Check warning on line 2 in source/devices/AM62PX/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Get started with Buildroot'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Get started with Buildroot'.", "location": {"path": "source/devices/AM62PX/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 2, "column": 1}}}, "severity": "INFO"}
##################################
Comment on lines +1 to +3

@StaticRocket StaticRocket Aug 5, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Title overrun


The SD card image sdcard.img provided on the |__SDK_DOWNLOAD_URL__| is all you
need to get started and explore Buildroot on TI microprocessors.

The Buildroot image provided has all the basic packages required to boot with
Weston as default window manager. You can install any new package and
customize the filesystem as required.

Follow the steps on this page to create an SD card image.

**************
Hardware setup
**************

In addition to the SK Evaluation Module (EVM) itself, you need the following hardware:

1. USB Type-C 5V - 15V and 3A power supply
2. Micro-SD card reader
3. Micro-SD card (16GB or larger recommended)
4. USB Micro-B cable for Universal Asynchronous Receiver/Transmitter (UART) serial communication
5. High-Definition Multimedia Interface (HDMI) display and HDMI cable
6. USB mouse and keyboard (for controlling the UI)
7. Ethernet cable (for network access)

*********************************
Create SD card using balenaEtcher
*********************************

1. Download the default bootable SD card image available on the release page as
:file:`tisdk-buildroot-sdcard-image-am62pxx-evm-<version>.img` for Linux image
or :file:`tisdk-buildroot-sdcard-image-rt-am62pxx-evm-<version>.img` for RT-Linux
image.

2. Download and install the balenaEtcher tool:

Balena Etcher is an open source utility that you can install on both Linux and Windows.
Download the tool from `this link <https://www.balena.io/etcher/>`__ and install it.

3. Flash the SD card image to the SD card:

Insert a micro SD card into the USB SD card reader and start Etcher. Choose the sdcard
image to flash, choose the USB SD card reader as the target, and then click "Flash".
Etcher will decompress the image and write it to the SD card, as shown in the following figure:

.. figure:: /images/balena_etcher.png
:height: 600
:width: 800

********************************
Set EVM to SD card boot mode

Check warning on line 53 in source/devices/AM62PX/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Set EVM to SD card boot mode'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Set EVM to SD card boot mode'.", "location": {"path": "source/devices/AM62PX/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 53, "column": 1}}}, "severity": "INFO"}
********************************
Comment on lines +52 to +54

@StaticRocket StaticRocket Aug 5, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Title overrun


The simplest way to run Linux on the SK EVM is through an SD card. For that, you must
configure the EVM for SD card boot.
Refer to `AM62Px SK EVM User's Guide <https://www.ti.com/tool/SK-AM62P-LP>`__ for
detailed information about boot mode configurations. For quick reference,
the following figure shows the boot mode switch setting for SD card boot.

.. figure:: /images/AM62x_SD_boot.jpg
:height: 600
:width: 800

***************************
Boot and validate Buildroot

Check warning on line 67 in source/devices/AM62PX/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Boot and validate Buildroot'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Boot and validate Buildroot'.", "location": {"path": "source/devices/AM62PX/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 67, "column": 1}}}, "severity": "INFO"}
***************************

Connect the Ethernet cable, HDMI display, mouse, and keyboard to the EVM.
Insert the SD card in the board and power on the EVM.

Booting to prompt will take around 12 seconds.

.. figure:: /images/buildroot_homescreen.png
:height: 600
:width: 800

You have successfully booted Buildroot on AM62Px.
33 changes: 33 additions & 0 deletions source/devices/AM62PX/buildroot/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
.. _linux-index:

###########################
Buildroot Developer's Guide

Check warning on line 4 in source/devices/AM62PX/buildroot/index.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Buildroot Developer's Guide'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Buildroot Developer's Guide'.", "location": {"path": "source/devices/AM62PX/buildroot/index.rst", "range": {"start": {"line": 4, "column": 1}}}, "severity": "INFO"}
###########################

.. rubric:: Welcome to the Buildroot Developer's Guide
:name: welcome-to-the-buildroot-developers-guide

.. include:: ../../../buildroot/_Buildroot_Developers_Guide.rst

.. toctree::
:maxdepth: 5
:hidden:
:numbered:

../../../buildroot/Overview
../linux/Release_Specific
Getting_Started_Guide
../../../buildroot/Building_Buildroot_Image
../../../buildroot/Building_Buildroot_Packages

.. rubric:: Feedback
:name: feedback

If you have feedback, suggestions, or ideas on how to improve the SDK
or docs, it is very appreciated. Please post your ideas to the Linux
forum listed at :ref:`Technical Support <technical-support>`.

Check warning on line 28 in source/devices/AM62PX/buildroot/index.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.UserReplacedValues] Separate words by underscores in user-replaced values.

Raw Output:
{"message": "[RedHat.UserReplacedValues] Separate words by underscores in user-replaced values.", "location": {"path": "source/devices/AM62PX/buildroot/index.rst", "range": {"start": {"line": 28, "column": 41}}}, "severity": "INFO"}


+--------------------------------+-------------------------------------------------------------------------------------+
| .. Image:: /images/E2e.jpg | For technical support please post your questions at `E2E <https://e2e.ti.com/>`__. |

Check warning on line 32 in source/devices/AM62PX/buildroot/index.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.DoNotUseTerms] Do not use "please" in technical documentation.

Raw Output:
{"message": "[RedHat.DoNotUseTerms] Do not use \"please\" in technical documentation.", "location": {"path": "source/devices/AM62PX/buildroot/index.rst", "range": {"start": {"line": 32, "column": 58}}}, "severity": "WARNING"}
+--------------------------------+-------------------------------------------------------------------------------------+
1 change: 1 addition & 0 deletions source/devices/AM62PX/buildroot/version.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
12_01_00_05_03
79 changes: 79 additions & 0 deletions source/devices/AM64X/buildroot/Getting_Started_Guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
##############################
Getting Started with Buildroot

Check warning on line 2 in source/devices/AM64X/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Getting Started with Buildroot'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Getting Started with Buildroot'.", "location": {"path": "source/devices/AM64X/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 2, "column": 1}}}, "severity": "INFO"}

Check warning on line 2 in source/devices/AM64X/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.NoGerundsInTitles] Where possible, avoid using gerunds in topic titles. Use the imperative form instead.

Raw Output:
{"message": "[RedHat.NoGerundsInTitles] Where possible, avoid using gerunds in topic titles. Use the imperative form instead.", "location": {"path": "source/devices/AM64X/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 2, "column": 1}}}, "severity": "INFO"}
##############################

The SD card Image sdcard.img provided on the |__SDK_DOWNLOAD_URL__| is all you
need to get started and explore Buildroot on TI microprocessors.

The Buildroot Image provided has all the basic packages required to boot with
Weston as default window manager. The user can install any new package and
customize the filesystem as required.

Follow the steps mentioned in this page to create an SD card Image.

**************
Hardware Setup

Check warning on line 15 in source/devices/AM64X/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Headings] Use sentence-style capitalization in 'Hardware Setup'.

Raw Output:
{"message": "[RedHat.Headings] Use sentence-style capitalization in 'Hardware Setup'.", "location": {"path": "source/devices/AM64X/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 15, "column": 1}}}, "severity": "INFO"}
**************

In addition to the SK EVM itself, the following hardware is needed:

Check warning on line 18 in source/devices/AM64X/buildroot/Getting_Started_Guide.rst

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[RedHat.Definitions] Define acronyms and abbreviations (such as 'EVM') on first occurrence if they're likely to be unfamiliar.

Raw Output:
{"message": "[RedHat.Definitions] Define acronyms and abbreviations (such as 'EVM') on first occurrence if they're likely to be unfamiliar.", "location": {"path": "source/devices/AM64X/buildroot/Getting_Started_Guide.rst", "range": {"start": {"line": 18, "column": 23}}}, "severity": "INFO"}

1. USB Type-C 5V - 15V and 3A power supply
2. Micro-SD card reader
3. Micro-SD card (16GB or larger recommended)
4. USB Micro-B cable for UART serial communication
5. HDMI display and HDMI cable
6. USB mouse and Keyboard (For controlling the UI)
7. Ethernet cable (For network access)

*********************************
Create SD Card using balenaEtcher
*********************************

1. Download the default bootable SD card image available on the release page as
:file:`tisdk-buildroot-sdcard-image-am64xx-evm-<version>.img` for Linux image
or :file:`tisdk-buildroot-sdcard-image-rt-am64xx-evm-<version>.img` for RT-Linux
image.

2. Download and install the balenaEtcher tool:

Balena Etcher is an open-source utility that can be installed on both Linux and Windows.
Download the tool from `this link <https://www.balena.io/etcher/>`__ and install it.

3. Flash the SD Card image to the SD card:

Insert a micro SD card into the USB SD card reader and start Etcher. Choose the sdcard
image to be flashed, choose the USB SD card reader as the target, and then click "Flash".
Etcher will decompress the image and write it to the SD card, as shown below:

.. figure:: /images/balena_etcher.png
:height: 600
:width: 800

********************************
Set the EVM to SD card Boot mode
********************************

The simplest way to run Linux on the SK EVM is through an SD card. For that, the
EVM will need to be configured for SD card boot.
Refer to `AM64x EVM User's Guide <https://www.ti.com/tool/TMDS64EVM>`__ 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/AM64x_SD_boot.jpg
:height: 600
:width: 800

Comment thread
sadik-smd marked this conversation as resolved.
***************************
Boot and Validate Buildroot
***************************

Make sure to connect the Ethernet cable, HDMI Display, Mouse and Keyboard to the EVM.
Insert the SD Card in the board and Power ON the EVM.

Booting to prompt will take around 12 seconds.

.. figure:: /images/buildroot_homescreen.png
:height: 600
:width: 800

You've successfully booted Buildroot on AM64x.
33 changes: 33 additions & 0 deletions source/devices/AM64X/buildroot/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
.. _linux-index:

###########################
Buildroot Developer's Guide
###########################

.. rubric:: Welcome to the Buildroot Developer's Guide
:name: welcome-to-the-buildroot-developers-guide

.. include:: ../../../buildroot/_Buildroot_Developers_Guide.rst

.. toctree::
:maxdepth: 5
:hidden:
:numbered:

../../../buildroot/Overview
../linux/Release_Specific
Getting_Started_Guide
../../../buildroot/Building_Buildroot_Image
../../../buildroot/Building_Buildroot_Packages

.. rubric:: Feedback
:name: feedback

If you have feedback, suggestions, or ideas on how to improve the SDK
or docs, it is very appreciated. Please post your ideas to the Linux
forum listed at :ref:`Technical Support <technical-support>`.


+--------------------------------+-------------------------------------------------------------------------------------+
| .. Image:: /images/E2e.jpg | For technical support please post your questions at `E2E <https://e2e.ti.com/>`__. |
+--------------------------------+-------------------------------------------------------------------------------------+
1 change: 1 addition & 0 deletions source/devices/AM64X/buildroot/version.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
12_01_00_05_03
Loading