New Crowdin translations - zh-CN (#25483)

Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
This commit is contained in:
PX4 Build Bot
2025-09-11 08:29:25 +10:00
committed by GitHub
co-authored by Crowdin Bot
parent 472e0657b5
commit 2e84e55d93
123 changed files with 2858 additions and 2621 deletions
@@ -22,7 +22,7 @@ It is pre-installed with PX4 v1.15.4 at time of writing (a more recent version m
- Compatibility with many different components, providing platform for loading other user sensors, preparing for functional model development.
- Abundant power supply making it perfect for installing additional sensors and onboard computers (including 5 external output voltages, 3 channels of 5V, 2 channels of 12V).
- Pc-SDK support.
This is a PC-based Python SDK Library based on MAVSDK that significantly simplifies UAV development compared to other approaches, such as using ROS or using C++. All you need is a basic understanding of Python programming and some simple coordinate system principles!
This is a PC-based Python SDK Library based on MAVSDK that significantly simplifies UAV development compared to other approaches, such as using ROS or using C++. All you need is a basic understanding of Python programming and some simple coordinate system principles!
- The [documentation](https://docs.amovlab.com/f450-v6c-wiki/#/en/) shows many of the options.
7. Quasi-smart battery. The battery has a hard housing design that makes easy to install and remove.
It provides accurate power estimates, but does not have some more advanced "smart battery" features.
+28 -28
View File
@@ -51,54 +51,54 @@ After setting up the PX4 development environment, follow these steps to install
1. Download the source code of the PX4 Bootloader:
```sh
git clone https://github.com/PX4/PX4-Bootloader.git
```
```sh
git clone https://github.com/PX4/PX4-Bootloader.git
```
2. Navigate into the top directory of the source code and compile it using:
```sh
make crazyflie_bl
```
```sh
make crazyflie_bl
```
3. Put the Crazyflie 2.0 into DFU mode by following these steps:
- Ensure it is initially unpowered.
- Hold down the reset button (see figure below...).
![Crazyflie2 Reset Button](../../assets/flight_controller/crazyflie/crazyflie_reset_button.jpg)
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
- Ensure it is initially unpowered.
- Hold down the reset button (see figure below...).
![Crazyflie2 Reset Button](../../assets/flight_controller/crazyflie/crazyflie_reset_button.jpg)
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
4. Install _dfu-util_:
```sh
sudo apt-get update
sudo apt-get install dfu-util
```
```sh
sudo apt-get update
sudo apt-get install dfu-util
```
5. Flash bootloader using _dfu-util_ and unplug Crazyflie 2.0 when done:
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D ./build/crazyflie_bl/crazyflie_bl.bin
```
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D ./build/crazyflie_bl/crazyflie_bl.bin
```
When powering on the Crazyflie 2.0 the yellow LED should blink.
When powering on the Crazyflie 2.0 the yellow LED should blink.
6. Download the source code of the PX4 autopilot:
```sh
git clone https://github.com/PX4/PX4-Autopilot.git
```
```sh
git clone https://github.com/PX4/PX4-Autopilot.git
```
7. Navigate into the top directory of the source code and compile it using:
```sh
make bitcraze_crazyflie_default upload
```
```sh
make bitcraze_crazyflie_default upload
```
8. When prompted to plug in device, plug in Crazyflie 2.0.
The yellow LED should start blinking indicating bootloader mode.
Then the red LED should turn on indicating that the flashing process has started.
The yellow LED should start blinking indicating bootloader mode.
Then the red LED should turn on indicating that the flashing process has started.
9. Wait for completion.
+40 -40
View File
@@ -64,56 +64,56 @@ After setting up the PX4 development environment, follow these steps to install
1. Download the source code of the PX4 Bootloader:
```sh
git clone https://github.com/PX4/PX4-Bootloader.git --recurse-submodules
```
```sh
git clone https://github.com/PX4/PX4-Bootloader.git --recurse-submodules
```
2. Navigate into the top directory of the source code and compile it using:
```sh
make crazyflie21_bl
```
```sh
make crazyflie21_bl
```
3. Put the Crazyflie 2.1 into DFU mode by following these steps:
- Ensure it is initially unpowered.
- Ensure battery is disconnected.
- Hold down the reset button (see figure below...).
![Crazyflie2 Reset Button](../../assets/flight_controller/crazyflie/crazyflie_reset_button.jpg)
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
- Ensure it is initially unpowered.
- Ensure battery is disconnected.
- Hold down the reset button (see figure below...).
![Crazyflie2 Reset Button](../../assets/flight_controller/crazyflie/crazyflie_reset_button.jpg)
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
4. Install _dfu-util_:
```sh
sudo apt-get update
sudo apt-get install dfu-util
```
```sh
sudo apt-get update
sudo apt-get install dfu-util
```
5. Flash bootloader using _dfu-util_ and unplug Crazyflie 2.1 when done:
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D ./build/crazyflie21_bl/crazyflie21_bl.bin
```
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D ./build/crazyflie21_bl/crazyflie21_bl.bin
```
When powering on the Crazyflie 2.1 the yellow LED should blink.
When powering on the Crazyflie 2.1 the yellow LED should blink.
6. Download the source code of the PX4 autopilot:
```sh
git clone https://github.com/PX4/PX4-Autopilot.git
```
```sh
git clone https://github.com/PX4/PX4-Autopilot.git
```
7. Navigate into the top directory of the source code and compile it using:
```sh
cd PX4-Autopilot/
make bitcraze_crazyflie21_default upload
```
```sh
cd PX4-Autopilot/
make bitcraze_crazyflie21_default upload
```
8. When prompted to plug in device, plug in Crazyflie 2.1.
The yellow LED should start blinking indicating bootloader mode.
Then the red LED should turn on indicating that the flashing process has started.
The yellow LED should start blinking indicating bootloader mode.
Then the red LED should turn on indicating that the flashing process has started.
9. Wait for completion.
@@ -124,20 +124,20 @@ After setting up the PX4 development environment, follow these steps to install
1. Download the latest [Crazyflie 2.1 bootloader](https://github.com/bitcraze/crazyflie2-stm-bootloader/releases)
2. Put the Crazyflie 2.1 into DFU mode by following these steps:
- Ensure it is initially unpowered.
- Ensure battery is disconnected.
- Hold down the reset button.
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
- Ensure it is initially unpowered.
- Ensure battery is disconnected.
- Hold down the reset button.
- Plug into computer's USB port.
- After a second, the blue LED should start blinking and after 5 seconds should start blinking faster.
- Release button.
3. Flash bootloader using _dfu-util_ and unplug Crazyflie 2.1 when done:
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D cf2loader-1.0.bin
```
```sh
sudo dfu-util -d 0483:df11 -a 0 -s 0x08000000 -D cf2loader-1.0.bin
```
When powering on the Crazyflie 2.1 the yellow LED should blink.
When powering on the Crazyflie 2.1 the yellow LED should blink.
4. Install the latest Bitcraze Crazyflie 2.1 Firmware using [this](https://www.bitcraze.io/documentation/tutorials/getting-started-with-crazyflie-2-x/#update-fw) tutorial.
@@ -84,26 +84,26 @@ Follow this guide to bind your ELRS receiver to your transmitter.
#### Setting up the Receiver
1. **Power On the Receiver**: Once your drone is powered on, you'll notice the ELRS receiver's blue LED flashing.
This is an indication that the receiver is on but has not yet established a connection with a transmitter.
This is an indication that the receiver is on but has not yet established a connection with a transmitter.
![Starling Receiver](../../assets/hardware/complete_vehicles/modalai_starling/starling-photo.png)
![Starling Receiver](../../assets/hardware/complete_vehicles/modalai_starling/starling-photo.png)
2. **Enter Binding Mode**: To initiate binding, open a terminal and execute the `adb shell` and `voxl-elrs -bind` commands.
You'll observe the receiver's LED switch to a flashing in a heartbeat pattern, signaling that it is now in binding mode.
You'll observe the receiver's LED switch to a flashing in a heartbeat pattern, signaling that it is now in binding mode.
![Boot Screenshot](../../assets/hardware/complete_vehicles/modalai_starling/screenshot-boot.png)
![Boot Screenshot](../../assets/hardware/complete_vehicles/modalai_starling/screenshot-boot.png)
#### Setting up the Transmitter
1. **Access the Menu**: On your Commando 8 radio transmitter included in the kit, press the left mode button to open the menu system.
![Press Menu on RC](../../assets/hardware/complete_vehicles/modalai_starling/radio-1.png)
![Press Menu on RC](../../assets/hardware/complete_vehicles/modalai_starling/radio-1.png)
2. **Navigate to ExpressLRS**: Use the right button to select the first menu entry, which should be "ExpressLRS."
3. **Find the Bind Option**: With the "ExpressLRS" option selected, scroll down to the bottom of the menu to locate the "Bind" section. This can be done by pressing the right button downwards until you reach the "Bind" option.
![Press Binding on RC](../../assets/hardware/complete_vehicles/modalai_starling/radio-2.png)
![Press Binding on RC](../../assets/hardware/complete_vehicles/modalai_starling/radio-2.png)
4. **Initiate Binding**: Select "Bind" to put the transmitter into binding mode. You will know the process has been successful when the transmitter emits a beep, indicating a successful bind.
+79 -79
View File
@@ -42,17 +42,17 @@ This kit is still highly recommended for developing and testing vision solutions
## Warnings and Notifications
1. The kit is intended for computer vision projects that use a forward-facing camera (it does not have downward or rear-facing depth cameras).
Consequently it can't be used (without modification) for testing features that require a downward-facing camera.
Consequently it can't be used (without modification) for testing features that require a downward-facing camera.
2. Obstacle avoidance in missions can only be tested when GPS is available (missions use GPS coordinates).
Collision prevention can be tested in position mode provided there is a good position lock from either GPS or optical flow.
Collision prevention can be tested in position mode provided there is a good position lock from either GPS or optical flow.
3. The port labeled `USB1` may jam the GPS if used with a _USB3_ peripheral (disable GPS-dependent functionality including missions).
This is why the boot image is supplied on a _USB2.0_ memory stick.
This is why the boot image is supplied on a _USB2.0_ memory stick.
4. PX4 Vision v1 with ECN 010 or above (carrier board RC05 and up), the _UP Core_ can be powered by either the DC plug or with battery.
![RC Number](../../assets/hardware/px4_vision_devkit/rc.png) ![ECN Number](../../assets/hardware/px4_vision_devkit/serial_number_update.jpg)
![RC Number](../../assets/hardware/px4_vision_devkit/rc.png) ![ECN Number](../../assets/hardware/px4_vision_devkit/serial_number_update.jpg)
5. All PX4 Vision v1.5 _UP Core_ can be powered by either the DC plug or with battery.
@@ -132,37 +132,37 @@ In addition, users will need ground station hardware/software:
## First-time Setup
1. Attach a [compatible RC receiver](../getting_started/rc_transmitter_receiver.md#connecting-receivers) to the vehicle (not supplied with kit):
- Remove/unscrew the top plate (where the battery goes) using an H2.0 hex key tool.
- [Connect the receiver to the flight controller](../assembly/quick_start_pixhawk4.md#radio-control).
- Re-attach the top plate.
- Mount the RC receiver on the _UP Core_ carrier board plate at the back of the vehicle (use zipties or double-sided tape).
- Ensure the antennas are clear of any obstructions and electrically isolated from the frame (e.g. secure them under the carrier board or to the vehicle arms or legs).
- Remove/unscrew the top plate (where the battery goes) using an H2.0 hex key tool.
- [Connect the receiver to the flight controller](../assembly/quick_start_pixhawk4.md#radio-control).
- Re-attach the top plate.
- Mount the RC receiver on the _UP Core_ carrier board plate at the back of the vehicle (use zipties or double-sided tape).
- Ensure the antennas are clear of any obstructions and electrically isolated from the frame (e.g. secure them under the carrier board or to the vehicle arms or legs).
2. [Bind](../getting_started/rc_transmitter_receiver.md#binding) the RC ground and air units (if not already done).
The binding procedure depends on the specific radio system used (read the receiver manual).
The binding procedure depends on the specific radio system used (read the receiver manual).
3. Raise the GPS mast to the vertical position and screw the cover onto the holder on the base plate. (Not required for v1.5)
![Raise GPS mast](../../assets/hardware/px4_vision_devkit/raise_gps_mast.jpg)
![Raise GPS mast](../../assets/hardware/px4_vision_devkit/raise_gps_mast.jpg)
4. Insert the pre-imaged USB2.0 stick from the kit into the _UP Core_ port labeled `USB1` (highlighted below).
![UP Core: USB1 Port ](../../assets/hardware/px4_vision_devkit/upcore_port_usb1.png)
![UP Core: USB1 Port ](../../assets/hardware/px4_vision_devkit/upcore_port_usb1.png)
5. Power the vehicle with a fully charged battery.
::: info
Ensure propellers are removed before connecting the battery.
::: info
Ensure propellers are removed before connecting the battery.
:::
6. Connect the ground station to the vehicle WiFi network (after a few seconds) using the following default credentials:
- **SSID:** pixhawk4
- **Password:** pixhawk4
- **SSID:** pixhawk4
- **Password:** pixhawk4
:::tip
WiFi network SSID, password, and other credentials may be changed after connecting (if desired), by using a web browser to open the URL: `http://192.168.4.1`.
The baud rate must not be changed from 921600.
:::tip
WiFi network SSID, password, and other credentials may be changed after connecting (if desired), by using a web browser to open the URL: `http://192.168.4.1`.
The baud rate must not be changed from 921600.
:::
@@ -170,39 +170,39 @@ In addition, users will need ground station hardware/software:
8. [Configure/calibrate](../config/index.md) the vehicle:
::: info
The vehicle should arrive pre-calibrated (e.g. with firmware, airframe, battery, and sensors all setup).
You will however need to calibrate the radio system (that you just connected) and it is often worth re-doing the compass calibration.
::: info
The vehicle should arrive pre-calibrated (e.g. with firmware, airframe, battery, and sensors all setup).
You will however need to calibrate the radio system (that you just connected) and it is often worth re-doing the compass calibration.
:::
- [Calibrate the Radio System](../config/radio.md)
- [Calibrate the Compass](../config/compass.md)
- [Calibrate the Radio System](../config/radio.md)
- [Calibrate the Compass](../config/compass.md)
9. (Optional) Configure a [Flight Mode selector switch](../config/flight_mode.md) on the remote controller.
::: info
Modes can also be changed using _QGroundControl_
::: info
Modes can also be changed using _QGroundControl_
:::
We recommend RC controller switches are define for:
We recommend RC controller switches are define for:
- [Position Mode](../flight_modes_mc/position.md) - a safe manual flight mode that can be used to test collision prevention.
- [Mission Mode](../flight_modes_mc/mission.md) - run missions and test obstacle avoidance.
- [Return Mode](../flight_modes_mc/return.md) - return vehicle safely to its launch point and land.
- [Position Mode](../flight_modes_mc/position.md) - a safe manual flight mode that can be used to test collision prevention.
- [Mission Mode](../flight_modes_mc/mission.md) - run missions and test obstacle avoidance.
- [Return Mode](../flight_modes_mc/return.md) - return vehicle safely to its launch point and land.
10. Attach the propellers with the rotations as shown:
![Motor Order Diagram](../../assets/hardware/px4_vision_devkit/motor_order_diagram.png)
![Motor Order Diagram](../../assets/hardware/px4_vision_devkit/motor_order_diagram.png)
- The propellers directions can be determined from the labels: _6045_ (normal, counter-clockwise) and _6045_**R** (reversed, clockwise).
- The propellers directions can be determined from the labels: _6045_ (normal, counter-clockwise) and _6045_**R** (reversed, clockwise).
![Propeller identification](../../assets/hardware/px4_vision_devkit/propeller_directions.jpg)
![Propeller identification](../../assets/hardware/px4_vision_devkit/propeller_directions.jpg)
- Screw down firmly using the provided propellor nuts:
- Screw down firmly using the provided propellor nuts:
![Propeller nuts](../../assets/hardware/px4_vision_devkit/propeller_nuts.png)
![Propeller nuts](../../assets/hardware/px4_vision_devkit/propeller_nuts.png)
## Fly the Drone with Avoidance
@@ -212,30 +212,30 @@ When the vehicle setup described above is complete:
2. Wait until the boot sequence completes and the avoidance system has started (the vehicle will reject arming commands during boot).
:::tip
The boot/startup process takes around 1 minute from the supplied USB stick (or 30 seconds from [internal memory](#install_image_mission_computer)).
:::tip
The boot/startup process takes around 1 minute from the supplied USB stick (or 30 seconds from [internal memory](#install_image_mission_computer)).
:::
3. Check that the avoidance system has started properly:
- The _QGroundControl_ notification log displays the message: **Avoidance system connected**.
- The _QGroundControl_ notification log displays the message: **Avoidance system connected**.
![QGC Log showing avoidance system has started](../../assets/hardware/px4_vision_devkit/qgc_console_vision_system_started.jpg)
![QGC Log showing avoidance system has started](../../assets/hardware/px4_vision_devkit/qgc_console_vision_system_started.jpg)
- A red laser is visible on the front of the _Structure Core_ camera.
- A red laser is visible on the front of the _Structure Core_ camera.
4. Wait for the GPS LED to turn green.
This means that the vehicle has a GPS fix and is ready to fly!
This means that the vehicle has a GPS fix and is ready to fly!
5. Connect the ground station to the vehicle WiFi network.
6. Find a safe outdoor location for flying, ideally with a tree or some other convenient obstacle for testing PX4 Vision.
7. To test [collision prevention](../computer_vision/collision_prevention.md), enable [Position Mode](../flight_modes_mc/position.md) and fly manually towards an obstacle.
The vehicle should slow down and then stop within 6m of the obstacle (the distance can be [changed](../advanced_config/parameters.md) using the [CP_DIST](../advanced_config/parameter_reference.md#CP_DIST) parameter).
The vehicle should slow down and then stop within 6m of the obstacle (the distance can be [changed](../advanced_config/parameters.md) using the [CP_DIST](../advanced_config/parameter_reference.md#CP_DIST) parameter).
8. To test obstacle avoidance, create a mission where the path is blocked by an obstacle.
Then switch to [Mission Mode](../flight_modes_mc/mission.md) to run the mission, and observe the vehicle moving around the obstacle and then returning to the planned course.
Then switch to [Mission Mode](../flight_modes_mc/mission.md) to run the mission, and observe the vehicle moving around the obstacle and then returning to the planned course.
## Development using the Kit
@@ -280,22 +280,22 @@ To flash the USB image to the _UP Core_:
2. [Login to the companion computer](#login_mission_computer) (as described above).
3. Open a terminal and run the following command to copy the image onto internal memory (eMMC).
The terminal will prompt for a number of responses during the flashing process.
The terminal will prompt for a number of responses during the flashing process.
```sh
cd ~/catkin_ws/src/px4vision_ros/tools
sudo ./flash_emmc.sh
```
```sh
cd ~/catkin_ws/src/px4vision_ros/tools
sudo ./flash_emmc.sh
```
::: info
All information saved in the _UP Core_ computer will be removed when executing this script.
::: info
All information saved in the _UP Core_ computer will be removed when executing this script.
:::
4. Pull out the USB stick.
5. Restart the vehicle.
The _UP Core_ computer will now boot from internal memory (eMMC).
The _UP Core_ computer will now boot from internal memory (eMMC).
### Boot the Companion Computer
@@ -319,23 +319,23 @@ To login to the companion computer:
1. Connect a keyboard and mouse to the _UP Core_ via port `USB2`:
![UP Core: USB2](../../assets/hardware/px4_vision_devkit/upcore_port_usb2.png)
![UP Core: USB2](../../assets/hardware/px4_vision_devkit/upcore_port_usb2.png)
- Use the USB-JST cable from the kit to get a USB A connector
- Use the USB-JST cable from the kit to get a USB A connector
![USB to JST cable](../../assets/hardware/px4_vision_devkit/usb_jst_cable.jpg)
![USB to JST cable](../../assets/hardware/px4_vision_devkit/usb_jst_cable.jpg)
- A USB hub can be attached to the cable if the keyboard and mouse have separate connectors.
- A USB hub can be attached to the cable if the keyboard and mouse have separate connectors.
2. Connect a monitor to the _UP Core_ HDMI port.
![UP Core: HDMI port](../../assets/hardware/px4_vision_devkit/upcore_port_hdmi.png)
![UP Core: HDMI port](../../assets/hardware/px4_vision_devkit/upcore_port_hdmi.png)
The Ubuntu login screen should then appear on the monitor.
The Ubuntu login screen should then appear on the monitor.
3. Login to the _UP Core_ using the credentials:
- **Username:** px4vision
- **Password:** px4vision
- **Username:** px4vision
- **Password:** px4vision
### Developing/Extending PX4 Avoidance
@@ -350,39 +350,39 @@ To integrate a different planner, this needs to be disabled.
1. Disable the avoidance process using the following command:
```sh
systemctl stop avoidance.service
```
```sh
systemctl stop avoidance.service
```
You can simply reboot the machine to restart the service.
You can simply reboot the machine to restart the service.
Other useful commands are:
Other useful commands are:
```sh
# restart service
systemctl start avoidance.service
```sh
# restart service
systemctl start avoidance.service
# disable service (stop service and do not restart after boot)
systemctl disable avoidance.service
# disable service (stop service and do not restart after boot)
systemctl disable avoidance.service
# enable service (start service and enable restart after boot)
systemctl enable avoidance.service
```
# enable service (start service and enable restart after boot)
systemctl enable avoidance.service
```
2. The source code of the obstacle avoidance package can be found in https://github.com/PX4/PX4-Avoidance which is located in `~/catkin_ws/src/avoidance`.
3. Make changes to the code! To get the latest code of avoidance pull the code from the avoidance repo:
```sh
git pull origin
git checkout origin/master
```
```sh
git pull origin
git checkout origin/master
```
4. Build the package
```sh
catkin build local_planner
```
```sh
catkin build local_planner
```
The ROS workspace is placed in `~/catkin_ws`.
For reference on developing in ROS and using the catkin workspace, see the [ROS catkin tutorials](https://wiki.ros.org/catkin/Tutorials).