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-05-26 01:17:51 +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,48 @@
+# BlueROV2 (UUV)
+
+<Badge type="tip" text="PX4 v1.12" />
+
+The [BlueROV2](https://bluerobotics.com/store/rov/bluerov2-upgrade-kits/brov2-heavy-retrofit-r1-rp/BlueROV2) is an affordable high-performance underwater vehicle that is perfect for inspections, research, and adventuring.
+
+PX4 provides [experimental support](index.md) for an 8-thrust vectored configuration, known as the _BlueROV2 Heavy Configuration_.
+
+![Hero](../../assets/airframes/sub/bluerov/bluerov_hero.jpg)
+
+## 购买渠道
+
+[BlueROV2](https://bluerobotics.com/store/rov/bluerov2/) + [BlueROV2 Heavy Configuration Retrofit Kit](https://bluerobotics.com/store/rov/bluerov2-upgrade-kits/brov2-heavy-retrofit-r1-rp/)
+
+### Motor Mapping/Wiring
+
+The motors must be wired to the flight controller following the standard instructions supplied by BlueRobotics for this vehicle .
+
+The vehicle will then match the configuration documented in the [Airframe Reference](../airframes/airframe_reference.md#vectored-6-dof-uuv):
+
+<img src="../../assets/airframes/types/Vectored6DofUUV.svg" width="29%" style="max-height: 180px;"/>
+
+- **MAIN1:** motor 1 CCW, bow starboard horizontal, , propeller CCW
+- **MAIN2:** motor 2 CCW, bow port horizontal, propeller CCW
+- **MAIN3:** motor 3 CCW, stern starboard horizontal, propeller CW
+- **MAIN4:** motor 4 CCW, stern port horizontal, propeller CW
+- **MAIN5:** motor 5 CCW, bow starboard vertical, propeller CCW
+- **MAIN6:** motor 6 CCW, bow port vertical, propeller CW
+- **MAIN7:** motor 7 CCW, stern starboard vertical, propeller CW
+- **MAIN8:** motor 8 CCW, stern port vertical, propeller CCW
+
+## Airframe Configuration
+
+BlueROV2 does not come with PX4 installed.
+You will need to:
+
+1. [Install PX4 Firmware](../config/firmware.md#installing-px4-main-beta-or-custom-firmware)
+2. [Set the Airframe](../config/airframe.md).
+   You will need to select the "BlueROV2 Heavy Configuration" as shown:
+   ![QGC - select airframe for BlueROV2 Heay configuration](../../assets/airframes/sub/bluerov/qgc_airframe.jpg)
+
+<!-- what other tuning/testing/ etc? -->
+
+## 视频
+
+<lite-youtube videoid="1sUaURmlmT8" title="PX4 on BlueRov Demo"/>
+
+<!-- @DanielDuecker on github is good person to ask about this frame -->
@@ -0,0 +1,40 @@
+# Submarines (Unmanned Underwater Vehicles - UUV)
+
+<LinkedBadge type="warning" text="Experimental" url="../airframes/#experimental-vehicles"/>
+
+:::warning
+Support for UUVs is [experimental](../airframes/index.md#experimental-vehicles).
+Maintainer volunteers, [contribution](../contribute/index.md) of new features, new frame configurations, or other improvements would all be very welcome!
+
+At time of writing it has only been tested using ROS in offboard mode.
+The following features have not been implemented:
+
+- Modes like missions, depth hold, stabilised manual control, etc.
+- BlueRobotics gripper support.
+
+:::
+
+PX4 has basic support for UUVs.
+
+## Supported Frames
+
+PX4 supports several unmanned underwater vehicle (UUV) frames.
+The set of supported configurations can be seen in [Airframe Reference > Underwater Robots](../airframes/airframe_reference.md#underwater-robot).
+
+### PX4 Compatible (Fully Assembled)
+
+This section lists fully assembled vehicles where you can update the software to run PX4.
+
+- [BlueROV2](../frames_sub/bluerov2.md): Vectored 6 DOF UUV
+
+### Other Frames
+
+- HippoCampus UUV: [Airframe Reference](../airframes/airframe_reference.md#underwater_robot_underwater_robot_hippocampus_uuv_%28unmanned_underwater_vehicle%29), [Gazebo Classic Simulation](../sim_gazebo_classic/vehicles.md#hippocampus-tuhh-uuv)
+
+## 视频
+
+<lite-youtube videoid="1sUaURmlmT8" title="PX4 on BlueRov Demo"/>
+
+---
+
+<lite-youtube videoid="xSXSoUK-iBM" title="Hippocampus UUV in PX4 SITL Gazebo"/>