home *** CD-ROM | disk | FTP | other *** search
/ Emulator Universe CD / emulatoruniversecd1998.iso / MSX / Emus / FMSX-DOS.TXT < prev   
Encoding:
Text File  |  1997-09-05  |  13.8 KB  |  282 lines
  1.                             fMSX MS-DOS 1.6b2.a
  2.                    MSX emulator for the MS-DOS platform.
  3.     Core emulator code copyright (C) 1994, 1995, 1996  Marat Fayzullin
  4.            This version copyright (C) 1996,1997  Marcel de Kogel
  5.                                      
  6.                MS-DOS(tm) is a trademark of Microsoft Corp.
  7.  
  8. Hardware Requirements
  9. =====================
  10. A 486SX-25 (P66 recommended)
  11. A VLB- or PCI-based VGA compatible video card
  12. PC Speaker/Adlib/SB2.0/SBPro/SB16/GUS/SB AWE32/MPU401 and joystick
  13. supported
  14.  
  15. Files included in FMSX-DOS.ZIP
  16. ==============================
  17. FMSX-DOS.EXE The emulator
  18. FMSX-DOS.TXT This file
  19. CWSDMI.ZIP   A DPMI server required by FMSX-DOS.EXE
  20.              If you don't run fMSX in a DPMI hosted environment (OS/2, MS-
  21.              Windows, Linux DOSEmu, QDPMI, ...), put the file CWSDPMI.EXE
  22.              included in this archive somewhere in your path or in the
  23.              emulator's directory
  24. FILE_ID.DIZ  A small description of this program
  25. Some utilities for use with fMSX MS-DOS can be found on the fMSX MS-DOS
  26. distribution site at http://www.komkon.org/~dekogel/fmsx.html
  27. The source of the Z80 emulation code used can be found on
  28. http://www.komkon.org/~dekogel/misc.html
  29. More information about fMSX and MSX in general can be found on the fMSX
  30. distibution site at http://www.freeflight.com/fms/fMSX
  31.  
  32. Other files required by fMSX MS-DOS
  33. ===================================
  34. The following files are required for correct operation but are not
  35. included in the archive for copyright reasons:
  36. MSX2.ROM     MSX2 BIOS and BASIC code
  37. MSX2EXT.ROM  MSX2 ExtROM containing system extensions
  38. MSX.ROM      Standard MSX BIOS and BASIC code [optional]
  39. MSX2P.ROM    MSX2+ BIOS and BASIC code [optional]
  40. MSX2PEXT.ROM MSX2+ ExtROM containing system extensions [optional]
  41. DISK.ROM     MSX DiskROM containing BDOS and DISK BASIC [optional]
  42. RS232.ROM    RS232 BIOS and BASIC extensions [optional]
  43. FMPAC.ROM    FM-PAC ROM extensions [optional]
  44. PAINTER.ROM  PAINTER ROM extensions [optional]
  45. CMOS.ROM     This file is created automatically and contains the non-
  46.              volatile memory used in MSX2 and MSX2+. This file gets
  47.              rewritten on exit if non-volatile memory was changed
  48. Please, do not ask where you can get these files as I shan't answer
  49.  
  50. Key Mapping
  51. ===========
  52. GRAPH  - Left alt
  53. CODE   - Right alt
  54. SELECT - PageDown
  55. STOP   - PageUp
  56.  
  57. Special Keys
  58. ============
  59. F6  - Rewind tape
  60. F7  - Wind tape
  61. F8  - Make screen shot
  62. F9  - Pause
  63. F10 - Quit emulator
  64. F11 - Increase sound volume
  65. F12 - Decrease sound volume
  66. RIGHT CTRL+F8    - Toggle sound on/off
  67. RIGHT CTRL+F9    - Change options
  68. RIGHT CTRL+1...0 - Change disk offset
  69. Win95 and Pointer keys - Space
  70. Left Ctrl+Left Alt+Right Ctrl+Right Alt     - Soft reset MSX
  71. Left Ctrl+Left Shift+Right Ctrl+Right Shift - Hard reset MSX
  72.  
  73. Command line options
  74. ====================
  75. Below is a list of available command line options. Many options may be
  76. abbreviated. Use -help to get a list of currently supported abbreviations
  77. -help                   Show a help page describing all available command
  78.                         line options
  79. -verbose <flags>        Select debugging messages [1]
  80.                         0 - Silent       1 - Startup messages
  81.                         2 - V9938 ops    4 - Disk
  82.                         8 - Memory      16 - Illegal Z80 ops
  83. -ifreq <frequency>      Set interrupt frequency [50Hz]
  84.                         Default interrupt frequency is 50Hz for PAL
  85.                         (European) systems and 60Hz for NTSC (American and
  86.                         Japanese) systems. If you find your games running
  87.                         a bit too slow, try using -ifreq 60
  88. -sync <mode>            Set synchronisation mode [1]
  89.                         0 - Do not sync emulation
  90.                         1 - Sync emulation on every VDP interrupt
  91. -adjust <mode>          Set VDP screen adjustment emulation mode [0]
  92.                         0 - Do not emulate VDP screen adjustment
  93.                         1 - Emulate horizontal adjustment only
  94.                         2 - Emulate vertical adjustment only
  95.                         3 - Fully emulate VDP screen adjustment
  96.                         Please note that some lines may not appear on the
  97.                         screen if VDP screen adjustment emulation is
  98.                         turned on
  99. -linedelay <value>      Set screen refresh delay [3 scanlines]
  100. -cpuspeed <percentage>  Set Z80 CPU speed [100%]
  101. -uperiod <period>       Set number of interrupts per screen update [2]
  102. -sprite <mode>          Select sprite emulation mode [0]
  103.                         0 - Show all sprites
  104.                         1 - Limit number of sprites per row to 4/8
  105.                         Though some games require -sprite 1 for correct
  106.                         display, it'll cause major sprite flicker with
  107.                         many others
  108. -printer <filename>     Redirect printer output to file [stdout]
  109. -serial <filename>      Redirect serial I/O to a file [stdin/stdout]
  110. -ram <pages>            Number of 16kB RAM pages [4/8/8]
  111.                         Many disk based games require more than 128KB RAM.
  112.                         Try using -ram 16 or -ram 32 if you're having
  113.                         problems getting such games to run
  114. -vram <pages>           Number of 16kB VRAM pages [2/8/8]
  115. -msx1/-msx2/-msx2+      Select MSX model [-msx2]
  116. -rom <type>             Select MegaROM mapper types [0,0]
  117.                         (two -rom options can be present)
  118.                         0 - Konami 8kB    1 - Konami 16kB
  119.                         2 - Konami5 8kB   3 - Konami4 8kB
  120.                         4 - ASCII 8kB     5 - ASCII 16kB
  121. -diska <filename>       Set disk image used for drive A: [DRIVEA.DSK]
  122.                         Physical drives are supported, e.g. "-diska A:"
  123.                         will use PC disk A:. Both single and double sided
  124.                         floppies are supported
  125. -diskb <filename>       Set disk image used for drive B: [DRIVEB.DSK]
  126. -tape <filename>        Select tape image [MSX.CAS]
  127.                         There's no limit to the length of a tape image
  128. -font <filename>        Set fixed font for text modes [none]
  129. -logsnd <filename>      Write soundtrack to a file [off]
  130. -painter <mode>         Load/Do not load PAINTER.ROM [0]
  131.                         0 - Do not load PAINTER.ROM
  132.                         1 - Load PAINTER.ROM
  133. -video <mode>           Select video mode [0]
  134.                         0 - 320x200   1 - 320x240
  135.                         2 - 640x480   3 - 256x212
  136.                         Video modes 1 and 3 may not be compatible with
  137.                         your video card and/or monitor. For video 2,
  138.                         you'll need a VESA compatible video card
  139. -chipset <id>           Select SVGA chipset [255]
  140.                         0 - VESA
  141.                         1 - S3
  142.                         255 - Detect
  143.                         Support for more popular chipsets may be added in
  144.                         future versions
  145. -modeswitch <mode>      Allow/Don't allow VGA mode switches [0]
  146.                         0 - Don't allow VGA mode switches
  147.                         1 - Allow VGA mode switches
  148.                         If this option is enabled, the game will use both
  149.                         video modes 2 and 3
  150. -gamma <value>          Select gamma adjustment value [1.0]
  151. -sound <mode>           Select audio mode [255]
  152.                         0 - No sound
  153.                         1 - Internal Speaker
  154.                         2 - Adlib
  155.                         3 - Sound Blaster
  156.                         4 - Gravis Ultrasound
  157.                         5 - SB AWE32
  158.                         255 - Detect
  159. -stereo <level>         Set stereo panning level (SB AWE32 only) [0]
  160.                         0 - Mono    100 - Maximum
  161. -speakerchannels        Set sound channel priority list (Internal speaker
  162. <list>                  only) [3,2,1]
  163.                         1-3 = PSG Melodic
  164.                         4-6 = PSG Noise
  165.                         7-11 = SCC
  166.                         Most games use channel 3 for their sound effects
  167.                         and channels 1 and 2 for their melodies. Try using
  168.                         3,1,2 if the default list doesn't give the desired
  169.                         sound quality
  170. -volume <volume>        Set initial volume [10]
  171.                         0 - Quiet    15 - Maximum
  172. -reverb <level>         Set reverb send level (SB AWE32 only) [7]
  173.                         0 - None    100 - Maximum
  174. -chorus <level>         Set chorus send level (SB AWE32 only) [0]
  175.                         0 - None    100 - Maximum
  176. -soundquality [-sq]     Set sound quality (SoundBlaster only) [3]
  177. <value>                 Range is from 1 (low) to 5 (very high)
  178. -scc <mode>             Set SCC emulation mode [1]
  179.                         0 - SCC emulation off
  180.                         1 - SCC emulation on
  181. -fmpac <mode>           Set FM-PAC emulation mode [0]
  182.                         0 - FM-PAC emulation off
  183.                         1 - FM-PAC emulation via OPL2 (Adlib)
  184.                         2 - FM-PAC emulation via MPU401 (General MIDI)
  185.                         3 - FM-PAC emulation via MPU401 & OPL2
  186.                         FM-PAC can only be turned on if FMPAC.ROM is
  187.                         resident in your fMSX MS-DOS directory
  188. -joystick <mode>        Select joystick mode [1]
  189.                         0 - No joystick support
  190.                         1 - Emulate joystick at port 1
  191.                         2 - Emulate joystick at port 2
  192.                         The 2nd PC joystick isn't supported (yet)
  193. -swapbuttons <mode>     Swap/Do not swap buttons [0]
  194.                         0 - Do not swap buttons
  195.                         1 - Swap joystick buttons
  196.  
  197. Multi disk games support
  198. ========================
  199. As of version 1.6b1, fMSX MS-DOS supports multi disk images. To create
  200. one, simply copy several disks to 1 image like this: "COPY /B
  201. DISK1.DSK+DISK2.DSK MULTI.DSK", start the emulator with the resulting disk
  202. image as disk A, and press RIGHT CTRL+1..0 when the game asks you to
  203. insert a new diskette. Please note that this only works for double sided
  204. disk images (720Kb ones)
  205.  
  206. Screen shots
  207. ============
  208. Whenever you press F8 to save the screen contents to a graphics file, the
  209. emulator will create an fMSXxxxx.BMP file, where xxxx is an ascending
  210. number starting at 0000, which is a 256 colour windows bitmap file
  211.  
  212. Passing options to the emulator
  213. ===============================
  214. With the amount of command line options fMSX MS-DOS supports, it's easy to
  215. create command lines larger than the DOS limit of 126 bytes. If you
  216. experience problems with the command line length, put all options in a
  217. temporary file (say, "TempFile.tmp"), and start the emulator with the
  218. command line "fMSX-DOS @TempFile.tmp". You may also give extra command
  219. line options when using this feature, like in `fMSX-DOS @MyConfig.cfg -
  220. ifreq 60 Pacman.rom'
  221.  
  222. Configuration files
  223. ===================
  224. The emulator loads three configuration files (if present) before it boots
  225. MSX: fMSX-DOS.cfg located in the emulator's directory and CARTA.cfg and
  226. CARTB.cfg located in the cartridge dump's directory. These are plain text
  227. files containing optional command line options. Options can be separated
  228. with spaces, tabs or returns
  229.  
  230. Troubleshooting
  231. ===============
  232. - If a game runs a bit too slow, try using -ifreq 60
  233. - If the emulator runs all games much too slow, try decreasing cpuspeed
  234.   to 50%-70%. You may also want to try -sync 0. If you're using a
  235.   SoundBlaster, try decreasing the sound quality or using Adlib mode
  236. - If you want your games to run faster, increase ifreq. If you want them
  237.   to run slower, decrease ifreq
  238. - If you don't own an MSX with a floppy drive and you want to create an
  239.   MSX floppy disk, follow these instructions: Format a 3½ inch floppy
  240.   disk to standard DOS 720KB format and start fMSX MS-DOS with the "-
  241.   diska A:" (or "-diska B:") option with the floppy not inserted in the
  242.   drive. After MSX-BASIC has booted, insert the floppy into your floppy
  243.   drive and type "CALL FORMAT". Choose drive A and double sided, and
  244.   wait till the formatting has finished.
  245.  
  246. History
  247. =======
  248. 1.6b2.a Winding/Rewinding tape bug fixed
  249. 1.6b2   Added -sprite, -gamma and -painter options and screenshot support.
  250.         Fixed several bugs in the VDP emulation, sped up emulation,
  251.         replaced Marat's Z80 emulation code with Z80Em 1.2
  252. 1.6b1   Fixed several interrupt related bugs, added multi-disk game
  253.         support, General MIDI support and a few miscellaneous options
  254. 1.4.1   Major improvements to the SoundBlaster support, added FM-PAC
  255.         emulation, fixed some bugs
  256. 1.3.1   Increased speed, fixed lots of bugs, added PC speaker, SB, GUS and
  257.         AWE32 support, added S3 support, added tape emulation and
  258.         configuration file support
  259. 1.2.3   Added volume control, joystick options, modeswitch option, video
  260.         mode 3, improved sound, increased speed, fixed some bugs
  261. 1.2.2   Added joystick support, Added SCC emulation and improved PSG
  262.         emulation, added VESA support, increased speed, fixed some major
  263.         bugs
  264. 1.2.1   Initial release
  265.  
  266. Credits
  267. =======
  268. - fMSX MS-DOS was compiled using DJ Delorie's DJGPP v2.0. DJGPP is a 32
  269.   bit C compiler for MS-DOS. Source code and binaries of DJGPP are
  270.   available at http://www.delorie.com
  271. - The SB AWE32 routines are heavily based on `The Unofficial Sound
  272.   Blaster AWE32 Programming Guide' written by Vince Vu a.k.a. Judge
  273.   Dredd. Thanks a million for writing this!
  274. - Martijn Zeedijk tested the GUS routines and helped me fix lots of bugs
  275. - Some parts of the code were taken from Allegro. Allegro is a library
  276.   for DJGPP written by Shawn Hargreaves. Allegro is available at
  277.   ftp://x2ftp.oulu.fi/pub/msdos/programming/djgpp2
  278.  
  279. Please send your comments to Marcel at
  280. m.dekogel@student.utwente.nl
  281.  
  282.