Introduction

Bootloader Driver API/interface file.

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...

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...

Typedefs
typedef void *	Bootloader_Handle
	Handle to the Bootloader driver returned by Bootloader_open() 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...

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...

Introduction

Data Structures

Macros

Typedefs

Functions