F.2. Boot Monitor command set

Table F.1. Standard Boot Monitor command set

CommandAction
@ script_fileRuns a script file.
ALIAS alias commandsCreate an alias command alias for the string of commands contained in commands.
CD directory path Change directory.
CLEAR BOOTSCRIPTClear the current boot script. The Boot Monitor will prompt for input on reset even if the run boot script switch is ON
CONFIGUREEnter Configure subsystem. Commands listed in Table F.3 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 in order 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 filenameCreate a new file by inputting text. Press Ctrl-Z to end the file.
DEBUGEnter the debug subsystem. Commands listed in Table F.4 can now be executed.
DELETE filenameDelete filename from MMC, SD or CompactFlash card
DIRECTORY [directory]List the files in a MMC, SD or CompactFlash card directory. Files only accessible from semihosting cannot be listed.
DISPLAY BOOTSCRIPTDisplay the current boot script.
ECHO textEcho text to the current output device.
EXITExit the Boot Monitor. The processor is held in a tight loop until it is interrupted by a JTAG debugger.
FLASHEnter the flash file system for the NOR flash on the baseboard. See Table F.5 for flash commands.
HELP [command]List the Boot Monitor commands. Entering HELP followed by a command displays help for that command.
LOAD nameLoad the image name into memory and run it.
M:Change drive (allocated to MMC or SD card).
K:Change drive (allocated to CompactFlash card).
MKDIR directory pathCreate a new directory.
QUITAlias for EXIT. Exit the Boot Monitor.
RENAME old_name new_nameRename file named old_name to new_name.
RMDIR directory pathRemove a directory.
RUN image_nameLoad the image image_name into memory and run it.
SDCARDEnter the SD, MMC and CompactFlash card subsystem.
SET BOOTSCRIPT script_file

Specify script_file as the boot script. If the run boot script switch is ON, script_file will be run at system reset.

TYPE filenameDisplay the file filename.

The Boot Monitor (version 4 onwards) includes a set of MMC or SD card and CompactFlash commands (SDCARD command). The commands are provided in a separate sub-menu.

Table F.2 lists the commands for the SDCARD sub-menu.

Table F.2. MMC, SD, and CompactFlash card sub-menu commands

CommandAction
EXITExit the SDCARD commands and return to executing standard Boot Monitor commands.
FORMAT [QUICK] [VOLUME label]Formats MMC or SD card for use (does not apply to CompactFlash card). QUICK − Performs a quick format by just overwriting the FAT. VOLUME label − Sets the disk label.
HELP [command]List the SDCARD sub-menu commands. Entering HELP followed by a command displays help for that command.
IDENTIFYDisplays CompactFlash card information.
INFORM drive [CSD|CID|SCR|SDS]Displays Card Information. drive − Specify drive letter (required for PB926EJ-S only) CSD − Returns information from CSD register CID − Returns information from CID register SCR − Returns information from SCR register SDS − Issues SD_STATUS command and returns results
INITIALISE [socket]If the card has been changed, call INITIALISE to intialize the card and the file system before using any commands (otherwise the behavior is unpredictable and the card can be corrupted). Option [socket] selects different socket: M − selects MCI 0 K − selects CompactFlash
QUITAlias for EXIT. Exit the SDCARD commands and return to executing standard Boot Monitor commands.

Table F.3 lists the commands for the Configure sub-menu.

Table F.3. Boot Monitor Configure commands

CommandAction
DISABLE DATA CACHEDisables the D cache.
DISABLE I CACHEDisables the I cache.
DISABLE MMUDisables the MMU.
DISPLAY CLOCKSDisplay system clocks.
DISPLAY DATEDisplay date.
DISPLAY HARDWAREDisplay hardware information (for example, the FPGA revisions).
DISPLAY TIMEDisplay time.
ENABLE DATA CACHEEnables the D cache.
ENABLE I CACHEEnable the I cache.
ENABLE MMUEnable the MMU.
EXITExit 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.
QUITAlias for EXIT. Exit the Configure commands and return to standard Boot Monitor commands.
SET BAUD port rateSet the baud rate for the UART port specified. Valid port numbers are 0, 1, 2, 3.
SET CLOCK n FREQUENCY frequency

Set the frequency in MHz of the requested CLOCK n.

Caution

Recommended clock switching procedures must be used to ensure system integrity when changing the system clock frequency.

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/yySet date. The date can also be entered as dd-mm-yy.
SET TIME hh:mm:ssSet time. The time can also be entered as hh-mm-ss.

Table F.4 lists the commands for the Debug sub-menu.

Table F.4. Boot Monitor Debug commands

CommandAction
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 MESSAGESDisable debug messages.
ENABLE MESSAGESEnable debug messages.
EXAMINE addressExamine memory at address.
EXITExit the debug commands and return to executing standard Boot Monitor commands.
GO addressRun the code starting at address.
HELP [command]

List the debug commands.

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

QUITAlias 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 TIMERStart a timer.
STOP TIMERStop the timer started with the START TIMER command and display the elapsed time.

Table F.5 lists the commands for the NOR Flash subsystem.

Table F.5. Boot Monitor NOR flash commands

CommandAction
CREATE BOOTSCRIPT [NAME name] [FLASH_ADDRESS address]Creates a boot script that is stored in flash. The image will be 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 bootscript is written by using the optional FLASH_ADDRESS argument.
DISPLAY BOOTSCRIPT [name]Displays bootscript that is stored in flash. If the optional name is not specified then the default name BOOTSCRIPT is used.
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 will be 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 in the case of accidental erasure.

EXITExit 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 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.
RESERVE SPACE address sizeReserve space in NOR flash. This space will not be used by the Boot Monitor. address is the start of the area and size is the size of the reserved area.
RUN nameLoad the image name from flash and run it.
UNRESERVE SPACE addressFree 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 © 2008-2011 ARM Limited. All rights reserved.ARM DUI 0417D