home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d165 / cpm.lha / CPM / Readme < prev    next >
Text File  |  1988-11-22  |  4KB  |  150 lines
  1.               A CP/M emulator for the Amiga
  2.  
  3. Release one : 3 - October - 1988
  4.  
  5. (C) Copyright By Ulf Nordquist.
  6.  
  7. This software package emulates a CPM computer with a Z80 processor connected
  8. to an ADM3A terminal.
  9.  
  10. This software may only be used for non-commercial purposes, but may be freely
  11. distributed as long as all the files in the package is kept together.
  12.  
  13. The package consists of these files:
  14.  
  15. The source code:
  16. cz.a (the main module)
  17. ce.a,(the bios, bdos and terminal emulator)
  18. zek.a, zekcb.a, zekdd.a, zeked.a (the Z80 emulator)
  19.  
  20. The link command file:
  21. LinkCPM
  22. This file:
  23. Readme
  24.  
  25.                  How to use it
  26.                  -------------
  27.  
  28. Before you start the emulator, assign a: to the directory where the cpm
  29. files are.
  30.  
  31. [ Ed. Note: i.e. assuming undisturbed use of this disk:
  32.    1> Assign a: AmigaLibdisk165:CPM/DriveA      
  33.  -Fred ><> ]
  34.  
  35. The program has four menues:
  36.  
  37. Menu Project
  38.  
  39.    About
  40.       This gives the expected result
  41.  
  42.    Version
  43.       List the version number for the modules and the task address
  44.  
  45.    Quit
  46.       This also gives the expected result
  47.  
  48. Menu Windows
  49.  
  50.    Z80 processor
  51.       Opens a window which shows the Z80 registers. It also has three
  52.       gadgets: Step - Stop/Run - Reset
  53.      Step:    Executes the next instruction, the Z80 must be stopped
  54.         for this to work
  55.      Stop:    Stops the Z80 processor, the gadget then changes to a
  56.         Run gadget
  57.      Reset: Exit to the A> prompt
  58.  
  59. Terminal
  60.  
  61.    Trap Esc Seq
  62.       Gives a requester when the terminal emulator finds an undefined
  63.       escape sequence sent to it, normally such escape sequences are
  64.       ignored
  65.  
  66.    Log to File
  67.       Asks for a file name. Opens this file and logs all activity in
  68.       the console window to it
  69.  
  70. Debug
  71.  
  72.    Count
  73.       Increments a counter for each Z80 instruction as it is emulated,
  74.       and for each BDOS and BIOS call. Max count is 255.
  75.  
  76.    Save Count
  77.       Asks for a file name. Writes the count result so far as a binary
  78.       image to it. This file is organized as this:
  79.       byte $00 - $ff - one byte opcodes
  80.       byte $100-$1ff - $cb two byte opcodes
  81.       byte $200-$2ff - $dd two byte opcodes
  82.       byte $300-$3ff - $ed two byte opcodes
  83.       byte $400-$4ff - $fd two byte opcodes
  84.       byte $500-$57f - BDOS calls
  85.       byte $580-$5ff - BIOS calls
  86.       Note. This is a binary file. To be able to look at it by an editor,
  87.       convert it to hex format by using opt h with type.
  88.      Example: type >file cpm.count opt h
  89.  
  90.    Trace
  91.       Asks for a file name. Writes the address in hex for each instruction
  92.       as it is emulated to it.
  93.  
  94. Apart from these menues, the program is used as any CP/M computer
  95.  
  96.          Programs the emulator has been tested with
  97.          ------------------------------------------
  98.  
  99.            --- First the programs that works ---
  100.  
  101. D - seems to work alright
  102.  
  103. M80, L80 - seems to work alright
  104.  
  105.    I have assembled and linked the program SPIRAL.MAC and ASMTEST.MAC
  106.  
  107. ZSID - seems to work alright
  108.  
  109.    I have used ZSID to try to find why MBasic, WordStar and TurboPascal
  110.    did not work.
  111.  
  112. MBasic - seems to work alright
  113.  
  114.    I have run the program SUPTRK3.BAS
  115.  
  116. WordStar - I have some problems with this
  117.    WordStar is unable to find the end of files, it just ignores if bdos20
  118.    (read sequential) returns $ff as end of file flag
  119.  
  120. TurboPascal - here are also some problems
  121.    Compile to disk does not work, it says that the disk is full (which it
  122.    is not)
  123.  
  124.    However I have edited, compiled to memory and run the file TEST.PAS
  125.  
  126.         --- Now for the program that do not work ---
  127.  
  128. PIP - copy from CON: to a file works, but copy from file to file does not
  129.    work either it gives a disk write or a disk read error
  130.  
  131. SUBMIT - nothing happens, just a little disk activity
  132.  
  133. XSUB - it just says: Xsub Already Present
  134.  
  135. ============================================================================
  136.  
  137. Thanks to:
  138. Matt Dillon for the editor
  139. Charlie Gibbs for the assembler
  140. Metadigm, Inc. for the debugger
  141. Commodore-Amiga, Inc. for the computer
  142.  
  143. Comments and bug reports are welcome:
  144.  
  145.        Ulf Nordquist
  146.        Brunnehagen 36
  147.        417 47 Gothenburg
  148.        Sweden
  149.  
  150.