1. ArduPilot参数系统概述：什么是参数、参数在飞控中的角色、参数与变量的区别
各位同学，欢迎来到《ArduPilot参数系统深度解析与远程调参实战》的第一课。
咱们今天聊点最基础，但也最容易被忽视的东西——参数。我见过太多新手，上来就对着Mission Planner一顿猛改参数，结果飞机上天就翻跟头。说白了，参数系统是飞控的灵魂，不理解它，你永远只是个“调参工”，而不是“飞控工程师”。
1.1 什么是参数？
在ArduPilot里，参数（Parameter）就是一个有名字、有类型、有默认值、可持久化存储的配置项。你可以把它想象成飞控的“基因”——它决定了飞控的行为方式。
举个例子：
// 这是一个典型的参数定义
// 参数名：RTL_ALT
// 类型：浮点数（厘米）
// 默认值：1500（即15米）
// 范围：0 - 8000
// 说明：返航时目标高度
我个人习惯把参数比作“旋钮”。每个旋钮控制飞控的一个方面：姿态响应快慢、GPS融合权重、电机输出限幅……你拧动旋钮，飞控的行为就跟着变。
参数有几个关键特征：
- 持久化：参数保存在飞控的EEPROM或SD卡里，断电不丢失
- 可远程修改：通过数传、MAVLink协议，你可以在地面站实时修改参数
- 有范围约束：每个参数都有最小值和最大值，防止你设置离谱的值
- 有默认值：ArduPilot为每个参数提供了合理的默认值，新手可以直接飞
核心认知：参数是飞控的“静态配置”，它在编译时被定义，在运行时被读取，但不会在运行时被自动改变（除非你主动修改它）。
1.2 参数在飞控中的角色
参数在飞控里到底扮演什么角色？我总结了三层作用：
第一层：硬件适配层
飞控板子千千万，传感器型号各不同。参数告诉飞控：你用的是哪款IMU？GPS挂在哪个串口？电调协议是PWM还是DShot？
比如：
GPS_TYPE：选择GPS型号（1=UBlox, 2=NMEA, 5=UART）SERIAL1_PROTOCOL：串口1的协议（1=MAVLink, 2=GPS, 5=ESC）INS_GYRO_FILTER：陀螺仪低通滤波频率
嗯，这里要注意：硬件适配层的参数一旦设错，飞控可能直接不工作。我遇到过有人把GPS_TYPE设成2（NMEA协议），但实际用的是UBlox，结果搜星永远为0。排查了半天才发现是参数问题。
第二层：飞行行为层
这一层决定了飞机怎么飞。是暴力3D还是平稳航拍？返航高度多少？失控保护怎么处理？
典型参数：
ATC_ANG_RLL_P：横滚角控制P增益，越大响应越快WPNAV_SPEED：航点飞行速度（cm/s）FS_ACTION：信号丢失时的动作（0=悬停, 1=降落, 2=返航）
我曾经帮一个飞友调四轴，他抱怨飞机“晃得厉害”。我一看参数，ATC_ANG_RLL_P被设成了0.8，而默认才0.2。这相当于把方向盘灵敏度调到了最高，能不晃吗？
第三层：高级功能层
ArduPilot有很多高级功能，比如光流、避障、RTK定位、空中加油（是的，你没看错）。这些功能都需要通过参数来启用和配置。
例如：
FLOW_ENABLE：启用光流传感器AVOID_ENABLE：启用避障功能GPS_RTK_CFG：RTK配置
我的经验：调参时，建议每次只改1-2个参数，然后试飞验证。一次改10个参数，出了问题你根本不知道是哪个引起的。我曾经就吃过这个亏，改了一堆参数后飞机乱飞，最后只能恢复默认值重新来。
1.3 参数与变量的区别
这个问题我问过很多学员，能答清楚的没几个。你想想看，参数和变量不都是存数据的吗？有什么区别？
区别大了去了。我画个表格你就明白了：
| 对比维度 | 参数（Parameter） | 变量（Variable） |
|---|---|---|
| 存储位置 | EEPROM / SD卡（持久化） | RAM（掉电丢失） |
| 生命周期 | 跨重启、跨飞行 | 每次上电重新初始化 |
| 修改方式 | 通过地面站、MAVLink、命令行 | 代码内部赋值 |
| 作用域 | 全局可见，所有模块都能读取 | 局部或全局，取决于定义位置 |
| 命名规则 | 固定格式：模块名_名称（如RTL_ALT） | C语言变量命名规则 |
| 类型约束 | 有严格类型检查（INT8, FLOAT等） | 类型由定义决定 |
| 运行时变化 | 通常不变，除非主动修改 | 随时可能变化 |
说白了，参数是“配置”，变量是“状态”。
举个例子：RTL_ALT这个参数，你设成1500（15米），它就一直不变。但飞控内部有个变量叫current_loc.alt，它每秒钟变化几百次，因为飞机在动啊。
再深入一点，看看代码里是怎么用的：
// 参数定义（在参数表中）
// 这是静态的，编译时就确定了
AP_GROUPINFO("ALT", 0, RTL, alt, 1500);
// 运行时使用
// 读取参数值（不会变）
float target_alt = g.rtl.alt;
// 变量（实时变化）
float current_alt = ahrs.get_home().alt + ahrs.get_relative_position_NED().z;
避坑指南：我曾经见过有人试图在飞行中通过修改参数来改变行为，比如把WPNAV_SPEED从500改成1000。虽然参数确实可以空中修改，但有些参数修改后需要重启飞控才能生效。更危险的是，有些参数修改后飞控会重新初始化相关模块，导致瞬间失控。所以，空中改参要谨慎，不是所有参数都能热修改。
1.4 参数系统的整体架构
为了让你更直观地理解参数系统，我画了一张架构图：
这张图展示了参数系统的完整链路：地面站通过MAVLink协议发送参数修改请求 → 参数管理模块接收并验证 → 写入EEPROM或SD卡 → 参数表更新 → 各功能模块读取新参数 → 飞控行为改变。
你可能会问：为什么参数表要放在中间？因为它是“单点真相”。所有模块都从参数表读取配置，而不是各自维护一份。这样保证了数据一致性，也方便调试。
总结一下：参数是飞控的静态配置，变量是飞控的动态状态。参数决定了飞控“应该怎么做”，变量反映了飞控“正在怎么做”。理解这个区别，是你成为飞控工程师的第一步。
好了，这一章就到这里。记住我今天说的：参数是飞控的基因，改参数就是改基因。下一章我们会深入参数系统的内部实现，看看ArduPilot是怎么管理这成百上千个参数的。
课后小作业：打开你的Mission Planner，连接飞控后看看参数列表。随便找一个参数，比如RTL_ALT，看看它的类型、范围、默认值。然后想想：如果我把这个参数改成0，飞控会怎么反应？
公众号:蓝海资料掘金营，微信deep3321