diff --git a/configs/AM62PX/AM62PX_buildroot_config.txt b/configs/AM62PX/AM62PX_buildroot_config.txt new file mode 100644 index 000000000..efa56540d --- /dev/null +++ b/configs/AM62PX/AM62PX_buildroot_config.txt @@ -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 `__' +'__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' diff --git a/configs/AM62PX/AM62PX_buildroot_tags.py b/configs/AM62PX/AM62PX_buildroot_tags.py new file mode 100644 index 000000000..e4f1b37a4 --- /dev/null +++ b/configs/AM62PX/AM62PX_buildroot_tags.py @@ -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' diff --git a/configs/AM62PX/AM62PX_buildroot_toc.txt b/configs/AM62PX/AM62PX_buildroot_toc.txt new file mode 100644 index 000000000..d34d93e4c --- /dev/null +++ b/configs/AM62PX/AM62PX_buildroot_toc.txt @@ -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 diff --git a/configs/AM64X/AM64X_buildroot_config.txt b/configs/AM64X/AM64X_buildroot_config.txt new file mode 100644 index 000000000..bdd4b8720 --- /dev/null +++ b/configs/AM64X/AM64X_buildroot_config.txt @@ -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 `__' +'__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' diff --git a/configs/AM64X/AM64X_buildroot_tags.py b/configs/AM64X/AM64X_buildroot_tags.py new file mode 100644 index 000000000..a4397544e --- /dev/null +++ b/configs/AM64X/AM64X_buildroot_tags.py @@ -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' diff --git a/configs/AM64X/AM64X_buildroot_toc.txt b/configs/AM64X/AM64X_buildroot_toc.txt new file mode 100644 index 000000000..af20f1b14 --- /dev/null +++ b/configs/AM64X/AM64X_buildroot_toc.txt @@ -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 diff --git a/source/devices/AM62PX/buildroot/Getting_Started_Guide.rst b/source/devices/AM62PX/buildroot/Getting_Started_Guide.rst new file mode 100644 index 000000000..78bf74cd9 --- /dev/null +++ b/source/devices/AM62PX/buildroot/Getting_Started_Guide.rst @@ -0,0 +1,79 @@ +############################## +Getting Started with Buildroot +############################## + +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 +************** + +In addition to the SK EVM itself, the following hardware is needed: + +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-am62pxx-evm-.img` for Linux image + or :file:`tisdk-buildroot-sdcard-image-rt-am62pxx-evm-.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 `__ 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 `AM62Px SK EVM User's Guide `__ 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 + +*************************** +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 AM62Px. diff --git a/source/devices/AM62PX/buildroot/index.rst b/source/devices/AM62PX/buildroot/index.rst new file mode 100644 index 000000000..88bcba07d --- /dev/null +++ b/source/devices/AM62PX/buildroot/index.rst @@ -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 + /devices/AM62PX/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 `. + + ++--------------------------------+-------------------------------------------------------------------------------------+ +| .. Image:: /images/E2e.jpg | For technical support please post your questions at `E2E `__. | ++--------------------------------+-------------------------------------------------------------------------------------+ diff --git a/source/devices/AM62PX/buildroot/version.txt b/source/devices/AM62PX/buildroot/version.txt new file mode 100644 index 000000000..315ed9971 --- /dev/null +++ b/source/devices/AM62PX/buildroot/version.txt @@ -0,0 +1 @@ +12_01_00_05_03 diff --git a/source/devices/AM64X/buildroot/Getting_Started_Guide.rst b/source/devices/AM64X/buildroot/Getting_Started_Guide.rst new file mode 100644 index 000000000..20295376f --- /dev/null +++ b/source/devices/AM64X/buildroot/Getting_Started_Guide.rst @@ -0,0 +1,74 @@ +############################## +Getting Started with Buildroot +############################## + +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 +************** + +In addition to the SK EVM itself, the following hardware is needed: + +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-.img` for Linux image + or :file:`tisdk-buildroot-sdcard-image-rt-am64xx-evm-.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 `__ 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 `__ for +detailed information about boot mode configurations. + +*************************** +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. diff --git a/source/devices/AM64X/buildroot/index.rst b/source/devices/AM64X/buildroot/index.rst new file mode 100644 index 000000000..6a80b34c0 --- /dev/null +++ b/source/devices/AM64X/buildroot/index.rst @@ -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 + /devices/AM64X/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 `. + + ++--------------------------------+-------------------------------------------------------------------------------------+ +| .. Image:: /images/E2e.jpg | For technical support please post your questions at `E2E `__. | ++--------------------------------+-------------------------------------------------------------------------------------+ diff --git a/source/devices/AM64X/buildroot/version.txt b/source/devices/AM64X/buildroot/version.txt new file mode 100644 index 000000000..315ed9971 --- /dev/null +++ b/source/devices/AM64X/buildroot/version.txt @@ -0,0 +1 @@ +12_01_00_05_03