This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Andreas Regel <andreas.regel@powarman.de>

Project's homepage:          www.powarman.de

Latest version available at: www.powarman.de/vdr_plugins.htm

See the file COPYING for license information.

Description:
This plugin allows using a joystick as a remote control for VDR. I recommend
a joystick with a minimum of 2 axes and 4 buttons.
To use the plugin your joystick has to be connected to your game port and its
kernel module has to be loaded. To test this you can use the command

  jstest <joystick device>

for example

  jstest /dev/js0

When the plugin is loaded for the first time, vdr will prompt you to learn
the keys of the joystick remote control.

You can specify the jostick device through command line parameter -d (default:
/dev/js0):

  vdr -P'joystick -d /dev/js1'


Axis mapping
------------
With version 0.0.3 axis mappings became possible. They have to be defined in a
file called mappings.conf which has to reside in the subdirectory joystick in
your plugin-config directory, p. e. /video/plugins/joystick/mappings.conf

Each entry represents one axis in the following format:
  <axis number>:<off value>:<threshold>:<value1>:<value2>:<value3>: ...

This is an example which works for the hat of my Wingman Extreme:
  2:7800:1000:0:-12000:-32700
and leads to the following results:
        value        button
    6800 -   8800     none
   -1000 -   1000     0
  -13000 - -11000     1
  -33700 - -31700     2

If an axis is not mapped in mappings.conf a standard entry will be generated
which has the same effect like the axis handling of version 0.0.2:
  <num>:0:20000:-25000:25000