open-xiaoai/packages/flash-tool/README.md

Open-XiaoAI Flash Tool

小爱音箱刷机工具（macOS 专用版）

Note

本工具基于 @khadas/utils，macOS 二进制文件来自 @numbqq，特此鸣谢！

Caution

刷机有风险，操作需谨慎。刷机可能会造成设备失去保修资格，变砖无法运行等。请自行评估相关风险，一切后果自负！🚨

安装依赖

请先在 macOS 上使用 Homebrew 安装 libusb-0.1.4.dylib 依赖。

brew install libusb-compat

使用方法

# 克隆代码
git clone https://github.com/idootop/open-xiaoai.git

# 进入当前项目根目录
cd packages/flash-tool

# 授予可运行权限
chmod +x ./flash

# 查看使用说明
./flash help

# 小爱音箱刷机工具 v1.0.0  by https://del.wang
#
# 使用方法:
#   ./flash connect                   # 连接设备
#   ./flash delay <秒数>              # 设置启动延时，如 5 秒
#   ./flash switch <boot分区>         # 设置启动分区，如 boot0
#   ./flash system <分区> <固件路径>  # 把固件刷到指定分区，如 system0

# 第 1 步：连接设备
# 执行命令后拔掉小爱音箱的电源线，重新插上电源，等待设备连接
./flash connect

# 第 2 步：设置启动延时（5 秒）
./flash delay 5

# 第 3 步：切换启动分区
./flash switch boot0

# 第 4 步：刷写固件（注意替换固件文件的实际路径）
./flash system system0 root-patched.squashfs

Tip

如果你卡在第一步，连接不上设备，可以按照此教程排查问题。

Note

提示刷机成功之后，拔掉数据线和电源，重新插电重启小爱音箱即可。 如果重启之后小爱音箱没有反应，可以拔掉电源等几分钟再重新上电开机。 如果还是没反应，可以重新刷机试试看，或者将启动分区设置成 boot1 恢复原系统启动。