docs: remove docs for deprecated rover module

This commit is contained in:
chfriedrich98
2025-06-17 11:59:05 +02:00
committed by chfriedrich98
parent d2d3d8a5fd
commit beb62c2aad
31 changed files with 1 additions and 805 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 150 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 145 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 116 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 145 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 146 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 146 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 107 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 144 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 553 KiB

View File

@@ -415,7 +415,6 @@
- [Position Tuning](config_rover/position_tuning.md)
- [Complete Vehicles](complete_vehicles_rover/index.md)
- [Aion Robotics R1](complete_vehicles_rover/aion_r1.md)
- [(Deprecated) Rover Position Control](frames_rover/rover_position_control.md)
- [Submarines (experimental)](frames_sub/index.md)
- [BlueROV2](frames_sub/bluerov2.md)
- [Airframes Reference](airframes/airframe_reference.md)

View File

@@ -1,178 +0,0 @@
# (Deprecated) Rover Position Control
<LinkedBadge type="warning" text="Experimental" url="../airframes/#experimental-vehicles"/>
::: warning
This information applies to the original generic rover module that was derived from the fixed wing controller.
It has been replaced with new modules for [Ackermann](../frames_rover/index.md#ackermann) and [Differential-steering](../frames_rover/index.md#differential) rovers.
This module is no longer supported and will receive no updates.
:::
PX4 supports rovers (Unmanned Ground Vehicles - UGVs) with [ackermann and differential](#rover-types) steering.
This section contains build logs/instructions for assembling as well as configuring a number of UGV frames.
![Traxxas Rover Picture](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
## Rover Types
PX4 supports rovers with:
- **Differential steering**: direction is controlled by moving the left- and right-side wheels at different speeds.
This kind of steering commonly used on bulldozers, tanks, and other tracked vehicles.
- **Ackermann steering**: direction is controlled by pointing wheels in the direction of travel ([ackermann geometry](https://en.wikipedia.org/wiki/Ackermann_steering_geometry) compensates for the fact that wheels on the inside and outside of the turn move at different rates).
This kind of steering is used on most commercial vehicles, including cars, trucks etc.
The supported frames can be seen in [Airframes Reference > Rover](../airframes/airframe_reference.md#rover): these are the frames like _Generic Ground Vehicle (Deprecated)_ that include "(Deprecated)" in their name.
## How to Configure a Rover
### Ackermann Steering Configuration
Setting up a rover with Ackermann steering is straightforward:
1. In the [Airframe](../config/airframe.md) configuration, select the _Generic Ground Vehicle (Deprecated)_.
![Select Ackermann steered airframe](../../assets/config/airframe/airframe_rover_ackermann.png)
Select the **Apply and Restart** button.
1. Open the [Actuators Configuration & Testing](../config/actuators.md) to map the steering and throttle functions to flight controller outputs.
### Differential Steering Configuration
1. In the [Airframe](../config/airframe.md) configuration, select either the _Aion Robotics R1 UGV_ or _NXP Cup car: DF Robot GPX (Deprecated)_
![Select Differential steered airframe](../../assets/config/airframe/airframe_rover_aion.png)
Select the **Apply and Restart** button.
1. Open the [Actuators Configuration & Testing](../config/actuators.md) and map the left and right motor functions to flight controller outputs.
## Simulation
[Gazebo Classic](../sim_gazebo_classic/index.md) provides simulations for both types of steering:
- Ackermann: [ackermann rover](../sim_gazebo_classic/vehicles.md#ackermann-ugv)
- Differential: [r1 rover](../sim_gazebo_classic/vehicles.md#differential-ugv)
## Drive Modes (Rover)
Flight modes (or more accurately "Drive modes" for ground vehicles) provide autopilot support to make it easier to manually drive the vehicle, to execute autonomous missions, or to defer control to an external system.
PX4 ground vehicles using the deprecated rover position control module only support [manual mode](#manual-mode), [mission mode](#mission-mode) and [offboard mode](#offboard-mode) (other modes may be offered in a ground station, but these all behave just like manual mode).
### Manual Mode
_Manual mode_ is the only manual mode for ground vehicles on PX4, and requires a manual controller (RC controller, gamepad, joystick etc.).
In this mode, motors are stopped when RC control sticks are centered.
To move the vehicle you move the sticks outside of the center.
As soon as you release the control sticks they will return to the center deadzone.
This will turn off the motors and center the wheels.
There is no active braking, so the vehicle may continue to move until its momentum dissipates.
### Mission Mode
_Mission mode_ is an automatic mode that causes the vehicle to execute a predefined autonomous [mission](../flying/missions.md) plan that has been uploaded to the flight controller.
The mission is typically created and uploaded with a Ground Control Station (GCS) application, such as [QGroundControl](https://docs.qgroundcontrol.com/master/en/).
### Offboard Mode
[Offboard mode](../flight_modes/offboard.md) causes the vehicle to obey position, velocity, or attitude, setpoints provided over MAVLink.
Not all setpoint types make sense for a ground vehicle, or are supported.
::: info
This mode is intended for vehicle control from companion computers and ground stations!
:::
## Further Information
- [Basic Configuration > Flight Modes](../config/flight_mode.md) - How to map RC control switches to specific flight modes
- [Flight Modes (Multicopter)](../flight_modes_mc/index.md)
- [Flight Modes (Fixed-wing)](../flight_modes_fw/index.md)
- [Flight Modes (VTOL)](../flight_modes_vtol/index.md)
## Traxxas Stampede VXL
This vehicle was chosen to understand how a Pixhawk could be used for wheeled platforms.
We chose to use a Traxxas vehicle as they are very popular and it is a very strong brand in the RC community.
The idea was to develop a platform that allows for easy control of wheeled UGVs with an autopilot.
![Traxxas Stampede VXL](../../assets/airframes/rover/traxxas_stampede_vxl/stampede.jpg)
### Parts List
- [Traxxas Stampede](https://traxxas.com/products/models/electric/stampede-vxl-tsm) All of this is used except for the top plastic cover.
- [Pixhawk Mini (Discontinued)](../flight_controller/pixhawk_mini.md)
- 3DR 10S Power Module
- 3DR 433MHz Telemetry Module (EU)
- [Spektrum Dxe Controller](https://www.spektrumrc.com/product/dxe-dsmx-transmitter-with-ar610/SPM1000.html) or other PX4-compatible remotes
- [Spektrum Quad Race Serial Receiver w/Diversity](https://www.spektrumrc.com/product/dsmx-quad-race-serial-receiver-with-diversity/SPM4648.html)
- [PX4Flow](../sensor/px4flow.md) (Deprecated)
### Assembly
The assembly consists of a wooden frame on which all the autopilot parts were attached.
Tests showed that a better vibration insulation should be used, especially for the Pixhawk and the Flow module.
![Stampede Chassis](../../assets/airframes/rover/traxxas_stampede_vxl/stampede_chassis.jpg)
![Wooden Panel Top](../../assets/airframes/rover/traxxas_stampede_vxl/panel_top.jpg)
![Wooden Panel Bottom](../../assets/airframes/rover/traxxas_stampede_vxl/panel_bottom.jpg)
![Traxxas Stampede Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_assembly.jpg)
![Side View Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
![Wodden panel fixture](../../assets/airframes/rover/traxxas_stampede_vxl/mounting_detail.jpg)
For this particular mounting we chose to use the clip supplied with the rover to attach the upper plate.
For this, two supports were 3D printed.
The CAD files are provided [here](https://github.com/PX4/PX4-Autopilot/raw/main/docs/assets/airframes/rover/traxxas_stampede_vxl/plane_holders.zip).
::: warning
It is **HIGHLY RECOMMENDED** to set the ESC in training mode (see Traxxas Stampede Manual), which reduces power to 50%.
:::
### Output Connections
| PWM Output | Actuator |
| ---------- | -------------------- |
| MAIN2 | Steering servo |
| MAIN4 | Throttle (ESC input) |
### Configuration
Rovers are configured using _QGroundControl_ in the same way as any other vehicle.
The main rover-specific configuration is setting the correct frame:
1. Switch to the [Basic Configuration](../config/index.md) section in _QGroundControl_
1. Select the [Airframe](../config/airframe.md) tab.
1. Scroll down the list to find the **Rover** icon.
1. Choose **Traxxas stampede vxl 2wd** from the drop down list.
![Select Airframe](../../assets/airframes/rover/traxxas_stampede_vxl/airframe_px4_rover_traxxas_stampede_vxl_2wd.jpg)
### Usage
At the current time, PX4 only supports Mission and Manual modes when a RC remote is connected.
To use the mission mode, first upload a new mission to the vehicle with QGC. Then, BEFORE ARMING, select `MISSION` and then arm.
:::warning
It is very important to do a mission composed \*only** of normal waypoints (i.e. no takeoff waypoints etc.) and it is crucial to set the waypoint height of **every\*\* waypoint to 0 for correct execution.
Failing to do so will cause the rover to continuously spin around a waypoint.
:::
A correct mission setup looks as follows:
![mission](../../assets/airframes/rover/traxxas_stampede_vxl/correct_mission.jpg)
## Video
<iframe width="740" height="416" src="https://www.youtube.com/embed/N3HvSKS3nCw" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

View File

@@ -84,7 +84,7 @@ Please continue reading for [upgrade instructions](#upgrade-guide).
### Rover
- TBD
- Removed deprecated rover module ([PX4-Autopilot#25054](https://github.com/PX4/PX4-Autopilot/pull/25054)).
### ROS 2

View File

@@ -78,8 +78,6 @@ For the full list of build targets run `make px4_sitl list_vmd_make_targets` (an
| [Standard Plane (with catapult launch)](../sim_gazebo_classic/vehicles.md#standard-plane-with-catapult-launch) | `make px4_sitl gazebo-classic_plane_catapult` |
| [Standard VTOL](../sim_gazebo_classic/vehicles.md#standard-vtol) | `make px4_sitl gazebo-classic_standard_vtol` |
| [Tailsitter VTOL](../sim_gazebo_classic/vehicles.md#tailsitter-vtol) | `make px4_sitl gazebo-classic_tailsitter` |
| [Ackerman UGV (Rover)](../sim_gazebo_classic/vehicles.md#ackermann-ugv) | `make px4_sitl gazebo-classic_rover` |
| [Differential UGV (Rover)](../sim_gazebo_classic/vehicles.md#differential-ugv) | `make px4_sitl gazebo-classic_r1_rover` |
| [HippoCampus TUHH (UUV: Unmanned Underwater Vehicle)](../sim_gazebo_classic/vehicles.md#unmanned-underwater-vehicle-uuv-submarine) | `make px4_sitl gazebo-classic_uuv_hippocampus` |
| [Boat (USV: Unmanned Surface Vehicle)](../sim_gazebo_classic/vehicles.md#hippocampus-tuhh-uuv) | `make px4_sitl gazebo-classic_boat` |
| [Cloudship (Airship)](../sim_gazebo_classic/vehicles.md#airship) | `make px4_sitl gazebo-classic_cloudship` |

View File

@@ -98,26 +98,6 @@ make px4_sitl gazebo-classic_tailsitter
![Tailsitter VTOL in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/tailsitter.png)
<a id="ugv"></a>
## Unmmanned Ground Vehicle (UGV/Rover/Car)
### Ackermann UGV
```sh
make px4_sitl gazebo-classic_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/rover.png)
### Differential UGV
```sh
make px4_sitl gazebo-classic_r1_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/r1_rover.png)
## Unmanned Underwater Vehicle (UUV/Submarine)
### HippoCampus TUHH UUV

View File

@@ -435,7 +435,6 @@
- [Position Tuning](config_rover/position_tuning.md)
- [Complete Vehicles](complete_vehicles_rover/index.md)
- [Aion Robotics R1](complete_vehicles_rover/aion_r1.md)
- [(Deprecated) Rover Position Control](frames_rover/rover_position_control.md)
- [Submarines (experimental)](frames_sub/index.md)
- [블루로브2](frames_sub/bluerov2.md)
- [기체 프레임 정의서](airframes/airframe_reference.md)

View File

@@ -1,178 +0,0 @@
# (Deprecated) Rover Position Control
<LinkedBadge type="warning" text="Experimental" url="../airframes/#experimental-vehicles"/>
:::warning
This information applies to the original generic rover module that was derived from the fixed wing controller.
It has been replaced with new modules for [Ackermann](../frames_rover/index.md#ackermann) and [Differential-steering](../frames_rover/index.md#differential) rovers.
This module is no longer supported and will receive no updates.
:::
PX4 supports rovers (Unmanned Ground Vehicles - UGVs) with [ackermann and differential](#rover-types) steering.
This section contains build logs/instructions for assembling as well as configuring a number of UGV frames.
![Traxxas Rover Picture](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
## Rover Types
PX4 supports rovers with:
- **Differential steering**: direction is controlled by moving the left- and right-side wheels at different speeds.
This kind of steering commonly used on bulldozers, tanks, and other tracked vehicles.
- **Ackermann steering**: direction is controlled by pointing wheels in the direction of travel ([ackermann geometry](https://en.wikipedia.org/wiki/Ackermann_steering_geometry) compensates for the fact that wheels on the inside and outside of the turn move at different rates).
This kind of steering is used on most commercial vehicles, including cars, trucks etc.
The supported frames can be seen in [Airframes Reference > Rover](../airframes/airframe_reference.md#rover): these are the frames like _Generic Ground Vehicle (Deprecated)_ that include "(Deprecated)" in their name.
## How to Configure a Rover
### Ackermann Steering Configuration
Setting up a rover with Ackermann steering is straightforward:
1. In the [Airframe](../config/airframe.md) configuration, select the _Generic Ground Vehicle (Deprecated)_.
![Select Ackermann steered airframe](../../assets/config/airframe/airframe_rover_ackermann.png)
Select the **Apply and Restart** button.
2. Open the [Actuators Configuration & Testing](../config/actuators.md) to map the steering and throttle functions to flight controller outputs.
### Differential Steering Configuration
1. In the [Airframe](../config/airframe.md) configuration, select either the _Aion Robotics R1 UGV_ or _NXP Cup car: DF Robot GPX (Deprecated)_
![Select Differential steered airframe](../../assets/config/airframe/airframe_rover_aion.png)
Select the **Apply and Restart** button.
1. Open the [Actuators Configuration & Testing](../config/actuators.md) and map the left and right motor functions to flight controller outputs.
## 시뮬레이션
[Gazebo Classic](../sim_gazebo_classic/index.md) provides simulations for both types of steering:
- Ackermann: [ackermann rover](../sim_gazebo_classic/vehicles.md#ackermann-ugv)
- Differential: [r1 rover](../sim_gazebo_classic/vehicles.md#differential-ugv)
## Drive Modes (Rover)
Flight modes (or more accurately "Drive modes" for ground vehicles) provide autopilot support to make it easier to manually drive the vehicle, to execute autonomous missions, or to defer control to an external system.
PX4 ground vehicles using the deprecated rover position control module only support [manual mode](#manual-mode), [mission mode](#mission-mode) and [offboard mode](#offboard-mode) (other modes may be offered in a ground station, but these all behave just like manual mode).
### 수동 모드
_Manual mode_ is the only manual mode for ground vehicles on PX4, and requires a manual controller (RC controller, gamepad, joystick etc.).
In this mode, motors are stopped when RC control sticks are centered.
To move the vehicle you move the sticks outside of the center.
조종 스틱을 놓으면 중앙 데드 존으로 돌아갑니다.
This will turn off the motors and center the wheels.
There is no active braking, so the vehicle may continue to move until its momentum dissipates.
### Mission Mode
_Mission mode_ is an automatic mode that causes the vehicle to execute a predefined autonomous [mission](../flying/missions.md) plan that has been uploaded to the flight controller.
The mission is typically created and uploaded with a Ground Control Station (GCS) application, such as [QGroundControl](https://docs.qgroundcontrol.com/master/en/).
### Offboard Mode
[Offboard mode](../flight_modes/offboard.md) causes the vehicle to obey position, velocity, or attitude, setpoints provided over MAVLink.
Not all setpoint types make sense for a ground vehicle, or are supported.
:::info
This mode is intended for vehicle control from companion computers and ground stations!
:::
## 추가 정보
- [Basic Configuration > Flight Modes](../config/flight_mode.md) - How to map RC control switches to specific flight modes
- [Flight Modes (Multicopter)](../flight_modes_mc/index.md)
- [Flight Modes (Fixed-wing)](../flight_modes_fw/index.md)
- [Flight Modes (VTOL)](../flight_modes_vtol/index.md)
## Traxxas Stampede VXL
This vehicle was chosen to understand how a Pixhawk could be used for wheeled platforms.
We chose to use a Traxxas vehicle as they are very popular and it is a very strong brand in the RC community.
The idea was to develop a platform that allows for easy control of wheeled UGVs with an autopilot.
![Traxxas Stampede VXL](../../assets/airframes/rover/traxxas_stampede_vxl/stampede.jpg)
### 부품 목록
- [Traxxas Stampede](https://traxxas.com/products/models/electric/stampede-vxl-tsm) All of this is used except for the top plastic cover.
- [Pixhawk Mini (Discontinued)](../flight_controller/pixhawk_mini.md)
- 3DR 10S 전원 모듈
- 3DR 433MHz Telemetry Module (EU)
- [Spektrum Dxe Controller](https://www.spektrumrc.com/product/dxe-dsmx-transmitter-with-ar610/SPM1000.html) or other PX4-compatible remotes
- [Spektrum Quad Race Serial Receiver w/Diversity](https://www.spektrumrc.com/product/dsmx-quad-race-serial-receiver-with-diversity/SPM4648.html)
- [PX4Flow](../sensor/px4flow.md) (Deprecated)
### 조립
The assembly consists of a wooden frame on which all the autopilot parts were attached.
Tests showed that a better vibration insulation should be used, especially for the Pixhawk and the Flow module.
![Stampede Chassis](../../assets/airframes/rover/traxxas_stampede_vxl/stampede_chassis.jpg)
![Wooden Panel Top](../../assets/airframes/rover/traxxas_stampede_vxl/panel_top.jpg)
![Wooden Panel Bottom](../../assets/airframes/rover/traxxas_stampede_vxl/panel_bottom.jpg)
![Traxxas Stampede Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_assembly.jpg)
![Side View Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
![Wodden panel fixture](../../assets/airframes/rover/traxxas_stampede_vxl/mounting_detail.jpg)
For this particular mounting we chose to use the clip supplied with the rover to attach the upper plate.
For this, two supports were 3D printed.
The CAD files are provided [here](https://github.com/PX4/PX4-Autopilot/raw/main/docs/assets/airframes/rover/traxxas_stampede_vxl/plane_holders.zip).
:::warning
It is **HIGHLY RECOMMENDED** to set the ESC in training mode (see Traxxas Stampede Manual), which reduces power to 50%.
:::
### Output Connections
| PWM Output | 액추에이터 |
| ---------- | --------------------------------------- |
| MAIN2 | Steering servo |
| MAIN4 | Throttle (ESC input) |
### 설정
Rovers are configured using _QGroundControl_ in the same way as any other vehicle.
The main rover-specific configuration is setting the correct frame:
1. Switch to the [Basic Configuration](../config/index.md) section in _QGroundControl_
2. Select the [Airframe](../config/airframe.md) tab.
3. Scroll down the list to find the **Rover** icon.
4. Choose **Traxxas stampede vxl 2wd** from the drop down list.
![Select Airframe](../../assets/airframes/rover/traxxas_stampede_vxl/airframe_px4_rover_traxxas_stampede_vxl_2wd.jpg)
### 사용법
At the current time, PX4 only supports Mission and Manual modes when a RC remote is connected.
To use the mission mode, first upload a new mission to the vehicle with QGC. Then, BEFORE ARMING, select `MISSION` and then arm.
:::warning
It is very important to do a mission composed \*only\*\* of normal waypoints (i.e. no takeoff waypoints etc.) and it is crucial to set the waypoint height of \*\*every\*\* waypoint to 0 for correct execution.
Failing to do so will cause the rover to continuously spin around a waypoint.
:::
A correct mission setup looks as follows:
![mission](../../assets/airframes/rover/traxxas_stampede_vxl/correct_mission.jpg)
## 비디오
<iframe width="740" height="416" src="https://www.youtube.com/embed/N3HvSKS3nCw" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

View File

@@ -78,8 +78,6 @@ For the full list of build targets run `make px4_sitl list_vmd_make_targets` (an
| [Standard Plane (with catapult launch)](../sim_gazebo_classic/vehicles.md#standard-plane-with-catapult-launch) | `make px4_sitl gazebo-classic_plane_catapult` |
| [Standard VTOL](../sim_gazebo_classic/vehicles.md#standard-vtol) | `make px4_sitl gazebo-classic_standard_vtol` |
| [Tailsitter VTOL](../sim_gazebo_classic/vehicles.md#tailsitter-vtol) | `make px4_sitl gazebo-classic_tailsitter` |
| [Ackerman UGV (Rover)](../sim_gazebo_classic/vehicles.md#ackermann-ugv) | `make px4_sitl gazebo-classic_rover` |
| [Differential UGV (Rover)](../sim_gazebo_classic/vehicles.md#differential-ugv) | `make px4_sitl gazebo-classic_r1_rover` |
| [HippoCampus TUHH (UUV: Unmanned Underwater Vehicle)](../sim_gazebo_classic/vehicles.md#unmanned-underwater-vehicle-uuv-submarine) | `make px4_sitl gazebo-classic_uuv_hippocampus` |
| [Boat (USV: Unmanned Surface Vehicle)](../sim_gazebo_classic/vehicles.md#hippocampus-tuhh-uuv) | `make px4_sitl gazebo-classic_boat` |
| [Cloudship (Airship)](../sim_gazebo_classic/vehicles.md#airship) | `make px4_sitl gazebo-classic_cloudship` |

View File

@@ -98,26 +98,6 @@ make px4_sitl gazebo-classic_tailsitter
![Tailsitter VTOL in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/tailsitter.png)
<a id="ugv"></a>
## Unmmanned Ground Vehicle (UGV/Rover/Car)
### Ackermann UGV
```sh
make px4_sitl gazebo-classic_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/rover.png)
### Differential UGV
```sh
make px4_sitl gazebo-classic_r1_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/r1_rover.png)
## Unmanned Underwater Vehicle (UUV/Submarine)
### HippoCampus TUHH UUV

View File

@@ -435,7 +435,6 @@
- [Position Tuning](config_rover/position_tuning.md)
- [Complete Vehicles](complete_vehicles_rover/index.md)
- [Aion Robotics R1](complete_vehicles_rover/aion_r1.md)
- [(Deprecated) Rover Position Control](frames_rover/rover_position_control.md)
- [Submarines (experimental)](frames_sub/index.md)
- [BlueROV2](frames_sub/bluerov2.md)
- [Airframes Reference](airframes/airframe_reference.md)

View File

@@ -1,178 +0,0 @@
# (Deprecated) Rover Position Control
<LinkedBadge type="warning" text="Experimental" url="../airframes/#experimental-vehicles"/>
:::warning
This information applies to the original generic rover module that was derived from the fixed wing controller.
It has been replaced with new modules for [Ackermann](../frames_rover/index.md#ackermann) and [Differential-steering](../frames_rover/index.md#differential) rovers.
This module is no longer supported and will receive no updates.
:::
PX4 supports rovers (Unmanned Ground Vehicles - UGVs) with [ackermann and differential](#rover-types) steering.
This section contains build logs/instructions for assembling as well as configuring a number of UGV frames.
![Traxxas Rover Picture](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
## Rover Types
PX4 supports rovers with:
- **Differential steering**: direction is controlled by moving the left- and right-side wheels at different speeds.
This kind of steering commonly used on bulldozers, tanks, and other tracked vehicles.
- **Ackermann steering**: direction is controlled by pointing wheels in the direction of travel ([ackermann geometry](https://en.wikipedia.org/wiki/Ackermann_steering_geometry) compensates for the fact that wheels on the inside and outside of the turn move at different rates).
This kind of steering is used on most commercial vehicles, including cars, trucks etc.
The supported frames can be seen in [Airframes Reference > Rover](../airframes/airframe_reference.md#rover): these are the frames like _Generic Ground Vehicle (Deprecated)_ that include "(Deprecated)" in their name.
## How to Configure a Rover
### Ackermann Steering Configuration
Setting up a rover with Ackermann steering is straightforward:
1. In the [Airframe](../config/airframe.md) configuration, select the _Generic Ground Vehicle (Deprecated)_.
![Select Ackermann steered airframe](../../assets/config/airframe/airframe_rover_ackermann.png)
Select the **Apply and Restart** button.
2. Open the [Actuators Configuration & Testing](../config/actuators.md) to map the steering and throttle functions to flight controller outputs.
### Differential Steering Configuration
1. In the [Airframe](../config/airframe.md) configuration, select either the _Aion Robotics R1 UGV_ or _NXP Cup car: DF Robot GPX (Deprecated)_
![Select Differential steered airframe](../../assets/config/airframe/airframe_rover_aion.png)
Select the **Apply and Restart** button.
1. Open the [Actuators Configuration & Testing](../config/actuators.md) and map the left and right motor functions to flight controller outputs.
## Симуляція
[Gazebo Classic](../sim_gazebo_classic/index.md) provides simulations for both types of steering:
- Ackermann: [ackermann rover](../sim_gazebo_classic/vehicles.md#ackermann-ugv)
- Differential: [r1 rover](../sim_gazebo_classic/vehicles.md#differential-ugv)
## Drive Modes (Rover)
Flight modes (or more accurately "Drive modes" for ground vehicles) provide autopilot support to make it easier to manually drive the vehicle, to execute autonomous missions, or to defer control to an external system.
PX4 ground vehicles using the deprecated rover position control module only support [manual mode](#manual-mode), [mission mode](#mission-mode) and [offboard mode](#offboard-mode) (other modes may be offered in a ground station, but these all behave just like manual mode).
### Ручний режим
_Manual mode_ is the only manual mode for ground vehicles on PX4, and requires a manual controller (RC controller, gamepad, joystick etc.).
In this mode, motors are stopped when RC control sticks are centered.
To move the vehicle you move the sticks outside of the center.
Як тільки ви відпустите ручки керування, вони повернуться до центральної мертвої зони.
This will turn off the motors and center the wheels.
There is no active braking, so the vehicle may continue to move until its momentum dissipates.
### Mission Mode
_Mission mode_ is an automatic mode that causes the vehicle to execute a predefined autonomous [mission](../flying/missions.md) plan that has been uploaded to the flight controller.
The mission is typically created and uploaded with a Ground Control Station (GCS) application, such as [QGroundControl](https://docs.qgroundcontrol.com/master/en/).
### Offboard Mode
[Offboard mode](../flight_modes/offboard.md) causes the vehicle to obey position, velocity, or attitude, setpoints provided over MAVLink.
Not all setpoint types make sense for a ground vehicle, or are supported.
:::info
This mode is intended for vehicle control from companion computers and ground stations!
:::
## Подальша інформація
- [Базова конфігурація > Режими польоту](../config/flight_mode.md) - Як відповідати перемикачі керування RC конкретним режимам польоту
- [Flight Modes (Multicopter)](../flight_modes_mc/index.md)
- [Flight Modes (Fixed-wing)](../flight_modes_fw/index.md)
- [Flight Modes (VTOL)](../flight_modes_vtol/index.md)
## Traxxas Stampede VXL
This vehicle was chosen to understand how a Pixhawk could be used for wheeled platforms.
We chose to use a Traxxas vehicle as they are very popular and it is a very strong brand in the RC community.
The idea was to develop a platform that allows for easy control of wheeled UGVs with an autopilot.
![Traxxas Stampede VXL](../../assets/airframes/rover/traxxas_stampede_vxl/stampede.jpg)
### Список деталей
- [Traxxas Stampede](https://traxxas.com/products/models/electric/stampede-vxl-tsm) All of this is used except for the top plastic cover.
- [Pixhawk Mini (Discontinued)](../flight_controller/pixhawk_mini.md)
- Модуль живлення 3DR 10S
- 3DR 433MHz Telemetry Module (EU)
- [Spektrum Dxe Controller](https://www.spektrumrc.com/product/dxe-dsmx-transmitter-with-ar610/SPM1000.html) or other PX4-compatible remotes
- [Spektrum Quad Race Serial Receiver w/Diversity](https://www.spektrumrc.com/product/dsmx-quad-race-serial-receiver-with-diversity/SPM4648.html)
- [PX4Flow](../sensor/px4flow.md) (Deprecated)
### Збірка
The assembly consists of a wooden frame on which all the autopilot parts were attached.
Tests showed that a better vibration insulation should be used, especially for the Pixhawk and the Flow module.
![Stampede Chassis](../../assets/airframes/rover/traxxas_stampede_vxl/stampede_chassis.jpg)
![Wooden Panel Top](../../assets/airframes/rover/traxxas_stampede_vxl/panel_top.jpg)
![Wooden Panel Bottom](../../assets/airframes/rover/traxxas_stampede_vxl/panel_bottom.jpg)
![Traxxas Stampede Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_assembly.jpg)
![Side View Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
![Wodden panel fixture](../../assets/airframes/rover/traxxas_stampede_vxl/mounting_detail.jpg)
For this particular mounting we chose to use the clip supplied with the rover to attach the upper plate.
For this, two supports were 3D printed.
The CAD files are provided [here](https://github.com/PX4/PX4-Autopilot/raw/main/docs/assets/airframes/rover/traxxas_stampede_vxl/plane_holders.zip).
:::warning
It is **HIGHLY RECOMMENDED** to set the ESC in training mode (see Traxxas Stampede Manual), which reduces power to 50%.
:::
### Output Connections
| PWM Output | Actuator |
| ---------- | --------------------------------------- |
| MAIN2 | Steering servo |
| MAIN4 | Throttle (ESC input) |
### Налаштування
Rovers are configured using _QGroundControl_ in the same way as any other vehicle.
The main rover-specific configuration is setting the correct frame:
1. Switch to the [Basic Configuration](../config/index.md) section in _QGroundControl_
2. Select the [Airframe](../config/airframe.md) tab.
3. Scroll down the list to find the **Rover** icon.
4. Choose **Traxxas stampede vxl 2wd** from the drop down list.
![Select Airframe](../../assets/airframes/rover/traxxas_stampede_vxl/airframe_px4_rover_traxxas_stampede_vxl_2wd.jpg)
### Використання
At the current time, PX4 only supports Mission and Manual modes when a RC remote is connected.
To use the mission mode, first upload a new mission to the vehicle with QGC. Then, BEFORE ARMING, select `MISSION` and then arm.
:::warning
It is very important to do a mission composed \*only\*\* of normal waypoints (i.e. no takeoff waypoints etc.) and it is crucial to set the waypoint height of \*\*every\*\* waypoint to 0 for correct execution.
Failing to do so will cause the rover to continuously spin around a waypoint.
:::
A correct mission setup looks as follows:
![mission](../../assets/airframes/rover/traxxas_stampede_vxl/correct_mission.jpg)
## Відео
<iframe width="740" height="416" src="https://www.youtube.com/embed/N3HvSKS3nCw" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

View File

@@ -78,8 +78,6 @@ For the full list of build targets run `make px4_sitl list_vmd_make_targets` (an
| [Standard Plane (with catapult launch)](../sim_gazebo_classic/vehicles.md#standard-plane-with-catapult-launch) | `make px4_sitl gazebo-classic_plane_catapult` |
| [Standard VTOL](../sim_gazebo_classic/vehicles.md#standard-vtol) | `make px4_sitl gazebo-classic_standard_vtol` |
| [Tailsitter VTOL](../sim_gazebo_classic/vehicles.md#tailsitter-vtol) | `make px4_sitl gazebo-classic_tailsitter` |
| [Ackerman UGV (Rover)](../sim_gazebo_classic/vehicles.md#ackermann-ugv) | `make px4_sitl gazebo-classic_rover` |
| [Differential UGV (Rover)](../sim_gazebo_classic/vehicles.md#differential-ugv) | `make px4_sitl gazebo-classic_r1_rover` |
| [HippoCampus TUHH (UUV: Unmanned Underwater Vehicle)](../sim_gazebo_classic/vehicles.md#unmanned-underwater-vehicle-uuv-submarine) | `make px4_sitl gazebo-classic_uuv_hippocampus` |
| [Boat (USV: Unmanned Surface Vehicle)](../sim_gazebo_classic/vehicles.md#hippocampus-tuhh-uuv) | `make px4_sitl gazebo-classic_boat` |
| [Cloudship (Airship)](../sim_gazebo_classic/vehicles.md#airship) | `make px4_sitl gazebo-classic_cloudship` |

View File

@@ -98,26 +98,6 @@ make px4_sitl gazebo-classic_tailsitter
![Tailsitter VTOL in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/tailsitter.png)
<a id="ugv"></a>
## Безпілотний наземний засіб (Ровер/Автомобіль)
### Наземний засіб з трапецією Аккермана
```sh
make px4_sitl gazebo-classic_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/rover.png)
### Наземний засіб з диференціалом
```sh
make px4_sitl gazebo-classic_r1_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/r1_rover.png)
## Безпілотний підводний засіб(Підводний човен)
### HippoCampus TUHH

View File

@@ -435,7 +435,6 @@
- [Position Tuning](config_rover/position_tuning.md)
- [Complete Vehicles](complete_vehicles_rover/index.md)
- [Aion Robotics R1](complete_vehicles_rover/aion_r1.md)
- [(Deprecated) Rover Position Control](frames_rover/rover_position_control.md)
- [Submarines (experimental)](frames_sub/index.md)
- [BlueROV2](frames_sub/bluerov2.md)
- [机架参考](airframes/airframe_reference.md)

View File

@@ -1,178 +0,0 @@
# (Deprecated) Rover Position Control
<LinkedBadge type="warning" text="Experimental" url="../airframes/#experimental-vehicles"/>
:::warning
This information applies to the original generic rover module that was derived from the fixed wing controller.
It has been replaced with new modules for [Ackermann](../frames_rover/index.md#ackermann) and [Differential-steering](../frames_rover/index.md#differential) rovers.
This module is no longer supported and will receive no updates.
:::
PX4 supports rovers (Unmanned Ground Vehicles - UGVs) with [ackermann and differential](#rover-types) steering.
This section contains build logs/instructions for assembling as well as configuring a number of UGV frames.
![Traxxas Rover Picture](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
## Rover Types
PX4 supports rovers with:
- **Differential steering**: direction is controlled by moving the left- and right-side wheels at different speeds.
This kind of steering commonly used on bulldozers, tanks, and other tracked vehicles.
- **Ackermann steering**: direction is controlled by pointing wheels in the direction of travel ([ackermann geometry](https://en.wikipedia.org/wiki/Ackermann_steering_geometry) compensates for the fact that wheels on the inside and outside of the turn move at different rates).
This kind of steering is used on most commercial vehicles, including cars, trucks etc.
The supported frames can be seen in [Airframes Reference > Rover](../airframes/airframe_reference.md#rover): these are the frames like _Generic Ground Vehicle (Deprecated)_ that include "(Deprecated)" in their name.
## How to Configure a Rover
### Ackermann Steering Configuration
Setting up a rover with Ackermann steering is straightforward:
1. In the [Airframe](../config/airframe.md) configuration, select the _Generic Ground Vehicle (Deprecated)_.
![Select Ackermann steered airframe](../../assets/config/airframe/airframe_rover_ackermann.png)
Select the **Apply and Restart** button.
2. Open the [Actuators Configuration & Testing](../config/actuators.md) to map the steering and throttle functions to flight controller outputs.
### Differential Steering Configuration
1. In the [Airframe](../config/airframe.md) configuration, select either the _Aion Robotics R1 UGV_ or _NXP Cup car: DF Robot GPX (Deprecated)_
![Select Differential steered airframe](../../assets/config/airframe/airframe_rover_aion.png)
Select the **Apply and Restart** button.
1. Open the [Actuators Configuration & Testing](../config/actuators.md) and map the left and right motor functions to flight controller outputs.
## 仿真
[Gazebo Classic](../sim_gazebo_classic/index.md) provides simulations for both types of steering:
- Ackermann: [ackermann rover](../sim_gazebo_classic/vehicles.md#ackermann-ugv)
- Differential: [r1 rover](../sim_gazebo_classic/vehicles.md#differential-ugv)
## Drive Modes (Rover)
Flight modes (or more accurately "Drive modes" for ground vehicles) provide autopilot support to make it easier to manually drive the vehicle, to execute autonomous missions, or to defer control to an external system.
PX4 ground vehicles using the deprecated rover position control module only support [manual mode](#manual-mode), [mission mode](#mission-mode) and [offboard mode](#offboard-mode) (other modes may be offered in a ground station, but these all behave just like manual mode).
### 手动模式
_Manual mode_ is the only manual mode for ground vehicles on PX4, and requires a manual controller (RC controller, gamepad, joystick etc.).
In this mode, motors are stopped when RC control sticks are centered.
To move the vehicle you move the sticks outside of the center.
一旦释放摇杆,它们将会返回中心停顿区。
This will turn off the motors and center the wheels.
There is no active braking, so the vehicle may continue to move until its momentum dissipates.
### Mission Mode
_Mission mode_ is an automatic mode that causes the vehicle to execute a predefined autonomous [mission](../flying/missions.md) plan that has been uploaded to the flight controller.
The mission is typically created and uploaded with a Ground Control Station (GCS) application, such as [QGroundControl](https://docs.qgroundcontrol.com/master/en/).
### Offboard Mode
[Offboard mode](../flight_modes/offboard.md) causes the vehicle to obey position, velocity, or attitude, setpoints provided over MAVLink.
Not all setpoint types make sense for a ground vehicle, or are supported.
:::info
This mode is intended for vehicle control from companion computers and ground stations!
:::
## 更多信息
- [Basic Configuration > Flight Modes](../config/flight_mode.md) - How to map RC control switches to specific flight modes
- [Flight Modes (Multicopter)](../flight_modes_mc/index.md)
- [Flight Modes (Fixed-wing)](../flight_modes_fw/index.md)
- [Flight Modes (VTOL)](../flight_modes_vtol/index.md)
## Traxxas Stampede VXL
This vehicle was chosen to understand how a Pixhawk could be used for wheeled platforms.
We chose to use a Traxxas vehicle as they are very popular and it is a very strong brand in the RC community.
The idea was to develop a platform that allows for easy control of wheeled UGVs with an autopilot.
![Traxxas Stampede VXL](../../assets/airframes/rover/traxxas_stampede_vxl/stampede.jpg)
### 配件列表
- [Traxxas Stampede](https://traxxas.com/products/models/electric/stampede-vxl-tsm) All of this is used except for the top plastic cover.
- [Pixhawk Mini (Discontinued)](../flight_controller/pixhawk_mini.md)
- 3DR 10S Power Module
- 3DR 433MHz Telemetry Module (EU)
- [Spektrum Dxe Controller](https://www.spektrumrc.com/product/dxe-dsmx-transmitter-with-ar610/SPM1000.html) or other PX4-compatible remotes
- [Spektrum Quad Race Serial Receiver w/Diversity](https://www.spektrumrc.com/product/dsmx-quad-race-serial-receiver-with-diversity/SPM4648.html)
- [PX4Flow](../sensor/px4flow.md) (Deprecated)
### 组装
The assembly consists of a wooden frame on which all the autopilot parts were attached.
Tests showed that a better vibration insulation should be used, especially for the Pixhawk and the Flow module.
![Stampede Chassis](../../assets/airframes/rover/traxxas_stampede_vxl/stampede_chassis.jpg)
![Wooden Panel Top](../../assets/airframes/rover/traxxas_stampede_vxl/panel_top.jpg)
![Wooden Panel Bottom](../../assets/airframes/rover/traxxas_stampede_vxl/panel_bottom.jpg)
![Traxxas Stampede Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_assembly.jpg)
![Side View Final Assembly](../../assets/airframes/rover/traxxas_stampede_vxl/final_side.jpg)
![Wodden panel fixture](../../assets/airframes/rover/traxxas_stampede_vxl/mounting_detail.jpg)
For this particular mounting we chose to use the clip supplied with the rover to attach the upper plate.
For this, two supports were 3D printed.
The CAD files are provided [here](https://github.com/PX4/PX4-Autopilot/raw/main/docs/assets/airframes/rover/traxxas_stampede_vxl/plane_holders.zip).
:::warning
It is **HIGHLY RECOMMENDED** to set the ESC in training mode (see Traxxas Stampede Manual), which reduces power to 50%.
:::
### Output Connections
| PWM Output | 执行器 |
| ---------- | --------------------------------------- |
| MAIN2 | Steering servo |
| MAIN4 | Throttle (ESC input) |
### 配置
Rovers are configured using _QGroundControl_ in the same way as any other vehicle.
The main rover-specific configuration is setting the correct frame:
1. Switch to the [Basic Configuration](../config/index.md) section in _QGroundControl_
2. Select the [Airframe](../config/airframe.md) tab.
3. Scroll down the list to find the **Rover** icon.
4. Choose **Traxxas stampede vxl 2wd** from the drop down list.
![Select Airframe](../../assets/airframes/rover/traxxas_stampede_vxl/airframe_px4_rover_traxxas_stampede_vxl_2wd.jpg)
### 用法
At the current time, PX4 only supports Mission and Manual modes when a RC remote is connected.
To use the mission mode, first upload a new mission to the vehicle with QGC. Then, BEFORE ARMING, select `MISSION` and then arm.
:::warning
It is very important to do a mission composed \*only\*\* of normal waypoints (i.e. no takeoff waypoints etc.) and it is crucial to set the waypoint height of \*\*every\*\* waypoint to 0 for correct execution.
Failing to do so will cause the rover to continuously spin around a waypoint.
:::
A correct mission setup looks as follows:
![mission](../../assets/airframes/rover/traxxas_stampede_vxl/correct_mission.jpg)
## 视频
<iframe width="740" height="416" src="https://www.youtube.com/embed/N3HvSKS3nCw" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

View File

@@ -78,8 +78,6 @@ For the full list of build targets run `make px4_sitl list_vmd_make_targets` (an
| [Standard Plane (with catapult launch)](../sim_gazebo_classic/vehicles.md#standard-plane-with-catapult-launch) | `make px4_sitl gazebo-classic_plane_catapult` |
| [Standard VTOL](../sim_gazebo_classic/vehicles.md#standard-vtol) | `make px4_sitl gazebo-classic_standard_vtol` |
| [Tailsitter VTOL](../sim_gazebo_classic/vehicles.md#tailsitter-vtol) | `make px4_sitl gazebo-classic_tailsitter` |
| [Ackerman UGV (Rover)](../sim_gazebo_classic/vehicles.md#ackermann-ugv) | `make px4_sitl gazebo-classic_rover` |
| [Differential UGV (Rover)](../sim_gazebo_classic/vehicles.md#differential-ugv) | `make px4_sitl gazebo-classic_r1_rover` |
| [HippoCampus TUHH (UUV: Unmanned Underwater Vehicle)](../sim_gazebo_classic/vehicles.md#unmanned-underwater-vehicle-uuv-submarine) | `make px4_sitl gazebo-classic_uuv_hippocampus` |
| [Boat (USV: Unmanned Surface Vehicle)](../sim_gazebo_classic/vehicles.md#hippocampus-tuhh-uuv) | `make px4_sitl gazebo-classic_boat` |
| [Cloudship (Airship)](../sim_gazebo_classic/vehicles.md#airship) | `make px4_sitl gazebo-classic_cloudship` |

View File

@@ -98,26 +98,6 @@ make px4_sitl gazebo-classic_tailsitter
![Tailsitter VTOL in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/tailsitter.png)
<a id="ugv"></a>
## Unmmanned Ground Vehicle (UGV/Rover/Car)
### Ackermann UGV
```sh
make px4_sitl gazebo-classic_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/rover.png)
### Differential UGV
```sh
make px4_sitl gazebo-classic_r1_rover
```
![Rover in Gazebo Classic](../../assets/simulation/gazebo_classic/vehicles/r1_rover.png)
## Unmanned Underwater Vehicle (UUV/Submarine)
### HippoCampus TUHH UUV