From cf1ea06f463d366b8fc807884862a088b87582fc Mon Sep 17 00:00:00 2001
From: Juan Pablo Pino Bravo <jp.pinob@gmail.com>
Date: Tue, 5 May 2026 14:10:30 +0200
Subject: [PATCH] feat: add AutoWhiteBalanceTel and SetAutoWhiteBalanceCtrl
 messages

Add protobuf messages for auto white balance filter control and
telemetry, using the shared FilterMessage format. Also improve
documentation for existing SetTurbidityFilterCtrl.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 protobuf_definitions/control.proto   | 9 +++++++++
 protobuf_definitions/telemetry.proto | 7 +++++++
 2 files changed, 16 insertions(+)

diff --git a/protobuf_definitions/control.proto b/protobuf_definitions/control.proto
index 42301321..eeedc689 100644
--- a/protobuf_definitions/control.proto
+++ b/protobuf_definitions/control.proto
@@ -229,10 +229,19 @@ message FormatRemovableStorageDeviceCtrl {
 }
 
 // Message sent when the user wants to set turbidity filter settings.
+// Uses CLAHE to enhance the contrast of the video, which can make it easier to see details in turbid water.
+// Only supported on X3 Ultra.
 message SetTurbidityFilterCtrl {
   FilterMessage turbidity_filter = 1; // Message with the turbidity filter settings to set.
 }
 
+// Message sent when the user wants to set auto white balance settings.
+// Removes underwater color casts using the Gray World algorithm.
+// Only supported on X3 Ultra.
+message SetAutoWhiteBalanceCtrl {
+  FilterMessage awb_filter = 1; // Message with the auto white balance settings to set.
+}
+
 // Issue a command to set the digital pan, tilt, and zoom of the main camera.
 //
 // Only supported on X3 Ultra.
diff --git a/protobuf_definitions/telemetry.proto b/protobuf_definitions/telemetry.proto
index ce577716..5d82b2eb 100644
--- a/protobuf_definitions/telemetry.proto
+++ b/protobuf_definitions/telemetry.proto
@@ -334,6 +334,13 @@ message TurbidityFilterTel {
   FilterMessage turbidity_filter = 1; // Turbidity filter settings.
 }
 
+// Auto white balance settings telemetry message.
+//
+// Message is published when the filter settings are changed.
+message AutoWhiteBalanceTel {
+  FilterMessage awb_filter = 1; // Auto white balance settings.
+}
+
 // Digital pan, tilt, and zoom telemetry from the main camera.
 //
 // Reports the actual pan, tilt, and zoom state of the camera.