feat: 开放小爱音箱 Pro 刷机教程

This commit is contained in:
Del Wang
2025-04-13 18:57:41 +08:00
parent aebf94d5cd
commit a863da3067
10 changed files with 119 additions and 38 deletions
+1 -14
View File
@@ -9,19 +9,6 @@
- 禁用系统自动更新(系统更新后需要重新刷机打补丁)
- 添加开机启动脚本 `/data/init.sh`(方便执行一些初始化脚本)
## 准备条件
> [!IMPORTANT]
> 本教程仅适用于 **小爱音箱 ProLX06** 和 **Xiaomi 智能音箱 ProOH2P** 这两款机型,**其他型号**的小爱音箱请勿直接使用!🚨
- 小爱音箱 ProLX06、OH2P
- Windows 电脑(需为 x86_64 架构,用于刷机)
- 数据线(不能只是充电线,需要连接到电脑传输数据)
- Type-C(适用于新款小爱音箱 Pro,无需拆机)
- Micro USB(旧款小爱音箱 Pro 用这种,需要拆机)
## 下载固件
你可以直接在 [Github Releases](https://github.com/idootop/open-xiaoai/releases) 页面下载打包好的固件:
@@ -79,7 +66,7 @@ SSH_PASSWORD=open-xiaoai
- Dockerhttps://www.docker.com/get-started/
> [!NOTE]
> Windows 系统推荐使用 Git Bash 终端运行。
> Windows 系统推荐使用 [Git Bash](https://git-scm.com/downloads) 终端运行。
>
> CMD 和 PowerShell 终端需要调整下面命令中文件(夹)的实际路径。
+3 -8
View File
@@ -13,7 +13,7 @@
## 编译运行
> [!IMPORTANT]
> 本项目仅作为挖掘小爱音箱潜力的一个演示,并未提供任何预构建产物,仅适合有动手能力的人自行编译运行。你可以按需修改源代码,增删自己想要的功能。
> 本项目只是一个简单的演示程序,抛砖引玉,并未提供任何预构建产物,仅适合有动手能力的人自行编译运行。你可以按需修改源代码,增删自己想要的功能。
首先,你需要在电脑上安装 `Rust` 开发环境 👉 [传送门](https://www.rust-lang.org/)
@@ -28,7 +28,7 @@ cross build --release --target armv7-unknown-linux-gnueabihf
```
> [!NOTE]
> 以下操作需要先将小爱音箱刷机, 然后 SSH 连接到小爱音箱。
> 以下操作需要先将小爱音箱刷机, 然后 SSH 连接到小爱音箱。👉 [教程](../../docs/flash.md)
编译成功后,将构建好的补丁程序 `client` 复制到小爱音箱上
@@ -63,18 +63,13 @@ curl -# -o /data/client https://你的client文件下载链接
chmod +x /data/client
# 运行
/data/client ws://你的 server 端地址
/data/client ws://你的 server 端地址(默认使用 4399 端口)
# 比如:/data/client ws://192.168.31.227:4399
```
## 注意事项
> [!TIP]
> 旧版小爱音箱 Pro 的可用 RAM 和 ROM 均为 10MB 左右
>
> 新版 Xiaomi 智能音箱 Pro 约为 100MB(升级为旧版的 10 倍!)
当前 Client 端使用 Rust 编写,只负责转发和被动响应 Server 端的调用,不实现具体的业务逻辑。
一方面,小爱音箱的内存算力和存储空间极为有限,语音识别之类的任务并不适合放在 Client 端侧运行。
+6 -3
View File
@@ -25,8 +25,6 @@ pnpm install
pnpm dev
```
## 注意事项
首次运行你需要先配置自己的大模型服务,才能正常获取 AI 回复。
> [!NOTE]
@@ -57,7 +55,12 @@ async function main() {
main();
```
默认 Rust Server 在启动时,并没有开启小爱音箱的录音能力。如果你需要在 Node.js 端正常接收音频输入流,或者播放音频输出流,请将 `src/server.rs` 文件中被注释掉的 `start_recording``start_play` 代码加回来,然后重新编译运行。
## 注意事项
1. 默认 Server 服务端口为 `4399`(比如 ws://192.168.31.227:4399),运行前请确保该端口未被其他程序占用。
2. 默认 Rust Server 在启动时,并没有开启小爱音箱的录音能力。
如果你需要在 Node.js 端正常接收音频输入流,或者播放音频输出流,请将 `src/server.rs` 文件中被注释掉的 `start_recording``start_play` 代码加回来,然后重新编译运行。
> [!NOTE]
> 本项目只是一个简单的演示程序,抛砖引玉。如果你需要更多的功能,比如唤醒词识别、语音转文字、连续对话等(甚至是对接 OpenAI 的 [Realtime API](https://platform.openai.com/docs/guides/realtime)),可参考本项目代码,自行实现想要的功能。