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

Xroar is the best emulator of Dragon32/64 and Tandy
Coco home computer running on many systems such as
Linux, Unix, Mac OS X, GP32 and Windows32.  See
http://www.6809.org.uk/dragon/xroar.shtml for
further informations.

GP2X-Dragon is a port of the PSP version to GP2X.

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

In the Dragon 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 GP2X trigger keys.

  -------------------------------------
  GP2X       Dragon          (standard)

  A          2
  B          ENTER
  Y          1
  X          Joystick Fire
  Up         Up
  Down       Down
  Left       Left 
  Right      Right

  Joystick   Joystick

  -------------------------------------
  GP2X       Dragon (left trigger)

  A          Fps
  B          Render
  Y          Load state 
  X          Save state
  Up         Up
  Down       Down
  Left       Left 
  Right      Right

  -------------------------------------
  GP2X       Dragon (right trigger)

  A          Space
  B          ENTER
  Y          4
  X          Auto fire on/off
  Up         Up
  Down       Down
  Left       Dec Fire
  Right      Inc Fire

  Analog     Joystick
  
  Joystick   Up, Down, Left, Rigth
    
  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 DISK FILES (DSK)
 ------------

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

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

To list the content of the disk, you have to use
the virtual keyboard (press START key) and type the
command DIR followed by ENTER.

To run the game MYGAME.BIN on your disk, you have
to use the virtual keyboard and type the command
LOADM"MYGAME" followed by ENTER.  Once the game is
loaded, enter the command EXEC followed by ENTER.

To run a basic game (with .BAS extention) use RUN
command instead of LOADM.

If you want to specify the command to run for given
games then you can do it in the run.txt, using the
following syntax :

  tapename=CLOAD"":EXEC
  diskname=LOADM"RunName":EXEC
  diskname=RUN"RunName"


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

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

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
cartridge or disk file then when you load this
file, 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.


  Enjoy,

      Zx
