Move PX4 Guide source into /docs (#24490)

* Add vitepress tree * Update existing workflows so they dont trigger on changes in the docs path * Add nojekyll, package.json, LICENCE etc * Add crowdin docs upload/download scripts * Add docs flaw checker workflows * Used docs prefix for docs workflows * Crowdin obvious fixes * ci: docs move to self hosted runner runs on a beefy server for faster builds Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: don't run build action for docs or ci changes Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: update runners Signed-off-by: Ramon Roche <mrpollo@gmail.com> * Add docs/en * Add docs assets and scripts * Fix up editlinks to point to PX4 sources * Download just the translations that are supported * Add translation sources for zh, uk, ko * Update latest tranlsation and uorb graphs * update vitepress to latest --------- Signed-off-by: Ramon Roche <mrpollo@gmail.com> Co-authored-by: Ramon Roche <mrpollo@gmail.com>
2026-06-01 19:07:45 +08:00 · 2025-03-13 16:08:27 +11:00
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions
@@ -0,0 +1,201 @@
+# Gazebo Vehicles
+
+This topic lists/displays the vehicles supported by the PX4 [Gazebo](../sim_gazebo_gz/index.md) simulation, and the `make` commands required to run them (the commands are run from a terminal in the **PX4-Autopilot** directory).
+
+The models are included in PX4 as a submodule that is fetched from the [Gazebo Models Repository](../sim_gazebo_gz/gazebo_models.md).
+
+Supported vehicle types include: mutirotor, VTOL, Plane, Rover.
+
+:::warning
+See [Gazebo Classic Vehicles](../sim_gazebo_classic/vehicles.md) for vehicles that work with the older [Gazebo "Classic" simulation](../sim_gazebo_classic/index.md).
+Note that vehicle models are not interchangable between the two versions of the simulator: the vehicles on this page only work with (new) [Gazebo](../sim_gazebo_gz/index.md).
+:::
+
+## 多旋翼
+
+### X500 Quadrotor
+
+```sh
+make px4_sitl gz_x500
+```
+
+### X500 Quadrotor with Visual Odometry
+
+```sh
+make px4_sitl gz_x500_vision
+```
+
+![x500 in Gazebo](../../assets/simulation/gazebo/vehicles/x500.png)
+
+### X500 Quadrotor with Depth Camera (Front-facing)
+
+This model has a forward-facting depth camera attached, modelled on the [OAK-D](https://shop.luxonis.com/products/oak-d).
+
+```sh
+make px4_sitl gz_x500_depth
+```
+
+![x500 with depth camera in Gazebo](../../assets/simulation/gazebo/vehicles/x500_depth.png)
+
+### X500 Quadrotor with Monocular Camera
+
+This model has a simple monocular camera sensor attached (there is no physical camera visualization on the model itself).
+
+```sh
+make px4_sitl gz_x500_mono_cam
+```
+
+:::info
+The camera cannot yet be used to stream video or for image capture in QGroundControl.
+[PX4-Autopilot#22563](https://github.com/PX4/PX4-Autopilot/issues/22563) can be used to track the additional work needed to fully enable these use cases.
+:::
+
+### X500 Quadrotor with Monocular Camera (Down-facing)
+
+This model has a simple monocular camera sensor attached facing down (there is no physical camera visualization on the model itself).
+
+This can be used with the [Aruco world](../sim_gazebo_gz/worlds.md#aruco) to test precision landing.
+
+```sh
+make px4_sitl gz_x500_mono_cam_down
+```
+
+### X500 Quadrotor with 1D LIDAR (Down-facing)
+
+This model has a LIDAR attached to the bottom, modelled on the [Lightware LW20/C](../sensor/sfxx_lidar.md).
+
+It has a range between 0.1 and 100m.
+
+The model can be used for testing [rangefinder](../sensor/rangefinders.md) use cases like [landing](../flight_modes_mc/land.md) or [terrain following](../flying/terrain_following_holding.md).
+
+```sh
+make px4_sitl gz_x500_lidar_down
+```
+
+![x500 with down-facing 1D LIDAR in Gazebo](../../assets/simulation/gazebo/vehicles/x500_lidar_down.png)
+
+### X500 Quadrotor with 1D LIDAR (Front-facing)
+
+This model has a LIDAR attached to the front, modelled on the [Lightware LW20/C](../sensor/sfxx_lidar.md).
+
+It has a range between 0.2 and 100m.
+
+The model can be used for testing [Collision Prevention](../computer_vision/collision_prevention.md#gazebo-simulation).
+
+```sh
+make px4_sitl gz_x500_lidar_front
+```
+
+![x500 with front-facing 1D LIDAR in Gazebo](../../assets/simulation/gazebo/vehicles/x500_lidar_front.png)
+
+### X500 Quadrotor with 2D LIDAR
+
+This model has a 2D LIDAR attached, modelled on the [Hokuyo UTM-30LX](https://www.hokuyo-aut.jp/search/single.php?serial=169).
+It has a range between 0.1 and 30m, and scans in a 270° arc.
+The model can be used for testing [Collision Prevention](../computer_vision/collision_prevention.md#gazebo-simulation).
+
+```sh
+make px4_sitl gz_x500_lidar_2d
+```
+
+![x500 with 2D LIDAR in Gazebo](../../assets/simulation/gazebo/vehicles/x500_lidar_2d.png)
+
+:::info
+The sensor information is written to the [ObstacleDistance](../msg_docs/ObstacleDistance.md) UORB message used by collision prevention.
+:::
+
+### X500 Quadrotor with Gimbal (Front-facing)
+
+This model has a [gimbal](../advanced/gimbal_control.md) attached to the front with angular ranges of
+
+- roll: [- $\frac{\pi}{4}$, $\frac{\pi}{4}$]
+- pitch: [- $\frac{3\pi}{4}$, $\frac{\pi}{4}$]
+- yaw: infinite rotation
+
+The gimbal joints uses position control with a kinematic chain ZXY.
+
+![Quadrotor(x500) with gimbal (Front-facing) in Gazebo](../../assets/simulation/gazebo/vehicles/x500_gimbal.png).
+
+```sh
+make px4_sitl gz_x500_gimbal
+```
+
+## Plane/Fixed-wing
+
+### Standard Plane
+
+```sh
+make px4_sitl gz_rc_cessna
+```
+
+![Plane in Gazebo](../../assets/simulation/gazebo/vehicles/rc_cessna.png)
+
+### Advanced Plane
+
+<Badge type="tip" text="PX4 v1.15" />
+
+```sh
+make px4_sitl gz_advanced_plane
+```
+
+![Advanced Plane in Gazebo](../../assets/simulation/gazebo/vehicles/advanced_plane.png)
+
+:::info
+The difference between the Advanced Plane and the "regular plane" lies in the Lift Physics that the two models use:
+
+- You can configure the _Advanced Lift Drag_ plugin used by the model to more closely match a particular vehicle using the [Advanced Lift Drag Tool](../sim_gazebo_gz/tools_avl_automation.md).
+- For more detail on the lift calculations for the Advanced Plane, see [PX4-SITL_gazebo-classic/src/liftdrag_plugin/README.md](https://github.com/PX4/PX4-SITL_gazebo-classic/blob/main/src/liftdrag_plugin/README.md)
+
+:::
+
+## 垂直起降
+
+### 标准垂起固定翼
+
+```sh
+make px4_sitl gz_standard_vtol
+```
+
+![Standard VTOL in Gazebo Classic](../../assets/simulation/gazebo/vehicles/standard_vtol.png)
+
+### Quad Tailsitter VTOL
+
+A VTOL tailsitter model that uses differential thrust for pitch, roll, and yaw control.
+
+```sh
+make px4_sitl gz_quadtailsitter
+```
+
+![VTOL quad tailsitter in Gazebo](../../assets/simulation/gazebo/vehicles/vtol_quad_tailsitter.png)
+
+### 倾转旋翼式VTOL
+
+A VTOL Plane, where during the transition the front two motors will tilt forward and be used for forward thrust.
+
+```sh
+make px4_sitl gz_tiltrotor
+```
+
+![VTOL Tiltrotor in Gazebo](../../assets/simulation/gazebo/vehicles/vtol_tiltrotor.png)
+
+## 无人车
+
+### Differential Rover
+
+[Differential Rover](../frames_rover/differential.md) uses the [rover world](../sim_gazebo_gz/worlds.md#rover) by default.
+
+```sh
+make px4_sitl gz_r1_rover
+```
+
+![Differential Rover in Gazebo](../../assets/simulation/gazebo/vehicles/rover_differential.png)
+
+### Ackermann Rover
+
+[Ackermann Rover](../frames_rover/ackermann.md) uses the [rover world](../sim_gazebo_gz/worlds.md#rover) by default.
+
+```sh
+make px4_sitl gz_rover_ackermann
+```
+
+![Ackermann Rover in Gazebo](../../assets/simulation/gazebo/vehicles/rover_ackermann.png)