# Compass Calibration

The compass calibration process configures all magnetometers on the vehicle.

Calibrate compasses on first use of the vehicle. They should not need to be calibrated again unless exposed to a very strong magnetic field, or if the vehicle is used in an area with abnormal magnetic characteristics.

{% hint style="info" %}
Indications of a poor compass calibration include circling during hover, "toilet bowling" (spiraling-outwards at constant altitude, leading to fly-way), or veering off-path when attempting to fly straight.
{% endhint %}

The process can be performed in three different approaches, quick compass calibration,6-sides calibration and in-field calibration. See each section below.

### Quick compass calibration

The calibration steps are:

1. Select **Vehicle Overview** > **Sensors > Compass** in the left sidebar.\\

   <div align="left" data-full-width="true"><figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-4102a385f438ad153d20667972f77bea619677b5%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure></div>
2. **If available**, select the checkbox to enable the quick calibration. There should be immediate feedback. Click **Ok** to contiue.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-e996c726640b537e4e1f5a9881b6c680a4adfb32%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Fill out the latitude, longitude and heading information. If the vehicle has a valid position, the information will be pre-filled.

```
The valid ranges are:
Latitude: -90 to 90 degrees
Longitude: -180 to 180 degrees
Heading: 0 to 359 degrees
```

MGRS information will automatically be updated to reflect the current latitude and longitude. Similarly, changing the MGRS will update the latitude and longitude values.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-056282ba3904707fb8fa5812b8110caad76724cd%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-ee2eda1082ec4e031124e88e5c5a3da90bcbf642%2Fimage.png?alt=media" alt=""><figcaption><p>Make sure all fields are valid, else Apply will be disabled.</p></figcaption></figure>

4. Click **Apply** to execute the quick calibration. The application will confirm if calibration was successful or failed.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-b4b911583c6f3255097d10a93439205576ea2d89%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Complete 6-sides calibration

{% hint style="info" %}
If the 6-sides magnetometer calibration has already been performed once on the fully assembled drone, follow the steps of the [in-field calibration](#in-field-calibration) section below.
{% endhint %}

*Auterion Mission Control* will guide you to position the vehicle in a number of set orientations and then rotate the vehicle about the specified axis.

{% hint style="warning" %}
Choose a location away from large metal objects or magnetic fields. Metal is not always obvious! Avoid calibrating on top of an office table (often contain metal bars) or next to a vehicle. Calibration can even be affected if you're standing on a slab of concrete with uneven distribution of re-bar.
{% endhint %}

The calibration steps are:

1. Select **Vehicle Overview** > **Sensors > Compass** in the left sidebar.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-76011376d40c6f5fcaeed18762b555f5e32c957f%2FAMC_Sensor_Compass.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Check that the Autopilot orientation matches the actual mounting orientation

<div align="left"><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-91cdb404a797fa07e83e7b270084aafb70742164%2Fsensor_compass_start_prompt_select.jpg?alt=media" alt=""></div>

1. Click **OK** to start the calibration.
2. Place the vehicle in any of the orientations shown in red (incomplete) and hold it still. Once prompted (the orientation-image turns yellow) rotate the vehicle around the specified axis in either/both directions. Once the calibration is complete for the current orientation the associated image on the screen will turn green.

   <div align="left"><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-91644d6a90ca8f726137923496dd197d598b0194%2Fsensor_compass_calibration.jpg?alt=media" alt="" width="375"></div>
3. Repeat the calibration process for all vehicle orientations.
4. Once you've calibrated the vehicle in all the positions *Mission Control* will display the *Compass Calibration Complete* prompt (all orientation images will be displayed in green and the progress bar will fill completely).\
   ![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-66d77e3a28805c581de37e63fa9ffbf4364a9746%2Fsensor_compass_calibration_complete.jpg?alt=media)
5. Press **OK** to finish and **Reboot the Vehicle** if the orientation was changed.

### In-field calibration

If the drone shows symptoms of compass issues (e.g.: toilet bowling or pre-flight check error), the sensor biases can be automatically corrected simply by oscillating the drone around its 3 axes by about ±30 degrees. Two oscillations per axis are usually enough to obtain a good result.

Watch the in-field calibration in video below:

The valid ranges are:\
Latitude: -90 to 90 degrees\
Longitude: -180 to 180 degrees\
Heading: 0 to 359 degrees

{% embed url="<https://youtu.be/A1V1kVrZRZI?t=52>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.auterion.com/hardware-integration/hardware-integration/sensors-setup/compass-calibration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
