Blackbox 日志基础入门(安装、导出)新手教程

国药准字H前天 09:20:42

适用:Betaflight,FPV 穿越机,用于试飞后分析震动、PID 震荡、电机异常、电调丢步,定位调参问题 一、Blackbox 是什么Bla...

适用:Betaflight,FPV 穿越机,用于试飞后分析震动、PID 震荡、电机异常、电调丢步,定位调参问题

 一、Blackbox 是什么

Blackbox(黑盒)就是飞控自带记录仪,飞行时记录陀螺仪、PID 输出、电机转速、油门、摇杆通道等数据。

飞机肉眼看不出的细微抖动、震荡,日志里可以直接看波形,是调参、排查故障最核心工具。

 ⚠️ 黑盒不是事故录像,只存数据,不存图传画面。

 二、硬件准备(存储介质)

Betaflight 黑盒存储两种方案:

1. Flash 闪存(飞控板载 SPI Flash):绝大多数新款飞控自带,容量小(4MB/8MB/16MB),短时间试飞够用,适合日常调参。优点:不用额外插卡;缺点:记录时间短,满了会覆盖旧日志。

2. SD 卡(TF 卡):大容量,适合长时间飞行、连续多轮试飞。

   - 推荐规格:16G~32G,Class10,FAT32 格式

   - ❌ 避坑:不要用大容量 64G + 卡,容易识别失败;高速 U3 卡部分老飞控兼容性差。

接线:飞控 SD 卡槽直接插卡;部分飞控需要在 UART 开启 SD 卡外设(大部分集成卡槽无需额外 UART)

 三、Betaflight 配置端开启黑盒(电脑 BF 调参软件)

1. 飞控 USB 连接电脑,打开 Betaflight Configurator,连接飞控

2. 左侧菜单找到 **Blackbox** 页面

3. 【Blackbox logging device】日志存储设备,二选一

   - `Flash`:板载闪存

   - `SD Card`:TF 卡

4. 【Logging mode】记录模式(新手推荐)

   - `Always`:上电就开始记录(简单,但是会占用存储空间)

   - `When armed`:解锁后才记录(强烈推荐新手),上锁自动停止,节省空间

   - `When armed + switch`:解锁 + 通道开关控制记录,进阶用法

5. 【Blackbox rate】日志采样率

   - 5 寸竞速机:1kHz(足够日常 PID 调参,文件体积适中)

   - 高转速小机(1S 65mm):可 2kHz;4kHz 文件巨大,SD 卡压力高,新手不建议

6. 【Debug debug mode】调试变量(重点!)

调 PID 震动:选`GYRO_SCALED`

看 PID 输出:选`PID`

看电机输出:选`MOTOR`

每次只开 1 组 Debug,开太多会占用带宽,日志异常

7. 点击页面右下角 Save 保存设置

 配套提醒:如果选 SD 卡,SD 卡必须先格式化:FAT32,分配单元大小 4096 字节。

四、试飞采集日志

1. 保存参数后,断开 USB,给飞机上电

2. 解锁,正常试飞,复现你遇到的问题(抖动、震荡、电调异响等)

3. 上锁,停止记录,断电

✅ 最佳操作:有问题的那一段飞行尽量短一点,日志小,后面分析更轻松。

五、导出日志,两种方法

方法 A:板载 Flash 导出(无 SD 卡)

1. USB 连飞控,打开 BF,进入 Blackbox 页面

2. 页面上方会显示:已存储日志数量、剩余空间

3. 点击 `Save blackbox data`

4. 弹出窗口,选择保存位置,文件名建议备注:机型 + 日期 + 现象,例:5 寸_20261022_P 震荡

5. 保存得到文件后缀:`.bbl`(Betaflight 黑盒原始日志文件)

方法 B:SD 卡存储日志导出

1. 飞机断电,取出 TF 卡

2. 读卡器插电脑,打开 SD 卡目录

3. 日志文件直接放在根目录,文件名`LOG001.TXT`、`LOG002.TXT`

SD 卡模式下是 txt,Flash 导出是 bbl,两者都可以用黑盒查看器打开。

 六、日志查看工具安装(Blackbox Viewer)

方案 1:在线网页版(新手首选,不用安装软件)

Betaflight 官方在线黑盒查看器:shturl.cc/9NRlDKZ6qafAy

- 打开网页,直接拖拽 `.bbl` 或者 `.txt` 日志文件进去,立刻加载波形

- 优点:免安装,跨平台;缺点:大日志加载会卡顿

 方案 2:本地 Blackbox Explorer(PC 客户端,推荐长期调参)

1. Github 搜索 `blackbox-explorer` 下载对应系统版本(Windows/macOS)

2. 解压直接使用,无需安装

3. 打开软件,Load log,选中 bbl/txt 日志加载波形

适合深度分析,放大波形、导出截图,做 PID / 震动分析。

七、新手常见坑

1. 解锁但是没有日志:

   - 检查 Logging Mode 是不是 When armed;SD 卡没格式化 / 损坏;Flash 空间已满

2. 日志打开是空的、波形断断续:

   - 采样率太高,SD 卡读写跟不上,降低采样率;或者 Debug 变量开太多

3. Flash 容量很快满:

   - Blackbox 页面点 `Erase Flash` 清空闪存,重新记录

4. 日志文件打不开:

   - 飞行中途断电,日志文件损坏,需要重飞重新采集

八、简单实操流程总结

设置存储设备 → 选择解锁记录 → 设置采样率 + Debug 变量 → Save → 试飞复现故障 → 上锁断电 → 导出日志 → 网页 / 本地工具打开看波形

用手机扫码体验更多功能

扫码查看6条评论