home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / z / zsim20.zip / READ.ME < prev    next >
Text File  |  1992-12-04  |  7KB  |  199 lines
  1.  
  2.  
  3. ZSIM v2.0 is copyrighted
  4.  
  5. (c) 1990,1992 by
  6.  
  7.  
  8. Jürgen G. Weber
  9. Wiesentalstraße 1
  10. W-7170 Schwäbisch Hall
  11. Federal Republic of Germany
  12.  
  13. email: weberj@dia.informatik.uni-stuttgart.de
  14.  
  15.  
  16.  
  17. ZSIM is free for personal use.
  18.  
  19.  
  20.  
  21. Send comments and reports of reproduceable bugs to
  22. weberj@dia.informatik.uni-stuttgart.de
  23.  
  24.  
  25. ZSIM is a Program that simulates a CP/M Z80 machine. It DOES NOT
  26. simulate CP/M. But in the ZSIM package are included a PD CP/M
  27. compatible operating system and a program to format CP/M disks, so you
  28. can run CP/M programs.
  29. With the included DOSFTP utility you can exchange data between
  30. CP/M and MS-Dos.
  31.  
  32. Users of Version 1.2: look at the start of cpmbios.asm to see
  33.                       what is new in version 2.0
  34.  
  35. WARNING: Don't let CP/M work on a MS-Dos disc as it may be destroyed.
  36.          Even CP/M discs may be destroyed if they are in a format ZSIM
  37.          does not recognize.
  38.  
  39. WARNING: Making MS-Dos write to a CP/M disc probably will destroy it's
  40.          contents.
  41.  
  42.  
  43. Use the software at your own risk. There is no warranty for the
  44. program of any kind. The author takes no responsibility for any damage
  45. caused by the program, either direct or indirect, to your hardware or
  46. software. If you can't accept this restriction, please don't use ZSIM.
  47.  
  48.  
  49. ZSIM consists of a Z80 emulator part and a CP/M 80 bios for 80286 PC
  50. compatible machines. The sources of the bios are included. I think
  51. contrary to the CP/M bios a Z80 simulator might be used commercially
  52. still today, so I hid it's sources. The Z80 emulator is
  53. included in Z80EMU.OBJ - don't try to disassemble it, in programming it
  54. I vastly used macros, so the disassembler doesn't show much.
  55. Z80EMU.ASM is in encrypted form in Z80EMU.ZIP. See below.
  56.  
  57. ZSIM was developed using Borland's TASM/TLINK.
  58. ZSIM is almost wholly written in assembler, only the popup windows and
  59. the parameter editor are written in Modula-2 (using the shareware
  60. FMODULA2 Modula).
  61.  
  62. In the sources variable and label names are in English, comments are
  63. in German. So if you are interested in some intricacies of the
  64. bios get a German-English dictionary. Sorry.
  65.  
  66. By the way, excuse my English.
  67.  
  68. You may use the program ZSIM free of charge. This software may only be
  69. duplicated and used for personal, non-commercial use. The software may
  70. not be sold for profit. An adequate fee may be requested for copying,
  71. shipping and handling when redistributing this program. You may modify
  72. and improve those parts of the program where the sources are included.
  73. But the executable program must show a message that your version has
  74. been modified. Please include notes of your changes.
  75.  
  76.  
  77. You may freely copy, distribute and use this program. If you like
  78. ZSIM, a donation of $20 or any amount would be appreciated.
  79. Please send a check to the above address.
  80.  
  81. The sources of the Z80 simulator are included in Z80EMU.ZIP but they are
  82. protected with a password.
  83.  
  84. If you want to look at these sources, send a $50 check to the
  85. above address and I'll send you the password to unzip the sources by
  86. postal mail.
  87.  
  88.  
  89. ================
  90. GETTING STARTED:
  91. ================
  92.  
  93. If you don't have a CP/M disc at hand you can test the Z80 emulator
  94. too. Copy a the files in the archive into a directory on your hard
  95. disk. Format a 360K disc with CPMFRM.EXE. Be sure that FORMAT.COM is
  96. in your PATH. The disc is only needed because ZSIM requires a CP/M
  97. disc in the drive but it may be empty.
  98. Then start ZSIM. It will load a CP/M compatible operating system from
  99. CPMSYS.CPM (Superdos together with ZCPR) and load
  100. RAMDISC.CPM as ramdisc. Copy the files in the ramdisc (B:) to the disc
  101. using the SWEEP utility (enter ? to get help) or PPIP.
  102. The Small-C compiler is in RAMDISC.SMC. Rename this file to RAMDISC.CPM
  103. and copy those files to disc, too. I could have put all into one ramdisc
  104. but if you have little memory free in MS-Dos, you couldn't load it.
  105.  
  106. If you want to boot from a real CP/M system disc see in ZSIM.DOC
  107. for how to proceed.
  108.  
  109.  
  110. =================
  111. A SAMPLE STARUP:
  112. =================
  113.  
  114. jgw 64K cp/m 80 bios ver 2.0 --  12/02/92  (C) 1990,1992 by Jürgen G.Weber
  115.  
  116. BDOS: SUPERDOS AND ZCPR1
  117.  
  118. A>b:
  119. B>dir
  120. DFLIB   .C    :  DOSFTP  .C    :  DOSFTP  .COM  :  MAKE    .SUB
  121. MS2CPM  .C    :  PPIP    .COM  :  SWEEP   .COM  :  VDE     .COM
  122. ZLINK   .COM  :  ZLINK   .DOC  :  ZMAC    .COM  :  ZMAC    .DOC
  123. ZMON    .COM  :  ZSIMLIB .C    :  ZSIMLIB .H
  124. B>
  125.  
  126.  
  127.  
  128. =====================
  129. FILES IN THE ARCHIVE:
  130. =====================
  131.  
  132.  
  133. The following files should be in the archive:
  134.  
  135. MAKEFILE          1121 12-03-92   5:37p | ZSIM's makefile
  136.  
  137. CONIO    ASM     22327 12-02-92   9:27p | ZSIM's sources
  138. CPMBIOS  ASM     91995 12-03-92   5:38p   \
  139. PORTIO   ASM      1200 12-02-92   9:27p    \
  140. DOS      INC      6479 05-20-90   1:30p     \
  141. Z80EMU   INC      1246 11-19-92   9:06a      \
  142. ZBIOS    INC      6462 10-07-92   9:20a       \
  143.  
  144. EMUMENU  DEF      1737 01-12-92   4:41p | modula-2 subroutines
  145. EMUMENU  MOD     17214 12-02-92   9:37p   \
  146. EMUMENU  OBJ      8591 10-21-92   9:55p    \
  147.  
  148. CPMFRM   EXE     18144 10-06-90  12:37a | format CP/M disks
  149. CPMFRM   MOD      3579 10-06-90  12:36a   \
  150. FRMCPM   BAT        81 12-03-92   9:17a | format CP/M disks using SFB
  151. SFB      EXE     25200 05-05-90  10:54p | sets format byte
  152. SFB      MOD      1152 04-23-90   1:17p | modula-2 sources
  153.  
  154. OSBORN   PAR        21 08-06-92  10:27p | Discparm Osborn SSDD
  155. KAYPROII PAR        21 12-03-92   4:12p | Discparm Kaypro II SSDD
  156.  
  157. RAMDISC  CPM    131074 12-04-92   4:30p | ramdisc part I
  158. RAMDISC  SMC    288770 12-02-92   8:53p | ramdisc part II
  159.  
  160. CPMSYS   CPM      8704 01-11-92  11:28p | system image to boot from
  161. SUPERDOS SYS      8704 01-11-92  11:28p | CP/M compatible Dos
  162. Z80DOS   SYS      8704 01-11-92  11:30p | CP/M compatible Dos
  163.  
  164. Z80DOS   CHG      1023 01-12-92   1:03p | changes made in Z80DOS+ZCPR
  165.  
  166.  
  167. 8080EMU  OBJ      9124 12-02-92   9:34p | 8080 Emulator objects
  168. Z80EMU   OBJ     23301 12-02-92   9:28p | Z80 Emulator objects
  169. Z80EMU   ZIP     18900 12-03-92   5:50p | encrypted asm sources of Z80EMU
  170.  
  171. Z80EXMPL C        1766 12-02-92   9:42p | to use z80emu with your progs
  172. Z80IFACE ASM      4129 12-02-92   9:27p | to use z80emu with your progs
  173.  
  174. ZSIM     DOC     42405 12-04-92  12:31p
  175. ZSIM     EXE     16133 12-03-92   5:48p
  176.  
  177.  
  178. READ     ME                             | the file you're reading
  179.  
  180.  
  181. RAMDISC.CPM and RAMDISC.SMC are sample ramdiscs that contain
  182. Ron Cain's Small C Compiler, the VDE editor and the PPIP and SWEEP
  183. file copy programs.
  184. 8080EMU.OBJ contains a version of the cpu emulator that understands
  185. only 8080 code but runs a bit faster as it needn't worry about some
  186. of the Z80's intricacies. (But programs that require a Z80 won't run
  187. e.g. SUPERDOS.)
  188. If you want to use Z80DOS instead of SUPERDOS simply copy Z80DOS.SYS
  189. to CPMSYS.CPM.
  190.  
  191. I got SUPERDOS, Z80DOS and ZCPR from the SIMTEL20 [192.88.110.20] ftp
  192. server (directory PD2:<CPM.xxx> xxx=BDOS,ZCPR). It contains a lot of
  193. other CP/M software too.
  194.  
  195.  
  196. HAVE FUN using ZSIM!
  197.  
  198. Jürgen G. Weber
  199.