home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / emulator / applem / readme < prev    next >
Text File  |  1995-02-27  |  4KB  |  73 lines
  1. July 6, 1992
  2.  
  3.                     Apple Emulator, DEMO version
  4.                            By Greg Dunlap
  5.  
  6.     This program emulates an Apple ][+;  it supports all of the display
  7. modes of an Apple ][+ - Primary and Secondary pages of Text, Hires, Lores,
  8. and Mixed; sound, joystick, and Language Card.  It does all this while also
  9. being completely multitasking! (It runs at a priority of -1)
  10.     If you have a 68000, run "AppleM000".  If you have anything else, run
  11. "AppleM0x0".
  12.     To run this program you need to have a file in the current directory
  13. called "AppleROM" - this is an image of the Apple ][ ROM.  If you have an
  14. Apple ][ or ][+ you can save an image of the ROM by booting DOS and typing:
  15.      "BSAVE APPLEROM, A$D000, L$2000"
  16. and then transferring the file  to the Amiga via a serial cable.
  17.      THE APPLE //E AND //C ROMS WILL NOT WORK!  This is because this version
  18. of the emulator doesn't support the extra firmware bankswitching present on
  19. those systems; such emulation is forthcoming.
  20.     The emulator DOES emulate a Language Card, so that when disk support is
  21. provided programs that live in this area (such as assemblers, UCSD Pascal, etc)
  22. will work.
  23.     A joystick is emulated via the mouse and a digital joystick in Port 2.
  24. POT's 1 and 2 are MouseX and MouseY;  POT's 3 and 4 are the joystick up/down
  25. and left/right.  Pushbutton 1 is the left mousebutton, Pushbutton 2 is the
  26. right one, and Pushbutton 3 is joystick fire.  In the future this will all
  27. be configurable.
  28.     Although this is primarily an Apple ][+ emulator, it does have a few
  29. enhancements: lowercase text is displayed and the 65C02 instruction set is
  30. emulated.
  31.     You will notice four gadgets at the top of the screen:
  32.  
  33.     QUIT - self explanatory.
  34.     RESET - Same as CTRL-RESET on the Apple ][.
  35.     COLD - Does a cold reset - same as CTRL-OPENAPPLE-RESET on a //e, but
  36.            without the memory corruption.
  37.     FREEZE - Suspends the emulator in order to free the CPU to lower-pri tasks.
  38.  
  39.     Clicking the right mouse button at the top of the screen will switch
  40. between the row of gadgets and a screen drag bar.
  41.  
  42.     This is a demo version because there is no disk support, nor is there
  43. support for a printer or modem; these are forthcoming.  As an extra bonus,
  44. however, if you happen to have a 23937-byte file called "BOLO" in the current
  45. directory, it will be loaded into "Apple memory" at $1100.  This is the
  46. file "BOLO.BINARY" on the BOLO disk.
  47.     This program has been tested on my Amiga 500 (68010, 1Meg CHIP, 2Meg FAST),
  48. an Amiga 2500/30, an Amiga 3000, a stock Amiga 500, and a stock Amiga 1000.
  49. It will run under Kickstarts 1.2, 1.3, and 2.0 (it may also run under 1.1 if
  50. anyone cares enough to try it).
  51.  
  52. BUGS:
  53.     If you run another program that uses sound on Voice 1 and turns the
  54. volume off when done, the speaker will no longer click.  This is because I
  55. cheated on the sound code by going directly to the hardware to click the
  56. speaker; other programs that use sound aren't bothered by this.
  57.     If you have another screen (Workbench, say) in front of the emulator's
  58. and you drag it down, if the emulator is in a display mode other than
  59. Primary Text then at certain points of dragging the screen in front will
  60. appear munged.  This is an artifact of the copper lists I use to render the
  61. display, and is COMPLETELY HARMLESS.
  62.  
  63.     I have not tested the sound on a machine faster than mine, because the
  64. sound was never hooked up on the A3000 and the A2500/30.  I'd like to know how
  65. it sounds.  Also, if anyone cares to try this on an '040 I'd love to hear about
  66. it!
  67.  
  68.     Please send any bug reports or cool ideas to:
  69.     gdunlap.ecst.csuchico.edu
  70.  
  71. - Greg Dunlap
  72. - CSUChico
  73.