mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2025-12-09 15:58:31 +08:00
Docs/test card update (#25451)
* added VIO test card * added tickets for regression testing * Subedit --------- Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
This commit is contained in:
BIN
docs/assets/test_cards/dshot_log_output.png
Normal file
BIN
docs/assets/test_cards/dshot_log_output.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 269 KiB |
@@ -823,6 +823,8 @@
|
||||
- [Test MC_04 - Failsafe Testing](test_cards/mc_04_failsafe_testing.md)
|
||||
- [Test MC_05 - Manual Modes (Inside)](test_cards/mc_05_indoor_flight_manual_modes.md)
|
||||
- [Test MC_06 - Optical Flow (Inside)](test_cards/mc_06_optical_flow.md)
|
||||
- [Test MC_07 - VIO (Inside)](test_cards/mc_07_vio.md)
|
||||
- [Test MC_08 - DSHOT ESC](test_cards/mc_08_dshot.md)
|
||||
- [Unit Tests](test_and_ci/unit_tests.md)
|
||||
- [Fuzz Tests](test_and_ci/fuzz_tests.md)
|
||||
- [Continuous Integration](test_and_ci/continous_integration.md)
|
||||
|
||||
@@ -28,3 +28,5 @@ These are run by the test team as part of release testing, and for more signific
|
||||
- [MC_04 - Failsafe Testing](../test_cards/mc_04_failsafe_testing.md)
|
||||
- [MC_05 - Indoor Flight (Manual Modes)](../test_cards/mc_05_indoor_flight_manual_modes.md)
|
||||
- [MC_06 - Indoor Flight (Optical Flow)](../test_cards/mc_06_optical_flow.md)
|
||||
- [MC_07 - VIO (Visual-Inertial Odometry)](../test_cards/mc_07_vio.md)
|
||||
- [MC_08 - DSHOT ESC](../test_cards/mc_08_dshot.md)
|
||||
|
||||
@@ -2,11 +2,19 @@
|
||||
|
||||
## Objective
|
||||
|
||||
To test that optical flow / external vision work as expected
|
||||
To test that optical flow works as expected
|
||||
|
||||
## Preflight
|
||||
|
||||
Disconnect all GPS / compasses and ensure vehicle is using optical flow for navigation
|
||||
([Setup Information here](../sensor/optical_flow.md))
|
||||
|
||||
Ensure there are no other sources of positioning besides optical flow
|
||||
|
||||
- [EKF2_OF_CTRL](../advanced_config/parameter_reference.md#EKF2_OF_CTRL): `1`
|
||||
- [EKF2_GPS_CTRL](../advanced_config/parameter_reference.md#EKF2_GPS_CTRL): `0`
|
||||
- [EKF2_EV_CTRL](../advanced_config/parameter_reference.md#EKF2_EV_CTRL): `0`
|
||||
- [SYS_HAS_MAG](../advanced_config/parameter_reference.md#SYS_HAS_MAG): `0`
|
||||
|
||||
Ensure that the drone can go into Altitude / Position flight mode while still on the ground
|
||||
|
||||
@@ -39,5 +47,7 @@ Ensure that the drone can go into Altitude / Position flight mode while still on
|
||||
## Expected Results
|
||||
|
||||
- Take-off should be smooth as throttle is raised
|
||||
- Drone should hold altitude in Altitude Flight mode without wandering
|
||||
- Drone should hold position within 1 meter in Position Flight mode without pilot moving sticks
|
||||
- No oscillations should present in any of the above flight modes
|
||||
- Upon landing, copter should not bounce on the ground
|
||||
|
||||
52
docs/en/test_cards/mc_07_vio.md
Normal file
52
docs/en/test_cards/mc_07_vio.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# Test MC_07 - VIO (Visual-Inertial Odometry)
|
||||
|
||||
## Objective
|
||||
|
||||
To test that external vision (VIO) works as expected
|
||||
|
||||
## Preflight
|
||||
|
||||
Disconnect all GPS / compasses and ensure vehicle is using VIO for navigation
|
||||
|
||||
Ensure that the drone can go into Altitude / Position flight mode while still on the ground
|
||||
|
||||
Ensure there are no other sources of positioning besides VIO:
|
||||
|
||||
- [EKF2_OF_CTRL](../advanced_config/parameter_reference.md#EKF2_OF_CTRL): `0`
|
||||
- [EKF2_GPS_CTRL](../advanced_config/parameter_reference.md#EKF2_GPS_CTRL): `0`
|
||||
- [EKF2_EV_CTRL](../advanced_config/parameter_reference.md#EKF2_EV_CTRL): `15`
|
||||
- [SYS_HAS_MAG](../advanced_config/parameter_reference.md#SYS_HAS_MAG): `0`
|
||||
|
||||
## Flight Tests
|
||||
|
||||
❏ Altitude flight mode
|
||||
|
||||
❏ Vertical position should hold current value with stick centered
|
||||
|
||||
❏ Pitch/Roll/Yaw response 1:1
|
||||
|
||||
❏ Throttle response set to climb/descent rate
|
||||
|
||||
❏ Position flight mode
|
||||
|
||||
❏ Horizontal position should hold current value with stick centered
|
||||
|
||||
❏ Vertical position should hold current value with stick centered
|
||||
|
||||
❏ Throttle response set to climb/descent rate
|
||||
|
||||
❏ Pitch/Roll/Yaw response set to pitch/roll/yaw rates
|
||||
|
||||
## Landing
|
||||
|
||||
❏ Land in either Position or Altitude mode with the throttle below 40%
|
||||
|
||||
❏ Upon touching ground, copter should disarm automatically within 2 seconds (default: see [COM_DISARM_LAND](../advanced_config/parameter_reference.md#COM_DISARM_LAND))
|
||||
|
||||
## Expected Results
|
||||
|
||||
- Take-off should be smooth as throttle is raised
|
||||
- Drone should hold altitude in Altitude Flight mode without wandering
|
||||
- Drone should hold position within 1 meter in Position Flight mode without pilot moving sticks
|
||||
- No oscillations should present in any of the above flight modes
|
||||
- Upon landing, copter should not bounce on the ground
|
||||
46
docs/en/test_cards/mc_08_dshot.md
Normal file
46
docs/en/test_cards/mc_08_dshot.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# Test MC_08 - DSHOT ESC
|
||||
|
||||
## Objective
|
||||
|
||||
Regression test for DSHOT working with PX4
|
||||
|
||||
## Preflight
|
||||
|
||||
- Ensure vehicle is using a DSHOT ESC.
|
||||
- Parameter [DSHOT_BIDIR_EN](../advanced_config/parameter_reference.md#DSHOT_BIDIR_EN) is enabled
|
||||
- Parameter [DSHOT_TEL_CFG](../advanced_config/parameter_reference.md#DSHOT_TEL_CFG) is configured (if ESC supports telemetry)
|
||||
- Parameter [SDLOG_PROFILE](../advanced_config/parameter_reference.md#SDLOG_PROFILE) has Debug (`5`) checked
|
||||
|
||||
## Flight Tests
|
||||
|
||||
❏ Stabilized Flight mode
|
||||
|
||||
❏ Takeoff in stabilized flight mode to ensure correct motor spin
|
||||
|
||||
❏ Pitch/Roll/Yaw response 1:1
|
||||
|
||||
❏ Throttle response 1:1
|
||||
|
||||
❏ Position flight mode
|
||||
|
||||
❏ Horizontal position should hold current value with stick centered
|
||||
|
||||
❏ Vertical position should hold current value with stick centered
|
||||
|
||||
❏ Throttle response set to climb/descent rate
|
||||
|
||||
❏ Pitch/Roll/Yaw response set to pitch/roll/yaw rates
|
||||
|
||||
## Landing
|
||||
|
||||
❏ Land in either Position or Altitude mode with the throttle below 40%
|
||||
|
||||
❏ Upon touching ground, copter should disarm automatically within 2 seconds (default: see [COM_DISARM_LAND](../advanced_config/parameter_reference.md#COM_DISARM_LAND))
|
||||
|
||||
## Expected Results
|
||||
|
||||
- Download flight logs
|
||||
- Load into Data Plot Juggler
|
||||
- Ensure data is logged for esc_status/esc.0x/esc_rpm
|
||||
|
||||

|
||||
Reference in New Issue
Block a user