5.3.1. Using the Set Address/Data Break/Tracepoint dialog box

Select Debug → Simple Breakpoints → Address/Data... from the Code window main menu to display the Set Address/Data Break/Tracepoint dialog box, shown in Figure 5.8.

Figure 5.8. Set Address/Data Break/Tracepoint dialog box

Set Address/Data Break/Tracepoint dialog box

The Set Address/Data Break/Tracepoint dialog box provides comprehensive facilities to enable you to specify new breakpoints in full. You can also use it to edit existing breakpoints.

The main interface components of the Set Address/Data Break/Tracepoint dialog box are:

Location

Specifies the memory location where the new breakpoint is set. Click the drop-down arrow to the right of this field to choose from a list browser, or select from your personal favorites list, or select from a list of previously-used expressions. The options shown here depend on your debug target and connection.

Where supported by your target hardware, use the options from the right-arrow menu to qualify the location (see Using ranges and masks for details).

This field is enabled if you select a suitable Breakpoint Type and your current target supports the chosen type.

Value Match

Enter the data value that triggers the breakpoint. Click the drop-down arrow to the right of this field to choose from a list browser, or select from your personal favorites list, or select from a list of previously-used expressions.

If you use this with data breakpoints, this compares the data value that is read or written.

Where supported by your target hardware, use the options from the right-arrow menu to qualify the value match (see Using ranges and masks for details).

This field is enabled if you select a suitable Breakpoint Type and your current target supports the chosen type.

Break/Tracepoint Type

Enables you to select the type of breakpoint to set. On first opening the dialog box, the list shows only the breakpoint types that are supported by your debug target.

If you choose a breakpoint type, this changes the contents of the groups in this dialog box.

HW Support

This area is populated if you select a suitable Breakpoint Type and your current target supports the chosen type.

Where your debug target supports breakpoint tests in hardware, they can be managed and edited using this group. If enabled, the display lists currently available tests.

See Setting hardware breakpoints for details on using these controls.

Qualifiers

When setting a conditional breakpoint, you specify the condition that must be satisfied to trigger the breakpoint. Qualifiers are the tests that RealView Debugger carries out to trigger the breakpoint. Click New to display the New Qualifiers menu, shown in Figure 5.9, where you can define the test criteria.

Figure 5.9. Breakpoint New Qualifiers menu

Breakpoint New Qualifiers menu

See Setting conditional breakpoints for details on using these controls.

Actions

When a conditional breakpoint triggers the usual action is to stop execution but you can specify one or more RealView Debugger actions that must be performed when execution stops. In addition, RealView Debugger can carry out the specified action and then execution can continue. This is useful when debugging complex applications without direct user intervention.

Click New to display the New Actions menu, shown in Figure 5.10.

Figure 5.10. Breakpoint New Actions menu

Breakpoint New Actions menu

See Setting conditional breakpoints for details on using these controls.

OK

Click OK to confirm the new breakpoint properties and close the dialog box.

Cancel

Click Cancel to close the dialog box and abandon the breakpoint setting.

Help

Click Help to get online help on the controls in this dialog box.

Note

Depending on the Break/Tracepoint Type you select, the Location or the Value Match field might be unavailable. In this case, the field is grayed out.

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential