Files
PX4-Autopilot/docs/en/config/joystick.md
T
zdeno-sekerakandHamish Willee c0d2c54308 docs(joystick): rewrite joystick setup page (#29240)
* docs(joystick): rewrite joystick setup page

* Style changes in joystick.md compared to the last version

* docs(joystick): address reviewer feedback, rewrote pages based on it, update images, and remove unused assets

* docs: restore accidentally deleted micronav image

* docs(docs): Keep the better aspects

---------

Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
2026-10-29 14:10:32 +11:00

2.5 KiB

Joystick Setup

A computer joystick or gamepad connected to a device running QGroundControl (QGC) can be used to manually control a vehicle (instead/as well as an RC Transmitter)

This approach sends Joystick movements and button presses encoded as MAVLink MANUAL_CONTROL messages over the telemetry link, which provides a simpler and (usually) less expensive setup than using a separate RC Transmitter.

Joysticks are often used in Integrated Ground Control Stations and are recommended for flying the vehicle in simulation.

Gamepad connected to a computer running QGroundControl, which communicates with a PX4 vehicle over a telemetry radio link

::: tip A joystick-based controller system requires a reliable, high-bandwidth telemetry link to ensure that the vehicle is responsive to joystick movements. RC Transmitters are preferred for vehicle bring-up and in other situations where very low latency is required. :::

Enabling PX4 Joystick Support

Information about how to set up a joystick is covered in: QGroundControl > Joystick Setup.

::: tip Radio Setup is not required when using only a joystick. :::

Note:

Developer Information

QGC uses the cross-platform SDL library to convert joystick movements to MAVLink MANUAL_CONTROL messages, which are then sent to PX4 over the telemetry link. PX4 also defines fixed meanings to some of the MANUAL_CONTROL button values, and these are mapped to user-selected functions by the ground station.

Other ground stations and MAVLink APIs may use different methods to map joystick controls to MANUAL_CONTROL messages.