一、PX4调试概述：调试的重要性、调试流程总览、调试工具链介绍
1.1 为什么调试这么重要？
说实话，我见过太多飞控项目「死」在调试阶段了。
代码写完了，传感器也初始化了，电机能转。一解锁，飞机直接翻跟头。或者更糟——飞起来三秒，掉下来。
这不是代码本身的问题。是调试没做到位。
PX4 是一个很复杂的系统。传感器融合、姿态控制、位置估计、导航逻辑……每一层都可能出问题。而且这些层是串在一起的——你以为是姿态控制的问题，查了半天，发现是磁罗盘没校准。
我个人习惯把调试分成三个层次：
- 第一层：能不能飞？——传感器数据对不对，电机响应正不正常，遥控器信号稳不稳。
- 第二层：飞得稳不稳？——姿态控制参数调好了吗？有没有震荡？有没有偏航漂移？
- 第三层：飞得聪明不聪明？——GPS 定位准不准？航线跟踪误差大不大？故障切换是否可靠？
很多新手跳过第一层，直接调第二层。结果就是——越调越乱。
⚠️ 重要提醒： 调试不是「出了问题再查」，而是「每一步都确认没问题再往前走」。我在项目中遇到过好几次，因为跳过传感器校准直接飞，结果炸机后才发现是磁罗盘装反了。嗯，从那以后我再也不敢省这一步了。
1.2 调试流程总览
PX4 的调试流程，说白了就是一条流水线。你按顺序走完，基本不会出大问题。
我把它总结成六个阶段：
- 硬件检查与传感器校准——确认飞控板、GPS、遥控器、电调、电机都正常。校准加速度计、陀螺仪、磁罗盘、气压计。
- 基础功能验证——检查传感器数据流、遥控器通道映射、安全开关逻辑、LED 状态指示。
- 电机与电调测试——确认电机转向、电调行程校准、混控器输出正确。
- 姿态与位置控制调参——调 PID 参数，做悬停测试、偏航响应测试、位置保持测试。
- 飞行模式与故障切换测试——验证定高、定点、返航、降落等模式是否正常。模拟 GPS 丢失、遥控器信号丢失等故障。
- 实际飞行验证——在安全环境下做完整航线飞行，记录日志，分析性能。
你想想看，这六个阶段其实是一个「从静态到动态、从简单到复杂」的过程。跳过任何一步，后面都会加倍还回来。
下面这张图是我自己画的调试流程框架，你可以把它贴在工位上：
1.3 调试工具链介绍
工欲善其事，必先利其器。PX4 的调试工具链其实挺全的，关键是你要知道什么时候用哪个。
我按使用场景把它们分成了四类：
| 工具类别 | 工具名称 | 主要用途 | 我的使用建议 |
|---|---|---|---|
| 地面站 | QGroundControl | 传感器校准、参数调整、飞行模式设置、实时数据监控 | 日常调试首选，界面直观，适合快速验证 |
| 日志分析 | Flight Review / PX4 Log Analysis | 飞行日志上传、自动分析、性能评分、问题定位 | 每次飞行后必做，能发现很多肉眼看不到的问题 |
| 命令行 | MAVLink Shell / nsh | 直接执行 PX4 内部命令、查看系统状态、调试传感器 | 高级调试必备，我经常用它查传感器原始数据 |
| 仿真环境 | Gazebo + PX4 SITL | 在电脑上模拟飞行、测试控制算法、验证故障逻辑 | 调参前先在仿真里跑一遍，能省很多炸机成本 |
💡 个人经验： 我刚开始用 PX4 时，总觉得命令行工具没必要学。直到有一次飞机在空中突然偏航，QGC 上显示一切正常。我连上 MAVLink Shell，敲了
sensor gyro status，才发现陀螺仪 Z 轴数据有间歇性跳变。嗯，从那以后我再也不嫌命令行麻烦了。
1.4 调试的核心思维
说了这么多工具和流程，其实调试最核心的东西就一句话：一次只改一个变量。
我见过太多人——包括我自己早期——一上来就调三四个参数。结果飞机好了，不知道是哪个参数起了作用。飞机炸了，也不知道是哪个参数出了问题。
为什么会这样？因为飞控系统是非线性的。姿态 PID 和位置 PID 会互相影响。传感器融合参数和控制参数也会互相影响。你一次改多个，根本分不清因果关系。
所以我建议你养成一个习惯：
- 每次只改一个参数
- 改完飞一次，看日志
- 确认效果后，再改下一个
听起来慢，其实最快。因为你不走回头路。
📌 本章核心要点：
- 调试是系统化工程，不是「出了问题再查」
- 六个阶段：硬件检查 → 基础验证 → 电机测试 → 控制调参 → 模式测试 → 实际飞行
- 工具链：QGC（日常）、Flight Review（日志）、MAVLink Shell（深度）、Gazebo（仿真）
- 核心原则：一次只改一个变量，逐层验证，不跳步