
1. INTRODUCTION
------------

XZ81 is one of the best emulator of the Sinclair ZX81
computer running on Unix systems. 
See http://rus.members.beeb.net/ for further
informations.

PSPZX81 is a port on PSP of the Unix version 
2.1 of xz81.

Special thanks to Murilo for his feedback and good
advices !


2. CONTROL
------------

2.1 - Virtual keyboard

In the ZX81 emulator window, there are three 
differents mappings (standard, left trigger,
 and right Trigger mappings). 

You can toggle between while playing inside the 
emulator using the two PSP trigger keys.

-------------------------------------
PSP        ZX81             (standard)

Up         Up
Down       Down
Left       Left
Right      Right
Triangle   NewLine
Circle     Y
Cross      N
Square     Rubout/Delete

A-Pad      A,B,C,D

-------------------------------------
PSP        ZX81   (left and right trigger)

same ...

Press Start  + L + R   to exit and return to eloader.
Press Select           to enter in emulator main menu.
Press Start            open/close the virtual 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 virtual 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.

2.2 - 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

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.

3. LOADING ZX81 PROGRAM FILES
------------

If you want to load program files in your emulator,
you have to put your file (with .p or .81 file
extension) on your PSP memory stick in the 'prg'
directory.

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

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

4. LOADING KEY MAPPING FILES
------------

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

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 program
filename (.zip etc ...) then when you load this
program, 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

