    Dunfield
    MicroScope

    A Universal High-Level/Low-Level PC-Hosted embedded debugger


Dunfield MicroScope is a Universal Debugger, designed to be (fairly)
easily portable to any CPU and target platform. It includes source debug
and symbolic capabilities, as well as full disassembly and binary
capabilities.

This debugger has been in use "in-house" for some time, however due to
the declining interest in DOS based tools, I had not taken the time to
polish up the documentation, finish all the target definition files and
kernels and otherwise make it ready as an "off the shelf" product.

I do however want to make it available on this package, so here it is!

The documentation may be a bit sketchy in places, however there is
decent on-line help.

Also, although not all of the Target Definition Files and Debug Kernels
are complete / tested, I decided to include them all, as significant work
has been done which will benefit anyone wishing to establish an interface
to an "unfinished" processor.

** Getting Started

Please note that the content of this distribution is copyright, and must
not be redistributed in any way. The full text of the license agreement
is displayed during the INSTALL process.

To install this package:

From DOS/Command prompt
   - Select the drive containing the distribution.
   - CD to the subdirectory containing the distribution (if necessary)
   - Run the INSTALL program

From Windows:
   - From "My Computer", open the drive containing the distribution.
   - Locate and open the subdirectory containing the distribution.
   - Double-Click on the INSTALL program icon.

NOTE: INSTALL is menu driven, and allows you to choose what portions of
the distribution package to install, and where to put them (directory).
It will warn you before installing over an existing directory, and does
not modify AUTOEXEC.BAT or CONFIG.SYS. It simply copies/dearchives the
files from the distribution diskette into appropriate directories on your
hard disk.

Please refer to the various README.*, *.TXT, and *.DOC files installed
with the package for more information.

Note that some DDS source files ('.c', '.h' etc.) are written using tab
stops at 4 character intervals, which is much more convenient for 'C'
development than the usual MS-DOS tab stops at 8 character intervals.
The DDSIDE and EDT editors from Dunfield Development Systems correctly
support these 4 character tab stop.

For information on obtaining technical help, see the TECHSUPP.TXT file
installed with the package documentation.

----
DEMO Version notes:

The demo version of DMS works only with my virtual "CFLEA" processor,
and does not include the CPU/Target source files and building tools.

To run the DEMO debugger, you will need a working CFLEA target.
The CFLEA package will install VMCDMS, a program which will implement
a CFLEA DMS target on another PC. Please refer to VMCDMS.TXT for more
information.
