Debug

The dialog Debug defines options that are applied when a debugging session is started. The screen is split into options for the Simulator and for debugging on hardware.

Use Simulator

Selects the µVision Simulator for debugging applications.

Settings (button)

Configures device specific Simulator options such as start-up features and BUS characteristics (available for some devices).

Limit Speed to Real-Time

Synchronizes the CPU simulation to the PC clock, which is a real-world clock. It limits the speed of the CPU simulation to real-time considering the CPU frequency set in the field Options for Target - Target - Xtal(MHz). This setting is useful only for targets that simulate faster than real-time, which is mostly the case for 8051 applications.

Use: Debug Driver

Selects a driver for debugging the target hardware. Several AGDI drivers are available that use different software or hardware tools to test the program. For example, a ULINK USB-JTAG adapter driver that uses the embedded on-chip debugging hardware.

Settings (button)

Configures target driver options, for example the communication channel, memory cache, or tracing options.

Common Options

The dialog consists of two almost identical configuration sections:

Load Application at Startup

Loads the object file specified in the field Options for Target - Output - Name of Executable into the µVision Debugger.

Run to main()

Executes the instructions until main() is reached and stops execution. When disabled, the application stops at the first instruction. Commands defined in Initialization File are executed regardless of this option.

Initialization File

Specifies a file that can contain Debug Commands, Debug Functions, debugger configuration settings, and device initialization commands. For example, Toolbox buttons can be defined. Click Edit to open the file.

Note

• To exit long running or hanging functions, position the cursor into the command-line of the Output window and press ESC.

Restore Debug Session Settings

Restores the settings defined in the previous debugging session for Breakpoints, Watch Windows and Performance Analyzer, Memory Window, Toolbox, and the System Viewer.

CPU/Driver DLL - Parameter

Preferably, do not modify these settings. Device Database Parameters describe the parameters.

Dialog DLL - Parameter

Preferably, do not modify these settings. Device Database Parameters describe the parameters.

Sequence of Execution

µVision executes the commands in the following order:

1. The debugger loads the file set in the field Project - Options for Target - Output — Name of Executable when Load Application at Startup is enabled.
2. Restores Debug Session Settings for enabled dialogs.
3. Executes the commands in the Initialization File.
4. Executes the instructions until reaching main() when Run to main() is enabled or the command g, main is found in the Initialization File.