feat: 添加 macOS 专用小爱音箱刷机工具

2025-04-14 23:39:18 +08:00
parent b7716e8654
commit 29f4f77c7a
5 changed files with 206 additions and 6 deletions
@@ -0,0 +1,49 @@
+# Open-XiaoAI Flash Tool
+
+小爱音箱刷机工具（macOS 专用版）
+
+> [!NOTE]
+> 本工具基于 [@khadas/utils](https://github.com/khadas/utils/tree/master/aml-flash-tool)，macOS 二进制文件来自 [@numbqq](https://github.com/numbqq)，特此鸣谢！
+
+> [!CAUTION]
+> 刷机有风险，操作需谨慎。刷机可能会造成设备失去保修资格，变砖无法运行等。请自行评估相关风险，一切后果自负！🚨
+
+
+## 安装依赖
+
+请先在 macOS 上使用 [Homebrew](https://brew.sh/zh-cn/) 安装 `libusb-0.1.4.dylib` 依赖。
+
+```shell
+brew install libusb-compat
+```
+
+## 使用方法
+
+```shell
+# 授予可运行权限
+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
+
+```