简介：这份文档面向无人机、航模飞控调试的入门与进阶用户，针对 Mission Planner 地面站参数树条目繁多、英文术语晦涩、新手难以快速定位关键项的痛点，对常用参数逐条进行中文翻译与要点归纳，可作为对照调参时的速查手册。资源包内仅含 1 个 docx 文件，约 75KB，按参数名、默认值、取值范围与功能说明的格式编排，便于检索与横向比对。内容覆盖 ACRO 特技模式的姿态锁定与角速度限制、ADSB 广播式监视系统的启用与行为配置、AFS 高级失效保护的高度限制、通讯与 GPS 丢失阈值、终止动作及心跳引脚设定，以及 AHRS 姿态估计中 GPS 增益、最小卫星数、主板安装朝向、加速度计修正速率与罗盘偏航参与度等核心条目，并附有 QNH 气压、地速空速差异等细节解释。目前已有 9996 人学习下载，适合希望摆脱逐条查英文文档、快速建立参数体系认知的飞控调试者参考。
1. 参数树不是字典：为什么我劝你先搞懂这四类参数再动手
刚拿到一份 Mission Planner 全参数翻译文档时，很多人的第一反应是把它当字典用——遇到哪个参数不认识就翻哪个。我一开始也这么干，结果在一次固定翼调试里翻了车：飞机在 AUTO 模式下突然切到 RTL，查了半天日志才发现是FS_LONG_ACTN和FS_SHORT_ACTN两个失效保护参数在打架。那份翻译文档里每个参数都写得很清楚，但我没搞懂它们之间的联动关系。
这份资源的核心价值不在于“翻译”，而在于把散落在参数树里的几百个参数按功能域重新组织，让你看到参数之间的因果链。它覆盖了 ArduPilot 体系下固定翼/多旋翼的完整参数集，从ACRO_*特技模式到AFS_*高级失效保护，从AHRS_*姿态估计到ARSPD_*空速校准，再到BATT_*电源监控和COMPASS_*罗盘补偿。适合两类人：一是刚接触 Mission Planner 地面站、面对参数树一脸茫然的新手；二是飞了一段时间但调参靠玄学、炸机后找不到原因的老手。如果你正在用 Pixhawk 或同类飞控做固定翼航测、多旋翼巡检，这份对照表能帮你把“猜参数”变成“查参数”。
2. 姿态与导航参数：AHRS 和 COMPASS 的联动逻辑
2.1 AHRS_ORIENTATION 与 COMPASS_ORIENT 的配合关系
AHRS_ORIENTATION是飞控板在机架上的安装朝向，COMPASS_ORIENT是罗盘相对飞控板的朝向。这两个参数最容易搞混。常见做法是：先确定飞控板怎么装在机架上，把AHRS_ORIENTATION设对；如果用的是外置罗盘，再根据罗盘实际安装方向设COMPASS_ORIENT。文档里列了 38 种朝向组合，从0:None到37:Roll90Yaw270，覆盖了绝大多数安装场景。
我一般会这样验证：把飞机机头指向正北，在 Mission Planner 的罗盘校准页面看 X 轴读数是否接近 0、Y 轴是否为正。如果 X 轴有大读数，说明COMPASS_ORIENT没设对。注意AHRS_ORIENTATION修改后必须重启飞控，而且重启前要把设备放水平，否则姿态估计会漂。
2.2 AHRS_GPS_GAIN 和 AHRS_GPS_MINSATS 的边界
AHRS_GPS_GAIN控制 GPS 数据参与姿态估计的权重，默认 1.0。文档里有一句警告很关键：固定翼飞机请勿设置为 0，否则将导致失控。原因是固定翼没有多旋翼那种快速姿态修正能力，GPS 速度数据是抑制加速度计漂移的重要来源。AHRS_GPS_MINSATS默认 6，意思是至少 6 颗星才用 GPS 速度修正姿态。如果你在峡谷或城市楼宇间飞，卫星数经常掉到 5 以下，这时候姿态修正会退化为纯惯导，几分钟后航向就会漂到没法看。
# 通过 MAVLink 查看当前 GPS 卫星数和 AHRS 状态 # 在 Mission Planner 的 MAVLink Inspector 里查看 GPS_RAW_INT.satellites_visible # 以及 AHRS2 的 roll/pitch/yaw 与 GPS 速度的偏差参数调整建议：如果飞行环境遮挡严重，可以把AHRS_GPS_MINSATS降到 5，但不要低于 5。同时把AHRS_GPS_GAIN保持在 1.0，不要试图用降低增益来“平滑”姿态，那只会让漂移更严重。
2.3 COMPASS_MOT 系列：电机干扰补偿的实操
COMPASS_MOT_X/Y/Z是电机磁场干扰补偿系数，单位是“偏移量每安培”或“全油门时的偏移量”。COMPASS_MOTCT决定补偿类型：0 禁用、1 油门值补偿、2 电流值补偿。如果你用的是电流计，选 2 更准，因为磁场干扰和电流成正比，而电流和油门不是线性关系。
常见做法是：先做罗盘校准，然后在地面推油门到 100%，观察罗盘读数变化。如果 X 轴读数变化超过 30 毫高斯，就需要启用COMPASS_MOTCT=2并让飞控自动学习补偿值。注意COMPASS_MOT2_*和COMPASS_MOT3_*是给第二、第三罗盘用的，如果你只用一个外置罗盘，不用管这些。
3. 失效保护与飞行模式：AFS 和 FS 参数的安全链
3.1 AFS_TERM_ACTION 的“魔数 42”到底该不该用
AFS_TERM_ACTION设为 42 时，飞机会在所有舵面执行最大打舵并收 0 油门，故意让自己坠机。这个参数在文档里写得很直白，但实际使用要非常谨慎。我见过有人在室内测试时误设了 42，结果飞机直接撞墙。这个功能的设计场景是：当飞机失控飞向人群或禁飞区时，主动坠毁是最后手段。普通航模玩家建议保持默认 0，不要碰这个参数。
如果你确实需要这个功能，必须配合AFS_ENABLE=1和AFS_TERM_PIN使用。AFS_TERM_PIN指定一个数字 IO 口，飞行终止后输出高电平，可以触发外部失效保护板。注意AFS_HB_PIN是心跳信号引脚，以 10Hz 翻转，用来让外部板子区分“飞控崩溃”和“主动终止”。
3.2 FS_SHORT_ACTN 和 FS_LONG_ACTN 的触发条件差异
短时失效保护由遥控信号丢失或地面站失联触发，长时失效保护由持续超过FS_LONG_TIMEOUT秒的失效触发。文档里FS_LONG_TIMEOUT默认值写的是 5 秒，但正文里又说“默认值 20 秒”，这里以参数表为准，实际固件版本不同可能有差异，建议在 Mission Planner 里看当前值。
关键区别在于动作：FS_SHORT_ACTN在自稳和手动模式下切到盘旋，FS_LONG_ACTN在同样模式下切到返航。如果你飞的是自动任务，FS_LONG_ACTN=0会让飞机继续任务，=1切返航，=2切 FBWA。我一般设FS_SHORT_ACTN=1、FS_LONG_ACTN=1、FS_LONG_TIMEOUT=20，这样短时失联先盘旋等人接管，长时失联直接返航。
3.3 FLTMODE_CH 和六段飞行模式的映射
FLTMODE_CH默认 8，对应遥控器第 8 通道。FLTMODE1到FLTMODE6分别对应开关的六个位置，PWM 范围在文档里写得很清楚：位置 1 是 910-1230，位置 2 是 1231-1360，以此类推。常见做法是把FLTMODE1设为 Manual（0），FLTMODE2设为 FBWA（5），FLTMODE3设为 AUTO（10），FLTMODE4设为 RTL（11），FLTMODE5设为 Loiter（12），FLTMODE6设为 Guided（15）。
注意FLTMODE6的 PWM 范围是 1750-2049，有些遥控器的六段开关最高位只到 2000，这时候需要在地面站里微调端点。如果模式切换不生效，先看遥控器通道监视器里的 PWM 值是否落在对应区间。
4. 空速、电源与混控：ARSPD、BATT 和 ELEVON 的调参细节
4.1 ARSPD_RATIO 和 ARSPD_AUTOCAL 的校准流程
ARSPD_RATIO是空速计校准比率，默认 1.9936。ARSPD_AUTOCAL=1时，飞控会在飞行中基于地速和空速的估计滤波器自动调整比率，变化超过 5% 就每 2 分钟存一次 EEPROM。我一般先在地面做一次空速计校准：用嘴对着皮托管吹气，看 Mission Planner 里空速读数是否跟吹气力度成正比。如果读数跳变，检查ARSPD_TUBE_ORDER设置。
ARSPD_TUBE_ORDER默认 2，意思是接受任意连接顺序。但如果你发现空速读数在静止时有明显正偏差，可能是静压管和动压管接反了。这时候设ARSPD_TUBE_ORDER=0或1来指定顺序。注意ARSPD_PIN在 Pixhawk 上必须设为 15，在 APM2 上是 0-9，在 PX4 上是 11，设错了空速计完全不工作。
4.2 BATT_AMP_PERVOLT 和 BATT_VOLT_MULT 的实测方法
BATT_AMP_PERVOLT默认 17，意思是电流传感器输出 1V 对应 17A。BATT_VOLT_MULT默认 10.1，意思是电压传感器引脚电压乘以 10.1 得到实际电压。这两个参数必须根据你的电源模块实测调整。常见做法是：用万用表测电池实际电压，对比 Mission Planner 显示的电压，如果偏差超过 0.2V，按比例调整BATT_VOLT_MULT。电流校准需要钳形表，在地面推油门到一定值，对比显示电流和实测电流。
# 电压校准公式 # 新 BATT_VOLT_MULT = 旧值 * (万用表读数 / 地面站显示电压) # 例如：旧值 10.1，万用表 12.6V，显示 12.2V # 新值 = 10.1 * (12.6 / 12.2) = 10.43注意BATT_CURR_PIN和BATT_VOLT_PIN在不同硬件上取值不同：APM2.5 电源模块电流引脚是 12、电压引脚是 13；Pixhawk 电源模块电流引脚是 3、电压引脚是 2；PX4 是 101 和 100。设错了要么读数为零，要么读数乱跳。
4.3 ELEVON_MIXING 和 FLAPERON_OUTPUT 的共存限制
ELEVON_MIXING和FLAPERON_OUTPUT不能同时启用，文档里写得很明确。如果你飞的是飞翼，用ELEVON_OUTPUT做升降副翼混控；如果是常规布局带襟副翼，用FLAPERON_OUTPUT。ELEVON_OUTPUT有四种混控模式：上-上、上-下、下-上、下-下，对应不同的舵机映射方式。
我踩过的坑是：在 APM1 上启用ELEVON_OUTPUT前没有把FLTMODE_CH从 8 改走，导致通道 8 的手动控制直接穿透到舵机，混控完全失效。如果你用 APM1，务必先把FLTMODE_CH设为非 8 通道。另外MIXING_GAIN参数决定输出增益，默认 0.5，如果舵面行程不够可以适当加大，但不要超过 0.8，否则舵机可能堵转。
5. 避坑与排查：五个让我炸过机的参数组合
5.1 现象：AUTO 模式下飞机突然切 RTL，日志显示 FS_LONG_ACTN 触发
原因：FS_LONG_TIMEOUT设得太短，数传信号偶尔丢包超过阈值就触发长时失效保护。文档里默认值在不同固件版本间有差异，有的写 5 秒，有的写 20 秒。如果设成 5 秒，在数传距离边缘飞行时几乎必然误触发。
解决：把FS_LONG_TIMEOUT设为 20 秒以上，同时把FS_GCS_ENABL设为 1 而不是 2。设为 2 时，地面站没有收到 RADIO_STATUS 也会触发失效保护，在单链路数传不对称噪声下容易误判。
5.2 现象：空速读数在地面静止时显示 5-8 m/s，起飞后空速异常导致油门控制震荡
原因：ARSPD_OFFSET没有校准，或者ARSPD_TUBE_ORDER设错导致静压和动压接反。文档里ARSPD_OFFSET默认 2.333235，但这是某个特定硬件的值，你的空速计需要重新校准。
解决：在地面静止状态下执行空速计校准，让ARSPD_OFFSET自动更新。如果校准后静止读数仍然不为零，检查皮托管是否被遮挡，或者设ARSPD_TUBE_ORDER=0/1手动指定顺序。
5.3 现象：罗盘校准后航向仍然漂移，电机一转航向就偏
原因：COMPASS_MOTCT设为 0 禁用了电机干扰补偿，或者COMPASS_MOT_X/Y/Z没有学习。文档里COMPASS_MOTCT默认 0，但实际使用中电机磁场对罗盘的影响很大，尤其是大电流多旋翼。
解决：设COMPASS_MOTCT=2（电流补偿），在地面推油门让飞控自动学习补偿值。如果用的是外置罗盘，确保COMPASS_EXTERNAL=1，并且罗盘远离电源线。
5.4 现象：解锁时电机不转，地面站显示 ARMING_CHECK 失败
原因：ARMING_CHECK默认值在不同固件里可能是 0 或 1。文档里写默认不检查，但有些版本默认开启全部检查。如果ARMING_CHECK=1，任何一项检查不通过都无法解锁。
解决：在 Mission Planner 的解锁检查页面看具体哪项失败。常见的是 GPS 没锁定（ARMING_CHECK包含 8）或罗盘没校准（包含 4）。临时解锁可以把ARMING_CHECK设为 0，但飞行前务必恢复。
5.5 现象：返航时飞机不爬升到 ALT_HOLD_RTL 设定高度，直接平飞回来
原因：ALT_HOLD_RTL设成了负数（通常是 -1），文档里写负数意味着维持当前高度。如果你想要固定返航高度，必须设正值，单位是厘米。比如想返航到 100 米，设 10000。
解决：把ALT_HOLD_RTL设为正值，同时注意ALT_MIX默认 1（100% 气压计），不要改成 0。文档里强烈建议不要动ALT_MIX，因为 GPS 高度数据不可靠，只有从高空气球投放等特殊场景才需要改。
6. 从参数表到飞行日志：用 MAVLink Inspector 验证调参效果
调完参数不是终点，验证才是。我习惯在每次调参后飞一个固定航线，然后用 Mission Planner 的 MAVLink Inspector 看几个关键消息：ATTITUDE看姿态跟踪是否平滑，GPS_RAW_INT看卫星数和 HDOP，VFR_HUD看空速和地速的差值，SYS_STATUS看电池电压和电流。如果VFR_HUD里空速和地速在无风天差值超过 3 m/s，说明ARSPD_RATIO还需要微调。
# 用 pymavlink 解析飞行日志，提取关键参数变化 from pymavlink import mavutil # 连接日志文件 log = mavutil.mavlink_connection('flight_log.bin') # 提取 ATTITUDE 和 VFR_HUD 消息 attitude_data = [] vfr_data = [] while True: msg = log.recv_match(type=['ATTITUDE', 'VFR_HUD']) if msg is None: break if msg.get_type() == 'ATTITUDE': attitude_data.append((msg.time_boot_ms, msg.roll, msg.pitch, msg.yaw)) elif msg.get_type() == 'VFR_HUD': vfr_data.append((msg.time_boot_ms, msg.airspeed, msg.groundspeed, msg.alt)) # 计算空速和地速差值 for t, air, ground, alt in vfr_data: diff = abs(air - ground) if diff > 3.0: print(f"时间 {t}ms: 空速 {air:.1f} m/s, 地速 {ground:.1f} m/s, 差值 {diff:.1f} m/s")这段脚本用 pymavlink 读取.bin日志，提取ATTITUDE和VFR_HUD消息，然后计算空速和地速的差值。如果差值持续超过 3 m/s，说明空速计校准有问题。参数说明：time_boot_ms是飞控启动后的毫秒数，airspeed是校准后空速，groundspeed是 GPS 地速。注意在强风天这个差值会自然增大，要在无风或微风天验证。
另一个技巧是用 Mission Planner 的“图表”功能叠加ATTITUDE.roll和RC_CHANNELS.chan1，看横滚输入和实际姿态的跟随延迟。如果延迟超过 200ms，可能是AHRS_RP_P设得太低，默认 0.2，可以试着加到 0.25，但不要超过 0.4，否则姿态会震荡。
从那以后我每次调完参数，都会先在地面做一次完整的舵面和传感器检查，再飞一个短航线看日志，确认没有异常才敢飞长航线。这份参数翻译文档我放在平板里，现场调参时随时翻，比在手机小屏幕上搜论坛快得多。希望帮到你。
本文还有配套的精品资源，点击获取
