diff --git a/message_definitions/v1.0/common.xml b/message_definitions/v1.0/common.xml
index 8b96e8355a1..cdfe0a9055c 100644
--- a/message_definitions/v1.0/common.xml
+++ b/message_definitions/v1.0/common.xml
@@ -775,19 +775,19 @@
Loiter around this waypoint for X turns
Number of turns.
- Empty
- Radius around waypoint. If positive loiter clockwise, else counter-clockwise
- Forward moving aircraft this sets exit xtrack location: 0 for center of loiter wp, 1 for exit location. Else, this is desired yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
+ Leave loiter circle only when track heads towards the next waypoint (MAV_BOOL_FALSE: Leave when turns complete). Values not equal to 0 or 1 are invalid.
+ Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, else counter-clockwise
+ Loiter circle exit location and/or path to next waypoint ("xtrack") for forward-only moving vehicles (not multicopters). 0 for the vehicle to converge towards the center xtrack when it leaves the loiter (the line between the centers of the current and next waypoint), 1 to converge to the direct line between the location that the vehicle exits the loiter radius and the next waypoint. Otherwise the angle (in degrees) between the tangent of the loiter circle and the center xtrack at which the vehicle must leave the loiter (and converge to the center xtrack). NaN to use the current system default xtrack behaviour.
Latitude
Longitude
Altitude
- Loiter around this waypoint for X seconds
- Loiter time.
- Empty
- Radius around waypoint. If positive loiter clockwise, else counter-clockwise.
- Forward moving aircraft this sets exit xtrack location: 0 for center of loiter wp, 1 for exit location. Else, this is desired yaw angle. NaN to use the current system yaw heading mode (e.g. yaw towards next waypoint, yaw to home, etc.).
+ Loiter at the specified latitude, longitude and altitude for a certain amount of time. Multicopter vehicles stop at the point (within a vehicle-specific acceptance radius). Forward-only moving vehicles (e.g. fixed-wing) circle the point with the specified radius/direction. If the Heading Required parameter (2) is non-zero forward moving aircraft will only leave the loiter circle once heading towards the next waypoint.
+ Loiter time (only starts once Lat, Lon and Alt is reached).
+ Leave loiter circle only when track heading towards the next waypoint (MAV_BOOL_FALSE: Leave on time expiry). Values not equal to 0 or 1 are invalid.
+ Loiter radius around waypoint for forward-only moving vehicles (not multicopters). If positive loiter clockwise, else counter-clockwise.
+ Loiter circle exit location and/or path to next waypoint ("xtrack") for forward-only moving vehicles (not multicopters). 0 for the vehicle to converge towards the center xtrack when it leaves the loiter (the line between the centers of the current and next waypoint), 1 to converge to the direct line between the location that the vehicle exits the loiter radius and the next waypoint. Otherwise the angle (in degrees) between the tangent of the loiter circle and the center xtrack at which the vehicle must leave the loiter (and converge to the center xtrack). NaN to use the current system default xtrack behaviour.
Latitude
Longitude
Altitude
@@ -1068,11 +1068,16 @@
Empty
- Changes the home location either to the current location or a specified location.
+
+ Sets the home position to either to the current position or a specified position.
+ The home position is the default position that the system will return to and land on.
+ The position is set automatically by the system during the takeoff (and may also be set using this command).
+ Note: the current home position may be emitted in a HOME_POSITION message on request (using MAV_CMD_REQUEST_MESSAGE with param1=242).
+
Use current location (MAV_BOOL_FALSE: use specified location). Values not equal to 0 or 1 are invalid.
- Empty
- Empty
- Empty
+ Roll angle (of surface). Range: -180..180 degrees. NAN or 0 means value not set. 0.01 indicates zero roll.
+ Pitch angle (of surface). Range: -90..90 degrees. NAN or 0 means value not set. 0.01 means zero pitch.
+ Yaw angle. NaN to use default heading. Range: -180..180 degrees.
Latitude
Longitude
Altitude
@@ -1315,9 +1320,9 @@
Stabilize roll (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
Stabilize pitch (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
Stabilize yaw (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
- Empty
- Empty
- Empty
+ Roll input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)
+ Pitch input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)
+ Yaw input (0 = angle body frame, 1 = angular rate, 2 = angle absolute frame)
@@ -1335,7 +1340,7 @@
Camera trigger distance. 0 to stop triggering.
Camera shutter integration time. -1 or 0 to ignore
Trigger camera once, immediately (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
- Empty
+ Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission.
Empty
Empty
Empty
@@ -1469,9 +1474,23 @@
Empty
- Set the mission item with sequence number seq as current item. This means that the MAV will continue to this mission item on the shortest path (not following the mission items in-between).
- Mission sequence value to set
- Empty
+
+ Set the mission item with sequence number seq as the current item and emit MISSION_CURRENT (whether or not the mission number changed).
+ If a mission is currently being executed, the system will continue to this new mission item on the shortest path, skipping any intermediate mission items.
+ Note that mission jump repeat counters are not reset unless param2 is set (see MAV_CMD_DO_JUMP param2).
+
+ This command may trigger a mission state-machine change on some systems: for example from MISSION_STATE_NOT_STARTED or MISSION_STATE_PAUSED to MISSION_STATE_ACTIVE.
+ If the system is in mission mode, on those systems this command might therefore start, restart or resume the mission.
+ If the system is not in mission mode this command must not trigger a switch to mission mode.
+
+ The mission may be "reset" using param2.
+ Resetting sets jump counters to initial values (to reset counters without changing the current mission item set the param1 to `-1`).
+ Resetting also explicitly changes a mission state of MISSION_STATE_COMPLETE to MISSION_STATE_PAUSED or MISSION_STATE_ACTIVE, potentially allowing it to resume when it is (next) in a mission mode.
+
+ The command will ACK with MAV_RESULT_FAILED if the sequence number is out of range (including if there is no mission item).
+
+ Mission sequence value to set. -1 for the current mission item (use to reset mission without changing current mission item).
+ Reset mission (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid. Resets jump counters to initial values and changes mission state "completed" to be "active" or "paused".
Empty
Empty
Empty
@@ -1642,7 +1661,8 @@
Format a storage medium. Once format is complete, a STORAGE_INFORMATION message is sent. Use the command's target_component to target a specific component's storage.
Storage ID (1 for first, 2 for second, etc.)
Format storage (and reset image log). Values not equal to 0 or 1 are invalid.
- Reserved (all remaining params)
+ Reset Image Log (without formatting storage medium). This will reset CAMERA_CAPTURE_STATUS.image_count and CAMERA_IMAGE_CAPTURED.image_index. Values not equal to 0 or 1 are invalid.
+ Reserved (all remaining params)
@@ -1659,7 +1679,7 @@
Reset all camera settings to Factory Default
Reset all settings (MAV_BOOL_TRUE). Values not equal to 0 or 1 are invalid.
- Reserved (all remaining params)
+ Target camera ID. 7 to 255: MAVLink camera component id. 1 to 6 for cameras attached to the autopilot, which don't have a distinct component id. 0: all cameras. This is used to target specific autopilot-connected cameras. It is also used to target specific cameras when the MAV_CMD is used in a mission.
Set camera running mode. Use NaN for reserved values. GCS will send a MAV_CMD_REQUEST_VIDEO_STREAM_STATUS command after a mode change if the camera supports video streaming.
@@ -1898,8 +1918,8 @@
User defined
User defined
User defined
- Target latitude of center of circle in CIRCLE_MODE
- Target longitude of center of circle in CIRCLE_MODE
+ Target latitude of center of circle in CIRCLE_MODE
+ Target longitude of center of circle in CIRCLE_MODE
Fence return point (there can only be one such point in a geofence definition). If rally points are supported they should be used instead.