Gimbal Configuration Protocol (v1)

WARNING

This service definition has been superseded by Gimbal Protocol v2 (gimbal manufacturers/GCSs/autopilots are expected to use the new API, but the old API is still in broad use, and there is no plan to for it to be removed).

The gimbal configuration message set uses a number of commands and few special-purpose messages to configure a payload mount.

By default the gimbal should be communicating with the component ID MAV_COMP_ID_GIMBAL.

Commands to Configure and Control Gimbal

The commands to use mavlink gimbals are MAV_CMD_DO_MOUNT_CONFIGURE and MAV_CMD_DO_MOUNT_CONTROL. MAV_CMD_DO_MOUNT_CONTROL_QUAT is also defined but does not seem to be implemented by any systems at time of writing.

Command	Description
MAV_CMD_DO_MOUNT_CONFIGURE	Configure a camera or antenna mount
MAV_CMD_DO_MOUNT_CONTROL	Control mount
MAV_CMD_DO_MOUNT_CONTROL_QUAT	Control a camera or antenna mount, using a quaternion as reference.

Enum	Description
MAV_MOUNT_MODE	Enumeration of possible mount operation modes.

Command to Reboot or Shutdown Gimbal

To reboot or shut down a gimbal send the command MAV_CMD_PREFLIGHT_REBOOT_SHUTDOWN. The options to be set for the gimbal are found in param4.

INFO

This is the same message/process as for autopilot systems.

Telemetry from Gimbal

A gimbal (or mount) should send a HEARTBEAT (e.g. every second) just like any other MAVLink component. Additionally, it can send feedback about the angles it's pointing using the message MOUNT_ORIENTATION.

Known Issues

This version of the gimbal protocol (v1) has a number of known issues:

• Unspecified signs in DO_MOUNT_CONTROL.
• Confusing order of axes in DO_MOUNT_CONTROL.
• Unclear “stabilize” flags in DO_MOUNT_CONFIGURE.
• Confusing and unimplemented “absolute” flags in DO_MOUNT_CONFIGURE.
• Unclear when to use DO_MOUNT_CONTROL or DO_MOUNT_CONFIGURE.
• Too many overloaded params in DO_MOUNT_CONTROL depending on GPS or targetting.
• Unusual param number for DO_MOUNT_CONTROL.
• The GPS mode in DO_MOUNT_CONTROL conflicts with DO_SET_ROI_* commands.
• MOUNT naming makes discovery hard.
• Unused DO_MOUNT_CONTROL_QUAT.
• Confusion and conflicts between gimbal commands used between ground station and gimbal messages between autopilot and gimbal.
• Commands require acknowledgements back and are therefore not suitable for higher rate setpoint streams for manual control.
• Control conflicts between different sources. It is not clear what takes precedence and how the deconfliction between different sources and commands should be implemented.

If possible migrate to Gimbal Protocol v2 which addresses these issues.