This file describes how to install the joystick device driver version
0.6 in the Linux 0.99pl15 kernel.

This package includes the following files:

Makefile         - make file for package and test programs
README           - this README file
joystick-0.6.lsm - Linux Software map entry for this package
joystick.patch   - patch for 0.99pl15 kernel
js.4             - man page
js.c             - test program
jscal.c          - calibration program

If you have a different kernel level you may have to apply the patches
by hand. If you are upgrading from a previous release of the joystick
drivers you will need to uninstall the previous version.

Unpack the tar file in any convenient working directory. Then apply
the patch using:

% cd /usr/src             <- or wherever you keep your kernel source
% patch <joystick.patch   <- use appropriate path to wherever you installed
                             the joystick driver package

After this, cd to /usr/src/linux and configure the joystick driver
into the kernel using:

% make config

and answering 'y' to the joystick question.

Save a backup of your current kernel, remake the kernel, and reboot
the new kernel. On bootup you should see a message displayed such as
the following:

js_init: found 2 joysticks

To use the joystick driver, two files should be made in /dev. To do
this, go to the directory where the joystick distribution was
installed and do:

% make devs

To test the driver, compile and run the programs "js" and "jscal" by
doing:

% make all

The program "js" simply prints out the state of the buttons and
joystick values continuously.

The program "jscal" allows the joysticks to be calibrated to return
values between 0 and 0xff (or as close as can be done with
shifting).

To install the man page, do:

% make man

The original joystick driver was written by Art Smith
(asmith@cbnewsd.att.com). Changes in this version were made by Jeff
Tranter (tranter@software.mitel.com).

Changes from version 0.5 to 0.6:
- updated to work with 0.99pl15 kernel (and hopefully 1.0)
- wrote man page
- enhanced "js" and "jscal" programs
- various minor changes (indenting code, fixing typos, etc...)

I would like to get feedback on whether this driver is useful and any
problems you may find. If this version is stable, I would like to
lobby to have it moved into the standard kernel sources.

One application that supports the joystick driver is the "fly8" flight
simulator program. Check any of the major Linux archive sites for the
latest version.
