Date : Sun, 01 Nov 1992 18:13:27 EST
From : wilker@hopf.math.purdue.edu (Clarence Wilkerson)
Subject: MYZ80 ver 1.03
The author has given me permission to distribute this via
anonymous FTP from hopf.math.purdue.edu (128.210.3.19). Other
sites are welcome to pick it up and distribute it also.
It's in the pub/cpm directory.
This is a full demonstration version, to be used only
for non-profit purposes.
The full version with more documentation is available as
shareware from the author and should be obtained if used for
education, software development or other commercial activity.
Here's the .DOC file:
MicroFast Z80 Emulation Engine code,
MYZ80 API,
and The MYZ80 Emulator Package Versions 1.xx are each:
Copyright 1991,1992 Simeon Cran.
M Y Z 8 0
========
by Simeon Cran.
Welcome to MYZ80!
~~~~~~~~~~~~~~~~~
MYZ80 is a Z80/64180 emulator package. It was written to allow you
to finally get rid of those old Z80 computers which have done so
many fine years of service. The new 80386 machines with the fast
hard drives and the snazzy OS/2 operating systems are such a
delight... but for many, the Z80 machines still have to be fired
up from to time in order to develop code for CP/M and the Z80
chip. Well, not any more, thanks to MYZ80.
Other emulators on the market are less than satisfactory
solutions. Of the small number which can actually run without
causing system errors under the later versions of DOS, apparently
none are capable of running real CP/M. Instead they use an
emulated version of CP/M which is only as accurate as the
developers have bothered to make it.
None can run CP/M 3.0, and none can run ZCPR (which is such a
useful Z80 developer's environment). Add to that their less than
perfect Z80 emulation and slow overall performance, and until
MYZ80, the 'real' Z80 machines were destined to remain in the
office.
MYZ80 provides the solution being conceived, born and nurtured to
the point where it is now the most useful Z80 emulator package
ever!
MYZ80 features.
~~~~~~~~~~~~~~~
MYZ80 emulates the instruction set of the 8080, Z80 and Z180/64180
CPU chips. It does this with the "MicroFast Z80 Emulation Engine"
which is a very highly tuned piece of code designed to be as fast
and as accurate as technically possible on 80286, 80386 and 80486
CPUs.
MYZ80 provides an interface (the MYZ80 API) to the host computer
which allows real Z80 BDOSes to run in the MYZ80 environment. This
interface provides disk and character I/O as well as two banks of
64k RAM (with common area) and a large RAM disk. These unique
features allow MYZ80 to run 'real' CP/M 2.2, CP/M 3.0, Z-System
and ZPM3.
MYZ80 is designed for the latest multitasking operating systems
and makes Z80 programs 'host friendly'. MYZ80 will share time very
fairly with the host. Even multiple instances of MYZ80 are
supported.
MYZ80 can take advantage of the latest computer hardware for
increased performance. The Microfast Z80 Emulation Engine operates
in either 16 (80286) or 32 (80386/80486) bit mode depending on the
capabilities of the host computer.
MYZ80 runs beautifully on IBM AT compatible (or better) computers
under DOS 3.3 compatible (or later) operating systems. This
includes running under OS/2 2.0, Desqview, and Windows 3.x.
Starting MYZ80.
~~~~~~~~~~~~~~~
MYZ80 is started from the DOS command line by simply typing the
name of its executable (CPM). However, advanced users may wish to
include optional arguments on the command line.
The first argument is the name of a boot file to be used instead
of the default (BOOT.CPM), and following arguments are saved by
MYZ80 and may be retrieved from within the MYZ80 environment.
MYZ80 always looks for its support files in the directory it
resides in. Therefore, you may start MYZ80 from any directory or
disk, and it will always find its support files (as long as they
are in the same directory as CPM.EXE).
MYZ80 may be run from a floppy disk (although a hard disk is
recommended). To do so, put CPM.EXE and the support files onto the
floppy disk, and start the program.
Leaving MYZ80.
~~~~~~~~~~~~~~
There are two ways to exit from the MYZ80 environment. You may
select the 'Abort and exit' choice from the pause box menu, or you
may run the MYZ80 utility QUIT.COM. The latter method also allows
you to specify an error level to return to DOS with (for use in
batch files).
Further information.
~~~~~~~~~~~~~~~~~~~~
Some explanations of the terms used above and further information
will be displayed to you when you start MYZ80 for the first time.
Legal information is provided in the file READ.1ST which was
supplied with this package. All the MYZ80 utilities have online
help. Other support files for MYZ80 should be provided in the
future and will probably be available from the place where you
found this package.
The version of MYZ80 that you have now may not be perfect, but it
is pretty close! It has been released so that as many people as
possible can join the MYZ80 revolution, and keep CP/M and Z80
alive for years to come. Please enjoy it.
Simeon Cran.
*************************************************************
Acknowledgments:
Due to all the great help, I feel compelled to acknowledge
the support given by a number of people in the "Z" community.
Especially Bruce Dudley (Sysop of Z-Node 62 in Perth, Western
Australia), and the handful of crash testers in Australia and
around the world. And to all those people who truly
appreciate the elegance of the art of machine code
optimization, please enjoy "MYZ80 by Simeon Cran."
*************************************************************