1.4.5. Boot Monitor NOR flash commands

The Boot Monitor includes a set of NOR flash commands, FLASH.

Enter FLASH while the main command set is active to enable the NOR flash commands.

Table 1.7 shows the commands for the NOR Flash subsystem.

Table 1.7. Boot Monitor NOR flash command set

CommandAction
CREATE BOOTSCRIPT [NAME name] [FLASH_ADDRESS address]Create a boot script that is stored in flash. The image is identified in flash by the default name BOOTSCRIPT. This can be overridden by using the optional NAME argument. You can specify where in flash the boot script is written using the optional FLASH_ADDRESS argument.
DISPLAY BOOTSCRIPT [name]Display boot script that is stored in flash. If the optional name is not specified, then the default name BOOTSCRIPT is used.
DISPLAY IMAGE nameDisplay information of image name.
ERASE IMAGE nameErase an image or binary file from flash.
ERASE RANGE start [end]

Erase an area of NOR flash from the start address to the end address.

Note

It is only possible to erase entire blocks of flash. Therefore, the entire block of flash that contains start, the block that contains end, and all intervening blocks are erased. This might mean that data before start or after end is erased if they are not on block boundaries. If you do not specify the optional end parameter, only the single block of flash that contains start is erased.

EXITExit the NOR flash commands and return to executing standard Boot Monitor commands that Default command set describes.
HELP [command]

List the flash commands.

Entering HELP followed by a command displays help for that command.

LINUX BOOT image name [LOAD_ADDRESS address] [ENTRY_POINT address] [kernel command line]

LINUX BOOT image name [LOAD_ADDRESS address] [ENTRY_POINT address] [FILE file name]

Load Linux image image name from flash and run it. If the LOAD_ADDRESS or ENTRY_POINT are specified, these replace the programmed load address or entry point. You can specify a text file file name containing the kernel command line.

LINUX FDT image name [LOAD_ADDRESS address]

Load FDT image image name from flash. If the LOAD_ADDRESS is specified, it replaces the programmed load.

LINUX INITRD image name [LOAD_ADDRESS address]

Load initrd image image name from flash. If the LOAD_ADDRESS is specified, it replaces the programmed load.
LIST AREASList areas in flash. An area is one or more contiguous blocks that have the same size and use the same programming algorithm.
LIST IMAGESList images in flash.
LOAD nameLoad the image image_name into memory.
QUITAlias for EXIT. Exit the NOR flash commands and return to standard Boot Monitor commands that Default command set describes.
REBOOTPower down and then restart the system.
RESERVE SPACE address sizeReserve space in NOR flash. The Boot Monitor does not use this space. address is the start of the area and size is the size of the reserved area.
RESETPerform a reset of the daughterboards.
RUN nameLoad the image name from flash and run it.
SHUTDOWNPower down the whole system except for the MCC which enters standby state.
UNRESERVE SPACE addressFree the space starting at address in NOR flash. The Boot Monitor can use tis space.
WRITE BINARY file [NAME new_name] [FLASH_ADDRESS address] [LOAD_ADDRESS address] [ENTRY_POINT address]

Write a binary file to flash. By default, the image is identified by its file name. Use NAME new_name to specify a name instead of using the default name.

Use FLASH_ADDRESS address to specify where in flash the image is to be located. The optional LOAD_ADDRESS and ENTRY_POINT arguments enable you to specify the load address and the entry point.

If an entry point is not specified, the load address is used as the entry point.

Note

Remote file access requires semihosting. Use a debugger connection to provide semihosting.

WRITE IMAGE file [NAME new_name] [FLASH_ADDRESS address]

Write an ELF image file to flash. By default, the image is identified by its file name. For example, t:\images\boot_monitor.axf is identified as boot_monitor. Use NAME new_name to specify a name instead of using the default name.

Use FLASH_ADDRESS address to specify where in flash the image is to be located. If the image is linked to run from flash, the link address is used and address is ignored.

Note

Remote file access requires semihosting. Use a debugger connection to provide semihosting.


Copyright © 2009-2012 ARM. All rights reserved.ARM DUI 0465F
Non-ConfidentialID110612