-
Notifications
You must be signed in to change notification settings - Fork 88
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.
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
Merged
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 lines 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' |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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' |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 lines 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' |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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' |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,79 @@ | ||
| ########################## | ||
| Get 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. 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 | ||
| **************************** | ||
|
|
||
| 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 | ||
| *************************** | ||
|
|
||
| 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. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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/>`__. | | ||
| +--------------------------------+-------------------------------------------------------------------------------------+ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| 12_01_00_05_03 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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-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 | ||
|
|
||
| *************************** | ||
| 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. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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/>`__. | | ||
| +--------------------------------+-------------------------------------------------------------------------------------+ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| 12_01_00_05_03 |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.