INTRODUCTION
------------

fMSX emulates MSX, MSX2, and MSX2+ 8bit home
computers. It runs MSX/MSX2/MSX2+ software on many
different platforms including Windows, MacOS, Unix,
MSDOS, AmigaOS, etc. 
See http://fms.komkon.org/fMSX/ for further 
informations.

GP2XMSX is a port on GP2X of the version 2.7.0.40 of
fMSX-SDL from Vincent van Dam.

Many thanks to Paul Bosselaar for his help on sound
improvement. Thanks should goes also to Pou-chan who
developped the multiple keyboard mapping feature.
Finally i would like to thanks JBurton for his 
feedback on memory size and PAL/NTSC issue.

CONTROL
------------

In the MSX emulator window, there are three different
mapping (standard, left trigger, and right Trigger
mappings).  You can toggle between while playing
inside the emulator using the two trigger keys.

-------------------------------------
GP2X        MSX            (standard)

A           Delete
B           Space
Y           Return
X           Fire
Up          Up
Down        Down
Left        Left
Right       Right

Joystick    Joystick

-------------------------------------
GP2X        MSX      (left trigger)

A           FPS
B           Swap joystick / cursor
Y           Load state
X           Save state
Up          Up
Down        Down
Left        Render 
Right       Render

-------------------------------------
GP2X        MSX      (right trigger)

A           Escape
B           Space
Y           Return
X           Auto-fire
Up          Up
Down        Down
Left        Dec auto-fire
Right       Inc auto-fire

Joystick    Joystick

Press Select  to enter in emulator main menu.
Press Start   open/close the On-Screen keyboard

In the main menu

RTrigger   Reset the emulator

Y   Go Up directory
X   Valid
B   Valid
A   Go Back to the emulator window

The On-Screen Keyboard of "Danzel" and "Jeff Chen"

Use the stick to choose one of the 9 squares, and
use A, B, X, Y to choose one of the 4 letters 
of the highlighted square.

Use LTrigger and RTrigger to see other 9 squares 
figures.

LOADING MSX ROM FILES
------------

If you want to load rom image in your emulator, you
have to put your rom file (with .zip, .rom, .mx1 or
.mx2 file extension) on your GP2X memory in the
'roms' directory.

Then, while inside GP2XSX emulator, just press
SELECT to enter in the emulator main menu, and then
using the file selector choose one rom file to load
in your emulator.

Back to the emulator window, the rom should stard
automatically.

(NOTE): To eject a ROM choose "Eject Rom" inside the
emulator menu.

LOADING DISK FILES
------------

If you want to load disk image in the virtual drive
A or B of your emulator, you have to put your disk
file (with .dsk file extension, or gzipped disk
file with .dsz file extension) on your SD memory
in the 'disk' directory.  

(NOTE): gzipped disk files are not writable

You proceed as previously described for ROM files,
and your disk is then inserted in the drive 'A' of
your emulator.

To start your disk, you have to choose the "Reset
MSX" option and back to the emulator window, the MSX
should reboot and stard your disk automatically.

(NOTE): you must eject any present rom before
starting a disk, or only the ROM will start instead
of your disk image.
  

LOADING KEY MAPPING FILES
------------

For given games, the default keyboard mapping between
GP2X Keys and MSX keys, is not suitable, and the game
can't be played on GP2X-MSX.

To overcome the issue, you can write your own
mapping file. Using notepad for example you can edit
a file with the .kbd extension and put it in the kbd
directory.

For the exact syntax of those mapping files, have a
look on sample files already presents in the kbd
directory (default.kbd etc ...).

After writting such keyboard mapping file, you can
load them using the main menu inside the emulator.

If the keyboard filename is the same as the rom
filename (.zip etc ...) then when you load this rom,
the corresponding keyboard file is automatically
loaded !

You can now use the Keyboard menu and edit, load and
save your keyboard mapping files inside the emulator.
The Save option save the .kbd file in the kbd
directory using the "Game Name" as filename. The game
name is displayed on the right corner in the emulator
menu.

(NOTE): If you have saved the state of a game, then a
thumbnail image will be displayed in the file requester 
while selecting any file (rom, disk, keyboard,
settings) with game name, to help you to recognize
that game later.


  Enjoy,

            Zx

