RealView Platform Baseboard Explore for Cortex-A9 User Guide: E.2. Boot Monitor command set

E.2. Boot Monitor command set

Table E.1. Standard Boot Monitor command set

Command	Action
`@ script_file`	Runs a script file.
`ALIAS alias commands`	Create an alias command `alias` for the string of commands contained in `commands`.
`CLEAR BOOTSCRIPT`	Clear the current boot script. The Boot Monitor prompts for input on reset even if the S6-1 is set to ON to indicate that a boot script must be run.
`CONFIGURE`	Enter Configure subsystem. Commands that Table E.2 lists can now be executed.
`CONVERT BINARY binary_file LOAD_ADDRESS address [ENTRY_POINT address]`	Provides information to the system that is required by the RUN command to execute a binary file. A new file with name `binary_file` is produced, but with an `.exe` file extension.
`COPY file1 file2`	Copy `file1` to `file2`. For example, to copy the `leds` code from the PC to the MMC or SD card enter: `COPY C:\software\projects\examples\rvds2.0\leds.axf leds.axf` Note Remote file access requires semihosting. Use a debugger connection to provide semihosting.
`CREATE filename`	Create a new file by inputting text. Press Ctrl-Z to end the file.
`DEBUG`	Enter the debug subsystem. Commands that Table E.3 lists can now be executed.
`DELETE filename`	Delete `file` from MMC or SD card or CompactFlash card
`DIRECTORY [directory`]	List the files in a MMC or SD card or CompactFlash card directory. Files only accessible from semihosting cannot be listed.
`DISABLE CACHES`	Disable both the I and D caches.
`DISPLAY BOOTSCRIPT`	Display the current boot script.
`ECHO text`	Echo `text` to the current output device.
`ENABLE CACHES`	Enable both the I and D caches.
`EXIT`	Exit the Boot Monitor. The processor is held in a tight loop until it is interrupted by a JTAG debugger.
`FLASH`	Enter the flash file system for the NOR flash on the baseboard. See Table E.4 for flash commands.
`HELP [command]`	List the Boot Monitor commands. Entering `HELP` followed by a command displays help for that command.
`LOAD name`	Load the image `name` into memory and run it.
`QUIT`	Alias for `EXIT`. Exit the Boot Monitor.
`RENAME old_name new_name`	Rename file named `old_name` to `new_name`.
`RUN image_name`	Load the image `image_name` into memory and run it.
`SET BOOTSCRIPT script_file`	Specify `script_file` as the boot script. If the run boot script switch S4-1 is ON, `script_file` is run at system reset.
`TYPE filename`	Display the file `filename`.

Table E.2 lists the commands for the Configure sub-menu.

Table E.2. Boot Monitor Configure commands

Command	Action
`DISPLAY CLOCKS`	Display system clocks.
`DISPLAY DATE`	Display date.
`DISPLAY HARDWARE`	Display hardware information (for example, the FPGA revisions).
`DISPLAY TIME`	Display time.
`EXIT`	Exit the configure commands and return to executing standard Boot Monitor commands.
`HELP [command]`	List the configure commands. Entering `HELP` followed by a command displays help for that command.
`QUIT`	Alias for `EXIT`. Exit the Configure commands and return to standard Boot Monitor commands.
`SET CLOCK n FREQUENCY frequency`	Set the `frequency` in MHz of the requested `CLOCK n`. Note The Boot Monitor does not set any of the clocks on startup. The clock values are determined by the default values in the FPGA image.
`SET DATE dd/mm/yy`	Set date. The date can also be entered as `dd-mm-yy`.
`SET TIME hh:mm:ss`	Set time. The time can also be entered as `hh-mm-ss`.

Table E.3 lists the commands for the Debug sub-menu.

Table E.3. Boot Monitor Debug commands

Command	Action
`DEPOSIT address value [size]`	Load memory specified by `address` with `value`. The `size` parameter is optional. If used, it can be `BYTE`, `HALFWORD`, or `WORD`. The default is `WORD`.
`DISABLE MESSAGES`	Disable debug messages.
`ENABLE MESSAGES`	Enable debug messages.
`EXAMINE address`	Examine memory at `address`.
`EXIT`	Exit the debug commands and return to executing standard Boot Monitor commands.
`GO address`	Run the code starting at `address`.
`HELP [command]`	List the debug commands. Entering `HELP` followed by a command displays help for that command.
`QUIT`	Alias for `EXIT`. Exit the Debug commands and return to standard Boot Monitor commands.
`MODIFY address value mask [size]`	Performs read-modify-write at memory specified by `address`. The current value at the location is ORed with the result of ANDing `value` and `mask`. The `size` parameter is optional. If used, it can be `BYTE`, `HALFWORD`, or `WORD`. The default is `WORD`.
`START TIMER`	Start a timer.
`STOP TIMER`	Stop the timer started with the `START TIMER` command and display the elapsed time.

Table E.4 lists the commands for the NOR Flash subsystem.

Table E.4. Boot Monitor NOR flash commands

Command	Action
`DISPLAY IMAGE name`	Displays details of image `name`.
`ERASE IMAGE name`	Erase 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 the optional `end` parameter is not specified, only the single block of flash that contains `start` is erased. Caution This command can erase the Boot Monitor image. See Loading Boot Monitor into NOR flash.
`EXIT`	Exit the NOR flash commands and return to executing standard Boot Monitor commands.
`HELP [command]`	List the flash commands. Entering `HELP` followed by a command displays help for that command.
`LIST AREAS`	List areas in flash. An area is one or more contiguous blocks that have the same size and use the same programming algorithm.
`LIST IMAGES`	List images in flash.
`LOAD name`	Load the image `image_name` into memory.
`QUIT`	Alias for `EXIT`. Exit the NOR flash commands and return to standard Boot Monitor commands.
`RESERVE SPACE address size`	Reserve space in NOR flash. This space is not used by the Boot Monitor. `address` is the start of the area and `size` is the size of the reserved area.
`RUN name`	Load the image `name` from flash and run it.
`UNRESERVE SPACE address`	Free the space starting at `address` in NOR flash. This space can be used by the Boot Monitor.
`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-2011 ARM Limited. All rights reserved.	ARM DUI 0440B
Non-Confidential	ID060911
PDF version

E.2. Boot Monitor command set

Note

Note

Note

Caution

Note

Note