小爱音箱自定义固件完整实战指南:用 xiaoai-patch 把音箱改造成你的开源语音助手
【免费下载链接】xiaoai-patchPatching for XiaoAi Speakers (小爱音箱), add custom binaries and open source software. Tested on LX06, LX01, LX05, L09A项目地址: https://gitcode.com/GitHub_Trending/xia/xiaoai-patch
你家里的小爱音箱常年只能定闹钟、放流行歌,功能被厂商写死,想要多一点自由却无从下手。xiaoai-patch 是一套开源的小爱音箱定制固件工具集,通过几条命令,就能把音箱刷成支持 AirPlay、DLNA、MPD 和语音助手的全能设备,所有软件全部开源可查。
小爱音箱 LX06 主板(推荐改造型号),可见核心 SoC、存储芯片与无线射频模块
📌 项目定位:它是什么,适合谁
xiaoai-patch 是一个针对小爱音箱的补丁与脚本集合:它把固件里的私有软件移除,重新编译出一张装满开源软件的 rootfs 镜像刷回音箱。适合有动手意愿、想把闲置或入门款小爱音箱改造成DIY 语音助手和多协议音乐播放器的普通用户,推荐的 LX06 型号全程不需要焊接。
✨ 核心功能清单
- 开源纯净系统:移除全部小米私有软件,固件内容透明可改,不再被厂商锁定。
- 多协议音乐播放:内置MPD、Snapcast、Shairport-Sync、Upmpdcli、Squeezelite,AirPlay、DLNA、LMS 音源一次全支持。
- DIY 语音助手:用Porcupine做唤醒词、Whisper做语音识别,可对接Home Assistant实现语音控家。
- 远程管理能力:音箱自带 Web 配置页面和 SSH 终端,改网络、改配置不用拆机。
所有可安装的软件包源码都在 packages/ 目录,想加什么自己挑。
🧰 动手前的准备:兼容机型与环境要求
已测试确认支持的型号(以 research/ 各型号文档为准):
| 型号 | 说明 | 参考固件版本 |
|---|---|---|
| LX06 / L06A | 小米小爱音箱 Pro(黑色,带红外) | 1.74.10 |
| LX01 | 小米 AI 音箱 Mini | 1.32.6 |
| L09A | 小爱音箱 Art(白色) | 1.76.4 |
| LX05 | 小爱音箱 Play(加密分区) | 以官方文档为准 |
重要提示:LX05、L15A 等机型的 rootfs 分区带DER 证书做签名校验,刷入未签名固件可能直接无法启动。动手前建议用
binwalk检查原始镜像里是否有 Certificate 条目,有则不建议刷写。
环境与前置条件:
- 宿主机需要Linux(amd64 架构);WSL 用户务必开启
setCaseSensitiveInfo,Apple M1 与 Windows 原生环境未获支持。 - 预装
squashfs-tools、make、rsync、shasum和Docker。 - 刷机环节准备一条micro USB线:Windows 10 用 Amlogic Flash Tool,Linux 用 aml-flash-tool,LX06 的详细流程见 research/lx06/install.md。
- 全部软件包编译一次大约需要1 小时以上,请预留时间。
🚀 快速上手:五步刷出新固件
第一步:备份原始 rootfs
先从音箱取一份 rootfs 备份(官方升级包也可以):
dd if=/dev/mtd4 of=/tmp/image第二步:获取项目源码
git clone https://gitcode.com/GitHub_Trending/xia/xiaoai-patch想增删软件,先编辑 packages.sh 配置清单。
第三步:进入 Docker 构建环境
docker build -t xiaoai-patch packages docker run -it -v $PWD:/xiaoai xiaoai-patch重要提示:软件包编译过程会打系统补丁,必须放在 Docker 里运行,直接在宿主机执行可能污染你的 GNU/Linux 系统。
第四步:解包、打补丁、构建
一条命令完成 extract、patch、build 全流程:
sudo make clean all FILE=image-mtd4 MODEL=lx06MODEL 换成你自己的型号即可,可用型号见 Makefile。
第五步:写回音箱
音箱接 USB 线进入刷机模式后,把产出的root.squashfs写入system0/system1分区,具体命令按 research/lx06/install.md 执行。
🎯 刷完之后能玩什么:三个实战场景
场景一:把音箱变成全屋音乐中枢
手机上的 AirPlay 可以直接把音乐推给音箱,电脑上的 DLNA 媒体库走 Upmpdcli 播放,自建 LMS 音乐库由 Squeezelite 承接。几台设备同时在线时,音源可以无缝切换,音箱从此不再依赖任何云服务的曲库。
场景二:搭建你自己的语音助手
唤醒链路是:Porcupine 监听唤醒词 → 录音上传Home Assistant→ Whisper 做语音识别 → 识别为意图后执行动作,最后用 TTS 播报结果。整个过程不经过小米服务器,数据留在你本地。连接和参数配置(识别语言、唤醒词等)在 Web 页面完成,细节见 docs/voice-assistant.md。
场景三:多房间同步播放
装上Snapcast后,家里多台刷了固件的音箱(外加任意支持蓝牙的音箱)可以同步播放同一份内容,延迟一致,相当于一个轻量级的多房间音响系统。
小爱音箱 LX01(Mi AI Speaker Mini)主板,同样是 xiaoai-patch 支持改造的入门型号
⚠️ 避坑与救砖指南
- 刷错型号:L05G、L09G 等机型不在支持列表,刷错镜像基本等于变砖。
- 加密分区机型硬刷:LX05、L15A 的签名校验会让未签名 rootfs 失效,风险最高。
- 写错分区:音箱是 A/B 双分区设计,系统镜像写进 boot 分区会直接无法启动。
- 捆绑内核不兼容:部分新批次 LX06 的 NAND 芯片(如 FSNS8A001G)不识别旧版
boot.img,会进启动循环——原 boot 分区能正常启动就别动它。
重要提示:刷机前把 U-Boot 的
bootdelay设成 3 以上,并预留 TTL 串口线。只要任何时候能打断进入 U-Boot 菜单,你就握有救砖的最后底牌。
补救方案:
- 有原始备份:用同一套刷机工具把备份镜像原样写回对应分区即可恢复。
- 能进 U-Boot:在菜单里切换 A/B 启动槽,回到能启动的那个系统,再慢慢修复。
- U-Boot 进不去:接 TTL 串口拿到控制权,用
fw_setenv恢复启动参数。
❓ 常见问题
Q:刷完之后还能用米家 App 吗?A:不能。默认补丁会移除全部小米私有软件,音箱改由 Web 页面和 SSH 管理,智能家居能力则交给 Home Assistant。
Q:没有屏幕,怎么配 Wi-Fi?A:连按播放键5次,用手机的 improv-wifi 应用绑定音箱配网;在终端模式下也可以直接执行/bin/wifi_connect $SSID $PASSWORD。
Q:蓝牙配对怎么操作?A:连按播放键3次,音箱进入约 45 秒的配对窗口;也可以用/bin/bluetooth_pair命令。
Q:日常怎么管理这台音箱?A:浏览器访问音箱 IP(例如http://192.168.1.40)打开配置页,或直接 SSH 登录,补丁已把默认 root 密码改为root。
Q:不想编译,直接下现成固件行吗?A:可以。项目的 Releases 提供了各型号预编译固件包(如lx06.tar),下载后按安装指南刷写即可,跳过整个编译流程。
🏁 写在最后
xiaoai-patch 把一台功能写死的小爱音箱,变成了可拆解、可编译、可定制的开源设备,音频与智能家居的控制权真正回到你自己手里。建议先读一遍 docs/faq.md,确认型号在支持列表里,然后从备份 rootfs 这一步开始动手。现在就去翻出家里那台吃灰的音箱,先把备份命令跑起来吧。
【免费下载链接】xiaoai-patchPatching for XiaoAi Speakers (小爱音箱), add custom binaries and open source software. Tested on LX06, LX01, LX05, L09A项目地址: https://gitcode.com/GitHub_Trending/xia/xiaoai-patch
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考