Keil™, An ARM® Company

µVision® User's Guide

Debug Commands

µVision3 supports a number of commands you may enter in the Output Window — Command Line. Commands may be separated into categories that describe the common function of the commands.

The commands can be grouped into the following categories:

Breakpoint Commands

Breakpoint commands let you create and delete breakpoints. You use breakpoints to halt program execution or to execute µVision3 commands or user functions when a particular instruction is reached.

CommandDescription
BreakAccessAdd an access breakpoint with length to the list of breakpoints.
BreakDisableDisables one or more breakpoints.
BreakEnableEnables one or more breakpoints.
BreakKillRemoves one or more breakpoints from the breakpoint list.
BreakListLists the current breakpoints.
BreakSetAdds a breakpoint expression to the list of breakpoints.

General Commands

General commands let you perform a number of miscellaneous debugging operations.

CommandDescription
ASSIGNAssigns input and output sources for the Serial window.
DEFINECreates a Toolbox button.
DIRGenerates a directory of symbol names.
EXITExits µVision3 debug mode.
INCLUDEReads and executes the commands in a command file.
KILLDeletes µVision3 debug functions and Toolbox buttons.
LOADLoads object modules, and HEX files.
LOGCreates log files, queries log status, and closes log files for the Debug window.
MODESets the baud rate, parity, and number of stop bits for PC COM ports.
RESETResets µVision3, resets memory map assignments, and resets predefined variables.
SAVESaves a memory range in an Intel HEX386 file.
SCOPEDisplays address assignments of modules and functions of a target program.
SETSets the string value for predefined variable.
SIGNALDisplays signal function status and removes active signal functions.
SLOGCreates log files, queries log status, and closes log files for the Serial window.

Memory Commands

Memory commands let you display and change the contents of memory.

CommandDescription
ASMAssembles in-line code.
DEFINEDefines typed symbols that you may use with µVision3 functions.
DISPLAYDisplay the contents of memory.
ENTEREnters values into a specified memory area.
EVALuateEvaluates an expression and outputs the results.
MAPSpecifies access parameters for memory areas.
UnassembleDisassembles program memory.
WatchSetAdds a watch variable to the Watch window.
WatchKillKill all watch variable in the Watch window.

Program Commands

Program commands let you execute your target program and analyze its performance.

CommandDescription
COVERAGEDisplay code coverage information.
GoStarts program execution.
LogicAnalyzeInitializes the Logic Analyser.
PerformanceAnalyzeInitializes the built-in performance analyzer.
PstepSteps over instructions but does not step into procedures or functions.
OstepSteps out of the current function.
TstepSteps over instructions and into functions.

Command Entry

During command entry, the syntax generator displays possible commands, options and parameters. As you enter commands µVision3 reduces the list of likely commands to coincide with the characters you type.

If you type B, the syntax generator reduces the commands listed.Syntax Generator Example 1
Available command options are listed if the command is clear.Syntax Generator Example 2
The syntax generator leads you through the command entry and helps you to avoid errors.Syntax Generator Example 3

Note

  • Only the CAPITAL characters of the command names are enter. For example, the BreakSet command must be entered as BS.