home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / vmac192.zip / Readme.OS2 < prev    next >
Text File  |  1998-03-15  |  11KB  |  250 lines
  1. *************************************************
  2. *  vMac/DOS README                *
  3. *  Port by:                    *
  4. *  David Bacher (dbacher@ibm.net)        *
  5. *  Marcus Childs (m.childs@internetmc.com)    *
  6. *  README by Ray Ruvinskiy (rruvin@sprint.ca)    *
  7. *               (rruvin@idirect.com)    *
  8. *************************************************
  9.  
  10. NOTE:     Using this software shows your acceptance to the End User License
  11.         Agreement which was shown to you before downloading vMac.
  12.         If you have not read or accepted it, you are not entitled
  13.         to use this software!!!
  14.         Please read EULA.TXT (located in the same directory as the readme),
  15.         make sure you understand it and accept its terms. If you don't
  16.         accept vMac's End User License Agreement, please delete vMac from 
  17.     your machine.
  18.  
  19. 0. Brief introduction
  20. 1. Getting vMac
  21. 2. Installing vMac
  22. 3. Running vMac
  23. 4. While vMac is running...
  24. 5. Troubleshooting
  25. 6. How to help...
  26. 7. Additional features
  27. 8. OS/2 FAQ
  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. - Mouse support
  41. - Floppy drive support
  42. - HardDrive support (vMac can now mount all HFS media; however, vMac will
  43.             treat all media as floppy disks)
  44. - Can run MacOS (System Software) versions up to 7.5.5
  45.  
  46. Currently, work is being done on IceCube, a new CPU emulator that would
  47. replace UAE's CPU emulator which we use currently, Hard Disk suppport,
  48. and other stuff :).
  49.  
  50. The system requirements for vMac are:
  51.  
  52. - OS/2 Warp 3.0 revision 17 *required*
  53.   OS/2 Warp 4.0 highly recommended
  54. - 80486 with a 80487 FPU
  55. - A Video card with support for DIVE
  56.   A Pentium 133 recommended
  57. - A minimum of 8 MB of RAM
  58.   16 MB of RAM recommended
  59. - Mouse
  60. - About 3 - 4 MB of harddrive space for minimum install (vMac + ROM file + disk image)
  61.   15 - 20 MB of harddrive space recommended (You do want to use some Mac software
  62.   with vMac, right?)
  63.  
  64. 1. Getting vMac
  65. ---------------
  66.  
  67. vMac's homepage is at http://www.vMac.org. If that doesn't work, try
  68. http://leb.net/vmac. If *that* doesn't work, try again another day, the
  69. site is probably down :\. Click on the Download link, fill a few
  70. blanks and download vMac. If you are reading this, however, you have
  71. probably already downloaded vMac. This section is here just in case...
  72.  
  73. 2. Installing vMac
  74. ------------------
  75.  
  76. Unzip the file you downloaded into a directory of your choice.
  77. You have to have a ROM in a file taken from a real Macintosh Plus in order
  78. to use the emulator.
  79.  
  80. NOTE: LEGALLY, YOU HAVE THE RIGHT TO USE A MAC ROM _ONLY_ IF YOU OWN A
  81. REAL MAC PLUS. ALSO, YOU MUSTN'T USE YOUR REAL MAC AND HAVE vMac RUNNING
  82. AT THE SAME TIME.
  83.  
  84. If you do not have a ROM in a file, and you do own a real Macintosh
  85. Plus, read the file vmac_rom.txt.
  86.  
  87. You also need a System Software disk image. System 6.0.8, System 7.0,
  88. and System 7.0.1 are distributed freely and can be downloaded from
  89. Apple's FTP site (ftp://ftp.apple.com), or the vMac Application Site
  90. (VAS - http://www.hostus.com/vas). A considerably large selection of
  91. Macintosh applications and games can also be found on VAS.
  92.  
  93. Once you've got your ROM and MacOS disk image, edit vMac.cfg and modify
  94. it to suite your system (and desires). All options are self explanatory.
  95. For example: to boot off Disk1.dsk put "Disk1.dsk" (without the quotes) 
  96. beside DrivePath1=.
  97.  
  98. To boot off a real floppy put "A:" besides DrivePath1 (if your HFS formatted
  99. floppy is in drive A:, and you want to mount it as the first disk in vMac).
  100.  
  101. To mount an HFS formatted HDD or any other media put the drive letter that
  102. corresponds to that media in OS/2 besides "DrivePathx".
  103.  
  104. 3. Running vMac
  105. ---------------
  106.  
  107. There are four binaries - vmac.exe for vMac with a 68000 CPU, vmac010 for
  108. vMac with a 68010 CPU, vmac020.exe for vMac with a 68020 CPU and vmac881.exe
  109. for vMac with a 68020 CPU + 68881 FPU. In the examples in this README we will
  110. always use "vmac". Note, however, that you can always substitute "vmac" with
  111. of the above mentioned filenames.
  112.  
  113. Launch vMac (by typing "vmac") and if everything is alright, vMac should boot
  114. within a minute. Voila, you can run Macintosh software on your PC.
  115.  
  116. 4. While vMac is running...
  117. ---------------------------
  118.  
  119. The default keyboard mappings
  120.  
  121.   Alt     : This key emulates the Command [or Pretzel] key on the Mac.
  122.   Ctrl    : This key emulates the Option key on the Mac.
  123.   Shift   : This key emulates the Shift key on the Mac.
  124.   CapsLock: This key emulates the CapsLock key on the Mac.
  125.   Keypad  : The gray keypad emulates the Macintosh Plus keypad.
  126.             The regular [white] keypad acts like under Num-Lock.
  127.  
  128. 5. Troubleshooting
  129. ------------------
  130.  
  131. This section currently deals with very elementary stuff. Hopefully
  132. (or then again, maybe not) it will be expanded in the future.
  133.  
  134. A) When vMac starts, a floppy with a question mark on it appears - the
  135.    Mac can't find your disk image/parition/floppy. Double check the path.
  136.  
  137. B) When vMac starts, a floppy with an X on it appears - the Mac can't
  138.    boot off your floppy/disk image/partition.
  139.  
  140. C) It takes longer for vMac to boot when I run it with 4 MB RAM than
  141.    when I run it with 1 MB of RAM - this is natural. It takes time to
  142.    check for all that RAM. In this version, however, you can disable
  143.    the memory in vMac.cfg.
  144.  
  145. D) MacOS 7.6 and higher won't boot! - MacOS version 7.6 and higher don't even
  146.    work on a real Macintosh Plus. Downgrade...
  147.  
  148. E) vMac is running incredibly slowly with MacOS x.x.x - You might have a
  149.    slow machine. You might try to remove extensions and control panels
  150.    from System Folder:Extensions and/or System Folder:Control Panels.
  151.    You might not have enough RAM on your machine. You might want to try to
  152.    downgrade your MacOS version. You may want to try using the 68000 
  153.    binary if you're using the 68020 one. You may want to try to increase the
  154.    frame rate (video quality will be worse though).
  155.  
  156. F) When I try to boot System 7 or higher, the Mac writes something like
  157.    "You need more RAM to boot this version of the System Software" - 
  158.    tell vMac to emulate more RAM.
  159.  
  160. G) The System 7.0.1/System 7.1 disk image I downloaded from VAS doesn't work - 
  161.    Some people have problems downloading from VAS. Try downloading a couple of
  162.    times. If you still don't succeed, there's nothing we can do, so stop e-mailing
  163.    the port authors about it! :-)
  164.  
  165. To get help with any other problem, e-mail the port author.
  166.  
  167. 6. How to help...
  168. -----------------
  169.  
  170. If you'd like to help, please e-mail the port author you want to help to.
  171. The e-mail addresses of porters are located on vMac's site
  172. (http://www.vMac.org), in the Port Roster. We appreciate all help we can 
  173. get so if you are able/willing to donate some of your time, we'll probably 
  174. find something for you to do.
  175.  
  176. 7. Additional Features...
  177. -------------------------
  178.  
  179. The OS/2 version of vMac provides Icons to access the following features:
  180.    Setup - This Icon brings up a tabbed dialog box to configure vMac.  Changes
  181.            are written to the configuration file, and all available options are
  182.            shown.
  183.    Disk  - There is an Icon for each disk.  This will bring up a dialog box to
  184.            allow you to access a disk or disk image.  If you have a .dsk file
  185.            on your hard drive, select Image, if you have a real disk of some
  186.            form, select Drive.
  187.  
  188. 8.  OS/2 FAQ...
  189. ---------------
  190.  
  191. A) Do I need EMXRT.DLL or a similar file to run vMac for OS/2?
  192.  
  193.    No.  vMac is compiled with Watcom C++ 10.6, and is self contained.  You will
  194.    need to install the Multimedia Support in OS/2, however, for this release.
  195.  
  196. B) What versions of OS/2 is vMac compatible with?
  197.  
  198.    Version 3.0 Fixpack 17 or newer, and all Version 4 systems are supported.  You
  199.    must have Multimedia Support installed, however.
  200.  
  201. C) Where is vMac.cfg located?  It doesn't seem to take effect when I change the one
  202.    in the vMac directory.
  203.  
  204.    Do to changes in the X-Windows version, from which this version is derived, the
  205.    vMac.cfg file is now stored in your home directory, if it is defined.  The home
  206.    directory (in OS/2) can be set by typing "SET HOME=<directory" in Config.Sys.
  207.    If a home directory is not defined, vMac will store the file in the current
  208.    directory.
  209.  
  210. D) How do I mount a real 3.5" disk?
  211.  
  212.    Insert the disk into drive A.  In vMac, make sure that one of the three floppy
  213.    drives is available, and then click on its Icon.  A window will appear with
  214.    two radio buttons -- choose Disk Drive, and make sure the edit box says A:\.
  215.    Click on OK.  You can mount any disk drive this way.  vMac can not currently
  216.    format floppies because it thinks that the disk drive is an 800k drive.
  217.  
  218. E) How do I mount an IoMega Zip 100, Jaz 1g, Jaz 2g or Syquest EzDrive cartridge?
  219.  
  220.    See instructions for mounting a floppy.  Use the drive letter of your drive
  221.    instead of A.
  222.  
  223. F) The mouse seems kinda slow, and the keyboard lags behind a little.
  224.  
  225.    Due to how we had to do the code to prevent OS/2 4 from believing that vMac had
  226.    locked the system on slow machines, this minor annoyance must just be tolerated.
  227.    We are working on it.  The mouse is "polled" 60 times a second.
  228.  
  229. G) What happened to the Skip Frames if Behind box?
  230.    
  231.    The code always skips frames when it falls behind now.  The option was removed.
  232.  
  233. H) What happened to the Vertical Blank Rate box?
  234.  
  235.    The code sends *EXACTLY* sixty blanks per second now.  The code evenly spaces
  236.    these over the course of a second.  If you don't want 60 screen redraws, use
  237.    the Frame Rate option on the Performance tab.
  238.  
  239. I) The splash screen window is way too big for the image...
  240.  
  241.    Run at 640 x 480.  We're working on it, but at the moment I'm expecting a new C
  242.    compiler any day, and want to postpone fixing the code until it arrives.  It only
  243.    effects the splash screen, so it's sorta a low priority.
  244.  
  245. J) The new version seems alot faster.
  246.  
  247.    We changed C compilers from Watcom to IBM Visual Age for C++.  Watcom had gained
  248.    us a significant improvement over EMX, and IBM's gained us a 50% improvement over
  249.    Watcom.  If you're running an AMD K6 200, you should score around three times a
  250.    Mac Plus.