Hamish Willee 88d623bedb
Move PX4 Guide source into /docs (#24490)
* Add vitepress tree

* Update existing workflows so they dont trigger on changes in the docs path

* Add nojekyll, package.json, LICENCE etc

* Add crowdin docs upload/download scripts

* Add docs flaw checker workflows

* Used docs prefix for docs workflows

* Crowdin obvious fixes

* ci: docs move to self hosted runner

runs on a beefy server for faster builds

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: don't run build action for docs or ci changes

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* ci: update runners

Signed-off-by: Ramon Roche <mrpollo@gmail.com>

* Add docs/en

* Add docs assets and scripts

* Fix up editlinks to point to PX4 sources

* Download just the translations that are supported

* Add translation sources for zh, uk, ko

* Update latest tranlsation and uorb graphs

* update vitepress to latest

---------

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
Co-authored-by: Ramon Roche <mrpollo@gmail.com>
2025-03-13 16:08:27 +11:00

107 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 查找/更新参数
PX4 behaviour can be configured/tuned using [parameters](../advanced_config/parameter_reference.md) (e.g. [Multicopter PID gains](../config_mc/pid_tuning_guide_multicopter.md), calibration information, etc.).
The _QGroundControl Parameters_ screen allows you to find and modify **any** of the parameters associated with the vehicle.
The screen is accessed by clicking the **Q** application icon > **Vehicle Setup**, and then _Parameters_ in the sidebar.
:::info
Most of the more commonly used parameters are more conveniently set using the dedicated setup screens, as described in the [Standard Configuration](../config/index.md) section.
The _Parameters_ screen is needed when modifying less commonly modified parameters - for example while tuning a new vehicle.
:::
:::warning
While some parameters can be changed in flight, this is not recommended (except where explicitly stated in the guide).
:::
<a id="finding"></a>
## 查找参数
You can search for a parameter by entering a term in the _Search_ field.
This will show you a list of all parameter names and descriptions that contain the entered substring (press **Clear** to reset the search, and use the **Show modified only** checkbox to filter out unchanged parameters).
![Parameters Search](../../assets/qgc/setup/parameters/parameters_search.png)
You can also browse the parameters by type and group by clicking on the buttons to the left (in the image below the _DShot_ group in the _Standard_ parameters is selected).
![Parameters Screen](../../assets/qgc/setup/parameters/parameters_px4.png)
You can expand/collapse the "type" groupings as shown.
Note that the groups at the bottom named _Component X_ are attached [DroneCAN peripherals](../dronecan/index.md#qgc-cannode-parameter-configuration) ("X" is the node id).
[QGC can set the parameters](../dronecan/index.md#qgc-cannode-parameter-configuration) of these peripherals if they are attached to the Flight Controller when QGC is started.
![Parameters Types - collapsed](../../assets/qgc/setup/parameters/parameters_types.png)
:::tip
If you can't find an expected parameter, see the [next section](#missing).
:::
<a id="missing"></a>
## 找不到的参数
参数通常不可见,因为它们要么以其他参数为条件,要么不存在于固件中(见下文)。
### 条件参数
如果一个参数是以未启用的另一个参数为条件,则该参数不会被显示。
You can usually find out what parameters are conditional by searching the [full parameter reference](../advanced_config/parameter_reference.md) and other documentation.
In particular [serial port configuration parameters](../peripherals/serial_configuration.md) depend on what service is assigned to a serial port.
### 固件中没有的参数
参数可能不在固件中,因为您使用了不同版本的 PX4或者因为您构建的固件中没有包含相关的模块。
每个PX4版本都添加了新参数现有参数有时被删除或重命名。
You can check whether a parameter _should_ be present by reviewing the [full parameter reference](../advanced_config/parameter_reference.md) for the version you're targeting.
您还可以在源代码和发布说明中查找参数。
参数可能不在固件中的另一个原因是如果其关联的模块没有被包含。
This is a problem (in particular) for _FMUv2 firmware_, which omits many modules so that PX4 can fit into the 1MB of available flash.
解决此问题有两种方法:
- Check if you can update your board to run FMUv3 firmware, which includes all modules: [Firmware > FMUv2 Bootloader Update](../config/firmware.md#bootloader)
- If your board can only run FMUv2 firmware you will need to [rebuild PX4](../dev_setup/building_px4.md) with the missing modules enabled.
You need reconfigure the PX4 firmware itself through make px4_fmuv2_default boardconfig where you can enabled/disable modules.
::: info
You may also need to disable other modules in order to fit the rebuilt firmware into 1MB flash.
Finding modules to remove requires some trial/error and depends on what use cases you need the vehicle to meet.
:::
<a id="changing"></a>
## 更改参数
要更改参数的值,请单击组或搜索列表中的参数行。
单击后屏幕侧边会显示一个对话框,您在其中更改参数的值(这个对话框还提供了该参数的额外细节信息——包括是否需要重启才能使参数生效)。
![Changing a parameter value](../../assets/qgc/setup/parameters/parameters_changing.png)
:::info
When you click **Save** the parameter is automatically and silently uploaded to the connected vehicle.
根据参数,您可能需要重新启动飞控才能使更改生效。
:::
## 工具
You can select additional options from the **Tools** menu on the top right hand side of the screen.
![Tools menu](../../assets/qgc/setup/parameters/parameters_tools_menu.png)
**Refresh** <br>Refresh the parameter values by re-requesting all of them from the vehicle.
**Reset all to firmware defaults** <br>Reset all parameters to their original default values in the firmware.
**Reset to vehicle's configuration defaults** <br>Reset all parameters to their original default values for the particular selected airfame configuration.
**Load from file / Save to file** <br>Load parameters from an existing file or save your current parameter settings to a file.
**Clear all RC to Param** <br>This clears all associations between RC transmitter controls and parameters.
For more information see: [Radio Setup > Param Tuning Channels](../config/radio.md#param-tuning-channels).
**Reboot Vehicle** <br>Reboot the vehicle (required after changing some parameters).