From a8409798b8ef6db7f25c37d2161d1de3f90662ca Mon Sep 17 00:00:00 2001 From: Randolph Sapp Date: Fri, 7 Nov 2025 17:08:10 -0600 Subject: [PATCH] fix(boot_monitor): remove deprecated boot utility This old example has not been maintained and the u-boot commands referenced in it's documentation do not seem to exist anymore. Signed-off-by: Randolph Sapp --- configs/AM57X/AM57X_linux_toc.txt | 1 - source/images/Boot-kernel-arch.jpg | Bin 14444 -> 0 bytes source/linux/Foundational_Components.rst | 1 - .../_Boot_Monitor_Release_Notes.rst | 19 --- .../_Boot_Monitor_Users_Guide.rst | 135 ------------------ .../Foundational_Components/_Boot_Monitor.rst | 9 -- .../Foundational_Components_Boot_Monitor.rst | 3 - 7 files changed, 168 deletions(-) delete mode 100644 source/images/Boot-kernel-arch.jpg delete mode 100644 source/linux/Foundational_Components/Boot_Monitor/_Boot_Monitor_Release_Notes.rst delete mode 100644 source/linux/Foundational_Components/Boot_Monitor/_Boot_Monitor_Users_Guide.rst delete mode 100644 source/linux/Foundational_Components/_Boot_Monitor.rst delete mode 100644 source/linux/Foundational_Components_Boot_Monitor.rst diff --git a/configs/AM57X/AM57X_linux_toc.txt b/configs/AM57X/AM57X_linux_toc.txt index 23a72345c..650b450a1 100644 --- a/configs/AM57X/AM57X_linux_toc.txt +++ b/configs/AM57X/AM57X_linux_toc.txt @@ -44,7 +44,6 @@ linux/Foundational_Components/U-Boot/Applications linux/Foundational_Components/U-Boot/Apps-SPL-Debug-OpenOCD linux/Foundational_Components/U-Boot/Apps-Load-in-CCS linux/Foundational_Components/U-Boot/Apps-TroubleShooting -linux/Foundational_Components_Boot_Monitor linux/Foundational_Components_Kernel linux/Foundational_Components_Kernel_Drivers linux/Foundational_Components/Kernel/Kernel_Drivers/ADC diff --git a/source/images/Boot-kernel-arch.jpg b/source/images/Boot-kernel-arch.jpg deleted file mode 100644 index f3b8790dc64dda7a1275f502b863e11e99ce0208..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14444 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

A;<=%S*uj|65x1I<% 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/linux-devkit/sysroots/x86_64-arago-linux/usr/bin:$PATH - -The command to clean the boot monitor - -:: - - $ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- clean - -The command to build the boot monitor - -:: - - $ make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- [image_] - -:: - - where ks2_platform = k2hk, k2e, k2l, or k2g - if image_ is left blank, all platforms will be built. - -| - -.. rubric:: Boot sequence of primary core - :name: boot-sequence-of-primary-core - -In the primary ARM core, ROM boot loader (RBL) code is run on Power on -reset. After completing its task, RBL load and run u-boot code in the -non secure mode. Boot monitor gets install through the command -mon\_install(). As part of this following will happen - -- boot monitor primary core entry point is entered via the branch - address where it was installed -- As part of non secure entry, boot monitor calls the RBL API (smc #0) - through SMC call passing the \_skern\_init() as the argument. This - function get called as part of the RBL code -- \_skern\_init() assembly function copies the RBL stack to its own - stack. It initializes the monitor vector and SP to point to its own - values. It then calls skern\_init() C function to initialize to do - Core or CPU specific initialization. r0 points to where it enters - from primary core or secondary core, r1 points to the Tetris PSC base - address and r2 points to the ARM Arch timer clock rate. RBL enters - this code in monitor mode. skern\_init() does the following: -- Initialize the arch timer CNTFREQ -- Set the secondary core entry point address in the ARM magic address - for each core -- Configure GIC controller to route IPC interrupts - -Finally the control returns to RBL and back to non secure primary core -boot monitor entry code. - -- On the primary core, booting of Linux kernel happens as usual through - the bootm command. -- At Linux start up, primary core make smc call to power on each of the - secondary core. smc call is issued with r0 pointing to the command (0 - - power ON). r1 points to the CPU number and r2 to secondary core - kernel entry point address. Primary core wait for secondary cores to - boot up and then proceeds to rest of booting sequence. - -| - -.. rubric:: Boot sequence of secondary core - :name: boot-sequence-of-secondary-core - -At the secondary core, following squence happens - -- On power ON reset, RBL initializes. It then enters the secondary - entry point address (\_skern\_123\_init()) of the boot monitor core - which was written to the fast boot address in RBL by the primary - core. The init code sets its own stack, and vectors. It then calls - skern\_123\_init() C function to initialize per CPU variables. It - initializes the arch timer CNTFREQ to desired value. -- On return from skern\_123\_init(), it returns the secondary core - kernel entry point address, and back to \_skern\_123\_init() which - goes to non-secure SVR mode and jumps to the secondary kernel entry - point address, and it starts booting secondary instance of Linux - kernel. - -| - diff --git a/source/linux/Foundational_Components/_Boot_Monitor.rst b/source/linux/Foundational_Components/_Boot_Monitor.rst deleted file mode 100644 index 9497e950d..000000000 --- a/source/linux/Foundational_Components/_Boot_Monitor.rst +++ /dev/null @@ -1,9 +0,0 @@ -.. http://processors.wiki.ti.com/index.php/Processor_SDK_Linux_Boot_Monitor - -*************************** -Boot Monitor -*************************** - -.. include:: Foundational_Components/Boot_Monitor/_Boot_Monitor_Users_Guide.rst - -.. include:: Foundational_Components/Boot_Monitor/_Boot_Monitor_Release_Notes.rst diff --git a/source/linux/Foundational_Components_Boot_Monitor.rst b/source/linux/Foundational_Components_Boot_Monitor.rst deleted file mode 100644 index 37fd9cdea..000000000 --- a/source/linux/Foundational_Components_Boot_Monitor.rst +++ /dev/null @@ -1,3 +0,0 @@ -.. _foundational-components-boot-monitor: - -.. include:: Foundational_Components/_Boot_Monitor.rst