Skip to content

Commit cf3fea4

Browse files
committed
modify to clearly make behaviour non standard
1 parent 47c4cbe commit cf3fea4

1 file changed

Lines changed: 19 additions & 16 deletions

File tree

en/services/mission.md

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,7 @@ The items for the different types of plan are usually identified using a simple
4646
- _Geofence plan_:
4747
- Prefixed with `MAV_CMD_NAV_FENCE_` (e.g. [MAV_CMD_NAV_FENCE_RETURN_POINT](../messages/common.md#MAV_CMD_NAV_FENCE_RETURN_POINT)).
4848
- _Rally point plan_:
49-
- Rally points are defined using [MAV_CMD_NAV_RALLY_POINT](../messages/common.md#MAV_CMD_NAV_RALLY_POINT).
50-
51-
::: info
52-
[MAV_CMD_NAV_LOITER_TO_ALT](../messages/common.md#MAV_CMD_NAV_LOITER_TO_ALT) items declared immediately after `MAV_CMD_NAV_RALLY_POINT` may be used as VTOL approach loiter waypoints.
53-
VTOL can use these points in a fixed-wing return to define the location and radius of VTOL loiter-descent, and heading, prior to traveling to the final rally point.
54-
If multiple loiter waypoints are specified, selection is autopilot-specific.
55-
:::
49+
- Rally points are defined using [MAV_CMD_NAV_RALLY_POINT](../messages/common.md#MAV_CMD_NAV_RALLY_POINT) (only).
5650

5751
## Plan Payload Message
5852

@@ -477,27 +471,36 @@ The Xtrack parameter independently defines the path and exit location:
477471

478472
### PX4
479473

480-
The protocol has been implemented in C.
474+
The protocol has been implemented in C++.
481475

482476
Source code:
483477

484-
- [src/modules/mavlink/mavlink_mission.cpp](https://github.com/PX4/Firmware/blob/master/src/modules/mavlink/mavlink_mission.cpp)
478+
- [src/modules/mavlink/mavlink_mission.cpp](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/mavlink/mavlink_mission.cpp)
485479

486480
The implementation status is (at time of writing):
487481

488-
- Flight plan missions:
482+
- Mission (flight) plans:
489483
- upload, download, clearing missions, and monitoring progress are supported as defined in this specification.
490-
- Geofence missions" are supported as defined in this specification.
491-
- Rally point "missions" are not supported on PX4.
484+
- Geofence plans are supported as defined in this specification.
485+
- Rally point plans are supported.
492486

493-
Mission operation cancellation works for mission download (sets system to idle).
494-
Mission operation cancellation does not work for mission uploading; PX4 resends `MISSION_REQUEST_INT` until the operation times out.
487+
PX4 supports additionally supports the following non-standard behaviour:
488+
- [MAV_CMD_NAV_LOITER_TO_ALT](../messages/common.md#MAV_CMD_NAV_LOITER_TO_ALT) items can also be added to the rally point plan.
489+
Any of these declared immediately after `MAV_CMD_NAV_RALLY_POINT` may be used as [VTOL approach loiter waypoints](https://docs.px4.io/main/en/flight_modes_vtol/return#vtol-rally-point-approach-loiters).
490+
VTOL can use these points in a fixed-wing return to define the location and radius of VTOL loiter-descent, and heading, prior to traveling to the final rally point.
491+
If multiple loiter waypoints are specified, selection is autopilot-specific.
492+
493+
::: info
494+
This is non-standard because it is only implemented by PX4 and broadly opposed by ArduPilot (limited initial discussion).
495+
The argument is that rally points are not designed for this purpose, and that adding new allowed waypoints turns them into mini-missions.
496+
These might be implemented in the mission plan.
497+
:::
495498

496-
<!-- https://github.com/PX4/Firmware/blob/master/src/modules/mavlink/mavlink_mission.cpp#L641 -->
499+
Mission operation cancellation works for both mission upload and download (sets system to idle).
497500

498501
Source code:
499502

500-
- [src/modules/mavlink/mavlink_mission.cpp](https://github.com/PX4/Firmware/blob/master/src/modules/mavlink/mavlink_mission.cpp)
503+
- [src/modules/mavlink/mavlink_mission.cpp](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/mavlink/mavlink_mission.cpp)
501504

502505
### QGroundControl
503506

0 commit comments

Comments
 (0)