BOOTLOADER

Table of Contents

• Features Supported
• R5 Dual Core Support
• Example Usage
• API

The Bootloader module provides APIs to write bootloader applications for various boot media like OSPI, UART, SOC memory etc.

Features Supported

• QSPI Boot
• UART Boot
• API to parse multicore appimage
• Separate APIs to boot self and non-self cores

R5 Dual Core Support

• With the configuration used in MCU SDK to generate the app images, the RBL brings the R5 Lock Step Mode.
• The SBL runs on R5 core in Lock Step Mode.
• The SBL will switch to Dual core or continue in lock step mode depending on whether App Image loaded by SBL contains the R5 Core 1 image or not.
• If the App Image to be loaded contains the R5 core 1 binary
  • The SBL will configure R5 to switch to Dual Core Mode.
  • At the end of SBL flow, The Application image of R5 will start running in the dual core mode.
• If the App Image doesnot contain the R5 core 1 binary
  • The SBL will not configure R5 to switch to Dual core Mode
  • At the end of SBL flow, The Application image of R5 will start running in the lock step mode.
• Refer the IPC example which configures the R5 in Dual Core mode. IPC Notify Echo

Example Usage

Include the below file to access the APIs

#include <stdio.h>
#include <drivers/bootloader.h>

Instance Open Example

 
    gBootloaderHandle = Bootloader_open(0, NULL);
    DebugP_assert(gBootloaderHandle != NULL);

Booting Cores Example

    int32_t status = SystemP_SUCCESS;
 
    status = Bootloader_parseMultiCoreAppImage(gBootloaderHandle, &gBootImageInfo);
 
    if(SystemP_SUCCESS == status && gBootloaderHandle != NULL)
    {
        if(status == SystemP_SUCCESS)
        {
            gBootImageInfo.cpuInfo[CSL_CORE_ID_C66SS0].clkHz = Bootloader_socCpuGetClkDefault(CSL_CORE_ID_C66SS0);
            status = Bootloader_bootCpu(gBootloaderHandle, &gBootImageInfo.cpuInfo[CSL_CORE_ID_C66SS0]);
        }
        if(status == SystemP_SUCCESS)
        {
            gBootImageInfo.cpuInfo[CSL_CORE_ID_R5FSS0_1].clkHz = Bootloader_socCpuGetClkDefault(CSL_CORE_ID_R5FSS0_1);
            status = Bootloader_bootCpu(gBootloaderHandle, &gBootImageInfo.cpuInfo[CSL_CORE_ID_R5FSS0_1]);
        }
        if(status == SystemP_SUCCESS)
        {
            gBootImageInfo.cpuInfo[CSL_CORE_ID_R5FSS0_0].clkHz = Bootloader_socCpuGetClkDefault(CSL_CORE_ID_R5FSS0_0);
            gBootImageInfo.cpuInfo[CSL_CORE_ID_R5FSS0_1].clkHz = Bootloader_socCpuGetClkDefault(CSL_CORE_ID_R5FSS0_1);
            /* Reset self cluster, both Core0 and Core 1. Init RAMs and run the app  */
            status = Bootloader_bootSelfCpu(gBootloaderHandle, &gBootImageInfo);
        }
    }
 

Instance Close Example

    Bootloader_close(gBootloaderHandle);

API

APIs for BOOTLOADING CPUs