简介这份文档聚焦 Mission Planner 飞行模式与参数调校面向飞控开发、无人机调试及 ArduPilot 参数配置人员帮助解决英文参数含义不清、取值边界难判断和失效保护设置易混淆等问题。压缩包内仅含 1 个 docx 文件大小约 66KB便于快速查阅与本地检索。内容按 ACRO、ADSB、AFS、AHRS 等模式梳理常用参数的中文说明覆盖姿态锁定、最大俯仰与横滚角速度、高度限制误差裕量、通讯与 GPS 丢失计数、遥控失效保护、EKF 类型、主板安装朝向等关键项并给出默认值、取值范围和使用注意。已有 4112 人学习适合作为飞行模式参数速查表与调参排错参考也可用于对照理解安全保护逻辑。1. 装完地面站先别连飞机Mission Planner 飞行模式中文参数调参必备到底解决哪一步装 Mission Planner 的人十有八九会在第一次打开参数树时愣住飞行模式一堆英文缩写调参项散在几十个页面里《Mission Planner 飞行模式中文参数调参必备》就是在这种场景下被翻出来的。它不负责装地面站却决定了装完之后你敢不敢改第一个参数。尤其做飞控开发参数名看得懂和参数值写对是两件事AHRS_ORIENTATION差 90 度、ARMING_CHECK位掩码少算一项地面测试可能一切正常上天就是另一回事。下面按装前环境、文件落地、参数写入、排错、验证的顺序走一遍适合刚接触 Mission Planner 的开发者也适合已经装过但每次调参都要翻英文文档的人。2. 装前环境清单Windows 运行时、串口驱动和目录规划怎么配Mission Planner 本身是 Windows 桌面程序装起来不复杂真正让人翻车的是装完打不开、打开了连不上、连上了参数写不进去。先把运行环境、安装目录和串口驱动这三件事处理掉后面读参数表才不会一边查中文释义一边猜为什么地面站闪退。2.1 系统版本与运行时检查我一般先在 Windows 10 或 Windows 11 的干净账户里装不用 administrator 日常账号直接跑地面站。Mission Planner 依赖 .NET Framework 运行时系统缺组件时常见表现是双击没反应或者启动到一半直接退出连错误窗口都不给。与其装完再猜不如先看注册表里的 .NET Framework 4.x 项是否存在同时把串口设备列出来飞控上电后有没有 COM 口一目了然。# 检查 .NET Framework 4.x 注册表项是否完整 $ndp HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full if (Test-Path $ndp) { Get-ItemProperty $ndp | Select-Object Version, Release } else { Write-Host 未检测到 .NET Framework 4.x先补运行时再装地面站 } # 飞控上电后执行确认系统是否识别到串口 Get-CimInstance Win32_SerialPort | Select-Object DeviceID, Description, PNPDeviceID第一段只看注册表项存不存在Version和Release用来判断运行时是否装过不用背具体数值第二段看DeviceID里有没有COMx。如果这里空空如也先别打开 Mission Planner去设备管理器看飞控是否出现在“端口”分类下。常见做法是先装 USB 串口驱动再插飞控顺序反了容易出现设备管理器里带黄色感叹号的未知设备。系统更新也建议先跑完缺系统补丁时 .NET 运行时安装器可能中途回滚。2.2 安装路径和权限中文目录、OneDrive 同步目录都不要碰Mission Planner 的安装包默认往Program Files里放普通账户写入参数文件、日志和固件缓存时容易碰到权限问题。我的习惯是单独建一个D:\UAV根目录地面站、参数文件、日志各占一层不跟桌面、文档、OneDrive 同步目录混在一起。中文路径不是绝对不能用但一旦日志文件名带中文、参数文件又被同步盘锁住排查起来就是玄学。血泪经验是路径越短、越纯英文后面出的怪问题越少。# 建立独立目录地面站和参数文件分开存放 $root D:\UAV New-Item -ItemType Directory -Force -Path $root\MissionPlanner,$root\params,$root\logs | Out-Null # 给当前用户完全控制避免参数文件和日志写入失败 icacls $root /grant $env:USERNAME:(OI)(CI)F | Out-Null-Force的作用是目录已存在时不报错适合反复执行icacls那一行把当前用户对D:\UAV及其子目录的权限补齐(OI)(CI)F表示文件继承和目录继承都给完全控制。安装时把 Mission Planner 指到D:\UAV\MissionPlanner不要把安装包解压到C:\Users\你的名字\Desktop这类路径。后面导出的.param文件统一放D:\UAV\params日志放D:\UAV\logs出问题时不用满硬盘找文件。提示安装包如果被系统拦截先把安装包放到本地磁盘再加入信任后重试不要直接在压缩包里双击运行。2.3 串口驱动与飞控上电顺序串口驱动没装好时Mission Planner 的连接下拉框里可能只显示AUTO点连接一直转圈。正确顺序是先装驱动、再给飞控上电、最后打开地面站。飞控上电后看设备管理器出现COMx且没有感叹号再回 Mission Planner 选对应端口。波特率不要在地面站里一个个试按飞控固件里串口的SERIALx_BAUD设置来常见是 57600 或 115200数传电台还要看流控BRD_SER1_RTSCTS和BRD_SER2_RTSCTS在原文里写得很清楚0 禁用、1 启用、2 自动检测PX4v1 的串口 1 没有硬件流控引脚要设为禁用。连接步骤我通常拆成四步第一步飞控只插 USB不接电池确认地面站能读到参数第二步接电池后再连一次看电压读数是否正常第三步换一根短线再连排除 USB 线只供电不传数据第四步如果换了口还是连不上回设备管理器看驱动版本不要在地面站里反复点 Connect。地面站能连上只是入口参数表里的AHRS_ORIENTATION、COMPASS_EXTERNAL、BATT_MONITOR这些值能不能写进去才是后面要盯的事。3. 把 docx 变成参数速查库解压、提取参数名、按固件分组这份中文参数表的用法不是从头读到尾而是当成参数速查库装完 Mission Planner 后遇到不认识的参数名先在这份表里搜中文释义再去 Full Parameter List 里改值。docx 本身是文档格式直接在里面搜参数名可以但参数一多就容易看串行。我的做法是先备份原始文件再用脚本把参数名、默认值/范围和说明抽成 CSV最后按模块分组和 Mission Planner 的参数树对齐。3.1 先备份原始 docx再建立只读索引原始参数表不要边看边改尤其不要在里面加自己的备注后覆盖原文件。先复制一份到D:\UAV\params把备份设为只读后面所有查询都基于备份。这样即使误操作原始文件还在参数释义不会丢。docx 本质上是一个压缩包里面是 XML直接解压也能看但用 Python 读段落更省事不用和 XML 标签较劲。# 备份原始参数表后续只读打开避免误改 Copy-Item D:\UAV\params\MissionPlanner飞行模式中文参数调参必备.docx D:\UAV\params\原始备份.docx -Force Set-ItemProperty D:\UAV\params\原始备份.docx -Name IsReadOnly -Value $trueCopy-Item的-Force用于覆盖旧备份适合每次拿到新版本参数表时重新执行IsReadOnly设为$true后Word 打开会提示只读减少手滑改原件的概率。备份完成后原文件可以留在下载目录工作目录只放备份和导出的 CSV。后面如果参数表和固件版本对不上回退时也有原始文件可查。3.2 用 Python 提取参数名和默认值/范围参数表里的参数名大多是大写字母、数字和下划线比如ACRO_LOCKING、AFS_AMSL_LIMIT、BATT_VOLT_PIN。用正则把每段开头符合这个规则的词抓出来再把整段原文作为说明保留生成 CSV 后用 Excel 或 VS Code 查都比翻 docx 快。先建一个独立虚拟环境避免解析依赖装进系统 Python把环境弄脏。# 建独立虚拟环境解析依赖只装在这里 python -m venv D:\UAV\venv-param D:\UAV\venv-param\Scripts\activate pip install python-docx虚拟环境激活后命令行前面会出现(venv-param)表示后面的pip install只影响这个环境。python-docx用来读 docx 段落不依赖 Word 客户端。下面脚本把参数名、后面紧跟的默认值/范围、整段原文三列写进 CSV编码用utf-8-sigExcel 直接打开不乱码。from docx import Document import csv import re doc Document(rD:\UAV\params\原始备份.docx) rows [] for p in doc.paragraphs: text p.text.strip() # 参数名通常是大写字母开头后接大写字母、数字或下划线 m re.match(r^([A-Z][A-Z0-9_]{2,})\s*(\S*), text) if m: rows.append([m.group(1), m.group(2), text]) with open(rD:\UAV\params\param_index.csv, w, newline, encodingutf-8-sig) as f: writer csv.writer(f) writer.writerow([param, default_or_range, raw_text]) writer.writerows(rows) print(f提取 {len(rows)} 条参数)re.match只匹配段落开头避免把说明里的英文单词误当成参数名group(1)是参数名group(2)是参数名后面紧跟的默认值或范围可能为空所以 CSV 里允许空列。raw_text保留整段中文说明后面查单位时不用再回 docx。这个脚本不保证百分之百准确docx 里有些参数名和说明写在同一段有些默认值带单位提取后要人工扫一遍 CSV把明显不对的行标出来。常见做法是先跑脚本再用 Excel 筛选param列长度为 0 或重复的行手工修正。3.3 把参数表映射到 Mission Planner 的 Full Parameter ListCSV 建好后打开 Mission Planner 的 Full Parameter List在搜索框里输参数名能搜到就说明固件里有这个参数搜不到时先别怀疑参数表先确认固件版本和参数表是不是同一套。原文里有些参数是特定平台才有的比如BATT_VOLT_PIN在 Pixhawk 上常见值是 2APM2.5 上是 13PX4 上是 100ARSPD_PIN在 Pixhawk 上常见 15PX4 上常见 11APM2 是 0 到 9APM1 是 64I2C 空速计是 65。这些值不是让你照抄而是让你在搜不到参数时知道该看哪个平台的说明。docx 里的字段Mission Planner 里看什么写入前确认参数名Full Parameter List 搜索框大小写一致不要多空格默认值/范围参数值列和右侧说明范围不是默认值别把上限当地址单位参数说明里的厘米、米、弧度、角度/秒先换算再写ALT_HOLD_RTL是厘米AFS_AMSL_LIMIT是米适用模式飞行模式页和参数说明模式编号与当前固件一致单位是参数表落地时最容易踩的坑。ALT_HOLD_RTL原文写的是厘米10000 就是 100 米AFS_AMSL_LIMIT写的是米0 表示禁用AHRS_TRIM_X写的是弧度不是角度。ACRO_PITCH_RATE和ACRO_ROLL_RATE的单位是角度/秒默认 180范围 10 到 500改之前先想清楚是想要更灵活还是更柔和。把这些单位先标在 CSV 里再往地面站里写比写完发现高度差 100 倍再回头查要省事。4. 参数配置顺序从板级朝向、电池监控到失效保护怎么写参数不要从第一页开始顺着改顺序错了会出现“传感器还没校准失效保护先触发”的假故障。我一般按板级参数、电池与空速计、失效保护与返航高度三段来写每一段写完都重启回读一次。下面给的.param片段是示例格式不是让你整段无脑导入BATT_VOLT_PIN、ARSPD_PIN这类值要按你的飞控板型号改。4.1 先写板级参数AHRS_ORIENTATION、COMPASS_EXTERNAL、BRD_SAFETYENABLEAHRS_ORIENTATION控制飞控板相对机架的安装朝向原文里 0 是无旋转4 是 Yaw1808 是 Roll18016 是 Roll9024 是 Pitch90完整值表到 37。这个参数改完要重启才生效重启前必须把设备放水平否则姿态基准会偏。COMPASS_EXTERNAL是外置罗盘设置原文写得很明确PX4 上自动识别APM2 上必须正确设置用了外罗盘就置 1而且外罗盘的COMPASS_ORIENT选项独立于AHRS_ORIENTATION这两个不要混着理解。BRD_SAFETYENABLE是安全解锁开关原文建议除非特殊情况始终设为 1测试台架上也不要随手关。# 板级安装朝向0无旋转按实际安装角度改改完重启并保持水平 AHRS_ORIENTATION,0 # 外置罗盘1外部APM2 上必须手动确认PX4 自动识别 COMPASS_EXTERNAL,1 # 安全开关1启用除非测试台架有特殊需要不要设为 0 BRD_SAFETYENABLE,1这三行里AHRS_ORIENTATION的值不是越大越好而是和板子实际安装方向一致拿不准时先保持 0把飞控平放看 HUD 姿态线是否跟实际转动一致再决定要不要改。COMPASS_EXTERNAL设 1 之前先确认外罗盘确实接好否则校准会报罗盘不健康。BRD_SAFETYENABLE设 1 后解锁前要按安全开关这是正常流程不要为了省事关掉。写入方式是在 Full Parameter List 里逐项改点 Write Params然后重启飞控再读一遍。4.2 再写电池与空速计BATT_MONITOR、BATT_VOLT_PIN、ARSPD_PIN电池参数是第二个容易写错的模块。BATT_MONITOR控制电池监控类型0 禁用、3 仅电压、4 电压和电流只测电压就设 3要测电流必须确认电源模块的电流线也接好。BATT_VOLT_PIN和BATT_CURR_PIN是引脚映射原文给了平台差异Pixhawk 电压引脚常见 2、电流引脚常见 3APM2.5 电压引脚常见 13、电流引脚常见 12PX4 电压引脚常见 100、电流引脚常见 101。BATT_VOLT_MULT和BATT_AMP_PERVOLT是换算系数常见电源模块的电压倍数 10.1、电流 17四合一电调的电压倍数 12.02PX4IO 电源模块的电压倍数 1。这些值来自原文不要拿万用表随便估一个填进去。参数作用常见取值写入前注意BATT_MONITOR电池监控类型0 禁用3 仅电压4 电压和电流先确认电源模块接线BATT_VOLT_PIN电压采样引脚Pixhawk 2APM2.5 13PX4 100按飞控板型号选BATT_CURR_PIN电流采样引脚Pixhawk 3APM2.5 12PX4 101不测电流可先不管BATT_VOLT_MULT电压换算倍数常见电源模块 10.1四合一电调 12.02PX4IO 1用万用表对比读数BATT_AMP_PERVOLT电流换算系数常见电源模块 17没有电流钳就先别改ARSPD_PIN空速计引脚Pixhawk 15PX4 11APM2 0-9APM1 64I2C 65接错引脚读数会乱跳ARSPD_USE是否使用空速1 使用0 不使用没校准前先设 0空速计的参数顺序要反过来先把ARSPD_USE设 0接好皮托管检查ARSPD_PIN对不对再做ARSPD_OFFSET和ARSPD_RATIO校准最后才把ARSPD_USE设 1。原文里ARSPD_TUBE_ORDER设 2 表示接受任意一种动静压顺序拿不准管路接法时可以先设 2ARSPD_AUTOCAL启用后会在飞行中根据地速和空速自动调整ARSPD_RATIO变化超过 5% 会每隔 2 分钟写一次 EEPROM。校准没做完就打开ARSPD_USE飞控可能拿一个漂移的空速值去控油门地面测试看不出问题空中就是另一回事。4.3 最后写失效保护与返航高度AFS_ENABLE、ARMING_CHECK、ALT_HOLD_RTL失效保护放在最后写因为前面的板级参数和传感器没配好时开失效保护容易误触发。AFS_ENABLE是高级失效保护总开关0 禁用、1 启用AFS_AMSL_LIMIT是海拔高度限制单位米0 表示禁用AFS_TERM_ACTION是飞行终止后的动作0 默认无额外动作42 是原文里的“魔数”会在所有舵面最大打舵并给 0 油门这个值只适合理解逻辑不要在地面随手上机。ALT_HOLD_RTL是返航目标高度单位厘米10000 就是 100 米负数通常表示维持当前高度。ARMING_CHECK是解锁前检查的位掩码原文默认是不检查64 是遥控发射机8 是 GPS72 是两者同时有效才允许解锁这个 72 是示例不是默认值。# 高级失效保护总开关0禁用1启用先确认失控动作再开 AFS_ENABLE,0 # AMSL 高度限制单位米0 表示禁用 AFS_AMSL_LIMIT,0 # 返航高度单位厘米10000100 米 ALT_HOLD_RTL,10000 # 解锁检查位掩码64遥控8GPS72两者同时有效 ARMING_CHECK,72 # 飞行终止动作0无额外动作42 为最大打舵0 油门不要随意设 AFS_TERM_ACTION,0AFS_ENABLE先保持 0等ARMING_CHECK、遥控失控动作、GPS 状态都确认后再开。ARMING_CHECK改成 72 后没有 GPS 锁定或遥控信号时解锁会被拦这是预期行为如果在地面台架上调试可以临时把对应位去掉但不要长期设 0 绕过检查。ALT_HOLD_RTL写 10000 之前先确认返航路径上没有障碍厘米单位别写成 100。写入后导出当前参数备份再重启读回确认没有一项被固件改回去。5. 排查清单参数写入不生效、罗盘方向错、串口掉线的 5 个坑装完能连上只是第一步参数写入和回读才是翻车高发区。下面五条是我在 Mission Planner 里反复遇到的坑每条按现象、原因、解决写能对上就少走弯路。5.1 参数写入后重启又变回去现象在 Full Parameter List 里把AHRS_ORIENTATION从 0 改成 4点写入界面显示成功重启飞控再读又回到 0。原因常见有四种只改了输入框没点 Write Params用 Load from file 加载了.param但没执行写入当前固件不支持这个参数搜索框里能搜到只是缓存电池供电不足写 EEPROM 中途掉电。解决时先看 Mission Planner 底部提示有没有 “Parameters written” 之类的反馈再点一次 Write Params然后导出当前参数文件和改之前的备份对比确认差异行最后换满电电池重写。如果只有某一个参数回退先查这个参数是不是重启后才生效的类型AHRS_ORIENTATION本身就是重启生效写入后必须重启再读。5.2 罗盘方向不对或外置罗盘不识别现象飞控平放时 HUD 姿态线正常转动 90 度后方向反了或者校准罗盘时一直提示罗盘不健康。原因通常是AHRS_ORIENTATION和COMPASS_ORIENT混淆板子安装朝向改了但外罗盘朝向没改APM2 上用了外罗盘但COMPASS_EXTERNAL还是 0罗盘校准没做或者电机线磁干扰太大。解决时先把飞控水平放置改AHRS_ORIENTATION后重启再单独看外罗盘数据APM2 上确认COMPASS_EXTERNAL设为 1PX4 上让它自动识别然后做一次完整的罗盘校准校准远离电机和金属台面。原文特别提醒外罗盘的COMPASS_ORIENT独立于AHRS_ORIENTATION这两个不要互相替代。5.3 串口能识别但 Mission Planner 连不上现象设备管理器里有COMxMission Planner 选了口和波特率点 Connect 一直超时。原因可能是波特率跟飞控固件里的SERIALx_BAUD不一致数传流控没配对BRD_SER1_RTSCTS或BRD_SER2_RTSCTS设了启用但线序不对USB 线只供电不传数据驱动装了两个版本互相抢口。解决时先换一根已知能传数据的短线再按固件串口波特率逐个试不要一次改多个参数数传场景下检查流控PX4v1 的串口 1 没有硬件流控引脚原文明确要设禁用最后在设备管理器里卸载重复端口再重插。能识别 COM 口不代表数据线没问题这一步用替换法最快。5.4 解锁失败ARMING_CHECK 拦截现象推油门电机不转Messages 页出现 PreArm 检查失败。原因通常是ARMING_CHECK开了 GPS、罗盘、遥控、电池等检查但对应条件没满足ARMING_REQUIRE设了解锁后输出油门 PWM但遥控没掰杆油门没回最低。解决时先看 Messages 页具体拦在哪一项不要直接把ARMING_CHECK设 0按位掩码逐项排查64 是遥控、8 是 GPS、4 是罗盘、2 是气压计确认对应硬件状态室内调试没有 GPS 时可以临时去掉 GPS 位但不要长期关检查。ARMING_REQUIRE原文写了解锁后输出THR_MIN或 0 PWM 的差异改之前先确认电调待机状态。5.5 空速计读数漂移或为负现象地面吹气空速有变化但静置时读数不为零飞行中空速和地速差很多。原因可能是ARSPD_PIN配错接到别的模拟口ARSPD_TUBE_ORDER动静压接反ARSPD_RATIO和ARSPD_OFFSET没校准ARSPD_USE已经打开但校准没做完。解决时先把ARSPD_USE设 0检查皮托管动静压口有没有接反ARSPD_TUBE_ORDER拿不准就设 2 让驱动器接受任意顺序然后做ARSPD_OFFSET和ARSPD_RATIO校准或者开ARSPD_AUTOCAL让飞控在飞行中慢慢修最后确认ARSPD_PIN和飞控板型号匹配。空速计是典型的“地面看着差不多空中差很多”的传感器校准没完成不要打开使用。6. 装完怎么验证参数回读、模式切换和地面测试的三步确认装完不要只看地面站能不能连。我的习惯是三步参数回读、模式切换、地面测试。先把改之前的参数导出成before.param写完关键参数重启后再导出after.param用脚本对比差异确认没有参数被固件悄悄改回去。def load_param(path): data {} with open(path, encodingutf-8-sig) as f: for line in f: line line.strip() if not line or line.startswith(#): continue parts line.replace(,, ).split() if len(parts) 2: data[parts[0]] parts[1] return data before load_param(rD:\UAV\params\before.param) after load_param(rD:\UAV\params\after.param) for key in sorted(set(before) | set(after)): if before.get(key) ! after.get(key): print(f{key}: {before.get(key)} - {after.get(key)})load_param同时兼容逗号和空格分隔utf-8-sig处理带 BOM 的参数文件对比结果里如果出现你没改过的参数变化先查是不是固件自动写入再决定要不要回滚。参数回读通过后在地面依次切 ACRO、FBWA、RTL看 HUD 模式是否跟着变然后做一次解锁检查看 Messages 有没有 PreArm 报错最后模拟遥控失控确认失效保护按AFS_ENABLE和AFS_TERM_ACTION的设置动作。从那以后我每次装完 Mission Planner都强制先导出一份before.param改完再导出after.param两个文件对一遍才敢上电。希望帮到你。本文还有配套的精品资源点击获取
