New Crowdin translations - zh-CN (#25661)

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
2025-12-09 04:01:49 +08:00 · 2025-10-08 16:19:27 +11:00
parent fa706c905f
commit d3bcdf8ba7
20 changed files with 631 additions and 283 deletions
--- a/docs/zh/SUMMARY.md
+++ b/docs/zh/SUMMARY.md
@@ -436,6 +436,7 @@
      - [Attitude Tuning](config_rover/attitude_tuning.md)
      - [Velocity Tuning](config_rover/velocity_tuning.md)
      - [Position Tuning](config_rover/position_tuning.md)
+    - [Apps & API](flight_modes_rover/api.md)
    - [Complete Vehicles](complete_vehicles_rover/index.md)
      - [Aion Robotics R1](complete_vehicles_rover/aion_r1.md)
  - [Submarines (experimental)](frames_sub/index.md)
@@ -872,6 +873,7 @@
    - [PX4 ROS 2 Interface Library](ros2/px4_ros2_interface_lib.md)
      - [Control Interface](ros2/px4_ros2_control_interface.md)
      - [Navigation Interface](ros2/px4_ros2_navigation_interface.md)
+      - [Waypoint Missions](ros2/px4_ros2_waypoint_missions.md)
    - [ROS 2 Message Translation Node](ros2/px4_ros2_msg_translation_node.md)
  - [ROS 1 (Deprecated)](ros/ros1.md)
    - [ROS/MAVROS安装指南](ros/mavros_installation.md)
--- a/docs/zh/companion_computer/pixhawk_rpi.md
+++ b/docs/zh/companion_computer/pixhawk_rpi.md
@@ -266,7 +266,7 @@ The configuration steps are:
   ```

   [MAV_1_CONFIG=0](../advanced_config/parameter_reference.md#MAV_1_CONFIG) and [UXRCE_DDS_CFG=102](../advanced_config/parameter_reference.md#UXRCE_DDS_CFG) disable MAVLink on TELEM2 and enable the uXRCE-DDS client on TELEM2, respectively.
-   The `SER_TEL2_BAUD` rate sets the comms link data rate.\
+   The `SER_TEL2_BAUD` rate sets the comms link data rate.  
   You could similarly configure a connection to `TELEM1` using either `MAV_1_CONFIG` or `MAV_0_CONFIG`.

   ::: info
--- a/docs/zh/config/_autotune.md
+++ b/docs/zh/config/_autotune.md
@@ -95,9 +95,17 @@ The test steps are:

   4. Read the warning popup and click on **OK** to start tuning.

+<div style="display: inline;" v-if="$frontmatter.frame === 'Multicopter'">
+
 4. The drone will first start to perform quick roll motions followed by pitch and yaw motions.
   The progress is shown in the progress bar, next to the _Autotune_ button.

+</div><div v-else-if="$frontmatter.frame === 'Plane'">
+
+4. The drone will first start to perform quick roll motions followed by pitch and yaw motions. When [`FW_AT_SYSID_TYPE`](../advanced_config/parameter_reference.md#FW_AT_SYSID_TYPE) is set to linear/logarithmic sine sweep (recommended), the max rates are approximately 45 deg/s for roll and 30 deg/s for pitch and yaw.
+   The progress is shown in the progress bar, next to the _Autotune_ button.
+
+</div>
 <div style="display: inline;" v-if="$frontmatter.frame === 'Multicopter'">

 5. Manually land and disarm to apply the new tuning parameters.
@@ -108,6 +116,13 @@ The test steps are:
 5. The tuning will be immediately/automatically be applied and tested in flight (by default).
   PX4 will then run a 4 second test and revert the new tuning if a problem is detected.

+The figure below shows how steps 4 and 5 might look in flight on the pitch axis.
+The pitch rate gradually increases up until it reaches the target.
+This amplitude is then held while the signal frequency is increased.
+You can then see how the tuned system is able to follow the setpoint in the test signal.
+
+<img src="../../assets/config/fw/autotune.png" title="Fixed-Wing Autotune"/>
+
 </div>

 :::warning
@@ -174,9 +189,20 @@ Fast oscillations (more than 1 oscillation per second): this is because the gain

 ### The auto-tuning sequence fails

+<div v-if="$frontmatter.frame === 'Multicopter'">
+
 If the drone was not moving enough during auto-tuning, the system identification algorithm might have issues to find the correct coefficients.

-Increase the <div style="display: inline;" v-if="$frontmatter.frame === 'Multicopter'">[MC_AT_SYSID_AMP](../advanced_config/parameter_reference.md#MC_AT_SYSID_AMP)</div><div style="display: inline;" v-else-if="$frontmatter.frame === 'Plane'">[FW_AT_SYSID_AMP](../advanced_config/parameter_reference.md#FW_AT_SYSID_AMP)</div> parameter by steps of 1 and trigger the auto-tune again.
+Increase the [MC_AT_SYSID_AMP](../advanced_config/parameter_reference.md#MC_AT_SYSID_AMP) parameter by steps of 1 and trigger the auto-tune again.
+
+</div>
+<div v-else-if="$frontmatter.frame === 'Plane'">
+
+By default, the autotune maneuvers ensure that a sufficient angular rate is reached for system identification. The target rates are approximately 45 deg/s for roll and 30 deg/s for pitch and yaw.
+
+If the signal-to-noise ratio of the vehicle is low, the system identification algorithm might have issues finding the correct coefficients. Ensure that there is no excessive noise and/or platform vibration.
+
+</div>

 ### The drone oscillates after auto-tuning

--- a/docs/zh/debug/failure_injection.md
+++ b/docs/zh/debug/failure_injection.md
@@ -9,7 +9,7 @@ Failure injection is disabled by default, and can be enabled using the [SYS_FAIL
 Failure injection still in development.
 At time of writing (PX4 v1.14):

- It can only be used in simulation (support for both failure injection in real flight is planned).
+- Support may vary by failure type and between simulatiors and real vehicle.
 - It requires support in the simulator.
  It is supported in Gazebo Classic
 - Many failure types are not broadly implemented.
@@ -33,31 +33,31 @@ where:

 - _component_:
  - 传感器：
-    - `gyro`: Gyro.
-    - `accel`: Accelerometer.
+    - `gyro`: Gyroscope
+    - `accel`: Accelerometer
    - `mag`: Magnetometer
    - `baro`: Barometer
-    - `gps`: GPS
+    - `gps`: Global navigation satellite system
    - `optical_flow`: Optical flow.
-    - `vio`: Visual inertial odometry.
+    - `vio`: Visual inertial odometry
    - `distance_sensor`: Distance sensor (rangefinder).
-    - `airspeed`: Airspeed sensor.
+    - `airspeed`: Airspeed sensor
  - Systems:
-    - `battery`: Battery.
-    - `motor`: Motor.
-    - `servo`: Servo.
-    - `avoidance`: Avoidance.
-    - `rc_signal`: RC Signal.
-    - `mavlink_signal`: MAVLink signal (data telemetry).
+    - `battery`: Battery
+    - `motor`: Motor
+    - `servo`: Servo
+    - `avoidance`: Avoidance
+    - `rc_signal`: RC Signal
+    - `mavlink_signal`: MAVLink data telemetry connection
 - _failure_type_:
-  - `ok`: Publish as normal (Disable failure injection).
-  - `off`: Stop publishing.
-  - `stuck`: Report same value every time (_could_ indicate a malfunctioning sensor).
-  - `garbage`: Publish random noise. This looks like reading uninitialized memory.
-  - `wrong`: Publish invalid values (that still look reasonable/aren't "garbage").
-  - `slow`: Publish at a reduced rate.
-  - `delayed`: Publish valid data with a significant delay.
-  - `intermittent`: Publish intermittently.
+  - `ok`: Publish as normal (Disable failure injection)
+  - `off`: Stop publishing
+  - `stuck`: Constantly report the same value which _can_ happen on a malfunctioning sensor
+  - `garbage`: Publish random noise. This looks like reading uninitialized memory
+  - `wrong`: Publish invalid values that still look reasonable/aren't "garbage"
+  - `slow`: Publish at a reduced rate
+  - `delayed`: Publish valid data with a significant delay
+  - `intermittent`: Publish intermittently
 - _instance number_ (optional): Instance number of affected sensor.
  0 (default) indicates all sensors of specified type.

@@ -65,7 +65,7 @@ where:

 To simulate losing RC signal without having to turn off your RC controller:

-1. Enable the parameter [SYS_FAILURE_EN](../advanced_config/parameter_reference.md#SYS_FAILURE_EN).
+1. Enable the parameter [SYS_FAILURE_EN](../advanced_config/parameter_reference.md#SYS_FAILURE_EN). And specifically to turn off motors also [CA_FAILURE_MODE](../advanced_config/parameter_reference.md#CA_FAILURE_MODE).
 2. Enter the following commands on the MAVLink console or SITL _pxh shell_:

   ```sh
--- a/docs/zh/flight_modes/offboard.md
+++ b/docs/zh/flight_modes/offboard.md
@@ -62,6 +62,11 @@ bool thrust_and_torque
 bool direct_actuator
 ```

+:::warning
+The following list shows the `OffboardControlMode` options for copter, fixed-wing, and VTOL.
+For rovers see the [rover section](#rover).
+:::
+
 The fields are ordered in terms of priority such that `position` takes precedence over `velocity` and later fields, `velocity` takes precedence over `acceleration`, and so on.
 第一个非零字段(从上到下) 定义了Offboard模式所需的有效估计以及可用的设定值消息。
 For example, if the `acceleration` field is the first non-zero value, then PX4 requires a valid `velocity estimate`, and the setpoint must be specified using the `TrajectorySetpoint` message.
@@ -90,20 +95,93 @@ Before using offboard mode with ROS 2, please spend a few minutes understanding
    - Velocity setpoint (`velocity` different from `NaN` and `position` set to `NaN`). Non-`NaN` values acceleration are used as feedforward terms for the inner loop controllers.
    - Acceleration setpoint (`acceleration` different from `NaN` and `position` and `velocity` set to `NaN`)

-  - 所有值都是基于NED(北, 东, 地)坐标系，位置、速度和加速的单位分别为\[m\], \[m/s\] 和\[m/s^2\] 。
+  - All values are interpreted in NED (Nord, East, Down) coordinate system and the units are `[m]`, `[m/s]` and `[m/s^2]` for position, velocity and acceleration, respectively.

 - [px4_msgs::msg::VehicleAttitudeSetpoint](https://github.com/PX4/PX4-Autopilot/blob/main/msg/versioned/VehicleAttitudeSetpoint.msg)
  - 支持以下输入组合：
    - quaternion `q_d` + thrust setpoint `thrust_body`.
-      Non-`NaN` values of `yaw_sp_move_rate` are used as feedforward terms expressed in Earth frame and in \[rad/s\].
+      Non-`NaN` values of `yaw_sp_move_rate` are used as feedforward terms expressed in Earth frame and in `[rad/s]`.

-  - 姿态四元数表示无人机机体坐标系FRD(前、右、下) 与NED坐标系之间的旋转。 这个推力是在无人机体轴FRD坐标系下，并归一化为 \[-1, 1\] 。
+  - 姿态四元数表示无人机机体坐标系FRD(前、右、下) 与NED坐标系之间的旋转。
+    这个推力是在无人机体轴FRD坐标系下，并归一化为 \[-1, 1\] 。

 - [px4_msgs::msg::VehicleRatesSetpoint](https://github.com/PX4/PX4-Autopilot/blob/main/msg/versioned/VehicleRatesSetpoint.msg)
  - 支持以下输入组合：
    - `roll`, `pitch`, `yaw` and `thrust_body`.

-  - 所有值都表示在无人机体轴FRD坐标系下。 角速率(roll, pitch, yaw) 单位为\[rad/s\] ，thrust_body归一化为 \[-1, 1\]。
+  - 所有值都表示在无人机体轴FRD坐标系下。
+    The rates are in `[rad/s]` while thrust_body is normalized in `[-1, 1]`.
+
+### 无人车
+
+Rover modules must set the control mode using `OffboardControlMode` and use the appropriate messages to configure the corresponding setpoints.
+The approach is similar to other vehicle types, but the allowed control mode combinations and setpoints are different:
+
+| Category                                                                               | 用法                      | Setpoints                                                                                                                                                                                                                                                                                                                                                                  |
+| -------------------------------------------------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| (Recommended) [Rover Setpoints](#rover-setpoints)                   | General rover control   | [RoverPositionSetpoint](../msg_docs/RoverPositionSetpoint.md), [RoverSpeedSetpoint](../msg_docs/RoverSpeedSetpoint.md), [RoverAttitudeSetpoint](../msg_docs/RoverAttitudeSetpoint.md), [RoverRateSetpoint](../msg_docs/RoverRateSetpoint.md), [RoverThrottleSetpoint](../msg_docs/RoverThrottleSetpoint.md), [RoverSteeringSetpoint](../msg_docs/RoverSteeringSetpoint.md) |
+| [Actuator Setpoints](#actuator-setpoints)                                              | Direct actuator control | [ActuatorMotors](../msg_docs/ActuatorMotors.md), [ActuatorServos](../msg_docs/ActuatorServos.md)                                                                                                                                                                                                                                                                           |
+| (Deprecated) [Trajectory Setpoint](#deprecated-trajectory-setpoint) | General vehicle control | [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md)                                                                                                                                                                                                                                                                                                                    |
+
+#### Rover Setpoints
+
+The rover modules use a hierarchical structure to propagate setpoints:
+
+![Rover Control Structure](../../assets/middleware/ros2/px4_ros2_interface_lib/rover_control_structure.svg)
+
+The "highest" setpoint that is provided will be used within the PX4 rover modules to generate the setpoints that are below it (overriding them!).
+With this hierarchy there are clear rules for providing a valid control input:
+
+- Provide a position setpoint **or**
+- One of the setpoints on the "left" (speed **or** throttle) **and** one of the setpoints on the "right" (attitude, rate **or** steering).
+  All combinations of "left" and "right" setpoints are valid.
+
+The following are all valid setpoint combinations and their respective control flags that must be set through [OffboardControlMode](../msg_docs/OffboardControlMode.md) (set all others to _false_).
+Additionally, for some combinations we require certain setpoints to be published with `NAN` values so that the setpoints of interest are not overridden by the rover module (due to the hierarchy above).
+&check; are the relevant setpoints we publish, and &cross; are the setpoint that need to be published with `NAN` values.
+
+| Setpoint Combination | Control Flag                                                | [RoverPositionSetpoint](../msg_docs/RoverPositionSetpoint.md) | [RoverSpeedSetpoint](../msg_docs/RoverSpeedSetpoint.md) | [RoverThrottleSetpoint](../msg_docs/RoverThrottleSetpoint.md) | [RoverAttitudeSetpoint](../msg_docs/RoverAttitudeSetpoint.md) | [RoverRateSetpoint](../msg_docs/RoverRateSetpoint.md) | [RoverSteeringSetpoint](../msg_docs/RoverSteeringSetpoint.md) |
+| -------------------- | ----------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------- |
+| 安装位置                 | 位置                                                          | &check;                                   |                                                         |                                                               |                                                               |                                                       |                                                               |
+| Speed + Attitude     | 速度                                                          |                                                               | &check;                             |                                                               | &check;                                   |                                                       |                                                               |
+| Speed + Rate         | 速度                                                          |                                                               | &check;                             |                                                               | &cross;                                   | &check;                           |                                                               |
+| Speed + Steering     | 速度                                                          |                                                               | &check;                             |                                                               | &cross;                                   | &cross;                           | &check;                                   |
+| Throttle + Attitude  | attitude                                                    |                                                               |                                                         | &check;                                   | &check;                                   |                                                       |                                                               |
+| Throttle + Rate      | body_rate                              |                                                               |                                                         | &check;                                   |                                                               | &check;                           |                                                               |
+| Throttle + Steering  | thrust_and_torque |                                                               |                                                         | &check;                                   |                                                               |                                                       | &check;                                   |
+
+:::info
+If you intend to use the rover setpoints, we recommend using the [PX4 ROS 2 Interface Library](../ros2/px4_ros2_interface_lib.md) instead since it simplifies the publishing of these setpoints.
+:::
+
+#### Actuator Setpoints
+
+Instead of controlling the vehicle using position, speed, rate and other setpoints, you can directly control the motors and actuators using [ActuatorMotors](../msg_docs/ActuatorMotors.md) and [ActuatorServos](../msg_docs/ActuatorServos.md).
+In [OffboardControlMode](../msg_docs/OffboardControlMode.md) set `direct_actuator` to _true_ and all other flags to _false_.
+
+:::info
+This bypasses the rover modules including any limits on steering rates or accelerations and the inverse kinematics step.
+We recommend using [RoverSteeringSetpoint](../msg_docs/RoverSteeringSetpoint.md) and [RoverThrottleSetpoint](../msg_docs/RoverThrottleSetpoint.md) instead for low level control (see [Rover Setpoints](#rover-setpoints)).
+:::
+
+#### (Deprecated) Trajectory Setpoint
+
+:::warning
+The [Rover Setpoints](#rover-setpoints) are a replacement for the [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md) and we highly recommend using those instead as they have a well defined behaviour and offer more flexibility.
+:::
+
+The rover modules support the _position_, _velocity_ and _yaw_ fields of the [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md).
+However, only one of the fields is active at a time and is defined by the flags of [OffboardControlMode](../msg_docs/OffboardControlMode.md):
+
+| Control Mode Flag | Active Trajectory Setpoint Field |
+| ----------------- | -------------------------------- |
+| 位置                | 位置                               |
+| 速度                | 速度                               |
+| attitude          | yaw                              |
+
+:::info
+Ackermann rovers do not support the yaw setpoint.
+:::

 ### Generic Vehicle

@@ -116,8 +194,10 @@ Before using offboard mode with ROS 2, please spend a few minutes understanding

 - [px4_msgs::msg::ActuatorMotors](https://github.com/PX4/PX4-Autopilot/blob/main/msg/versioned/ActuatorMotors.msg) + [px4_msgs::msg::ActuatorServos](https://github.com/PX4/PX4-Autopilot/blob/main/msg/versioned/ActuatorServos.msg)
  - 直接控制电机输出和/或伺服系统（舵机）输出。
-  - Currently works at lower level than then `control_allocator` module. Do not publish these messages when not in offboard mode.
-  - 所有值归一化为\[-1, 1\]。 For outputs that do not support negative values, negative entries map to `NaN`.
+  - Currently works at lower level than then `control_allocator` module.
+    Do not publish these messages when not in offboard mode.
+  - All the values normalized in `[-1, 1]`.
+    For outputs that do not support negative values, negative entries map to `NaN`.
  - `NaN` maps to disarmed.

 ## MAVLink 消息
@@ -207,41 +287,7 @@ Before using offboard mode with ROS 2, please spend a few minutes understanding

 ### 无人车

- [SET_POSITION_TARGET_LOCAL_NED](https://mavlink.io/en/messages/common.html#SET_POSITION_TARGET_LOCAL_NED)
-  - The following input combinations are supported (in `type_mask`): <!-- https://github.com/PX4/PX4-Autopilot/blob/main/src/lib/FlightTasks/tasks/Offboard/FlightTaskOffboard.cpp#L166-L170 -->
-    - Position setpoint (only `x`, `y`, `z`)
-      - Specify the _type_ of the setpoint in `type_mask`:
-
-        ::: info
-        The _setpoint type_ values below are not part of the MAVLink standard for the `type_mask` field.
-        ::
-
-        值为：
-
-        - 12288：悬停设定值（无人机足够接近设定值时会停止）。
-
-    - Velocity setpoint (only `vx`, `vy`, `vz`)
-
-  - PX4 supports the coordinate frames (`coordinate_frame` field): [MAV_FRAME_LOCAL_NED](https://mavlink.io/en/messages/common.html#MAV_FRAME_LOCAL_NED) and [MAV_FRAME_BODY_NED](https://mavlink.io/en/messages/common.html#MAV_FRAME_BODY_NED).
-
- [SET_POSITION_TARGET_GLOBAL_INT](https://mavlink.io/en/messages/common.html#SET_POSITION_TARGET_GLOBAL_INT)
-  - The following input combinations are supported (in `type_mask`): <!-- https://github.com/PX4/PX4-Autopilot/blob/main/src/lib/FlightTasks/tasks/Offboard/FlightTaskOffboard.cpp#L166-L170 -->
-    - Position setpoint (only `lat_int`, `lon_int`, `alt`)
-
-  - Specify the _type_ of the setpoint in `type_mask` (not part of the MAVLink standard).
-    值为：
-    - 下面的比特位没有置位，是正常表现。
-    - 12288：悬停设定值（无人机足够接近设定值时会停止）。
-
-  - PX4 supports the coordinate frames (`coordinate_frame` field): [MAV_FRAME_GLOBAL](https://mavlink.io/en/messages/common.html#MAV_FRAME_GLOBAL).
-
- [SET_ATTITUDE_TARGET](https://mavlink.io/en/messages/common.html#SET_ATTITUDE_TARGET)
-  - 支持以下输入组合：
-    - Attitude/orientation (`SET_ATTITUDE_TARGET.q`) with thrust setpoint (`SET_ATTITUDE_TARGET.thrust`).
-      ::: info
-      Only the yaw setting is actually used/extracted.
-
-:::
+Rover does not support a MAVLink offboard API (ROS2 is supported).

 ## Offboard参数

--- a/docs/zh/flight_modes_rover/api.md
+++ b/docs/zh/flight_modes_rover/api.md
@@ -0,0 +1,29 @@
+# Apps & API
+
+The rover modules have been tested and integrated with a subset of the available [Apps & API](../middleware/index.md) methods.
+We specifically provide guides for using [ROS 2](../ros2/index.md) to interface a companion computer with PX4 via [uXRCE-DDS](../middleware/uxrce_dds.md).
+
+| Method                                                                       | 描述                                                                                                                                                                                                     |
+| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [PX4 ROS 2 Interface](#px4-ros-2-interface) (Recommended) | Register a custom mode and publish [RoverSetpointTypes](../ros2/px4_ros2_control_interface.md#rover-setpoints).                                                                        |
+| [ROS 2 Offboard Control](#ros-2-offboard-control)                            | Use the PX4 internal [Offboard Mode](../flight_modes/offboard.md) and publish messages defined in [dds_topics.yaml](../middleware/dds_topics.md). |
+
+## PX4 ROS 2 Interface
+
+We recommend the use of the [PX4 ROS 2 Interface Library](../ros2/px4_ros2_interface_lib.md) which allows you to register a custom drive mode and exposes [RoverSetpointTypes](../ros2/px4_ros2_control_interface.md#rover-setpoints).
+
+By using these setpoints (instead of the PX4 internal rover setpoints), you are guaranteed to send valid control inputs to your vehicle and the control flags for the setpoints you are using are automatically set for you.
+Registering a custom drive mode instead of using [ROS 2 Offboard Control](#ros-2-offboard-control) additionally provides the advantages listed [here](../concept/flight_modes.md#internal-vs-external-modes).
+
+To get familiar with this method, read through the guide for the [PX4 ROS 2 Interface Library](../ros2/px4_ros2_interface_lib.md) where we also provide an example app for rover.
+
+## ROS 2 Offboard Control
+
+[ROS 2 Offboard Control](../ros2/offboard_control.md) uses the PX4 internal [Offboard Mode](../flight_modes/offboard.md).
+
+While you can subscribe/publish to all topics specified in [dds_topics.yaml](../middleware/dds_topics.md), not all rover modules support all of these topics (see [Supported Setpoints](../flight_modes/offboard.md#rover)).
+Unlike the [RoverSetpointTypes](../ros2/px4_ros2_control_interface.md#rover-setpoints) exposed through the [PX4 ROS 2 Interface](#px4-ros-2-interface), there is no guarantee that the published setpoints lead to a valid control input.
+
+In addition, the correct control mode flags must be set through [OffboardControlMode](../msg_docs/OffboardControlMode.md).
+This requires a deeper understanding of PX4 and the structure of the rover modules.
+For general information on setting up offboard mode read through [Offboard Mode](../flight_modes/offboard.md) and then consult [Supported Setpoints](../flight_modes/offboard.md#rover).
--- a/docs/zh/frames_rover/index.md
+++ b/docs/zh/frames_rover/index.md
@@ -21,7 +21,7 @@ The supported frames can be seen in [Airframes Reference > Rover](../airframes/a

 ## Ackermann

-<0/> <1/>
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="warning" text="Experimental" />

 An Ackermann rover controls its direction by pointing the front wheels in the direction of travel — the [Ackermann steering geometry](https://en.wikipedia.org/wiki/Ackermann_steering_geometry) compensates for the fact that wheels on the inside and outside of the turn move at different rates.
 This kind of steering is used on most commercial vehicles, including cars, trucks etc.
@@ -34,7 +34,7 @@ PX4 does not require that the vehicle uses the Ackermann geometry and will work

 ## Differential

-<0/> <1/>
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="warning" text="Experimental" />

 A differential rover's motion is controlled using a differential drive mechanism, where the left and right wheel speeds are adjusted independently to achieve the desired forward speed and yaw rate.
 Forward motion is achieved by driving both wheels at the same speed in the same direction.
@@ -48,7 +48,7 @@ The differential setup also work for rovers with skid or tank steering.

 ## Mecanum

-<0/> <1/>
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="warning" text="Experimental" />

 A Mecanum rover is a type of mobile robot that uses Mecanum wheels to achieve omnidirectional movement. These wheels are unique because they have rollers mounted at a 45-degree angle around their circumference, allowing the rover to move not only forward and backward but also side-to-side and diagonally without needing to rotate first.
 Each wheel is driven by its own motor, and by controlling the speed and direction of each motor, the rover can move in any direction or spin in place.
@@ -57,15 +57,17 @@ Each wheel is driven by its own motor, and by controlling the speed and directio

 ## See Also

- [Drive Modes](../flight_modes_rover/index.md).
+- [Drive Modes](../flight_modes_rover/index.md)
 - [Configuration/Tuning](../config_rover/index.md)
+- [Apps & API](../flight_modes_rover/api.md)
 - [Complete Vehicles](../complete_vehicles_rover/index.md)

 ## 仿真

-[Gazebo](../sim_gazebo_gz/index.md) provides simulations for ackermann and differential rovers:
+PX4 provides synthetic simulation models for [Gazebo](../sim_gazebo_gz/index.md) of all three rover types to test the software and validate changes and new features:

 - [Ackermann rover](../sim_gazebo_gz/vehicles.md#ackermann-rover)
 - [Differential rover](../sim_gazebo_gz/vehicles.md#differential-rover)
+- [Mecanum rover](../sim_gazebo_gz/vehicles.md#mecanum-rover)

 ![Rover gazebo simulation](../../assets/airframes/rover/rover_simulation.png)
--- a/docs/zh/middleware/uxrce_dds.md
+++ b/docs/zh/middleware/uxrce_dds.md
@@ -389,12 +389,12 @@ While most releases should support a very similar set of messages, to be certain

 Note that ROS 2/DDS needs to have the _same_ message definitions that were used to create the uXRCE-DDS client module in the PX4 Firmware in order to interpret the messages.
 The message definitions are stored in the ROS 2 interface package [PX4/px4_msgs](https://github.com/PX4/px4_msgs), and they are automatically synchronized by CI on the `main` and release branches.
-Note that all the messages from PX4 source code are present in the repository, but only those listed in `dds_topics.yaml` will be available as ROS 2 topics.
-Therefore,
+需要注意的是，PX4 源代码中的所有消息均存在于该代码仓库中，但只有在dds_topics.yaml文件中列出的消息，才会作为 ROS 2 话题可用。
+因此

- If you're using a main or release version of PX4 you can get the message definitions by cloning the interface package [PX4/px4_msgs](https://github.com/PX4/px4_msgs) into your workspace.
- If you're creating or modifying uORB messages you must manually update the messages in your workspace from your PX4 source tree.
-  Generally this means that you would update [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml), clone the interface package, and then manually synchronize it by copying the new/modified message definitions from [PX4-Autopilot/msg](https://github.com/PX4/PX4-Autopilot/tree/main/msg) to its `msg` folders.
+- 如果您正在使用 PX4 的主要版本或发布版本，您可以通过克隆接口包[PX4/px4_msgs](https://github.com/PX4/px4_msgs)获得消息定义。
+- 如果您要创建或修改 uORB 消息，必须从 PX4 源代码树中手动更新工作空间中的消息。
+  一般来说，这意味着您将更新 [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml)，克隆接口包。 然后手动同步，将新的/修改的消息定义从 [PX4-Autopilot/msg](https://github.com/PX4/PX4-Autopilot/tree/main/msg)复制到它的 `msg` 文件夹。
  Assuming that PX4-Autopilot is in your home directory `~`, while `px4_msgs` is in `~/px4_ros_com/src/`, then the command might be:

  ```sh
@@ -412,13 +412,13 @@ Therefore,

 Custom topic and service namespaces can be applied at build time (changing [dds_topics.yaml](../middleware/dds_topics.md)), at runtime, or through a parameter (which is useful for multi vehicle operations):

- One possibility is to use the `-n` option when starting the [uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client) from command line.
-  This technique can be used both in simulation and real vehicles.
- A custom namespace can be provided for simulations (only) by setting the environment variable `PX4_UXRCE_DDS_NS` before starting the simulation.
+- 一种可能性是在从命令行启动[uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client)时使用 "-n" 选项。
+  这种技术既可用于模拟，也可用于实际机体。
+- 在开始模拟前，可以通过设置环境变量 `PX4_UXRCE_DDS_NS`来提供自定义命名空间 (仅限)

 :::info
 Changing the namespace at runtime will append the desired namespace as a prefix to all `topic` fields in [dds_topics.yaml](../middleware/dds_topics.md) and all [service servers](#dds-ros-2-services).
-Therefore, commands like:
+因此，命令如下：

 ```sh
 uxrce_dds_client start -n uav_1
@@ -430,7 +430,7 @@ uxrce_dds_client start -n uav_1
 PX4_UXRCE_DDS_NS=uav_1 make px4_sitl gz_x500
 ```

-will generate topics under the namespaces:
+将在以下命名空间下生成话题：

 ```sh
 /uav_1/fmu/in/  # for subscribers
--- a/docs/zh/releases/main.md
+++ b/docs/zh/releases/main.md
@@ -58,7 +58,10 @@ Please continue reading for [upgrade instructions](#upgrade-guide).

 ### 仿真

- TBD
+- Overhaul rover simulation:
+  - Add synthetic differential rover model: [PX4-gazebo-models#107](https://github.com/PX4/PX4-gazebo-models/pull/107)
+  - Add synthetic mecanum rover model: [PX4-gazebo-models#113](https://github.com/PX4/PX4-gazebo-models/pull/113)
+  - Update synthetic ackermann rover model: [PX4-gazebo-models#117](https://github.com/PX4/PX4-gazebo-models/pull/117)

 ### Ethernet

@@ -67,6 +70,7 @@ Please continue reading for [upgrade instructions](#upgrade-guide).
 ### uXRCE-DDS / ROS2

 - [PX4 ROS 2 Interface Library](../ros2/px4_ros2_control_interface.md) support for [Fixed Wing lateral/longitudinal setpoint](../ros2/px4_ros2_control_interface.md#fixed-wing-lateral-and-longitudinal-setpoint-fwlaterallongitudinalsetpointtype) (`FwLateralLongitudinalSetpointType`) and [VTOL transitions](../ros2/px4_ros2_control_interface.md#controlling-a-vtol). ([PX4-Autopilot#24056](https://github.com/PX4/PX4-Autopilot/pull/24056)).
+- [PX4 ROS 2 Interface Library](../ros2/px4_ros2_control_interface.md) support for [ROS-based waypoint missions](../ros2/px4_ros2_waypoint_missions.md).

 ### MAVLink

@@ -89,6 +93,8 @@ Please continue reading for [upgrade instructions](#upgrade-guide).
 ### 无人车

 - Removed deprecated rover module ([PX4-Autopilot#25054](https://github.com/PX4/PX4-Autopilot/pull/25054)).
+- Add support for [Apps & API](../flight_modes_rover/api.md) ([PX4-Autopilot#25074](https://github.com/PX4/PX4-Autopilot/pull/25074), [PX4-ROS2-Interface-Lib#140](https://github.com/Auterion/px4-ros2-interface-lib/pull/140)).
+- Update [rover simulation](../frames_rover/index.md#simulation) ([PX4-Autopilot#25644](https://github.com/PX4/PX4-Autopilot/pull/25644)) (see [Simulation](#simulation) release note for details).

 ### ROS 2

--- a/docs/zh/ros2/index.md
+++ b/docs/zh/ros2/index.md
@@ -6,23 +6,23 @@
 小提示
 PX4 开发团队强烈建议您使用此 ROS 版本，或将现有系统迁移至此 ROS 版本！

-这是最新版本的 [ROS](https://www.ros.org/) (机器人操作系统)。
+这是最新版本的 [ROS](https://www.ros.org/)(机器人操作系统)。
 它在 ROS “1” 的基础上进行了显著改进，尤其能够实现与 PX4 更深度、更低延迟的集成。
 :::

 ROS的优势在于拥有活跃的开发者生态系统 —— 该生态系统致力于解决各类常见的机器人技术问题，同时还能调用其他为 Linux 系统编写的软件库。
-例如，它可以用于 [computer vision](../computer_vision/index.md)解决问题。
+例如，它可以用于 [计算机试图](../computer_vision/index.md) 解决问题。

 ROS 2 能够实现与 PX4 极深度的集成，你可以在 ROS 2 中创建飞行模式，这些模式与 PX4 内部原生飞行模式毫无区别；同时还能以高速率直接读取和写入 PX4 内部的 uORB 主题。
 （尤其）建议在以下场景中使用：从伴飞计算机进行控制与通信（且低延迟至关重要时）、需借助 Linux 系统的现有库时，或编写新的高级飞行模式时。

 ROS 2 与 PX4 之间的通信使用的中间件需实现 [XRCE-DDS protocol](../middleware/uxrce_dds.md).
-这个中间件将以 ROS 2 消息和类型显示 PX4 [uORB messages](../msg_docs/index.md) 会转换为 ROS 2 消息和数据类型，从而切实支持从 ROS 2 工作流与节点直接访问 PX4。
+这个中间件将以 ROS 2 消息和类型显示 PX4  [uORB messages](../msg_docs/index.md) 会转换为 ROS 2 消息和数据类型，从而切实支持从 ROS 2 工作流与节点直接访问 PX4。
 中间件使用 uORB 消息定义生成代码来序列化和反序列化来处理PX4 的收发消息。
 这些相同的消息定义也用于 ROS 2 应用程序中以便能够解析这些消息。

 :::info
-ROS 2 也可以使用 [MAVROS](https://github.com/mavlink/mavros/tree/ros2/mavros而不是 XRCE-DDS连接到 PX4。
+ROS 2 也可以使用 [MAVROS](https://github.com/mavlink/mavros/tree/ros2/mavros)而不是 XRCE-DDS连接到 PX4。
 该选项受 MAVROS 项目支持（本文档未对此进行说明）。
 :::

@@ -33,9 +33,9 @@ ROS 2 也可以使用 [MAVROS](https://github.com/mavlink/mavros/tree/ros2/mavro

 本节的主要主题是：

- ROS 2 用户指南: PX4 视角下的 ROS 2，包括安装、设置和如何构建与 PX4 通信的 ROS 2 应用。
- [ROS 2 离板控制示例](../ros2/offboard_control.md)：一个 C++ 教程示例显示如何在 [离板模式] (../flight_modes/offboard.md) 中使用 ROS 2 节点进行位置控制。
- [ROS 2 多车辆模拟](../ros2/multi_vehicle.md)：通过单独的ROS2 代理商连接到多极PX4 模拟的说明。
+- [ROS 2 用户指南](../ros2/user_guide.md): PX4 视角下的 ROS 2，包括安装、设置和如何构建与 PX4 通信的 ROS 2 应用。
+- [ROS 2 离板控制实例](../ros2/offboard_control.md)：一个 C++ 教程示例显示如何在 [离板模式] (../flight_modes/offboard.md) 中使用 ROS 2 节点进行位置控制。
+- [ROS 2 多载具模拟](../ros2/multi_vehicle.md)：通过单独的ROS2 代理商连接到多极PX4 模拟的说明。
 - [PX4 ROS2 接口库](../ros2/px4_ros2_interface_lib.md)：一个C++ 库，它与ROS2的 PX4 交互。
  可以使用 ROS 2 创建和注册飞行模式，并从 ROS2 应用程序如VIO 系统发送位置估计数。
 - [ROS 2 消息翻译节点](../ros2/px4_ros2_msg_translation_node.md)：一个 ROS 2 消息翻译节点，它允许在 PX4 和 ROS 2 应用程序之间共享，这些应用程序被编译成不同的消息版本。
--- a/docs/zh/ros2/multi_vehicle.md
+++ b/docs/zh/ros2/multi_vehicle.md
@@ -1,54 +1,54 @@
-# 使用 ROS 2 进行多车辆模拟
+# 使用 ROS 2 的多载具模拟

-[XRCE-DDS](../middleware/uxrce_dds.md) 支持多个客户端通过 UDP 协议连接到同一个代理。
+[XRCE-DDS](../middleware/uxrce_dds.md)支持多个客户端通过 UDP 协议连接到同一个代理。
 这在模拟中特别有用，因为只有一个代理需要启动。

 ## 设置和要求

 唯一的要求是

- 能够在不依赖 ROS 2 的情况下，使用所需的仿真器([Gazebo](../sim_gazebo_gz/multi_vehicle_simulation.md), [Gazebo Classic](../sim_gazebo_classic/multi_vehicle_simulation.md#multiple-vehicle-with-gazebo-classic), [FlightGear](../sim_flightgear/multi_vehicle.md) 和 [JMAVSim](../sim_jmavsim/multi_vehicle.md))运行多车辆仿真[multi-vehicle simulation](../simulation/multi-vehicle-simulation.md)。
- 能够在单一车辆仿真中使用ROS 2（机器人操作系统 2）
+- 能够在不依赖 ROS 2 的情况下，使用所需的仿真器([Gazebo](../sim_gazebo_gz/multi_vehicle_simulation.md), [Gazebo Classic](../sim_gazebo_classic/multi_vehicle_simulation.md#multiple-vehicle-with-gazebo-classic), [FlightGear](../sim_flightgear/multi_vehicle.md) and [JMAVSim](../sim_jmavsim/multi_vehicle.md))运行多载具模拟 [multi-vehicle simulation](../simulation/multi-vehicle-simulation.md) 。
+- 能够在单一载具模拟中使用 [ROS 2](../ros2/user_guide.md)

 ## 工作原理

-在仿真中，每个 PX4 实例都会获得一个唯一的px4_instance编号，编号从0开始。
+在模拟中，每个 PX4 实例都会获得一个唯一的`px4_instance`编号，编号从`0`开始。
 该值用于为 [UXRCE_DDS_KEY](../advanced_config/parameter_reference.md#UXRCE_DDS_KEY)分配一个唯一值：

 ```sh
-参数设置 UXRCE_DDS_KEY $(px4_instance+1))
+参数设置UXRCE_DDS_KEY $((px4_instance+1))
 ```

 :::info
-通过这种方式，UXRCE_DDS_KEY 将始终与 [MAV_SYS_ID] 保持一致（../advanced_config/parameter_reference.md#MAV_SYS_ID）
+通过这种方式， `UXRCE_DDS_KEY` 将始终与 [MAV_SYS_ID] 保持一致(../advanced_config/parameter_reference.md#MAV_SYS_ID)
 :::

-此外，当 px4_instance 大于 0 时，会添加一个格式为 px4_$px4_instance 的唯一 ROS 2 命名空间前缀：
+此外，当 `px4_instance` 大于 0 时，会添加一个格式为  `px4_$px4_instance` 的唯一 ROS 2[namespace prefix](../middleware/uxrce_dds.md#customizing-the-namespace)：

 ```sh
 uxrce_dds_ns="-n px4_$px4_instance"
 ```

 :::info
-环境变量 PX4_UXRCE_DDS_NS 若已设置，将覆盖上文所述的命名空间行为。
+环境变量`PX4_UXRCE_DDS_NS` 若已设置，将覆盖上文所述的命名空间行为。
 :::

-第一个实例（px4_instance=0）没有额外的命名空间，此举是为了与真实载具上 xrce-dds 客户端的默认行为保持一致。
-这种不匹配可以通过手动使用 `PX4_UXRCE_DDS_NS` 来修复，或者通过从索引 `1` 中添加车辆而不是 `0` (这是Gazebo Classic的 [sitl_multiple_run.sh](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/simulation/gazebo-classic/sitl_multiple_run.sh) 的默认行为)。
+第一个实例(`px4_instance=0`)没有额外的命名空间，此举是为了与真实载具上 xrce-dds 客户端的默认行为保持一致。
+这种不匹配可以通过手动使用 `PX4_UXRCE_DDS_NS` 来修复，或者通过从索引 `1` 中添加车辆而不是 `0` (这是Gazebo Classic的  [sitl_multiple_run.sh](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/simulation/gazebo-classic/sitl_multiple_run.sh) 的默认行为)。

 模拟中的默认客户端配置概述如下：

-| `PX4_UXRCE_DDS_NS` | `px4_instance` | `UXRCE_DDS_KEY`  | 客户端命名空间               |
+| `PX4_UXRCE_DDS_NS` | `px4_instance` | `UXRCE_DDS_KEY`  | client namespace      |
 | ------------------ | -------------- | ---------------- | --------------------- |
-| 未提供                | 0              | `px4_instance+1` | 无                     |
-| 已提供                | 0              | `px4_instance+1` | `PX4_UXRCE_DDS_NS`    |
-| 未提供                | > 0            | `px4_instance+1` | `px4_${px4_instance}` |
-| 已提供                | > 0            | `px4_instance+1` | `PX4_UXRCE_DDS_NS`    |
+| not provided       | 0              | `px4_instance+1` | 无                     |
+| provided           | 0              | `px4_instance+1` | `PX4_UXRCE_DDS_NS`    |
+| not provided       | > 0            | `px4_instance+1` | `px4_${px4_instance}` |
+| provided           | > 0            | `px4_instance+1` | `PX4_UXRCE_DDS_NS`    |

 ## 调整 `target_system` 值

-PX4 只在他们的 `target_system` 字段为 0 (路由通信) 或与 `MAV_SYS_ID` 一致时，才接受 [VehicleCommand](../msg_docs/VehicleCommand.md)。
+PX4 只在他们的 `target_system` 字段为 0`(路由通信) 或与`MAV_SYS_ID` 一致时，才接受[VehicleCommand](../msg_docs/VehicleCommand.md)。
 在所有其他情况下，信息都被忽视。
-因此，当 ROS 2 节点需向 PX4 发送 VehicleCommand（载具指令）消息时，必须确保消息中填写了合适的 target_system（目标系统）字段值。
+因此，当 ROS 2 节点需向 PX4 发送`VehicleCommand`消息时，必须确保消息中填写了合适的`target_system\`字段值。

-例如，若你想向 px4_instance=2 的第三台飞行器发送指令，则需要在所有 VehicleCommand消息中设置 target_system=3。
+例如，若你想向 `px4_instance=2` 的第三台飞行器发送指令，则需要在所有`VehicleCommand`消息中设置 `target_system=3`。
--- a/docs/zh/ros2/offboard_control.md
+++ b/docs/zh/ros2/offboard_control.md
@@ -1,6 +1,6 @@
 # ROS 2 Offboard 控制示例

-以下的 C++ 示例展示了如何在 [离板模式] (../flight_modes/offboard.md) 中从 ROS 2 节点进行位置控制。
+以下的 C++ 示例展示了如何在 [离板模式] (../flight_modes/offboard.md) 中从 ROS 2 节点进行多轴位置控制。

 示例将首先发送设置点、进入offboard模式、解锁、起飞至5米，并悬停等待。
 虽然简单，但它显示了如何使用offboard控制以及如何向无人机发送指令。
@@ -16,13 +16,13 @@ _Offboard_ control is dangerous.
 ROS 与 PX4 存在若干不同的预设（假设），尤其是在坐标系约定（[frame conventions]）方面../ros/external_position_estimation.md#reference-frames-and-ros
 当主题发布或订阅时，坐标系类型之间没有隐含转换！

-这个例子按照PX4的预期在NED坐标系下发布位置。
+这个例子按照 PX4 的预期在NED坐标系下发布位置。
 若要订阅来自在不同框架内发布的节点的数据(例如ENU, 这是ROS/ROS 2中的标准参考框架，使用 [frame_transforms](https://github.com/PX4/px4_ros_com/blob/main/src/lib/frame_transforms.cpp)库中的辅助函数。
 :::

 ## 小試身手

-请遵循 ROS 2 用户指南 （../ros2/user_guide.md）中的说明，完成安装 PX4和运行模拟器，安装 ROS 2和启动 XRCE-DDS 代理（Agent）。
+按照 [ROS 2 User Guide](../ros2/user_guide.md)中的说明来安装PX 并运行多轴模拟器，安装ROS 2, 并启动XRCE-DDS代理。

 之后，我们可参照 ROS 2 用户指南 > 构建 ROS 2 工作空间 （../ros2/user_guide.md#build-ros-2-workspace）中的相似的步骤来运行这个例子。

@@ -95,7 +95,7 @@ ROS 与 PX4 存在若干不同的预设（假设），尤其是在坐标系约
   ros2 run px4_ros_com offboard_control
   ```

-飞行器将解锁、起飞至5米并悬停等待（永久）。
+飞行器将解锁、起飞至 5 米并悬停等待(永久)。

 ## 实现

@@ -133,7 +133,7 @@ timer_ = this-&gt;create_wall_timer(100ms, timer_callback);
 ```

 循环运行在一个100毫秒计时器。
-在最初的 10 个循环中，它会调用 publish_offboard_control_mode() 和 publish_trajectory_setpoint() 这两个函数，向 PX4 发送 OffboardControlMode（离板控制模式）（../msg_docs/OffboardControlMode.md） 和 TrajectorySetpoint（轨迹设定点）（../msg_docs/TrajectorySetpoint.md） 消息。
+在最初的 10 个循环中，它会调用 `publish_offboard_control_mode()` 和 `publish_trajectory_setpoint()` 这两个函数，向 PX4 发送 OffboardControlMode[OffboardControlMode](../msg_docs/OffboardControlMode.md) 和 [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md) 消息。
 OffboardControlMode消息会持续发送，以便 PX4 切换到离板模式后允许解锁；而 TrajectorySetpoint消息会被忽略（直到载具处于离板模式）

 10 个循环后，会调用 publish_vehicle_command() 函数切换至离板模式，并调用 arm() 函数对载具进行解锁。
--- a/docs/zh/ros2/px4_ros2_control_interface.md
+++ b/docs/zh/ros2/px4_ros2_control_interface.md
@@ -327,7 +327,7 @@ private:
 };
 ```

- `[1]`: 首先创建一个从 [`px4_ros2::ModeExecutorBase`](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1ModeExecutorBase.html) 继承的类。
+- `[1]`: 首先创建一个继承 [`px4_ros2::ModeExecutorBase`](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1ModeExecutorBase.html)。
 - `[2]`: 构造函数采用与执行器相关联的自定义模式，并传递给`ModeExecutorBase`的构造函数。
 - `[3]`: 我们为想要运行的状态定义一个枚举。
 - `[4]`: `onActivate` 在执行器激活时被调用。 此时，我们可以开始遍历这些状态了。
@@ -344,9 +344,10 @@ private:

 以下章节提供了支持的设置点类型列表：

- [MulticopterGotoSetpointType](#go-to-setpoint-multicoptergotosetpointtype): <Badge type="warning" text="MC only" /> Smooth position and (optionally) heading control
- [FwLateralLongitudinalSetpointType](#fixed-wing-lateral-and-longitudinal-setpoint-fwlaterallongitudinalsetpointtype): <Badge type="warning" text="FW only" /> <Badge type="tip" text="main (planned for: PX4 v1.17)" /> Direct control of lateral and longitudinal fixed wing dynamics
+- [MulticopterGotoSetpointType](#go-to-setpoint-multicoptergotosetpointtype): <Badge type="warning" text="MC only" /> 平滑的位置控制以及（可选的）航向控制
+- [FwLateralLongitudinalSetpointType](#fixed-wing-lateral-and-longitudinal-setpoint-fwlaterallongitudinalsetpointtype): <Badge type="warning" text="FW only" /> <Badge type="tip" text="main (planned for: PX4 v1.17)" /> 对横向和纵向固定翼动态的直接控制
 - [DirectActuatorsSetpointType](#direct-actuator-control-setpoint-directactuatorssetpointtype)：直接控制发动机和飞行地面servo setpoints
+- [Rover Setpoints](#rover-setpoints): <Badge type="tip" text="main (planned for: PX4 v1.17)" /> Direct access to rover control setpoints (Position, Speed, Attitude, Rate, Throttle and Steering).

 :::tip
 其他设置点类型目前是实验性的，可在以下网址找到：[px4_ros2/control/setpoint_types/experimental](https://github.com/Auterion/px4-ros2-interface-lib/tree/main/px4_ros2_cpp/include/px4_ros2/control/setpoint_types/experimental)。
@@ -354,18 +355,20 @@ private:
 您可以通过添加一个从 `px4_ros2::SetpointBase` 继承的类来添加您自己的 setpoint 类型， 根据设置点的要求设置配置标志，然后发布任何包含设置点的主题。
 :::

-#### Go-to Setpoint (MulticopterGotoSetpointType)
+#### 转到设置点 (MulticopterGotoSetpointType)

 <Badge type="warning" text="MC only" />

+<Badge type="warning" text="Multicopter only" />
+
 :::info
-This setpoint type is currently only supported for multicopters.
+当前，此设定点类型仅支持多旋翼飞行器。
 :::

-Smoothly control position and (optionally) heading setpoints with the [`px4_ros2::MulticopterGotoSetpointType`](https://github.com/Auterion/px4-ros2-interface-lib/blob/main/px4_ros2_cpp/include/px4_ros2/control/setpoint_types/multicopter/goto.hpp) setpoint type.
-The setpoint type is streamed to FMU based position and heading smoothers formulated with time-optimal, maximum-jerk trajectories, with velocity and acceleration constraints.
+可通过[`px4_ros2::MulticopterGotoSetpointType`](https://github.com/Auterion/px4-ros2-interface-lib/blob/main/px4_ros2_cpp/include/px4_ros2/control/setpoint_types/multicopter/goto.hpp)设定点类型，对位置设定点以及（可选的）航向设定点进行平滑控制。
+设定点类型会被传输至飞控主模块（FMU），该模块基于采用时间最优、最大加加速度轨迹构建的位置及航向平滑器。

-There is also a [`px4_ros2::MulticopterGotoGlobalSetpointType`](https://github.com/Auterion/px4-ros2-interface-lib/blob/main/px4_ros2_cpp/include/px4_ros2/control/setpoint_types/multicopter/goto.hpp) class that allows to send setpoints in global coordinates.
+还有一个 [\`px4_ros2::MulticopterGotoGlobalSetpootType'(https://github.com/Auterion/px4-ros2-interface-lib/blob/main/px4_ros2_cpp/include/px4_ros2/control/setpoint_types/multicopter/goto.hpp)， 该类支持在全局坐标系下发送设定点。

 最简单的用法就是直接向update method中输入一个3D 位置

@@ -551,13 +554,47 @@ _fw_lateral_longitudinal_setpoint->update(setpoint_s, config_s);
 若你想控制的执行器并非用于控制飞行器的运动（例如，而是用于控制有效载荷舵机），请参阅 [below](#controlling-an-independent-actuator-servo)。
 :::

+#### Rover Setpoints
+
+<Badge type="tip" text="main (planned for: PX4 v1.17)" /> <Badge type="warning" text="Experimental" />
+
+The rover modules use a hierarchical structure to propagate setpoints:
+
+![Rover Control Structure](../../assets/middleware/ros2/px4_ros2_interface_lib/rover_control_structure.svg)
+
+:::info
+The "highest" setpoint that is provided will be used within the PX4 rover modules to generate the setpoints that are below it (Overriding them!).
+With this hierarchy there are clear rules for providing a valid control input:
+
+- Provide a position setpoint, **or**
+- One of the setpoints on the "left" (speed **or** throttle) **and** one of the setpoints on the "right" (attitude, rate **or** steering). All combinations of "left" and "right" setpoints are valid.
+
+For ease of use we expose these valid combinations as new SetpointTypes.
+:::
+
+The RoverSetpointTypes exposed through the control interface are combinations of these setpoints that lead to a valid control input:
+
+| SetpointType                                                                                                                        | 安装位置                        | Speed                                            | 油门                                               | Attitude                                         | 频率                                               | Steering                                         | Control Flags                                          |
+| ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------- | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------------ |
+| [RoverPosition](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverPositionSetpointType.html#details)         | &check; | (&check;) | (&check;) | (&check;) | (&check;) | (&check;) | Position, Velocity, Attitude, Rate, Control Allocation |
+| [RoverSpeedAttitude](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverSpeedAttitudeSetpointType.html)       |                             | &check;                      | (&check;) | &check;                      | (&check;) | (&check;) | Velocity, Attitude, Rate, Control Allocation           |
+| [RoverSpeedRate](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverSpeedRateSetpointType.html)               |                             | &check;                      | (&check;) |                                                  | &check;                      | (&check;) | Velocity, Rate, Control Allocation                     |
+| [RoverSpeedSteering](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverSpeedSteeringSetpointType.html)       |                             | &check;                      | (&check;) |                                                  |                                                  | &check;                      | Velocity, Control Allocation                           |
+| [RoverThrottleAttitude](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverThrottleAttitudeSetpointType.html) |                             |                                                  | &check;                      | &check;                      | (&check;) | (&check;) | Attitude, Rate, Control Allocation                     |
+| [RoverThrottleRate](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverThrottleRateSetpointType.html)         |                             |                                                  | &check;                      |                                                  | &check;                      | (&check;) | Rate, Control Allocation                               |
+| [RoverThrottleSteering](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1RoverThrottleSteeringSetpointType.html) |                             |                                                  | &check;                      |                                                  |                                                  | &check;                      | Control Allocation                                     |
+
+&check; are the setpoints we publish, and (&check;) are generated internally by the PX4 rover modules according to the hierarchy above.
+
+An example for a rover specific drive mode using the `RoverSpeedAttitudeSetpointType` is provided [here](https://github.com/Auterion/px4-ros2-interface-lib/tree/main/examples/cpp/modes/rover_velocity).
+
 ### 控制VTOL

 <Badge type="tip" text="main (planned for: PX4 v1.17)" /> <Badge type="warning" text="Experimental" />

 要在外部飞行模式下控制VTOL，需确保根据当前飞行配置返回正确的设定值类型：

- 多旋翼模式：使用与多旋翼控制兼容的设定值类型。 For example: either the [`MulticopterGotoSetpointType`](#go-to-setpoint-multicoptergotosetpointtype) or the [`TrajectorySetpointType`](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1TrajectorySetpointType.html).
+- 多旋翼模式：使用与多旋翼控制兼容的设定值类型。 例如：要么[`MulticopterGotoSetpootType`](#go-to-setpoint-multicoptergotosetpointtype) 要么[`TrattorySettpointType`](https://auterion.github.io/px4-ros2-interface-lib/classpx4__ros2_1_1TrajectorySetpointType.html)。
 - 固定翼形模式：使用 [`FwLateralLongitudinalSetpointType` ](#fixed-wing-lateral-and-longitudinal-setpoint-fwlaterallongitudinalsetpointtype)。

 只要VTOL在整个外部模式期间始终处于多旋翼模式或固定翼模式中的任意一种，就无需额外处理。
--- a/docs/zh/ros2/px4_ros2_interface_lib.md
+++ b/docs/zh/ros2/px4_ros2_interface_lib.md
@@ -14,10 +14,7 @@ Experimental
 1. [Control Interface](./px4_ros2_control_interface.md) 允许开发者创建并动态注册使用 ROS2 编写的模式。
   它为发送不同类型的设置点提供了课程，涵盖范围从高级导航任务一直到直接执行器控制。
 2. [导航界面](./px4_ros2_navigation_interface.md) 允许从ROS 2应用程序（如VIO系统）向PX4发送车辆位置估计数。
-
-<!--
-## Overview
-->
+3. [Waypoint Missions](./px4_ros2_waypoint_missions.md) 允许航点飞行任务完全在ROS2中运行。

 ## 在 ROS 2 工作区中安装

--- a/docs/zh/ros2/px4_ros2_msg_translation_node.md
+++ b/docs/zh/ros2/px4_ros2_msg_translation_node.md
@@ -1,6 +1,6 @@
 # PX4 ROS 2 消息翻译节点

-<0/> <1/>
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="warning" text="Experimental" />

 消息翻译节点允许针对不同版本的 PX4 消息编译的 ROS 2 应用程序与更新版本的 PX4 交互。 反之亦然，而不必更改应用程序或PX4一侧。

--- a/docs/zh/ros2/px4_ros2_waypoint_missions.md
+++ b/docs/zh/ros2/px4_ros2_waypoint_missions.md
@@ -0,0 +1,190 @@
+# PX4 ROS 2 Waypoint Missions
+
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="tip" text="Multicopter (only)" /> <Badge type="warning" text="Experimental" />
+
+The [PX4 ROS 2 Interface Library](../ros2/px4_ros2_interface_lib.md) provides a high-level interface for executing ROS-based waypoint missions in ROS 2.
+The main use-case is for creating missions where a custom behavior is required, such as a pickup action within a mission.
+
+:::warning
+ROS 2 missions are not compatible with MAVLink mission definitions, plan files, or ground stations.
+They completely bypass the existing PX4 mission mode and waypoint logic, and cannot be planned or displayed within a ground station.
+:::
+
+ROS 2 waypoint missions are effectively special PX4 ROS 2 custom modes that are run based on the content of a [JSON mission definition](#mission-definition).
+Mission definitions can contain actions that reference existing PX4 modes, such as Takeoff mode or RTL, and can also be extended with arbitrary custom actions written in ROS.
+A [mode executor](px4_ros2_control_interface.md#mode-executor) is used to schedule the modes.
+
+Mission definitions can be hard coded in the custom mission mode (either in code or statically loaded from a JSON string), or directly generated within the application.
+They can also be dynamically loaded based on modification of a particular JSON file — this allows for building a more generic mission framework with a fixed set of custom actions.
+The file can then be written by any other application, for example a HTTP or MAVFTP server.
+
+The current implementation only supports multicopters but is designed to be extendable to any other vehicle type.
+
+## Comparison to PX4/MAVLink Missions
+
+There are some benefits and drawbacks to using ROS-based missions, which are provided in the following paragraphs.
+
+### Benefits
+
+- Allows to extend mission capabilities by registering custom actions.
+- More control over how the mission is executed.
+  A custom trajectory executor can be implemented, which can use any of the existing PX4 setpoint types to track the trajectory.
+- Reduced complexity on the flight controller side by running non-safety-critical and non-real-time code on a more high-level companion computer.
+- It can be extended to support other trajectory types, like Bezier or Dubin curves.
+
+### Drawbacks
+
+- QGroundControl currently does not display the mission or progress during execution, and cannot upload or download a mission.
+  Therefore you will need another mechanism to provide a mission, such as from a web server, a custom GCS, or by generating it directly inside the application.
+- The current implementation only supports multicopters (it uses the [GotoSetpointType](../ros2/px4_ros2_control_interface.md#go-to-setpoint-gotosetpointtype), which only works for multicopters, and VTOL in MC mode).
+  It is designed to be extendable to any other vehicle type.
+
+## 综述
+
+This diagram provides a conceptual overview of the main classes and their interactions:
+
+![Waypoint missions overview diagram](../../assets/middleware/ros2/px4_ros2_interface_lib/waypoint_missions.svg)
+
+<!-- Source: https://drive.google.com/file/d/1BXx4fegVE71eq0kDMMuRnhcLnJeDawWe/view?usp=sharing -->
+
+Missions can be defined in [JSON](#mission-definition), either as a file, or directly inside the application.
+There is a file change monitor (`MissionFileMonitor`), that can be used to automatically load a mission from a specific file whenever it is created by another application (e.g. upload via MAVFTP or a cloud service).
+
+The **`MissionExecutor`** class contains the state machine to progress the mission index, and is at the core of the implementation:
+
+- Internally, it builds on top of the [Modes and Mode Executors](px4_ros2_control_interface.md#overview) and registers itself through a custom mode and executor with PX4.
+- It handles switching in and out of missions: it gets activated when the user switches to the custom mode that represents the mission and the vehicle is armed.
+  The mode name can be customized (`My Mission` in the example below).
+  The mission can be paused, which makes the vehicle switch into _Hold mode_.
+  To resume the mission, the custom mode has to be selected again.
+- When an action switches into another mode (for example Takeoff), QGroundControl will display this mode until it is completed.
+  The mission executor will then automatically continue.
+- Custom actions can be registered.
+- The mission can be set.
+  It then checks that all the actions which the mission defines are available and can be run.
+- The state can be stored persistently by providing a file name, allowing for battery swapping.
+
+The **`ActionInterface`** is an interface class for custom actions.
+They are identified by a name, and any number of these can be registered with the `MissionExecutor`.
+A custom action is then run whenever a mission item with matching name is executed, and any extra arguments from the JSON definition are passed as arguments (for example an altitude for a takeoff action).
+Actions can call other actions, run any mode (PX4 or external by its ID), run a trajectory, or run any other external action before deciding when to continue the mission.
+
+There is a set of default actions, for example for RTL, Land, etc.
+These simply trigger the corresponding PX4 mode.
+They can be disabled or replaced with custom implementations.
+There are also some special actions (which can be replaced as well):
+
+- `OnFailure`: this is called in case of a failure, e.g. a mode switch failed, a non-existing action is called (by another action) or by an explicit call to `MissionExecutor::abort()`.
+  The default is to run RTL, with fallback to Land.
+- `OnResume`: this is called when resuming a mission (either from the ground or in-air).
+  It handles a number of cases:
+  - when called with an argument `action="storeState"`: this can be used to store the current position when the mission is deactivated, so it can be resumed from the same position.
+    Currently it does not store anything.
+  - otherwise, when called without a valid mission index or 0, it directly continues.
+  - otherwise, when called while in-air, it also directly continues.
+  - otherwise, if landed and if the current mission item is an action that supports resuming from landed, it continues to let the action handle the resuming.
+  - otherwise, if landed, it finds the takeoff action from the mission, runs it, and then flies to the previous waypoint from the current index to continue the mission.
+- `ChangeSettings`: this can be used to change the mission settings, such as the velocity.
+  The settings are applied to all following items in the mission.
+
+The **`TrajectoryExecutorInterface`** is an interface class to execute segments of a trajectory.
+It can use any setpoint that PX4 and the current vehicle supports for tracking the trajectory.
+This class is vehicle-type specific.
+The current default implementation (`multicopter::WaypointTrajectoryExecutor`) uses a Goto setpoint (and thus is limited to multicopters).
+The default can be replaced with a custom implementation.
+
+## 用法
+
+The following provides a small example.
+It defines a custom action and a mission that uses it.
+
+```c++
+class CustomAction : public px4_ros2::ActionInterface {
+public:
+  CustomAction(px4_ros2::ModeBase & mode) : _node(mode.node()) { }
+
+  std::string name() const override {return "customAction";}
+
+  void run(
+    const std::shared_ptr<px4_ros2::ActionHandler> & handler,
+    const px4_ros2::ActionArguments & arguments,
+    const std::function<void()> & on_completed) override
+  {
+    RCLCPP_INFO(_node.get_logger(), "Running custom action");
+    // Do something...
+
+    on_completed();
+  }
+private:
+  rclcpp::Node & _node;
+};
+
+class MyMission {
+public:
+  MyMission(const std::shared_ptr<rclcpp::Node> & node) : _node(node)
+  {
+    const auto mission =  px4_ros2::Mission(nlohmann::json::parse(R"(
+  {
+    "version": 1,
+    "mission": {
+        "items": [
+           {
+               "type": "takeoff"
+           },
+           {
+               "type": "navigation",
+               "navigationType": "waypoint",
+               "x": 47.3977419,
+               "y": 8.5455939,
+               "z": 500,
+               "frame": "global"
+           },
+           {
+               "type": "navigation",
+               "navigationType": "waypoint",
+               "x": 47.39791657,
+               "y": 8.54595214,
+               "z": 500,
+               "frame": "global"
+           },
+           {
+               "type": "customAction"
+           },
+           {
+               "type": "rtl"
+           }
+        ]
+    }
+  }
+)"));
+    _mission_executor = std::make_unique<px4_ros2::MissionExecutor>("My Mission",
+      px4_ros2::MissionExecutor::Configuration().addCustomAction<CustomAction>(), *node);
+
+    if (!_mission_executor->doRegister()) {
+      throw std::runtime_error("Failed to register mission executor");
+    }
+    _mission_executor->setMission(mission);
+
+    _mission_executor->onProgressUpdate([&](int current_index) {
+        RCLCPP_INFO(_node->get_logger(), "Current mission index: %i", current_index);
+      });
+    _mission_executor->onCompleted([&] {
+        RCLCPP_INFO(_node->get_logger(), "Mission completed callback");
+      });
+  }
+
+private:
+  std::shared_ptr<rclcpp::Node> _node;
+  std::unique_ptr<px4_ros2::MissionExecutor> _mission_executor;
+};
+```
+
+A full example with a few custom actions can be found under [github.com/Auterion/px4-ros2-interface-lib/tree/main/examples/cpp/modes/mission/include](https://github.com/Auterion/px4-ros2-interface-lib/tree/main/examples/cpp/modes/mission/include).
+
+## Mission Definition
+
+The mission JSON file can contain mission defaults and a list of mission items, including user-defined types with custom arguments.
+Waypoint coordinates currently need to be defined in global frame, and other frame types might be added in future.
+
+The schema can be found under [github.com/Auterion/px4-ros2-interface-lib/blob/main/mission/schema.yaml](https://github.com/Auterion/px4-ros2-interface-lib/blob/main/mission/schema.yaml).
+It provides more details and can be used to validate a JSON file.
--- a/docs/zh/ros2/user_guide.md
+++ b/docs/zh/ros2/user_guide.md
@@ -376,7 +376,7 @@ accelerometer_integral_dt: 4739

 #### (可选) 启动转化节点

-<0/> <1/>
+<Badge type="tip" text="PX4 v1.16" /> <Badge type="warning" text="Experimental" />

 此示例由 PX4 和ROS 2 版本构建，它们使用相同的消息定义。
 若你要使用不兼容的 [message versions](../middleware/uorb.md#message-versioning)，则在运行示例之前，还需要安装并运行[Message Translation Node](./px4_ros2_msg_translation_node.md)：
@@ -448,60 +448,60 @@ See [REP105: Coordinate Frames for Mobile Platforms](https://www.ros.org/reps/re

 ![Reference frames](../../assets/lpe/ref_frames.png)

-The FRD (NED) conventions are adopted on **all** PX4 topics unless explicitly specified in the associated message definition.
-Therefore, ROS 2 nodes that want to interface with PX4 must take care of the frames conventions.
+除非在相关消息定义中明确指定，否则所有PX4 话题均采用 FRD（即 NED）坐标系约定。
+因此，想要与 PX4 进行交互的 ROS 2 节点，必须妥善处理坐标系约定问题。

- To rotate a vector from ENU to NED two basic rotations must be performed:
-  - first a pi/2 rotation around the `Z`-axis (up),
-  - then a pi rotation around the `X`-axis (old East/new North).
+- 要将一个向量从ENU坐标系旋转到NED坐标系，必须执行两个基本旋转操作：
+  - 首先是绕 Z 轴（朝上方向）旋转 π/2 弧度。
+  - 然后是绕 X 轴（原东向 / 新北向）旋转 π 弧度

- To rotate a vector from NED to ENU two basic rotations must be performed:
+- 要将一个向量从NED坐标系旋转到ENU坐标系，必须执行两个基本旋转操作：

- - first a pi/2 rotation around the `Z`-axis (down),
-  - then a pi rotation around the `X`-axis (old North/new East). Note that the two resulting operations are mathematically equivalent.
+- - 首先是绕 Z 轴（朝下方向）旋转 π/2 弧度。
+  - 然后是绕 X 轴（原北向 / 新东向）旋转 π 弧度。 需注意，这两种最终得到的操作在数学上是等效的

- To rotate a vector from FLU to FRD a pi rotation around the `X`-axis (front) is sufficient.
+- 将向量从 FLU坐标系旋转到 FRD坐标系，仅需绕 X 轴（朝前方向）旋转 π 弧度即可。

- To rotate a vector from FRD to FLU a pi rotation around the `X`-axis (front) is sufficient.
+- 将向量从 FRD坐标系旋转到 FLU坐标系，仅需绕 X 轴（朝前方向）旋转 π 弧度即可。

-Examples of vectors that require rotation are:
+需要进行旋转处理的向量示例包括：

- all fields in [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md) message; ENU to NED conversion is required before sending them.
- all fields in [VehicleThrustSetpoint](../msg_docs/VehicleThrustSetpoint.md) message; FLU to FRD conversion is required before sending them.
+- [TrajectorySetpoint](../msg_docs/TrajectorySetpoint.md)消息中的所有字段；发送这些字段前，需先将其从 ENU坐标系转换为 NED坐标系。
+- [VehicleThrustSetpoint](../msg_docs/VehicleThrustSetpoint.md)消息中的所有字段；发送这些字段前，需先将其从 FLU坐标系转换为 FRD坐标系。

-Similarly to vectors, also quaternions representing the attitude of the vehicle (body frame) w.r.t. the world frame require conversion.
+与向量类似，用于表示飞行器（机体坐标系）相对于（w.r.t.）姿态的四元数也是如此。 （相对于）世界坐标系（的四元数）需要进行转换。

-[PX4/px4_ros_com](https://github.com/PX4/px4_ros_com) provides the shared library [frame_transforms](https://github.com/PX4/px4_ros_com/blob/main/include/px4_ros_com/frame_transforms.h) to easily perform such conversions.
+[PX4/px4_ros_com](https://github.com/PX4/px4_ros_com) 提供了名为  [frame_transforms](https://github.com/PX4/px4_ros_com/blob/main/include/px4_ros_com/frame_transforms.h)的共享库，可便捷地执行此类转换操作。

-### ROS, Gazebo and PX4 time synchronization
+### ROS, Gazebo 和 PX4 时间同步

-By default, time synchronization between ROS 2 and PX4 is automatically managed by the [uXRCE-DDS middleware](https://micro-xrce-dds.docs.eprosima.com/en/latest/time_sync.html) and time synchronization statistics are available listening to the bridged topic `/fmu/out/timesync_status`.
-When the uXRCE-DDS client runs on a flight controller and the agent runs on a companion computer this is the desired behavior as time offsets, time drift, and communication latency, are computed and automatically compensated.
+默认情况下，ROS 2 与 PX4 之间的时间同步由[uXRCE-DDS middleware](https://micro-xrce-dds.docs.eprosima.com/en/latest/time_sync.html) 自动管理；若需查看时间同步统计信息，可监听已桥接的话题 /fmu/out/timesync_status。
+当 uXRCE-DDS 客户端运行在飞控器上，且代理运行在机载计算机上时，这便是理想的运行状态 —— 此时时间偏移、时间漂移以及通信延迟会被自动计算并补偿。

-For Gazebo simulations the GZBridge sets the PX4 time on every sim step (see [Change simulation speed](../sim_gazebo_gz/index.md#change-simulation-speed)).
-Note that this is different from the [simulation lockstep](../sim_gazebo_classic/index.md#lockstep) procedure adopted with Gazebo Classic.
+在 Gazebo 仿真中，GZBridge 会在每个仿真步长（sim step）为 PX4 设置时间[Change simulation speed](../sim_gazebo_gz/index.md#change-simulation-speed)。
+需注意，这与 Gazebo Classic所采用的仿真锁步[simulation lockstep](../sim_gazebo_classic/index.md#lockstep)流程不同。

-ROS2 users have then two possibilities regarding the [time source](https://design.ros2.org/articles/clock_and_time.html) of their nodes.
+对于 ROS 2 用户而言，其节点的[time source](https://design.ros2.org/articles/clock_and_time.html)有两种选择。

-#### ROS2 nodes use the OS clock as time source
+#### ROS2 节点使用操作系统时钟作为时间源

-This scenario, which is the one considered in this page and in the [offboard_control](./offboard_control.md) guide, is also the standard behaviour of the ROS2 nodes.
-The OS clock acts as time source and therefore it can be used only when the simulation real time factor is very close to one.
-The time synchronizer of the uXRCE-DDS client then bridges the OS clock on the ROS2 side with the Gazebo clock on the PX4 side.
-No further action is required by the user.
+本文档以及[offboard_control](./offboard_control.md)指南中所采用的便是此场景，同时，该场景也是 ROS 2 节点的标准行为
+操作系统时钟作为时间来源，因此它只能在模拟实时系数非常接近时才能使用。
+uXRCE-DDS 客户端的时间同步器随后会将 ROS 2 端的操作系统时钟（OS clock）与 PX4 端的 Gazebo 时钟进行桥接同步。
+用户不需要进一步操作。

-#### ROS2 nodes use the Gazebo clock as time source
+#### ROS2 节点使用 Gazebo 时钟作为时间源

-In this scenario, ROS2 also uses the Gazebo `/clock` topic as time source.
-This approach makes sense if the Gazebo simulation is running with real time factor different from one, or if ROS2 needs to directly interact with Gazebo.
-On the ROS2 side, direct interaction with Gazebo is achieved by the [ros_gz_bridge](https://github.com/gazebosim/ros_gz) package of the [ros_gz](https://github.com/gazebosim/ros_gz) repository.
+在这种情况下，ROS2还使用Gazebo\`/时钟主题作为时间来源。
+若 Gazebo 仿真的实时因子（real time factor）不为 1，或 ROS 2 需直接与 Gazebo 交互，则该方法具有合理性。
+在 ROS 2 端，可通过[ros_gz](https://github.com/gazebosim/ros_gz)代码仓库中的[ros_gz_bridge](https://github.com/gazebosim/ros_gz) 功能包，实现与 Gazebo 的直接交互。

-Use the following commands to install the correct ROS 2/gz interface packages (not just the bridge) for the ROS2 and Gazebo version(s) supported by PX4.
+请使用以下命令，为 PX4 所支持的 ROS 2 和 Gazebo 版本安装正确的 ROS 2/gz 接口功能包（不仅限于桥接功能包）。

 :::: tabs

 :::tab humble
-To install the bridge for use with ROS 2 "Humble" and Gazebo Harmonic (on Ubuntu 22.04):
+在 Ubuntu 22.04 系统上，若需安装用于搭配 ROS 2 “Humble”与 Gazebo Harmonic的桥接功能包，可执行以下操作：

 ```sh
 sudo apt install ros-humble-ros-gzharmonic
@@ -510,9 +510,9 @@ sudo apt install ros-humble-ros-gzharmonic
 :::

 :::tab foxy
-First you will need to [install Gazebo Garden](../sim_gazebo_gz/index.md#installation-ubuntu-linux), as by default Foxy comes with Gazebo Classic 11. <!-- note, garden is EOL Nov 2024 -->
+首先，您需要 [install Gazebo Garden](../sim_gazebo_gz/index.md#installation-ubuntu-linux)，因为默认情况下，Foxy预装的是 Gazebo Classic 11 <!-- note, garden is EOL Nov 2024 -->

-Then to install the interface packages for use with ROS 2 "Foxy" and Gazebo (Ubuntu 20.04):
+接下来，若要在 Ubuntu 20.04 系统上安装用于搭配 ROS 2 "Foxy"与 Gazebo的接口功能包，操作如下：

 ```sh
 sudo apt install ros-foxy-ros-gzgarden
@@ -523,40 +523,40 @@ sudo apt install ros-foxy-ros-gzgarden
 ::::

 :::info
-The [repo](https://github.com/gazebosim/ros_gz#readme) and [package](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_bridge#readme) READMEs show the package versions that need to be installed depending on your ROS2 and Gazebo versions.
+[repo](https://github.com/gazebosim/ros_gz#readme) 和 [package](https://github.com/gazebosim/ros_gz/tree/ros2/ros_gz_bridge#readme) README显示了需要安装的软件包版本，取决于您的 ROS2 和 Gazebo 版本。
 :::

-Once the packages are installed and sourced, the node `parameter_bridge` provides the bridging capabilities and can be used to create an unidirectional `/clock` bridge:
+功能包安装并完成环境配置后，parameter_bridge节点会提供桥接能力，可用于创建一个单向的/clock桥接。

 ```sh
 ros2 run ros_gz_bridge parameter_bridge /clock@rosgraph_msgs/msg/Clock[gz.msgs.Clock
 ```

-At this point, every ROS2 node must be instructed to use the newly bridged `/clock` topic as time source instead of the OS one, this is done by setting the parameter `use_sim_time` (of _each_ node) to `true` (see [ROS clock and Time design](https://design.ros2.org/articles/clock_and_time.html)).
+此时，必须指示每个 ROS 2 节点使用新桥接的/clock话题作为时间源，而非操作系统时钟（OS clock）；要实现这一点，需将（每个节点的）use_sim_time参数设置为true（详见[ROS clock and Time design](https://design.ros2.org/articles/clock_and_time.html)）。

-This concludes the modifications required on the ROS2 side. On the PX4 side, you are only required to stop the uXRCE-DDS time synchronization, setting the parameter [UXRCE_DDS_SYNCT](../advanced_config/parameter_reference.md#UXRCE_DDS_SYNCT) to `false`.
-By doing so, Gazebo will act as main and only time source for both ROS2 and PX4.
+至此，ROS 2 端所需的修改已全部完成。 在 PX4 端，你只需停止 uXRCE-DDS 时间同步功能，将参数[UXRCE_DDS_SYNCT](../advanced_config/parameter_reference.md#UXRCE_DDS_SYNCT)设置为false即可。
+通过此操作，Gazebo 将成为 ROS 2 和 PX4 两者共同的、唯一的主时间源。

-## ROS 2 Example Applications
+## ROS 2 示例应用程序

 ### ROS 2 Listener

-The ROS 2 [listener examples](https://github.com/PX4/px4_ros_com/tree/main/src/examples/listeners) in the [px4_ros_com](https://github.com/PX4/px4_ros_com) repo demonstrate how to write ROS nodes to listen to topics published by PX4.
+[px4_ros_com](https://github.com/PX4/px4_ros_com中的 ROS 2  [listener examples](https://github.com/PX4/px4_ros_com/tree/main/src/examples/listeners)  repo展示了如何编写 ROS 节点，以监听由 PX4 发布的话题

-Here we consider the [sensor_combined_listener.cpp](https://github.com/PX4/px4_ros_com/blob/main/src/examples/listeners/sensor_combined_listener.cpp) node under `px4_ros_com/src/examples/listeners`, which subscribes to the [SensorCombined](../msg_docs/SensorCombined.md) message.
+此处我们以 px4_ros_com/src/examples/listeners 路径下的 [sensor_combined_listener.cpp](https://github.com/PX4/px4_ros_com/blob/main/src/examples/listeners/sensor_combined_listener.cpp) 节点为例，该节点会订阅 [SensorCombined](../msg_docs/SensorCombined.md) 消息。

 :::info
-[Build ROS 2 Workspace](#build-ros-2-workspace) shows how to build and run this example.
+[Build ROS 2 Workspace](#build-ros-2-workspace) 显示如何构建和运行这个例子。
 :::

-The code first imports the C++ libraries needed to interface with the ROS 2 middleware and the header file for the `SensorCombined` message to which the node subscribes:
+代码首先导入了与 ROS 2 中间件进行交互所需的 C++ 库，以及该节点所订阅的SensorCombined消息对应的头部文件：

 ```cpp
-#include <rclcpp/rclcpp.hpp>
-#include <px4_msgs/msg/sensor_combined.hpp>
+#include <0>
+#include <1>
 ```

-Then it creates a `SensorCombinedListener` class that subclasses the generic `rclcpp::Node` base class.
+随后，代码创建了一个 SensorCombinedListener 类，该类继承自通用的 rclcpp::Node 基类。

 ```cpp
 /**
@@ -566,7 +566,7 @@ class SensorCombinedListener : public rclcpp::Node
 {
 ```

-This creates a callback function for when the `SensorCombined` uORB messages are received (now as micro XRCE-DDS messages), and outputs the content of the message fields each time the message is received.
+这会创建一个回调函数，用于处理SensorCombined uORB 消息（当前以微型 XRCE-DDS 消息格式传输）的接收事件；每当接收到该消息时，该函数会输出消息字段的内容

 ```cpp
 public:
@@ -595,12 +595,12 @@ public:
 ```

 :::info
-The subscription sets a QoS profile based on `rmw_qos_profile_sensor_data`.
-This is needed because the default ROS 2 QoS profile for subscribers is incompatible with the PX4 profile for publishers.
-For more information see: [ROS 2 Subscriber QoS Settings](#ros-2-subscriber-qos-settings),
+该订阅会基于 rmw_qos_profile_sensor_data 设置一个 QoS 配置文件。
+之所以需要这样做，是因为 ROS 2 订阅者的默认 QoS（服务质量）配置文件，与 PX4 发布者的配置文件不兼容。
+欲了解更多信息，请参阅：[ROS 2 Subscriber QoS Settings](#ros-2-subscriber-qos-settings),
 :::

-The lines below create a publisher to the `SensorCombined` uORB topic, which can be matched with one or more compatible ROS 2 subscribers to the `fmu/sensor_combined/out` ROS 2 topic.
+以下代码行创建了一个发布者，用于向 SensorCombined uORB 话题发布数据；该发布者可与一个或多个兼容的 ROS 2 订阅者匹配，这些订阅者监听的是 fmu/sensor_combined/out ROS 2 话题。

 ````cpp
 private:
@@ -623,14 +623,14 @@ int main(int argc, char *argv[])
 }
 ````

-This particular example has an associated launch file at [launch/sensor_combined_listener.launch.py](https://github.com/PX4/px4_ros_com/blob/main/launch/sensor_combined_listener.launch.py).
-This allows it to be launched using the [`ros2 launch`](#ros2-launch) command.
+此特殊示例在[launch/sensor_combined_listener.launch.py](https://github.com/PX4/px4_ros_com/blob/main/launch/sensor_combined_listener.launch.py).有一个相关的启动文件。
+这使得它可以通过 [`ros2 launch`](#ros2-launch)  命令启动

-### ROS 2 Advertiser
+### ROS 2 发布者

-A ROS 2 advertiser node publishes data into the DDS/RTPS network (and hence to the PX4 Autopilot).
+一个 ROS 2 发布者节点会将数据发布到 DDS/RTPS 网络中（进而传递给 PX4 自动驾驶仪）。

-Taking as an example the `debug_vect_advertiser.cpp` under `px4_ros_com/src/advertisers`, first we import required headers, including the `debug_vect` msg header.
+以 px4_ros_com/src/advertisers 路径下的 debug_vect_advertiser.cpp（文件）为例，首先我们会导入所需的headers，其中包括 `debug_vect` msg header。

 ```cpp
 #include <chrono>
@@ -640,15 +640,15 @@ Taking as an example the `debug_vect_advertiser.cpp` under `px4_ros_com/src/adve
 using namespace std::chrono_literals;
 ```

-Then the code creates a `DebugVectAdvertiser` class that subclasses the generic `rclcpp::Node` base class.
+随后，代码创建了一个 DebugVectAdvertiser 类，该类继承自通用的 rclcpp::Node 基类。

 ```cpp
 class DebugVectAdvertiser : public rclcpp::Node
 {
 ```

-The code below creates a function for when messages are to be sent.
-The messages are sent based on a timed callback, which sends two messages per second based on a timer.
+这段代码创建了一个用来发送消息的回调函数。
+发送消息的回调函数由定时器触发的，每秒钟发送两次消息。

 ```cpp
 public:
@@ -676,7 +676,7 @@ private:
 };
 ```

-The instantiation of the `DebugVectAdvertiser` class as a ROS node is done on the `main` function.
+这段代码在 main 函数中将 DebugVectAdvertiser 类实例化成一个ROS节点。

 ```cpp
 int main(int argc, char *argv[])
@@ -693,31 +693,31 @@ int main(int argc, char *argv[])

 ### Offboard控制

-[ROS 2 Offboard control example](../ros2/offboard_control.md) provides a complete C++ reference example of how to use [offboard control](../flight_modes/offboard.md) of PX4 with ROS2.
+[ROS 2 Offboard control example](../ros2/offboard_control.md)提供了一个完整的 C++ 参考示例，说明如何使用 PX4 的  [offboard control](../flight_modes/offboard.md) 与 ROS 2。

-[Python ROS2 offboard examples with PX4](https://github.com/Jaeyoung-Lim/px4-offboard) (Jaeyoung-Lim/px4-offboard) provides a similar example for Python, and includes the scripts:
+[Python ROS2 offboard examples with PX4](https://github.com/Jaeyoung-Lim/px4-offboard) (Jaeyoung-Lim/px4-offboard) 为Python 提供了一个类似的示例，并包含脚本：

- `offboard_control.py`: Example of offboard position control using position setpoints
- `visualizer.py`: Used for visualizing vehicle states in Rviz
+- `offboard_control.py`: 使用位置设定值进行离板位置控制的示例
+- “visualizer.py\`：用于可视化载体状态的 Rviz

-## Using Flight Controller Hardware
+## 使用飞行控制器硬件

-ROS 2 with PX4 running on a flight controller is almost the same as working with PX4 on the simulator.
-The only difference is that you need to start both the agent _and the client_, with settings appropriate for the communication channel.
+在飞行控制器上运行的 PX4 号ROS2与在模拟器上运行的 PX4 几乎相同。
+唯一的区别是您需要同时启动agent  _and the client_，并设置适合通信频道。

-For more information see [Starting uXRCE-DDS](../middleware/uxrce_dds.md#starting-agent-and-client).
+更多信息详见[Starting uXRCE-DDS](../middleware/uxrce_dds.md#starting-agent-and-client)

-## Custom uORB Topics
+## 自定义 uORB 主题

-ROS 2 needs to have the _same_ message definitions that were used to create the uXRCE-DDS client module in the PX4 Firmware in order to interpret the messages.
-The definition are stored in the ROS 2 interface package [PX4/px4_msgs](https://github.com/PX4/px4_msgs) and they are automatically synchronized by CI on the `main` and release branches.
-Note that all the messages from PX4 source code are present in the repository, but only those listed in `dds_topics.yaml` will be available as ROS 2 topics.
-Therefore,
+ROS 2需要有用于在 PX4 固件中创建 uXRCE-DDS客户端模块的 _sam_message 定义，以便解释消息。
+这些定义存储在 ROS 2 接口包[PX4/px4_msgs](https://github.com/PX4/px4_msgs)中，并且会通过CI在 main（主）分支和发布分支上自动同步。
+需要注意的是，PX4 源代码中的所有消息均存在于该代码仓库中，但只有在dds_topics.yaml文件中列出的消息，才会作为 ROS 2 话题可用。
+因此

- If you're using a main or release version of PX4 you can get the message definitions by cloning the interface package [PX4/px4_msgs](https://github.com/PX4/px4_msgs) into your workspace.
- If you're creating or modifying uORB messages you must manually update the messages in your workspace from your PX4 source tree.
-  Generally this means that you would update [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml), clone the interface package, and then manually synchronize it by copying the new/modified message definitions from [PX4-Autopilot/msg](https://github.com/PX4/PX4-Autopilot/tree/main/msg) to its `msg` folders.
-  Assuming that PX4-Autopilot is in your home directory `~`, while `px4_msgs` is in `~/ros2_ws/src/`, then the command might be:
+- 如果您正在使用 PX4 的主要版本或发布版本，您可以通过克隆接口包[PX4/px4_msgs](https://github.com/PX4/px4_msgs)获得消息定义。
+- 如果您要创建或修改 uORB 消息，必须从 PX4 源代码树中手动更新工作空间中的消息。
+  一般来说，这意味着您将更新 [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml)，克隆接口包。 然后手动同步，将新的/修改的消息定义从 [PX4-Autopilot/msg](https://github.com/PX4/PX4-Autopilot/tree/main/msg)复制到它的 `msg` 文件夹。
+  假定PX4-Autopilot在你的主目录`~`中，而`px4_msgs`则在`~/ros2_ws/src/`中，命令可能是：

  ```sh
  rm ~/ros2_ws/src/px4_msgs/msg/*.msg
@@ -725,22 +725,22 @@ Therefore,
  ```

  ::: info
-  Technically, [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml) completely defines the relationship between PX4 uORB topics and ROS 2 messages.
-  For more information see [uXRCE-DDS > DDS Topics YAML](../middleware/uxrce_dds.md#dds-topics-yaml).
+  从技术角度而言，[dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml) 这个文件完整定义了 PX4 uORB 话题与 ROS 2 消息之间的对应关系。
+  欲了解更多信息，请参阅[uXRCE-DDS > DDS Topics YAML](../middleware/uxrce_dds.md#dds-topics-yaml)。

 :::

 ## Customizing the Namespace

-Custom topic and service namespaces can be applied at build time (changing [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml)) or at runtime (useful for multi vehicle operations):
+自定义主题和服务命名空间可以在构建时间(更改 [dds_topics.yaml](https://github.com/PX4/PX4-Autopilot/blob/main/src/modules/uxrce_dds_client/dds_topics.yaml))或运行时间(对多载体操作有用)：

- One possibility is to use the `-n` option when starting the [uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client) from command line.
-  This technique can be used both in simulation and real vehicles.
- A custom namespace can be provided for simulations (only) by setting the environment variable `PX4_UXRCE_DDS_NS` before starting the simulation.
+- 一种可能性是在从命令行启动[uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client)时使用 "-n" 选项。
+  这种技术既可用于模拟，也可用于实际机体。
+- 在开始模拟前，可以通过设置环境变量 `PX4_UXRCE_DDS_NS`来提供自定义命名空间 (仅限)

 :::info
-Changing the namespace at runtime will append the desired namespace as a prefix to all `topic` fields in [dds_topics.yaml](../middleware/dds_topics.md) and all [service servers](#px4-ros-2-service-servers).
-Therefore, commands like:
+更改运行时的命名空间将会将所需的命名空间作为一个前缀附加到 [dds_topics.yaml](../middleware/dds_topics.md) 中所有的 "topic " 字段和所有 [service servers](#px4-ros-2-service-servers)。
+因此，命令如下：

 ```sh
 uxrce_dds_client start -n uav_1
@@ -752,7 +752,7 @@ uxrce_dds_client start -n uav_1
 PX4_UXRCE_DDS_NS=uav_1 make px4_sitl gz_x500
 ```

-will generate topics under the namespaces:
+将在以下命名空间下生成话题：

 ```sh
 /uav_1/fmu/in/  # for subscribers
@@ -766,27 +766,27 @@ will generate topics under the namespaces:
 <Badge type="tip" text="PX4 v1.15" />

 PX4 uXRCE-DDS middleware supports [ROS 2 services](https://docs.ros.org/en/jazzy/Concepts/Basic/About-Services.html).
-Services are remote procedure calls, from one node to another, that return a result.
+服务（Services）是一种远程过程调用（remote procedure calls），由一个节点发起，向另一个节点请求调用，最终会返回一个结果。

 A service server is the entity that will accept a remote procedure request, perform some computation on it, and return the result.
 They simplify communication between ROS 2 nodes and PX4 by grouping the request and response behaviour, and ensuring that replies are only returned to the specific requesting user.
-This is much easier that publishing the request, subscribing to the reply, and filtering out any unwanted responses.
+这比发布请求、订阅回复并过滤掉所有不需要的响应要容易得多。

-The service servers that are built into the PX4 [uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client) module include:
+构建在 PX4 [uxrce_dds_client](../modules/modules_system.md#uxrce-dds-client) 模块中的服务服务器包括：

 - `/fmu/vehicle_command` (definition: [`px4_msgs::srv::VehicleCommand`](https://github.com/PX4/px4_msgs/blob/main/srv/VehicleCommand.srv).)

-  This service can be called by ROS 2 applications to send PX4 [VehicleCommand](../msg_docs/VehicleCommand.md) uORB messages and receive PX4 [VehicleCommandAck](../msg_docs/VehicleCommandAck.md) uORB messages in response.
+  此服务可以被 ROS 2 应用程序调用来发送 PX4[VehicleCommand](../msg_docs/VehicleCommand.md) uORB 消息，并相应接收 PX4  [VehicleCommandAck](../msg_docs/VehicleCommandAck.md)uORB 消息。

-All PX4 service names follow the convention `{extra_namespace}/fmu/{server_specific_name}` where `{extra_namespace}` is the same [custom namespace](#customizing-the-namespace) that can be given to the PX4 topics.
+所有 PX4 服务名称均遵循 `{extra_namespace}/fmu/{server_specific_name}` 这一约定，其中 {extra_namespace} 与可分配给 PX4 话题的 [custom namespace](#customizing-the-namespace)相同。

-Details and specific examples are provided in the following sections.
+具体细节和示例将在以下章节中提供。

-### VehicleCommand service
+### 载体指挥服务

-This can be used to send commands to the vehicle, such as "take off", "land", change mode, and "orbit", and receive a response.
+这可用于向飞行器发送指令（例如 “起飞”“着陆”“切换模式” 和 “盘旋”），并接收响应。

-The service type is defined in [`px4_msgs::srv::VehicleCommand`](https://github.com/PX4/px4_msgs/blob/main/srv/VehicleCommand.srv) as:
+服务类型在 [`px4_msgs::srv::VehicleCommand`](https://github.com/PX4/px4_msgs/blob/main/srv/VehicleCommand.srv)  中定义如下：

 ```txt
 VehicleCommand request
@@ -794,30 +794,30 @@ VehicleCommand request
 VehicleCommandAck reply
 ```

-Users can make service requests by sending [VehicleCommand](../msg_docs/VehicleCommand.md) messages, and receive a [VehicleCommandAck](../msg_docs/VehicleCommandAck.md) message in response.
-The service ensures that only the `VehicleCommandAck` reply generated for the specific request made by the user is sent back.
+用户可通过发送  [VehicleCommand](../msg_docs/VehicleCommand.md)消息发起服务请求，并会收到一条[VehicleCommandAck](../msg_docs/VehicleCommandAck.md) 消息作为响应。
+该服务可确保仅将针对用户发起的特定请求所生成的 VehicleCommandAck回复返回。

-#### VehicleCommand Service Offboard Control Example
+#### 载体指挥服务离板控制示例

-A complete _offboard control_ example using the VehicleCommand service is provided by the [offboard_control_srv](https://github.com/PX4/px4_ros_com/blob/main/src/examples/offboard/offboard_control_srv.cpp) node available in the `px4_ros_com` package.
+在 px4_ros_com 功能包中，有一个[offboard_control_srv](https://github.com/PX4/px4_ros_com/blob/main/src/examples/offboard/offboard_control_srv.cpp) 节点，该节点提供了一个完整的、使用 VehicleCommand 服务实现离板控制的示例。

-The example closely follows the _offboard control_ example described in [ROS 2 Offboard Control Example](../ros2/offboard_control.md) but uses the `VehicleCommand` service to request mode changes, vehicle arming and vehicle disarming.
+该示例与[ROS 2 Offboard Control Example](../ros2/offboard_control.md) 中描述的离板控制示例高度相似，但使用 VehicleCommand 服务来请求模式切换、飞行器上锁和飞行器解锁。

-First the ROS 2 application declares a service client of type `px4_msgs::srv::VehicleCommand` using `rclcpp::Client()` as shown (this is the same approach used for all ROS2 service clients):
+首先，ROS 2 应用程序会使用 rclcpp::Client() 声明一个类型为 px4_msgs::srv::VehicleCommand 的服务客户端，具体如下（所有 ROS 2 服务客户端均采用此方法）

 ```cpp
-rclcpp::Client<px4_msgs::srv::VehicleCommand>::SharedPtr vehicle_command_client_;
+rclcpp::Client<0>::SharedPtr vehicle_command_client_;
 ```

-Then the client is initialized to the right ROS 2 service (`/fmu/vehicle_command`).
-As the application assumes the standard PX4 namespace is used, the code to do this looks like this:
+然后客户端初始化到正确的 ROS 2 服务 (`/fmu/vehicle_command` )。
+当应用程序假设使用标准的 PX4 命名空间时，这样做的代码看起来就像这样：

 ```cpp
 vehicle_command_client_{this->create_client<px4_msgs::srv::VehicleCommand>("/fmu/vehicle_command")}
 ```

-After that, the client can be used to send any vehicle command request.
-For example, the `arm()` function is used to request the vehicle to arm:
+此后，客户可以用来发送任何机体命令请求。
+例如，`arm()`函数用于请求机体放置：

 ```cpp
 void OffboardControl::arm()
@@ -827,7 +827,7 @@ void OffboardControl::arm()
 }
 ```

-where `request_vehicle_command` handles formatting the request and sending it over in _asynchronous_ [mode](https://docs.ros.org/en/humble/How-To-Guides/Sync-Vs-Async.html#asynchronous-calls):
+`request_vehicle_command`处理请求格式化并在_asynchronous_ [mode](https://docs.ros.org/en/humble/How-To-Guides/Sync-Vs-Async.html#asynchronous-calls):

 ```cpp
 void OffboardControl::request_vehicle_command(uint16_t command, float param1, float param2)
@@ -853,7 +853,7 @@ void OffboardControl::request_vehicle_command(uint16_t command, float param1, fl
 }
 ```

-The response is finally captured asynchronously by the `response_callback` method which checks for the request result:
+最终，响应由 response_callback 方法以异步方式捕获，该方法会检查请求结果：

 ```cpp
 void OffboardControl::response_callback(
@@ -872,20 +872,20 @@ void OffboardControl::response_callback(

 ## ros2 CLI

-The [ros2 CLI](https://docs.ros.org/en/humble/Tutorials/Beginner-CLI-Tools.html) is a useful tool for working with ROS.
-You can use it, for example, to quickly check whether topics are being published, and also inspect them in detail if you have `px4_msg` in the workspace.
-The command also lets you launch more complex ROS systems via a launch file.
-A few possibilities are demonstrated below.
+[ros2 CLI](https://docs.ros.org/en/humble/Tutorials/Beginner-CLI-Tools.html)是一个有用的工具来处理ROS。
+例如，您可以使用它快速检查话题是否正在发布；如果您的工作空间中包含 px4_msg，还可以详细查看这些话题的内容。
+该命令还允许您通过启动文件（launch file）启动更复杂的 ROS 系统。
+下文显示了几种可能性。

-### ros2 topic list
+### ros2 topic list（ROS 2 话题列表命令）

-Use `ros2 topic list` to list the topics visible to ROS 2:
+使用 ros2 topic list 命令列出 ROS 2 可识别的话题：

 ```sh
-ros2 topic list
+ros2 topic list（ROS 2 话题列表命令）
 ```

-If PX4 is connected to the agent, the result will be a list of topic types:
+若 PX4 已连接至代理，输出结果将是一份话题类型列表：

 ```sh
 /fmu/in/obstacle_distance
@@ -894,19 +894,19 @@ If PX4 is connected to the agent, the result will be a list of topic types:
 ...
 ```

-Note that the workspace does not need to build with `px4_msgs` for this to succeed; topic type information is part of the message payload.
+请注意，工作区不需要使用 px4_msgs 构建才能成功；主题类型信息是消息有效载荷的一部分。

 ### ros2 topic echo

-Use `ros2 topic echo` to show the details of a particular topic.
+使用  `ros2 topic echo`"来显示特定主题的详细信息。

-Unlike with `ros2 topic list`, for this to work you must be in a workspace has built the `px4_msgs` and sourced `local_setup.bash` so that ROS can interpret the messages.
+与 ros2 topic list 命令不同，要让该功能正常工作，你必须处于一个已编译 px4_msgs且已执行 local_setup.bash 脚本的工作空间中，这样 ROS 才能解析相关消息

 ```sh
 ros2 topic echo /fmu/out/vehicle_status
 ```

-The command will echo the topic details as they update.
+该命令将在主题细节更新时响应它们的详细信息。

 ```sh
 ---
@@ -927,14 +927,14 @@ hil_state: 0

 ### ros2 topic hz

-You can get statistics about the rates of messages using `ros2 topic hz`.
-For example, to get the rates for `SensorCombined`:
+你可以使用 ros2 topic hz 命令获取消息速率相关的统计信息。
+例如，获取`SensorCombined`速率：

 ```sh
 ros2 topic hz /fmu/out/sensor_combined
 ```

-The output will look something like:
+输出会看起来像这样：

 ```sh
 average rate: 248.187
@@ -953,30 +953,30 @@ min: 0.000s max: 0.012s std dev: 0.00148s window: 3960

 ### ros2 launch

-The `ros2 launch` command is used to start a ROS 2 launch file.
-For example, above we used `ros2 launch px4_ros_com sensor_combined_listener.launch.py` to start the listener example.
+ros2 launch 命令用于启动一个 ROS 2 启动文件
+例如，前面我们使用 ros2 launch px4_ros_com sensor_combined_listener.launch.py 命令启动了监听器示例。

-You don't need to have a launch file, but they are very useful if you have a complex ROS 2 system that needs to start several components.
+你并非必须使用启动文件，但如果你的 ROS 2 系统较为复杂，需要启动多个组件，那么启动文件会非常实用。

-For information about launch files see [ROS 2 Tutorials > Creating launch files](https://docs.ros.org/en/humble/Tutorials/Intermediate/Launch/Creating-Launch-Files.html)
+关于启动文件的信息，请参阅 [ROS 2 Tutorials > Creating launch files](https://docs.ros.org/en/humble/Tutorials/Intermediate/Launch/Creating-Launch-Files.html)

 ## 故障处理

-### Missing dependencies
+### 缺少依赖项

-The standard installation should include all the tools needed by ROS 2.
+标准安装应包含 ROS 2 所需的所有工具。

-If any are missing, they can be added separately:
+如果有任何缺失，可以单独添加：

- **`colcon`** build tools should be in the development tools.
-  It can be installed using:
+- **`colcon`** 构建工具应该在开发工具中。
+  可以使用以下方式安装它：

  ```sh
  sudo apt install python3-colcon-common-extensions
  ```

- The Eigen3 library used by the transforms library should be in the both the desktop and base packages.
-  It should be installed as shown:
+- 变换库（transforms library）所使用的 Eigen3 库，应同时存在于桌面版（desktop）功能包和基础版（base）功能包中。
+  它应该安装在显示中：

  :::: tabs

@@ -1002,10 +1002,10 @@ If any are missing, they can be added separately:

 ### ros_gz_bridge not publishing on the \clock topic

-If your [ROS2 nodes use the Gazebo clock as time source](../ros2/user_guide.md#ros2-nodes-use-the-gazebo-clock-as-time-source) but the `ros_gz_bridge` node doesn't publish anything on the `/clock` topic, you may have the wrong version installed.
-This might happen if you install ROS 2 Humble with the default "Ignition Fortress" packages, rather than using those for PX4, which uses "Gazebo Harmonic".
+如果你的[ROS2 nodes use the Gazebo clock as time source](../ros2/user_guide.md#ros2-nodes-use-the-gazebo-clock-as-time-source) 但`ros_gz_bridge` 节点没有发布任何关于\`/时钟' 主题的内容。 您可能安装了错误的版本。
+若你在安装 ROS 2 Humble 时，使用的是默认的 “Ignition Fortress” 功能包，而非 PX4 所使用的、适配 “Gazebo Harmonic” 的功能包，就可能出现这种情况。

-The following commands uninstall the default Ignition Fortress topics and install the correct bridge and other interface topics for **Gazebo Harmonic** with ROS2 **Humble**:
+以下命令会卸载默认的 Ignition Fortress 功能包，并为搭配 ROS 2 Humble 版本的 Gazebo Harmonic 安装正确的桥接功能包及其他接口功能包：

 ```bash
 # Remove the wrong version (for Ignition Fortress)
@@ -1015,7 +1015,7 @@ sudo apt remove ros-humble-ros-gz
 sudo apt install ros-humble-ros-gzharmonic
 ```

-## Additional information
+## 更多信息

 - [ROS 2 in PX4: Technical Details of a Seamless Transition to XRCE-DDS](https://www.youtube.com/watch?v=F5oelooT67E) - Pablo Garrido & Nuno Marques (youtube)
 - [DDS and ROS middleware implementations](https://github.com/ros2/ros2/wiki/DDS-and-ROS-middleware-implementations)
--- a/docs/zh/sim_gazebo_gz/index.md
+++ b/docs/zh/sim_gazebo_gz/index.md
@@ -20,6 +20,8 @@ See [Simulation](../simulation/index.md) for general information about simulator

 Gazebo Harmonic is installed by default on Ubuntu 22.04 as part of the normal [development environment setup](../dev_setup/dev_env_linux_ubuntu.md#simulation-and-nuttx-pixhawk-targets).

+Gazebo versions Harmonic, Ionic, and Jetty are supported on Ubuntu 24.04. The latest installed Gazebo release is used by default.
+
 :::info
 The PX4 installation scripts are based on the instructions: [Binary Installation on Ubuntu](https://gazebosim.org/docs/harmonic/install_ubuntu/) (gazebosim.org).
 :::
@@ -48,22 +50,23 @@ This runs both the PX4 SITL instance and the Gazebo client.
 The supported vehicles and `make` commands are listed below.
 Note that all gazebo make targets have the prefix `gz_`.

-| Vehicle                                                                                                                                                            | 通信                                  | `PX4_SYS_AUTOSTART` |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- | ------------------- |
-| [Quadrotor (x500)](../sim_gazebo_gz/vehicles.md#x500-quadrotor)                                                                                 | `make px4_sitl gz_x500`             | 4011                |
-| [X500 Quadrotor with Depth Camera (Front-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-depth-camera-front-facing)                   | `make px4_sitl gz_x500_depth`       | 4002                |
-| [Quadrotor(x500) with Vision Odometry](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-visual-odometry)                                        | `make px4_sitl gz_x500_vision`      | 4005                |
-| [Quadrotor(x500) with 1D LIDAR (Down-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-1d-lidar-down-facing)         | `make px4_sitl gz_x500_lidar_down`  | 4016                |
-| [Quadrotor(x500) with 2D LIDAR](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-2d-lidar)                                                      | `make px4_sitl gz_x500_lidar_2d`    | 4013                |
-| [Quadrotor(x500) with 1D LIDAR (Front-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-1d-lidar-front-facing)       | `make px4_sitl gz_x500_lidar_front` | 4017                |
-| [Quadrotor(x500) with gimbal (Front-facing) in Gazebo](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-gimbal-front-facing) | `make px4_sitl gz_x500_gimbal`      | 4019                |
-| [VTOL](../sim_gazebo_gz/vehicles.md#standard-vtol)                                                                                                                 | `make px4_sitl gz_standard_vtol`    | 4004                |
-| [Plane](../sim_gazebo_gz/vehicles.md#standard-plane)                                                                                                               | `make px4_sitl gz_rc_cessna`        | 4003                |
-| [Advanced Plane](../sim_gazebo_gz/vehicles.md#advanced-plane)                                                                                                      | `make px4_sitl gz_advanced_plane`   | 4008                |
-| [Differential Rover](../sim_gazebo_gz/vehicles.md#differential-rover)                                                                                              | `make px4_sitl gz_r1_rover`         | 4009                |
-| [Ackermann Rover](../sim_gazebo_gz/vehicles.md#ackermann-rover)                                                                                                    | `make px4_sitl gz_rover_ackermann`  | 4012                |
-| [Quad Tailsitter VTOL](../sim_gazebo_gz/vehicles.md#quad-tailsitter-vtol)                                                                                          | `make px4_sitl gz_quadtailsitter`   | 4018                |
-| [Tiltrotor VTOL](../sim_gazebo_gz/vehicles.md#tiltrotor-vtol)                                                                                                      | `make px4_sitl gz_tiltrotor`        | 4020                |
+| Vehicle                                                                                                                                                            | 通信                                    | `PX4_SYS_AUTOSTART` |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- | ------------------- |
+| [Quadrotor (x500)](../sim_gazebo_gz/vehicles.md#x500-quadrotor)                                                                                 | `make px4_sitl gz_x500`               | 4011                |
+| [X500 Quadrotor with Depth Camera (Front-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-depth-camera-front-facing)                   | `make px4_sitl gz_x500_depth`         | 4002                |
+| [Quadrotor(x500) with Vision Odometry](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-visual-odometry)                                        | `make px4_sitl gz_x500_vision`        | 4005                |
+| [Quadrotor(x500) with 1D LIDAR (Down-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-1d-lidar-down-facing)         | `make px4_sitl gz_x500_lidar_down`    | 4016                |
+| [Quadrotor(x500) with 2D LIDAR](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-2d-lidar)                                                      | `make px4_sitl gz_x500_lidar_2d`      | 4013                |
+| [Quadrotor(x500) with 1D LIDAR (Front-facing)](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-1d-lidar-front-facing)       | `make px4_sitl gz_x500_lidar_front`   | 4017                |
+| [Quadrotor(x500) with gimbal (Front-facing) in Gazebo](../sim_gazebo_gz/vehicles.md#x500-quadrotor-with-gimbal-front-facing) | `make px4_sitl gz_x500_gimbal`        | 4019                |
+| [VTOL](../sim_gazebo_gz/vehicles.md#standard-vtol)                                                                                                                 | `make px4_sitl gz_standard_vtol`      | 4004                |
+| [Plane](../sim_gazebo_gz/vehicles.md#standard-plane)                                                                                                               | `make px4_sitl gz_rc_cessna`          | 4003                |
+| [Advanced Plane](../sim_gazebo_gz/vehicles.md#advanced-plane)                                                                                                      | `make px4_sitl gz_advanced_plane`     | 4008                |
+| [Quad Tailsitter VTOL](../sim_gazebo_gz/vehicles.md#quad-tailsitter-vtol)                                                                                          | `make px4_sitl gz_quadtailsitter`     | 4018                |
+| [Tiltrotor VTOL](../sim_gazebo_gz/vehicles.md#tiltrotor-vtol)                                                                                                      | `make px4_sitl gz_tiltrotor`          | 4020                |
+| [Differential Rover](../sim_gazebo_gz/vehicles.md#differential-rover)                                                                                              | `make px4_sitl gz_rover_differential` | 50000               |
+| [Ackermann Rover](../sim_gazebo_gz/vehicles.md#ackermann-rover)                                                                                                    | `make px4_sitl gz_rover_ackermann`    | 51000               |
+| [Mecanum Rover](../sim_gazebo_gz/vehicles.md#mecanum-rover)                                                                                                        | `make px4_sitl gz_rover_mecanum`      | 52000               |

 All [vehicle models](../sim_gazebo_gz/vehicles.md) (and [worlds](#specify-world)) are included as a submodule from the [Gazebo Models Repository](../sim_gazebo_gz/gazebo_models.md) repository.

--- a/docs/zh/sim_gazebo_gz/vehicles.md
+++ b/docs/zh/sim_gazebo_gz/vehicles.md
@@ -185,7 +185,7 @@ make px4_sitl gz_tiltrotor
 [Differential Rover](../frames_rover/index.md#differential) uses the [rover world](../sim_gazebo_gz/worlds.md#rover) by default.

 ```sh
-make px4_sitl gz_r1_rover
+make px4_sitl gz_rover_differential
 ```

 ![Differential Rover in Gazebo](../../assets/simulation/gazebo/vehicles/rover_differential.png)
@@ -199,3 +199,13 @@ make px4_sitl gz_rover_ackermann
 ```

 ![Ackermann Rover in Gazebo](../../assets/simulation/gazebo/vehicles/rover_ackermann.png)
+
+### Mecanum Rover
+
+[Mecanum Rover](../frames_rover/index.md#mecanum) uses the [rover world](../sim_gazebo_gz/worlds.md#rover) by default.
+
+```sh
+make px4_sitl gz_rover_mecanum
+```
+
+![Mecanum Rover in Gazebo](../../assets/simulation/gazebo/vehicles/rover_mecanum.png)
--- a/docs/zh/telemetry/telemetry_wifi.md
+++ b/docs/zh/telemetry/telemetry_wifi.md
@@ -1,6 +1,6 @@
 # WiFi 数传电台

-WiFi telemetry enables MAVLink communication between a WiFi radio on a vehicle and a GCS.\
+WiFi telemetry enables MAVLink communication between a WiFi radio on a vehicle and a GCS.  
 WiFi typically offers shorter range than a normal telemetry radio, but supports higher data rates, and makes it easier to support FPV/video feeds.
 Usually only a single radio unit for the vehicle is needed (assuming the ground station already has WiFi).