一、日志基础入门：什么是飞行日志？
大家好，我是老张，搞无人机飞控系统有些年头了。今天咱们聊聊飞行日志——这玩意儿说白了，就是无人机飞行的「黑匣子」。
你想想看，飞机飞上天，出了故障怎么办？光靠眼睛看肯定不行。飞行日志就是记录下飞控系统每一毫秒的状态数据。我习惯把它比作飞机的「体检报告」，而且是实时动态的那种。
1.1 飞行日志到底是什么？
飞行日志，是飞控系统在运行过程中自动生成的数据文件。它记录了传感器原始数据、控制指令输出、状态估计结果、电机转速、GPS信息等等。说白了，就是飞控大脑在想什么、做了什么，全都被写进了这个文件里。
举个例子，我手头有个PX4飞控的日志文件，打开后能看到这样的数据流：
# 时间戳(us) 陀螺仪X(rad/s) 陀螺仪Y 陀螺仪Z 加速度X(m/s²) 加速度Y 加速度Z
1234567890 0.012 -0.008 0.003 9.81 0.02 -0.01
1234567891 0.011 -0.007 0.004 9.80 0.01 -0.02
1234567892 0.013 -0.009 0.002 9.82 0.03 -0.01
嗯，这里要注意，不同飞控系统的日志格式不太一样，但核心思想是一样的——把飞行过程中的关键数据都记录下来。
1.2 日志的作用与价值
我经常跟团队里的新人说：不会看日志的飞手，就像闭着眼睛开车。日志的价值体现在几个方面：
- 故障诊断：飞机炸了？别急着哭。打开日志，看看是电机堵转、GPS丢星还是IMU数据异常。我在项目中遇到过好几次，用户说「飞机突然失控」，结果日志一看，是电池电压骤降导致飞控重启。
- 性能优化：调参的时候，日志就是你的「照妖镜」。PID参数调得好不好，看日志里的响应曲线就知道了。
- 事故复盘：炸机不可怕，可怕的是不知道为什么会炸。日志能帮你还原事故现场，找到根本原因。
- 合规审计：有些行业应用（比如农业植保、电力巡检），需要保留飞行日志作为作业凭证。
核心观点：飞行日志是无人机系统的「数字孪生」。没有日志，你就是在盲飞。
1.3 主流飞控日志系统介绍
目前市面上主流的开源飞控，主要是PX4和ArduPilot。这两家的日志系统各有特色，我分别说说。
1.3.1 PX4日志系统
PX4使用的是ULog格式（Unified Logging Format）。这是一种二进制日志格式，效率高、体积小。我个人比较喜欢它的设计——数据按主题（topic）组织，每个主题对应一个数据流。
举个例子，你想看姿态数据，就找 vehicle_attitude 这个主题；想看GPS数据，就找 vehicle_gps_position。这种设计让日志分析变得非常清晰。
PX4日志的典型结构：
ULog文件结构：
├── 文件头（magic number + 版本号）
├── 定义段（消息类型定义）
├── 数据段（实际数据记录）
│ ├── vehicle_attitude (100Hz)
│ ├── vehicle_gps_position (5Hz)
│ ├── actuator_outputs (400Hz)
│ └── sensor_combined (1000Hz)
└── 结尾标记
我曾经帮一个用户分析炸机原因，就是通过PX4日志里的 sensor_combined 数据发现，他的IMU在起飞后第3秒出现了剧烈的数据跳变——嗯，传感器坏了。
1.3.2 ArduPilot日志系统
ArduPilot使用的是自己的日志格式，通常以 .bin 或 .log 结尾。它的日志系统叫「DataFlash」，设计思路和PX4不太一样。
ArduPilot的日志是按「消息类型」来组织的。每个消息类型有一个固定的ID，比如：
| 消息ID | 消息名称 | 描述 | 记录频率 |
|---|---|---|---|
| ATT | 姿态数据 | 滚转、俯仰、偏航角 | 10Hz |
| GPS | GPS数据 | 经纬度、高度、速度 | 5Hz |
| IMU | IMU原始数据 | 加速度、角速度 | 100Hz |
| MOT | 电机输出 | 各电机PWM值 | 50Hz |
| ERR | 错误信息 | 系统错误码 | 事件触发 |
ArduPilot的日志有个好处——它默认记录了很多调试信息，对新手比较友好。但坏处是，日志文件可能会比较大。我建议在正式飞行前，先调整好日志记录级别，别什么都记，否则飞一次就能把SD卡写满。
小技巧：不管是PX4还是ArduPilot，我都建议在第一次试飞时开启「全量日志」模式。等飞控调稳了，再根据需求精简日志内容。这样万一炸机，你手里有最完整的数据。
1.4 知识体系总览
为了让大家更直观地理解本章的知识结构，我画了一张图：
避坑指南：我曾经遇到过一位用户，飞了半年从来没看过日志。结果某天飞机突然失控炸了，他想分析原因，发现SD卡里空空如也——原来他买的飞控板默认没插SD卡。所以，拿到新飞控的第一件事，就是检查日志功能是否正常开启。
好了，这一章的内容就到这里。日志这东西，说白了就是飞控的「记忆」。你越了解它，就越能掌控你的无人机。下一章我们会深入聊聊如何用工具打开和查看这些日志文件。