简介这份文档面向飞控开发与无人机调试人员系统整理了 Mission Planner 中各类飞行模式的中文参数说明帮助读者摆脱英文参数表的理解障碍快速定位并调整关键参数。内容覆盖 ACRO 特技模式的姿态锁定与俯仰、横滚角速度ADSB 模式行为控制AFS 高级失效保护系统的 AMSL 高度限制、地理围栏、心跳引脚与飞行终止动作以及 AHRS 姿态解算中的 EKF 类型、GPS 参与度、主板安装朝向等核心条目并附有取值范围与功能释义。资源包共 1 个 docx 文件约 66KB以表格化参数清单形式呈现便于按模式检索和对照调参。目前已有 4112 人学习适合需要逐项核对参数含义、排查失效保护配置或搭建调参笔记的飞控开发者参考使用。1. 一份被翻烂的调参速查表从 ACRO 到 COMPASS 的中文参数手册飞控调参最怕的不是参数多而是参数名看得懂、含义猜不透。尤其固定翼上电前那半小时一边翻英文文档一边对地面站一个AFS_TERM_ACTION设错试飞时就是直接坠机。这份《Mission Planner 所有飞行模式中文参数调参必备》把 ACRO、AFS、AHRS、ARSPD、BATT、COMPASS 等几大参数族的默认值、取值范围和中文释义逐条整理成文档本质是一张能对着地面站逐项核对的速查表。它适合刚接手固定翼调参的新手照着抄也适合熟手在改失效保护、空速计、罗盘补偿时快速回查边界值。下面按“先立概念、再动手、最后避坑”的顺序把这份文档怎么用讲透。2. 参数族怎么分组先分清哪些能碰、哪些别乱动拿到一份几百行的参数表第一反应不该是从头往下读而是先按“改动风险”分组。这份文档的参数大致能分成三类飞行姿态与导航类ACRO、AHRS、ALT、ARSPD、安全与失效保护类AFS、ARMING、BATT、CHUTE、外设与传感器类COMPASS、CAM、BRD。分组的意义在于姿态类参数改错顶多飞得别扭安全类参数改错可能直接触发空中终止外设类改错则是“看着正常、实际没生效”。2.1 按风险等级给参数贴标签我一般会在文档上做三色标记。绿色是“可以按机型微调”的比如ACRO_PITCH_RATE、ACRO_ROLL_RATE、AUTOTUNE_LEVEL、ALT_HOLD_RTL黄色是“必须和硬件对得上”的比如BATT_VOLT_PIN、BATT_CURR_PIN、ARSPD_PIN、COMPASS_EXTERNAL红色是“不懂就别动”的比如AFS_TERM_ACTION、AFS_AMSL_LIMIT、AHRS_ORIENTATION、ARMING_CHECK。这个分法的依据很实在绿色参数错了飞机还能飞回来黄色参数错了地面站读数全是假的你会基于假数据做判断红色参数错了飞控会在你没预期的时候执行终止或解锁逻辑。文档里AFS_TERM_ACTION那条写得很直白——设为魔数 42 就是“所有舵面最大打舵加 0 油门故意让自己坠机”这种参数在没搞懂之前碰它没有任何收益。2.2 默认值不是建议值是“出厂假设”文档每条参数都带了默认值但默认值成立是有前提的。BATT_AMP_PERVOLT默认 17前提是你用 3DR 电源模块BATT_VOLT_PIN默认 2前提是 Pixhawk 接电源模块。换一套硬件默认值就是错的。所以读这份表时默认值那一列的正确用法是“对照我的硬件判断这个默认值还成不成立”而不是“没想法就填默认”。一个典型翻车点ARSPD_PIN在文档里列了 APM2 用 0-9、APM1 用 64、PX4 用 11、Pixhawk 用 15、I2C 空速计用 65。如果你拿着 Pixhawk 却填了 11空速读数要么不动要么乱跳而你不会立刻意识到是引脚号错了只会怀疑空速计坏了。2.3 用表格把“硬件—参数”对应关系固定下来调参前建议先填一张硬件对照表把文档里黄色类参数逐项落到自己的配置上。下面这张表是常见组合的填法实际以你手上的硬件为准参数含义Pixhawk电源模块APM2.5电源模块PX4BATT_VOLT_PIN电压检测引脚213100BATT_CURR_PIN电流检测引脚312101BATT_VOLT_MULT电压换算系数10.110.11PX4IO 模块BATT_AMP_PERVOLT电流换算系数1717按模块ARSPD_PIN空速计引脚15按板型11 或 65这张表填完黄色参数基本就锁死了后面调姿态参数时不用再回头纠结硬件映射。文档里BATT_MONITOR那条也提醒了0 禁用、3 仅电压、4 电压和电流先确认监控类型再谈系数否则系数调得再准也没有数据来源。3. 失效保护与安全参数AFS 和 ARMING 怎么配才不误触发安全参数是这份文档里信息密度最高的部分也是最容易“配了等于没配”的部分。AFS_ENABLE设为 0 时文档明确写了“所有高级失效保护功能无效”——也就是说你在AFS_*下面调的任何值都不会生效。很多人调完一圈发现失效保护没动作根子就在这一条。3.1 AFS 的启用链条先开总闸再设分支AFS 相关参数存在依赖关系配置顺序应该是AFS_ENABLE置 1 → 按需开AFS_GEOFENCE、AFS_RC、AFS_DUAL_LOSS→ 再设阈值类参数。文档里AFS_RC_FAIL_TIME默认 0意味着遥控失效判定时间没设配合AFS_RC才有意义AFS_MAX_COM_LOSS和AFS_MAX_GPS_LOSS默认 0文档解释是“允许任意数目的失联事件”也就是不限制、不触发停止任务。一个可抄的保守配置思路数值按机型改逻辑不变# 通过 MAVLink 参数协议写入示例用 pymavlink # 先开总闸再设分支最后设阈值 param set AFS_ENABLE 1 param set AFS_GEOFENCE 1 param set AFS_RC 1 param set AFS_RC_FAIL_TIME 2 param set AFS_MAX_COM_LOSS 3 param set AFS_MAX_GPS_LOSS 3 param set AFS_TERM_ACTION 0这段配置的逻辑是启用 AFS 总开关打开地理围栏和遥控失效保护遥控失联 2 秒判定失效通讯和 GPS 各允许累计 3 次失联后停止任务恢复。AFS_TERM_ACTION保持 0即终止后不执行额外动作——这是最保守的选择魔数 42 那种“主动坠机”只在特定测试场景用。参数说明AFS_RC_FAIL_TIME单位是秒设太小会在信号抖动时误触发设太大则失效保护形同虚设AFS_MAX_COM_LOSS和AFS_MAX_GPS_LOSS的“累计”是跨整个上电周期算的不是单次任务这点文档没展开但实际排查时经常被忽略。3.2 高度限制的两个坑AMSL 与 QNH 单位不一致AFS_AMSL_LIMIT和AFS_QNH_PRESSURE是一对。文档特别提醒AFS_AMSL_LIMIT以米计而“气压高度限制通常以英尺来计”。如果你按英尺的习惯填了 400实际含义是 400 米限制比预期低了一大截飞机爬到一半就被终止。AFS_QNH_PRESSURE单位是毫米汞柱0 值禁用高度限制填之前先确认你的气压基准用的是毫米汞柱还是百帕。AFS_AMSL_ERR_GPS默认 -1文档解释是“气压计失灵会立即触发飞行终止”。这个 -1 不是“关闭”而是“零容错”。如果你希望气压计失灵后还能靠 GPS 高度撑一段需要把它设成正的误差裕量并且文档提到 OBC 用户应与安全盒保持一致——这条对做载荷控制的团队尤其重要飞控和安全盒的高度判定不一致会出现一方认为该终止、另一方还在正常飞的割裂状态。3.3 ARMING_CHECK 的位掩码别把“能解锁”当成“该解锁”ARMING_CHECK默认 1全部检查但文档正文里有一句容易看漏的话“默认选项是不检查允许任意时刻解锁”。这两处描述存在张力实际以你固件版本的参数说明为准配置时按位掩码自己算清楚。文档给的例子很实用要“GPS 锁定且人工遥控有效才允许解锁”设 72即 8GPS 64遥控发射机。位掩码的算法是把需要的检查项编码相加2 气压计、4 罗盘、8 GPS、16 惯导、32 参数、64 遥控、128 主板电压、256 电池等级。想全开就设 1想全关设 0。注意ARMING_REQUIRE设为 0 时“需要重启设备才能解锁”而且即便它为 0只要ARMING_CHECK非 0检查不通过照样解不了锁——这两个参数是“要不要解锁流程”和“解锁前查什么”两层别混为一谈。4. 姿态、空速与罗盘AHRS、ARSPD、COMPASS 的实操配置这三组参数决定飞控“知不知道自己朝哪、飞多快、航向对不对”是固定翼能不能稳定飞的基础。文档在这部分给的信息最细也最值得逐条对照。4.1 AHRS_ORIENTATION装反了不是靠这个参数救AHRS_ORIENTATION有 38 个取值从 0无旋转到 37Roll90Yaw270覆盖 45 度和 90 度步进的安装朝向。文档明确写了“这个参数将在下一次重启时生效重启前必须将设备放置水平”。实操里最常见的错误是飞控装歪了 30 度想用这个参数凑但取值只有 45 度步进凑不上最后姿态还是偏。正确做法是物理安装尽量对齐这个参数只处理 45/90 度整数倍的朝向差异。另一个坑是AHRS_TRIM_X和AHRS_TRIM_Y单位弧度范围 ±0.1745约 ±10 度用来补偿机架和飞控板之间的横滚、俯仰差异。有人把安装歪斜全丢给 TRIM结果超过 10 度就设不进去还以为是参数坏了。TRIM 是微调ORIENTATION 是粗调顺序不能反。4.2 ARSPD 校准RATIO 和 OFFSET 不是拍脑袋填的空速计相关参数里ARSPD_RATIO默认 1.9936、ARSPD_OFFSET默认 2.333235这两个值因传感器而异不能照抄。文档提到ARSPD_AUTOCAL启用后飞控会在飞行中基于地速和实际空速的估计滤波器自动调整 RATIO变化超过 5% 会每隔 2 分钟存 EEPROM。这是个省事但需要耐心的过程先手动给一个接近的初值再开自动校准飞几个起落看收敛。ARSPD_TUBE_ORDER默认 2接受任意顺序文档解释了为什么有人会指定顺序指定后空速计能检测静压过大而静压过大可能被误读成正空速。如果你遇到“地面读数不为零、越飞越大”的怪现象先查皮托管接法再考虑把这个参数从 2 改成 0 或 1 来定位问题。ARSPD_USE设为 0 时空速数据不参与飞行控制但ARSPD_FBW_MAX和ARSPD_FBW_MIN仍然定义自动油门下的空速映射。文档给的默认 22 和 9 米/秒只是示例必须按你的机型失速速度和巡航速度重设范围都是 5 到 50。4.3 COMPASS外部罗盘和自动学习的边界COMPASS_EXTERNAL在 PX4 上自动识别在 APM2 上必须手动设 1。文档还提醒用了外罗盘COMPASS_ORIENT独立于AHRS_ORIENTATION两个朝向要分别设。COMPASS_LEARN启用后自动获取偏移但COMPASS_MOT_X/Y这类电机干扰补偿系数默认 0需要在实际通电、电机运转的状态下观察罗盘读数漂移再填范围 -1000 到 1000单位是“每安培偏移量或全油门偏移量”。COMPASS_AUTODEC启用后按 GPS 坐标自动算磁偏角COMPASS_DEC则是手动值单位弧度范围 -3.142 到 3.142。两者不要同时依赖自动能算准就别手填手填错了航向会整体偏一个固定角度飞起来就是“直线飞成弧线”。5. 避坑与排查五条血泪经验5.1 现象改了 AFS 参数失效保护完全不动作原因AFS_ENABLE还是 0或者AFS_RC、AFS_GEOFENCE等分支没开。文档写得很清楚总开关为 0 时所有高级失效保护无效。解决按 3.1 的链条顺序逐项确认改完重启再测。测试时不要真飞用地面站模拟遥控失联或 GPS 丢失看飞控是否按预期进入保护状态。5.2 现象高度限制在远低于设定值时就触发原因AFS_AMSL_LIMIT单位是米但配置时按英尺填了或者AFS_QNH_PRESSURE的基准压强单位搞错毫米汞柱 vs 百帕。解决把限制值换算成米重新填QNH 按文档要求用毫米汞柱0 表示禁用。改完在地面用气压模拟验证触发点。5.3 现象空速读数地面不为零空中越飞越大原因皮托管动静压接反或ARSPD_TUBE_ORDER设为 2 时掩盖了接法问题也可能是ARSPD_OFFSET没校准。解决先把ARSPD_TUBE_ORDER临时设为 0 或 1 定位接法重新做地面校准拿 OFFSET再开ARSPD_AUTOCAL让 RATIO 收敛。校准期间ARSPD_USE设 0别让错误空速进控制环。5.4 现象解锁失败地面站提示检查不通过原因ARMING_CHECK位掩码开了某项检查但对应条件不满足比如开了 GPS 检查8但室内没星或者ARMING_REQUIRE和ARMING_CHECK的组合理解反了。解决按位掩码逐项核对室内调试把 GPS 位去掉只留必要的罗盘和惯导检查。改ARMING_REQUIRE后记得重启。5.5 现象航向整体偏一个固定角度原因COMPASS_DEC手填了错误的磁偏角或COMPASS_ORIENT与外罗盘实际朝向不符。解决优先用COMPASS_AUTODEC自动计算关掉手填值外罗盘朝向按实际安装设COMPASS_ORIENT它和AHRS_ORIENTATION是两套独立配置。6. 把速查表变成检查单一次上电前的完整核对流程文档的价值不在“读一遍”而在“每次上电前走一遍”。我的习惯是把这份参数表裁成一张检查单按固定顺序过先硬件映射BATT、ARSPD、COMPASS 的 PIN 和 EXTERNAL再安全链条AFS_ENABLE 到各分支到阈值再姿态基准AHRS_ORIENTATION、TRIM最后空速与罗盘校准状态。这个顺序不能乱因为后面的判断依赖前面的数据可信。举个具体做法把关键参数导出成一份基线文件每次改动机型或硬件后重新导出对比。用 pymavlink 拉参数并和基线做 diff能快速看出哪些值被意外改动from pymavlink import mavutil # 连接飞控拉取全部参数 master mavutil.mavlink_connection(/dev/ttyUSB0, baud57600) master.wait_heartbeat() master.mav.param_request_list_send(master.target_system, master.target_component) params {} while True: msg master.recv_match(typePARAM_VALUE, blockingTrue, timeout5) if msg is None: break params[msg.param_id] msg.param_value # 与基线对比只打印差异项 baseline {...} # 上次确认过的参数快照 for k, v in params.items(): if k in baseline and abs(baseline[k] - v) 1e-6: print(f{k}: baseline{baseline[k]} current{v})这段脚本的逻辑是先请求全量参数列表逐条收进字典再和基线快照比对只输出有差异的项。参数说明param_request_list_send一次请求全部recv_match的 timeout 设 5 秒防止卡死比对阈值 1e-6 是为了过滤浮点传输误差。实际用的时候基线快照要按机型分开存别拿 A 机的基线去比 B 机。还有一个容易被忽略的验证点AHRS_GPS_GAIN文档明确写了“固定翼飞机请勿设置为 0否则将导致失控”默认 1.0。如果你在排查姿态问题时把它调成 0 做对照实验记得改回来并且改完重启。AHRS_GPS_USE设为 0 时 GPS 不参与导航只做盲预测正常飞行必须非零——这两条是文档里少有的带“失控”字样的警告值得单独标红。最后说个习惯。早些年我调完参数直接上电试飞觉得“地面站看着都对”。后来一次AFS_AMSL_ERR_GPS保持 -1 没注意气压计在低温下漂了一点飞控直接判定高度异常触发终止飞机在返场途中就掉了。从那以后我每次改完安全类参数都强制走一遍“地面模拟触发 参数 diff 重启复读”三步确认保护逻辑按预期动作才允许解锁。这份中文参数表最大的用处就是让这三步有据可查而不是凭记忆。希望帮到你。本文还有配套的精品资源点击获取