From d36d3f758bc0a1e0edd19b33795ca56c431599a4 Mon Sep 17 00:00:00 2001 From: Ubuntu Date: Fri, 20 Nov 2026 18:32:26 +0100 Subject: [PATCH] docs(rover): explain the differential waypoint slow down The slow down diagram shows the arrival speed formula, but the text did not say which parameters v_max and v_gain are, or how the change of direction at the waypoint is normalized. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Ubuntu --- docs/en/config_rover/position_tuning.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/en/config_rover/position_tuning.md b/docs/en/config_rover/position_tuning.md index abae2be9545..32148aa91f7 100644 --- a/docs/en/config_rover/position_tuning.md +++ b/docs/en/config_rover/position_tuning.md @@ -141,7 +141,8 @@ Differential rovers employ the following state machine to make full use of a dif These transition thresholds can be set with [RD_TRANS_DRV_TRN](#RD_TRANS_DRV_TRN) and [RD_TRANS_TRN_DRV](#RD_TRANS_TRN_DRV). -In mission modes [RD_TRANS_DRV_TRN](#RD_TRANS_DRV_TRN) is also used to slow down the rover to a standstill, if the transition angle between the waypoints exceeds this threshold: +In mission modes [RD_TRANS_DRV_TRN](#RD_TRANS_DRV_TRN) is also used to slow down the rover to a standstill at a waypoint, if the change of direction $\theta_{WP}$ at that waypoint exceeds this threshold. +Otherwise the rover passes the waypoint at the speed $v_{trans}$, where $v_{max}$ is the speed limit [RO_SPEED_LIM](../advanced_config/parameter_reference.md#RO_SPEED_LIM), $v_{gain}$ is [RO_SPEED_RED](#RO_SPEED_RED) (no slow down if it is disabled) and $\theta_{WP,norm}$ is $\theta_{WP}$ normalized from $[0\degree, 180\degree]$ to $[0, 1]$: ![Differential slow down effect](../../assets/config/rover/differential_slow_down_effect.svg)