Subject: Joystick drivers 0.7. Loadable module.
From: [email-masked] (Carlos M. Puchol)
Date: Fri, 18 Mar 1994 18:09:00 GMT
Newsgroups: comp.os.linux.announce

Begin2
Title        = joystick
Version      = 0.7
Desc1        = Kernel drivers for analog joysticks as a loadable module.
Desc2        = Supports up to two joysticks.
Desc3        =
Desc4        =
Desc5        =
Author       = Art Smith
AuthorEmail  = [email-masked]
Maintainer   = Carlos Puchol
MaintEmail   = [email-masked]
Site1        = sunsite.unc.edu
Path1        = /pub/linux/patches
File1        = joystick-0.7.tar.gz
FileSize1    = 11K
Required1    = joystick and game port hardware
CopyPolicy1  = Freely distributable.
Keywords     = joystick
Comment1     = This version is for the releases of Linux
Comment2     = that support loadable modules.
Entered      = 16MAY94
EnteredBy    = Carlos Puchol
CheckedEmail = [email-masked]
End

---------------------------------------------------------------------
The README file.

This file describes how to install the joystick device driver version
0.7 for the Linux 1.0 kernel (or previous, if it has the loadable
modules).

This package includes the following files:

Makefile         - make file for package and test programs
README           - this README file
joystick-0.7.lsm - Linux Software map entry for this package
joystick.c       - The device driver itself
joystick.h       - The device driver include file
js.4             - man page
js.c             - test program
jscal.c          - calibration program

INSTALLATION:

You will need the modutils to load and remove loadable modules from
the kernel. They can be found in the kernel directories of the
Linux sites.

$ make joystick.o

Then in your rc.local insert a line like this:

$ insmod /conf/modules/joystick.o

(chose your own path for joystick.o, I have a conf dir for modules).
You can try this as well by becoming root.

If you have a kernel where it has the proper symbol table, you
shouldn't have problems. If not (quite likely for now, unfortunately),
then you will get an error similar to this:

$ insmod joystick.o
_xtime undefined
$

If that is the case, then you need to add those ``undefined'' calls to
the kernel symbol table in linux/kernel/ksyms.S, then remake the
kernel, save a backup of your current 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
([email-masked]). Changes in version 0.6 were made by Jeff
Tranter ([email-masked]). This version brought to you by
Carlos Puchol ([email-masked]).

Changes from version 0.6 to 0.7
- Support for loadable modules

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...)

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.