File: INSTALL

package info (click to toggle)
libjsw 1:1.5.0-5
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,240 kB
  • ctags: 1,098
  • sloc: ansic: 14,128; cpp: 2,838; makefile: 162
file content (87 lines) | stat: -rw-r--r-- 3,031 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
            J O Y S T I C K   W R A P P E R   L I B R A R Y

           I N S T A L L A T I O N   I N S T R U C T I O N S


    IMPORTANT: Read README regarding 1.4.x to 1.5.x upgrades!!


    Basic Installation Overview:

	Step 1: Install the Linux Joystick Driver.
	Step 2: Install the Joystick Wrapper Library (libjsw).
	Step 3: Install the Joystick Calibrator.
	Step 4: Calibrate your Joystick(s).


    1. Install the Linux Joystick Driver:

        * Skip this step if you already have it installed. If you
	* have Linux 2.2.15 or newer then you may already have the
	* joystick drivers installed.
	* Check in /lib/modules/<linux_version>/misc/*joy*

	Download the Linux Joystick Driver 1.2.x at:

	http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/

	-or-

	ftp://atrey.karlin.mff.cuni.cz/pub/linux/joystick/joystick-1.2.14.tar.gz

	Follow the instructions included in the Linux Joystick Driver.
	Rememeber to load the joystick driver modules and install the
	joystick.h header file in /usr/include/linux/joystick.h.


    2. Install the Joystick Wrapper Library (libjsw):

	Go to the `libjsw' subdirectory. Choose the most appropriate
	Makefile for your system and type `make -f <makefile>' to
	start the building process.

	If there were no errors, then type `make -f <makefile> install'
	(make sure you have root privlages).


    3. Build the Joystick Calibrator:

	Go to the `jscalibrator' subdirectory. Choose the most appropriate
	Makefile for your system and type `make -f <makefile>' to
	start the building process.

	If there were no errors, then type `make -f <makefile> install'
	(make sure you have root privlages).


    4. Calibrating your Joystick(s):

	Make sure that you have your Linux Joystick Driver is installed
	properly and that the required modules are loaded. For example,
	type `modprobe joy-analog' to load the analog joystick driver.
	More advanced loading would look like `modprobe joy-analog
	js_an=0x201,1023,0'. Read the Linux Joystick driver documentation
	for a list of available arguments that can be passed while you
	modprobe it.

	Next run `jscalibrator' to calibrate the joystick(s) and
	create the $HOME/.joystick calibration file. If you already
	have this file and it contains calibrations for other joysticks,
	they will be preserved and the new joystick calibrations will
	be appended in that file. Go to Help->How To Calibrate for
	steps on how to calibrate your joystick using `jscalibrator'.

	Be sure to CENTER your joystick axis BEFORE clicking
	on the calibration button before and after calibration,
	move your axises only DURING calibration. This is to help
	center the axises and calculate their tolorance for error
	correction properly.

	The logical layout (look in the view menu) offers more advanced
	axis caliberation options, try it!

	For a starting point on games that use libjsw, check out
	http://wolfpack.twu.net/

                                                                 ------
                                                                 LIBJSW