Analog Devices ADSP-SC58 Series Hardware Reference Manual page 3487

Bit Position
26
27
28
29
30
31
The blockCount argument specifies the number of blocks to be processed before terminating the boot process. The
default would normally be 0x00000000. A value of 0x00000000 instructs the boot software to continue processing
a boot stream until the ROM_BFLAG_FINAL flag is set. Should users wish to load only a specified number of
blocks they can instruct the boot kernel to do so via this parameter.
When the block count is used in combination with the ROM_BFLAG_NEXTDXE flag then the block count is re
purposed as a next application count. The boot kernel will navigate the first blocks of multiple boot streams similar
to a linked list and upon reaching the requested application count will return the pointer to this application in the
boot source. This allows users to use the boot kernel to find a specific application when multiple application boot
stream are stored contiguously in the boot source.
The pHook argument is a function pointer to a hook routine. When set along with the ROM_BFLAG_HOOK global
flag the boot mode will call the hook routine after calling the boot modes init and functions in the boot modes
driver allowing customization and altering of the configuration performed by the boot software.
This can be used to enabled new features not supported by the boot software and allows for installing of a user
defined load function or error handler as an example.
The command argument describes the boot peripheral to boot from, the peripheral instance and contains additional
boot mode specific configuration information and flags specific to the boot mode.
NOTE: When calling a boot mode via this API the user must first ensure that the boot peripheral is confirgured
accordingly in the SPU as a secure master. The boot software does not configure the peripheral security via
this API in order to allow device security to be fully controlled by a dedicated task.
adi_rom_BootKernel()
Calls the boot kernel allowing for implementation of custom boot modes.
API Details
void *
adi_rom_BootKernel
ADSP-SC58x/ADSP-2158x SHARC+ Processor Hardware Reference
Flag Name
ROM_BFLAG_SLAVE
ROM_BFLAG_WAKEUP
ROM_BFLAG_NEXTDXE
ROM_BFLAG_RETURN
Reserved
ROM_BFLAG_NORESTORE
(ADI_ROM_BOOT_CONFIG * pBoot)
Description
Boot mode is a slave boot mode. This results in different handling
of ignore blocks by the kernel
Set this to enable conditional processing of boot blocks intended for
wakeup events but not exclusively
Parse stream via Next DXE pointer
Return the application after calling the API instead of running the
new application
Reserved
Do not execute the boot peripherals cleanup routine to restore regis-
ter contents
API Reference
53–67