home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / OS / MYZ80102.ZIP / MYZ80.DOC < prev    next >
Text File  |  1992-08-23  |  5KB  |  138 lines
  1.  
  2.  
  3.  
  4.              MicroFast Z80 Emulation Engine code,
  5.                          MYZ80 API,
  6.      and The MYZ80 Emulator Package Versions 1.xx are each:
  7.               Copyright 1991,1992 Simeon Cran.
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                             M Y Z 8 0
  14.                             =========
  15.  
  16.                          by Simeon Cran.
  17.  
  18. Welcome to MYZ80!
  19. ~~~~~~~~~~~~~~~~~
  20. MYZ80 is a Z80/64180 emulator package. It was written to allow you 
  21. to finally get rid of those old Z80 computers which have done so 
  22. many fine years of service. The new 80386 machines with the fast 
  23. hard drives and the snazzy OS/2 operating systems are such a 
  24. delight... but for many, the Z80 machines still have to be fired 
  25. up from to time in order to develop code for CP/M and the Z80 
  26. chip. Well, not any more, thanks to MYZ80.
  27.  
  28. Other emulators on the market are less than satisfactory 
  29. solutions. Of the small number which can actually run without 
  30. causing system errors under the later versions of DOS, apparently 
  31. none are capable of running real CP/M. Instead they use an 
  32. emulated version of CP/M which is only as accurate as the 
  33. developers have bothered to make it.
  34.  
  35. None can run CP/M 3.0, and none can run ZCPR (which is such a 
  36. useful Z80 developer's environment). Add to that their less than 
  37. perfect Z80 emulation and slow overall performance, and until 
  38. MYZ80 the 'real' Z80 machines were destined to stay in the office.
  39.  
  40. MYZ80 provides the solution being conceived, born and nurtured to 
  41. the point where it is now the most useful Z80 emulator package 
  42. ever!
  43.  
  44.  
  45. MYZ80 features.
  46. ~~~~~~~~~~~~~~~
  47. MYZ80 emulates the instruction set of the 8080, Z80 and Z180/64180 
  48. CPU chips. It does this with the "MicroFast Z80 Emulation Engine" 
  49. which is a very highly tuned piece of code designed to be as fast 
  50. and as accurate as technically possible on 80286, 80386 and 80486 
  51. CPUs.
  52.  
  53. MYZ80 provides an interface (the MYZ80 API) to the host computer 
  54. which allows real Z80 BDOSes to run in the MYZ80 environment. This 
  55. interface provides disk and character I/O as well as two banks of 
  56. 64k RAM (with common area) and a large RAM disk. These unique 
  57. features allow MYZ80 to run 'real' CP/M 2.2, CP/M 3.0, Z-System 
  58. and ZPM3.
  59.  
  60. MYZ80 is designed for the latest multitasking operating systems 
  61. and makes Z80 programs 'host friendly'. MYZ80 will share time very 
  62. fairly with the host. Even multiple instances of MYZ80 are 
  63. supported.
  64.  
  65. MYZ80 can take advantage of the latest computer hardware for 
  66. increased performance. The Microfast Z80 Emulation Engine operates 
  67. in either 16 (80286) or 32 (80386/80486) bit mode depending on the 
  68. capabilities of the host computer.
  69.  
  70. MYZ80 runs beautifully on IBM AT compatible (or better) computers 
  71. under DOS 3.3 compatible (or later) operating systems. This 
  72. includes running under OS/2 2.0, Desqview, and Windows 3.x.
  73.  
  74.  
  75. Starting MYZ80.
  76. ~~~~~~~~~~~~~~~
  77. MYZ80 is started from the DOS command line by simply typing the 
  78. name of its executable (CPM). However, advanced users may wish to 
  79. include optional arguments on the command line.
  80.  
  81. The first argument is the name of a boot file to be used instead 
  82. of the default (BOOT.CPM), and following arguments are saved by 
  83. MYZ80 and may be retrieved from within the MYZ80 environment.
  84.  
  85. MYZ80 always looks for its support files in the directory it 
  86. resides in. Therefore, you may start MYZ80 from any directory or 
  87. disk, and it will always find its support files (as long as they 
  88. are in the same directory as CPM.EXE).
  89.  
  90. MYZ80 may be run from a floppy disk (although a hard disk is 
  91. recommended). To do so, put CPM.EXE and the support files onto the 
  92. floppy disk, and start the program.
  93.  
  94.  
  95. Leaving MYZ80.
  96. ~~~~~~~~~~~~~~
  97. There are two ways to exit from the MYZ80 environment. You may 
  98. select the 'Abort and exit' choice from the pause box menu, or you 
  99. may run the MYZ80 utility QUIT.COM. The latter method also allows 
  100. you to specify an error level to return to DOS with (for use in 
  101. batch files).
  102.  
  103.  
  104. Further information.
  105. ~~~~~~~~~~~~~~~~~~~~
  106. Some explanations of the terms used above and further information 
  107. will be displayed to you when you start MYZ80 for the first time. 
  108. Legal information is provided in the file READ.1ST which was 
  109. supplied with this package. All the MYZ80 utilities have online 
  110. help. Other support files for MYZ80 should be provided in the 
  111. future and will probably be available from the place where you 
  112. found this package.
  113.  
  114.  
  115. The version of MYZ80 that you have now may not be perfect, but it 
  116. is pretty close! It has been released so that as many people as 
  117. possible can join the MYZ80 revolution, and keep CP/M and Z80 
  118. alive for years to come. Please enjoy it.
  119.  
  120.  
  121.  
  122. Simeon Cran.
  123.  
  124.  
  125.  
  126.  
  127.      *************************************************************
  128.      Acknowledgments:
  129.      Due to all the great help,  I feel  compelled to  acknowledge 
  130.      the support given by a number of people in the "Z" community. 
  131.      Especially Bruce Dudley (Sysop of Z-Node 62 in Perth, Western 
  132.      Australia), and the handful of crash testers in Australia and 
  133.      around  the  world.  And  to  all  those  people   who  truly 
  134.      appreciate  the  elegance  of   the  art   of  machine   code 
  135.      optimization, please enjoy "MYZ80 by Simeon Cran."
  136.      *************************************************************
  137.  
  138.