µ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.
The command options are shown when the typed command is identified clearly.
The syntax generator leads through the command entry and helps avoiding errors.

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

• Expressions describes the debug commands syntax.
• Fully Qualified Symbols explains the use of symbols.
• System Variables help in setting or querying specific system functions.
• Cortex-M Code and Data Trace describes trace features, limitations, and concepts.
• Trace Expressions describes the syntax for defining tracepoint conditions.