1evdev-joystick(1)           General Commands Manual          evdev-joystick(1)
2
3
4

NAME

6       evdev-joystick - joystick calibration program
7

SYNOPSIS

9       evdev-joystick --help
10       evdev-joystick --listdevs
11       evdev-joystick --showcal <device‐path>
12       evdev-joystick --evdev device‐path> [--axis <axis>] [--minimum <value>]
13       [--maximum <value>] [--deadzone <value>] [--fuzz <value>]
14

DESCRIPTION

16       evdev-joystick calibrates joysticks.  Calibrating  a  joystick  ensures
17       the positions on the various axes are correctly interpreted.
18

OPTIONS

20       --h, --help
21              Print out a summary of available options.
22
23       --l, --listdevs
24              List all joystick devices found.
25
26       --s, --showcal <device‐path>
27              Show the current calibration for the specified device.
28
29       --e, --evdev <device‐path>
30              Specify the joystick device to modify.
31
32       --a, --axis <axis>
33              Specify  the  axis  to  modify  (by  default, all axes are cali‐
34              brated).
35
36       --m, --minimum <value>
37              Change the minimum for the current joystick.
38
39       --M, --maximum <value>
40              Change the maximum for the current joystick.
41
42       --d, --deadzone <value>
43              Change the deadzone for the current joystick.
44
45       --f, --fuzz <value>
46              Change the fuzz for the current joystick.
47

CALIBRATION

49       Using the Linux input system, joysticks are expected to produce  values
50       between  -32767 and 32767 for axes, with 0 meaning the joystick is cen‐
51       tred.  Thus, full‐left should produce -32767 on the X axis,  full‐right
52       32767 on the X axis, full‐forward -32767 on the Y axis, and so on.
53
54       Many  joysticks  and gamepads (especially older ones) are slightly mis‐
55       aligned; as a result they may not use the full range of values (for the
56       extremes of the axes), or more annoyingly they may not give 0 when cen‐
57       tred.  Calibrating a joystick provides the kernel with information on a
58       joystick's  real  behaviour, which allows the kernel to correct various
59       joysticks' deficiencies and produce consistent output as  far  as  joy‐
60       stick‐using software is concerned.
61
62       jstest(1) is useful to determine whether a joystick is calibrated: when
63       run, it should produce all 0s when the joystick is at  rest,  and  each
64       axis  should  be  able  to produce the values -32767 and 32767.  Analog
65       joysticks should produce values in between 0 and the extremes, but this
66       is  not  necessary;  digital  directional  pads work fine with only the
67       three values.
68

SEE ALSO

70       ffset(1), jstest(1).
71

AUTHORS

73       evdev-joystick was  written  by  Stephen  Anthony,  based  on  VDrift's
74       G25manage tool.
75
76       This manual page was written by Stephen Kitt <steve@sk2.org>.
77
78
79
80evdev-joystick                   Apr 19, 2016                evdev-joystick(1)
Impressum