Short: Apple 2 emulator written in Modula-2

                          Apple 2 Emulator
                          ~~~~~~~~~~~~~~~~
      (written and put into the public domain by Claudio Nieder)

Version 0.1, 03-Jan-1993
~~~~~~~~~~~~~~~~~~~~~~~~
This is the first version of an Apple 2 emulator I'm writing.

Although this is a alpha test version, it is quite stable. It doesn't
produce any enforcer or mungwall hits. It doesn't loose memory.

The emulator is written in Modula-2 and was compiled with M2Amiga V4.1.

What you need
~~~~~~~~~~~~~
You should have a fast Amiga. I am using it on a 25MHz Amiga 3000.

You should have at least 0.5 MByte contiguous memory free, when
loading the emulator.

You should have at least Workbench 2.04.

You should have an Apple 2 from which you can transfer the ROMs and the
contents of your Apple 2 floppies to the Amiga.

You need a cable to connect the annunciator ouput port 0 (AN0 on the game
paddle connector) to the receive data input of the Amiga serial port.

You need a way, to transfer the audio output from the Amiga to the Apple 2.
This can be either done, by first recording the output of the Amiga on a
tape, and then playback it to the Apple, or by a direct cable. I have tried
the first method only, using two different tape recorders, so I didn't need
to get a special cable.

What it does
~~~~~~~~~~~~
Currently it emulates an 48K Apple 2 with two disk drives. Only the text
page can be displayed until now.

It runs BASIC programs at about 1/10 the speed of an original Apple 2.
Disk access can be as slow as 1/60 of an original Apple 2. So you have to
be patient when booting. This may take 5-6 minutes.

The disk drives are also emulated, i.e. you don't connect directly your
Apple 2 disk drives to the Amiga. You can use your Apple 2 to tranfer the
contents of a floppy to the Amiga. On the Amiga you can use the floppy
for reading and writeing, but at the moment it is not possible to save
back a floppy.



Bugs & Questions
~~~~~~~~~~~~~~~~
If you have any bugs to report or questions to ask:

Before March 1, 1993, you can send me mail (claudio@chuug.ch).

After March 1, 1993, you should ftp the newest AppleOnAmiga.readme
from ftp.eunet.ch [146.228.10.15] to see, if the program was updated.

			claudio


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    7499    2666 64.4% 31-Dec-97 18:00:00  AmigaComm.source
   32972   14159 57.0% 31-Dec-97 18:00:00  Apple
     422     213 49.5% 31-Dec-97 18:00:00  Apple.info
   20272   10605 47.6% 31-Dec-97 18:00:00  AppleComm
     422     210 50.2% 31-Dec-97 18:00:00  AppleComm.info
     219     144 34.2% 31-Dec-97 18:00:00  Bugs
     469     227 51.5% 31-Dec-97 18:00:00  Bugs.info
    5568    2288 58.9% 31-Dec-97 18:00:00  Readme
     469     227 51.5% 31-Dec-97 18:00:00  Readme.info
     287     168 41.4% 31-Dec-97 18:00:00  TODO
     469     230 50.9% 31-Dec-97 18:00:00  TODO.info
       0       0  0.0% 05-Jun-94 09:06:58  txt/
     283     155 45.2% 31-Dec-97 18:00:00  txt/ACASLReq.def
     469     228 51.3% 31-Dec-97 18:00:00  txt/ACASLReq.def.info
    3183    1115 64.9% 31-Dec-97 18:00:00  txt/ACASLReq.mod
     469     230 50.9% 31-Dec-97 18:00:00  txt/ACASLReq.mod.info
      95      83 12.6% 31-Dec-97 18:00:00  txt/ACGadgets.def
     469     227 51.5% 31-Dec-97 18:00:00  txt/ACGadgets.def.info
    2495     701 71.9% 31-Dec-97 18:00:00  txt/ACGadgets.mod
     469     226 51.8% 31-Dec-97 18:00:00  txt/ACGadgets.mod.info
   46458    8312 82.1% 31-Dec-97 18:00:00  txt/Apple.mod
     469     231 50.7% 31-Dec-97 18:00:00  txt/Apple.mod.info
   22531    6485 71.2% 31-Dec-97 18:00:00  txt/AppleComm.mod
     469     228 51.3% 31-Dec-97 18:00:00  txt/AppleComm.mod.info
     506     275 45.6% 31-Dec-97 18:00:00  txt/AppleScreen.def
     469     232 50.5% 31-Dec-97 18:00:00  txt/AppleScreen.def.info
   13372    3701 72.3% 31-Dec-97 18:00:00  txt/AppleScreen.mod
     469     230 50.9% 31-Dec-97 18:00:00  txt/AppleScreen.mod.info
     463     311 32.8% 31-Dec-97 18:00:00  txt/Base37.def
     469     228 51.3% 31-Dec-97 18:00:00  txt/Base37.def.info
     393     224 43.0% 31-Dec-97 18:00:00  txt/Base37.mod
     469     228 51.3% 31-Dec-97 18:00:00  txt/Base37.mod.info
     628     277 55.8% 31-Dec-97 18:00:00  txt.info
-------- ------- ----- --------- --------
  164165   55064 66.4% 12-Jan-93 14:44:34   33 files
