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 (claudiochuug.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

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
-rw-rw-r-- 20025/206      2666    7499  35.6% -lh5- 77ad              AmigaComm.source
-rw-rw-r-- 20025/206     14159   32972  42.9% -lh5- e249              Apple
-rw-rw-r-- 20025/206       213     422  50.5% -lh5- ccc6              Apple.info
-rw-rw-r-- 20025/206     10605   20272  52.3% -lh5- d64a              AppleComm
-rw-rw-r-- 20025/206       210     422  49.8% -lh5- 6c66              AppleComm.info
-rw-rw-r-- 20025/206       144     219  65.8% -lh5- f13b              Bugs
-rw-rw-r-- 20025/206       227     469  48.4% -lh5- 0ee4              Bugs.info
-rw-rw-r-- 20025/206      2288    5568  41.1% -lh5- 79d3              Readme
-rw-rw-r-- 20025/206       227     469  48.4% -lh5- e660              Readme.info
-rw-rw-r-- 20025/206       168     287  58.5% -lh5- d13a              TODO
-rw-rw-r-- 20025/206       230     469  49.0% -lh5- ed77              TODO.info
drwxrwxr-x 20025/206         0       0 ****** -lhd- 0000 Jun  5  1994 txt/
-rw-rw-r-- 20025/206       155     283  54.8% -lh5- fb5c              txt/ACASLReq.def
-rw-rw-r-- 20025/206       228     469  48.6% -lh5- 5142              txt/ACASLReq.def.info
-rw-rw-r-- 20025/206      1115    3183  35.0% -lh5- 735f              txt/ACASLReq.mod
-rw-rw-r-- 20025/206       230     469  49.0% -lh5- 3d29              txt/ACASLReq.mod.info
-rw-rw-r-- 20025/206        83      95  87.4% -lh5- e814              txt/ACGadgets.def
-rw-rw-r-- 20025/206       227     469  48.4% -lh5- 720e              txt/ACGadgets.def.info
-rw-rw-r-- 20025/206       701    2495  28.1% -lh5- 7ff9              txt/ACGadgets.mod
-rw-rw-r-- 20025/206       226     469  48.2% -lh5- 2309              txt/ACGadgets.mod.info
-rw-rw-r-- 20025/206      8312   46458  17.9% -lh5- c4a5              txt/Apple.mod
-rw-rw-r-- 20025/206       231     469  49.3% -lh5- 5b4d              txt/Apple.mod.info
-rw-rw-r-- 20025/206      6485   22531  28.8% -lh5- edf9              txt/AppleComm.mod
-rw-rw-r-- 20025/206       228     469  48.6% -lh5- fd44              txt/AppleComm.mod.info
-rw-rw-r-- 20025/206       275     506  54.3% -lh5- cc75              txt/AppleScreen.def
-rw-rw-r-- 20025/206       232     469  49.5% -lh5- 410a              txt/AppleScreen.def.info
-rw-rw-r-- 20025/206      3701   13372  27.7% -lh5- 0329              txt/AppleScreen.mod
-rw-rw-r-- 20025/206       230     469  49.0% -lh5- c3f0              txt/AppleScreen.mod.info
-rw-rw-r-- 20025/206       311     463  67.2% -lh5- dbdc              txt/Base37.def
-rw-rw-r-- 20025/206       228     469  48.6% -lh5- b2bd              txt/Base37.def.info
-rw-rw-r-- 20025/206       224     393  57.0% -lh5- ae8c              txt/Base37.mod
-rw-rw-r-- 20025/206       228     469  48.6% -lh5- eef6              txt/Base37.mod.info
-rw-rw-r-- 20025/206       277     628  44.1% -lh5- ebdd              txt.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        33 files   55064  164165  33.5%            Jan 12  1993