Mission Planner飞控参数调参指南：ACRO、AFS、AHRS等模块详解

简介这份文档面向飞控开发与无人机调试人员系统整理了 Mission Planner 中各类飞行模式的中文参数说明帮助读者摆脱英文参数表的阅读障碍快速理解每个参数的含义与取值范围。内容覆盖 ACRO 特技模式的姿态锁定与俯仰、横滚角速度ADSB 模式行为控制AFS 高级失效保护系统的 AMSL 高度限制、地理围栏、心跳引脚与飞行终止动作以及 AHRS 姿态解算中的 EKF 类型、GPS 参与度、主板安装朝向等关键项并附有默认值与可调区间。资源包共 1 个 docx 文件约 66KB以表格化条目呈现便于按模式检索对照。目前已有 4112 人学习下载适合需要逐项核对参数、排查保护逻辑或进行机架适配的中高级飞控开发者参考使用。1. 拿到这份参数表先别急着改飞控上周有个做植保机的朋友发来一段日志飞机在自动任务返航段突然掉高他第一反应是气压计坏了换了两个模块还是老样子。最后翻参数才发现ALT_HOLD_RTL被上一手调参的人改成了负值返航时维持当前高度而不是爬升到安全高度撞上田边的高压线区域才触发保护。这类问题在飞控开发里太常见了——不是硬件坏是参数表没吃透。这份《Mission Planner 所有飞行模式中文参数调参必备》文档干的就是把 ArduPilot 固件里那几百个参数按功能域拆开、逐条给中文释义和取值范围的事。它覆盖 ACRO 特技、AFS 高级失效保护、AHRS 姿态航向、空速计、电池监控、相机触发、降落伞等模块每条参数都带默认值、单位、上下限和适用场景说明。适合两类人一是刚接手 Pixhawk/APM 平台、面对全英文参数树发怵的新手二是需要快速核对某个参数边界值的老手。下面按我实际调参的顺序把这份文档里最值得先啃的几块拆开讲。2. 姿态与特技参数ACRO 和 AHRS 这两组怎么落地2.1 ACRO 模式的锁定与角速率特技模式是很多飞手又爱又怕的东西。ACRO_LOCKING这个参数控制的是摇杆回中后姿态是否保持——设为 1 启用锁定松杆后飞机维持当前姿态角设为 0 则松杆后按当前角速率继续转直到你反向打舵。做 3D 动作的喜欢关掉它做航拍增稳的必须打开。ACRO_PITCH_RATE和ACRO_ROLL_RATE默认都是 180 度/秒范围 10 到 500。这两个值决定满舵时飞机能转多快。我一般先按默认飞一圈感觉转得肉就往上加 20 到 30一次别加太多加到 300 以上要确认机架刚度和电调响应跟得上否则容易触发过载保护。# 通过 MAVLink 命令行读取当前 ACRO 参数Mission Planner 的 MAVLink Inspector 也可查 param show ACRO_* # 输出示例 # ACRO_LOCKING 1 # ACRO_PITCH_RATE 180 # ACRO_ROLL_RATE 180上面这条命令在 Mission Planner 的“终端”页或 QGC 的 MAVLink Console 里都能跑。param show后面跟通配符可以批量看一组参数比在完整参数树里翻快得多。改参数用param set ACRO_ROLL_RATE 220改完记得param save写进 EEPROM不然断电就丢。2.2 AHRS 安装朝向与 GPS 参与度AHRS_ORIENTATION是新手翻车率最高的参数之一。它描述飞控板相对机身的安装角度取值 0 到 37对应 Yaw45、Roll180、Pitch90 等各种组合。文档里列了完整对照表我建议直接查表而不是自己算。改完这个参数必须重启而且重启前要把飞机放水平否则姿态基准会带偏差。AHRS_GPS_GAIN控制 GPS 速度数据参与姿态估计的权重固定翼必须保持默认 1.0设成 0 会导致失控——文档里专门标了这句警告不是吓唬人。AHRS_GPS_MINSATS默认 6意思是至少 6 颗星才用 GPS 速度修正加速度计低于这个数就退回纯惯导推算。多旋翼在楼宇间飞我一般会把它提到 7 到 8减少 GPS 跳变带来的姿态抖动。AHRS_TRIM_X和AHRS_TRIM_Y用来补偿机架和飞控板之间的安装误差单位是弧度范围正负 0.1745约正负 10 度。正值对应右倾和抬头。这两个值不要手动硬填正确做法是飞起来看悬停时是否需要持续打舵修正再反推微调每次改 0.01 弧度左右。提示AHRS_ORIENTATION改错最典型的症状是解锁后飞机往一侧猛偏或者自稳模式下舵面反向。遇到这种情况先别怀疑电机转向回头核对这个参数。3. 失效保护 AFS 组飞行终止不是闹着玩的3.1 AMSL 高度限制与 GPS 误差裕量AFS_AMSL_LIMIT设的是海拔高度硬上限单位米气压高度超过这个值就强制终止飞行。注意它和常见的英尺制高度限制不是一套单位填之前先换算。0 值表示禁用。配套的AFS_AMSL_ERR_GPS默认 -1 米作用是气压计失灵时用 GPS 高度兜底但这个裕量会从限制值里扣掉保证 GPS 误差不会让气压高度突破上限。文档里提到 OBC 用户应把这个值和 D2 安全盒设成一致——这是给做机载计算机集成的团队看的普通飞手保持 -1 即可意思是气压计一失效立刻触发终止不留缓冲。AFS_QNH_PRESSURE设 QNH 压强单位毫米汞柱0 值禁用高度限制。这个参数要和当地气象报的 QNH 对齐填错了高度基准整体偏移限制就形同虚设。3.2 通讯与 GPS 丢失的累计策略AFS_MAX_COM_LOSS和AFS_MAX_GPS_LOSS默认都是 0含义是允许任意次数的失联事件恢复后继续任务。如果你飞的是超视距任务建议设成 2 到 3累计超过就停止任务不再自动恢复逼你人工介入检查。这两个参数是“后悔药”性质的设 0 等于把判断权全交给飞控。AFS_TERM_ACTION默认 0 无额外动作设成魔数 42 会在终止后所有舵面最大打舵加 0 油门故意让飞机坠毁。这个值只在特定安防场景用普通作业千万别碰。AFS_TERMINATE可以在飞行中动态置位来强行终止心跳信号配合AFS_HB_PIN使用——后者指定一个 10Hz 翻转的数字 IO 口外部失效保护板靠它区分“飞控死机”和“主动终止”。# 用 pymavlink 批量读取 AFS 组参数并打印适合起飞前做一次核对 from pymavlink import mavutil master mavutil.mavlink_connection(/dev/ttyUSB0, baud57600) master.wait_heartbeat() afs_params [AFS_ENABLE, AFS_AMSL_LIMIT, AFS_AMSL_ERR_GPS, AFS_MAX_COM_LOSS, AFS_MAX_GPS_LOSS, AFS_TERM_ACTION] for name in afs_params: master.mav.param_request_read_send( master.target_system, master.target_component, name.encode(), -1) msg master.recv_match(typePARAM_VALUE, blockingTrue, timeout3) if msg: print(f{msg.param_id}: {msg.param_value})这段脚本连上飞控后逐条请求参数值param_request_read_send的第三个参数是参数名第四个 -1 表示按名称索引。实际用的时候把串口和波特率换成你的链路超时设 3 秒够用。起飞前跑一遍把输出和文档里的默认值对一遍比在界面里一条条点快。注意AFS_ENABLE设为 0 时所有高级失效保护全部失效包括地理围栏。有些人调完别的参数顺手把它关了排查问题后来忘了开这是血泪教训级别的疏忽。4. 空速计与电池监控传感器标定的参数闭环4.1 空速计从管脚到校准比率ARSPD_PIN决定空速计接哪个口。APM2 用 0 到 9 对应模拟引脚APM1 设 64PX4 设 11Pixhawk 设 15I2C 空速计EagleTree 或 MEAS在 PX4/Pixhawk 上设 65。这个值填错空速读数要么恒为零要么乱跳。ARSPD_TUBE_ORDER默认 2表示驱动器自动接受皮托管的任意连接顺序。设 0 或 1 是强制指定动压接上口还是下口好处是能检测静压过大被误读成正空速的情况。我一般保持 2除非做高空长航时任务需要严格诊断。ARSPD_RATIO默认 1.9936ARSPD_OFFSET默认 2.333235这两个是校准结果不要手填。正确流程是开ARSPD_AUTOCAL在飞行中自动修正比率变化超过 5% 时每 2 分钟存一次 EEPROM。ARSPD_FBW_MAX和ARSPD_FBW_MIN默认 22 和 9 米/秒对应最大和最小油门下的空速所有自动油门模式都用这两个值做映射填之前先确认你的失速速度和巡航速度。4.2 电池监控的管脚与换算系数BATT_MONITOR设 0 禁用、3 仅电压、4 电压加电流。BATT_VOLT_PIN和BATT_CURR_PIN按硬件平台填APM2.5 电源模块电压脚 13、电流脚 12Pixhawk 电源模块电压脚 2、电流脚 3PX4 电压脚 100、电流脚 101。这几个数字文档里列得很清楚填错的表现是电压读数离谱或者电流恒为零。BATT_VOLT_MULT默认 10.1BATT_AMP_PERVOLT默认 17分别是电压和电流的换算系数。3DR 电源模块用 10.1 和 17四合一电调供电的 Pixhawk 电压系数改 12.02。BATT_CAPACITY填电池实际容量 mAh这个值直接影响剩余电量百分比估算填大了会虚标续航。参数默认值单位常见误填后果BATT_VOLT_PIN2引脚号电压读数恒为 0 或满量程BATT_CURR_PIN3引脚号电流始终显示 0BATT_VOLT_MULT10.1倍率电压偏差成比例放大BATT_AMP_PERVOLT17安/伏电流估算整体偏移BATT_CAPACITY3300mAh剩余电量百分比失真第二组电池BATT2_*参数结构完全一样双电池冗余的机型要两组都配。BATT_WATT_MAX默认 0 不限功率做长航时想限制放电功率可以设个上限。5. 避坑排查这五条都是实际翻过的车5.1 改完 AHRS_ORIENTATION 没重启就解锁现象是自稳模式下飞机往一侧持续偏转打反舵也压不住。原因是这个参数标注了“下一次重启生效”改完不重启飞控还在用旧朝向做姿态解算。解决方法是改完立即断电重启重启前把机身放水平重启后在地面站看姿态球是否与实际倾斜一致。5.2 ARMING_CHECK 设 72 却解不了锁有人照着文档算 8GPS加 64遥控等于 72想实现“有星且有遥控才允许解锁”结果地面怎么都解不了。原因是位掩码求和没错但 GPS 锁定状态在室内永远不满足。排查顺序是先看 Mission Planner 的“消息”页有没有 pre-arm 报错再逐项关掉检查定位是哪个条件卡住。室外测试时至少等 HDOP 小于 1.5 再试。5.3 ARSPD_USE 开着但没装空速计现象是自动模式下油门忽大忽小高度保持像坐电梯。原因是ARSPD_USE设为 1 但ARSPD_ENABLE为 0 或空速计没接飞控拿不到有效空速还硬用。解决方法是没装空速计就把ARSPD_USE设 0装了但没校准就先关掉校准完再开。5.4 AFS_TERM_ACTION 误设 42这个值一旦生效终止时舵面满打加零油门飞机直接进入不可控俯冲。有人调试失效保护时随手填了 42 想“看看效果”结果地面测试触发终止逻辑桨叶打坏。排查建议是地面调试时把AFS_ENABLE先设 0确认逻辑链路通了再逐项开AFS_TERM_ACTION永远留 0 除非你明确知道自己在做什么。5.5 COMPASS_EXTERNAL 在 APM2 上没手动设PX4 能自动识别内外罗盘APM2 不行。用了外置罗盘但COMPASS_EXTERNAL还是 0飞控拿内置罗盘数据做航向电机电流一干扰航向就飘。解决方法是在 APM2 平台上手动设 1并且注意COMPASS_ORIENT独立于AHRS_ORIENTATION外罗盘的安装朝向要单独配。6. 进阶用法把参数表变成起飞前检查脚本文档里几百条参数靠人眼逐条核对不现实。我的习惯是把关键安全参数抽出来做成一个起飞前自动核对脚本每次换机或改配置后跑一遍输出和基线值的差异。下面这段用 pymavlink 实现思路是维护一个期望值字典连上飞控后逐条比对偏差超过阈值就标红。from pymavlink import mavutil # 基线值字典按机型维护换机只改这里 BASELINE { AHRS_GPS_GAIN: 1.0, AHRS_GPS_MINSATS: 6, AFS_ENABLE: 1, AFS_TERM_ACTION: 0, ARSPD_USE: 1, BATT_MONITOR: 4, ARMING_CHECK: 1, } master mavutil.mavlink_connection(/dev/ttyUSB0, baud57600) master.wait_heartbeat() for name, expect in BASELINE.items(): master.mav.param_request_read_send( master.target_system, master.target_component, name.encode(), -1) msg master.recv_match(typePARAM_VALUE, blockingTrue, timeout3) if not msg: print(f[MISS] {name} 读取超时) continue actual msg.param_value flag OK if abs(actual - expect) 1e-6 else DIFF print(f[{flag}] {name}: 期望 {expect}, 实际 {actual})BASELINE字典按你的机型维护固定翼和多旋翼的期望值不一样别混用。比对逻辑用 1e-6 的容差是因为浮点参数存 EEPROM 后可能有末位误差。param_request_read_send逐条请求在参数多的时候偏慢实际项目里可以改成请求全部参数后本地过滤但逐条读的好处是超时能定位到具体哪条没响应。这套脚本配合文档使用的方式是文档负责告诉你每个参数“是什么、范围多少、为什么这么设”脚本负责告诉你“当前机器上实际是多少、和基线差在哪”。两者结合换机、升级固件、接手别人的飞机这三种场景下能省掉大量翻参数树的时间。我一般还会把每次核对结果存成带日期的文本文件出问题时往回翻能快速定位是哪次改动引入的偏差。从那以后我每次动飞控参数前都强制先跑一遍基线核对、改完再跑一遍对比差异确认没有连带改动才解锁。这个习惯帮我拦下过至少三次“改 A 参数顺手把 B 参数带偏”的隐性故障。希望这份拆解和脚本思路能帮到你少走几段我踩过的弯路。本文还有配套的精品资源点击获取