home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / emulate / appleona.zoo / Readme < prev    next >
Text File  |  1993-01-04  |  6KB  |  160 lines
  1.                           Apple 2 Emulator
  2.                           ~~~~~~~~~~~~~~~~
  3.       (written and put into the public domain by Claudio Nieder)
  4.  
  5. Version 0.1, 03-Jan-1993
  6. ~~~~~~~~~~~~~~~~~~~~~~~~
  7. This is the first version of an Apple 2 emulator I'm writing.
  8.  
  9. Although this is a alpha test version, it is quite stable. It doesn't
  10. produce any enforcer or mungwall hits. It doesn't loose memory.
  11.  
  12. The emulator is written in Modula-2 and was compiled with M2Amiga V4.1.
  13.  
  14. What you need
  15. ~~~~~~~~~~~~~
  16. You should have a fast Amiga. I am using it on a 25MHz Amiga 3000.
  17.  
  18. You should have at least 0.5 MByte contiguous memory free, when
  19. loading the emulator.
  20.  
  21. You should have at least Workbench 2.04.
  22.  
  23. You should have an Apple 2 from which you can transfer the ROMs and the
  24. contents of your Apple 2 floppies to the Amiga.
  25.  
  26. You need a cable to connect the annunciator ouput port 0 (AN0 on the game
  27. paddle connector) to the receive data input of the Amiga serial port.
  28.  
  29. You need a way, to transfer the audio output from the Amiga to the Apple 2.
  30. This can be either done, by first recording the output of the Amiga on a
  31. tape, and then playback it to the Apple, or by a direct cable. I have tried
  32. the first method only, using two different tape recorders, so I didn't need
  33. to get a special cable.
  34.  
  35. What it does
  36. ~~~~~~~~~~~~
  37. Currently it emulates an 48K Apple 2 with two disk drives. Only the text
  38. page can be displayed until now.
  39.  
  40. It runs BASIC programs at about 1/10 the speed of an original Apple 2.
  41. Disk access can be as slow as 1/60 of an original Apple 2. So you have to
  42. be patient when booting. This may take 5-6 minutes.
  43.  
  44. The disk drives are also emulated, i.e. you don't connect directly your
  45. Apple 2 disk drives to the Amiga. You can use your Apple 2 to tranfer the
  46. contents of a floppy to the Amiga. On the Amiga you can use the floppy
  47. for reading and writeing, but at the moment it is not possible to save
  48. back a floppy.
  49.  
  50. Setup
  51. ~~~~~
  52. First unpack the archive, if you haven't already done it. The archive
  53. should contain these files:
  54.  
  55.     Apple
  56.     Apple.info
  57.     AppleComm
  58.     AppleComm.info
  59.     Readme
  60.     Readme.info
  61.     Bugs
  62.     Bugs.info
  63.     TODO
  64.     TODO.info
  65.     AmigaComm.source
  66.     txt.info
  67.     txt/Apple.mod
  68.     txt/Apple.mod.info
  69.     txt/AppleComm.mod
  70.     txt/AppleComm.mod.info
  71.     txt/AppleScreen.def
  72.     txt/AppleScreen.def.info
  73.     txt/AppleScreen.mod
  74.     txt/AppleScreen.mod.info
  75.     txt/ACASLReq.def
  76.     txt/ACASLReq.def.info
  77.     txt/ACASLReq.mod
  78.     txt/ACASLReq.mod.info
  79.     txt/ACGadgets.def
  80.     txt/ACGadgets.def.info
  81.     txt/ACGadgets.mod
  82.     txt/ACGadgets.mod.info
  83.     txt/Base37.def
  84.     txt/Base37.def.info
  85.     txt/Base37.mod
  86.     txt/Base37.mod.info
  87.  
  88. The programs you need are Apple and AppleComm, which should be placed in
  89. the same directory. Bugs and TODO are text files. The directory txt/
  90. contains the source of the Apple 2 emulator. The file AmigaComm.source
  91. contains the assembler source for the Apple 2 program which can send
  92. Disks and ROM contents from the Apple to the Amiga.
  93.  
  94. As a first step, we have to bring the program AmigaComm onto the Apple.
  95. Connect a tape recorder to the Amiga audio output. Start the program
  96. AppleComm on the Amiga. Start the recorder, and click on the "Send AmigaComm"
  97. gadget. When the status line "Sending AmigaComm(31xxx)" disappears, you can
  98. halt the tape recorder.
  99.  
  100. Now connect a tape recorder to the Apple 2. On the Apple enter the monitor
  101. (CALL -151) and type 8000.8586R. Play back the recording you have just
  102. made.
  103.  
  104. When playback is finished, you have the program "AmigaComm" on the
  105. Apple 2. This program allows you to send the contents of the needed ROMs
  106. and the contents of floppies to the Amiga. You should save the
  107. Program to a floppy with
  108.  
  109.     BSAVE AMIGACOMM,A$8000,L$587
  110.  
  111. so you can use it later.
  112.  
  113. As next step you need to transfer the contents of the BASIC ROM and of the
  114. PROM on the disk controller. For this you need to connect the annunciator
  115. output 0 to the Amiga serial port receive data line. You have to start
  116. the AppleComm program on the Amiga, and the AMIGACOMM program on the
  117. Apple. Click on the "Receive ROM" gadget on the Amiga, and press the
  118. "R" key on the Apple. This will transfer the two ROM contents, and save
  119. them in the appropriate files.
  120.  
  121. If you want run programs you already have on Apple 2 floppies, the you
  122. can tranfser them too, using AppleComm/AmigaComm. Click on the "Receive
  123. Disk" gadget on the Amiga, and after that press "D" on the Apple. After
  124. the transfer of the disk, a requester will ask you for a name, on which
  125. the disk contents shall be stored. Each floppy will currently use
  126. approx. 230kByte. Future version of this emulator will probably
  127. store those files in a compressed form.
  128.  
  129. Some explanation to the program Apple
  130. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131. Menu
  132. ~~~~
  133. The Project menu contains only the function Quit. As I'm still debugging
  134. this program, this function will not immediately terminate the emulator,
  135. but pop up a requester. Click on the gadget "abbrechen" to terminate the
  136. emulator.
  137.  
  138. The Disk1 and Disk2 menus are identical. They provide functions for loading
  139. a disk, unloading a disk, and write protecting a disk.
  140.  
  141. NOTE: Unloading does not save back the diskette on the file. So at the
  142. moment you can't keep changes you've made.
  143.  
  144. Keyboard
  145. ~~~~~~~~
  146. The only special key of the Apple 2 is the RESET key. On the Amiga
  147. you have to press HELP.
  148.  
  149.  
  150. Bugs & Questions
  151. ~~~~~~~~~~~~~~~~
  152. If you have any bugs to report or questions to ask:
  153.  
  154. Before March 1, 1993, you can send me mail (claudio@chuug.ch).
  155.  
  156. After March 1, 1993, you should ftp the newest AppleOnAmiga.readme
  157. from ftp.eunet.ch [146.228.10.15] to see, if the program was updated.
  158.  
  159.             claudio
  160.