Introduction

This is a bootloader example, which shows an example of booting Linux on A53 core and RTOS/NORTOS applications on DM R5 and M4 cores.

The booting is done in 2 stages(2 bootloader applications).

The stage1 of the bootloader runs from the HSM RAM. It boots MCU M4 with RTOS/NORTOS application and initializes the DDR. Then it loads the stage2 of the bootloader to DDR and stats running it.
The stage2 of the bootloader boots Linux on A53 and then self loads DM firmware on the DM R5.

The SBL uses 6 appimages

A Linux appimage containing the Linux binaries (ATF, OPTEE, A53 SPL).
tiboot3.bin with SBL stage1, TIFS, BoardConfig
Appimage for SBL stage2
Appimage for MCU M4
Appimage for HSM M4
DM firmware appimage for DM R5

Refer SBL Booting Linux From OSPI for more details on the OSPI boot loader.

Supported Combinations

Parameter	Value
CPU + OS	r5fss0-0 nortos
Toolchain	ti-arm-clang
Board	am62x-sk-lp
Example folder	examples/drivers/boot/sbl_ospi_nand_linux_multistage

Steps to Run the Example

Build the example

When using CCS projects to build, import the CCS project for the required combination and build it using the CCS project menu (see Using SDK with CCS Projects).
When using makefiles to build, note the required combination and build using make command (see Using SDK with Makefiles)
Note
Change DEVICE_TYPE to HS in ${SDK_INSTALL_PATH}/devconfig/devconfig.mak and then generate Linux Appimage for HS-SE device.
For booting A53 with linux, OSPI NAND needs to be flashed with the uboot and Linux image. Refer to Processor SDK Linux user guide on how to flash uboot and Linux kernel to OSPI NAND.

Flash the OSPI NAND with u-boot and Linux kernel

Note: This needs to be the first step as later the tiboot3.bin at the starting of the bootpartition will be overwritten by sbl_ospi_nand_linux_stage1.release.tiimage .

For booting A53 with linux, OSPI NAND needs to be flashed with the Linux image. Refer to Processor SDK Linux user guide on how to flash OSPI NAND with u-boot and boot Linux kernel.

Create Linux Appimage

Note: Change DEVICE_TYPE to HS in ${SDK_INSTALL_PATH}/devconfig/devconfig.mak and then generate Linux Appimage for HS-SE device.; Change PSDK_LINUX_PATH to the path where A53 spl images (ATF, OPTEE, A53 uboot) is.; Instructions to build A53 uboot can be found in the SDK Linux documentation at Foundational Components » U-Boot » User’s Guide » General Information » Build U-Boot

Create a Linux Appimage containing the Linux binaries (ATF, OPTEE, A53 SPL)
This can be done by running the makefile at {SDK_INSTALL_PATH}/tools/boot/linuxAppimageGen after setting the PSDK path in file config.mak
Refer Linux Appimage Generator Tool for more details

Create HSM Appimage

Note: Change DEVICE_TYPE to HS in ${SDK_INSTALL_PATH}/devconfig/devconfig.mak and then generate HSM Appimage for HS-SE device.

Create a HSM Appimage
This can be done by running the makefile at {SDK_INSTALL_PATH}/tools/boot/HSMAppimageGen
Refer HSM Appimage Generator Tool for more details

Run the example

This example is the SBL which needs to be flashed on the EVM flash, along with sample application images for R5, M4 CPUs and Linux Appimage.

Note: For HS-SE device, use default_sbl_ospi_nand_linux_hs.cfg as the cfg file.; For HS-FS device, use default_sbl_ospi_nand_linux_hs_fs.cfg as the cfg file.

There is a default flash config file as shown below which flashes this SBL and the IPC RPMsg Linux echo applications
```
  ${SDK_INSTALL_PATH}/tools/boot/sbl_prebuilt/am62x-sk-lp/default_sbl_ospi_nand_linux.cfg
```
Make sure IPC rpmsg linux echo application is built before running the flash script. (see IPC RP Message Linux Echo)

Note: For IPC rpmsg linux echo, the resource table entity must be placed at the beginning of remoteproc memory section as mentoined in Linux dts file.

To flash to the EVM, refer to Flash an example application . Only when giving the flash config file, point to the default_sbl_ospi_nand_linux.cfg shown above.
Example, assuming SDK is installed at C:/ti/mcu_plus_sdk and this example and IPC application is built using makefiles, and Linux Appimage is already created, in Windows,
```
  cd C:/ti/mcu_plus_sdk/tools/boot
  python uart_uniflash.py -p COM13 --cfg=C:/ti/mcu_plus_sdk/tools/boot/sbl_prebuilt/am62x-sk-lp/default_sbl_ospi_nand_linux.cfg
```

If Linux PC is used, assuming SDK is installed at ~/ti/mcu_plus_sdk

  cd ~/ti/mcu_plus_sdk/tools/boot
  python uart_uniflash.py -p /dev/ttyUSB0 --cfg=~/ti/mcu_plus_sdk/tools/boot/sbl_prebuilt/am62x-sk-lp/default_sbl_ospi_nand_linux.cfg

Boot the EVM in OSPI NAND boot mode.

Sample Output

After flashing and booting the EVM, you will see below output on the UART console (Complete log is not shown)

DMSC Firmware Version 9.0.5--v09.00.05 (Kool Koala)
DMSC Firmware revision 0x9
DMSC ABI revision 3.1

[BOOTLOADER_PROFILE] Boot Media       : FLASH
[BOOTLOADER_PROFILE] Boot Media Clock : 200.000 MHz
[BOOTLOADER_PROFILE] Boot Image Size  : 182 KB
[BOOTLOADER_PROFILE] Cores present    :
m4f0-0
r5f0-0
[BOOTLOADER PROFILE] System_init                      :      37270us
[BOOTLOADER PROFILE] Drivers_open                     :        207us
[BOOTLOADER PROFILE] Board_driversOpen                :         88us
[BOOTLOADER PROFILE] Sciclient Get Version            :       9925us
[BOOTLOADER PROFILE] App_waitForMcuPbist              :          5us
[BOOTLOADER PROFILE] App_waitForMcuLbist              :       7689us
[BOOTLOADER PROFILE] App_loadImages                   :       5520us
[BOOTLOADER PROFILE] App_loadSelfcoreImage            :      10788us
[BOOTLOADER_PROFILE] SBL Total Time Taken             :      71496us

Image loading done, switching to application ...
Starting MCU-m4f and 2nd stage bootloader

DMSC Firmware Version 9.0.5--v09.00.05 (Kool Koala)
DMSC Firmware revision 0x9
DMSC ABI revision 3.1

[BOOTLOADER_PROFILE] Boot Media       : FLASH
[BOOTLOADER_PROFILE] Boot Media Clock : 200.000 MHz
[BOOTLOADER_PROFILE] Boot Image Size  : 895 KB
[BOOTLOADER_PROFILE] Cores present    :
hsm-m4f0-0
r5f0-0
a530-0
[BOOTLOADER PROFILE] System_init                      :       2845us
[BOOTLOADER PROFILE] Drivers_open                     :        269us
[BOOTLOADER PROFILE] Board_driversOpen                :         89us
[BOOTLOADER PROFILE] Sciclient Get Version            :       9976us
[BOOTLOADER PROFILE] App_loadImages                   :       2427us
[BOOTLOADER PROFILE] App_loadSelfcoreImage            :      11338us
[BOOTLOADER PROFILE] App_loadLinuxImages              :      52860us
[BOOTLOADER_PROFILE] SBL Total Time Taken             :      79806us

Image loading done, switching to application ...
Starting linux and RTOS/Baremetal applications
NOTICE:  BL31: v2.8(release):v2.8-226-g2fcd408bb3-dirty
NOTICE:  BL31: Built : 00:42:57, Jan 13 2023

U-Boot SPL 2023.04-ga3595f1e3e (Jun 15 2023 - 08:14:46 +0000)
SYSFW ABI: 3.1 (firmware rev 0x0009 '9.0.5--v09.00.05 (Kool Koala)')
Trying to boot from SPINAND


U-Boot 2023.04-ga3595f1e3e (Jun 15 2023 - 08:14:46 +0000)

SoC:   AM62X SR1.0 HS-FS
Model: Texas Instruments AM62x LP SK
EEPROM not available at 80, trying to read at 81
Board: AM62-LP-SKEVM rev E1
DRAM:  2 GiB



.
.
.
.
.
.


_____                    _____           _         _
|  _  |___ ___ ___ ___   |  _  |___ ___  |_|___ ___| |_
|     |  _| .'| . | . |  |   __|  _| . | | | -_|  _|  _|
|__|__|_| |__,|_  |___|  |__|  |_| |___|_| |___|___|_|
            |___|                    |___|

Arago Project am62xx-lp-evm -

Arago 2023.04 am62xx-lp-evm -

am62xx-lp-evm login:

Table of Contents