1. PX4参数系统概述：什么是参数、参数在飞控中的作用、参数与固件的关系

各位同学好，我是你们的老朋友。咱们这门课叫《PX4飞控参数原理解析》，第一节课，得先把地基打牢。

什么是参数？说白了，就是飞控固件里那些你可以改的数字、开关、选项。你想想看，一架四旋翼和一架固定翼，硬件可能差不多，但飞起来的感觉天差地别。区别在哪？就在参数里。

1.1 什么是参数？

参数，在PX4里就是一个有名字、有类型、有默认值的变量。它存储在飞控的EEPROM或者SD卡上，掉电不丢失。每次飞控启动，固件会把这些值读出来，决定怎么飞。

我举个例子，你打开QGroundControl，点开参数列表，会看到一堆像 MC_ROLL_P、MPC_XY_VEL_MAX 这样的名字。这些就是参数。

每个参数都有几个关键属性：

• 名称：唯一标识，比如 MC_ROLL_P，不能重复。
• 类型：整型、浮点型、布尔型、枚举型。你没法给一个布尔参数填3.14，系统会报错。
• 默认值：固件编译时写死的，第一次烧录或者参数重置后就是这个值。
• 取值范围：最小值、最大值、步长。防止你手滑填了个离谱的数。
• 描述：一段简短说明，告诉你这个参数是干嘛的。

我记得刚接触PX4那会儿，看到参数列表里上千个参数，头都大了。后来才明白，其实大部分参数你根本不用动，只有几十个核心参数需要理解。

1.2 参数在飞控中的作用

参数的作用，我总结成三句话：

1. 调参调姿态：PID增益、滤波器截止频率、限幅值。这些决定了飞机稳不稳、跟不跟手。
2. 配置硬件：传感器方向、PWM输出频率、GPS型号。飞控不知道你焊了啥传感器，你得告诉它。
3. 切换模式：定高、悬停、返航、降落。不同模式对应不同的参数组。

你想想看，没有参数系统会怎样？每次想改个PID，都得重新编译固件、烧录。那开发效率得多低？我早期做飞控原型时就是这么干的，改个Kp值，编译五分钟，烧录一分钟，飞起来发现调过了，再来一遍……那滋味，谁试谁知道。

参数还有一个容易被忽略的作用——调试诊断。PX4里有一类参数叫“参数调试”，比如 IMU_GYRO_CUTOFF，你可以动态改它，观察传感器数据的变化，判断问题出在哪。我曾经遇到过一架飞机，悬停时高频抖动，查了半天，最后发现是陀螺仪低通滤波参数设得太低了，高频噪声没滤干净。

1.3 参数与固件的关系

参数和固件的关系，有点像“菜谱”和“厨师”。固件是厨师，知道所有做菜的步骤；参数是菜谱，告诉厨师今天盐放多少、火开多大。同一个厨师，换本菜谱，就能做出不同的菜。

具体到代码层面，参数在固件里是这样工作的：

• 固件启动时，从存储介质（SD卡或EEPROM）加载参数到内存。
• 飞行过程中，各个模块（姿态控制、位置控制、导航）通过参数API读取当前值。
• 用户通过地面站修改参数后，固件会收到更新通知，实时生效（部分参数需要重启）。

这里有个关键点：参数不是固件的一部分。你编译固件时，参数默认值确实写在代码里，但一旦你修改了参数，飞控上存的就是新值，跟固件里的默认值没关系了。所以有时候你升级固件，发现参数变了，那是因为新固件改了默认值，但你飞控上存的是旧值，不会自动覆盖。

为了让你更直观地理解参数在固件中的位置和作用，我画了一张图：

从这张图你能看到，参数系统就像一个“中间人”。左边是固件的各个功能模块，它们需要参数才能工作；右边是存储介质和地面站，负责参数的持久化和修改。参数系统核心负责读写、校验、通知更新。

嗯，这里要注意：不是所有参数修改后都能立即生效。有些参数（比如混控器配置、传感器方向）需要重启飞控才能重新加载。这类参数在QGC里会标一个“需要重启”的图标。

1.4 参数的生命周期

一个参数从出生到消亡，大概经历这几个阶段：

阶段	说明	示例
定义	在固件源码中声明，指定名称、类型、默认值、范围	PARAM_DEFINE_FLOAT(MC_ROLL_P, 0.15f)
编译	编译时生成参数元数据表，烧录进固件	生成 .params 文件
加载	飞控启动时从存储介质读取，若无则用默认值	首次烧录时自动写入默认值
使用	飞行过程中各模块实时读取	控制循环每2ms读一次
修改	用户通过地面站修改，参数系统校验后写入存储	QGC修改后点“保存”
重置	用户手动重置为固件默认值	QGC“重置为默认值”

这个生命周期，你理解透了，后面调参时遇到“参数改了没生效”、“参数丢了”、“参数冲突”这些问题，就能快速定位。

1.5 为什么你要学参数原理？

可能有同学会问：“我直接用QGC调参不就行了？学原理干嘛？”

我跟你讲，只靠界面调参，你永远是个“调参侠”。遇到飞机抖，你调PID；遇到偏航，你调PID；遇到炸鸡，你还是调PID。但问题可能根本不在PID上——可能是传感器滤波参数不对，可能是混控器映射错了，可能是安全参数触发了保护。

我见过太多人，飞机飞不稳，上来就调 MC_ROLL_P，结果越调越糟。其实只要看一眼 IMU_GYRO_CUTOFF 和 IMU_ACCEL_CUTOFF，问题就解决了。