From 79905043ac336d37b2a6aee688f8a8326921682d Mon Sep 17 00:00:00 2001
From: Christian Petri <christianpetri@users.noreply.github.com>
Date: Tue, 2 Jun 2026 23:30:40 +0200
Subject: [PATCH] common: rename/add MAG_CAL_STATUS failure enums to FAILED_* +
 RESIDUALS_HIGH (#2478)

---
 message_definitions/v1.0/common.xml | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/message_definitions/v1.0/common.xml b/message_definitions/v1.0/common.xml
index ccf7bd8cd7f..74160053510 100644
--- a/message_definitions/v1.0/common.xml
+++ b/message_definitions/v1.0/common.xml
@@ -4695,8 +4695,21 @@
       <entry value="3" name="MAG_CAL_RUNNING_STEP_TWO"/>
       <entry value="4" name="MAG_CAL_SUCCESS"/>
       <entry value="5" name="MAG_CAL_FAILED"/>
-      <entry value="6" name="MAG_CAL_BAD_ORIENTATION"/>
-      <entry value="7" name="MAG_CAL_BAD_RADIUS"/>
+      <entry value="6" name="MAG_CAL_FAILED_ORIENTATION">
+        <description>Compass calibration failed: the vehicle orientation is outside the required tolerance.</description>
+      </entry>
+      <entry value="7" name="MAG_CAL_FAILED_RADIUS">
+        <description>Compass calibration failed: the radius of the fitted sphere is unrealistically small or large.</description>
+      </entry>
+      <entry value="8" name="MAG_CAL_FAILED_OFFSETS">
+        <description>Compass calibration failed: offset magnitude too large.</description>
+      </entry>
+      <entry value="9" name="MAG_CAL_FAILED_DIAG_SCALING">
+        <description>Compass calibration failed: diagonal or off-diagonal scaling values out of valid range.</description>
+      </entry>
+      <entry value="10" name="MAG_CAL_FAILED_RESIDUALS_HIGH">
+        <description>Compass calibration failed: fitness (RMS residual) exceeds tolerance.</description>
+      </entry>
     </enum>
     <enum name="HIL_SENSOR_UPDATED_FLAGS" bitmask="true">
       <description>Flags in the HIL_SENSOR message indicate which fields have updated since the last message</description>