日志解析工具链：从原始数据到可视化洞察

做飞控日志分析，说白了就是跟一堆二进制数据打交道。你想想看，无人机在天上飞了几分钟，记录的日志可能有几十万条消息。没有趁手的工具，光靠肉眼去翻，那简直是灾难。

我个人习惯把工具链分成三层：底层解析层（pyMavlink）、数据转储层（mavlogdump.py）、可视化分析层（FlightPlot、Mission Planner）。今天我们就一层层把它打通。

pyMavlink 库安装与配置

pyMavlink 是 MAVLink 协议的 Python 实现。说白了，它就是一把万能钥匙，能打开所有 MAVLink 格式的日志文件。

安装其实很简单，但我建议你用虚拟环境，别直接装到系统 Python 里。为什么？因为不同项目可能依赖不同版本的 pyMavlink，混在一起容易出问题。

# 创建虚拟环境（推荐）
python3 -m venv mavlink_env
source mavlink_env/bin/activate  # Linux/Mac
# 或 mavlink_env\Scripts\activate  # Windows

# 安装 pyMavlink
pip install pymavlink

# 验证安装
python -c "from pymavlink import mavutil; print('pyMavlink 安装成功')"

配置方面，有几点要注意：

• Python 版本：pyMavlink 支持 Python 3.6+，但我建议用 3.8 或更高版本。我在项目中遇到过 Python 3.6 下某些消息解析报错的情况。
• 依赖冲突：如果同时安装了 dronekit，注意版本兼容性。我曾经被这两个库的依赖搞得焦头烂额，最后发现是 future 库版本不一致。
• Windows 用户：如果安装时提示缺少 C 编译器，去下载 Microsoft C++ Build Tools 就行。

mavlogdump.py：二进制日志的翻译官

mavlogdump.py 是 pyMavlink 自带的一个命令行工具。它的作用很简单——把二进制日志转成人类能读懂的文本。

你想想看，.bin 文件里存的都是字节流，你总不能拿十六进制编辑器去一行行看吧？mavlogdump.py 就是干这个的。

# 基本用法：导出所有消息
mavlogdump.py --types=GPS,IMU flight_log.bin > output.txt

# 只看特定类型消息
mavlogdump.py --types=ATTITUDE flight_log.bin

# 带时间戳导出
mavlogdump.py --timestamps flight_log.bin

# 条件过滤（比如只看高度大于10米时的消息）
mavlogdump.py --condition="relative_alt>10" flight_log.bin

常用的消息类型有哪些？我列个表给你参考：

消息类型	用途	关键字段
GPS	定位信息	Lat, Lng, Alt, HDOP, NumSats
IMU	惯性测量	AccelX/Y/Z, GyroX/Y/Z
ATTITUDE	姿态数据	Roll, Pitch, Yaw
BATTERY	电池状态	Voltage, Current, Remaining
RC_CHANNELS	遥控器通道	Chan1~Chan16
MODE	飞行模式切换	Mode, ModeNum

FlightPlot 基础操作

FlightPlot 是我个人非常喜欢的一个工具。它轻量、跨平台，而且画出来的曲线图可以直接用于报告。

说实话，刚开始用 FlightPlot 时我也觉得它界面有点简陋。但用久了你会发现，它把最核心的功能都做得很扎实。

基本操作流程：

1. 加载日志：File → Open，选择 .bin 或 .tlog 文件。支持拖拽，这个很方便。
2. 选择数据：左侧树形结构展开，勾选你想看的消息类型。比如想看姿态，就勾上 ATTITUDE。
3. 绘制曲线：在右侧图表区域右键，选择 Add Curve，然后选字段。我习惯把 Roll、Pitch、Yaw 放在同一个图里对比。
4. 缩放与测量：鼠标滚轮缩放，按住 Ctrl 拖动可以平移。想测量时间差？按住 Shift 然后拖拽就行。

FlightPlot 还有一个隐藏功能——数据导出。你可以把选中的曲线数据导出为 CSV 格式，然后用 Excel 或者 Python 做进一步分析。这个功能在写报告时特别有用。

Mission Planner 日志查看器

Mission Planner 的日志查看器，功能比 FlightPlot 更全面。它不仅能画曲线，还能做 3D 飞行轨迹回放、参数对比、甚至事件标记。

我记得第一次用 Mission Planner 分析一次炸机事故，就是靠它的 3D 回放功能，发现飞机在最后 10 秒出现了剧烈的翻滚，结合姿态数据，最终定位到是陀螺仪故障。

核心功能一览：

• 图形化日志浏览：左侧选择消息类型，右侧显示曲线。支持多图联动，拖动时间轴时所有图表同步滚动。
• 3D 飞行回放：在 Flight Data 页面，点击 Play 按钮就能看到飞机在三维空间中的姿态和轨迹。这个功能对分析撞树、撞楼之类的事故特别直观。
• 参数对比：可以把两次飞行的参数放在一起对比。比如调整了 PID 参数后，看响应曲线有没有改善。
• 事件标记：在日志时间轴上可以添加标记，方便后续回顾。我习惯在模式切换、故障触发等关键节点打上标记。

Mission Planner 的日志查看器还有一个优势——社区支持。很多飞控固件开发者会直接在 Mission Planner 里分析日志，所以你能找到大量的教程和案例。遇到看不懂的数据，去 ArduPilot 论坛搜一下，基本都能找到答案。