【产出】 > 把 PX4 的 ULog 飞行日志从飞控里取出来,上传到 Flight Review,按顺序判断振动是否超标、姿态是否跟得上设定值、电池电压和电量估算是否正常,并知道发现问题后该改哪里。
【版本】 > 依据 PX4 官方文档 main 分支(Flight Reporting、Logging、Flight Log Analysis、Log Analysis using Flight Review、Vibration Isolation、Battery Estimation Tuning)和 QGroundControl 用户指南编写,适用于使用 ULog 格式日志的 PX4 版本。
一、PX4 什么时候记日志、记在哪里
PX4 的日志由 logger 模块写入,格式是 ULog(扩展名 .ulg)。它可以记录任何 uORB 话题的全部字段。
默认行为(参数 SDLOG_MODE = 0):解锁时开始记录,上锁时停止,每次解锁生成一个新文件,写在 SD 卡上。所以一次"飞行"对应一个日志文件。没有解锁就不会有日志,这是"刚才调试了半天,日志里什么都没有"的常见原因。
SDLOG_MODE | 何时记录 |
|---|---|
| 0 | 解锁到上锁(默认) |
| 1 | 上电到上锁 |
| 2 | 上电到关机 |
| 3 | 遥控 AUX1 通道大于 30% 时 |
| 4 | 第一次解锁到关机 |
想排查"解锁前就出问题"(例如上电后传感器异常导致无法解锁),把模式改成 1,就能录到上电以后的数据。改动需要重启生效。
在控制台手动控制(QGC 的 MAVLink Console 或 SITL 的 pxh>):
logger status # 查看当前是否在记录
logger on # 立即开始记录,相当于已经解锁
logger off # 停止当前记录
存储与清理:日志放在按日期命名的目录(如 2024-01-15)里,系统没有有效时间时放在 sess001 这样的会话目录里。PX4 会自动清理旧日志:磁盘占用默认不超过 90%(SDLOG_ROTATE),单个文件默认最大 1024 MB(SDLOG_MAX_SIZE),超出后从最旧的日志开始删除。重要的飞行要及时下载。
SD 卡:NuttX 支持的最大容量是 32 GB。官方测试中 SanDisk Extreme U3 32GB 和 Samsung EVO Plus 32GB 表现可靠。默认话题的记录带宽约 50 KB/s,几乎所有卡的平均写速都够;真正影响的是偶发的长时间写入停顿,会造成日志"掉数据(dropout)"。可以在控制台测一下自己的卡:
sd_bench -r 100
二、下载日志的三种方式
| 方式 | 操作 | 适用 |
|---|---|---|
| QGC 下载 | Analyze → Log Download,点 Refresh 列出日志,勾选后 Download | 最常用,USB 或数传都可以,数传下载大文件很慢 |
| 读卡器 | 断电后取出 SD 卡,直接拷贝 .ulg 文件 | 文件大、数量多时最快 |
| MAVLink 日志流 | 通过 MAVLink 实时把日志数据发到地面站 | 飞控没有 SD 卡槽,或者希望不碰 SD 卡;链路至少要约 50 KB/s,例如 WiFi |
QGC 的 Log Download 页面还提供全选、按时间排序和 Erase All(清空飞控上的全部日志)。
【注意】 > Erase All 不可恢复。 清空前确认需要的日志已经下载到电脑并能正常打开。出过事故的那次飞行,建议同时保留 SD 卡原始文件。
飞行中途断电的日志:日志在空中突然结束,官方说明主要有两种可能,供电中断或者操作系统硬故障(hard fault)。基于 STM32 的飞控会把硬故障记录到 SD 卡根目录,文件名形如 fault_2017_04_03_00_26_05.log。日志戛然而止时,先看 SD 卡根目录有没有这类文件:有,说明是软件崩溃;没有,优先怀疑供电。
【提示】 > 加密日志无法用 QGC 下载,也不能上传到公共的 Flight Review,需要用官方的日志加密工具处理。
三、上传到 Flight Review,或者离线查看
Flight Review 是 PX4 官方的在线日志分析工具(https://logs.px4.io/)。上传 .ulg 文件后会生成一个分析页面,并通过邮件发给你链接。这个链接可以直接贴到 PX4 论坛或 GitHub issue 里,请别人帮忙看。
QGC 的 PX4 Log Transfer 设置页还可以配置自动上传:填写邮箱、描述、风力、飞行评价,选择是否公开,打开 Enable automatic log uploads 后,下载完日志就会自动上传。
【注意】 > 日志里包含飞行轨迹的 GPS 坐标。上传时如果勾选公开(Make this log publicly available),任何人都能看到你的飞行地点。只想自己看或者涉及敏感场地时,不要公开。
离线查看:不方便上传时,可以用官方的 Python 工具 pyulog 在本地查看:
pip install pyulog
ulog_info flight.ulg # 日志时长、掉数据统计、硬件和软件版本、每个话题的数据量
ulog_params flight.ulg params.txt # 导出本次飞行时的全部参数
ulog2csv flight.ulg # 每个话题导出成一个 CSV 文件
ulog_info 输出的第二行 Dropouts 就是掉数据统计,可以先看这一项判断日志本身是否可信。需要看所有话题、任意字段画图时,官方推荐 PlotJuggler,Flight Review 只展示其中一部分数据。
四、先建立分析的上下文
拿到日志不要直接盯着某张图找问题。官方给出的结构化分析思路,整理成四个问题:
- 日志记录完整吗? 如果是事故后分析,日志是录到了坠地,还是在空中就断了(断了就回到上一节的供电 / 硬故障判断)。
- 控制器跟住设定值了吗? 最简单的判断方法是比较横滚、俯仰的角速度和它们的设定值。
- 传感器数据可信吗? 有没有很强的振动。官方给的经验阈值是:峰峰值超过 2–3 m/s² 就算强振动。
- 是不是 PX4 本身的问题? 如果根因不在你的飞机上,带上日志链接(有视频更好)到 PX4 的 issue 上报告。
Flight Review 的图表有两个通用特点:曲线背景颜色表示当时的飞行模式,鼠标悬停可以看到模式名称;在坐标轴上滚动鼠标滚轮缩放该轴,在图内滚动同时缩放两个轴。分析时要把时间缩放到你关心的那一段,比如悬停段或出问题的那几秒。
五、重点一:振动
振动是多旋翼最常见的问题。官方列出的后果包括:效率下降、续航变短、电机发热、部件磨损加快、无法把参数调得更紧、传感器削波,严重时位置估计失败导致飞机乱飞。
官方特别提醒,判断振动要同时看几张图,单看一张可能漏判。
1. Raw Acceleration(原始加速度)
显示加速度计 x、y、z 三轴的原始测量值。
- 理想情况下每条线都很细,能清楚看出飞机的加速过程。
- 经验判断:悬停或慢速飞行时,z 轴曲线碰到了 x / y 轴曲线,振动就太大了。
- 先把时间缩放到一段悬停再看。
2. Acceleration Power Spectral Density(加速度功率谱密度)
横轴是时间,纵轴是频率,颜色越黄表示该时刻该频率的能量越大(三轴求和)。
- 理想情况:只有最下面几赫兹是黄色,其余大部分是绿色或蓝色。
- 在 100 Hz 左右出现一条线,常常是螺旋桨的桨叶通过频率。
- 整张图几乎全黄,官方明确说不要以这样的振动水平飞行。
3. Actuator Controls FFT(控制量频谱)
显示角速度控制器输出(PID 输出)在横滚、俯仰、偏航三个轴上的频谱,用来找频率峰值、配置软件滤波器。
- 理想情况:只在最低端(大约 20 Hz 以下)有一个峰,其余又低又平。
- 不同飞机之间纵轴刻度不能直接比较,同一架飞机的不同日志可以直接比较。
- 这张图需要打开高速率记录才会显示,见下面的参数设置。
官方举的一个典型反例:起落架松动在 50 Hz 附近产生一个强峰。这类接近飞机动态的单一低频最麻烦,因为它低于软件滤波器的截止频率,滤不掉,只能从机械上解决。
4. 需要更详细数据时怎么设置
SDLOG_PROFILE 是位掩码,默认值 1(只开默认话题集)。常用的几位:
| 位 | 内容 | 用途 |
|---|---|---|
| 0 | 默认话题集 | 一般分析 |
| 4 | 高速率(遥控、姿态、角速度、执行器) | 角速度环调参,Actuator Controls FFT |
| 8 | 陀螺仪 FIFO 原始高速数据 | 看几 kHz 的高频振动 |
| 9 | 加速度计 FIFO 原始高速数据 | 同上 |
例如在默认集基础上加高速率记录,就是 1 + 16 = 17。
要记录 FIFO 原始数据时,官方建议:IMU_GYRO_RATEMAX 设为 400,用一张好的 SD 卡,只打开陀螺仪或加速度计其中一个 FIFO 位并关掉其他位(卡足够好时才同时打开)。测完记得把参数改回去,否则日志体积会大很多。
5. 发现振动大以后
官方的排查顺序:
- 检查所有部件是否固定牢靠,包括起落架、GPS 支架。
- 换用动平衡好的螺旋桨。
- 螺旋桨、电机、电调、机架的质量都会有明显影响。
- 飞控用减震方式安装(很多飞控附带减震泡棉,有的内部已经减震)。
- 最后才去调软件滤波器。从源头减小振动比在软件里滤掉更好。
【注意】 > 检查螺旋桨和电机时必须断开电池。不要在通电状态下用手转动或拨动螺旋桨。
六、重点二:姿态跟踪
1. 设定值与估计值
Flight Review 的姿态、角速度、速度、位置等图里,红线是估计值(Estimated),绿线是设定值(Setpoint)。红线应当紧贴绿线。
不同飞行模式跟踪的对象不同。例如自稳(Stabilized)模式下没有速度设定值,速度图里就没有绿线,这是正常的。
| 现象 | 常见原因 |
|---|---|
| 红线明显滞后于绿线 | 增益偏低,响应慢 |
| 红线越过绿线后来回摆 | 增益偏高,超调振荡 |
| 红线上叠着细密的毛刺 | 振动传进了控制器,先回到第五节 |
| 某一个轴始终跟不上 | 该轴增益问题,或者机械问题(电机歪、桨损坏) |
官方说法是:红线和绿线对不上时,大多数情况需要调整对应控制器的 PID 增益。看角速度环时,打开高速率记录(SDLOG_PROFILE 第 4 位)放大后细节更清楚。
2. Actuator Outputs(执行器输出)
这张图显示发给每个电机或舵机的信号,一般在设置的最小和最大 PWM 之间(例如 1000–2000)。正常的四旋翼,各电机的输出都在范围内、大致重叠、噪声不大。它能帮你发现:
- 饱和:一个或多个输出长时间顶在最大值。满油门时出现是正常的;在执行任务时出现,说明飞机对它的推力来说太重了。
- 重心或推力不平衡:相邻的电机(四旋翼是相邻两个)平均输出明显偏高。可能是重心偏、某些电机推力大,或者电调没有校准。飞控会自动补偿,但会降低最大可用推力、加重某些电机负担。
- 偏航不平衡:对角的电机一组高一组低,原因多半是有电机装歪了。
- 噪声很大:传感器噪声或振动传进了控制器,或者 PID 增益太高。
七、重点三:电池
电池相关的问题在日志里主要看三件事:电压够不够、电量估算准不准、电流有没有影响别的传感器。日志里的电池数据在 battery_status 话题中,可以用 ulog2csv 导出该话题的 CSV 自己画图(列名以导出的表头为准),也可以在 PlotJuggler 里直接拖出该话题的电压、电流和剩余电量曲线。
1. 带载电压有没有掉得太低
官方给出的单节电压经验值:
| 水平 | 锂聚合物 LiPo (V) | 锂离子 LiIon (V) |
|---|---|---|
| 保守值(空载电压) | 3.7 | 3 |
| "实际"最低值(带载、飞行中) | 3.5 | 2.7 |
| 损伤电池(带载) | 3.0 | 2.5 |
把日志里的总电压除以节数,看飞行末段的单节电压。如果带载电压已经接近 3.5 V,说明这包电池的续航已经用到头了;低于 3.0 V 就已经在损伤电池。
2. 电量估算是否平稳
只用电压估算电量时,电压在加油门时会因为电池内阻而下降,显示的剩余电量就会跟着油门上下跳。如果日志里剩余电量随推力明显波动,或者在飞行末段突然大幅下跌,需要回到电池设置:
| 问题 | 处理 |
|---|---|
| 显示电压和万用表实测不一致 | 校准分压系数 BAT1_V_DIV |
| 电流读数不准 | 校准 BAT1_A_PER_V(电流测量同时影响负载补偿和电流积分) |
| 剩余电量随油门跳动 | 确认负载补偿生效。BAT1_R_INTERNAL = -1(默认)时实时估算内阻;也可以填实测的单节内阻 |
| 末段电量骤降 | 使用电流积分时,BAT1_CAPACITY 填标称容量的 约 90%,不要填太高 |
官方给出的参考:锂聚合物电池单节内阻典型值约 5 mΩ,会随放电倍率、老化和健康状况变化,有的充电器可以测内阻。
3. 电流是否干扰磁罗盘
Thrust and Magnetic Field 图显示推力和磁场强度(磁力计测量向量的模)。磁场强度应当在整个飞行中保持恒定、并且和推力无关。
如果磁场强度跟着推力一起变化,说明电机或其他用电设备的电流在干扰磁场,会导致航向估计错误。官方给出的解决方法:使用外置磁罗盘,不要用飞控内置的;已经是外置的,就用更长的 GPS 支架让它离大电流线更远。磁场不恒定但和推力无关时,多半是没校准好,也可能是飞近了金属结构。
【注意】 > 锂电池过放会造成永久损伤,鼓包的电池有起火风险。日志显示单节带载电压低于 3.0 V 的电池,单独存放观察,不要再用于飞行。充电和存放都要在防火袋或防火箱中进行,充电时有人看守。
八、其他值得顺手看的图
| 图表 | 正常范围 | 异常时怎么办 |
|---|---|---|
| GPS Uncertainty | 卫星数约 12 颗以上;水平精度 < 1 m;垂直精度 < 2 m;fix 为 3 表示 3D 定位 | 检查天线位置和遮挡 |
| GPS Noise & Jamming | 干扰指示约 40 或以下;80 左右或更高就要检查 | 远离 USB 3 设备(已知的 GPS 干扰源)和发射类设备 |
| Estimator Watchdog | 一直为 0 | 非零说明估计器发现问题,多为传感器问题,看对应传感器的图 |
| Sampling Regularity | 掉数据少;IMU 采样间隔 delta t 接近 4 ms;estimator timeslip 保持为 0 | 掉数据多就换 SD 卡 |
| Logged Messages | 逐条看系统错误和警告 | 不是每条都代表问题,比如测试紧急停桨也会留下记录 |
九、每次飞完的检查清单
- 日志完整,
Dropouts很少,没有在空中中断 - 悬停段 Raw Acceleration 的 z 轴没有碰到 x / y 轴
- 功率谱密度大部分是绿色或蓝色,没有低频强峰
- 横滚、俯仰角速度的估计值紧贴设定值
- 执行器输出没有长时间饱和,各电机平均输出接近
- 飞行末段单节带载电压高于 3.5 V,剩余电量没有骤降
- 磁场强度恒定、与推力无关
- 卫星数、精度、干扰指示都在正常范围
参考资料
- PX4 飞行报告与日志下载:https://docs.px4.io/main/en/getting_started/flight_reporting.html
- PX4 日志记录(logger、SDLOG 参数、SD 卡):https://docs.px4.io/main/en/dev_log/logging.html
- PX4 飞行日志分析工具总览:https://docs.px4.io/main/en/log/flight_log_analysis.html
- 用 Flight Review 分析日志:https://docs.px4.io/main/en/log/flight_review.html
- PX4 减振:https://docs.px4.io/main/en/assembly/vibration_isolation.html
- PX4 电池估算设置:https://docs.px4.io/main/en/config/battery.html
- PX4 参数参考:https://docs.px4.io/main/en/advanced_config/parameter_reference.html
- QGC 日志下载:https://docs.qgroundcontrol.com/master/en/qgc-user-guide/analyze_view/log_download.html
- QGC PX4 日志传输设置:https://docs.qgroundcontrol.com/master/en/qgc-user-guide/settings_view/px4_log_transfer.html
- pyulog:https://github.com/PX4/pyulog
- Flight Review:https://logs.px4.io/
评价 (0)