User manual

UM0036 Basic debugging features
Doc ID 7705 Rev 11 173/385
Note: A breakpoint and a bookmark may be placed together at the same position.
● Breakpoint icon : a round red dot symbol. Changes in a breakpoint icon's color
indicate the following:
–A red breakpoint dot means that breakpoint is enabled.
–A grey breakpoint dot means that breakpoint is disabled.
–A brown breakpoint dot (shown in Figure 112) means that STVD is uncertain
about the position of the breakpoint. The position of the brown dot indicates where
STVD believes the breakpoint is, but cannot verify its position. This situation can
occur if the application you are debugging is missing debug information.
Figure 112. Brown breakpoint icon in Disassembly window
Breakpoints may be inserted, removed, enabled or disabled from the Edit menu or
toolbar, or by simply clicking on the breakpoint itself—this toggles the breakpoint
between the disabled state (dot becomes grey), removed, then back to the enabled
state. The Editor's Contextual menu also permits these actions.
If you exit debug mode, the breakpoints you have placed remain visible in the margin of
the Editor window. Editing your source code does not perturb the placement of the
breakpoint—it follows the source code line at which it has been placed, even it you add
or delete other source code lines before and after it.
● Program Counter : yellow arrow and yellow highlighting. The Program Counter (PC)
indicator automatically marks the current position of the program counter. It highlights
the line in the source program which is the origin of the next machine instruction to be
executed by the processor.
● When a program is run (using the run commands) and halts at an active Breakpoint,
the program line corresponding to the Program Counter is highlighted in the Editor
window. The program text is adjusted in the window so that the section containing the
PC indicator is displayed.
● Call Stack Frame Indicator : a green triangular symbol and green highlighting. The
Call Stack window lists the addresses contained in the Stack; the value of the Program
Counter followed by the most recent Call value are at the top of the stack list. If a value
in the Call Stack other than the PC is selected (by double-clicking on it), the Call Stack
Frame indicator is set to this value. In the Editor window, the corresponding line of the
source program is highlighted. (If the Disassembly window is open, the selected stack
address is also highlighted.)