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.

PSPDragon is a port on PSP of the version 0.19 of
Xroar.

- Virtual keyboard

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 PSP
trigger keys.

  -------------------------------------
  PSP        DRAGON            (standard)

  Square     2
  Triangle   ENTER
  Circle     1
  Cross      Joystick Fire
  Up         Up
  Down       Down
  Left       Left 
  Right      Right

  Analog     Joystick

  -------------------------------------
  PSP        DRAGON   (left trigger)

  Square     FPS  
  Triangle   LOAD Snapshot
  Circle     Swap digital / Analog
  Cross      SAVE Snapshot
  Up         Up
  Down       Down
  Left       Render mode
  Right      Render mode

  -------------------------------------
  PSP        DRAGON   (right trigger)

  Square     Space
  Triangle   ENTER
  Circle     4
  Cross      Joystick Fire
  Up         Up
  Down       Down
  Left       Left 
  Right      Right


  Analog     Joystick
  
Press Start+L+R to exit and return to eloader.
Press Select    to enter in emulator main menu.
Press Start     open/close the On-Screen keyboard

In the main menu

  RTrigger   Reset the emulator

  Triangle   Go Up directory
  Cross      Valid
  Circle     Valid
  Square     Go Back to the emulator window

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

Use Analog stick to choose one of the 9 squares,
and use Triangle, Square, Cross and Circle to
choose one of the 4 letters of the highlighted
square.

Use LTrigger and RTrigger to see other 9 squares
figures.

- IR keyboard

You can also use IR keyboard. Edit the
pspirkeyb.ini file to specify your IR keyboard
model, and modify eventually layout keyboard files
in the keymap directory.

The following mapping is done :

IR-keyboard   PSP

Cursor        Digital Pad

Tab           Start
Ctrl-W        Start

Escape        Select
Ctrl-Q        Select

Ctrl-E        Triangle
Ctrl-X        Cross
Ctrl-S        Square
Ctrl-F        Circle
Ctrl-Z        L-trigger
Ctrl-C        R-trigger

In the emulator window you can use the IR keyboard
to enter letters, special characters and digits.

- LOADING TAPE FILES (.cas)

If you want to load tape image in the virtual drive
of your emulator, you have to put your tape file
(with .cas file extension) on your PSP memory stick
in the 'tape' directory. 

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

To run the game of your tape file, you have to use
the virtual keyboard (press START key) and type the
command CLOADM followed by ENTER (Triangle). Once
the data are loaded, enter the command EXEC
followed by ENTER.

 LOADING DISK FILES (DSK)
 ------------

If you want to load tape image in the virtual disk
drive of your emulator, you have to put your disk
file (with .dsk file extension) on your PSP memory
stick 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 PSP Keys and DRAGON keys, is not suitable,
and the game can't be played on PSPDRAGON.

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
