Documentation for RTFMJoyMod Version 3.12

***********************************************
*                                             *
*      This module will not run without       *
*      RTFM joystick hardware in place        *
*                                             *
***********************************************

Three SWIs are provided, the first of which is the
Acorn defined joystick reading SWI (A3010 etc.)

SWI Joystick_Read (&43F40) : Acorn defined
Entry : R0 = Joystick to read (0 or 1)
Exit  : R0 contains a 4 byte number ;
&00000000 :1 is reserved (0)
  1 2 3 4  2 contains fire button status(1=on 0=off)
           3 contains left/right status(-64,0,64)
           4 contains down/up status(-64,0,64)

SWI Joystick_State (&43F41)
Entry : R0 = 0,1 to set joysticks off,on
             255 to return joystick status in R0
Exit  : R0 preserved when setting, contains
           joystick status (0,1) when reading

SWI Joystick_Ports (&43F42)
Entry : R0 = 0,1 to set swap status on,off
             255 to return swap status in R0
Exit  : R0 preserved when setting, contains
           swap status (0,1) when reading

All other registers are preserved by all three SWIs.

The last two SWIs are only provided in RTFMJoyMod,
do not rely on them being provided by the Acorn
module (although feel free to copy the standard
for other emulation modules!)

The module code (except for RTFMs slightly modified
hardware checking routine) are copyright Adam Gundy,
ARG Systems.
This code is PD provided the entire application
ONLY is distributed.
Commercial companies wishing to use part (or all)
of the code should contact me for terms.
Do not modify and pass on the code without sending
me a copy:

Snail Mail:

The Gables
Strubby
Alford
Lincs.