summaryrefslogtreecommitdiffstats
path: root/Documentation/input/devices/pxrc.rst
blob: ca11f646bae819e93d9bb4f91030cf21ad5cf6dc (plain)
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
=======================================================
pxrc - PhoenixRC Flight Controller Adapter
=======================================================

:Author: Marcus Folkesson <marcus.folkesson@gmail.com>

This driver let you use your own RC controller plugged into the
adapter that comes with PhoenixRC [1]_ or other compatible adapters.

The adapter supports 7 analog channels and 1 digital input switch.

Notes
=====

Many RC controllers is able to configure which stick goes to which channel.
This is also configurable in most simulators, so a matching is not necessary.

The driver is generating the following input event for analog channels:

+---------+----------------+
| Channel |      Event     |
+=========+================+
|     1   |  ABS_X         |
+---------+----------------+
|     2   |  ABS_Y         |
+---------+----------------+
|     3   |  ABS_RX        |
+---------+----------------+
|     4   |  ABS_RY        |
+---------+----------------+
|     5   |  ABS_RUDDER    |
+---------+----------------+
|     6   |  ABS_THROTTLE  |
+---------+----------------+
|     7   |  ABS_MISC      |
+---------+----------------+

The digital input switch is generated as an `BTN_A` event.

Manual Testing
==============

To test this driver's functionality you may use `input-event` which is part of
the `input layer utilities` suite [2]_.

For example::

    > modprobe pxrc
    > input-events <devnr>

To print all input events from input `devnr`.

References
==========

.. [1] http://www.phoenix-sim.com/
.. [2] https://www.kraxel.org/cgit/input/