Creating watchpoint

Use the Add Watchpoint dialog to create a watchpoint. The debugger sets the watchpoint according to the settings that you specify in this dialog.

The following table describes each option.

Table 1. Add Watchpoint dialog options
Option Description
Expression to Watch Enter an expression that evaluates to an address on the target device. The debugger displays an error message when the specified expression evaluates to an invalid address. You can enter these types of expressions:
  • An r-value, such as &variable
  • A register-based expression. Use the $ character to denote register names. For example, enter $SP-12 to have the debugger set a watchpoint on the stack-pointer address minus 12 bytes.
The Add Watchpoints dialog does not support entering expressions that evaluate to registers.
Memory Space Select it if you want to specify the memory space in which the watchpoint is set. The pop-up menu to the right of the checkbox lists each memory space available for the active debug context. If no debug session is active, the pop-up menu is empty and lets you enter text. This feature lets you set a memory-space-qualified watchpoint before starting a debug session.
Range If selected - enter the number of addresable units that the watchpoints monitors. If deselected - set the watchpoint on the entire range of memory occupied by the variable.
Write If selected - the watchpoint monitors write activity on the specified memory space and address range. If deselected - the watchpoint does not monitor write activity.
Read If selected - the watchpoint monitors read activity on the specified memory space and address range. If deselected - the watchpoint does not monitor read activity.
Enabled Select the Enabled option to enable or disable a breakpoint.
Condition Specifies an expression that is evaluated when the watchpoint is hit.
Ignore count Set the ignore count of watchpoint number to an integer n. The next n times the watchpoint is reached, program's execution does not stop; other than to decrement the ignore count, debugger takes no action. To make the watchpoint stop the next time it is reached, specify a count of 0 (zero).