See BOOTLOADER for more details.
Data Structures | |
struct | Bootloader_Params |
Parameters passed during Bootloader_open() More... | |
struct | Bootloader_Fxns |
Driver implementation callbacks. More... | |
struct | Bootloader_Config |
Bootloader driver configuration, these are filled by SysCfg based on the boot media selected. More... | |
struct | Bootloader_CpuInfo |
Data structure containing information related to a particular CPU, required for RPRC loading. More... | |
struct | Bootloader_BootImageInfo |
Data structure containing information related all CPUs, this will be filled by Bootloader_parseMultiCoreAppImage. More... | |
Functions | |
void | Bootloader_Params_init (Bootloader_Params *params) |
Initialize Bootloader params. More... | |
void | Bootloader_BootImageInfo_init (Bootloader_BootImageInfo *bootImageInfo) |
Initialize BootImage info. More... | |
void | Bootloader_CpuInfo_init (Bootloader_CpuInfo *cpuInfo) |
Initialize CPU info. More... | |
Bootloader_Handle | Bootloader_open (uint32_t instanceNum, Bootloader_Params *openParams) |
Open bootloader driver. More... | |
void | Bootloader_close (Bootloader_Handle handle) |
Close bootloader driver. More... | |
int32_t | Bootloader_initCpu (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
API to initialize a non-self CPU. More... | |
int32_t | Bootloader_loadCpu (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
API to load a non-self CPU. More... | |
int32_t | Bootloader_loadSelfCpu (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo, uint32_t skipLoad) |
API to load self CPU. More... | |
int32_t | Bootloader_runCpu (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
API to run a non-self CPU. More... | |
int32_t | Bootloader_runSelfCpu (Bootloader_Handle handle, Bootloader_BootImageInfo *bootImageInfo) |
API to boot self CPU. More... | |
int32_t | Bootloader_bootCpu (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
API to boot a non-self CPU. More... | |
int32_t | Bootloader_bootSelfCpu (Bootloader_Handle handle, Bootloader_BootImageInfo *bootImageInfo) |
API to boot self CPU. More... | |
int32_t | Bootloader_parseMultiCoreAppImage (Bootloader_Handle handle, Bootloader_BootImageInfo *bootImageInfo) |
Parse Multicore Appimage. More... | |
int32_t | Bootloader_cpuSetAppEntryPoint (Bootloader_BootImageInfo *bootImageInfo, uint32_t bDualSelfR5F) |
Set Application entry point for self CPU in the AM65x SOC from reset. More... | |
int32_t | Bootloader_rprcImageParseEntryPoint (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
Parse entrypoint from RPRC. More... | |
int32_t | Bootloader_rprcImageLoad (Bootloader_Handle handle, Bootloader_CpuInfo *cpuInfo) |
Load application binaries into SOC memory. More... | |
int32_t | Bootloader_parseAndLoadLinuxAppImage (Bootloader_Handle handle, Bootloader_BootImageInfo *bootImageInfo) |
Parse and load linux Appimage, containing linux binaries(ATF, OPTEE, SPL) More... | |
int32_t | Bootloader_runSelfCpuWithLinux (void) |
API to boot self CPU with Linux. More... | |
uint32_t | Bootloader_getMulticoreImageSize (Bootloader_Handle handle) |
API to fetch the size of the multicore image. More... | |
uint32_t | Bootloader_isCorePresent (Bootloader_Handle handle, uint32_t cslCoreId) |
API to check if a particular core's RPRC image is present in the multicore image. More... | |
uint32_t | Bootloader_getBootMedia (Bootloader_Handle handle) |
API to get the selected boot media in the bootloader instance. More... | |
int32_t | Bootloader_parseAndLoadMultiCoreELF (Bootloader_Handle handle, Bootloader_BootImageInfo *bootImageInfo) |
API to parse and load MCELF image. More... | |
uint32_t | Bootloader_getX509CertLen (uint8_t *x509_cert_ptr) |
API to get the length of an x509 certificate. More... | |
uint32_t | Bootloader_getMsgLen (uint8_t *x509_cert_ptr, uint32_t x509_cert_size) |
API to get image length from a x509 certificate. More... | |
Typedefs | |
typedef void * | Bootloader_Handle |
Handle to the Bootloader driver returned by Bootloader_open() More... | |
Macros | |
#define | BOOTLOADER_INVALID_ID (0xDEADBABE) |
Invalid ID magic number to be used for initializations. More... | |
#define | BOOTLOADER_OPMODE_LOCKSTEP (0U) |
Operating mode type. More... | |
#define | BOOTLOADER_OPMODE_STANDALONE (1U) |
#define | BOOTLOADER_MEDIA_MEM (0xB0070001) |
Boot media IDs. More... | |
#define | BOOTLOADER_MEDIA_FLASH (0xB0070002) |
#define | BOOTLOADER_MEDIA_EMMC (0xB0070003) |
#define | BOOTLOADER_MEDIA_SD (0xB0070004) |
#define | BOOTLOADER_MEDIA_BUFIO (0xB0070005) |
#define | BOOTLOADER_MEDIA_PCIE (0xB0070006) |
#define | BOOTLOADER_MEDIA_USB (0xB0070007) |
#define | BOOTLOADER_SCRATCH_MEM_ENABLE (1U) |
Bootloader buffer enable. More... | |
Bootloader driver implementation callbacks | |
typedef int32_t(* | Bootloader_imgOpenFxn) (void *args, Bootloader_Params *params) |
Driver implementation to open a specific bootloader driver - Memory, OSPI, UART, MMCSD etc. More... | |
typedef int32_t(* | Bootloader_imgReadFxn) (void *dstAddr, uint32_t length, void *args) |
Driver implementation to read from boot media using a specific bootloader driver - Memory, OSPI, UART, MMCSD etc. More... | |
typedef uint32_t(* | Bootloader_imgOffsetFxn) (void *args) |
Driver implementation to get the current offset in the boot media. More... | |
typedef void(* | Bootloader_imgSeekFxn) (uint32_t location, void *args) |
Driver implementation to read from boot media using a specific bootloader driver - Memory, OSPI, UART, MMCSD etc. More... | |
typedef void(* | Bootloader_imgCloseFxn) (void *handle, void *args) |
Driver implementation to close a specific bootloader driver - Memory, OSPI, UART, MMCSD etc. More... | |
typedef int32_t(* | Bootloader_imgCustomFxn) (void *args) |
Driver implementation to enable a custom function for a specific bootloader driver - Memory, OSPI, UART, MMCSD etc. More... | |
#define BOOTLOADER_INVALID_ID (0xDEADBABE) |
Invalid ID magic number to be used for initializations.
#define BOOTLOADER_OPMODE_LOCKSTEP (0U) |
Operating mode type.
#define BOOTLOADER_OPMODE_STANDALONE (1U) |
#define BOOTLOADER_MEDIA_MEM (0xB0070001) |
Boot media IDs.
#define BOOTLOADER_MEDIA_FLASH (0xB0070002) |
#define BOOTLOADER_MEDIA_EMMC (0xB0070003) |
#define BOOTLOADER_MEDIA_SD (0xB0070004) |
#define BOOTLOADER_MEDIA_BUFIO (0xB0070005) |
#define BOOTLOADER_MEDIA_PCIE (0xB0070006) |
#define BOOTLOADER_MEDIA_USB (0xB0070007) |
#define BOOTLOADER_SCRATCH_MEM_ENABLE (1U) |
Bootloader buffer enable.
typedef void* Bootloader_Handle |
Handle to the Bootloader driver returned by Bootloader_open()
typedef int32_t(* Bootloader_imgOpenFxn) (void *args, Bootloader_Params *params) |
Driver implementation to open a specific bootloader driver - Memory, OSPI, UART, MMCSD etc.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
args | [in] Boot media specific arguments, obtained from the config |
params | [in] User controllable params |
typedef int32_t(* Bootloader_imgReadFxn) (void *dstAddr, uint32_t length, void *args) |
Driver implementation to read from boot media using a specific bootloader driver - Memory, OSPI, UART, MMCSD etc.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
dstAddr | [in] Destination address to which the data is to be read into |
length | [in] Length in bytes of the data to be read |
args | [in] Boot media specific arguments, obtained from the config |
typedef uint32_t(* Bootloader_imgOffsetFxn) (void *args) |
Driver implementation to get the current offset in the boot media.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
args | [in] Boot media specific arguments, obtained from the config |
typedef void(* Bootloader_imgSeekFxn) (uint32_t location, void *args) |
Driver implementation to read from boot media using a specific bootloader driver - Memory, OSPI, UART, MMCSD etc.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
dstAddr | [in] Destination address to which the data is to be read into |
length | [in] Length in bytes of the data to be read |
args | [in] Boot media specific arguments, obtained from the config |
typedef void(* Bootloader_imgCloseFxn) (void *handle, void *args) |
Driver implementation to close a specific bootloader driver - Memory, OSPI, UART, MMCSD etc.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
handle | [in] Handle returned from Bootloader_imgOpen |
args | [in] Boot media specific arguments, obtained from the config |
typedef int32_t(* Bootloader_imgCustomFxn) (void *args) |
Driver implementation to enable a custom function for a specific bootloader driver - Memory, OSPI, UART, MMCSD etc.
Typically this callback is hidden from the end application and is implemented when a new boot media needs to be supported.
args | [in] Boot media specific arguments, obtained from the config |
void Bootloader_Params_init | ( | Bootloader_Params * | params | ) |
Initialize Bootloader params.
params | [out] Pointer to a Bootloader_Params structure |
void Bootloader_BootImageInfo_init | ( | Bootloader_BootImageInfo * | bootImageInfo | ) |
Initialize BootImage info.
bootImageInfo | [out] Pointer to a Bootloader_BootImageInfo structure |
void Bootloader_CpuInfo_init | ( | Bootloader_CpuInfo * | cpuInfo | ) |
Initialize CPU info.
cpuInfo | [out] Pointer to a Bootloader_CpuInfo structure |
Bootloader_Handle Bootloader_open | ( | uint32_t | instanceNum, |
Bootloader_Params * | openParams | ||
) |
Open bootloader driver.
Make sure the SOC periheral driver is open'ed before calling this API. Drivers_open function generated by SysCfg opens the underlying SOC peripheral driver, e.g OSPI.
Global variables Bootloader_Config gBootloaderConfig[]
and uint32_t gBootloaderConfigNum
is instantiated by SysCfg to describe the boot media and other configuration based on user selection in SysCfg.
instanceNum | [in] Index within Bootloader_Config gBootloaderConfig[] denoting the bootloader driver to open |
openParams | [in] Open parameters |
void Bootloader_close | ( | Bootloader_Handle | handle | ) |
Close bootloader driver.
handle | [in] Bootloader driver handle from Bootloader_open |
int32_t Bootloader_initCpu | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
API to initialize a non-self CPU.
This API will initialize a non-self CPU, i.e a CPU on which the bootloader application is not running. This API is not applicable for cores from self cluster. They will be loaded by the Bootloader_loadSelfCpu API.
NOTE: No checks are done to confirm non-self CPU ID is passed, user need to make sure non-self CPU ID is passed, else the load could fail.
handle | [in] Bootloader driver handle from Bootloader_open |
cpuInfo | [in] Data structure containing information regarding the CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_loadCpu | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
API to load a non-self CPU.
This API will load RPRC images on a non-self CPU, i.e a CPU on which the bootloader application is not running. This API is not applicable for cores from self cluster. They will be loaded by the Bootloader_loadSelfCpu API.
NOTE: No checks are done to confirm non-self CPU ID is passed, user need to make sure non-self CPU ID is passed, else the load could fail.
handle | [in] Bootloader driver handle from Bootloader_open |
cpuInfo | [in] Data structure containing information regarding the CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_loadSelfCpu | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo, | ||
uint32_t | skipLoad | ||
) |
API to load self CPU.
This API will load RPRC images on self CPU, i.e a CPU on which the bootloader application is running
NOTE: No checks are done to confirm self CPU ID is passed, user need to make sure self CPU ID is passed, else the load could fail.
handle | [in] Bootloader driver handle from Bootloader_open |
cpuInfo | [in] Data structure containing information regarding the CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
skipLoad | [in] Skip the image load, only do the initialization |
int32_t Bootloader_runCpu | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
API to run a non-self CPU.
This API will run a non-self CPU, i.e a CPU on which the bootloader application is not running. This API is not applicable for cores from self cluster. They will be run by the Bootloader_runSelfCpu API. It is expected that this API be called after Bootloader_loadCpu API
handle | [in] Bootloader driver handle from Bootloader_open |
cpuInfo | [in] Data structure containing information regarding the CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_runSelfCpu | ( | Bootloader_Handle | handle, |
Bootloader_BootImageInfo * | bootImageInfo | ||
) |
API to boot self CPU.
This API will boot self CPU, i.e a CPU on which the bootloader application is running. It is expected that this API be called after Bootloader_loadSelfCpu API
handle | [in] Bootloader driver handle from Bootloader_open |
bootImageInfo | [in] Data structure of type Bootloader_BootImageInfo containing information regarding self CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_bootCpu | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
API to boot a non-self CPU.
This API will boot a non-self CPU, i.e a CPU on which the bootloader application is not running. Now if the self CPU is a dual core CPU, like a Cortex R5, this API is not applicable for the second core of the self CPU. That will be booted by the Bootloader_bootSelfCpu API.
handle | [in] Bootloader driver handle from Bootloader_open |
cpuInfo | [in] Data structure containing information regarding the CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_bootSelfCpu | ( | Bootloader_Handle | handle, |
Bootloader_BootImageInfo * | bootImageInfo | ||
) |
API to boot self CPU.
This API will boot self CPU, i.e a CPU on which the bootloader application is running
handle | [in] Bootloader driver handle from Bootloader_open |
bootImageInfo | [in] Data structure of type Bootloader_BootImageInfo containing information regarding self CPU. This should have been filled by the Bootloader_parseMultiCoreAppImage API |
int32_t Bootloader_parseMultiCoreAppImage | ( | Bootloader_Handle | handle, |
Bootloader_BootImageInfo * | bootImageInfo | ||
) |
Parse Multicore Appimage.
When the booting is done through some boot media, unlike loading via CCS, the application binaries for each core applicable are converted into a file format '.rprc' and combined together into a multicore appimage binary. The bootloader needs to read this appimage, and load the binaries correctly into memories. This API helps in parsing the multicore appimage and filling the metadata in the bootImageInfo structure passed.
handle | [in] Bootloader driver handle from Bootloader_open |
bootImageInfo | [in] Data structure of type Bootloader_BootImageInfo which will be filled |
int32_t Bootloader_cpuSetAppEntryPoint | ( | Bootloader_BootImageInfo * | bootImageInfo, |
uint32_t | bDualSelfR5F | ||
) |
Set Application entry point for self CPU in the AM65x SOC from reset.
bootImageInfo | [out] Pointer to a Bootloader_BootImageInfo structure |
bDualSelfR5F | TRUE (1U) if dual cores enabled, FALSE (0U) if not. |
int32_t Bootloader_rprcImageParseEntryPoint | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
Parse entrypoint from RPRC.
This API reads the RPRC image to parse the entry points of a particular CPU
int32_t Bootloader_rprcImageLoad | ( | Bootloader_Handle | handle, |
Bootloader_CpuInfo * | cpuInfo | ||
) |
Load application binaries into SOC memory.
This API loads the application binaries for each core applicable is loaded from the boot media to the SOC memory
int32_t Bootloader_parseAndLoadLinuxAppImage | ( | Bootloader_Handle | handle, |
Bootloader_BootImageInfo * | bootImageInfo | ||
) |
Parse and load linux Appimage, containing linux binaries(ATF, OPTEE, SPL)
handle | [in] Bootloader driver handle from Bootloader_open |
bootImageInfo | [in] Data structure of type Bootloader_BootImageInfo which will be filled |
int32_t Bootloader_runSelfCpuWithLinux | ( | void | ) |
API to boot self CPU with Linux.
This API will boot self CPU, i.e a CPU on which the bootloader application is running. It is expected that this API be called after Bootloader_loadSelfCpu API. This API does not perform a security handoff
uint32_t Bootloader_getMulticoreImageSize | ( | Bootloader_Handle | handle | ) |
API to fetch the size of the multicore image.
This API simply returns the internal global variable which gets updated everytime a section is loaded. So this API should only be called after all the rprc loading is complete.
handle | Bootloader driver handle from Bootloader_open |
uint32_t Bootloader_isCorePresent | ( | Bootloader_Handle | handle, |
uint32_t | cslCoreId | ||
) |
API to check if a particular core's RPRC image is present in the multicore image.
This API checks the csl core id against an internally maintained bitmap which will be populated after parsing the image. So this API should be called only after the multicore image is parsed.
handle | Bootloader driver handle from Bootloader_open |
cslCoreId | CSL core ID of the interested core |
uint32_t Bootloader_getBootMedia | ( | Bootloader_Handle | handle | ) |
API to get the selected boot media in the bootloader instance.
This API returns the selected boot media. This data will be filled by sysconfig
handle | [in] Bootloader driver handle from Bootloader_open |
int32_t Bootloader_parseAndLoadMultiCoreELF | ( | Bootloader_Handle | handle, |
Bootloader_BootImageInfo * | bootImageInfo | ||
) |
API to parse and load MCELF image.
This API parses the MCELF file and loads the loadable segments into xthe respective cores.
handle | Bootloader driver handle from Bootloader_open |
bootImageInfo | [in] Data structure of type Bootloader_BootImageInfo which will be filled |
uint32_t Bootloader_getX509CertLen | ( | uint8_t * | x509_cert_ptr | ) |
API to get the length of an x509 certificate.
This API calculates the length of an x509 certificate from the 4 byte x509 header present at the top.
x509_cert_ptr | Pointer to the 4 byte x509 header present at the start of the certificate. |
uint32_t Bootloader_getMsgLen | ( | uint8_t * | x509_cert_ptr, |
uint32_t | x509_cert_size | ||
) |
API to get image length from a x509 certificate.
This API calculates the length of an image from the x509 certificate.
x509_cert_ptr | Pointer to the x509 certificate. |
x509_cert_size | Length of the x509 certificate. |