The DoCD debugger fully supports Keil uVision AGDI interface to hardware debuggers. It allows Keil software users to work within uVision environments without switching between Keil compiler and external DoCD software. Everything - compilation, simulation, debugging - is under control of a single application. This document describes how to install and use DoCD debugger with programs written using Keil C/ASM tools.

In order to run your application inside hardware using DoCD target driver follow the steps:

• Run uVision. Select 'Project | Open Project', the Select Project dialog comes up. Select the 'DoCD.uv2' project. It can be found normally in the folder - < Keil install path >\C51\EXAMPLES\DoCD.
• Select 'Options for Target | Devices'. From the 'Database' list-box, select 'Digital Core Design' which is our devices database. Select required microcontroller type you actually have. If everything is right, then the dialog should look like this:

• Select 'Rebuild all target files' to build the project.
• Select 'Options for Target | Debug'. From the combo-box, select 'DoCD 8051 Target Driver' which is our DoCD driver. Make sure that the 'Use:' radio button is checked. If everything is right, then the dialog should look like this:

• Select 'Settings' button. The 'Target Setup' dialog comes up.

Choose a COM port used by HAD board, enable at least CODE 'Caching Options'. Enter the actual clock frequency applied on-board to global CLK pin of 8051 IP Core. Allowed values are 1 MHz to 250 MHz. It means that DoCD will be working properly with CLK clock frequencies 2 times lower and 2 times higher than entered value.

It is described how to use DoCD debugger with 8051 C/ASM application basing on example DoCD project. It is assumed that the installation and configuration steps had been performed. You should also have DCD's 8051 core with Debug IP running inside some hardware prototype board equipped with FPGA or ASIC chip. There is DoCD FPGA Kit available to use with Keil uVision tool.

• Run uVision IDE. Select 'Project | Open Project', the Select Project dialog comes up. Select the 'DoCD.uv2' project. It can be found normally in the folder - < Keil install path >\C51\EXAMPLES\DoCD. The dialog should look like this:

• Select 'Rebuild all target files' to build the project. The build window shown above should report no warnings and errors.

• Start debugging by selecting 'Start/Stop Debug session'

• When hardware is properly configured, and program successfully uploaded/downloaded, then the debugger window should look similarly to picture below:

At this point debugging process is similar as in uVision simulator. The program can be run, halted, run step by step, breakpoints can be set/cleared. Variables can be watched, memory areas read/written/modified.

The following software packages can be downloaded from the internet.

1. DoCD Target driver for Keil uVision tool can be downloaded free of charge from DCD's web-site at http://www.dcd.pl/asoft.php.

2. Keil 8051 uVision tool suite can be obtained from Keil GmbH at http://www.keil.com. Evaluation version is free of charge downloadable online at http://www.keil.com/demo/eval/c51.htm.

The customers should have DCD's 8051/80390 IP Core equipped with DoCD on chip debugger, and HAD communication board. Information about DoCD debug system is available at http://www.dcd.pl, and can be also directly requested emailing to info@dcd.pl.

More details about DoCD Target driver for Keil uVision tool can be found in the following document. To obtain more information about supported microprocessors please check:

• DP8051XP - Pipelined High Performance Configurable 8051 microcontroller.
• DR8051XP - High Performance Configurable 8051 microcontroller.

• DP80390XP - Pipelined High Performance Configurable 8051/80390 microcontroller.
• DR80390XP - High Performance Configurable 8051/80390 microcontroller.

• Using DoCD debug software with Keil OMF files
• DoCD FPGA Kit