diff --git a/en/flight_modes_rover/auto.md b/en/flight_modes_rover/auto.md index c4ac465aa6b..5c1274f3384 100644 --- a/en/flight_modes_rover/auto.md +++ b/en/flight_modes_rover/auto.md @@ -51,7 +51,7 @@ To summarize, the following parameters can be used to tune the controller: | [PP_LOOKAHD_MIN](../advanced_config/parameter_reference.md#PP_LOOKAHD_MIN) | Minimum value for the look ahead radius | m | ::: note -Both [Ackermann](../frames_rover/ackermann_rover.md#mission-parameters) and [differential](../frames_rover/differential_rover.md#tuning-mission) rovers have further tuning parameters that are specific to the respective modules. +Both [Ackermann](../frames_rover/ackermann_rover.md#mission-parameters) and [differential](../frames_rover/differential_rover.md#auto-modes) rovers have further tuning parameters that are specific to the respective modules. ::: # Return Mode diff --git a/en/flight_modes_rover/manual.md b/en/flight_modes_rover/manual.md index 2219b9c218f..f6e059c5a9e 100644 --- a/en/flight_modes_rover/manual.md +++ b/en/flight_modes_rover/manual.md @@ -40,7 +40,7 @@ This mode requires a yaw rate estimate. Acro Mode is similar to [Manual mode](#manual-mode), but with closed-loop yaw rate control. In this mode, the left stick input remains open-loop for forward speed control, while the right stick input commands a desired yaw rate setpoint, which is then maintained by the rover's closed-loop control system. -See [Tuning(basic)](../frames_rover/differential_rover.md#tuning-basic) to go through the necessary setup to use acro mode for differential rovers. +See the tuning for [acro mode](../frames_rover/differential_rover.md#acro-mode) section to go through the necessary setup to use acro mode for differential rovers. ## Stabilized Mode @@ -52,12 +52,12 @@ Stabilized mode is only supported for differential rovers. This mode requires a yaw rate and yaw estimate. ::: -Just like [Acro mode](../flight_modes_rover/acro.md), the left stick input remains open-loop for forward speed control, while the right stick input commands a desired yaw rate setpoint, which is then maintained by the rover's closed-loop control system. +Just like [acro mode](#acro-mode), the left stick input remains open-loop for forward speed control, while the right stick input commands a desired yaw rate setpoint, which is then maintained by the rover's closed-loop control system. But in addition to that, the rover will do closed loop yaw (or heading) control when the right stick is centered or in other words if the yaw rate setpoint is zero. This means that the rover will maintain the current heading if the user only gives throttle input, but no yaw rate input. -Compared to [Acro mode](../flight_modes_rover/acro.md), this mode is much better at driving in a straight line as it can more effectively reject disturbances. +Compared to [acro mode](#acro-mode), this mode is much better at driving in a straight line as it can more effectively reject disturbances. -See the tuning for [acro mode](../frames_rover/differential_rover.md#acro) section to go through the necessary setup to use acro mode for differential rovers. +See the tuning for [stabilized mode](../frames_rover/differential_rover.md#stabilized-mode) section to go through the necessary setup to use acro mode for differential rovers. ## Position Mode @@ -72,4 +72,6 @@ This mode requires a yaw rate, yaw, speed and position estimate. This is the most advanced manual mode. It uses _closed loop yaw rate control_, _closed loop speed control_ and a special logic for driving a straight line when there is no yaw rate input. In this mode, moving the left stick up/down commands a desired speed setpoint and moving the right stick left and right commands a desired yaw rate setpoint which are both close-loop controlled by the autopilot. If there is no yaw rate input, the controller will remember the gps coordiantes and yaw (or heading) of the vehicle and use those to construct a line that the rover will then follow using the [pure pursuit](../flight_modes_rover/auto.md#pure-pursuit-guidance-logic) algorithm (same path following algorithm as in auto modes). -This way the rover is even better than the [stabilized mode](#stabilized-mode) at rejecting disturbances when driving a straight line. +This way the rover is even better than the [stabilized mode](#stabilized-mode) at rejecting disturbances when driving a straight line. +See the tuning for [position mode](../frames_rover/differential_rover.md#position-mode) section to go through the necessary setup to use acro mode for differential rovers. + diff --git a/en/releases/main.md b/en/releases/main.md index af208b1b389..223c1c34edd 100644 --- a/en/releases/main.md +++ b/en/releases/main.md @@ -90,16 +90,16 @@ This release contains a major rework for the rover support in PX4: - Complete restructure of the [rover related documentation](../frames_rover/index.md). - New firmware build specifically for [rovers](../frames_rover/index.md#flashing-the-rover-build) ([PX4-Autopilot#22675](https://github.com/PX4/PX4-Autopilot/pull/22675)). - New module dedicated to [differential-steering rovers](../frames_rover/differential_rover.md) ([PX4-Autopilot#22402](https://github.com/PX4/PX4-Autopilot/pull/22402), [PX4-Autopilot#23430](https://github.com/PX4/PX4-Autopilot/pull/23430) and [PX4-Autopilot#23629](https://github.com/PX4/PX4-Autopilot/pull/23629)) - - The module currently supports [manual mode](../flight_modes_rover/index.md#manual-mode), [acro mode](../flight_modes_rover/index.md#acro-mode), [mission mode](../flight_modes_rover/index.md#mission-mode), [return mode](../flight_modes_rover/index.md#return-mode) and implements a [guidance state machine](../frames_rover/differential_rover.md#state-machine) to fully leverage the power of differential-steering. + - The module currently supports [manual mode](../flight_modes_rover/manual.md#manual-mode), [acro mode](../flight_modes_rover/manual.md#acro-mode), [stabilized mode](../flight_modes_rover/manual.md#stabilized-mode), [position mode](../flight_modes_rover/manual.md#position-mode) and [auto modes](../flight_modes_rover/auto.md). - New module dedicated to [Ackermann rovers](../frames_rover/ackermann_rover.md) ([PX4-Autopilot#23024](https://github.com/PX4/PX4-Autopilot/pull/23024), [PX4-Autopilot#23310](https://github.com/PX4/PX4-Autopilot/pull/23383), [PX4-Autopilot#23423](https://github.com/PX4/PX4-Autopilot/pull/23423) and [PX4-Autopilot#23572](https://github.com/PX4/PX4-Autopilot/pull/23572)). - - The module currently supports [manual mode](../flight_modes_rover/index.md#manual-mode), [mission mode](../flight_modes_rover/index.md#mission-mode), [return mode](../flight_modes_rover/index.md#return-mode) and adds a number of [Ackermann specific features](../frames_rover/ackermann_rover.md#tuning-advanced). + - The module currently supports [manual mode](../flight_modes_rover/manual.md#manual-mode) and [auto modes](../flight_modes_rover/auto.md). - Restructure of the [rover airframe](../airframes/airframe_reference.md#rover) numbering convention ([PX4-Autopilot#23506](https://github.com/PX4/PX4-Autopilot/pull/23506)). This also introduces several [new rover airframes](../airframes/airframe_reference.md#rover): - Generic Differential Rover `50000`. - Generic Ackermann Rover `51000`. - Axial SCX10 2 Trail Honcho `51001`. -- Library for the [pure pursuit guidance algorithm](../flight_modes_rover/index.md#pure-pursuit-guidance-logic) that is shared among the rover modules ([PX4-Autopilot#23387](https://github.com/PX4/PX4-Autopilot/pull/23387) and [PX4-Autopilot#23438](https://github.com/PX4/PX4-Autopilot/pull/23438)). +- Library for the [pure pursuit guidance algorithm](../flight_modes_rover/auto.md#pure-pursuit-guidance-logic) that is shared among the rover modules ([PX4-Autopilot#23387](https://github.com/PX4/PX4-Autopilot/pull/23387) and [PX4-Autopilot#23438](https://github.com/PX4/PX4-Autopilot/pull/23438)). - [Simulation](../frames_rover/index.md#simulation) for differential-steering and Ackermann rovers in gazebo (for release notes see `r1_rover` and `rover_ackermann` in [simulation](#simulation)). - Deprecation of the [rover position control](../frames_rover/rover_position_control.md) module: Note that the legacy rover module still exists but has been superseded by the new dedicated modules.