xref: /OK3568_Linux_fs/kernel/Documentation/input/devices/pxrc.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun=======================================================
2*4882a593Smuzhiyunpxrc - PhoenixRC Flight Controller Adapter
3*4882a593Smuzhiyun=======================================================
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun:Author: Marcus Folkesson <marcus.folkesson@gmail.com>
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunThis driver let you use your own RC controller plugged into the
8*4882a593Smuzhiyunadapter that comes with PhoenixRC [1]_ or other compatible adapters.
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunThe adapter supports 7 analog channels and 1 digital input switch.
11*4882a593Smuzhiyun
12*4882a593SmuzhiyunNotes
13*4882a593Smuzhiyun=====
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunMany RC controllers is able to configure which stick goes to which channel.
16*4882a593SmuzhiyunThis is also configurable in most simulators, so a matching is not necessary.
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunThe driver is generating the following input event for analog channels:
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun+---------+----------------+
21*4882a593Smuzhiyun| Channel |      Event     |
22*4882a593Smuzhiyun+=========+================+
23*4882a593Smuzhiyun|     1   |  ABS_X         |
24*4882a593Smuzhiyun+---------+----------------+
25*4882a593Smuzhiyun|     2   |  ABS_Y         |
26*4882a593Smuzhiyun+---------+----------------+
27*4882a593Smuzhiyun|     3   |  ABS_RX        |
28*4882a593Smuzhiyun+---------+----------------+
29*4882a593Smuzhiyun|     4   |  ABS_RY        |
30*4882a593Smuzhiyun+---------+----------------+
31*4882a593Smuzhiyun|     5   |  ABS_RUDDER    |
32*4882a593Smuzhiyun+---------+----------------+
33*4882a593Smuzhiyun|     6   |  ABS_THROTTLE  |
34*4882a593Smuzhiyun+---------+----------------+
35*4882a593Smuzhiyun|     7   |  ABS_MISC      |
36*4882a593Smuzhiyun+---------+----------------+
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunThe digital input switch is generated as an `BTN_A` event.
39*4882a593Smuzhiyun
40*4882a593SmuzhiyunManual Testing
41*4882a593Smuzhiyun==============
42*4882a593Smuzhiyun
43*4882a593SmuzhiyunTo test this driver's functionality you may use `input-event` which is part of
44*4882a593Smuzhiyunthe `input layer utilities` suite [2]_.
45*4882a593Smuzhiyun
46*4882a593SmuzhiyunFor example::
47*4882a593Smuzhiyun
48*4882a593Smuzhiyun    > modprobe pxrc
49*4882a593Smuzhiyun    > input-events <devnr>
50*4882a593Smuzhiyun
51*4882a593SmuzhiyunTo print all input events from input `devnr`.
52*4882a593Smuzhiyun
53*4882a593SmuzhiyunReferences
54*4882a593Smuzhiyun==========
55*4882a593Smuzhiyun
56*4882a593Smuzhiyun.. [1] http://www.phoenix-sim.com/
57*4882a593Smuzhiyun.. [2] https://www.kraxel.org/cgit/input/
58