Keil Logo Arm Logo

µVision4 User's Guide

Debug Commands

Debug Commands can be used in debug functions and in the Command Window. The syntax generator displays matching commands, options, and parameters when using the Command Window. The list of likely commands is reduced to coincide with the typed characters.

Enter the CAPITAL characters of a command! For example, BreakSet must be entered as BS.

By typing B, the syntax generator reduces the list of possible commands. Syntax Generator Example 1
The command options are shown when the typed command is identified clearly. Syntax Generator Example 2
The syntax generator leads through the command entry and helps avoiding errors. Syntax Generator Example 3

Breakpoint Commands

Breakpoint commands create, delete, enable, disable, or list the breakpoints. Use breakpoints to halt program execution, to stop commands, or interrupt user functions.

Command Description
BreakAccess Adds an access breakpoint with a length parameter to the breakpoint list.
BreakDisable Disables one or more breakpoints.
BreakEnable Enables one or more breakpoints.
BreakKill Removes one or more breakpoints from the breakpoint list.
BreakList Lists the current breakpoints.
BreakSet Adds a breakpoint expression to the list of breakpoints.

General Commands

General commands perform a number of miscellaneous debugging operations.

Command Description
ASSIGN Assigns input and output sources for the Serial window.
DEFINE Creates a Toolbox button.
DIR Generates a directory of symbol names.
EXIT Exits the debug mode.
FUNC Creates C-like functions for debugging.
INCLUDE Reads and executes the commands in a command file.
ITMLOG Creates a log file for writing ITM channel output of Cortex-M devices. Each ITM channel has its own log file.
IRLOG Creates a log file for writing all ITM channel outputs of Cortex-M devices to one common file. Creates a log file for RTA channel output of ARM7 or ARM9 devices.
KILL Deletes user- or signal functions and Toolbox buttons.
LOAD Loads object modules, and HEX files.
LOG Creates log files, queries log status, and closes log files for the Debug window.
MODE Sets the baud rate, parity, and number of stop bits for PC COM ports.
RESET Resets the CPU, memory map assignments, and predefined variables.
SAVE Saves a memory range in an Intel HEX386 file.
SCOPE Displays address assignments of modules and functions of a target program.
SET Sets the string value for predefined variables.
SIGNAL Displays signal function status and removes active signal functions.
SLOG Creates log files, queries log status, and closes log files for the Serial window.

Memory Commands

Memory commands display and change the content of memory.

Command Description
ASM Assembles in-line code.
DEFINE Defines symbols or Toolbar buttons.
DISPLAY Displays the content of memory.
ENTER Enters values into a specified memory area.
EVALuate Evaluates an expression and outputs the results.
MAP Specifies access parameters for memory areas.
Unassemble Disassembles program memory.
WatchSet Adds a watch variable to the Watch window.
WatchKill Kills all watch variable in the Watch window.

Program Commands

Program commands execute target programs and analyze their performance.

Command Description
COVERAGE Displays code coverage information.
Go Starts program execution.
LogicAnalyze Adds, deletes, or displays Logic Analyser variables.
PerformanceAnalyze Adds, deletes, displays, or resets the Performance Analyzer ranges.
Pstep Steps over instructions but does not step into procedures or functions.
Ostep Steps out of the current function.
Tstep Steps over instructions and into functions.

Tracepoint Commands

Tracepoint commands define tracepoints for Cortex-M3 and Cortex-M4 processor-based devices.

Command Description
TraceAccessPoint Defines a tracepoint for capturing read or write activities on a memory range.
TraceDataPoint Defines a tracepoint for capturing read or write activities on a memory range.
TraceDisable Deactivates a tracepoint.
TraceEnable Activates a tracepoint.
TraceHalt Stops capturing all trace data.
TraceKill Removes one or more tracepoints.
TraceList Lists all tracepoints.
TraceRun (ETM) Defines a tracepoint to start capturing ETM instructions.
TraceSuspend (ETM) Defines a tracepoint to stop capturing ETM instructions.

Note

arm-logo-small

Keil logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.