| Copyright © 2003, 2004 ARM Limited. All rights reserved. | ARM DUI 0235B |
| Non-Confidential | |
 PDF version | |
| Home > RealView Debugger Commands > Alphabetical command reference > SETTINGS |
| |||
| Home > RealView Debugger Commands > Alphabetical command reference > SETTINGS | |||
The SETTINGS command enables you to define target settings.
SETTINGS [{default
| option_list}]
where:
defaultCauses all settings to revert to their default values.
option_listA list of option names and values. Each option-value pair consists of a setting name, an equals sign, and a value. The available option names and values are described in Description.
You can specify multiple options in the list by separating each option-value pair with a colon.
The SETTINGS command enables you to define settings (properties) for target support. These options are also set using the project manager interface.
If the only parameter is the default qualifier,
then all the settings revert to their default values. If you supply
no parameters, the command displays the current values of settings
for which a default value is defined.
Each setting is defined in the form of name=value:)
as a separator.
The standard option names are:
loadactAction on load. The possible values are:
defaultNormal load image behavior. For ARM architecture-based processors, the processor is placed in ARM state and supervisor mode with interrupts disabled.
noimaskDo not change the processor status register. For example, on ARM architecture-based processors, the default modification of CPSR is not performed.
resetReset the processor after the load, to perform a start from reset.
pre_resetReset the processor before the load.
pcsetWhen to change the PC when loading an image. The possible values are:
autoNormal behavior. The PC is modified if there is an entry point specified in the image file and:
an image file without symbols is loaded and the LOAD option /SP is
used
an image file with symbols is loaded.
neverDo not set PC.
alwaysAlways set the PC. If no entry point is specified
in the image, the PC is set to the reset vector (normally to address 0).
user_defaultAlways set the PC to the value specified in the pcdefault setting.
pcdefaultUser default PC value. This value is written to
the target PC when a image file is LOADed or RELOADed
and the pcset option is user_default.
regsetSet the values of registers before the image is
loaded. Use the format @ for
each register, and separate multiple assignments with a semicolon.regname=value
See SETREG on SETREG for more information on possible register names.
restartDefines the action of the RESTART command.
The possible values are:
set_pcSet the PC to the entry point of the image.
reloadReload the image as for RELOAD.
The options relating to RELOAD, loadact and pcset,
also apply.
reload_dataReload only the initialized data of the image. The
options relating to RELOAD, for example loadact and pcset,
also apply.
restart_resetReset on restart. The possible values are:
trueReset
the processor on RESTART, in addition to any
other actions.
falseDo
not reset the processor on RESTART.
verifyVerify the image LOADed or RELOADed.
The possible values are:
noneDo not verify the image.
fastPerform the normal image verify. The first and last words of every image file section written to the target are read and checked. For individual sections larger than about 2KB, then the first and last words of each 2KB block of the section is checked.
fullRead and check every byte of the image.
verify_warnsDetermines what happens if an image file verification failure occurs. The possible values are:
trueThe failure is treated as a warning and operation continues.
falseThe failure is an error and the image load is aborted.
disasmSet the disassembly mode. The possible values are:
defaultAttempt to auto-detect the disassembly mode.
Select from ARM, Thumb or Java instructions, using information from the image file where available.
standardSelect the standard, normal instruction disassembly mode.
Select ARM state (32-bit) instructions.
alternateSelect the standard, normal instruction disassembly mode.
Select Thumb state (16-bit) instructions.
dsmvalueSelects whether the instruction code is displayed in disassembly listings. The possible values are:
trueDisassembly listings include the instruction opcode, along with the instruction memory address and mnemonics.
falseDisassembly listings do not include the instruction opcode.
Additional options might be implemented for particular target interfaces. See the target interface documentation for more information.
The following examples show how to use SETTINGS:
settings regset=@r2=1;@spsr_svc=0xd0Set the value of processor the ARM processor register R2 and SVC mode SPSR whenever an image is loaded or reloaded.
settings pcset=use:pcdefault=0x8000When any image is loaded or reloaded, set the PC
to 0x8000.
settings loadact=resetAfter an image is loaded or reloaded, reset the processor (in hardware). This is useful when the image has been constructed to run from target reset.
settings verify=full:verify__warns=trueWhen an image is loaded, check every byte written to the target but do not consider a difference in the value read back to be an error.
| Copyright © 2003, 2004 ARM Limited. All rights reserved. | ARM DUI 0235B |
| Non-Confidential | |
| PDF version | |
| Home > RealView Debugger Commands > Alphabetical command reference > SETTINGS |