home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / EXTRA-ST / CPM-80-E / CPM-0.2 / CPM-0 / cpm-0.2 / README < prev    next >
Encoding:
Text File  |  1994-06-06  |  3.2 KB  |  106 lines
  1. %
  2. %  Time-stamp: <06/06/94 23:08:26 Michael Bischoff moulder>
  3. %
  4. % CP/M emulator README
  5. %
  6.  
  7. Introduction:
  8. =============
  9.  
  10. Type 'UNIX' at the CCP prompt to leave the emulator.
  11. (Or ctrl-@, followed by 'q' any time the keyboard is polled)
  12.  
  13.  
  14. WARNING! This software runs only on 386 compatible processors
  15. and systems which allow nonaligned word/dword memory access.
  16.  
  17. WARNING! This software has no documentation. If you want to use it, you're
  18. probably a Real Programmer; and Real Programmers don't read documentation.
  19.  
  20. WARNING! This software is supplied AS IS. There is No Warranty!
  21.  
  22. The software emulates an Intel 8080 CPU (quite accurate,
  23. except for the halfcarry flag for a couple of instructions)
  24. and a lot of Zilog Z80 instructions (not the complete set).
  25. Unimplemented instructions are input/output commands (IN A,(nn); OUT (nn),A;
  26.   INI, OUTI, INIR, OTIR, IND, OUTD, INDR, OTDR, IN C,(r), OUT r,(C)), and
  27. interrupt mode commands (IM 0, IM 1, IM 2, RETN, RETI), and the refresh
  28. register doesn't count at all.
  29.  
  30. A 486DX2-66 emulates a Z80 clocked at 22 MHz, a 386DX-33 simulates a 6MHz
  31. Z80. (approximately)
  32.  
  33.  
  34. The BDOS emulator does only provide
  35. - user 0
  36. - a single drive (A:)
  37. - access to lowercase-files.
  38.  
  39. A CCP-lookalike command interpreter is provided and the BDOS
  40. is emulated. The CCP is stored in the file /usr/local/lib/cpm/cpm.sys.
  41. Any CP/M .COM-files may also go in the directory /usr/local/lib/cpm.
  42.  
  43. If you have an original CP/M, with CCP-address e800, BDOS-address f006,
  44. and put it in the file /usr/local/lib/cpm/cpm.sys, you can have an
  45. emulator quite near to the original thing, using the -e option.
  46. The -e option tells the emulator to use the BDOS from cpm.sys,
  47. instead of catching the BDOS-calls.
  48. Pros:
  49. - a real CP/M running
  50. - access to CP/M-formatted floppies (you have to set the DPB correctly)
  51.   Try "cpm -e -i /dev/fd1" with a 800 KB CP/M floppy in B:
  52.      (bls = 2K, drm = 255)
  53.   after setting setfdprm -p /dev/fd1 800/1200 or the like.
  54.  
  55. Cons:
  56. - no access to the Linux filesystem
  57.  
  58.  
  59. About the emulator:
  60. ===================
  61.  
  62. Type "cpm -h" for a short usage message.
  63. You can interrupt the emulator by typing ctrl-@. This will enter
  64. the debug mode, where you can disassemble z80 memory, dump memory,
  65. edit data, set listpoints, breakpoints, set counts for breakpoints
  66. and the like. Type '?' for a short summary.
  67.  
  68.  
  69. extensions:
  70. BDOS:
  71.  there is a new BDOS function (41), "change directory"
  72.  and a CP/M program CD.COM which calls this function.
  73.  
  74. CCP:
  75.  ERA understands the /Q option (question!)
  76.  Example: ERA *.*/Q
  77.  TYPE understands the /W option (wait!)
  78.  Example: TYPE TEST.TXT/W
  79.  You can access files from other user numbers (image mode only)
  80.  Example: ERA *.BAS/2
  81.  
  82.  Again: Type UNIX to leave the Emulator.
  83.  
  84.  
  85.  
  86. TODO:
  87. =====
  88. - Improve the emulation of BDOS
  89. - Allow multiple drives (some as CP/M filesystem images?)
  90. - implement interrupt modes / signal catching to simulate NMI, INT
  91. - improve the accuracy of the emulator (but; after all, a Z80 isn't
  92.   8080-compatible as well; the sequence
  93.     XOR A
  94.     DEC A
  95.     JP PO,Z80_installed
  96.     /* an 8080, if we are here */
  97.   will find out...
  98. - merge the code with xtrs-80, to play GALAXY again!
  99.  
  100.  
  101. BUGS:
  102. =====
  103.  
  104. Surely there are LOTS of bugs. Please send fixes to mbi@mo.math.nat.tu-bs.de
  105. Bug reports (without fixes) are also accepted, but it would be nice if you
  106. could track down the bad opcode.