Add/Edit Dialog

 

Add / Edit Breakpoint Dialog

The Add / Edit Breakpoint dialog opens whenever an add or edit action is requested.  The fields in the dialog vary based on the breakpoint resource (Hardware, Software, etc), and also based on the type of breakpoint selected in the Break on field.

The following is a list of the possible breakpoint fields:

Identifier.  Displays a user-defined name for the breakpoint.  If this field is left blank, SourcePoint will automatically create a name based on the following rules:  

1. If a symbolic name was entered in the Address field, then the Identifier field will be set to the symbolic name, and the Address field will be changed to the numeric address value.

2. If a numeric address was entered in the Address field, then the Identifier field will be set to event #, where # is a unique number.

Break On.  Defines the breakpoint type.  The breakpoint type and resource are closely related.  If you select a new breakpoint type that is not available for a particular breakpoint resource, then the resource type will change automatically.  For more on breakpoint types and resources see Breakpoint Types and Resources.

Resource.  Defines the breakpoint resource (Hardware, Software, etc.).  The choices in this dropdown list vary based on the breakpoint type selected in the Break on field above.  If only one breakpoint resource is available for a given breakpoint type, then that resource is automatically selected.

Processor.  In multiprocessor systems, selects the processor associated with the breakpoint.  For task breakpoints, this field is labeled Task, and contains the name of the task the breakpoint is set in.

Address.  Defines the breakpoint address.  Both symbolic address expressions and numeric addresses are supported.  

If a symbolic address expression is entered without specifying a breakpoint identifier (name), then the symbolic expression is copied to the Identifier field, and the numeric address is entered in the Address field.

Find Symbol Button. Opens the Find Symbol dialog. This dialog allows quickly locating any program symbol and its memory address.

For detailed information on the Find Symbol dialog box, see the Edit Menu topic under "SourcePoint Overview," part of SourcePoint Environment.

Binary (1010) Buttons. Binary buttons are available for the Address and Data fields. These buttons open a dialog that allows editing a field value in binary and, if the breakpoint type supports it, specifying "Don’t Cares" for individual bits.

Translate.  Specifies the address translation type of the breakpoint.  This controls when virtual addresses are translated to physical addresses.  This control is only enabled for processors that have an MMU, and only for breakpoint resource types where a physical address is specified (e.g., software breakpoints).

When Translate Once is selected, the virtual address is translated when the OK button is pressed to dismiss the dialog.

When Translate Every Go is selected, the virtual address is re-translated prior to every Go operation.

Cmd/macro.  Specifies a macro to run when the breakpoint hits.  There are two ways to specify a macro:

1. Use the Browse button to find a macro file to be executed.

2. Enter a single command to execute prefaced by the '#' character.

This field is only available for hardware execution breakpoints, software breakpoints, task breakpoints and power cycle breakpoints.