home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Emulatoren / N!GGMSEM.LHA / MG.DOC < prev    next >
Encoding:
Text File  |  1996-08-18  |  5.8 KB  |  156 lines
  1.                          ******* MasterGear *******
  2.               The Portable SEGA MasterSystem/GameGear Emulator 
  3.                           version 0.4 (08/15/1996)
  4.  
  5.                             by Marat Fayzullin
  6.  
  7.  
  8.                          email: fms@freeflight.com
  9.                                 IRC: RST38h
  10.                     WWW: http://www.freeflight.com/fms/
  11.  
  12.  
  13.  
  14.  
  15.                                * DICLAIMERS *
  16.  
  17. * MasterSystem and GameGear are registered trademarks of SEGA.
  18. * The author is in no way affiliated with SEGA.
  19. * The author is in no way affiliated with any pirate group out there.
  20. * The author can not provide you with MasterSystem/GameGear games.
  21.  
  22.  
  23.  
  24.                          * NEW IN THIS VERSION *
  25.  
  26. * MSDOS sources (included into the archive) with sound emulation
  27.   via Adlib (based on Alex Krasivsky's sourcecode). No noise 
  28.   emulation in MSDOS version yet. Joystick support available
  29.   (press F2) but not tested.
  30. * Line interrupts work more or less reliably now, and therefore
  31.   are turned on by default. Use -noline to disable.
  32. * Localization support. The default localization is English (-engl).
  33.   Use -jap for Japanese localization.
  34. * Battery-backed RAM support. A .SAV file will be created if the
  35.   program accesses battery-backed RAM.
  36. * Sound logging is started but not finished yet.
  37.  
  38.  
  39.  
  40.                             * INTRODUCTION *
  41.  
  42.   MasterGear is a portable emulator of two SEGA game consoles: the
  43. MasterSystem and the portable GameGear which is basically an improved
  44. MasterSystem in a smaller package. The emulator is written in C and
  45. therefore can be ported to any computer platform out there, given that
  46. this platform can run 32-bit applications. You can always get the latest
  47. MasterGear binaries and support files from
  48.  
  49.                  http://www.freeflight.com/fms/MG/
  50.  
  51.   At this moment, MG is able to run about 75-80% of the SMS/GG carts I
  52. have, although the emulation is still far from perfection. With the help
  53. from friends I hope to make it as close to original machines as possible. 
  54.  
  55.   If you have any information on the MasterSystem/GameGear, or the
  56. ROM-images which can be used for testing, and are willing to help, feel
  57. free to send mail to fms@freeflight.com. Any *intelligent* help is greatly
  58. appreciated :). 
  59.  
  60.  
  61.  
  62.                              * BUTTONS *
  63.  
  64.   MasterGear is controlled by following buttons:
  65.  
  66.   [SPACE] - FIRE-A button (also: A,S,D,F,G,H,J,K,L)
  67.   [LALT]  - FIRE-B button (also: Z,X,C,V,B,N,M)
  68.   [ENTER] - START button (only in GameGear mode)
  69.   [TAB]   - RESET button (only in MasterSystem mode)
  70.   [ESC]   - Quit emulation (also: [F12])
  71.  
  72.   [SHIFT] and [CAPSLOCK] switch between joypads when in MasterSystem mode
  73.  
  74.   When compiled with #define DEBUG:
  75.   [F1]    - Turn tracing on/off
  76.  
  77.   When compiled with #define SOUND:
  78.   [1]-[4]    - Turn sound channels on/off
  79.   [0]        - Turn all sound on/off
  80.   [-]        - Decrease sound volume
  81.   [+]        - Increase sound volume
  82.  
  83.  
  84.  
  85.                       * COMMAND LINE OPTIONS *
  86.  
  87.   MasterGear can be started with following options:
  88.  
  89.   -verbose <level>    - Select debugging messages [1]
  90.                          0 - Silent             1 - Startup messages
  91.                          2 - Illegal accesses   4 - Illegal Z80 ops
  92.                          8 - Bank switching    16 - Sound
  93.                         32 - VDP registers
  94.   -vperiod <period>   - Set VBlank period [7000ops]
  95.   -uperiod <period>   - Number of interrupts per screen update [2]
  96.   -help               - Print this help page
  97.   -sms/-gg            - Run in MasterSystem/GameGear mode [-sms]
  98.   -engl/-jap          - Run in English/Japanese mode [-engl]
  99.   -autoa/-noautoa     - Autofire/No autofire for button A [-noautoa]
  100.   -autob/-noautob     - Autofire/No autofire for button B [-noautob]
  101.   -line/-noline       - Do/Don't do line interrupts [-line]
  102.   -logsnd <filename>  - Write soundtrack to a file [off]
  103.   -trap <address>     - Trap execution when PC reaches address [FFFFh]
  104.   -shm/-noshm         - Use/Don't use MIT SHM extensions for X [-shm]
  105.   -saver/-nosaver     - Save/Don't save CPU when inactive [-saver]
  106.  
  107.   When compiled with #define DEBUG:
  108.   -trap <address>     - Trap execution when PC reaches address [FFFFh]
  109.  
  110.   When compiled with #define DEBUG:
  111.   -sound [<quality>]  - Emulate sound with given quality [-nosound]
  112.                         0 - Off              7 - Highest quality
  113.                         (4 assumed if no quality was given)
  114.   -nosound            - Don't emulate sound [-nosound]
  115.  
  116.  
  117.  
  118.                              * NOTES *
  119.  
  120.   The SMS/GG programming information will be available soon at
  121. ftp.komkon.org. Both are nice little machines, logically structured and
  122. much less weird than Nintendo hardware. The CPU used is Z80, the original
  123. one, with no custom changes. Video controller seems to be based on a well
  124. known TMS9918/9928 (MSX,Coleco,TI99/4), but has only one screenmode (as
  125. far as I know), and is thoroughfully mutated in some other aspects. There 
  126. is no BIOS ROM as in MSX or ColecoVision.
  127.  
  128.   MasterGear comes without any ROM images due to copyright reasons. 
  129. Please, *do not* send me mail asking for ROM images: I can not give you
  130. any, no matter how strongly you desire to get them. MasterGear works with
  131. plain "raw" ROM images, and therefore the default file extension is .ROM. 
  132. It may be a wise idea to use .SMS and .GG extensions to distinguish
  133. between MasterSystem and GameGear ROMs though: the choice of extension is
  134. not limited in any way.
  135.  
  136.   Some copiers add a 512-byte header to the ROM image files they create. 
  137. If you see a ROM image whose size is a multiple of 16384 bytes + 512,
  138. simply cut off the first 512 bytes to et the raw image. Unix users can do 
  139. it in a following way:
  140.  
  141.             dd if=<input-file> of=<output-file> skip=1 bs=512
  142.  
  143.  
  144. That's it. Have fun!
  145.  
  146.  
  147.  
  148.                                * THANKS *
  149.  
  150.   I would like to thank Richard Aplin and James McKay without whom 
  151. MasterGear would have never appeared.
  152.  
  153.  
  154. ---------------
  155. Marat Fayzullin
  156.