home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 2 / 2562 / readme < prev   
Text File  |  1991-01-22  |  2KB  |  47 lines
  1. This is a quick overview of my CP/M emulator for Unix.  I apologize if
  2. it isn't completely up to date as the program is still evolving.
  3.  
  4. The system decodes most of the Z80 instruction set.  mostly the I/O is
  5. not implemented.  Whenever the PC is >= 0xfec0 it executes a return no
  6. matter what is in RAM at that location.  Before calling the routine for
  7. each instruction I look at the PC and end the program if it is zero or
  8. perform a BDOS function if it is 0xfec0 or BIOS if it is >= 0xff00.  Since
  9. the emulator ignores the contents of memory as far as instruction decoding
  10. is concerned, The system has the interesting property of being able to use
  11. all of memory except the first 0x100 bytes for user programs by putting the
  12. stack at 0xfffe.  In fact the default stack when a program is run is set
  13. to 0xfff0.
  14.  
  15. I use Unix commands to simulate some CP/M commands such as DIR, REN, TYPE
  16. and handle things such as SAVE internally.  I use the Unix file system for
  17. drives.  The user defines Unix directories to CP/M drive mappings.  This
  18. allows CP/M to use the same file system as the Unix but does force CP/M
  19. conventions on the file names such as upper case, must have 1 and only 1
  20. period, etc.  It is easy to handle though since one can always link files
  21. as necessary, even from CP/M since I also include a '!' command to do Unix
  22. commands from within CP/M.
  23.  
  24. Programs that use IN and OUT opcodes will fail.  All I/O must go through
  25. the BDOS or the BIOS.  The user can set up the following devices:  Screen
  26. (CON out), keyboard (CON in), RDR, PUN and LST.  The default for screen
  27. and keyboard is stdout and stdin.  The user can set up Unix files for any
  28. of these devices.  The file of course can be an actual file, a device or even
  29. a pipe to a command, even another CP/M command that has the keyboard reading
  30. from the same pipe.
  31.  
  32. Mostly I tried for speed except where speedup would depend on the program
  33. running on a specific processor.  The main part of the decoding module is
  34. a 256 entry switch table with sub-switches for the Z80 extensions.
  35.  
  36. It's not quite finished yet but I am running simple programs with it now.
  37. What would be nice would be some sort of test suite.  Anyone know of any?
  38.  
  39. As for copyright, if you use it say where you got it and send me any fixes
  40. or enhancements if you feel like it.  It's free and you get what you pay
  41. for.  Don't blame me if it breaks anything or doesn't do what you expect.
  42. (In case it isn't obvious I am not a lia^H^Hawyer.)
  43.  
  44. D'Arcy J.M. Cain
  45. UUCP: darcy@druid
  46.  
  47.