µVision4 User's Guide

Debug

The dialog Debug defines debugging options, including whether to debug on hardware or use the Simulator. The settings are applied when a debugging session is started.

Use Simulator

Selects the µVision Simulator for debugging applications.

Simulator Settings

Configures device specific Simulator options such as start-up features and BUS characteristics (available on 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.

Target Driver Settings

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

This dialog page contains two almost identical configuration sections, one for the Simulator and another for the target debugging driver:

Load Application at Startup

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

Run to main()

Executes the instructions until main() is reached and stops execution. When disabled, the application stops at the first instruction. However, the commands defined in the 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.

Restore Debug Session Settings

Restores the settings defined in the previous debugging session. Restores Breakpoints, Watchpoints, Performance Analyzer settings, Memory Window definitions, and the Toolbox.

CPU/Driver DLL - Parameter

Review Simulator or target driver DLL settings (taken from the Device Database). Please do not modify the DLL file or parameters.

Dialog DLL - Parameter

Review dialog DLL settings (taken from the Device Database). Please do not modify the DLL file or parameters.

µVision executes the commands in the following order:

1. When Load Application at Startup is enabled, the debugger loads the file set in the field Project - Options Target - Output — Name of Executable.
2. When enabled, restores the settings of the previous debugging session.
3. Executes the commands in the Initialization File.
4. When Run to main() is enabled, or the command g, main is entered into the initialization file, the instructions are executed until main() is reached.