From 43acec856f7b7d36e8fb1e33b0dbaa575b48881f Mon Sep 17 00:00:00 2001 From: Peter Barker Date: Sat, 30 Sep 2023 11:23:24 +1000 Subject: [PATCH] common: upgrade orientation note to warning two instances recent with users not setting orientation before magcal --- .../docs/common-compass-calibration-in-mission-planner.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/common/source/docs/common-compass-calibration-in-mission-planner.rst b/common/source/docs/common-compass-calibration-in-mission-planner.rst index c31029de9f..e52c348518 100644 --- a/common/source/docs/common-compass-calibration-in-mission-planner.rst +++ b/common/source/docs/common-compass-calibration-in-mission-planner.rst @@ -77,7 +77,9 @@ Large Vehicle MagCal Large or heavy vehicles are impractical to rotate on all axis. This feature allows a fairly accurate calibration if GPS lock is active on the autopilot and the vehicles actual heading is known, either using a landmark reference on the Mission Planner map, or using another compass (eg cell phone) and entering the vehicles heading. -.. note:: the heading entered should be TRUE, not MAGNETIC. Using a phone's compass app will usually required adding the local declination value to the reading in order to obtain the TRUE geographic heading which should be entered. The proper orientation of the compass must also be set in order for this method to work. +.. warning:: The proper orientation of the compass must also be set in order for this method to give a good result. If orientation is incorrect this procedure will appear to succeed while leaving the compass calibration in a very bad state. + +.. note:: the heading entered should be TRUE, not MAGNETIC. Using a phone's compass app will usually required adding the local declination value to the reading in order to obtain the TRUE geographic heading which should be entered. Compass Ordering ================