home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk1.iso / answers / emulate-apple2-faq < prev    next >
Text File  |  1993-11-17  |  26KB  |  588 lines
  1. Newsgroups: alt.emulators.ibmpc.apple2,alt.answers,news.answers
  2. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!spool.mu.edu!agate!headwall.Stanford.EDU!nntp.Stanford.EDU!news
  3. From: vera@anna.stanford.edu (James Vera)
  4. Subject: alt.emulators.ibmpc.apple2 Frequently Asked Questions (FAQ)
  5. Message-ID: <a.e.i.a_753534001@wilbur.stanford.edu>
  6. Followup-To: alt.emulators.ibmpc.apple2
  7. Summary: This posting contains a list of Frequently Asked Questions
  8.          (and their answers) about emulating Apple ][ computers (or //e
  9.          ...) on other computers (like PCs or UNIX boxes).  Please
  10.          read before posting questions.
  11. Sender: news@leland.Stanford.EDU (Mr News)
  12. Supersedes: <a.e.i.a_750852001@wilbur.stanford.edu>
  13. Reply-To: vera@anna.stanford.edu
  14. Organization: Stanford University
  15. Date: Wed, 17 Nov 93 10:59:55 GMT
  16. Approved: news-answers-request@MIT.Edu
  17. Lines: 568
  18. Xref: senator-bedfellow.mit.edu alt.emulators.ibmpc.apple2:584 alt.answers:1249 news.answers:14810
  19.  
  20. Archive-name: emulate-apple2-faq
  21. Version: 2.1.2
  22.  
  23. FAQ for alt.emulators.ibmpc.apple2
  24. by James Vera (vera@anna.stanford.edu)
  25. and Tom Baker (tombaker@world.std.com).
  26. Corrections/suggestions gratefully accepted.
  27. Last Modified: 11/11/93
  28.  
  29. Note: all mentions of the machine wilbur are referring to
  30. wilbur.stanford.edu (36.14.0.36).
  31. For our European colleagues, see ftp.uni-kl.de under the directory
  32. /pub/apple2
  33.  
  34.  
  35. Index:
  36.  Part 1, Q&A
  37.    1) What's the deal?
  38.    2) What's the difference between apl2em and applemu?
  39.    3) Where can I get an emulator?
  40.    4) I got .zip files off of wilbur but they're corrupted.
  41.    5) I got apl2em but when I try to run it I get a complaint about
  42.       APPLE.ROM  missing or some such?  Why did the idiot running
  43.       wilbur not include that file?
  44.    6) I have apl2em but I don't have the serial ROM.  What can I do?
  45.    7) How can I get apl2em to print to my printer?
  46.    8) OK, I got an emulator and it runs, now what?
  47.    9) Where can I find an image of foobar (where foobar is my favorite 
  48.       old Apple ][ game).
  49.   10) I have an Apple ][ and a bunch of disks (or for that matter, ROM
  50.       files) I want to transfer over to use on the emulator.  How do I
  51.       do it? 
  52.   11) Can't I just put my Apple disk into my PC and have some magic
  53.       happen?
  54.   12) What about all the freeware/shareware programs available on the 
  55.       net?
  56.   13) Um, what were all those disk image formats again and how do I move
  57.       between them?
  58.   14) Gee, can't I just buy an Apple II Emulator somewhere?
  59.   15) Nifty keen, how can I help?
  60.   16) Hey, I want to talk about "Building Emulators", not
  61.       using them.  Where should I go?
  62.  
  63.  Part 2, Database of emulators
  64.  Part 3, Database of disk images
  65.  
  66. ----------------------------------------------------------------------------
  67.  
  68. Part 1, Q&A
  69.  
  70. 1) What's the deal?
  71.  
  72. This group is concerned with emulating an Apple ][ (and in particular
  73. an Apple][+) on PC compatible hardware running DOS (though we've
  74. strayed to just about any hardware/OS).  Two freely available
  75. emulators for PC/DOS exist and are know here as "apl2em" and
  76. "applemu". apl2em was created by Randy Spurlock and its currently at
  77. version 2.  Rumor is a version 3 is available somewhere but who knows?
  78. I don't know who created applemu.
  79.  
  80. 2) What's the difference between apl2em and applemu?
  81.  
  82. apl2em runs on 286s or better, applemu runs on any x86.  apl2em seems
  83. more sophisticated; it can emulate a serial card and a language card
  84. while applemu cannot.  applemu seems be be the choice for those who do
  85. not have a 286 or better machine.
  86.  
  87. (Folks have taken the apl2em assembler source and converted it to run
  88. on 8088/8086 machines; the only change is substituting a bunch of
  89. single-shift instructions in for the 286 multiple shift.  But the
  90. resulting emulator runs too slowly on an 8086).
  91.  
  92. Because of the support for a language card, apl2em can run ProDos
  93. while applemu cannot.  Both emulators boot up into AppleSoft and
  94. take DOS 3.3 disks.
  95.  
  96. Because it is a 64K "machine", apl2em runs INTBASIC by just booting
  97. off the master disk.  applemu cannot do this (under normal operation)
  98. because it is a 48K "machine".  However, the wilbur site has a copy
  99. of INTBASIC, modified over a decade ago to run in 48K.
  100.  
  101. A big plus for applemu over apl2em is that it handles "disk swapping".  You
  102. can boot up on, say, the system master disk, then tell applemu "I am taking
  103. that disk out and putting another disk in the drive".  With apl2em, you
  104. specify what disks are in the drive *before* you start, and you have a
  105. devil of a time changing them while the emulator runs.  (Some folks have
  106. said they can do this, with a multitasking system.  If you run OS/2, or
  107. Desqview, you may find this works.)
  108.  
  109. A *VERY* big plus for applemu over apl2em, however, is that it does not need
  110. any extra files, like ROM files.  It is self-contained, runs on any PC with
  111. most any graphics card, and is up-and-running quickly.
  112.  
  113. 3) Where can I get an emulator?
  114.  
  115. They are available on may ftp sites, but one in particular is
  116. wilbur.stanford.edu in the directory /pub/emulators/apple2.
  117.  
  118. 4) I got .zip files off of wilbur but they're corrupted.
  119.  
  120. No they're not.  At least not on wilbur.  Make sure you use binary
  121. mode in ftp.  And the files were zipped with  info-zip's zip.  Some
  122. [old] versions of pkzip will not be able to unzip them.  A DOS
  123. executable unzip is available on wilbur (and many other places).
  124.  
  125. 5) I got apl2em but when I try to run it I get a complaint about
  126. APPLE.ROM  missing or some such?  Why did the idiot running wilbur not
  127. include that file?
  128.  
  129. Flatly ... That would be against the law.
  130.  
  131. Apl2em requires a copy of the ROMs inside an Apple ][+. ROM
  132. are software on a chip.  That software belongs to Apple and
  133. I don't think they've given permission for it to be freely
  134. distributed.  So its not available for anonymous ftp (at
  135. least not from wilbur).
  136.  
  137. So are you doomed then?  No.  If you own an Apple ][+ then
  138. you own a copy of the ROMs.  Its just a matter of getting
  139. them into a form usable by the emulator.  The doctrine of
  140. "running one copy on one machine" would mean running only
  141. one of the emulator or your apple. Maybe only one at a time
  142. (but I'm not a lawyer, this is not legal advice,...).  So
  143. how to dump the ROMs?  One way is:
  144.  
  145. [from Nye Liu (nyet@cco.caltech.edu)]
  146.  
  147. On your Apple II or II+, Do:
  148. BSAVE SERIAL.BIN, A$C200, L256   (assuming a serial card in slot 2)
  149. BSAVE FLOPPY.BIN, A$C600, L256   (assuming a floppy controller in slot 6)
  150. BSAVE  APPLE.BIN, A$D000, L$3000
  151.  
  152. Note: after doing that you still need to transfer those files to your
  153. PC  (See question 8 below).
  154.  
  155. For 64K machines, you'll have to make sure that the upper memory isn't
  156. bank switched in such a way as to block the ROMs.
  157.  
  158. There's a file on wilbur in /pub/emulators/apple2/dumping-ROMs which
  159. contains some additional tips on this matter.  An easier method is to
  160. depend on the kindness of strangers.  A request to the boards
  161. alt.emulator.ibmpc.apple2 or comp.sys.apple2 of the form:
  162.  
  163.   I own an Apple ][+ and would like to run the emulator but am unable
  164.   to dump the ROMS.  Would someone please send them to me.
  165.  
  166. will probably get you a hit.  Please don't ask me.
  167.  
  168. 6) I have apl2em but I don't have the serial ROM.  What can I do?
  169.  
  170. If you don't have a serial card, don't despair.  Just edit the
  171. build/apple.ini file in the apl2em and change the lines:
  172.  
  173. Type = Serial                           ; Slot 1 is a super serial card
  174. Port = COM1                             ; Use COM1 for super serial port
  175. Baud = 2400                             ; Set baud rate to 1200
  176. Stop = 1                                ; Use 1 stop bit
  177. Length = 8                              ; Word length is 8 bits
  178. Parity = None                           ; No parity generation/checking
  179. Pullup = DCD + DSR + CTS                ; Pull up the DCD/DSR/CTS lines
  180.  
  181. to
  182.  
  183. Type = Empty
  184.  
  185. Or, of course, you could try to get ahold of the serial ROMs.
  186.  
  187. 7) How can I get apl2em to print to my printer?
  188.  
  189. Good question.  I have yet to see an answer though :-(
  190.  
  191. 8) OK, I got an emulator and it runs, now what?
  192.  
  193. Run software, of course.  The emulators can run an "image" of an Apple
  194. diskette.  Think of an image as a single file which contains all of
  195. the information on a disk.  These files typically have the ".DSK"
  196. suffix. As you might imagine, there are many different ways one could
  197. choose to copy a disk to a single file so, of course, the authors of
  198. apl2em and applemu choose two different methods.  An image for apl2em
  199. is 143360 bytes.  Buzzwords for the apl2em format is that its in
  200. Dos3.3 order (DO).  An image for applemu is 232960 bytes.  Buzzwords
  201. for it is that its a nibblized version for the Dos3.3 order (NBO).
  202.  
  203. The disk images stored on wilbur (in /pub/emulators/apple2/DiskImages)
  204. are primarily in the apl2em format.  A program to convert an apl2em
  205. format disk image to an applemu format disk image can be found on
  206. wilbur in /pub/emulators/apple2/em2emu.zip Someone may feel free to
  207. write an program to convert from the applemu format to the apl2em
  208. format.
  209.  
  210. 9) Where can I find an image of foobar (where foobar is my favorite
  211. old Apple ][ game).
  212.  
  213. You can't, at least not from wilbur.  Believe it or not, those games
  214. are still copyrighted and can't be freely distributed.  Some Apple ][
  215. software has been release to the public as part of a project on Genie.
  216. That software has not yet migrated to a form emulator users can get
  217. at. (Hint Hint)
  218.  
  219. 10)  I have an Apple ][ and a bunch of disks (or for that matter, ROM
  220. files) I want to transfer over to use on the emulator.  How do I do
  221. it? 
  222.  
  223. Three files on wilbur: 
  224.     a2pctr11.zip: by Nye Liu (nyet@halycon.com)
  225.     senddisk.zip: by Rich Williamson (glitch@eskimo.com)
  226.     adt100.zip: Apple Disk Transfer 1.00 by Paul Guertin
  227.            (guertinp@iro.umontreal.ca) 
  228. contain strategies and several support programs for doing this.  It
  229. involves a program which runs on the ][ reading the disk and sending
  230. it out on the serial card (you need a serial card) which you then
  231. connected via a null modem to an PC which had a program running on it
  232. to receive the stream and write it to a file.  Yuck.
  233.  
  234. adt100 is derived from senddisk and includes support for transfers
  235. from PCs to ][s as well.
  236.  
  237. Another file diskread.bsc contains a BASIC program by Damon J. Rand
  238. (D.Rand@cantva.canterbury.ac.nu) which runs on an Apple //e and
  239. creates a disk image in the form needed by the emulators.  It has
  240. support for breaking an image into multiple pieces.
  241.  
  242. 11) Can't I just put my Apple disk into my PC and have some magic
  243. happen?
  244.  
  245. No.  They can put a man on the moon but...  The problem, according to
  246. Eric Smith (eric@america.Telebit.COM) and
  247. George Phillips (phillips@cs.ubc.ca) is:
  248.  
  249.    Both drives spin at the same speed and transfer bits at the
  250.    same rate (250 Kbit/s), but use different bit recording
  251.    schemes.  The Apple II uses a GCR channel code, while the
  252.    IBM compatible world uses the more popular MFM coding.
  253.    Standard floppy controller chips (uPD765, 8272, and the
  254.    like) can't read or write GCR.
  255.  
  256.    It is supposed to be possible to use the Copy II Option
  257.    Board from Central Point Software to read and write Apple II
  258.    disks on an IBM compatible, but I haven't got a card to
  259.    test.
  260.  
  261. Out of all the emulator FAQs, this is the most "FA"
  262. (frequently asked).  Everyone who used to use an Apple II
  263. and now uses IBMs has this problem.  And, it seems, when
  264. they first see that there is an "Apple/IBM Emulation Group",
  265. their first post is:
  266.                       Can you make my IBM read my Apple Disks?
  267. and the answer is:
  268.                       No.
  269.  
  270. 12)  What about all the freeware/shareware programs available on the
  271. net?
  272.  
  273. In general, I don't know how to get a get a random program into a form
  274. usable by an emulator.  But some software available on the net is in a
  275. form called a "shrunk disk image".  They usually have the suffix
  276. ".SDK".  If its a shrunk Apple ][ disk, here's how to convert it.
  277.  
  278.   1)Uncompress the .SDK file with nulib (this can the done on DOS or
  279.     UNIX, source for nulib and DOS executables are available on
  280.     wilbur).  This should give you a file whose size is 143360 bytes
  281.     long. If its a different size, say ~800KB, its probably a IIgs disk
  282.     and can't be used by the emulators.  This file is in ProDos order (PO).
  283.   2)If you want an apl2em format (DO) image :
  284.       Run the mapper program (available on wilbur, source and DOS
  285.       executables) on the file you got out of nulib.
  286.     If you want a applemu format (NDO) disk:
  287.       Run em2emu (available on wilbur) on the file you got out of
  288.       nulib..  This will give you a file of 232960 bytes.
  289.  
  290.  
  291. 13) Um, what were all those disk image formats again and how do I move
  292.     between them?
  293.  
  294.   1) Dos3.3 order (DO): 
  295.       First byte is the first byte of the first sector.  The 257th
  296.       byte is the first byte of sector two.  An image in this format
  297.       is 143360 bytes.
  298.  
  299.       APL2EM uses DO images.
  300.   
  301.   2) ProDos order (PO):
  302.       This looks a lot like a DO image, but the sectors are in a
  303.       different order.  When you pack a disk with Shrinkit on the
  304.       Apple, then unpack it with Nulib on a Unix or MsDos system, you
  305.       get this output. An image in this format is 143360 bytes.
  306.  
  307.   3) Nybblized Dos3.3 order (NDO):
  308.       This is a collection of tracks, just the way they look in a
  309.       nybble editor.  Every three bytes of data have been "bit
  310.       twiddled" into four bytes, and each sector has an "address
  311.       field" that has the track and sector numbers.  An image in this
  312.       format is 232960 bytes.
  313.  
  314.   Conversions:
  315.     a) DO to PO
  316.        Run mapper.
  317.     b) PO to DO
  318.        Run mapper.
  319.     c) (DO or PO) to NDO
  320.        Run em2emu.
  321.     d) NDO to (DO or PO)
  322.        Feel free to write it.
  323.  
  324. 14) Gee, can't I just buy an Apple II Emulator somewhere?
  325.  
  326. Yes!  The same folks who wrote "2inaMac" wrote "2inaPC".  It costs about
  327. $150 retail and runs on any PC with a VGA card or better.  Call 
  328.  
  329.   COMPUTER:applications
  330.   12813 Lindeley Drive
  331.   Raleigh, NC  27614
  332.  
  333.   Phone: 919-846-1411,
  334.  
  335. It emulates an Enhanced IIe, and is supposed to run 80 columns (though
  336. I have not seen it).  It seems to take Byte Oriented Disks, *BUT* it
  337. also simulates a hard disk.  The .DSK file used can hold a LOT.
  338.  
  339. Remember, VGA card required.
  340.  
  341.   
  342. 15)  Nifty keen, how can I help?
  343.  
  344. If you have any freely distributable disk images or programs useful in
  345. using the emulators please upload them to wilbur.stanford.edu in the
  346. directory /pub/emulators/apple2/incoming.
  347.  
  348. 16) Hey, I want to talk about "Building Emulators", not
  349. using them.  Where should I go?
  350.  
  351. This group does have emulation developers following it and
  352. starting threads.  Stick around and watch for the really
  353. technical talk.  Most of the developpers mentioned in Part
  354. Three of this FAQ have appeared in the group.
  355.  
  356. Also, the ZaniWok emulation group has a mailing list.  See
  357. ZaniWok in Part Three.
  358.  
  359. ----------------------------------------------------------------------------
  360. Part 2) Database of emulators
  361.  
  362. 1) PC based emulators
  363.  
  364. A. apl2em - The Randy Spurlock II+ emulator  (version 1)
  365.          1. where to get it:       ftp from
  366.                                    wilbur.stanford.edu:/pub/emulators/apple2/apl2em.zip
  367.          2. Author:                Randy Spurlock
  368.          3. Source Code:           ms-dos assembler
  369.          4. memory:   64K (16K language card)
  370.          5. cpu-min:  80286
  371.          6. Serial Support:        No. (There are stubs in the code for
  372.             it, but not implemented.)
  373.          7. Graphics Support:      HGR.
  374.          8. Graphics Required:     CGA or better.
  375.          9. Hercules Support:      With SIMCGA, it runs! (That is one
  376.                                    of the CGA simulators for the "old"
  377.                                    Hercules card.)
  378.         10. Mix Text and Graphics: No. When switched to that mode, the
  379.             text is not displayed.  (One interesting reason for this is
  380.             that it is an Apple capability that the IBM cannnot do,
  381.             directly.)
  382.         11. remarks:  see apl2em-2.
  383.  
  384. B. apl2em-2 The Randy Spurlock ][+ Emulator (Version 2)
  385.          1. where to get it:       ftp from
  386.                                    wilbur.stanford.edu:/pub/emulators/apple2/aple2em-2.zip
  387.          2. Author:                Randy Spurlock
  388.          3. Source Code:           ms-dos assembler
  389.          4. cpu-min:  286, with CGA or better.  Runs with "old" Hercules cards
  390.             with CGA simulators, BUT the graphics modes don't seem to work
  391.             (when I tried it -tb).
  392.          5. memory:   80 K (32K language card)
  393.          6. roms:     serial(c200), disk(c600), lang(d000-ffff)
  394.          7. Image format:          DO
  395.          8. Serial Support:        Yes
  396.          9. Graphics Support:      Yes (Haven't seen it.
  397.                                    Does it do DHR?)
  398.         10. Graphics Required:     CGA or better.
  399.         11. Hercules Support:      NO.
  400.         12. Mix Text and Graphics: ?
  401.         13. remarks:  NO 80 COLUMNS. Runs Prodos (kermitp.dsk)
  402.                       A *big* problem is "disk swapping".  The disks you
  403.                       use at bootup are the ones you must keep.
  404.                       (If you run multi-tasking somehow (Windows or DesqView,
  405.                       for instance), then some folks have ways of swapping
  406.                       the .DSK disk files.)
  407.  
  408. C. applemu - The 48K ][+ Emulator 
  409.          1. where to get it:       ftp from
  410.                                    wilbur.stanford.edu:/pub/emulators/apple2/applemu.zip
  411.          2. Author:                This person did not leave their name
  412.                                    in the documentation or the code!
  413.          3. Source Code:           ms-dos assembler
  414.          4. cpu-min:  8088
  415.          5. memory:   48K (No language card)
  416.          6. roms:     provided.  Two serial roms (for
  417.             file/serial/printer I/O), one converts CRLF <-> CR, the
  418.             other doesn't.
  419.                       There is no "apple.rom" file needed.
  420.          7. Image Format:          NDO
  421.          8. Serial Support:        Yes
  422.          9. Graphics Support:      HGR
  423.         10. Graphics Required:     CGA or better
  424.         11. Hercules Support:      (Scratch head.) My notes say, with a
  425.             CGA simulator, "does not work, boot disk never seems to
  426.             boot.")
  427.         12. Mix Text and Graphics: Yes
  428.         13. remarks:  Truly solid.
  429.  
  430. D. IIinaPC - a commercial product, for $150
  431.          1. where to get it:       Computer Applications, Inc.
  432.          2. Author:                Computer Applications, Inc.
  433.          3. Source Code:           ?
  434.          4. cpu-min:  8088, needs VGA display or better
  435.          5. Serial Support:        Yes
  436.          5. Graphics Support:      HGR (DHR?)
  437.          7. Graphics Required:     VGA or better
  438.          8. Hercules Support:      no
  439.          9. Mix Text and Graphics: ? (imagine so)
  440.         10. remarks:  Costs about $150 retail.  Terribly good looking,
  441.             with lots and lots of support for moving your stuff from
  442.             the Apple to the PC and back.  It's icon based, with about
  443.             three-quarters of the screen devoted to the "Apple screen"
  444.             and the rest given over to "tool icons".  One tool icon is
  445.             for serial connections to your real Apple, another is for
  446.             swapping disks.  The IBM's function keys perform different 
  447.             functions, like Control+F12 is the simulated "Reset" button.
  448.  
  449.             (Of all the folks who have mentioned IIinaPC in the
  450.             group, there have been enthusiastic users of it and others
  451.             who use it now and then. One fellow had problems switching
  452.             with the "INT" command, and changing modes with the "PR#3"
  453.             command.)
  454.  
  455. 2) HARDWARE EMULATIONS
  456.  
  457.   A. Apple IIe Card for Macintosh
  458.      Currently at v2.2.  Apple Catalog #B1043, retails for $145.  Runs
  459.      on Mac LC, LC II and Color Classic.
  460.  
  461.   B. TrackStar Card for IBM PC
  462.      Made by Diamond Computer Systems
  463.      Card for PCs. Lets you read Apple diskettes on PC drives by
  464.      replacing the disk controller.
  465.  
  466. 3) UNIX based emulators
  467.  
  468.   A. apple2e (file named ap2e) - 80 col curses, text only
  469.      ap2egl - 80 col curses with GL graphics
  470.      1. where to get it:       ftp from
  471.                                grind.isca.uiowa.edu:/unix/apple2/ap2e
  472.      3. Author:                Randy Frank
  473.      4. Source Language:       C code for Unix
  474.      5. cpu-min:  unix
  475.      6. memory:   64K
  476.      7. roms:     CDROM (c100-ffff)
  477.      8. Image Format:     PO and imports Unix binaries
  478.  
  479.   B. a2 - the Rich Skrenta's Unix emulator
  480.      1. where to get it:       ftp from
  481.                                ftp.uu.net?
  482.      3. Author:                Rich Skrenta (skrenta@rt.com)
  483.                                (CLI by Tom Markson)
  484.      4. Source Code:           C code for unix
  485.      5. cpu-min:  unix
  486.      6. roms:     disk(c600), language(d000-f7ff), start(f800-ffff)
  487.  
  488.   C. apple2 - Peter Koch's Apple ][+ emulator
  489.      1. where to get it:          ftp from
  490.                                   ftp.uni-kl.de:/pub/unix/X11/apple2.shar.Z 
  491.                                   wilbur.stanford.edu:/pub/emulators/apple2/apple2.tar.z
  492.      2. Author:                   Peter Koch
  493.                                   (koch@informatik.uni-kl.de)
  494.      3. CPU                       needs X
  495.      4. ROMs:                     character(0000-07ff),controller(c600-c6ff)
  496.                                   f800(f800-ffff), d000(d000-d7ff), 
  497.                                   d800(d800-dfff), e000(e000-e7ff),
  498.                                   e800(e800-efff), f000(f000-f7ff)
  499.                                   [the above six files are just
  500.                                   apl2em's apple.rom broken into 2KB chunks]
  501.                                   or
  502.                                   (old monitor roms)
  503.                                   f800(f800-ffff), e000(e000-e7ff),
  504.                                   e800(e800-efff), f000(f000-f7ff) 
  505.      5. Graphics supported:       Lores and Hires
  506.      6. Image Format:             DO
  507.      7. Remarks:                  supports disk swapping
  508.  
  509.   D. zaniWok - an Apple //e emulator
  510.      1. where to get it:           ftp from
  511.                                    ftp.byu.edu:/apple2/emulator
  512.      2. Author                     Mat Hostetter
  513.         Maintained by              Chris Osborn
  514.                                    (groucho.sonoma.edu!fozztexx%nvcc)
  515.      3. Source Code:               C code requires NeXTStep
  516.      4  CPU                        NeXT only
  517.      5. ROMS:                      needs them
  518.      6. Image format:              I'm not sure, but it looks like the
  519.                                    DO format with the following nine
  520.                                    bytes prepended to it: ^D^ScY^@^@^@^I^B
  521.                                    for a total of 143369 bytes.
  522.      7. Remarks:
  523.              There is a mailing list to discuss this emulator, na2sig@byu.edu;
  524.              to sign up, email na2sig-request@byu.edu.
  525.  
  526.              zaniWok emulates a 128K Apple //e, with 40/80 column text, hi-res
  527.              graphics (monochrome+color+grayscale), double-hires graphics,
  528.              sound, dynamically loadable peripheral card objects, Unix
  529.              filesystem support via Appleshare.  Chris Osborn is adding lores
  530.              graphics, copy and paste capability, keyboard buffering, a decent
  531.              user interface, and no doubt other things.  Some have expressed
  532.              interest in writing a virtual serial card and a virtual
  533.              Mockingboard.
  534.  
  535.              To emulate the 65c02, zaniWok dynamically translates the 65c02
  536.              code into an efficient interpreted form as the program is
  537.              running. Although I have not yet implemented some of the
  538.              compile-time optimizations the emulator was designed to support,
  539.              it still runs at approximately realtime.
  540.  
  541. ----------------------------------------------------------------------------
  542. Part 3, Database of disk images
  543.  
  544. All of these images are available at
  545. wilbur.stanford.edu:/pub/emulators/apple2/DiskImages/
  546.  
  547. All of these images except the last one are in DO format.  The last
  548. one is in NDO format.
  549.  
  550. hyperC.zip    A C compiler and support system.  Two disk images and
  551.         lots of documentation.  Images are not bootable.  I
  552.         haven't really tested it.  Actually, this used to be
  553.                 here but went away in The Great Disk Crash (tm).  If
  554.                 anyone downloaded and still has it please upload it.
  555. kermitp.zip    PRODOS version of Kermit (a terminal emulator, file
  556.         transfer utility) .
  557. inmate.zip    A Shareware textual adventure game.
  558. samp.zip    Rich Skrenta (skrenta@rt.com) experimentation with
  559.                 implementing multi-tasking on a ][ (this disk came
  560.                 with the Unix emulator "a2").
  561. tetrisII.zip    A Tetris game, I suppose.  I pulled if off
  562.         cco.caltech.edu and it boots but then just hangs.  Let
  563.         me know if anyone gets it working.
  564. berzap.zip    Shareware knockoff of old Berserk arcade game.
  565. sparkee.zip    Shareware graphics language and application; Can also
  566.         be used as a screen saver.
  567. defender.zip    Haven't looked at it but I imagine its a defender-like
  568.         game. 
  569. shrink.zip      Contains IIPlus.UNSHRINK
  570. -----
  571. and
  572. bcsutil4.zip    This image is in the applemu format.  It is the Boston
  573.         Computer Society Utility Disk Number 4.  It contains
  574.         an INTEGER BASIC, a II+ mini-assembler, games, etc.
  575.  
  576. This FAQ is (C) Copyright 1993 by the authors, but available for public
  577. use.  You are free to distribute it and quote it, as long as the two
  578. following conditions are strictly met:
  579.  
  580.    1) It keeps intact this copyright notice and all acknowledgements.
  581.  
  582.    2) No money is made from its distribution (this may be waived for
  583.       non-profit organizations only if they personally contact the
  584.       maintainers of this faq and get permission, either in writing or
  585.       in explicit email.
  586.  
  587. *End of FAQ*
  588.