ArmPalmSpec - A spectrum emulator for ARM based PalmOS computers.

(Written by Matan Ziv-Av, matan@svgalib.org)


Version 0.1
===========
Tested on Tungsten E only.
Emulates spectrum 48.
Sound is not perfect.
Read snapshots (.sna format) from databases, or 
 from /Palm/Programs/Spec directory on memory card.
On screen (Spectrum+) keyboard.
9 Hard keys can be defined to any spectrum key
 or kempston joystick key.


Loading
=======
To load the game to the Palm, you need to transfer the files armpalmspec.prc
and pdbs/spectrum.pdb. This can be done with the pilot-xfer program from
pilot-link package:
pilot-xfer -m armpalmspec.prc -m pdbs/spectrum.pdb
Or using the palm desktop software by dragging those files somwhere and the
synching.


Using
=====
In the main screen: 
Load -  loads the selected snapshot and starts running.
Cont -  continues running from current position (reset spectrum after loading
        program).
Speed - selects speed (0 means max possible, 1 means twice normal, 2 means
        normal).
Sound - enables/disables sound (a bell is displayed when sound enabled).
Define- define the meaning of the nine hardware keys.

In emulator:
The blue dot in the blue square (left of the keyboard) is the reset button.
To hide the keyboard, tap left to the keyboard on the top part (near the TRUE
VIDEO and DELETE keys). To redisplay, tap again in the same place.
To return to main screen, tap right to the keyboard (near the BREAK and ENTER
keys).


Converting snapshots to PDBs
============================
Using par tool by David Williams, it can be done with the command:

par c hskiing.pdb hskiing Data PSPe hskiing.sna

Or using Java program files2pdb:

java files2pdb -n maziacs -t Data -c PSPe maziacs.pdb maziacs.sna


Compiling
=========
On a Linux computer, install pilrc, prc-tools and prc-tools-arm. Then download
the palm SDK from palmsource developer site (and the file PalmChars.h) from
somewhere. If all is installed correctly make should compile the file
armpalmspec.prc.


History/Credits
===============
This program is a port of the PalmSpec program by Alex Bassas Serramia
(which is written mostly in 68K assembler) to C.

The z80 emulator was written by Ian Collier, but I got it by way of 
Russell Marks' zx81 emulator called z81.
