You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/zh/config/compass.md
+38-6Lines changed: 38 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ If you have [mounted the compass](../assembly/mount_gps_compass.md#compass-orien
10
10
11
11
## 综述
12
12
13
-
You will need to calibrate your compass(es) when you first setup your vehicle, 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.
13
+
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.
14
14
15
15
:::tip
16
16
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.
@@ -20,13 +20,16 @@ _QGroundControl_ should also notify the error `mag sensors inconsistent`.
20
20
The process calibrates all compasses and autodetects the orientation of any external compasses.
21
21
If any external magnetometers are available, it then disables the internal magnetometers (these are primarily needed for automatic rotation detection of external magnetometers).
22
22
23
+
### Types of Calibration
24
+
23
25
Several types of compass calibration are available:
24
26
25
27
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.
26
28
It compensates for hard and soft iron effects by estimating an offset and a scale factor for each axis.
27
29
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.
28
30
This type of calibration only estimates the offsets to compensate for a hard iron effect.
29
-
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.
31
+
3.[Large vehicle](#large-vehicle-calibration): This calibration can be performed when the vehicle is too large or heavy to perform a complete calibration.
32
+
This type of calibration only estimates the offsets to compensate for a hard iron effect.

69
75
70
76
6. 在机体的所有方向上重复校准步骤。
71
77
72
-
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.
78
+
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).
79
+
You can then proceed to the next sensor.
73
80
74
81
### Partial "Quick" Calibration
75
82
@@ -92,7 +99,8 @@ This calibration is similar to the well-known figure-8 compass calibration done
92
99
93
100
This calibration process leverages external knowledge of vehicle's orientation and location, and a World Magnetic Model (WMM) to calibrate the hard iron biases.
94
101
95
-
1. Ensure GNSS Fix. This is required to find the expected Earth magnetic field in WMM tables.
102
+
1. Ensure GNSS Fix.
103
+
This is required to find the expected Earth magnetic field in WMM tables.
96
104
2. Align the vehicle to face True North.
97
105
Be as accurate as possible for best results.
98
106
3. Open the [QGroundControl MAVLink Console](https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/mavlink_console.html) and send the following command:
@@ -112,6 +120,30 @@ This calibration process leverages external knowledge of vehicle's orientation a
112
120
113
121
After the calibration is complete, check that the heading indicator and the heading of the arrow on the map are stable and match the orientation of the vehicle when turning it e.g. to the cardinal directions.
114
122
123
+
## Recalibration
124
+
125
+
Recalibration is recommended whenever the magnetic environment of the vehicle has changed or when heading behavior appears unreliable.
126
+
127
+
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.
128
+
Complete calibration provides the most accurate soft-iron compensation.
129
+
130
+
Recalibrate the compass when:
131
+
132
+
-_The compass module or its mounting orientation has changed._
133
+
This includes replacing the GPS or mag unit, rotating the mast, or altering how the module is fixed to the airframe.
134
+
-_The vehicle has been exposed to a strong magnetic disturbance._
135
+
Examples include transport or storage near large steel structures, welding operations near the airframe, or operation close to high-current equipment.
136
+
-_Structural, wiring, or payload changes may have altered the magnetic field around the sensors._
137
+
New payloads, rerouted wires, additional batteries, or metal fasteners can introduce soft-iron effects that affect heading accuracy.
138
+
-_The vehicle is operated in a region with significantly different magnetic characteristics._
139
+
Large changes in latitude, longitude, or magnetic inclination can require re-estimation of offsets.
For example, if you see the error `mag sensors inconsistent`.
142
+
-_Heading behavior does not match the vehicle’s observed orientation._
143
+
Symptoms include drifting yaw, sudden heading jumps when attempting to fly straight, and toilet bowling
144
+
-_QGroundControl_ sends the error `mag sensors inconsistent`.
145
+
This indicates that multiple magnetometers are reporting different headings.
146
+
115
147
## Additional Calibration/Configuration
116
148
117
149
The process above will autodetect, [set default rotations](../advanced_config/parameter_reference.md#SENS_MAG_AUTOROT), calibrate, and prioritise, all available magnetometers.
Copy file name to clipboardExpand all lines: docs/zh/mavlink/standard_modes.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
<Badgetype="tip"text="PX4 v1.15" />
4
4
5
-
PX4 implements the MAVLink [Standard Modes Protocol](https://mavlink.io/en/services/standard_modes.md) from PX4 v1.15, with a corresponding implementation in QGroundControl Daily builds (and future release builds).
5
+
PX4 implements the MAVLink [Standard Modes Protocol](https://mavlink.io/en/services/standard_modes.html) from PX4 v1.15, with a corresponding implementation in QGroundControl Daily builds (and future release builds).
6
6
7
7
The protocol allows you to discover all flight modes available to the vehicle, including PX4 External modes created using the [PX4 ROS 2 Control Interface](../ros2/px4_ros2_control_interface.md), and get or set the current mode.
uint16 VEHICLE_CMD_DO_SET_CAM_TRIGG_INTERVAL=214 # Mission command to set TRIG_INTERVAL for this flight. |[m] Camera trigger distance|Shutter integration time (ms)|Unused|Unused|Unused|Unused|Unused|
73
74
uint16 VEHICLE_CMD_DO_MOUNT_CONTROL_QUAT=220 # Mission command to control a camera or antenna mount, using a quaternion as reference. |q1 - quaternion param #1, w (1 in null-rotation)|q2 - quaternion param #2, x (0 in null-rotation)|q3 - quaternion param #3, y (0 in null-rotation)|q4 - quaternion param #4, z (0 in null-rotation)|Unused|Unused|Unused|
74
75
uint16 VEHICLE_CMD_DO_GUIDED_MASTER=221 # Set id of master controller. |System ID|Component ID|Unused|Unused|Unused|Unused|Unused|
0 commit comments