# Compass The compass calibration process configures all connected internal and external [magnetometers](/px4-user-guide/drone_parts/peripherals/gps_compass.md). *QGroundControl* will guide you to position the vehicle in a number of set orientations and rotate the vehicle about the specified axis. ## Overview You will need to calibrate your compass on first use, and you may need to recalibrate it if the vehicles is ever exposed to a very strong magnetic field, or if it is used in an area with abnormal magnetic characteristics. :::tip Indications of a poor compass calibration include multicopter circling during hover, toilet bowling (circling at increasing radius/spiraling-out, usually constant altitude, leading to fly-way), or veering off-path when attempting to fly straight. *QGroundControl* should also notify the error `mag sensors inconsistent`. ::: Two types of compass calibration are available: 1. [Complete](#complete-calibration): This calibration is required after installing the autopilot on an airframe for the first time or when the configuration of the vehicle has changed significantly. It compensates for hard and soft iron effects by estimating an offset and a scale factor for each axis. 2. [Partial](#partial-quick-calibration) ("Quick Calibration"): This calibration can be performed as a routine when preparing the vehicle for a flight, after changing the payload, or simply when the compass rose seems inaccurate. This type of calibration only estimates the offsets to compensate for a hard iron effect. ## Performing the Calibration ### Preconditions Before starting the calibration: 1. Choose a location away from large metal objects or magnetic fields. :::tip 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. ::: 2. Connect via telemetry radio rather than USB if at all possible. USB can potentially cause significant magnetic interference. 3. If using an external compass (or a combined GPS/compass module), make sure it is [mounted](/px4-user-guide/assembly/mount_gps_compass.md) as far as possible from other electronics in order to reduce magnetic interference, and in a *supported orientation*. ### Complete Calibration The calibration steps are: 1. Start *QGroundControl* and connect the vehicle. 2. Select the **Gear** icon (Vehicle Setup) in the top toolbar and then **Sensors** in the sidebar. 3. Click the **Compass** sensor button. ![Select Compass calibration PX4](/files/rS0aewqZTVJQKGgc4AgE) :::note You should already have set the [Autopilot Orientation](/px4-user-guide/config/flight_controller_orientation.md). If not, you can also set it here. ::: 4. Click **OK** to start the calibration. 5. 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. ![Compass calibration steps on PX4](/files/OEiC6CoTgCb7rPIUfHL1) 6. Repeat the calibration process for all vehicle orientations. Once you've calibrated the vehicle in all the positions *QGroundControl* will display *Calibration complete* (all orientation images will be displayed in green and the progress bar will fill completely). You can then proceed to the next sensor. ### Partial "Quick" Calibration This calibration is similar to the well-known figure-8 compass calibration done on a smartphone: 1. Hold the vehicle in front of you and randomly perform partial rotations on all its axes. 2-3 oscillations of \~30 degrees in every direction is usually sufficient. 2. Wait for the heading estimate to stabilize and verify that the compass rose is pointing to the correct direction (this can take a couple of seconds). Notes: * There is no start/stop for this type of calibration (the algorithm runs continuously when the vehicle is disarmed). * The calibration is immediately applied to the data (no reboot is required) but is saved to the calibration parameters after disarming the vehicle only (the calibration is lost if no arming/disarming sequence is performed between calibration and shutdown). * The amplitude and the speed of the partial rotations done in step 1 can affect the calibration quality. Following the advice above is ususally enough. ## Additional Calibration/Configuration The process above will autodetect, [set default rotations](/px4-user-guide/advanced_config/parameter_reference.md#SENS_MAG_AUTOROT), calibrate, and prioritise, all connected magnetometers. Further compass configuration should generally not be required. :::note All external compasses are given the same priority by default, which is higher than the priority shared by all internal compasses. ::: ### Disable a Compass As stated above, generally no further configuration should be required. That said, developers can disable internal compasses if desired using the compass parameters. These are prefixed with [CAL\_MAGx\_](/px4-user-guide/advanced_config/parameter_reference.md#CAL_MAG0_ID) (where `x=0-3`). To disable an internal compass: * Use [CAL\_MAGn\_ROT](/px4-user-guide/advanced_config/parameter_reference.md#CAL_MAG0_ROT) to determine which compasses are internal. A compass is internal if `CAL_MAGn_ROT==1`. * Then use [CAL\_MAGx\_PRIO](/px4-user-guide/advanced_config/parameter_reference.md#CAL_MAG0_PRIO) to disable the compass. This can also be used to change the relative priority of a compass. ## Debugging Raw comparison data for magnetometers (in fact, for all sensors) can be logged by setting [SDLOG\_MODE=1](/px4-user-guide/advanced_config/parameter_reference.md#SDLOG_MODE) and [SDLOG\_PROFILE=64](/px4-user-guide/advanced_config/parameter_reference.md#SDLOG_PROFILE). See [Logging](/px4-user-guide/development/debug/logging.md) for more information. ## Further Information * [Peripherals > GPS & Compass](/px4-user-guide/drone_parts/peripherals/gps_compass.md) * [Basic Assembly](/px4-user-guide/assembly.md) (setup guides for each flight controller) * [Compass Power Compensation](/px4-user-guide/advanced_config/compass_power_compensation.md) (Advanced Configuration) * [QGroundControl User Guide > Sensors](https://docs.qgroundcontrol.com/master/en/SetupView/sensors_px4.html#compass) * [PX4 Setup Video - @2m38s](https://youtu.be/91VGmdSlbo4?t=2m38s) (Youtube) --- # 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://px4.gitbook.io/px4-user-guide/config/compass.md?ask= ``` 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.