home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 June / PCWorld_1999-06_cd.bin / software / temacd / vmacx / DOCS / README.DOS < prev    next >
Text File  |  1998-06-28  |  11KB  |  266 lines
  1. *************************************************
  2. *  vMac/DOS README                              *
  3. *  Port by Yoav Shadmi (yoav@nettaxi.com)    *
  4. *  README by Ray Ruvinskiy (rruvin@sprint.ca)    *
  5. *               (rruvin@idirect.com) *
  6. *************************************************
  7.  
  8. NOTE:     Using this software shows your acceptance to the End User License
  9.         Agreement which was shown to you before downloading vMac.
  10.         If you have not read or accepted it, you are not entitled
  11.         to use this software!!!
  12.         Please read EULA.TXT (located in the same directory as the readme),
  13.         make sure you understand it and accept its terms. If you don't
  14.         accept vMac's End User License Agreement, please delete vMac from 
  15.     your machine.
  16.  
  17.  
  18. 0. Brief introduction
  19. 1. Copyright notice and other legal issues.
  20. 2. Getting vMac
  21. 3. Installing vMac
  22. 4. Configuring vMac
  23. 5. Running vMac
  24. 6. While vMac is running...
  25. 7. Troubleshooting
  26. 8. How to help...
  27.  
  28.  
  29. 0. Brief introduction
  30. ---------------------
  31.  
  32. What is vMac? vMac is a free software emulator that emulates the Apple
  33. Macintosh Plus(tm). That means that vMac does not cost anything, and
  34. does not use any hardware. A lot of the Macintosh Plus' functionality is
  35. already implemented in this port, and that includes: 
  36.  
  37. - 68000 CPU, 68010 CPU, 68020 CPU + 68881 FPU emulation
  38. - 4 MB of RAM
  39. - Keyboard support
  40. - Floppy support
  41. - Sound support
  42. - Mouse support
  43. - Minimal printer support [Experimental]
  44. - Minimal SCSI support
  45. - Can run MacOS (System Software) versions up to 7.5.5
  46.  
  47. Currently, work is being done on IceCube, a new CPU emulator that would
  48. replace UAE's CPU emulator which we use currently, Hard Disk suppport,
  49. and other stuff :).
  50.  
  51. The system requirements for vMac are:
  52.  
  53. - MS-DOS 5.0 or higher
  54. - 80486 with a 80487 FPU
  55.   A Pentium 133 recommended
  56. - A minimum of 8 MB of RAM
  57.   16 MB of RAM recommended
  58. - Mouse
  59. - About 3 - 4 MB of harddrive space for minimum install (vMac + ROM file + disk image)
  60.   15 - 20 MB of harddrive space recommended (You do want to use some Mac software
  61.   with vMac, right?)
  62.  
  63.  
  64. 1. Copyright Notice
  65. -------------------
  66.  
  67. vMac is Copyright 1997 Philip Cummins and The vMac Team (ALL RIGHTS RESERVED).
  68. The UAE engine, which vMac's core is based on, is copyrighted by the UAE team.
  69. In addition to vMac core copyrights, each port author reserves the right to
  70. copyright his or her respective port.
  71.  
  72. WE ARE NOT RESPONSIBLE OR LAIBLE FOR ANYTHING. THERE ARE NO GUARANTEES.
  73. USE AT YOUR OWN RISK! YOU MAY NOT USE CODE FROM THIS SOURCE OR CODE
  74. BASED ON THIS SOURCE FOR COMMERCIAL PURPOSES WIHTOUT PERMISSION FROM
  75. THE VMAC TEAM.
  76.  
  77. Please also read the EULA notice which is distributed with the binary
  78. release.
  79.  
  80. vMac is freeware, so please redistribute it! You may NOT change any of the
  81. included files in any way. If you distribute other files along with vMac,
  82. YOU are 100% responsible for those files. You may NOT charge for vMac or
  83. to distribute vMac, unless you are bundling it with other files on CD-ROM,
  84. DVD, or other media. I encourage bundling vMac, as long as you comply with
  85. the above. If you bundle it, I would like to know, so please notify me by
  86. E-Mail. If you have any questions about this feel free to E-Mail me, or any
  87. other member of the vMac team about it.
  88.  
  89.  
  90. 2. Getting vMac
  91. ---------------
  92.  
  93. vMac's homepage is at http://www.vMac.org. If that doesn't work, try
  94. http://leb.net/vmac. If *that* doesn't work, try again another day, the
  95. site is probably down :\. Click on the Download link, fill a few
  96. blanks and download vMac. If you are reading this, however, you have
  97. probably already downloaded vMac. This section is here just in case...
  98.  
  99.  
  100. 3. Installing vMac
  101. ------------------
  102.  
  103. Unzip the file you downloaded into a directory of your choice.
  104. You have to have a ROM in a file taken from a real Macintosh Plus in order
  105. to use the emulator.
  106.  
  107. NOTE: LEGALLY, YOU HAVE THE RIGHT TO USE A MAC ROM _ONLY_ IF YOU OWN A
  108. REAL MAC PLUS. ALSO, YOU MUSTN'T USE YOUR REAL MAC AND HAVE vMac RUNNING
  109. AT THE SAME TIME.
  110.  
  111. If you do not have a ROM in a file, and you do own a real Macintosh
  112. Plus, read the file vmac_rom.txt.
  113.  
  114. You also need a System Software disk image. System 6.0.8, System 7.0.0,
  115. and System 7.0.1 are distributed freely and can be downloaded from
  116. Apple's FTP site (ftp://ftp.apple.com), or the vMac Application Site
  117. (VAS - http://www.hostus.com/vas). A considerably large selection of
  118. Macintosh applications and games can also be found on VAS.
  119.  
  120. Once you've got your ROM and MacOS disk image, edit vMac.cfg and modify
  121. it to suite your system (and desires). All options are self explanatory.
  122. For example: to boot off Disk1.dsk put "Disk1.dsk" (without the quotes) 
  123. beside DrivePath1=.
  124.  
  125.  
  126. 4. Configuring vMac
  127. -------------------
  128.  
  129. vMac can manage several config files simultaenously.  By default, it will
  130. use "vMac.cfg", but you can use other config files as well (see the command
  131. line help for more instructions - type "vmac -h").
  132.  
  133. The config file contains all you need to fine-tune vMac to suite your system
  134. needs and desires.  The file is commented, so there shouldn't be any problem
  135. understanding what's going on.
  136.  
  137.  
  138. 5. Running vMac
  139. ---------------
  140.  
  141. There are four binaries - vmac.exe for vMac with a 68000 CPU, vmac010.exe for
  142. vMac with a 68010 CPU, vmac020.exe for vMac with a 68020 CPU and vmac881.exe
  143. for vMac with a 68020 CPU + 68881 FPU. In the examples in this README we will
  144. always use "vmac". Note, however, that you can always substitute "vmac" with
  145. any of the above mentioned filenames.
  146.  
  147. Please note, that the 68020 and 68020/68881 binaries are slower than the
  148. 68000 and 68010 binaries.  This is natural, of course, as emulating a more
  149. sophisticated CPU requires a stronger host machine.
  150.  
  151. Launch vMac (by typing "vmac") and if everything is alright, vMac should boot
  152. within a minute. Voila, you can run Macintosh software on your PC.
  153.  
  154. To get a command line help, type "vmac -h".
  155.  
  156. If you want to enter debug mode you can press F9 at any time during the
  157. emulation.   For further information about the debugger included with
  158. vMac see "debug.txt" (located at the same directory as the readme file).
  159.  
  160.  
  161. 6. While vMac is running...
  162. ---------------------------
  163.  
  164. The keyboard mappings:
  165.  
  166.   Alt     : This key emulates the Command [or Pretzel] key on the Mac.
  167.   Ctrl    : This key emulates the Option key on the Mac.
  168.   Shift   : This key emulates the Shift key on the Mac.
  169.   CapsLock: This key emulates the CapsLock key on the Mac.
  170.   Keypad  : The gray keypad emulates the Macintosh Plus keypad.
  171.             The regular [white] keypad acts like under Num-Lock.
  172.   F1      : Inserts floppy-disk in internal floppy drive.
  173.   F2      : Inserts disk-image in external drive 1.
  174.   F3      : Inserts disk-image in external drive 2.
  175.   F4      : Inserts disk-image in external drive 3.
  176.   F8      : Will dump the screen contents [640x480] to a .BMP file.
  177.   F9      : Enter online debug mode [see "debug.txt" for further information].
  178.   F10     : This will close vMac.
  179.   F11     : This key emulates the Interrupt/Programmer Switch of the
  180.             Macintosh Plus.
  181.   F12     : This key emulates the Reset Switch of the Macintosh Plus.
  182.  
  183.  
  184. 7. Troubleshooting
  185. ------------------
  186.  
  187. This section currently deals with very elementary stuff. Hopefully
  188. (or then again, maybe not) it will be expanded in the future.
  189.  
  190. A) Startup problems
  191.    1. vMac must be run in MS-DOS mode.
  192.  
  193.    2. vMac requires a mouse driver.   You must load the mouse driver [Any
  194.       generic mouse driver should be fine, as long as it's not PS/2] before
  195.       running vMac.
  196.  
  197.    3. Sound driver - To use vMac's sound emulation, your sound card must
  198.       be installed [Naturally], and all of its drivers [if there are any]
  199.       must be loaded BEFORE running vMac.  It is also recommended that you
  200.       set the BLASTER variable in your environment setting.   Refer to your
  201.       sound-card documentation on how to configure it for DOS.   You should
  202.       also keep in mind, that vMac's sound code was written and tested for
  203.       "Creative Sound-Blaster" cards.  It was not tested under any other
  204.       sound card brand.
  205.  
  206.    4. "Cannot open printer port" means you specified the wrong paraller
  207.       port of your printer.  Most printers are usually connected through
  208.       LPT1.
  209.  
  210. B) QuickDraw hack issues - You should read this if you intend to use vMac's
  211.    QuickDraw patch.
  212.  
  213.    1. The Macintosh start-up icon [i.e. Happy Mac, Sad Mac etc] is hardcoded
  214.       into the ROM, and will not be shown when you run vMac with the QDHack
  215.       option set to ON.  
  216.  
  217.    2. In 640x480 mode, some alert boxes are smaller, and centered to the old
  218.       512x342 screen.   This is not a major bug, of course, but still looks
  219.       weird.
  220.  
  221. C) Bootup issues
  222.    1. When vMac starts, a floppy with a question mark on it appears - the
  223.       Mac can't find your disk image/parition/floppy. Double check the path
  224.       and name of the disk-image in the config file.
  225.  
  226.    2. When vMac starts, a floppy with an X on it appears - the Mac can't
  227.       boot off your floppy/disk image/partition.   It means that the
  228.       disk-image/floppy/partition you were trying to boot from is corrupt.
  229.  
  230.    3. When I try to boot System 7 or higher, the Mac writes something like
  231.       "You need more RAM to boot this version of the System Software" - 
  232.       tell vMac to emulate more RAM, through the config file.
  233.  
  234.    4. It takes longer for vMac to boot when I run it with 4 MB RAM than
  235.       when I run it with 1 MB of RAM - this is natural. It takes time to
  236.       check for all that RAM. In this version, however, you can disable
  237.       the memory test through the config file.
  238.  
  239.    5. MacOS 7.6 and higher won't boot! - MacOS version 7.6 and higher don't
  240.       even work on a real Macintosh Plus.  You can either downgrade to an
  241.       older Macintosh operating system, or wait until new Mac models are
  242.       implemented..
  243.  
  244. D) During runtime
  245.    1. vMac is running incredibly slowly with MacOS x.x.x - You might have a
  246.       slow machine. You might try to remove extensions and control panels
  247.       from System Folder:Extensions and/or System Folder:Control Panels.
  248.       You might not have enough RAM on your machine. You might want to try to
  249.       downgrade your MacOS version.
  250.  
  251.    2. You should keep in mind that 68020 emulation is slower, so if vMac
  252.       is going too slow with the 68020 binary, you might want to use the
  253.       the 68000 binary instead.
  254.  
  255. E) To get help with any other problem, e-mail the port author.
  256.  
  257.  
  258. 8. How to help...
  259. -----------------
  260.  
  261. If you'd like to help, please e-mail the port author you want to help to.
  262. The e-mail addresses of porters are located on vMac's site
  263. (http://www.vMac.org), in the Port Roster. We appreciate all help we can
  264. get so if you are able/willing to donate some of your time, we'll probably 
  265. find something for you to do.
  266.