一、飞控日志概述：读懂飞行器的“黑匣子”
各位同学，欢迎来到《日志分析快速定位飞控故障》的第一章。我是你们的老朋友，一个在飞控领域摸爬滚打了十几年的工程师。今天咱们聊聊最基础，但也最容易被忽视的东西——飞控日志。
很多人觉得，日志嘛，不就是一堆数字和文字？其实不然。我常说，飞控日志就是飞行器的“黑匣子”。飞机出事了，黑匣子能告诉我们真相；无人机炸机了，日志就是唯一的目击证人。你想想看，没有日志，你连飞机是怎么掉下来的都不知道，那还怎么修？
1.1 什么是飞控日志？
飞控日志，说白了就是飞行控制器在运行过程中，实时记录下来的“工作日记”。它把传感器数据、控制指令、状态变化、错误事件等等，一股脑儿地写进文件里。
具体来说，日志里通常包含这些信息：
- 传感器原始数据：陀螺仪、加速度计、磁力计、气压计、GPS 的读数。
- 状态估计结果：姿态角（横滚、俯仰、偏航）、位置、速度、高度。
- 控制输出：电机 PWM 值、舵机角度、控制模式切换。
- 系统事件：解锁、上锁、报错、参数变更、校准状态。
- 外设通信：遥控器信号、数传链路质量、SD 卡读写状态。
嗯，这里要注意，日志不是随便记的。它是有固定格式和采样率的。比如 IMU 数据可能 1000Hz 记录，而 GPS 数据只有 10Hz。理解这个采样率差异，对后续分析至关重要。
核心观点：飞控日志是飞行器行为的“数字孪生”。你在地面上回放日志，就等于在虚拟世界里重飞了一遍当时的任务。所有异常，都能在日志里找到蛛丝马迹。
1.2 日志的作用与价值
我经常跟团队里的新人说：“不会看日志，就别谈修飞控。” 日志的价值，体现在三个层面：
- 故障定位：炸机后，通过日志反推事故原因。是传感器漂移？电机堵转？还是 GPS 丢星？日志会告诉你答案。
- 性能调优：飞行手感不好、悬停不稳、航线偏差大。通过分析日志里的控制响应曲线，你能精准地调整 PID 参数。
- 开发验证：新功能上线前，跑一遍日志对比。看看改动后的行为是否符合预期，有没有引入新的 bug。
我记得有一次，客户反馈飞机在自动返航时突然侧翻。我们拿到日志一看，发现磁力计在某个航向上出现了剧烈的跳变，导致偏航角估计错误。这就是典型的“硬铁干扰”问题。如果没有日志，你根本不可能复现这个场景。
个人经验：我建议每个飞控开发者都养成一个习惯——每次飞行后，不管有没有炸机，都把日志下载下来，简单扫一眼关键参数。这就像飞行员做飞行后检查一样，能帮你发现很多潜在隐患。
1.3 常见飞控日志系统：PX4 与 ArduPilot
目前主流的开源飞控，就是 PX4 和 ArduPilot 两家。它们的日志系统各有特色，我分别说一下。
| 对比项 | PX4 | ArduPilot |
|---|---|---|
| 日志格式 | .ulg（主格式），也支持 .csv 导出 | .bin（二进制），.log（文本） |
| 记录机制 | 基于订阅-发布模型，按主题记录 | 基于消息 ID，按固定速率轮询 |
| 默认采样率 | 高（IMU 可达 1000Hz） | 中等（IMU 通常 400Hz） |
| 分析工具 | FlightPlot、ULogViewer、pyulog | Mission Planner、MAVExplorer |
| 适用场景 | 学术研究、高动态飞行 | 工业应用、长航时任务 |
我个人习惯是，PX4 的 .ulg 格式更紧凑，数据密度高，适合做精细分析；ArduPilot 的 .bin 格式则更成熟，工具链完善，适合现场快速排查。
你可能会问：为什么不用同一个格式？其实这跟两个项目的设计哲学有关。PX4 追求实时性和灵活性，所以用了自定义的 ULog 协议；ArduPilot 更看重兼容性和稳定性，所以沿用了一直以来的二进制格式。
1.4 日志文件格式详解
三种常见的日志格式，咱们一个一个说清楚。
.bin 格式（ArduPilot）
二进制格式，体积小，写入快。ArduPilot 的默认格式。需要用 Mission Planner 或 MAVExplorer 来解析。我曾经在野外调试时，SD 卡坏了，日志只写了一半。用十六进制编辑器打开 .bin 文件，硬是把前半段的数据读了出来。虽然麻烦，但关键时刻能救命。
.ulg 格式（PX4）
ULog 是 PX4 的专属格式。它把数据分成多个主题（topic），每个主题有自己的数据类型和频率。比如 sensor_accel 主题记录加速度计数据，vehicle_attitude 记录姿态四元数。这种结构化的设计，让数据检索非常高效。
# 一个典型的 .ulg 文件结构示例
# 文件头：魔数、版本、时间戳
# 定义段：消息类型、格式、名称
# 数据段：时间戳 + 主题数据包
# 结尾段：索引信息
[HEADER]
magic = 'ULog'
version = 1
timestamp = 1234567890
[DEFINITIONS]
message: sensor_accel { int64 timestamp; float[3] x; float[3] y; float[3] z; }
message: vehicle_attitude { int64 timestamp; float[4] q; }
[DATA]
timestamp=1000, sensor_accel: x=0.1, y=0.0, z=-9.8
timestamp=1001, sensor_accel: x=0.1, y=0.0, z=-9.8
timestamp=2000, vehicle_attitude: q=[1.0, 0.0, 0.0, 0.0]
.log 格式（ArduPilot 文本模式）
纯文本格式，可以直接用记事本打开。但体积大，写入慢，一般只用于调试阶段。生产环境很少用。
避坑指南：我曾经遇到过一个问题——日志文件损坏，打不开。后来发现是 SD 卡质量太差，写入速度跟不上。从此以后，我坚持使用 Class 10 以上的高速 SD 卡，并且每次飞行前都会格式化一遍。别小看这个细节，它能帮你省下很多排查时间。
1.5 知识体系总览
为了让你对本章内容有个整体印象，我画了一张图。它把飞控日志的核心概念、格式、工具和价值串在了一起。
这张图把本章的核心脉络理清了。从定义出发，到价值、格式、系统、工具，层层递进。后面的章节，我们会沿着这个框架，一步步深入下去。
好了，第一章就到这里。记住，日志是你最好的朋友。别怕它复杂，也别嫌它麻烦。等你真正学会看日志，你会发现，飞控系统在你面前，就像一本打开的书。