# 罗盘校准 This process calibrates and configures all [magnetometers](../gps_compass/index.md). _QGroundControl_ will guide you to position the vehicle in a number of set orientations and rotate the vehicle about the specified axis. :::info It also auto-detects the compass orientation for external magnetometers ([by default](../advanced_config/parameter_reference.md#SENS_MAG_AUTOROT)). If you have [mounted the compass](../assembly/mount_gps_compass.md#compass-orientation) at a non-standard angle you will need to [manually set the compass orientation](../config/flight_controller_orientation.md#setting-the-compass-orientation) before calibrating. ::: ## 综述 You will need to calibrate your compass(es) when you first setup your vehicle, and you may need to [recalibrate](#recalibration) 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`. ::: The process calibrates all compasses and autodetects the orientation of any external compasses. If any external magnetometers are available, it then disables the internal magnetometers (these are primarily needed for automatic rotation detection of external magnetometers). ### Types of Calibration Several 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): 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. 3. [Large vehicle](#large-vehicle-calibration): This calibration can be performed when the vehicle is too large or heavy to perform a complete calibration. This type of calibration only estimates the offsets to compensate for a hard-iron effect. ## 执行校准 ### 操作前提 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](../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 **"Q" icon > Vehicle Setup > Sensors** (sidebar) to open _Sensor Setup_. 3. Click the **Compass** sensor button. ![Select Compass calibration PX4](../../assets/qgc/setup/sensor/sensor_compass_select_px4.png) ::: info You should already have set the [Autopilot Orientation](../config/flight_controller_orientation.md). If not, you can also set it here. ::: 4. Click **OK** to start the calibration. 5. 把你的飞机放置在下面显示的某一个方向，并保持静止。 随后提示（方向图像变为黄色）在指定方向旋转飞行器。 该位置标定完成后，屏幕上的相应图示将变成绿色。 ![Compass calibration steps on PX4](../../assets/qgc/setup/sensor/sensor_compass_calibrate_px4.png) 6. 在机体的所有方向上重复校准步骤。 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 usually enough. ### Large Vehicle Calibration This calibration process leverages external knowledge of the vehicle's orientation and location, along with a World Magnetic Model (WMM), to calibrate hard-iron biases. It is designed for large or heavy vehicles where full-axis rotation is impractical. The calibration accepts an optional heading argument (), allowing you to specify the vehicle's current true heading. This means you can perform a valid magnetometer calibration while the vehicle is pointed in any direction, not just North. :::tip The [complete calibration](#complete-calibration) is more reliable, and should be used if you can physically rotate the vehicle through all required orientations. If the large vehicle calibration fails (magnetometer readings are inconsistent, or if yaw is unstable or incorrect) you will need to [recalibrate](#recalibration) using the complete calibration. ::: :::details Implementation details This implementation replaces an earlier version (PX4 v1.15 - PX4 v1.17) that required the vehicle to be facing True North. The calibration process: - Computes hard-iron bias offsets by comparing the expected Earth magnetic field vector (based on location and heading from WMM) with the measured field from the magnetometer(s). - Adjusts magnetometer offset parameters so the heading estimate aligns correctly without requiring full 3-axis rotation. - The calibration is applied immediately. Offsets persist once parameters are saved (typically on disarm or reboot). ::: #### 操作前提 - Obtain a valid GNSS fix (required for World Magnetic Model lookup). - Choose a location away from large metal objects or magnetic fields. - If using an external compass, ensure it is [mounted](../assembly/mount_gps_compass.md) as far as possible from other electronics. #### Procedure 1. **Ensure GNSS Fix.** This is required to look up the expected Earth magnetic field from WMM tables. 2. **Align the vehicle to a known heading.** This can be True North (0°), or any other known heading relative to True North. 3. Open the [QGroundControl MAVLink Console](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/mavlink_console.html) and run: ```sh commander calibrate mag quick [heading] ``` | 参数 | 描述 | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | `heading` (optional) | True heading of the vehicle in degrees (0–359). Defaults to 0° (North) if omitted. | **Examples:** | Vehicle Facing | 通信 | | ----------------------------------- | ----------------------------------- | | North (0°) | `commander calibrate mag quick` | | East (90°) | `commander calibrate mag quick 90` | | South (180°) | `commander calibrate mag quick 180` | | Southwest (225°) | `commander calibrate mag quick 225` | :::info 备注 - The vehicle doesn't need to be exactly level. Tilt is automatically compensated using the attitude estimate. - This calibration can also be triggered using the MAVLink command [MAV_CMD_FIXED_MAG_CAL_YAW](https://mavlink.io/en/messages/common.html#MAV_CMD_FIXED_MAG_CAL_YAW). ::: #### 验证 After calibration: 1. Check that the heading indicator in QGroundControl is stable. 2. Rotate the vehicle to cardinal directions (N/E/S/W) and verify the compass heading matches. 3. If using multiple magnetometers, confirm the correct sensor priority is set. ## Recalibration Recalibration is recommended whenever the magnetic environment of the vehicle has changed or when heading behavior appears unreliable. You can use either complete calibration or mag quick calibration depending on the size of the vehicle and your ability to rotate it through the required orientations. Complete calibration provides the most accurate soft-iron compensation. Recalibrate the compass when: - _The compass module or its mounting orientation has changed._ This includes replacing the GPS or mag unit, rotating the mast, or altering how the module is fixed to the airframe. - _The vehicle has been exposed to a strong magnetic disturbance._ Examples include transport or storage near large steel structures, welding operations near the airframe, or operation close to high-current equipment. - _Structural, wiring, or payload changes may have altered the magnetic field around the sensors._ New payloads, rerouted wires, additional batteries, or metal fasteners can introduce soft-iron effects that affect heading accuracy. - _The vehicle is operated in a region with significantly different magnetic characteristics._ Large changes in latitude, longitude, or magnetic inclination can require re-estimation of offsets. - _QGroundControl reports magnetometer inconsistencies_. For example, if you see the error `mag sensors inconsistent`. - _Heading behavior does not match the vehicle’s observed orientation._ Symptoms include drifting yaw, sudden heading jumps when attempting to fly straight, and toilet bowling - _QGroundControl_ sends the error `mag sensors inconsistent`. This indicates that multiple magnetometers are reporting different headings. ## Additional Calibration/Configuration The processes above will autodetect, [set default rotations](../advanced_config/parameter_reference.md#SENS_MAG_AUTOROT), calibrate, and prioritise, all available magnetometers. If external magnetometers are available, internal magnetometers are disabled. Further compass configuration should generally not be required. ### Enable/Disable a Compass While no further configuration should be _required_, developers who wish to disable/enable compasses for any reason, such as testing, can do so using the compass parameters. These are prefixed with [CAL_MAGx_](../advanced_config/parameter_reference.md#CAL_MAG0_ID) (where `x=0-3`): - [CAL_MAGn_ROT](../advanced_config/parameter_reference.md#CAL_MAG0_ROT) can be used to determine which compasses are internal. A compass is internal if `CAL_MAGn_ROT==1`. - [CAL_MAGx_PRIO](../advanced_config/parameter_reference.md#CAL_MAG0_PRIO) sets the relative compass priority and can be used to disable a compass. ## 调试 Raw comparison data for magnetometers (in fact, for all sensors) can be logged by setting [SDLOG_MODE=1](../advanced_config/parameter_reference.md#SDLOG_MODE) and [SDLOG_PROFILE=64](../advanced_config/parameter_reference.md#SDLOG_PROFILE). See [Logging](../dev_log/logging.md) for more information. ## 更多信息 - [Peripherals > GPS & Compass](../gps_compass/index.md) - [Basic Assembly](../assembly/index.md) (setup guides for each flight controller) - [Compass Power Compensation](../advanced_config/compass_power_compensation.md) (Advanced Configuration) - [QGroundControl User Guide > Sensors](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/setup_view/sensors_px4.html#compass) - [PX4 Setup Video - @2m38s](https://youtu.be/91VGmdSlbo4?t=2m38s) (Youtube)