18c2ecf20Sopenharmony_ci=======================================================
28c2ecf20Sopenharmony_cipxrc - PhoenixRC Flight Controller Adapter
38c2ecf20Sopenharmony_ci=======================================================
48c2ecf20Sopenharmony_ci
58c2ecf20Sopenharmony_ci:Author: Marcus Folkesson <marcus.folkesson@gmail.com>
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_ciThis driver let you use your own RC controller plugged into the
88c2ecf20Sopenharmony_ciadapter that comes with PhoenixRC [1]_ or other compatible adapters.
98c2ecf20Sopenharmony_ci
108c2ecf20Sopenharmony_ciThe adapter supports 7 analog channels and 1 digital input switch.
118c2ecf20Sopenharmony_ci
128c2ecf20Sopenharmony_ciNotes
138c2ecf20Sopenharmony_ci=====
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ciMany RC controllers is able to configure which stick goes to which channel.
168c2ecf20Sopenharmony_ciThis is also configurable in most simulators, so a matching is not necessary.
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ciThe driver is generating the following input event for analog channels:
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci+---------+----------------+
218c2ecf20Sopenharmony_ci| Channel |      Event     |
228c2ecf20Sopenharmony_ci+=========+================+
238c2ecf20Sopenharmony_ci|     1   |  ABS_X         |
248c2ecf20Sopenharmony_ci+---------+----------------+
258c2ecf20Sopenharmony_ci|     2   |  ABS_Y         |
268c2ecf20Sopenharmony_ci+---------+----------------+
278c2ecf20Sopenharmony_ci|     3   |  ABS_RX        |
288c2ecf20Sopenharmony_ci+---------+----------------+
298c2ecf20Sopenharmony_ci|     4   |  ABS_RY        |
308c2ecf20Sopenharmony_ci+---------+----------------+
318c2ecf20Sopenharmony_ci|     5   |  ABS_RUDDER    |
328c2ecf20Sopenharmony_ci+---------+----------------+
338c2ecf20Sopenharmony_ci|     6   |  ABS_THROTTLE  |
348c2ecf20Sopenharmony_ci+---------+----------------+
358c2ecf20Sopenharmony_ci|     7   |  ABS_MISC      |
368c2ecf20Sopenharmony_ci+---------+----------------+
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ciThe digital input switch is generated as an `BTN_A` event.
398c2ecf20Sopenharmony_ci
408c2ecf20Sopenharmony_ciManual Testing
418c2ecf20Sopenharmony_ci==============
428c2ecf20Sopenharmony_ci
438c2ecf20Sopenharmony_ciTo test this driver's functionality you may use `input-event` which is part of
448c2ecf20Sopenharmony_cithe `input layer utilities` suite [2]_.
458c2ecf20Sopenharmony_ci
468c2ecf20Sopenharmony_ciFor example::
478c2ecf20Sopenharmony_ci
488c2ecf20Sopenharmony_ci    > modprobe pxrc
498c2ecf20Sopenharmony_ci    > input-events <devnr>
508c2ecf20Sopenharmony_ci
518c2ecf20Sopenharmony_ciTo print all input events from input `devnr`.
528c2ecf20Sopenharmony_ci
538c2ecf20Sopenharmony_ciReferences
548c2ecf20Sopenharmony_ci==========
558c2ecf20Sopenharmony_ci
568c2ecf20Sopenharmony_ci.. [1] http://www.phoenix-sim.com/
578c2ecf20Sopenharmony_ci.. [2] https://www.kraxel.org/cgit/input/
58