Skip to content

Commit 102ae77

Browse files
sadik-smdVeeruPrudhvi
sadik-smd
authored and
VeeruPrudhvi
committed
feat(buildroot): add configs and sources for am64x
add configs and sources for buildroot distro for am64x evm platform. Signed-off-by: Mahammed Sadik Shaik <s-sadik@ti.com>
1 parent 70dae98 commit 102ae77

6 files changed

Lines changed: 157 additions & 0 deletions

File tree

‎configs/AM64X/AM64X_buildroot_config.txt‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# General family replacement variables and configuration values for Buildroot build
2+
3+
# This file is processed by Python scripts to define both replacement
4+
# variable and configuration values for a device family build.
5+
# For replacement variables, all variables should be listed on a single
6+
# line, and all the variables should be listed on consecutive lines
7+
# (i.e. no additional blank lines between the replacement variables).
8+
# Similarly, all the configuration values should be listed on individual,
9+
# consecutive lines (with no blank lines between the configuration values).
10+
#
11+
# Note that neither replacement variables nor configuration values may contain
12+
# a colon (i.e. ":") in their name. However, values may contain colons.
13+
14+
Replacement Variables
15+
---------------------
16+
'__PART_FAMILY_NAME__' : 'AM64x'
17+
'__PART_FAMILY_DEVICE_NAMES__' : 'AM64x'
18+
'__PRODUCT_LINE_NAME__' : 'Sitara MPU'
19+
'__SDK_BUILD_MACHINE__' : 'am64xx-evm'
20+
'__SDK_FULL_NAME__' : 'Buildroot for AM64x'
21+
'__SDK_SHORT_NAME__' : 'Buildroot'
22+
'__SDK_DOWNLOAD_URL__' : '`AM64x-SDK-Download-page <https://www.ti.com/tool/PROCESSOR-SDK-AM64X>`__'
23+
'__LINUX_UBUNTU_VERSION_LONG__' : '22.04 (64-bit)'
24+
'__LINUX_UBUNTU_VERSION_SHORT__' : '22.04'
25+
26+
Configuration Values
27+
--------------------
28+
'CONFIG_part_family' : 'AM64X_family'
29+
'CONFIG_part_variant' : 'AM64X'
30+
'CONFIG_sdk' : 'BuildrootSDK'

‎configs/AM64X/AM64X_buildroot_tags.py‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Project name and HTML title
2+
project = u'Buildroot for AM64x'
3+
html_title = 'Buildroot AM64x Documentation'
4+
5+
# The master toctree document.
6+
master_doc = 'devices/AM64X/buildroot/index'

‎configs/AM64X/AM64X_buildroot_toc.txt‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
devices/AM64X/buildroot/index
2+
devices/AM64X/buildroot/Getting_Started_Guide
3+
4+
buildroot/Overview
5+
devices/AM64X/linux/Release_Specific
6+
devices/AM64X/linux/Release_Specific_Release_Notes
7+
buildroot/Building_Buildroot_Image
8+
buildroot/Building_Buildroot_Packages

‎source/devices/AM64X/buildroot/Getting_Started_Guide.rst‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
##############################
2+
Getting Started with Buildroot
3+
##############################
4+
5+
The SD card Image sdcard.img provided on the |__SDK_DOWNLOAD_URL__| is all you
6+
need to get started and explore Buildroot on TI microprocessors.
7+
8+
The Buildroot Image provided has all the basic packages required to boot with
9+
Weston as default window manager. The user can install any new package and
10+
customize the filesystem as required.
11+
12+
Follow the steps mentioned in this page to create an SD card Image.
13+
14+
**************
15+
Hardware Setup
16+
**************
17+
18+
In addition to the SK EVM itself, the following hardware is needed:
19+
20+
1. USB Type-C 5V - 15V and 3A power supply
21+
2. Micro-SD card reader
22+
3. Micro-SD card (16GB or larger recommended)
23+
4. USB Micro-B cable for UART serial communication
24+
5. HDMI display and HDMI cable
25+
6. USB mouse and Keyboard (For controlling the UI)
26+
7. Ethernet cable (For network access)
27+
28+
*********************************
29+
Create SD Card using balenaEtcher
30+
*********************************
31+
32+
1. Download the default bootable SD card image available on the release page as
33+
:file:`tisdk-buildroot-sdcard-image-am64xx-evm-<version>.img` for Linux image
34+
or :file:`tisdk-buildroot-sdcard-image-rt-am64xx-evm-<version>.img` for RT-Linux
35+
image.
36+
37+
2. Download and install the balenaEtcher tool:
38+
39+
Balena Etcher is an open-source utility that can be installed on both Linux and Windows.
40+
Download the tool from `this link <https://www.balena.io/etcher/>`__ and install it.
41+
42+
3. Flash the SD Card image to the SD card:
43+
44+
Insert a micro SD card into the USB SD card reader and start Etcher. Choose the sdcard
45+
image to be flashed, choose the USB SD card reader as the target, and then click "Flash".
46+
Etcher will decompress the image and write it to the SD card, as shown below:
47+
48+
.. figure:: /images/balena_etcher.png
49+
:height: 600
50+
:width: 800
51+
52+
********************************
53+
Set the EVM to SD card Boot mode
54+
********************************
55+
56+
The simplest way to run Linux on the SK EVM is through an SD card. For that, the
57+
EVM will need to be configured for SD card boot.
58+
Refer to `AM64x EVM User's Guide <https://www.ti.com/tool/TMDS64EVM>`__ for
59+
detailed information about boot mode configurations. For quick reference,
60+
the figure below shows the boot mode switch setting for SD card boot.
61+
62+
.. figure:: /images/AM64x_SD_boot.jpg
63+
:height: 600
64+
:width: 800
65+
66+
***************************
67+
Boot and Validate Buildroot
68+
***************************
69+
70+
Make sure to connect the Ethernet cable, HDMI Display, Mouse and Keyboard to the EVM.
71+
Insert the SD Card in the board and Power ON the EVM.
72+
73+
Booting to prompt will take around 12 seconds.
74+
75+
.. figure:: /images/buildroot_homescreen.png
76+
:height: 600
77+
:width: 800
78+
79+
You've successfully booted Buildroot on AM64x.

‎source/devices/AM64X/buildroot/index.rst‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
.. _linux-index:
2+
3+
###########################
4+
Buildroot Developer's Guide
5+
###########################
6+
7+
.. rubric:: Welcome to the Buildroot Developer's Guide
8+
:name: welcome-to-the-buildroot-developers-guide
9+
10+
.. include:: ../../../buildroot/_Buildroot_Developers_Guide.rst
11+
12+
.. toctree::
13+
:maxdepth: 5
14+
:hidden:
15+
:numbered:
16+
17+
../../../buildroot/Overview
18+
../linux/Release_Specific
19+
Getting_Started_Guide
20+
../../../buildroot/Building_Buildroot_Image
21+
../../../buildroot/Building_Buildroot_Packages
22+
23+
.. rubric:: Feedback
24+
:name: feedback
25+
26+
If you have feedback, suggestions, or ideas on how to improve the SDK
27+
or docs, it is very appreciated. Please post your ideas to the Linux
28+
forum listed at :ref:`Technical Support <technical-support>`.
29+
30+
31+
+--------------------------------+-------------------------------------------------------------------------------------+
32+
| .. Image:: /images/E2e.jpg | For technical support please post your questions at `E2E <https://e2e.ti.com/>`__. |
33+
+--------------------------------+-------------------------------------------------------------------------------------+

‎source/devices/AM64X/buildroot/version.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
12_01_00_05_03

0 commit comments

Comments
 (0)