To configure the AXD user interface, select Configure Interface... from the Options menu. The resulting dialog has tabbed pages entitled:
General
Views
Formatting
Session File
Toolbars
Timed Refresh.
To display detailed information about the features of the currently displayed tabbed page, click Help.
When you have made changes on one or more of these tabbed pages, you can apply or abandon the changes as follows:
- OK
Apply outstanding changes on all tabbed pages and close the dialog.
- Cancel
Ignore any outstanding changes and close the dialog.
- Apply
Apply outstanding changes on all tabbed pages and keep the dialog open.
Figure 5.98 shows the General tab of the Configure Interface dialog.
The General tab of the Configure Interface dialog enables you to control the behavior of the target processor when you connect the debugger to it, and the actions to be taken when you restart or close a debugging session. It also enables you to make some other general settings applicable to the whole debugging session.
Most targets stop execution when a debugger is connected and restart when instructed to do so. Also, the displayed views are all updated each time the target execution stops. All views therefore show consistent data at all times.
Targets that support RealMonitor can be traced and queried without interrupting execution. The Target connection drop-down list enables you to select an appropriate way of connecting the debugger to the target, depending on whether you are using RealMonitor. See RealMonitor support for more information.
- Halt
The debugger is allowed to, and does, stop execution of the target when the connection is made. If connection to a new target is requested during program execution a warning message is displayed so that execution on the current target can continue, or stop, as required. This is the default setting.
- NoHalt
The target is assumed to be executing and must not be interrupted. If the target supports RealMonitor and a non-intrusive connection can be made, then the connection is made. Otherwise the debugger redisplays the configuration dialog.
- Attach
If the target supports RealMonitor and a non-intrusive connection can be made, then the connection is made without stopping target execution. If the target does not support RealMonitor then the connection is still made even though doing so stops the target execution.
Note
The AXD debug architecture does not currently support attaching and re-attaching while using any kind of semihosting.
Under Action on close/restart you can select a Save and load session file check box. If this is checked, details of your debug session are saved in a session file when you end the session, and next time you run AXD the new session starts in the same state. If the Save and load session file check box is cleared, details are not saved at the end of the current session, and the next session begins in the usual default state.
The check boxes in the General group control the types of messages recorded in the Debug Log tabbed page of the Output system view (see Output system view), and the List size fields enable you to control the amount of recent history that is maintained.
Figure 5.99 shows the Views tab of the Configure Interface dialog.
These Default view properties are used as default settings in all displayed views.
The General Font you select applies to the following views:
Backtrace
Breakpoints
Control Monitor
Low Level Symbols
Output
Watchpoints.
The Fixed Font you select applies to the following views:
Command Line Interface
Comms Channel
Console
Debugger Internals
Disassembly
Memory
Registers
Source
Variables.
The Default Initial View State you select applies to the starting state of all views except Source and Disassembly views which always float within the main window. You can set a view window as:
Docked
Undocked
Floating.
Docked and floating windows are described in Docked and floating windows. See also Window menu.
To display detailed information on all the fields and check boxes on this tabbed page, click Help.
Figure 5.100 shows the Formatting tab of the Configure Interface dialog.
The Formatting tab of the Configure Interface dialog enables you to define the formatting strings used for the default formatting options decimal, hex, floating point single, floating point double, Q15, and Q31. To change the default formatting string for a format option, select User.
The value you set for the Array expansion threshold limits the number of child items that you can display without first displaying the array expansion pop-up.
Figure 5.101 shows the Session File tab of the Configure Interface dialog. This tabbed page enables you to make settings that apply to all session files that you might create, including the default session file created automatically at the end of each debug session.
Under Session file options, you can choose whether or not to Reselect Target. If this is checked, target details are saved at the end of a session and a new session connects to the same target as the previous session. If unchecked, the new session starts with the same settings and displayed views as the previous session but with no target selected.
If you do reselect the previous target, you can use Reload Images to choose whether or not to reload the previous image onto the target. If this is checked, image details are saved at the end of a session and a new session loads the previous image. If unchecked, the new session starts with the same settings and displayed views as the previous session but with no image loaded.
If you use the Browse button to locate and select a script file, and check the Run Configuration Script check box, then the commands in the specified script file are executed after loading the session file and connecting to the target, but before loading any images.
Figure 5.102 shows the Toolbars tab of the Configure Interface dialog.
The check boxes in the Toolbars group control the display of the named toolbars. When a toolbar name is checked in this dialog, that toolbar is displayed on the main AXD screen. These toolbars are shown in Toolbars.
Figure 5.103 shows the Timed Refresh tab of the Configure Interface dialog.
The Timed Refresh tab of the Configure Interface dialog is particularly useful when you are debugging a target that supports RealMonitor (see RealMonitor support).
When you debug a target that does not support RealMonitor, all displayed views are refreshed each time execution on the target stops. This means that all the information you can see is consistent.
Execution on a target that supports RealMonitor, however, can be continuous, with each displayed view showing information that was relevant at one time but not necessarily at the time that the information in any other view was captured.
The pop-up menu available in most views includes a Refresh item, but that refreshes the information in that view only. The Window menu includes a Refresh All item, to refresh all the displayed views at the same time.
If you select the Enable Timed Refresh check box on the Timed Refresh tab of the Configure Interface dialog so that it is checked, then all displayed views are refreshed automatically and regularly.
Timed refresh is automatically suspended when dialogs are displayed. You can check the Disable Timer if user prompted by error dialog check box on the Timed Refresh tab of the Configure Interface dialog so that refreshes are disabled if an error dialog is displayed. When you have cleared the error dialog, you can enable timed refresh by clicking on the Timed Refresh tool.
You can also check or clear the Enable Timed Refresh check box by selecting the Timed Refresh item on the Window menu or by clicking on the Timed Refresh tool.
PDF version