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

BeebEm is a famous emulator of the BBC Micro computer
series running on both windows and unix. (see
http://www.mikebuk.dsl.pipex.com/beebem/)

Originally developed for UNIX systems in 1994 by
David Alan Gilbert, it was then ported to windows by
Richard Gellman and Mike Wyatt in 1997.
At the start of October 2005, David Eggleston started
porting the current Windows version of BeebEm
(version 2.3) to FreeBSD. 

PSPBEEB is a port of the version 0.0.4 from 
Dave Eggleston, using GTK and SDL environement.


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

In the PCP emulator window

PSP        BBC Micro

Square     Backspace
Triangle   ENTER
Cross      Space
Circle     Break
Up         Up
Down       Down
Left       Left 
Right      Right

LTrigger   Toogle with L keyboard mapping
RTrigger   Toggle with R keyboard mapping

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

In the main menu

L+R+Start  Exit the emulator
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.

LOADING BBC BOOTABLE DISK FILES
------------

If you want to load disk image in the virtual drive
of your emulator, you have to put your disk file
(with .ssd, .dsd, .adl, .adf, .uef  file extension)
on your PSP memory stick in the 'discs' directory.

Then, while inside PSPBEEB emulator, just press
SELECT to enter in the emulator main menu, and then
using the file selector choose one disk file to load
in the virtual drive of your emulator.

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


LOADING BBC DISK IMAGE FILES
------------

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

Then, while inside PSPBEEB emulator, just press
SELECT to enter in the emulator main menu, and then
using the file selector choose one disk image file to
load in the virtual drive of your emulator, and your
disk is then inserted in the drive '0' or drive '1'
(depending of the menu you have choosen).

(NOTE): You may find on the web .inf and data files
for BBC. You will need to use a convertor tool (such
as bbcim) to convert those file in a disk image
usable with PSPBEEB. For example if you want to build
an image disc with the two files FOO and FOO.INF, you
can use the following command to build 
the disk image :

  bbcim -a my-foo-image.img FOO.INF FOO
  
To display the content of your drive, you have to use
the virtual keyboard (press START key) and type the
CPC command *CAT followed by ENTER (Triangle).  For
example if you have loaded the disk file of the game
"Knight Lore" :

     *CAT

You should see something like this :

     (00)
   Drive  0                   Option 3 (EXEC)
   Dir. : 0.$                 Lib. :0.$
     
     KNIGHT                       KNIGHT1
     KNIGHT2

(NOTE-1) You can also use directly the shortcut in
the emulator menu (Command *CAT option) 
(NOTE-2) To display the content of the second drive,
use *CAT1 command instead of *CAT.

Then if you want to run a basic program KNIGHT that 
is on your drive '0', you have to use the BBC command
'CHAIN' as follow :

     CHAIN "KNIGHT"

(NOTE-1) If the filename of the .img (here
knightlore.img) is also the name of the program you
want to run (here knight) then you can use directly
the Command CHAIN " in the emulator menu. 

If you want to run a machine code program then
you have to the *RUN command instead of CHAIN 
command :

     *RUN KNIGHT (without doublequote)

If you want to run a script program then
you have to the *EXEC command instead of *RUN 
command :

     *EXEC KNIGHT (without doublequote)


(NOTE-2) If the command to run is different from the
filename then you can specify the proper command to
run in the file run.txt, for example :

    mygame=CHAIN "DISC"
or  mygame=*RUN DISC
or  mygame=*EXEC DISC

Then, while using the Command menu, the emulator will
type CHAIN "DISC" (*RUN, or *EXEC) instead of 
CHAIN "mygame" (i.e *RUN mygame or *EXEC mygame). 

Have a look the file run.txt for details about the
syntax.


  Enjoy,

            Zx

