You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The Gimbal indicator is shown when the vehicle supports the [MAVLink Gimbal Protocol](https://mavlink.io/en/services/gimbal_v2.html). It displays active gimbal status and provides access to gimbal controls and settings.
98
+
The Gimbal indicator appears in the toolbar when the vehicle supports the [MAVLink Gimbal Protocol v2](https://mavlink.io/en/services/gimbal_v2.html). It displays the current gimbal status and provides controls for gimbal operation.
99
+
100
+
#### Gimbal Status Display
101
+
102
+
The toolbar indicator shows:
103
+
104
+
***Pitch angle** - Current pitch position in degrees
105
+
***Yaw value** - Either local yaw (relative to vehicle heading) or azimuth (absolute earth frame), depending on settings
106
+
***Yaw Lock status** - Visual indicator showing whether yaw lock is enabled or disabled
107
+
***Yaw Lock (Locked icon)** - Gimbal yaw is locked to earth frame (maintains absolute heading)
108
+
***Yaw Follow (Follow icon)** - Gimbal yaw follows vehicle body frame (rotates with vehicle)
109
+
110
+
#### Gimbal Controls
111
+
112
+
Clicking the gimbal indicator opens a dropdown panel with the following controls:
113
+
114
+
##### Quick controls
115
+
116
+
***Center** - Points the gimbal forward (0° pitch, 0° yaw relative to vehicle)
117
+
***Tilt 90** - Points the gimbal straight down (-90° pitch)
118
+
***Point Home** - Points the gimbal towards the home position
119
+
***Retract** - Sets gimbal to retracted position. This is not supported by all gimbals.
120
+
***Yaw Lock/Unlock** - More info below
121
+
***Gimbal Control Acquisition** - More info below
122
+
123
+
##### Yaw Lock Mode Toggle
124
+
125
+
Toggle between two yaw control modes:
126
+
127
+
***Yaw Lock** - Gimbal maintains a fixed heading relative to earth/north. When the vehicle rotates, the gimbal counter-rotates to maintain its absolute heading.
128
+
***Yaw Follow** - Gimbal yaw is relative to the vehicle body. When the vehicle rotates, the gimbal rotates with it.
129
+
130
+
##### Gimbal Control Acquisition
131
+
132
+
If the option "Show Acquire/Release control button" is set, a new **Acquire/Release Control** button will appear
133
+
* Click to request control from the current operator, or to release control if we have it.
134
+
* Control is typically needed before sending gimbal commands. If not in control, **it will be requested automatically** when sending other commands.
135
+
136
+
#### Yaw Lock Behavior with Center and Tilt 90 Commands
137
+
138
+
By default, the Center and Tilt 90 buttons will also set yaw to follow mode. This is the typical user expectation for these commands.
139
+
140
+
**Example**: If you're in Yaw Lock mode and press "Center", the gimbal will point forward relative to the vehicle (Yaw Follow mode) rather than maintaining its absolute earth heading.
141
+
142
+
To change this behaviour and preserve last yaw lock status, you can enable the setting "Preserve yaw lock status on tilt 90 and center commands, don't force yaw follow".
0 commit comments