                               fPC MSX-DOS 0.00001a
                   PC emulator for the MSX-DOS platform.
    Core emulator code copyright (C) 1998, 2098  Daniel Caetano
             This version copyright (C) 1998, 2098 Daniel Caetano
                                     
               MSX-DOS(tm) is a trademark of Microsoft Corp.

Hardware Requirements
=====================
A MSX 2 or Better. Turbo on MSX 2/2+ will not work, but TR will.
V9938 or V9958 with at least 128Kb of VRAM is needed
64 Kb, PSG, Keyboard and a TV are required too.
HardDisk is recomended.

Or, At Least, a good MSX Emulator (I don't guaratee that will work...)

Files included in fPC.ZIP
==============================
FPC.COM - The emulator
FPC-MSX.TXT - This file

Other files required by fPC MSX-DOS
===================================
DISKCONT.ROM - PC Disk Controller ROM
PCBIOS.ROM - PC BIOS ROM
PCSLOT.ROM - PC SLOT Controller ROM
RS232.ROM - RS232 BIOS and BASIC extensions [optional]
CMOS.ROM - Non-volatile memory used in PC Computers [optional]

Key Mapping
===========
GRAPH  - Left alt
CODE   - Right alt
SELECT - PageDown
STOP   - PageUp

Special Keys
============
F12 - I'm looking for it...

Command line options
====================
Below is a list of available command line options. Many options may be
abbreviated. 

-help			Will be ignored
-verbose 		Will be ignored
-ifreq			Will be ignored
-sync 			Will be ignored
-adjust 		Will be ignored
-linedelay 		Will be ignored
-cpuspeed 		Will be always 233MHz
-uperiod 		Will be ignored
-printer 		Will be never used
-serial 		Will be never used
-ram 			Will be always 32Mb
-vram 			Will be ignored
-PII/-K6/-K6II    	Will be ignored
-diska 			Will be always drive A
-diskb 			Will be always drive B
-harddisk		Will be always the Cassete
-font 			Will never be released (also known as SOURCE CODE)
-logsnd 		What sound?
-video 			Will be always 256x212x8bit
-chipset 		Will be always V9938 or V9958
-modeswitch 		Why change the resolution?
-sound 			Think you are deaf
-stereo 		No, I can make children (yet)
-speakerchannels        Channels are on TV, not on the speaker!
-volume 		It's a distance times an area
-reverb 		What this could mean?
-chorus 		No, I don't like german food
-soundquality 		So, if it have quality, buy it!
-SBPCI128		Nah, FM is a lot better!
-joystick 		PC is not for playing games!
-swapbuttons 		Why? If you really want this, disassemble your joystick!

HardDisk emulation
==============
The harddisk emulation isn't nearly finished. Saving and loading files from
Windows95 works correctly (WordPad works well - I mean, sometimes),
but there are some major problems creating hard disk images in Cassete Tapes. 
There's no program shipped with the emulator that does this.

Multi games support
========================
Once you will need to run them on Windows95, if you
manage how to do this junk work, you will be able to make the
game run, too!

Passing options to the emulator
===============================
With the amount of command line options fPC MSX-DOS supports, it's easy to
create command lines larger than the MSX-DOS limit of 126 bytes. If you
experience problems with the command line length, put all options in a
temporary file (say, "TempFile.tmp"), and start the emulator with the
command line "fMSX-DOS @TempFile.tmp". You may also give extra command
line options when using this feature, like in `fPC-MSX @MyConfig.cfg -
ifreq 60 Pacman.rom' The emulator will ignore ALL your options, but this is
only a detail.

Configuration files
===================
The emulator loads three configuration files (if present) before it boots
MSX: fPC-MSX.cfg located in the emulator's directory and CARTA.cfg and
CARTB.cfg located in the cartridge dump's directory. These are plain text
files containing optional command line options. Options can be separated
with spaces, tabs or returns. All of them will be ignored, but this is 
another detail.

Troubleshooting
===============
- If a game runs a bit too slow, try using a whip
- If the emulator runs all games much too slow, try puting your
  computer into a car. If it is slow yet, put it into a plane!
- If you don't own an PC with a floppy drive and you want to create an
  PC floppy disk, follow these instructions: Format a 3 inch floppy
  disk to standard MSX-DOS 720KB format and start fPC MSX-DOS with 
  the "-diska A:" (or "-diska B:") option with the floppy not inserted in the
  drive. After Win95 has booted, insert the floppy into your floppy drive and 
  wait the "turn off your computer" appear. And your disk? Well, it's YOUR
  problem, not mine!

History
=======
0.00001a - Initial release

Credits
=======
- fPC MSX-DOS was compiled using Hi-Tech C v3.10. Hi-Tech C is a 8
  bit ANSI C compiler for MSX-DOS. Source code and binaries of it are
  available at http://www.hitech.com
- The PSG routines (you don't see them, but they are there!) programed
  with the help of the MSX Red Book.
- Mouse Routines (what mouse?) made by Adriano R. C. da Cunha.

- Thanks to (Alphabetical Inversed Order (for those that select a name
  begining with A just to be always on the top of the Credits)

- THE ALIENS, which have abducted me, Carchano and Edison
- Ricardo Jurczyk Pinheiro (aka Juracy) to help me with the MegaSCSI
- Ricardo Bittencourt, by creating BrMSX, the best MSX Emulator!
- Marco Andre Heidtmann, by finding one MSX 2+ and selling it to me!
- Giovanni dos Reis Nunes, which buyed my MSX Audio (Not delivered yet)
- Edison, by creating the Omega Project
- Delavy, to sell me SONYC in Brazilia (and let me know the "Gor Azul")
- DalPoz, because "THE VDP WILL NEVER WORK!"
- Adriano C. R. da Cunha by the Hi-Tech C for MSX
- Ana, to make us a better Ricardo Jurczyk Pinheiro (beat him, but don't kill him).
- Ademir Carchano, to "create" my MSX 2+ Turbo.

Please send your comments to Daniel at
dcaetano@sti.com.br
