diff --git a/en/flight_modes_fw/mission.md b/en/flight_modes_fw/mission.md index dedb839eee6..bf4817635a4 100644 --- a/en/flight_modes_fw/mission.md +++ b/en/flight_modes_fw/mission.md @@ -76,18 +76,20 @@ For more information about mission planning, see: ## Mission Feasibility Checks -PX4 runs some basic sanity checks to determine if a mission is feasible when it is uploaded, and when the vehicle is first armed. +PX4 runs some basic sanity checks to determine if a mission is feasible when it is uploaded and before executing a mission. If any of the checks fail, the user is notified and it is not possible to start the mission. A subset of the most important checks are listed below: -- First mission item too far away from vehicle ([MIS_DIST_1WP](#MIS_DIST_1WP)) - Any mission item conflicts with a plan or safety geofence - More than one land start mission item defined ([MAV_CMD_DO_LAND_START](https://mavlink.io/en/messages/common.html#MAV_CMD_DO_LAND_START)) - A fixed-wing landing has an infeasible slope angle ([FW_LND_ANG](#FW_LND_ANG)) - Land start item (`MAV_CMD_DO_LAND_START`) appears in mission before an RTL item ([MAV_CMD_NAV_RETURN_TO_LAUNCH](https://mavlink.io/en/messages/common.html#MAV_CMD_NAV_RETURN_TO_LAUNCH)) - Missing takeoff and/or land item when these are configured as a requirement ([MIS_TKO_LAND_REQ](#MIS_TKO_LAND_REQ)) +Additionally there is a check if the first waypoint is too far from the Home position ([MIS_DIST_1WP](#MIS_DIST_1WP)). +The user is notified should the check fail, but it has no effect on the validity of a mission plan, meaning that the mission can still be started even if the distance is too high. + ## QGroundControl Support _QGroundControl_ provides additional GCS-level mission handling support (in addition to that provided by the flight controller). @@ -113,7 +115,7 @@ Parameters related to [mission feasibility checks](#mission-feasibility-checks): | Parameter | Description | | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [MIS_DIST_1WP](../advanced_config/parameter_reference.md#MIS_DIST_1WP) | The mission will not be started if the current waypoint is more distant than this value from the home position. Disabled if value is 0 or less. | +| [MIS_DIST_1WP](../advanced_config/parameter_reference.md#MIS_DIST_1WP) | There is a warning message if the distance of the first waypoint to Home is more than this value. Disabled if value is 0 or less. | | [FW_LND_ANG](../advanced_config/parameter_reference.md#FW_LND_ANG) | Maximum landing slope angle. | | [MIS_TKO_LAND_REQ](../advanced_config/parameter_reference.md#MIS_TKO_LAND_REQ) | Mission takeoff/landing requirement configuration. FW and VTOL both have it set to 2 by default, which means that the mission has to contain a landing. | diff --git a/en/flight_modes_mc/mission.md b/en/flight_modes_mc/mission.md index a722e5baad8..902e96b3821 100644 --- a/en/flight_modes_mc/mission.md +++ b/en/flight_modes_mc/mission.md @@ -79,13 +79,16 @@ For more information about mission planning, see: ## Mission Feasibility Checks -PX4 runs some basic sanity checks to determine if a mission is feasible when it is uploaded, and when the vehicle is first armed. +PX4 runs some basic sanity checks to determine if a mission is feasible when it is uploaded and before executing a mission. If any of the checks fail, the user is notified and it is not possible to start the mission. A subset of the most important checks are listed below: -- First mission item too far away from vehicle ([MIS_DIST_1WP](#MIS_DIST_1WP)) - Any mission item conflicts with a plan or safety geofence +- Missing takeoff and/or land item when these are configured as a requirement ([MIS_TKO_LAND_REQ](#MIS_TKO_LAND_REQ)) + +Additionally there is a check if the first waypoint is too far from the Home position ([MIS_DIST_1WP](#MIS_DIST_1WP)). +The user is notified should the check fail, but it has no effect on the validity of a mission plan, meaning that the mission can still be started even if the distance is too high. ## QGroundControl Support @@ -113,9 +116,9 @@ Parameters related to [mission feasibility checks](#mission-feasibility-checks): | Parameter | Description | | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [MIS_DIST_1WP](../advanced_config/parameter_reference.md#MIS_DIST_1WP) | The mission will not be started if the current waypoint is more distant than this value from the home position. Disabled if value is 0 or less. | +| [MIS_DIST_1WP](../advanced_config/parameter_reference.md#MIS_DIST_1WP) | There is a warning message if the distance of the first waypoint to Home is more than this value. Disabled if value is 0 or less. | | [FW_LND_ANG](../advanced_config/parameter_reference.md#FW_LND_ANG) | Maximum landing slope angle. | -| [MIS_TKO_LAND_REQ](../advanced_config/parameter_reference.md#MIS_TKO_LAND_REQ) | Mission takeoff/landing requirement configuration. FW and VTOL both have it set to 2 by default, which means that the mission has to contain a landing. | +| [MIS_TKO_LAND_REQ](../advanced_config/parameter_reference.md#MIS_TKO_LAND_REQ) | Mission takeoff/landing requirement configuration. No requirement by default for multicopter.|