Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

rover flight modes: Specify speed axis #3530

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions en/flight_modes_rover/ackermann.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Manual modes require stick inputs from the user to drive the vehicle.

The sticks provide the same "high level" control effects over direction and rate of movement in all manual modes:

- `Left stick up/down`: Drive the rover forwards/backwards (controlling forward speed)
- `Left stick up/down`: Drive the rover forwards/backwards (controlling longitudinal speed)
Copy link
Collaborator

@hamishwillee hamishwillee Dec 20, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess longitudinal is OK. I preferred the original. I.e. this means "controlling forward backward speed".

Suggested change
- `Left stick up/down`: Drive the rover forwards/backwards (controlling longitudinal speed)
- `Left stick up/down`: Drive the rover forwards/backwards (controlling speed)

Why? Well when someone says longitudinal I'm thinking, now what does that mean? It's accurate, but not as immediately obvious as forwards/backwards.

So I'd prefer it done like this and as in https://github.com/PX4/PX4-user_guide/pull/3530/files#r1894469734

BUT you have broad ownership of this area, so if you strongly prefer longitudinal then please merge this as-is. Otherwise change.

- `Right stick left/right`: Make a left/right turn (controlling steering angle ([Manual mode](#manual-mode)) or lateral acceleration ([Acro](#acro-mode) and [Position](#position-mode))).

The manual modes provide progressively increasing levels of autopilot support for maintaining a course, speed, and rate of turn, compensating for external factors such as slopes or uneven terrain.
Expand All @@ -31,7 +31,7 @@ The manual modes provide progressively increasing levels of autopilot support fo

::: details Overview mode mapping to control effect

| Mode | Forward speed | Steering angle/lateral acceleration | Required measurements |
| Mode | Longitudinal speed | Steering angle/lateral acceleration | Required measurements |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could do this as (everywhere)

Suggested change
| Mode | Longitudinal speed | Steering angle/lateral acceleration | Required measurements |
| Mode | Forward/backwards speed | Steering angle/lateral acceleration | Required measurements |

| -------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| [Manual](#manual-mode) | Directly map stick input to motor command. | Directly map stick input to steering angle. | None. |
| [Acro](#acro-mode) | Directly map stick input to motor command. | Stick input creates a lateral acceleration setpoint for the control system to regulate. | Lateral acceleration. |
Expand Down
4 changes: 2 additions & 2 deletions en/flight_modes_rover/differential.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Manual modes require stick inputs from the user to drive the vehicle.

The sticks provide the same "high level" control effects over direction and rate of movement in all manual modes:

- `Left stick up/down`: Drive the rover forwards/backwards (controlling forward speed)
- `Left stick up/down`: Drive the rover forwards/backwards (controlling longitudinal speed)
- `Right stick left/right`: Rotate the rover to the left/right (controlling yaw rate).

The manual modes provide progressively increasing levels of autopilot support for maintaining a course, speed, and rate of turn, compensating for external factors such as slopes or uneven terrain.
Expand All @@ -32,7 +32,7 @@ The manual modes provide progressively increasing levels of autopilot support fo

::: details Overview mode mapping to control effect

| Mode | Forward speed | Yaw rate | Required measurements |
| Mode | Longitudinal speed | Yaw rate | Required measurements |
| ------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| [Manual](#manual-mode) | Directly map stick input to motor commands. | Directly map stick input to motor commands. | None. |
| [Acro](#acro-mode) | Directly map stick input to motor commands. | Stick input creates a yaw rate setpoint for the control system to regulate. | Yaw rate. |
Expand Down
6 changes: 3 additions & 3 deletions en/flight_modes_rover/mecanum.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ Manual modes require stick inputs from the user to drive the vehicle.

The sticks provide the same "high level" control effects over direction and rate of movement in all manual modes:

- `Left stick up/down`: Drive the rover forwards/backwards (controlling forward speed)
- `Left stick up/down`: Drive the rover forwards/backwards (controlling longitudinal speed)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `Left stick up/down`: Drive the rover forwards/backwards (controlling longitudinal speed)
- `Left stick up/down`: Drive the rover forwards/backwards (controlling speed)

- `Left stick left/right`: Yaw the rover to the left/right (controlling yaw rate).
- `Right stick left/right`: Drive the rover left/right (controlling lateral speed)
- `Right stick left/right`: Drive the rover left/right (controlling lateral speed).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `Right stick left/right`: Drive the rover left/right (controlling lateral speed).
- `Right stick left/right`: Drive the rover left/right (controlling speed).


The manual modes provide progressively increasing levels of autopilot support for maintaining a course, speed, and rate of turn, compensating for external factors such as slopes or uneven terrain.

Expand All @@ -33,7 +33,7 @@ The manual modes provide progressively increasing levels of autopilot support fo

::: details Overview mode mapping to control effect

| Mode | Forward/Lateral speed | Yaw rate | Required measurements |
| Mode | Longitudinal/Lateral speed | Yaw rate | Required measurements |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This case perhaps makes sense to keep as longitudinal.

| ------------------------------ | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| [Manual](#manual-mode) | Directly map stick input to motor commands. | Directly map stick input to motor commands. | None. |
| [Acro](#acro-mode) | Directly map stick input to motor commands. | Stick input creates a yaw rate setpoint for the control system to regulate. | Yaw rate. |
Expand Down
Loading