【产出】 > 在 QGroundControl 和 PX4 控制台里查找、修改、保存参数,导出整机参数做备份、导入到另一台飞机,必要时恢复默认值;并掌握新手最常改的速度、起降、返航和滤波参数的含义与默认值。
【版本】 > 依据 PX4 官方文档 main 分支(Finding/Updating Parameters、Parameters & Configurations、param 命令说明、Parameter Reference)和 QGroundControl 用户指南(Parameters、参数文件格式)编写。文中默认值摘自 main 分支参数参考,不同 PX4 版本可能有差异,以你飞控上 QGC 显示的为准。
一、PX4 参数是什么
PX4 的绝大部分行为由参数决定:PID 增益、传感器校准结果、失控保护动作、飞行速度上限等等。参数是一张扁平的表,每一项是 float 或 int32 类型的数值,名字全大写,前缀表示所属模块:
| 前缀 | 模块 | 例子 |
|---|---|---|
MPC_ | 多旋翼位置控制 | MPC_XY_VEL_MAX |
MC_ | 多旋翼姿态 / 角速度控制 | 姿态环和角速度环 PID |
COM_ | Commander(解锁、失控保护) | COM_DISARM_LAND |
NAV_ / MIS_ / RTL_ | 导航、任务、返航 | NAV_ACC_RAD、RTL_RETURN_ALT |
BAT1_ / BAT_ | 电池 | BAT1_N_CELLS |
IMU_ / SENS_ / CAL_ | 传感器、滤波、校准 | IMU_GYRO_CUTOFF |
SDLOG_ | 日志 | SDLOG_MODE |
SYS_ | 系统 | SYS_AUTOSTART |
官方说明:常用的设置在 QGC 的各个专门设置页(传感器、电池、失控保护等)里改更方便,这些页面本质上也是在改参数;Parameters 页面用来改那些没有专门界面的参数,例如调试一台新机时。
【注意】 > 官方不建议在飞行中修改参数,除非文档明确说明可以。修改与电机、控制器、失控保护有关的参数后,第一次测试要拆桨在地面确认,再低空试飞。
二、在 QGC 里查找参数
入口:点击左上角 Q 图标 → Vehicle Setup → 左侧栏最下面的 Parameters。
| 方法 | 操作 |
|---|---|
| 搜索 | 在 Search 框输入关键词,名称和描述中包含它的参数都会列出;Clear 清除搜索 |
| 只看改过的 | 勾选 Show modified only,过滤掉保持默认值的参数,排查"我到底改过什么"时最有用 |
| 按分组浏览 | 点左侧按类型和组排列的按钮,例如 Standard 下的某个组;分组可以展开 / 收起 |
左侧底部名为 Component X 的分组是连接在飞控上的 DroneCAN 外设,X 是节点号。QGC 启动时外设已经连着飞控,才能设置它们的参数。
找不到参数怎么办
官方列出了两类原因:
- 条件参数:参数依赖于另一个没有启用的参数,没启用时不显示。最典型的是串口配置参数,要先给串口分配了功能,相关的波特率等参数才会出现。改完前置参数通常需要重启,再刷新参数列表。
- 固件里没有:你用的 PX4 版本不同(参数会新增、删除、改名),或者固件编译时没有包含对应模块。对照所用版本的官方参数参考,或者在源码和发布说明里搜索这个参数名。
【提示】 > 网上教程里的参数名可能来自旧版本。照抄前先在 QGC 里搜索确认它存在,再到对应版本的参数参考里确认含义和单位。
三、修改参数
- 在列表里点击参数所在行,右侧弹出编辑框。
- 编辑框里有参数的详细说明、取值范围、单位,以及是否需要重启才能生效。
- 填入新值,点击 Save。
点 Save 后,参数会自动、静默地上传到飞机并保存,不需要另外的"写入"操作。如果这个参数要求重启,QGC 顶部工具栏会一直显示"需要重启"的提示,直到你重启飞控。重启用右上角 Tools → Reboot Vehicle。
枚举和位掩码参数:枚举参数在编辑框里是下拉选项;位掩码参数(如 SDLOG_PROFILE)是复选框,每一位对应一个功能。手动填数字时,要把各位对应的值相加,例如第 0 位和第 4 位都打开就是 1 + 16 = 17。
【注意】 > 改参数之前,先用下一节的方法导出一份当前参数。改坏了可以直接导回,不必凭记忆恢复。
四、导出与导入:备份整机配置
1. QGC 中的操作
右上角 Tools 菜单:
| 菜单项 | 作用 |
|---|---|
| Save to file | 把当前全部参数保存到电脑上的文件 |
| Load from file | 从文件加载参数到飞机 |
| Refresh | 重新从飞机读取全部参数 |
| Reset all to firmware defaults | 全部恢复为固件默认值 |
| Reset to vehicle's configuration defaults | 恢复为当前所选机架的默认值 |
| Clear all RC to Param | 清除遥控通道与参数的关联 |
| Reboot Vehicle | 重启飞控 |
2. 参数文件格式
QGC 保存的参数文件是文本格式,# 开头为注释,每行用 Tab 分隔五列:
# Onboard parameters for Vehicle 1
#
# # Vehicle-Id Component-Id Name Value Type
1 1 MIS_TAKEOFF_ALT 2.5 9
1 1 NAV_ACC_RAD 10 9
| 列 | 含义 |
|---|---|
| Vehicle-Id | 载具 ID |
| Component-Id | 组件 ID |
| Name | 参数名 |
| Value | 参数值 |
| Type | MAVLink 的 MAV_PARAM_TYPE_* 类型编号 |
一个文件只包含一架飞机的参数,可以包含这架飞机上多个组件的参数。上面示例中的数值和类型编号仅用于说明格式,实际以 QGC 导出的文件为准。
3. 推荐的备份时机
- 完成首次配置和校准、第一次成功试飞之后。
- 每次开始调参之前。
- 升级固件之前。
文件名里写上日期、机型和固件版本,例如 x500_v1.15_20261101_after_tune.params。
【注意】 > 把一台飞机的参数文件导入另一台飞机时,传感器校准值(加速度计、陀螺仪、磁罗盘的偏置和比例,以及传感器 ID)也会一起被覆盖,而每块飞控的这些值都不同。导入后必须重新做全部传感器校准,并重新检查电机映射和转向,确认无误前不要装桨。
五、在控制台里管理参数
PX4 的系统控制台提供 param 命令。真机通过 QGC 的 Analyze → MAVLink Console 输入;SITL 仿真在运行 make 的终端 pxh> 下输入。
1. 查看
param show # 列出参数
param show MPC_XY* # 只看以 MPC_XY 开头的参数(通配符只能放在末尾)
param show -c # 只看改过(与默认值不同)的参数
param show-for-airframe # 只看相对于当前机架默认值改过的参数
param status # 参数系统状态
param show 输出行首的符号含义:x 表示被使用,+ 表示已保存,* 表示未保存。
2. 修改
param set MIS_TAKEOFF_ALT 5
param bitset SDLOG_PROFILE 16 # 只把第 4 位置 1,其他位不变(仅 INT32)
param bitclear SDLOG_PROFILE 16 # 只把第 4 位清 0
官方说明,用 param set 修改的参数会自动保存,一般存在 FRAM 或 SD 卡上。
3. 保存到文件、从文件加载
param save /fs/microsd/param_backup # 保存到 SD 卡上的指定文件(不带参数时存到默认位置)
param load /fs/microsd/param_backup # 先全部重置为默认值,再用文件里的值覆盖
param save # load 不会自动保存,需要手动保存
param import /fs/microsd/param_backup # 只用文件里的值覆盖,其余保持不变,并自动保存
load 和 import 的区别很重要:
| 命令 | 效果 | 适用 |
|---|---|---|
param load | 相当于回到保存文件时的状态 | 整机恢复备份 |
param import | 把文件内容合并到当前配置 | 只导入一部分,例如只导入一份校准数据,不动其他配置 |
官方补充说明,load 是"近似"恢复:文件里有的参数会被设回去,但文件里没有的参数取当前固件的默认值,如果固件升级后默认值变了,结果会和当初不完全一样。
六、恢复默认值
按影响范围从小到大:
| 方法 | 范围 |
|---|---|
param reset 参数名(可用末尾通配符) | 只恢复指定参数 |
| QGC Reset to vehicle's configuration defaults | 恢复为当前机架的默认值 |
param set SYS_AUTOCONFIG 1 后 reboot | 下次启动时恢复为机架默认值 |
QGC Reset all to firmware defaults 或 param reset_all | 全部恢复为固件默认值 |
param reset_all 后面可以跟要排除的参数,例如保留全部校准参数:
param reset_all CAL_*
官方给出的更换机架并加载其默认参数的示例(4001 是 x500 四旋翼的机架编号):
param set SYS_AUTOSTART 4001
param set SYS_AUTOCONFIG 1
reboot
【注意】 > 恢复为固件默认值后,机架选择、传感器校准、遥控校准、电机映射、电池和失控保护设置都会丢失,相当于一台新飞控。之后要按 QGC 首次配置的完整流程重新做一遍,执行器测试必须拆桨。
七、新手最常改的参数
下表的默认值摘自 PX4 main 分支参数参考。失控保护相关参数(低电量、遥控丢失、圆柱围栏)已在本专区的 QGC 首次配置教程中讲过,这里不再重复。
1. 速度与倾角(手感)
| 参数 | 含义 | 默认值 |
|---|---|---|
MPC_XY_VEL_MAX | 所有速度控制模式下的水平速度绝对上限 | 12 m/s |
MPC_VEL_MANUAL | 位置模式下摇杆打满的最大水平速度,必须小于上一项 | 10 m/s |
MPC_XY_CRUISE | 任务、返航等自主模式的默认水平速度 | 5 m/s |
MPC_Z_VEL_MAX_UP | 最大上升速度(手动模式满杆对应它) | 3 m/s |
MPC_Z_VEL_MAX_DN | 最大下降速度 | 1.5 m/s |
MPC_MAN_TILT_MAX | 自稳、定高模式的最大倾角 | 35° |
MPC_ACC_HOR_MAX | 最大水平加速度,影响刹车距离 | 5 m/s² |
新手练习时,可以先把 MPC_VEL_MANUAL 调低,例如 3–5 m/s,熟练后再放开。
2. 起飞与降落
| 参数 | 含义 | 默认值 |
|---|---|---|
MIS_TAKEOFF_ALT | 起飞模式和任务起飞的默认目标高度 | 2.5 m |
MPC_TKO_SPEED | 起飞爬升速度 | 1.5 m/s |
MPC_LAND_SPEED | 降落最后阶段的下降速度 | 0.7 m/s |
MPC_LAND_ALT1 / MPC_LAND_ALT2 | 两级减速降落的高度,前者必须大于后者 | 10 m / 5 m |
COM_DISARM_LAND | 着陆后自动上锁的延时,0 或负数为不自动上锁 | 2 s |
COM_DISARM_PRFLT | 解锁后多久没起飞就自动上锁,负数为关闭 | 10 s |
【注意】 > 不要关闭
COM_DISARM_LAND和COM_DISARM_PRFLT这两项自动上锁。解锁状态的电机随时可能因误碰油门而转动,螺旋桨高速旋转会造成严重伤害。
3. 返航与任务
| 参数 | 含义 | 默认值 |
|---|---|---|
RTL_RETURN_ALT | 返航最低高度(相对目的地) | 60 m |
RTL_DESCEND_ALT | 到达后先降到的高度 | 30 m |
RTL_LAND_DELAY | 在上一高度停留的秒数,-1 为不降落一直悬停 | 0 s |
RTL_TYPE | 返航方式,0 为直飞最近的 Home 或集结点 | 0 |
NAV_ACC_RAD | 航点接受半径 | 10 m |
MPC_YAW_MODE | 自主模式机头朝向,0 为朝向航点 | 0 |
返航高度要按场地最高障碍物和当地法规限制来设,详见本专区的任务规划教程。
4. 电池估算
| 参数 | 含义 | 默认值 |
|---|---|---|
BAT1_N_CELLS | 电池节数,0 为未知 | 0 |
BAT1_V_CHARGED | 单节满电电压 | 4.2 V |
BAT1_V_EMPTY | 单节空电电压 | 3.6 V |
BAT1_CAPACITY | 电池容量(mAh),用于电流积分估算,-1 为不用 | -1 |
官方电池设置文档建议:满电电压比标称最高电压略低(锂聚合物 4.05 V 是 QGC 中的默认值),BAT1_CAPACITY 填标称容量的约 90%。这几项通常在 QGC 的 Power 页设置。节数填错会让电量估算完全错误,进而让低电量保护失效。
5. 日志与滤波
| 参数 | 含义 | 默认值 |
|---|---|---|
SDLOG_MODE | 何时记录日志,0 为解锁到上锁 | 0 |
SDLOG_PROFILE | 记录哪些话题(位掩码),1 为默认集 | 1 |
IMU_GYRO_CUTOFF | 陀螺仪低通滤波截止频率 | 40 Hz |
IMU_DGYRO_CUTOFF | D 项(角加速度)滤波截止频率 | 20 Hz |
滤波参数只在看过日志、确认振动已经从机械上尽量减小之后再动,日志分析方法见本专区的飞行日志教程。
八、日志里也有参数
每个 ULog 日志都记录了飞行时的全部参数。飞完发现异常时,可以用 pyulog 导出那次飞行的参数,和现在的参数对比:
pip install pyulog
ulog_params flight.ulg params_at_flight.txt
这也是一种"被动备份":即使忘了导出,只要有日志,就能查到当时每个参数的值。
九、常见问题
| 现象 | 原因与处理 |
|---|---|
| 改了参数没效果 | 该参数需要重启,看 QGC 工具栏是否有重启提示 |
| 搜不到教程里的参数 | 版本不同或参数依赖其他参数,见第二节 |
| 参数下载一直卡住 | 数传链路质量差时常见,换 USB 连接,或参考 QGC 官方的参数下载故障排除页面 |
| 导入参数后飞机姿态异常 | 校准值被另一台飞机的覆盖,重新校准全部传感器 |
| 不知道自己改过哪些 | QGC 勾选 Show modified only,或控制台 param show -c |
参考资料
- PX4 查找与修改参数:https://docs.px4.io/main/en/advanced_config/parameters.html
- PX4 参数与配置(param 命令):https://docs.px4.io/main/en/advanced/parameters_and_configurations.html
- PX4 param 模块说明:https://docs.px4.io/main/en/modules/modules_command.html#param
- PX4 参数参考:https://docs.px4.io/main/en/advanced_config/parameter_reference.html
- PX4 电池估算设置:https://docs.px4.io/main/en/config/battery.html
- QGC 参数页:https://docs.qgroundcontrol.com/master/en/qgc-user-guide/setup_view/parameters.html
- QGC 参数文件格式:https://docs.qgroundcontrol.com/master/en/qgc-dev-guide/file_formats/parameters.html
- pyulog:https://github.com/PX4/pyulog
评价 (0)