Skip to content

Commit 4acb8ec

Browse files
New Crowdin translations - zh-CN (#26111)
Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
1 parent 89d4318 commit 4acb8ec

File tree

7 files changed

+49
-9
lines changed

7 files changed

+49
-9
lines changed

docs/zh/advanced/neural_networks.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ If you are looking for more resources to learn about the module, a website has b
2626

2727
## Neural Network PX4 Firmware
2828

29+
:::warning
30+
This module requires Ubuntu 24.04 or newer (it is not supported in Ubuntu 22.04).
31+
:::
32+
2933
The module has been tested on a number of configurations, which can be build locally using the commands:
3034

3135
```sh

docs/zh/config/compass.md

Lines changed: 38 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ If you have [mounted the compass](../assembly/mount_gps_compass.md#compass-orien
1010

1111
## 综述
1212

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.
1414

1515
:::tip
1616
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`.
2020
The process calibrates all compasses and autodetects the orientation of any external compasses.
2121
If any external magnetometers are available, it then disables the internal magnetometers (these are primarily needed for automatic rotation detection of external magnetometers).
2222

23+
### Types of Calibration
24+
2325
Several types of compass calibration are available:
2426

2527
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.
2628
It compensates for hard and soft iron effects by estimating an offset and a scale factor for each axis.
2729
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.
2830
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.
3033

3134
## 执行校准
3235

@@ -57,19 +60,23 @@ The calibration steps are:
5760
![Select Compass calibration PX4](../../assets/qgc/setup/sensor/sensor_compass_select_px4.png)
5861

5962
::: info
60-
You should already have set the [Autopilot Orientation](../config/flight_controller_orientation.md). If not, you can also set it here.
63+
You should already have set the [Autopilot Orientation](../config/flight_controller_orientation.md).
64+
If not, you can also set it here.
6165

6266
:::
6367

6468
4. Click **OK** to start the calibration.
6569

66-
5. 把你的飞机放置在下面显示的某一个方向,并保持静止。 随后提示(方向图像变为黄色)在指定方向旋转飞行器。 该位置标定完成后,屏幕上的相应图示将变成绿色。
70+
5. 把你的飞机放置在下面显示的某一个方向,并保持静止。
71+
随后提示(方向图像变为黄色)在指定方向旋转飞行器。
72+
该位置标定完成后,屏幕上的相应图示将变成绿色。
6773

6874
![Compass calibration steps on PX4](../../assets/qgc/setup/sensor/sensor_compass_calibrate_px4.png)
6975

7076
6. 在机体的所有方向上重复校准步骤。
7177

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.
7380

7481
### Partial "Quick" Calibration
7582

@@ -92,7 +99,8 @@ This calibration is similar to the well-known figure-8 compass calibration done
9299

93100
This calibration process leverages external knowledge of vehicle's orientation and location, and a World Magnetic Model (WMM) to calibrate the hard iron biases.
94101

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.
96104
2. Align the vehicle to face True North.
97105
Be as accurate as possible for best results.
98106
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
112120

113121
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.
114122

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.
140+
- _QGroundControl reports magnetometer inconsistencies_.
141+
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+
115147
## Additional Calibration/Configuration
116148

117149
The process above will autodetect, [set default rotations](../advanced_config/parameter_reference.md#SENS_MAG_AUTOROT), calibrate, and prioritise, all available magnetometers.

docs/zh/mavlink/standard_modes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
<Badge type="tip" text="PX4 v1.15" />
44

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).
66

77
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.
88

docs/zh/modules/modules_driver.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -899,6 +899,8 @@ fetching the latest mixing result and write them to PCA9685 at its scheduling ti
899899
It can do full 12bits output as duty-cycle mode, while also able to output precious pulse width
900900
that can be accepted by most ESCs and servos.
901901

902+
The I2C bus and address can be configured via parameters `PCA9685_EN_BUS` and `PCA9685_I2C_ADDR`, or via command line arguments.
903+
902904
### 示例
903905

904906
It is typically started with:

docs/zh/msg_docs/VehicleCommand.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ uint16 VEHICLE_CMD_DO_PARACHUTE=208 # Mission command to trigger a parachute. |a
6969
uint16 VEHICLE_CMD_DO_MOTOR_TEST=209 # Motor test command. |Instance (@range 1, )|throttle type|throttle|timeout [s]|Motor count|Test order|Unused|
7070
uint16 VEHICLE_CMD_DO_INVERTED_FLIGHT=210 # Change to/from inverted flight. |inverted (0=normal, 1=inverted)|Unused|Unused|Unused|Unused|Unused|Unused|
7171
uint16 VEHICLE_CMD_DO_GRIPPER = 211 # Command to operate a gripper.
72+
uint16 VEHICLE_CMD_DO_AUTOTUNE_ENABLE = 212 # Enable autotune module. |1 to enable|Unused|Unused|Unused|Unused|Unused|Unused|
7273
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|
7374
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|
7475
uint16 VEHICLE_CMD_DO_GUIDED_MASTER=221 # Set id of master controller. |System ID|Component ID|Unused|Unused|Unused|Unused|Unused|

docs/zh/releases/main.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@ Please continue reading for [upgrade instructions](#upgrade-guide).
5555
### 传感器
5656

5757
- Add [sbgECom INS driver](../sensor/sbgecom.md) ([PX4-Autopilot#24137](https://github.com/PX4/PX4-Autopilot/pull/24137))
58+
- Quick magnetometer calibration now supports specifying an arbitrary initial heading ([PX4-Autopilot#24637](https://github.com/PX4/PX4-Autopilot/pull/24637))
5859

5960
### 仿真
6061

docs/zh/ros2/user_guide.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -552,8 +552,8 @@ ros2 run ros_gz_bridge parameter_bridge /clock@rosgraph_msgs/msg/Clock[gz.msgs.C
552552
代码首先导入了与 ROS 2 中间件进行交互所需的 C++ 库,以及该节点所订阅的SensorCombined消息对应的头部文件:
553553
554554
```cpp
555-
#include <0>
556-
#include <1>
555+
#include <rclcpp/rclcpp.hpp>
556+
#include <px4_msgs/msg/sensor_combined.hpp>
557557
```
558558
559559
随后,代码创建了一个 SensorCombinedListener 类,该类继承自通用的 rclcpp::Node 基类。

0 commit comments

Comments
 (0)