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>
This commit is contained in:
Hamish Willee
2025-03-13 16:08:27 +11:00
committed by GitHub
co-authored by Ramon Roche
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions
+47
View File
@@ -0,0 +1,47 @@
# 测试 MC_01 - 手动模式
## Objective
To test that manual flight modes work as expected
## Preflight
Ensure that the drone can go into Stabilized, Altitude, Position mode while still on the ground
## Flight Tests
❏ 自稳
&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response 1:1
&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response 1:1
❏ 高度
&nbsp;&nbsp;&nbsp;&nbsp;❏ Vertical position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response 1:1
&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response set to Climbs/Descend rate
❏ 定点
&nbsp;&nbsp;&nbsp;&nbsp;❏ Horizontal position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;❏ Vertical position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response set to Climbs/Descend rate
&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response set to Pitch/Roll/Yaw rates
❏ Landing
&nbsp;&nbsp;&nbsp;&nbsp;❏ Land in Position mode with the throttle below 40%
&nbsp;&nbsp;&nbsp;&nbsp;❏ Upon touching ground, copter should disarm automatically within 2 seconds (disarm time set by parameter: [COM_DISARM_LAND](../advanced_config/parameter_reference.md#COM_DISARM_LAND))
## 预期成果
- 当油门升高时,起飞应该是平稳的
- 在上述任何飞行模式中都不应出现振荡
- 着陆时,直升机不应在地面上反弹
@@ -0,0 +1,69 @@
# 测试 MC_02-完全自主
## Objective
To test the auto modes such as Mission, RTL, etc...
## Preflight
Plan a mission on the ground. Ensure the mission has
- Takeoff as first waypoint
- Changes in Altitude throughout the mission
- Last waypoint is an RTL
- Duration of 5 to 6 minutes
## Flight Tests
❏ Mission
&nbsp;&nbsp;&nbsp;&nbsp;❏ Auto take-off
&nbsp;&nbsp;&nbsp;&nbsp;❏ Changes in Altitude throughout the mission
&nbsp;&nbsp;&nbsp;&nbsp;❏ First waypoint set to Takeoff
&nbsp;&nbsp;&nbsp;&nbsp;❏ Enable Mission End RTL
&nbsp;&nbsp;&nbsp;&nbsp;❏ Duration of 5 to 6 minutes
&nbsp;&nbsp;&nbsp;&nbsp;❏ Auto Disarm on land
❏ Mission + Manual arm
&nbsp;&nbsp;&nbsp;&nbsp;❏ Arm in any manual mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage Auto (Mission Mode) to trigger take-off
&nbsp;&nbsp;&nbsp;&nbsp;❏ Observe tracking, cornering and proper RTL performance
&nbsp;&nbsp;&nbsp;&nbsp;❏ Upon touching ground, copter should disarm automatically within 2 seconds (disarm time set by parameter: [COM_DISARM_LAND](../advanced_config/parameter_reference.md#COM_DISARM_LAND))
❏ RTL
&nbsp;&nbsp;&nbsp;&nbsp;❏ Arm and takeoff in position mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Fly out ~10m from start point
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage RTL Mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Observe tracking, cornering and proper RTL performance
## 预期成果
- 当油门升高时,起飞应该是平稳的
- 任务应该在第一次尝试时上传
- 使用 Auto 时飞机应自动起飞
- Vehicle shoud adjust height to RTL altitude before returning home
- 着陆时,直升机不应在地面上反弹
<!--
MC_002 - Full autonomous
- Make sure the auto-disarm is enabled
- QGC open test1_mission.plan and sync to the vehicle
- Takeoff from QGC start mission slider
- Check the vehicle completes the mission
- Let the vehicle to auto land, take manual control if needed and explain the reason in log description.
- Check the vehicle disarms by itself.
-->
@@ -0,0 +1,59 @@
# 测试 MC_03 - 自动手动混合
## Objective
To test switching between various modes
## Preflight
- Takeoff as first waypoint
- Changes in Altitude throughout the mission
- Last waypoint is a NOT RTL, but a normal waypoint
- Duration of 5 to 6 minutes
## Flight Tests
❏ Position + Mission
&nbsp;&nbsp;&nbsp;&nbsp;❏ Arm and take-off in Position mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage Auto
&nbsp;&nbsp;&nbsp;&nbsp;❏ Observe tracking and cornering
&nbsp;&nbsp;&nbsp;&nbsp;❏ Once mission has completed, switch back to Position mode
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;❏ Horizontal position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;❏ Vertical position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response set to Climbs/Descend rate
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response set to Pitch/Roll/Yaw rates
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage RTL
&nbsp;&nbsp;&nbsp;&nbsp;❏ Upon touching ground, copter should disarm automatically within 2 seconds (disarm time set by parameter: COM_DISARM_LAND)
❏ Mission + Controller interruption
&nbsp;&nbsp;&nbsp;&nbsp;❏ Arm and take-off in Position mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage Auto
&nbsp;&nbsp;&nbsp;&nbsp;❏ Observe tracking and cornering
&nbsp;&nbsp;&nbsp;&nbsp;❏ Before the last waypoint mission is reached, move the control sticks and ensure the vehicle goes into Position flight mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Manually move the drone over the landing zone
&nbsp;&nbsp;&nbsp;&nbsp;❏ Engage Land mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Upon touching ground, copter should disarm automatically within 2 seconds (disarm time set by parameter: COM_DISARM_LAND)
## 预期成果
- 当油门升高时,起飞应该是平稳的
- 在上述任何飞行模式中都不应出现振荡
- When moving the control sticks the drone goes into Position flight mode
- 着陆时,直升机不应在地面上反弹
@@ -0,0 +1,37 @@
# 测试 MC_04 -故障安全测试
## Objective
Test RC loss, data link loss, and low battery failsafes.
## Preflight
- Verify RC Loss action is Return to Land
- Verify Data Link Loss action is Return to Land and the timeout is 10 seconds
- Verify Battery failsafe
- Action is Return to Land
- Battery Warn Level is 25%
- Battery Failsafe Level is 20%
- Battery Emergency Level is 15%
## Flight Tests
❏ RC 损失
&nbsp;&nbsp;&nbsp;&nbsp;❏ Take off in Altitude mode
&nbsp;&nbsp;&nbsp;&nbsp;❏ Move at least 20 meters away home position
&nbsp;&nbsp;&nbsp;&nbsp;❏Turn off RC and check the vehicle returns to home position, wait for the descent and turn on the RC and take over.
❏ Datalink Loss
&nbsp;&nbsp;&nbsp;&nbsp;❏ Disconnect telemetry, vehicle should return to home position after 10 seconds, wait for the descent and reconnect the telemetry radio
❏ Battery Failsafe
&nbsp;&nbsp;&nbsp;&nbsp;❏ Confirm the warning message is received in QGC
&nbsp;&nbsp;&nbsp;&nbsp;❏ Confirm the vehicle returns to land on failsafe level
&nbsp;&nbsp;&nbsp;&nbsp;❏ Confirm the vehicle lands on emergency land level
@@ -0,0 +1,42 @@
# 测试 MC_05-室内飞行(手动模式)
## 何时使用此测试卡
- 新建初次飞行
- 当需要在受限区域复现问题时
- 可能存在稳定性问题的实验性构建
- 测试已更换和/或修改的硬件
## 解锁并起飞
❏ 设置飞行模式以稳定和布防
❏ 升高油门起飞
## 飞行
❏ 自稳
&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response 1:1
&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response 1:1
❏ 高度
&nbsp;&nbsp;&nbsp;&nbsp;❏ Vertical position should hold current value with stick centered
&nbsp;&nbsp;&nbsp;&nbsp;❏ Pitch/Roll/Yaw response 1:1
&nbsp;&nbsp;&nbsp;&nbsp;❏ Throttle response set to Climbs/Descend rate
## 降落
❏ 以稳定或高度模式着陆,油门低于 40%
❏ Upon touching ground, copter should disarm automatically within 2 seconds (disarm time set by parameter: [COM_DISARM_LAND](../advanced_config/parameter_reference.md#COM_DISARM_LAND))
## 预期成果
- 当油门升高时,起飞应该是平稳的
- 在上述任何飞行模式中都不应出现振荡
- 着陆时,直升机不应在地面上反弹