From bc9dfc09210596ebf1140a2addf7b5a54865e8a1 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Tue, 20 Jan 2026 18:27:11 -0600 Subject: [PATCH 1/2] refactor: create boards subdirectory Create a boards subdirectory for board specific information. We may want to start aggregating SK/EVM specific information here later, but right now we can start collecting Beagle specific info. Signed-off-by: Randolph Sapp --- configs/AM335X/AM335X_linux_toc.txt | 6 +++--- configs/AM62LX/AM62LX_linux_toc.txt | 2 +- configs/AM62X/AM62X_android_toc.txt | 2 +- configs/AM67A/AM67A_android_toc.txt | 2 +- .../beagle/BeagleBadge/linux/Getting_Started.rst} | 0 ...w_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst | 0 .../How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst | 0 .../linux}/Program_the_eMMC_on_Beaglebone_Black.rst | 0 .../beagle/BeagleBone/linux}/files/fetcher.sh | 0 .../beagle/BeagleBone/linux}/files/flasher.sh | 0 .../beagle/BeagleBone/linux}/files/interfaces | 0 .../beagle/BeagleBone/linux}/files/sd-card-flasher.sh | 0 .../linux}/files/tisdk_am335x-evm-flasher_defconfig | 0 .../BeaglePlay}/android/Application_Notes_BeaglePlay.rst | 0 .../BeagleY-AI}/android/Application_Notes_BeagleY_AI.rst | 0 source/devices/AM62X/android/Application_Notes.rst | 1 - source/devices/AM67A/android/Application_Notes.rst | 1 - source/linux/How_to_Guides_Developer_Notes.rst | 2 -- source/linux/How_to_Guides_Host.rst | 1 - source/linux/How_to_Guides_Target.rst | 2 -- 20 files changed, 6 insertions(+), 13 deletions(-) rename source/{linux/How_to_Guides/Target/How_to_BeagleBadge_getting_started.rst => boards/beagle/BeagleBadge/linux/Getting_Started.rst} (100%) rename source/{linux/How_to_Guides/Target => boards/beagle/BeagleBone/linux}/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst (100%) rename source/{linux/How_to_Guides/Target => boards/beagle/BeagleBone/linux}/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst (100%) rename source/{linux/How_to_Guides/Host => boards/beagle/BeagleBone/linux}/Program_the_eMMC_on_Beaglebone_Black.rst (100%) rename source/{linux/How_to_Guides/Host => boards/beagle/BeagleBone/linux}/files/fetcher.sh (100%) rename source/{linux/How_to_Guides/Host => boards/beagle/BeagleBone/linux}/files/flasher.sh (100%) rename source/{linux/How_to_Guides/Host => boards/beagle/BeagleBone/linux}/files/interfaces (100%) rename source/{linux/How_to_Guides/Target => boards/beagle/BeagleBone/linux}/files/sd-card-flasher.sh (100%) rename source/{linux/How_to_Guides/Host => boards/beagle/BeagleBone/linux}/files/tisdk_am335x-evm-flasher_defconfig (100%) rename source/{devices/AM62X => boards/beagle/BeaglePlay}/android/Application_Notes_BeaglePlay.rst (100%) rename source/{devices/AM67A => boards/beagle/BeagleY-AI}/android/Application_Notes_BeagleY_AI.rst (100%) diff --git a/configs/AM335X/AM335X_linux_toc.txt b/configs/AM335X/AM335X_linux_toc.txt index 8de467f38..2fc97f30e 100644 --- a/configs/AM335X/AM335X_linux_toc.txt +++ b/configs/AM335X/AM335X_linux_toc.txt @@ -128,15 +128,15 @@ linux/How_to_Guides_Host linux/How_to_Guides/Host/Moving_Files_to_the_Target_System linux/How_to_Guides/Host/Customizing_the_SDK_Splash_Screen linux/How_to_Guides/Host/AM335x_ICEv2_flash_erase -linux/How_to_Guides/Host/Program_the_eMMC_on_Beaglebone_Black +boards/beagle/BeagleBone/linux/Program_the_eMMC_on_Beaglebone_Black linux/How_to_Guides_Target linux/How_to_Guides/Target/Processor_SDK_Linux_File_System_Optimization_Customization linux/How_to_Guides/Target/How_to_add_a_JVM linux/How_to_Guides/Target/Update_U-Boot_Environment_Variables_stored_in_SPI_Flash_from_Linux linux/How_to_Guides/Target/How_to_fix_y2k38 linux/How_to_Guides/Target/How_to_Change_dtb_File -linux/How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux -linux/How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card +boards/beagle/BeagleBone/linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux +boards/beagle/BeagleBone/linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card linux/How_to_Guides_Hardware_Setup_with_CCS linux/How_to_Guides/Hardware_Setup_with_CCS/EVMK2H_Hardware_Setup linux/How_to_Guides/Hardware_Setup_with_CCS/ICE_AM335x_Hardware_Setup diff --git a/configs/AM62LX/AM62LX_linux_toc.txt b/configs/AM62LX/AM62LX_linux_toc.txt index 8fddf4553..a5cbfa9a3 100644 --- a/configs/AM62LX/AM62LX_linux_toc.txt +++ b/configs/AM62LX/AM62LX_linux_toc.txt @@ -124,7 +124,7 @@ linux/How_to_Guides/Target/How_to_emmc_boot linux/How_to_Guides/Target/How_to_mmcsd_boot_emmc_uda linux/How_to_Guides/Target/How_To_Enable_M2CC3301_in_linux linux/How_to_Guides/Target/Runtime_debug_unlock_on_secure_device -linux/How_to_Guides/Target/How_to_BeagleBadge_getting_started +boards/beagle/BeagleBadge/linux/Getting_Started linux/How_to_Guides/FAQ/How_to_Check_Device_Tree_Info linux/How_to_Guides/FAQ/How_to_Integrate_Open_Source_Software linux/How_to_Guides_Hardware_Setup_with_CCS diff --git a/configs/AM62X/AM62X_android_toc.txt b/configs/AM62X/AM62X_android_toc.txt index 31c349a10..d6a51df67 100644 --- a/configs/AM62X/AM62X_android_toc.txt +++ b/configs/AM62X/AM62X_android_toc.txt @@ -3,7 +3,7 @@ devices/AM62X/android/Release_Specific devices/AM62X/android/Release_Specific_Release_Notes devices/AM62X/android/Application_Notes devices/AM62X/android/Application_Notes_dtbo_support -devices/AM62X/android/Application_Notes_BeaglePlay +boards/beagle/BeaglePlay/android/Application_Notes_BeaglePlay android/Application_Notes_M2_WiFi_BT diff --git a/configs/AM67A/AM67A_android_toc.txt b/configs/AM67A/AM67A_android_toc.txt index e1398bffc..4fd1dad58 100644 --- a/configs/AM67A/AM67A_android_toc.txt +++ b/configs/AM67A/AM67A_android_toc.txt @@ -3,7 +3,7 @@ devices/AM67A/android/Release_Specific devices/AM67A/android/Release_Specific_Release_Notes devices/AM67A/android/Application_Notes devices/AM67A/android/Application_Notes_dtbo_support -devices/AM67A/android/Application_Notes_BeagleY_AI +boards/beagle/BeagleY-AI/android/Application_Notes_BeagleY_AI android/Application_Notes_Android_Bootloader_SD_Card android/Application_Notes_Android_Dual_Screen diff --git a/source/linux/How_to_Guides/Target/How_to_BeagleBadge_getting_started.rst b/source/boards/beagle/BeagleBadge/linux/Getting_Started.rst similarity index 100% rename from source/linux/How_to_Guides/Target/How_to_BeagleBadge_getting_started.rst rename to source/boards/beagle/BeagleBadge/linux/Getting_Started.rst diff --git a/source/linux/How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst b/source/boards/beagle/BeagleBone/linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst similarity index 100% rename from source/linux/How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst rename to source/boards/beagle/BeagleBone/linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux.rst diff --git a/source/linux/How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst b/source/boards/beagle/BeagleBone/linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst similarity index 100% rename from source/linux/How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst rename to source/boards/beagle/BeagleBone/linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card.rst diff --git a/source/linux/How_to_Guides/Host/Program_the_eMMC_on_Beaglebone_Black.rst b/source/boards/beagle/BeagleBone/linux/Program_the_eMMC_on_Beaglebone_Black.rst similarity index 100% rename from source/linux/How_to_Guides/Host/Program_the_eMMC_on_Beaglebone_Black.rst rename to source/boards/beagle/BeagleBone/linux/Program_the_eMMC_on_Beaglebone_Black.rst diff --git a/source/linux/How_to_Guides/Host/files/fetcher.sh b/source/boards/beagle/BeagleBone/linux/files/fetcher.sh similarity index 100% rename from source/linux/How_to_Guides/Host/files/fetcher.sh rename to source/boards/beagle/BeagleBone/linux/files/fetcher.sh diff --git a/source/linux/How_to_Guides/Host/files/flasher.sh b/source/boards/beagle/BeagleBone/linux/files/flasher.sh similarity index 100% rename from source/linux/How_to_Guides/Host/files/flasher.sh rename to source/boards/beagle/BeagleBone/linux/files/flasher.sh diff --git a/source/linux/How_to_Guides/Host/files/interfaces b/source/boards/beagle/BeagleBone/linux/files/interfaces similarity index 100% rename from source/linux/How_to_Guides/Host/files/interfaces rename to source/boards/beagle/BeagleBone/linux/files/interfaces diff --git a/source/linux/How_to_Guides/Target/files/sd-card-flasher.sh b/source/boards/beagle/BeagleBone/linux/files/sd-card-flasher.sh similarity index 100% rename from source/linux/How_to_Guides/Target/files/sd-card-flasher.sh rename to source/boards/beagle/BeagleBone/linux/files/sd-card-flasher.sh diff --git a/source/linux/How_to_Guides/Host/files/tisdk_am335x-evm-flasher_defconfig b/source/boards/beagle/BeagleBone/linux/files/tisdk_am335x-evm-flasher_defconfig similarity index 100% rename from source/linux/How_to_Guides/Host/files/tisdk_am335x-evm-flasher_defconfig rename to source/boards/beagle/BeagleBone/linux/files/tisdk_am335x-evm-flasher_defconfig diff --git a/source/devices/AM62X/android/Application_Notes_BeaglePlay.rst b/source/boards/beagle/BeaglePlay/android/Application_Notes_BeaglePlay.rst similarity index 100% rename from source/devices/AM62X/android/Application_Notes_BeaglePlay.rst rename to source/boards/beagle/BeaglePlay/android/Application_Notes_BeaglePlay.rst diff --git a/source/devices/AM67A/android/Application_Notes_BeagleY_AI.rst b/source/boards/beagle/BeagleY-AI/android/Application_Notes_BeagleY_AI.rst similarity index 100% rename from source/devices/AM67A/android/Application_Notes_BeagleY_AI.rst rename to source/boards/beagle/BeagleY-AI/android/Application_Notes_BeagleY_AI.rst diff --git a/source/devices/AM62X/android/Application_Notes.rst b/source/devices/AM62X/android/Application_Notes.rst index 5bdf831d0..e0538e136 100644 --- a/source/devices/AM62X/android/Application_Notes.rst +++ b/source/devices/AM62X/android/Application_Notes.rst @@ -17,5 +17,4 @@ Application Notes /android/Application_Notes_Camera /android/Application_Notes_Simple_UI_App /android/Application_Notes_Sample_Maps_App - Application_Notes_BeaglePlay /android/Application_Notes_Android_Secure_Build diff --git a/source/devices/AM67A/android/Application_Notes.rst b/source/devices/AM67A/android/Application_Notes.rst index ecb24ec31..a336b7663 100644 --- a/source/devices/AM67A/android/Application_Notes.rst +++ b/source/devices/AM67A/android/Application_Notes.rst @@ -16,5 +16,4 @@ Application Notes /android/Application_Notes_Android_Multimedia_Video /android/Application_Notes_Sample_Maps_App /android/Application_Notes_Simple_UI_App - Application_Notes_BeagleY_AI /android/Application_Notes_Android_Secure_Build diff --git a/source/linux/How_to_Guides_Developer_Notes.rst b/source/linux/How_to_Guides_Developer_Notes.rst index d27abecd5..cbc6a644f 100644 --- a/source/linux/How_to_Guides_Developer_Notes.rst +++ b/source/linux/How_to_Guides_Developer_Notes.rst @@ -19,7 +19,6 @@ Developer Notes How_to_Guides/Target/How_to_Change_dtb_File How_to_Guides/Target/How_to_Set_Display_for_AM572x_GP_EVM How_to_Guides/Target/How_To_Enable_M2CC3301_in_linux - How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux How_to_Guides/Target/How_to_flash_emmc_device How_to_Guides/Target/How_to_emmc_boot How_to_Guides/Target/How_to_mmcsd_boot_emmc_uda @@ -35,7 +34,6 @@ Developer Notes How_to_Guides/Target/How_to_enable_SSC_for_DSS How_to_Guides/Target/How_to_boot_quickly How_to_Guides/Target/Runtime_debug_unlock_on_secure_device - How_to_Guides/Target/How_to_BeagleBadge_getting_started How_to_Guides/FAQ/How_to_Verify_Ipc_Linux_R5 How_to_Guides/FAQ/How_to_Configure_MSMC_memory How_to_Guides/FAQ/How_to_Check_Device_Tree_Info diff --git a/source/linux/How_to_Guides_Host.rst b/source/linux/How_to_Guides_Host.rst index 9dfb2156f..a323133cc 100644 --- a/source/linux/How_to_Guides_Host.rst +++ b/source/linux/How_to_Guides_Host.rst @@ -15,7 +15,6 @@ Host How_to_Guides/Host/AM335x_ICEv2_flash_erase How_to_Guides/Host/Additional_How_to_Guide_Links How_to_Guides/Host/AM335x_AM437x_Hardware_Migration_Guide - How_to_Guides/Host/Program_the_eMMC_on_Beaglebone_Black How_to_Guides/Host/K3_Resource_Partitioning_Tool How_to_Guides/Host/How_to_Setup_and_Debug_using_Lauterbach How_to_Guides/Host/SYSFW_Trace_Parser diff --git a/source/linux/How_to_Guides_Target.rst b/source/linux/How_to_Guides_Target.rst index f99789727..27756f1f4 100644 --- a/source/linux/How_to_Guides_Target.rst +++ b/source/linux/How_to_Guides_Target.rst @@ -10,10 +10,8 @@ Target How_to_Guides/Target/Update_U-Boot_Environment_Variables_stored_in_SPI_Flash_from_Linux How_to_Guides/Target/How_to_Change_dtb_File How_to_Guides/Target/How_to_Set_Display_for_AM572x_GP_EVM - How_to_Guides/Target/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux How_to_Guides/Target/How_to_flash_emmc_device How_to_Guides/Target/How_to_visualize_statistics_data How_to_Guides/Target/How_to_Use_K3Conf_Tool How_to_Guides/Target/How_to_Tune_Real_Time_Linux - How_to_Guides/Target/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card How_to_Guides/Target/How_to_fix_y2k38 From 5085c8c311ccec48d527eeafeb17304a2429ff82 Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Tue, 20 Jan 2026 20:36:11 -0600 Subject: [PATCH 2/2] feat(boards): add landing pages for beagle devices Add a landing page for the main beagle devices. Future ones can be added and the flavor text for each platform is subject to change. Signed-off-by: Randolph Sapp --- configs/AM335X/AM335X_linux_toc.txt | 10 ++- configs/AM62LX/AM62LX_linux_toc.txt | 5 +- configs/AM62X/AM62X_android_toc.txt | 3 + configs/AM62X/AM62X_linux_toc.txt | 3 + configs/AM67A/AM67A_android_toc.txt | 3 + configs/AM67A/AM67A_linux_toc.txt | 3 + .../boards/beagle/BeagleBadge/BeagleBadge.rst | 29 +++++++++ .../BeagleBadge/linux/Getting_Started.rst | 63 ++++++------------- .../boards/beagle/BeagleBone/BeagleBone.rst | 25 ++++++++ .../boards/beagle/BeaglePlay/BeaglePlay.rst | 23 +++++++ .../boards/beagle/BeagleY-AI/BeagleY-AI.rst | 23 +++++++ source/boards/index.rst | 15 +++++ source/devices/AM335X/linux/index.rst | 1 + source/devices/AM62LX/index.rst | 1 + source/devices/AM62X/index.rst | 1 + source/devices/J7_Family/linux/index.rst | 1 + 16 files changed, 160 insertions(+), 49 deletions(-) create mode 100644 source/boards/beagle/BeagleBadge/BeagleBadge.rst create mode 100644 source/boards/beagle/BeagleBone/BeagleBone.rst create mode 100644 source/boards/beagle/BeaglePlay/BeaglePlay.rst create mode 100644 source/boards/beagle/BeagleY-AI/BeagleY-AI.rst create mode 100644 source/boards/index.rst diff --git a/configs/AM335X/AM335X_linux_toc.txt b/configs/AM335X/AM335X_linux_toc.txt index 2fc97f30e..92f5ece71 100644 --- a/configs/AM335X/AM335X_linux_toc.txt +++ b/configs/AM335X/AM335X_linux_toc.txt @@ -128,15 +128,12 @@ linux/How_to_Guides_Host linux/How_to_Guides/Host/Moving_Files_to_the_Target_System linux/How_to_Guides/Host/Customizing_the_SDK_Splash_Screen linux/How_to_Guides/Host/AM335x_ICEv2_flash_erase -boards/beagle/BeagleBone/linux/Program_the_eMMC_on_Beaglebone_Black linux/How_to_Guides_Target linux/How_to_Guides/Target/Processor_SDK_Linux_File_System_Optimization_Customization linux/How_to_Guides/Target/How_to_add_a_JVM linux/How_to_Guides/Target/Update_U-Boot_Environment_Variables_stored_in_SPI_Flash_from_Linux linux/How_to_Guides/Target/How_to_fix_y2k38 linux/How_to_Guides/Target/How_to_Change_dtb_File -boards/beagle/BeagleBone/linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux -boards/beagle/BeagleBone/linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card linux/How_to_Guides_Hardware_Setup_with_CCS linux/How_to_Guides/Hardware_Setup_with_CCS/EVMK2H_Hardware_Setup linux/How_to_Guides/Hardware_Setup_with_CCS/ICE_AM335x_Hardware_Setup @@ -164,4 +161,11 @@ common/PRU-ICSS/PRU-Getting-Started-Labs_Lab5 common/PRU-ICSS/PRU-Hands-on-Labs common/PRU-ICSS/Resource_Tables + +boards/index +boards/beagle/BeagleBone/BeagleBone +boards/beagle/BeagleBone/linux/Program_the_eMMC_on_Beaglebone_Black +boards/beagle/BeagleBone/linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux +boards/beagle/BeagleBone/linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card + linux/Documentation_Tarball diff --git a/configs/AM62LX/AM62LX_linux_toc.txt b/configs/AM62LX/AM62LX_linux_toc.txt index a5cbfa9a3..bfc38c625 100644 --- a/configs/AM62LX/AM62LX_linux_toc.txt +++ b/configs/AM62LX/AM62LX_linux_toc.txt @@ -124,7 +124,6 @@ linux/How_to_Guides/Target/How_to_emmc_boot linux/How_to_Guides/Target/How_to_mmcsd_boot_emmc_uda linux/How_to_Guides/Target/How_To_Enable_M2CC3301_in_linux linux/How_to_Guides/Target/Runtime_debug_unlock_on_secure_device -boards/beagle/BeagleBadge/linux/Getting_Started linux/How_to_Guides/FAQ/How_to_Check_Device_Tree_Info linux/How_to_Guides/FAQ/How_to_Integrate_Open_Source_Software linux/How_to_Guides_Hardware_Setup_with_CCS @@ -132,4 +131,8 @@ linux/How_to_Guides/Hardware_Setup_with_CCS/AM62Lx_EVM_Hardware_Setup linux/Demo_User_Guides/index_Demos linux/Demo_User_Guides/TI_LVGL_Demo_User_Guide +boards/index +boards/beagle/BeagleBadge/BeagleBadge +boards/beagle/BeagleBadge/linux/Getting_Started + linux/Documentation_Tarball diff --git a/configs/AM62X/AM62X_android_toc.txt b/configs/AM62X/AM62X_android_toc.txt index d6a51df67..ed72b5f1d 100644 --- a/configs/AM62X/AM62X_android_toc.txt +++ b/configs/AM62X/AM62X_android_toc.txt @@ -3,6 +3,9 @@ devices/AM62X/android/Release_Specific devices/AM62X/android/Release_Specific_Release_Notes devices/AM62X/android/Application_Notes devices/AM62X/android/Application_Notes_dtbo_support + +boards/index +boards/beagle/BeaglePlay/BeaglePlay boards/beagle/BeaglePlay/android/Application_Notes_BeaglePlay android/Application_Notes_M2_WiFi_BT diff --git a/configs/AM62X/AM62X_linux_toc.txt b/configs/AM62X/AM62X_linux_toc.txt index a19dc9d9f..fbacd072c 100644 --- a/configs/AM62X/AM62X_linux_toc.txt +++ b/configs/AM62X/AM62X_linux_toc.txt @@ -204,4 +204,7 @@ common/PRU-ICSS/PRU-Getting-Started-Labs_Lab5 common/PRU-ICSS/PRU-Hands-on-Labs common/PRU-ICSS/Resource_Tables +boards/index +boards/beagle/BeaglePlay/BeaglePlay + linux/Documentation_Tarball diff --git a/configs/AM67A/AM67A_android_toc.txt b/configs/AM67A/AM67A_android_toc.txt index 4fd1dad58..f33f549fc 100644 --- a/configs/AM67A/AM67A_android_toc.txt +++ b/configs/AM67A/AM67A_android_toc.txt @@ -3,6 +3,9 @@ devices/AM67A/android/Release_Specific devices/AM67A/android/Release_Specific_Release_Notes devices/AM67A/android/Application_Notes devices/AM67A/android/Application_Notes_dtbo_support + +boards/index +boards/beagle/BeagleY-AI/BeagleY-AI boards/beagle/BeagleY-AI/android/Application_Notes_BeagleY_AI android/Application_Notes_Android_Bootloader_SD_Card diff --git a/configs/AM67A/AM67A_linux_toc.txt b/configs/AM67A/AM67A_linux_toc.txt index 532edf609..83ad81ca1 100644 --- a/configs/AM67A/AM67A_linux_toc.txt +++ b/configs/AM67A/AM67A_linux_toc.txt @@ -133,3 +133,6 @@ linux/Documentation_Tarball linux/Demo_User_Guides/index_Demos linux/Demo_User_Guides/Edge_AI_Gallery_User_Guide + +boards/index +boards/beagle/BeagleY-AI/BeagleY-AI diff --git a/source/boards/beagle/BeagleBadge/BeagleBadge.rst b/source/boards/beagle/BeagleBadge/BeagleBadge.rst new file mode 100644 index 000000000..bc276fbb5 --- /dev/null +++ b/source/boards/beagle/BeagleBadge/BeagleBadge.rst @@ -0,0 +1,29 @@ +########### +BeagleBadge +########### + +The BeagleBadge is a compact development platform from `BeagleBoard `__ powered +by the `TI AM62L SoC `__. Designed for portable and low-power applications, +it features a built-in CC33xx chip supporting WI-FI and Bluetooth applications, multiple low power modes, and +an integrated fuel gauge for battery power monitoring. The board provides a rich interface including an e-paper +connector, DSI connector, Grove expansion, seven-segment displays, and an RGB LED. Fully supported in TI sources, +the BeagleBadge offers flexible boot options (OSPI, UART, SD, USB-DFU). It supports Zephyr or Linux (with Armbian +or Arago distributions), making it an ideal open source solution for modern IoT and HMI projects. + +.. list-table:: Supported Distributions + :header-rows: 1 + :widths: 15, 15 + + * - Component + - Branch + * - Armbian + - `2025.12-beaglebadge `__ + * - Arago + - `Scarthgap `__ + +.. toctree:: + + linux/Getting_Started + +For more information see +``__. diff --git a/source/boards/beagle/BeagleBadge/linux/Getting_Started.rst b/source/boards/beagle/BeagleBadge/linux/Getting_Started.rst index 2bd84a01f..55e3e7650 100644 --- a/source/boards/beagle/BeagleBadge/linux/Getting_Started.rst +++ b/source/boards/beagle/BeagleBadge/linux/Getting_Started.rst @@ -1,38 +1,22 @@ -########################### -BeagleBadge Getting Started -########################### - -******** -Overview -******** - -The BeagleBadge is a compact development platform from `BeagleBoard `__ powered -by the `TI AM62L SoC `__. Designed for portable and low-power applications, -it features a built-in CC33xx chip supporting WI-FI and Bluetooth applications, multiple low power modes, and -an integrated fuel gauge for battery power monitoring. The board provides a rich interface including an e-paper -connector, DSI connector, Grove expansion, seven-segment displays, and an RGB LED. Fully supported in TI sources, -the BeagleBadge offers flexible boot options (OSPI, UART, SD, USB-DFU). It supports Zephyr or Linux (with Armbian -or Arago distributions), making it an ideal open source solution for modern IoT and HMI projects. - -********* +######### Boot Flow -********* +######### BeagleBadge has a `TI AM62L SoC `__, refer to :ref:`AM62Lx Boot Flow ` for more details on AM62L boot flow. -************ +############ Applications -************ +############ - Deep Sleep Low Power mode as low as 350mW power draw - RTC only mode with 3-5mW power draw - E-Paper display support with tinyDRM - Battery-powered with fuel gauge monitoring -***************** +################# Low level sources -***************** +################# .. list-table:: :header-rows: 1 @@ -48,24 +32,9 @@ Low level sources - `ti-linux-6.12.y `__ - :file:`arch/arm64/boot/dts/ti/k3-am62l3-beaglebadge.dts` -*********************** -Supported Distributions -*********************** - -.. list-table:: - :header-rows: 1 - :widths: 15, 15 - - * - Component - - Branch - * - Armbian - - `2025.12-beaglebadge `__ - * - Arago - - `Scarthgap `__ - -************************ +######################## Building for BeagleBadge -************************ +######################## .. code-block:: console @@ -89,9 +58,9 @@ For more information on building Arago for BeagleBadge, go :ref:`here `__. -******************* +################### Booting BeagleBadge -******************* +################### BeagleBadge supports four boot modes with the following configuration: @@ -106,8 +75,9 @@ BeagleBadge supports four boot modes with the following configuration: In the following instructions, assume /dev/ttyUSB0 is the serial port enumerated on host machine from BeagleBadge USB C connection. +******* SD boot -======= +******* 1. Flash SD card with Debian or Arago image 2. Insert Micro SD card @@ -115,8 +85,9 @@ SD boot 4. Connect USB C cable 5. Connect to /dev/ttyUSB0 on host machine +********* OSPI boot -========= +********* 1. Boot via SD boot and stop at u-boot prompt 2. Flash OSPI @@ -144,8 +115,9 @@ OSPI boot 3. Cold reset the board by disconnecting and reconnecting USB C cable. 4. Reconnect to /dev/ttyUSB0 on host machine +********* UART boot -========= +********* 1. Connect USB C cable 2. Connect to /dev/ttyUSB0 on host machine @@ -157,8 +129,9 @@ UART boot $ sb --xmodem tispl.bin > /dev/ttyUSB0 < /dev/ttyUSB0 $ sb --ymodem u-boot.img > /dev/ttyUSB0 < /dev/ttyUSB0 +************ USB-DFU boot -============ +************ 1. Press & hold **Select** until step 4 2. Connect USB C cable diff --git a/source/boards/beagle/BeagleBone/BeagleBone.rst b/source/boards/beagle/BeagleBone/BeagleBone.rst new file mode 100644 index 000000000..7b8c9008e --- /dev/null +++ b/source/boards/beagle/BeagleBone/BeagleBone.rst @@ -0,0 +1,25 @@ +########## +BeagleBone +########## + +The BeagleBone line of development boards from `BeagleBoard +`__ use the |__PART_FAMILY_DEVICE_NAMES__|. +They are low-cost, primarily community-supported development platforms. + +.. list-table:: Supported Distributions + :header-rows: 1 + :widths: 15, 15 + + * - Component + - Branch + * - Arago + - `Scarthgap `__ + +.. toctree:: + + linux/How_to_Boot_Beagle_Bone_Black_with_Processor_SDK_Linux + linux/How_to_Program_Beaglebone_Black_eMMC_via_SD_Card + linux/Program_the_eMMC_on_Beaglebone_Black + +For more information see +``__. diff --git a/source/boards/beagle/BeaglePlay/BeaglePlay.rst b/source/boards/beagle/BeaglePlay/BeaglePlay.rst new file mode 100644 index 000000000..d6883fe24 --- /dev/null +++ b/source/boards/beagle/BeaglePlay/BeaglePlay.rst @@ -0,0 +1,23 @@ +########## +BeaglePlay +########## + +The BeaglePlay development board from `BeagleBoard +`__ uses the |__PART_FAMILY_DEVICE_NAMES__|. It is +a low-cost, primarily community-supported development platform. + +.. list-table:: Supported Distributions + :header-rows: 1 + :widths: 15, 15 + + * - Component + - Branch + * - Arago + - `Scarthgap `__ + +.. toctree:: + + android/Application_Notes_BeaglePlay + +For more information see +``__. diff --git a/source/boards/beagle/BeagleY-AI/BeagleY-AI.rst b/source/boards/beagle/BeagleY-AI/BeagleY-AI.rst new file mode 100644 index 000000000..400eddf4c --- /dev/null +++ b/source/boards/beagle/BeagleY-AI/BeagleY-AI.rst @@ -0,0 +1,23 @@ +########## +BeagleY-AI +########## + +The BeagleY-AI development board from `BeagleBoard +`__ uses the |__PART_FAMILY_DEVICE_NAMES__|. It is +a low-cost, primarily community-supported development platform. + +.. list-table:: Supported Distributions + :header-rows: 1 + :widths: 15, 15 + + * - Component + - Branch + * - Arago + - `Scarthgap `__ + +.. toctree:: + + android/Application_Notes_BeagleY_AI + +For more information see +``__. diff --git a/source/boards/index.rst b/source/boards/index.rst new file mode 100644 index 000000000..def4634fd --- /dev/null +++ b/source/boards/index.rst @@ -0,0 +1,15 @@ +################ +Supported Boards +################ + +For any given system on a chip (SoC), there might be an external board that is +supported. These boards can have their own operating system specific information +or guides. The following is a list of relevant boards for +|__PART_FAMILY_DEVICE_NAMES__|. + +.. toctree:: + + beagle/BeagleBone/BeagleBone + beagle/BeaglePlay/BeaglePlay + beagle/BeagleY-AI/BeagleY-AI + beagle/BeagleBadge/BeagleBadge diff --git a/source/devices/AM335X/linux/index.rst b/source/devices/AM335X/linux/index.rst index 29a33a706..d56767282 100644 --- a/source/devices/AM335X/linux/index.rst +++ b/source/devices/AM335X/linux/index.rst @@ -20,6 +20,7 @@ Processor SDK Linux Software Developer's Guide /linux/Industrial_Protocols /linux/Examples_and_Demos /linux/How_to_Guides + /boards/index /linux/Documentation_Tarball | diff --git a/source/devices/AM62LX/index.rst b/source/devices/AM62LX/index.rst index e675feb1e..1e3e9bdd5 100644 --- a/source/devices/AM62LX/index.rst +++ b/source/devices/AM62LX/index.rst @@ -18,6 +18,7 @@ Linux SDK Software Developer's Guide /linux/Foundational_Components /linux/How_to_Guides /linux/Demo_User_Guides/index_Demos + /boards/index /linux/Documentation_Tarball | diff --git a/source/devices/AM62X/index.rst b/source/devices/AM62X/index.rst index 4988bb231..189a8fbba 100644 --- a/source/devices/AM62X/index.rst +++ b/source/devices/AM62X/index.rst @@ -19,6 +19,7 @@ Processor SDK Linux Software Developer's Guide /linux/How_to_Guides /devices/AM62X/index_RTOS /linux/Demo_User_Guides/index_Demos + /boards/index /linux/Documentation_Tarball | diff --git a/source/devices/J7_Family/linux/index.rst b/source/devices/J7_Family/linux/index.rst index a2268369b..1fe83f6e6 100644 --- a/source/devices/J7_Family/linux/index.rst +++ b/source/devices/J7_Family/linux/index.rst @@ -20,6 +20,7 @@ Processor SDK Linux Software Developer's Guide /linux/index_Edge_AI /linux/How_to_Guides /linux/Demo_User_Guides/index_Demos + /boards/index /linux/Documentation_Tarball |