Skip to content

Commit 752f53b

Browse files
update gimbal toolbar indicator docs
1 parent 1b946e0 commit 752f53b

1 file changed

Lines changed: 45 additions & 1 deletion

File tree

docs/en/qgc-user-guide/fly_view/fly_view_toolbar.md

Lines changed: 45 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,51 @@ The RC RSSI indicator appears when RC signal information is available. It shows
9595

9696
### Gimbal <img src="../../../assets/fly/toolbar/gimbal_indicator.png" alt="Gimbal indicator" style="height: 1.15em; vertical-align: text-bottom;" />
9797

98-
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".
99143

100144
### VTOL Transitions <img src="../../../assets/fly/toolbar/vtol_indicator.png" alt="VTOL indicator" style="height: 1.15em; vertical-align: text-bottom;" />
101145

0 commit comments

Comments
 (0)