# Joystick Setup

A computer joystick (opens new window) or gamepad connected through QGroundControl can be used to manually control the vehicle (instead of using an RC Transmitter).

This approach may be used by manual control units that have an integrated ground control station (like the UAVComponents MicroNav (opens new window) shown below). Joysticks are also commonly used to allow developers to fly the vehicle in simulation.

Joystick MicroNav

TIP

Radio Setup is not required if using only a joystick (because a joystick is not an RC controller)!

Note

QGroundControl uses the cross-platform SDL2 (opens new window) library to convert joystick movements to MAVLink MANUAL_CONTROL (opens new window) messages, which are then sent to PX4 over the telemetry channel. In consequence, a joystick-based controller system requires a reliable high bandwidth telemetry channel to ensure that the vehicle is responsive to joystick movements.

# Enabling PX4 Joystick Support

Information about how to set up a joystick is covered in: QGroundControl > Joystick Setup (opens new window).

In summary:

  • Open QGroundControl
  • Set the parameter COM_RC_IN_MODE=1 - Joystick
    • See Parameters (opens new window) for information about setting parameters
    • Setting the parameter to 2 or 3 also enables Joystick under some circumstances.
  • Connect the joystick
  • Configure the connected joystick in: Vehicle Setup > Joystick.