小爱音箱自定义固件刷机实践：从机型核对到智能家居中枢

小爱音箱自定义固件刷机实践从机型核对到智能家居中枢【免费下载链接】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 用一套开源补丁和交叉编译脚本对小爱音箱刷机移除闭源系统装上 MPD、Snapcast、Shairport-Sync 等一组开源服务再把语音链路接到 Home Assistant让音箱变成多协议音乐播放器和智能家居语音入口。适合手里有闲置小爱音箱、想接入自建智能家居、并且能接受一次超过 1 小时编译时间的折腾者。动手前的两道门槛核对机型看清变砖风险编译主机只测试过 Linux amd64 环境Apple M1、Windows 未验证WSL 下需要开启setCaseSensitiveInfo。刷之前先对照下面这张表确认你的机器机型产品推荐固件版本注意事项LX06 / L06A小爱音箱 Pro黑色带红外 / 白色无红外1.74.10测试最充分首选机型LX01小米 AI 音箱 Mini白色1.32.6镜像上限约 30MB选包时留意体积L09A小爱音箱 Art白色1.76.4常规流程即可LX05小爱音箱 Play—rootfs 带签名证书属于加密分区刷写需谨慎LX06 内部还有 RAM 128/256MB、不同 WiFi 芯片Marvell、Realtek、NXP等变体但不影响补丁流程research/ 下按机型整理了各自的主板图和刷机指南值得刷前翻一遍。加密分区是最大的坑。LX05、L15A 这类较新型号的 rootfs 分区里嵌了一张 DER 格式x509 v3证书用于验证系统签名未签名的 squashfs 可能被拒绝启动直接锁死设备。刷之前用binwalk解析原始固件输出里如果出现Certificate in DER format条目就按加密机型对待。LX05 属于实验性支持L15A 未完全支持新手不建议碰。固件能力全景语音、音频、智能家居集成语音能力Porcupine 唤醒Whisper 识别固件内置 Porcupine 唤醒词引擎本地检测唤醒词可更换不同 keyword。唤醒后录音发往 Home Assistant由 WhisperSTT转文字、执行意图再用 TTS 播报结果。接入方式浏览器打开音箱 IP 的 80 端口如http://192.168.1.40在网页里填 HA 地址和 token也可以直接编辑音箱上的/data/listener文件配置 STT provider、语言、唤醒词。这一步是语音助手工作的前提不是可选项。音频能力多协议音乐播放MPD 作为主播放服务管理本地音频库。Snapcast 做多房间同步播放多台音箱跟播同一路源。Shairport-Sync 接收 AirPlay手机可以直接投音。Upmpdcli 处理 UPnP/DLNA 源Squeezelite 接 Logitech LMS。蓝牙链路基于 bluez 与 blue-alsa播放键进配对见后文 FAQ。智能家居集成接入 Home Assistant固件带 core_api HTTP 服务和 Web 配置页音箱相当于 HA 里的一个设备节点。接入之后语音控制米家灯光、窗帘等设备以及用语音询问传感器读数温湿度等都走 HA 的意图执行。日常管理则靠 SSH补丁会把 root 密码改成root和那个 Web 页面完成。刷机全流程从源码到写入第 1 步获取源码。git clone https://gitcode.com/GitHub_Trending/xia/xiaoai-patch补丁、构建脚本、软件包定义全部在这个仓库里后面所有命令都在仓库目录执行。第 2 步备份原 rootfs。音箱文件系统是只读 squashfs无法在线修改任何改动都要靠整包重写所以先把在跑的 rootfs 完整拷回电脑电脑端用nc -vlp 8888 $HOME/backup-image监听音箱端dd if/dev/mtd4 of/tmp/image再用nc推过去。这份文件既是编译输入也是回滚材料一步两用。第 3 步可选调整包清单。编辑 packages.sh 决定交叉编译哪些软件默认清单已覆盖语音助手所需组件只装常用项可以缩短编译时间。第 4 步用 Docker 编译软件包。docker build -t xiaoai-patch packages docker run -it -v $PWD:/xiaoai xiaoai-patch必须走 Docker编译过程会对系统文件打补丁跑在裸主机上有污染风险。全部包编译超过 1 小时中途别断电。第 5 步生成新镜像。在容器内一条命令完成三阶段sudo make clean all FILEimage-mtd4 MODELlx06extract 解包、patch 按 scripts/ 与 packages/ 里的规则依次打补丁、build 重新压回 squashfs产物落在release/目录。用file命令对比新旧镜像确认压缩格式与原图一致再往下走。第 6 步刷入未使用的分区。以 LX06 为例拆下底盖 6 颗橡胶脚垫下的螺丝micro USB 连电脑上电后约 2 秒内连续跑update.exe identify打断启动进入 Amlogic 刷机模式。先只写当前未使用的那份 rootfsA/B 双分区之一重启验证能正常开机确认无误再写另一份。保留一份可用系统就是随时可以回头的退路。LX06 的完整拆装与命令序列见 research/lx06/install.md。刷完之后的实际体验多房间同步播放家里三台不同机型LX06、LX01、L09A组一个 Snapcast 房间厨房、卧室跟播同一首曲LX01 这种小机器只是吃 30MB 镜像上限播放能力不打折。投音手机走 AirPlay 推给 Shairport-SyncNAS 上的 UPnP 媒体库走 Upmpdcli 落到 MPD音源切换不用换 App。语音中枢唤醒词触发后打开客厅灯这类指令经 Whisper 转写进 HA 执行再语音播报传感器读数配置项、日志/tmp/stt.*都能在 SSH 里直接查。救砖与回滚预案TTL 串口、Uboot、整盘备份先焊 TTL 串口。主板上有丝印的 RX、TX、GND 测试点接三根线连 USB 转串口模块。系统全挂时TTL 是看启动日志、进 Uboot 的最后通道。再设 Uboot 延迟。bootdelay0时 Uboot 不会停下等你按键先执行update.exe bulkcmd setenv bootdelay 15加saveenv把延迟写进环境分区。写入任何改动之前先确认上电能停在Hit any key to stop autoboot提示Uboot 是你的保险丝别在没验证它就工作的情况下动分区。最后整盘备份。刷机前用update.exe mread store把 mtd0 到 mtd6 逐块读出落盘核对文件大小出问题时按原样写回。回滚顺序先恢复 system 分区rootfs再检查 boot 分区。特别注意部分新版 LX06 换装了新 NAND日志出现nand: Unknown FSNS8A001G、nand init failed循环重启此时该回写的是你自己备份的原始 boot 分区而不是发布包里的旧boot.img——那个 2021 年的内核不认新芯片。常见问题与进阶资源Q刷机后还能用米家 App 吗A默认不能。补丁会移除全部小米闭源软件替换为开源组件。音箱改由 SSHroot 密码为root、Web 页面和 Home Assistant 管理语音控制米家设备走 HA 而不是米家 App。Q怎么连 WiFiA连按播放键 5 次进入配网模式手机装 improv-wifi 应用连接音箱完成配置或者在终端直接跑/bin/wifi_connect $SSID $PASSWORD。Q蓝牙怎么配对A连按播放键 3 次音箱进入约 45 秒的蓝牙配对窗口也可以执行/bin/bluetooth_pair。Q语音助手一直报 errorA先查/data/listener里 HA 地址和 token再查系统时间——时间漂移会导致 TLS 握手失败用ntpd -q -p pool.ntp.org手动同步转写记录和状态在/tmp/stt.log、/tmp/stt.json。更多条目见 docs/faq.md。进阶方向补丁开发make patch按文件名顺序执行scripts/??_*.sh机型专属补丁放patches/model/自己加一个99_myfix.sh就能进每次构建。固件解析工具tools/ 下mico_firmware.py解析官方升级包、unpack_bootimg.py解 boot 镜像research/updates.md 收录了各机型可用固件版本与 MD5。语音链路原理docs/voice-assistant.md 有完整的信号流图与排错路径。最后一条实操建议刷机前把整盘备份和 Uboot 中断验证这两件事做完十分钟的准备工作是整套改造里成本最低的一份保险。【免费下载链接】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），仅供参考