小爱音箱自定义固件开发指南
小爱音箱自定义固件(xiaoai-patch) 是一个专为小米小爱音箱设计的开源项目,通过补丁和自定义二进制文件,让你彻底摆脱原厂限制,自由安装开源软件,打造专属智能语音助手。支持 LX06、LX01、LX05、L09A 等多款音箱型号,轻松实现智能家居控制、音乐播放等个性化功能。
为什么选择小爱音箱自定义固件?
原厂音箱往往受限于封闭系统,无法安装第三方应用或优化功能。而 xiaoai-patch 项目通过以下特性为你的音箱注入新活力:
- 100% 开源组件:所有代码基于开源许可,从底层补丁到应用层工具完全透明可修改
- 丰富媒体服务:集成 MPD 音乐播放器、Snapcast 多房间同步、Shairport-Sync AirPlay 支持
- AI 语音增强:支持 Porcupine 唤醒词引擎和 Whisper 语音识别
- 智能家居联动:可对接 Home Assistant 等平台,实现灯光、家电语音控制
支持设备与准备工作
已验证兼容型号
- LX06:主流热销型号,支持完整功能
- LX01/LX05:入门款性价比之选
- L09A:带屏幕版本适配
提示:不同型号需使用对应补丁,具体型号识别可参考 research/lx06/info.md
必备工具
- 电脑(Windows/macOS/Linux 均可)
- USB 数据线(部分型号需拆机焊接)
- 固件打包工具:tools/docker_firmware_build.sh
- 镜像处理脚本:tools/mico_firmware.py
快速安装步骤(以 LX06 为例)
1. 获取项目源码
git clone <repository_url>
cd xiaoai-patch
2. 配置固件参数
修改配置文件 api/config.py 设置:
- 网络参数(WiFi 名称/密码)
- 默认音频输出设备
- 启用的服务模块(如蓝牙/AirPlay)
3. 编译自定义固件
# 使用 Docker 环境构建(推荐新手)
bash tools/docker_firmware_build.sh lx06
# 或手动编译
make -j4
4. 刷入固件
- 将音箱进入恢复模式(具体方法参考 research/lx06/install.md)
- 连接电脑并执行刷机脚本:
python3 tools/mico_upgrade.py output/lx06_firmware.bin
警告:刷机有风险,请确保电量充足并严格遵循 docs/voice-assistant.md 中的安全指引
核心功能体验
打造全能音乐中心
- 多协议支持:AirPlay/DLNA/蓝牙无缝切换

