固件升级指引
FIRMWARE UPGRADE
KABU 固件升级指引
适用固件：v1.9.9 正式版 更新日期：2026 年 10 月 18 日
本页面向所有 KABU 用户，介绍把设备升级到最新正式版的三种方法。不需要安装任何软件：前两种方法只用浏览器，第一种甚至不用记设备的 IP 地址。
升级前先确认
- 设备当前没有播放音乐；升级中会要求停止播放。
- 使用稳定电源；不要在雷雨、停电风险或电压不稳时升级。
- 升级过程中不要断电、拔线或关闭页面。
- 记下当前固件版本（管理首页"系统信息"中可查），升级后用于核对。
- 固件文件只从官网下载中心或 USB 在线 OTA 页面获取，不要使用来源不明的文件。
三种升级方法，选一个就行
| 方法 | 适合谁 | 需要什么 |
|---|---|---|
| 方法一：USB 在线直刷（推荐） | 想最省事的所有用户 | 一根 USB 数据线 + 桌面版 Chrome 或 Edge 浏览器 |
| 方法二：管理页 Web OTA | 已经会打开设备管理页的用户 | 手机或电脑浏览器 + 固件文件 |
| 方法三：手动下载后刷写 | 方法一、二都失败时的备用路 | USB 线 + 从网盘下载的固件文件 |
三种方法都会保留设备里的 Wi-Fi、设备名、均衡器、电台等设置，不需要重新配网。
方法一：USB 在线直刷（推荐）
- 用 USB 数据线把 KABU 连接到电脑（注意是数据线，不是只供电的线）。
- 在桌面版 Chrome 或 Edge 中打开官网的 USB 在线 OTA 页面。
- 点击页面上的连接按钮，在弹出的窗口中选择你的 KABU 设备。
- 页面会自动读取设备信息（芯片、当前版本），并获取官方已验收的最新固件。
- 点击开始升级。页面会依次完成下载校验、写入、读回校验和重启自检。
- 看到"升级成功"后，设备会自动重启并回到待机灯。
如果担心升级中断，页面还提供"写入前备份"选项，可以把当前固件先备份到电脑。
方法二：管理页 Web OTA
- 下载升级文件：打开官网固件下载中心，把最新版本的
kabu_ota_v*.bin下载到手机或电脑（认准kabu_ota_开头的文件；kabu_factory_开头的是工厂镜像，不能用于网页升级）。 - 在浏览器打开设备管理页
http://<设备IP>。 - 滚动到"固件升级"区域，确认当前版本。
- 点击选择文件，选中刚下载的
kabu_ota_v*.bin。 - 点击"上传并安装"，等待上传进度和"校验安装中"提示。
- 页面提示成功后，设备会自动重启；等待约 20～60 秒。
- 刷新管理页，在"系统信息"中确认版本号已更新。
提示"播放中无法升级"时：在手机端停止播放（不是暂停）、电台页面点"停止"，等几秒再上传。
方法三：手动下载后刷写
方法一、二都失败（例如设备已无法正常联网）时使用：
- 在固件下载中心页面通过网盘链接下载固件文件到电脑。
- 用 USB 数据线连接 KABU 与电脑，打开 USB 在线 OTA 页面并连接设备。
- 在页面的"从共享网盘下载过？"区域选择本地
kabu_ota_v*.bin文件。 - 核对页面显示的文件 SHA-256 与下载中心标注一致后，开始刷写。
升级后建议核对
- 管理首页"系统信息"中的固件版本与目标版本一致。
- 待机灯为模式颜色慢呼吸，投放一首歌确认出声。
- Wi-Fi、设备名、均衡器、电台列表都还在。
升级失败的兜底设计
- 设备使用双固件槽：新固件先写入备用槽，验证通过才切换；万一新版本启动失败，设备会在下次启动自动回退到上一个可用版本。
- 上传失败时，保留页面错误信息，确认旧版本仍能打开管理页后再试。
- 升级中断电导致设备无法启动时，不要反复尝试网页升级；使用方法一（USB 直刷）重刷，或联系售后。
从旧版本升级的特别说明
- v1.9.6 及更高版本可以直接升级到 v1.9.9，无需中间版本。
- 从更早版本升级后，首次开机可能需要约 1 分钟补齐语音提示素材，期间请保持通电。