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 @@
#
## 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
## Очікувані результати
- Зліт повинен бути плавним, коли газ піднято
- Місія має бути завантажена при першій спробі
- Дрон повинен автоматично злетіти після ввімкнення автоматичного режиму
- 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))
## Очікувані результати
- Зліт повинен бути плавним, коли газ піднято
- Немає коливання в жодному з перерахованих режимів польоту
- Після посадки, коптер не повинен підскакувати на землі