mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-04-14 10:07:39 +08:00
31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# Joystick Setup
|
|
|
|
A [computer joystick](https://en.wikipedia.org/wiki/Joystick) or gamepad connected through _QGroundControl_ can be used to manually control the vehicle (_instead_ of using an [RC Transmitter](../config/radio.md)).
|
|
|
|
This approach may be used by manual control units that have an integrated ground control station (like the _UAVComponents_ [MicroNav](https://www.uxvtechnologies.com/ground-control-stations/micronav) shown below).
|
|
Joysticks are also commonly used to allow developers to fly the vehicle in simulation.
|
|
|
|
|
|
|
|
:::tip
|
|
[Radio Setup](../config/radio.md) is not required if using only a joystick (because a joystick is not an RC controller)!
|
|
:::
|
|
|
|
::: info
|
|
_QGroundControl_ uses the cross-platform [SDL2](https://www.libsdl.org/index.php) library to convert joystick movements to MAVLink [MANUAL_CONTROL](https://mavlink.io/en/messages/common.html#MANUAL_CONTROL) 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](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/setup_view/joystick.html).
|
|
|
|
In summary:
|
|
|
|
- Open _QGroundControl_
|
|
- Set the parameter [COM_RC_IN_MODE=1](../advanced_config/parameter_reference.md#COM_RC_IN_MODE) - `Joystick`
|
|
- See [Parameters](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/setup_view/parameters.html) 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**.
|