Give Classic Smart Speakers a Sovereign AI Brain.
赋予百元经典智能音箱一颗
本地主权 AI 大脑
A Rust-powered, local-first voice runtime and hardware gateway stack. Run on-device Zipformer KWS and Silero Neural VAD directly on Xiaomi AI Speaker Pro (LX06, zero-flash dual-wake coexistence) and Amazon Echo Dot 2 (7-mic array), connected to any LLM, ASR, TTS, and Home Assistant. 纯 Rust 打造的本地优先家庭语音运行时与硬件网关栈。在小米小爱音箱 Pro(LX06,零刷机风险、原厂小爱与自定义唤醒词毫秒级共存)与亚马逊 Echo Dot 2(7 麦阵列)上直接运行本地 Zipformer KWS 与 Silero 神经网络 VAD,支持多房间声学仲裁与 Home Assistant 闭环回读控制。
Engineered for Real Rooms, Not Demo Clips. 为真实家庭多房间声学环境而生
Every layer—from ALSA dsnoop capture and 160ms pre-onset ring buffers to cross-node RTT clock-normalized arbitration—is built in Rust with strict memory and flash gates. 从 ALSA 共享拾音、160ms 语音前导缓冲到跨节点时钟校准的声学仲裁,全栈采用 Rust 编写,在百元级嵌入式音箱的严苛内存与闪存限制下稳定运行。
Zero-Flash Dual-Wake Coexistence on Xiaomi LX06 小米小爱 Pro (LX06) 零刷机风险、双唤醒无缝共存
Stock system0/system1 SquashFS partitions remain 100% untouched (zero brick risk). Using Storage Scheme A, a 4.8 MB compressed bundle in /data/hm unpacks into /tmp RAM disk on boot. Shared ALSA noop capture and idle-closed softvol playback let native "XiaoAi" and your custom Home Mate wake word run simultaneously.
100% 不触碰原厂只读 system0/system1 SquashFS 分区(零变砖风险)。采用方案 A 压缩存储,/data/hm/hm-bundle.tar.xz(仅 4.8 MB)开机自动解压至 /tmp 内存盘运行;通过 ALSA noop 旁路共享拾音与空闲即放的 softvol 播放,实现原厂“小爱同学”与自定义唤醒词双系统同时在线。
Slim Core + Sidecar Neural Silero VAD Slim 瘦身内核 + 旁路 Silero 神经网络 VAD
By decoupling ONNX inference into the C-ABI hm-kws sidecar and streaming per-frame AudioChunk.vad_speech decisions over Northbound v2 (gateway_vad), hm-core sheds tract-onnx while preserving neural speech endpointing and 160ms pre-onset lead-in.
通过剥离 Core 内的 tract-onnx(--slim 编译),由网关侧 hm-kws 进程统一托管 3.3M Zipformer 热词检测与 Silero VAD v4,通过北向 v2 协议 AudioChunk.vad_speech 逐帧回传(gateway_vad),兼顾 4.8MB 极致体积与神经网络级断句精度。
Multi-Room Mesh Arbitration 多房间声学 Mesh 唤醒仲裁
When multiple speakers hear your wake word at once, peers exchange calibrated RMS dBFS and SNR claims with RTT-bounded clock-skew normalization. Only the closest speaker answers. 当客厅与卧室的多台音箱同时听到唤醒词时,6 节点舰队通过 RTT 时钟偏差校准实时比对各机校准后的信噪比(SNR)与声压(RMS dBFS),确保永远只有离你最近的一台开口应答。
Closed-Loop Home Assistant Home Assistant 状态回读闭环
Auto-discovers exposed Assist entities over WebSocket and verifies physical state readback after every command. If a light or curtain doesn't confirm, Home Mate never lies that it succeeded. 通过 WebSocket 自动同步 Home Assistant 暴露实体,每次控制后强制执行真实设备状态回读(Readback)——“动作结果以设备回读为准,没读回绝不谎报已完成”。
Open Protocol v2 (Apache-2.0) 开放北向 v2 协议 (Apache-2.0)
Strict boundary between hm-core (intent, tools, memory) and hm-gateway (ALSA, AEC, LEDs, buttons, EQ) via versioned LDJSON over TCP 127.0.0.1:8932.
hm-core(意图、工具、记忆)与 hm-gateway(声卡、AEC、灯环、按键、硬件 EQ)通过 127.0.0.1:8932 版本化 LDJSON 协议彻底解耦,极易移植到任意 Linux/ESP32 新硬件。
Two Legendary Speakers. One Unified Fleet. 两大百元神机,同一套全屋舰队
Each hardware model has its own dedicated, deeply tuned Rust gateway repository—no bloated cross-model hacks in the core brain. 每款硬件拥有独立维护、深度调校的专属 Rust 网关仓库,针对各自的麦克风阵列与扬声器腔体单独标定 EQ 与声学参数。
Xiaomi AI Speaker Pro (LX06)
Amlogic A113X Quad-Core ARM Cortex-A53 (aarch64) • 6-Mic Circular Array + Hi-Fi Woofer 小米小爱音箱 Pro(黑色旗舰款 `LX06`)• Amlogic A113X 四核 `aarch64` • 6 麦环形阵列 + 大腔体低音单元
- Installation Mode安装方式open-xiaoai SSH + /data/hm
- Stock Firmware Touch原厂固件分区改动0 Bytes (100% Untouched)
- Compressed Bundle Size闪存压缩包体积4.84 MiB (hm-bundle.tar.xz)
- Native XiaoAi Coexistence与原厂小爱同学共存Simultaneous Dual-Wake
- Hardware Voicing EQ硬件声学均衡曲线3-Band Custom Woofer Curve
- LED Ring & Top Buttons顶部灯环与实体按键Full Native State + CH Switch
Amazon Echo Dot 2 (RS03QR "Biscuit")
MediaTek MT8163 Quad-Core ARM64 • 512 MB RAM • 7-Microphone Far-Field Beamforming Array 亚马逊 Echo Dot 第二代(RS03QR)• MT8163 四核 ARM64 • 512 MB 内存 • 7 麦克风远场波束成形阵列
- Installation Mode安装方式amonet + emOS + hm-release
- OTA MechanismOTA 升级机制Ed25519 Signed A/B Rollback
- Echo Cancellation (AEC)回声消除与参考锁160ms Tail + Reference Lock
- Hardware Voicing EQ硬件声学均衡曲线EchoMuse 2-inch Driver Curve
- LED Ring & Action/Mute12 灯珠 RGB 灯环与按键60fps Direction + Privacy Latch
- Multi-Unit Calibration单机麦克风增益标定Per-Unit mic_gain_offset_db
Build Your Own Hardware Gateway 自定义硬件接入(树莓派 / Linux / ESP32)
Implement the lightweight Northbound v2 LDJSON specification to turn any Linux board or microcontroller into a Home Mate satellite. 基于 Apache-2.0 授权的 Northbound v2 LDJSON 协议规范,任何带有麦克风与扬声器的 Linux 开发板或单片机均可接入全屋舰队。
- Wire Transport传输层协议TCP LDJSON (127.0.0.1:8932)
- Audio Uplink音频上行格式16kHz Mono PCM + vad_speech
- Config Delivery配置下发协议Transactional config_apply_v2
- Contract Test Suite协议契约测试套件Included in crates/protocol
- Protocol Spec License协议规范许可证Apache-2.0
From Unboxed to Talking in 10 Minutes. 10 分钟从零跑通你的第一台 AI 音箱
New to Home Mate? Follow this step-by-step interactive guideline. No firmware flashing required on Xiaomi LX06, and clean one-line uninstall if you ever want stock state back. 第一次接触本项目?按以下四步保姆级向导操作。小米 LX06 全程无需刷写固件分区,随时可一行命令无痕卸载恢复纯原厂状态。
Enable SSH via open-xiaoai通过 open-xiaoai 开启 SSH
Confirm your speaker model is Xiaomi AI Speaker Pro (black cylinder, model LX06) with root SSH enabled on port 22 and at least 5.5 MB free in /data.
确认音箱底部型号为小米小爱音箱 Pro(黑色圆柱款 LX06),已通过社区开源项目 open-xiaoai 开启 root SSH,且 /data 分区剩余空间 ≥ 5.5 MB。
Host KWS Model Bundle on LAN局域网托管 KWS 语音模型包
Because LX06 has 13.3 MiB of /data flash and 120.9 MiB of /tmp RAM, the 4.8 MB main bundle lives in /data/hm while the 8.5 MB Zipformer KWS bundle is fetched into /tmp/hm-kws over HTTP on boot.
LX06 的 /data 分区为 13.3 MiB,而 /tmp 内存盘高达 120.9 MiB。主程序包(4.8 MB)常驻 /data/hm,8.5 MB 的 KWS 离线模型包通过局域网 HTTP 在开机时拉取到 /tmp/hm-kws。
Run 1-Command Installer执行一键部署脚本
Run deploy/lx06/install-lx06.sh from your computer. It uploads the verified bundle, hooks /data/init.sh, starts the supervisor, and prints your Web Console pairing token.
在电脑端运行仓库自带的 deploy/lx06/install-lx06.sh,自动完成 SHA-256 校验上传、写入 /data/init.sh 引导、拉起守护进程并输出 Web 控制台访问 Token。
# 1. Clone the LX06 Gateway repository git clone https://github.com/yes999zc/home-mate-gateway-lx06.git cd home-mate-gateway-lx06 # 2. Build (or download from Releases) and deploy to your LX06 speaker (e.g. 192.168.1.50) ./deploy/lx06/install-lx06.sh --device-ip 192.168.1.50 --kws-url http://192.168.1.10:18089/hm-kws-lx06.tar.xz ✓ Verified hm-bundle.tar.xz (4.84 MiB, 80.6% of 6.0 MiB /data gate) ✓ Installed /data/hm/init.sh supervisor (stock mtd4/mtd5 SquashFS untouched) ✓ Home Mate Core & LX06 Gateway online at http://192.168.1.50:8930 (gateway_vad active)
Pair Console (:8930)打开控制台并配对 (:8930)
Open http://<SPEAKER_IP>:8930 in your browser. On a fresh speaker, click Provision Token (or paste the hm1_... token printed by the installer) to unlock the 8 management pages.
浏览器访问 http://<音箱IP>:8930。首次进入点击生成配对令牌(或粘贴安装脚本输出的 hm1_... 令牌),请务必妥善保存该令牌。
Configure ASR, LLM & TTS配置 ASR / LLM / TTS 三大件
Go to Services: configure an OpenAI-compatible ASR endpoint (e.g., local Qwen3-ASR or Whisper), your primary/fallback LLM (DeepSeek / GLM / OpenAI), and TTS (Volcengine seed-tts-2.0 or OpenAI TTS). Wait for cue_readiness: 6/6 ready.
在「服务配置」页填入:ASR 语音识别地址(支持本地 Qwen3-ASR / Whisper 或云端兼容接口)、主/备大模型(DeepSeek / GLM / OpenAI)以及 TTS 语音合成。保存后系统会自动预合成 6 条唤醒应答提示音(看到 cue_readiness: ready 即代表发声链路就绪)。
Customize Wake Word & Join Fleet自定义唤醒词与组建多房间舰队
In Voice & Reflex, type any Chinese wake phrase (e.g. 你好小智). The built-in Pinyin tokenizer auto-generates toned Zipformer tokens and hot-deploys to hm-kws via config_apply_v2. Add second speakers in Fleet for multi-room SNR arbitration!
在「语音与反射」页输入你喜欢的唤醒词(如“你好小智”),内置带调拼音分词器会自动编译并通过 config_apply_v2 热下发至 hm-kws。若家里有多台音箱,在「舰队」页互相添加节点即可开启多房间声学仲裁与一键配置同步!
Unlock Bootrom & Install emOS解锁 Bootrom 并刷入 emOS 底座
Use firebreak / amonet over USB to unlock your Echo Dot 2 (RS03QR) and boot the Linux/Android audio base (emOS) with the 7-mic capture driver enabled.
使用 USB 数据线连接 Echo Dot 2,通过社区开源的 amonet / firebreak 解锁并刷入支持 7 麦阵列拾音的 emOS 系统底座。
One-Command Provisioning一行命令完成配网与舰队克隆
Run tools/hm-provision.sh from the Core repo. It installs the bootstrap seed, activates the signed release bundle, pairs the household token, and clones config from your reference speaker.
运行 Core 仓库的 tools/hm-provision.sh,自动完成种子包安装、签名固件包激活、Token 配对,并支持通过 --reference-node 一键从家里已配好的主音箱克隆全套家庭配置。
# Provision a new Echo Dot 2 and clone household config from an existing reference speaker ./tools/hm-provision.sh --device-id dot2-living \ --seed build/bootstrap/home-mate-bootstrap.tar.gz \ --release build/release/home-mate-release.tar \ --serial /dev/cu.usbmodem8401 --ip 192.168.1.73 \ --reference-node lx06 --reference-ip 192.168.1.50 --wake-word 你好小智
How Dual-Wake & Mode Switching Works双唤醒共存与切换原厂小爱方式
• Default Dual-Wake: Say "XiaoAi TongXue" for stock Xiaomi skills, or say your Home Mate wake word for your custom LLM agent.
• Voice Switch: Say "切换小爱" during a Home Mate session to immediately hand off.
• Physical Button: Double-tap the top CH (Channel) button to pin native XiaoAi-only mode; double-tap again to return to Dual-Wake.
• 默认双唤醒共存:平时说“小爱同学”由原厂小爱应答;说“你好小智/高达”由 Home Mate 大模型应答。
• 语音退场切换:对 Home Mate 说“切换小爱”即可立即结束会话让出声道。
• 顶部实体按键切换:双击音箱顶部的 CH 键可切换至“纯原厂小爱独占模式”,再次双击恢复双唤醒共存。
Hardware Pitfalls Already Solved for You已为你填平的 LX06 硬件坑点
• Woofer EQ Protection: Do NOT apply Echo Dot 2's echomuse (+14dB @ 175Hz) curve to LX06; LX06 uses a dedicated 3-band custom curve.
• Flash Wear Protection: Voice journals (voice-events) and runtime logs are routed to /tmp tmpfs so /data UBIFS never fills up.
• 专属 EQ 防破音:切勿在 LX06 上套用 Dot2 2 寸小喇叭的 echomuse (+14dB 低音增益) 曲线,LX06 默认配备专属 3 段平滑低音曲线。
• 闪存寿命与空间保护:voice-events 诊断日志自动软链至 /tmp 内存盘并在 85% 水位自动轮转,绝不撑爆 13.3MB 的 /data 分区。
1-Line Clean Uninstall (Back to 100% Stock)一行命令彻底无痕卸载(100% 恢复纯原厂)
Because Home Mate never modifies stock SquashFS partitions, removing /data/hm and /data/init.sh and rebooting returns the speaker to 100% factory software state.
由于从未改动任何原厂固件分区,只需在 SSH 执行:rm -rf /data/hm /data/init.sh && reboot,重启后即 100% 回到纯原厂小爱状态。
Modular Repositories. Clear Licensing. 清晰解耦的三仓架构与双轨开源许可
Free and open-source under AGPL-3.0 for personal, family, and hacker self-hosting. The Northbound v2 Gateway Protocol specification is licensed under Apache-2.0 so anyone can build custom hardware adapters. 个人、极客与家庭自部署遵循 AGPL-3.0 完全免费开源;北向 v2 网关通信协议规范采用宽松的 Apache-2.0 授权,支持社区自由开发任何第三方硬件网关;针对商业 OEM 预装或闭源定制提供商业授权。
The unified voice agent brain (hm-core), signed OTA installer (hm-release), Vue 3 management console, multi-room SNR arbiter, and Northbound v2 protocol specification.
Home Mate 核心大脑(hm-core)、签名发布安装器(hm-release)、Vue 3 响应式管理控制台、多房间声学仲裁器与北向 v2 协议规范。
Dedicated device gateway for Xiaomi AI Speaker Pro (LX06, A113X aarch64): Scheme A RAM-disk unpacker, dual-wake XiaoAi coexistence supervisor, LED ring, touchpad buttons, and sidecar hm-kws.
小米小爱音箱 Pro(LX06)专属设备网关:方案 A 内存盘解压守护进程、原厂小爱双唤醒共存状态机、灯环/触摸按键驱动与 hm-kws 旁路语音引擎。
Dedicated device gateway for Amazon Echo Dot 2 (RS03QR, MT8163): 7-microphone array capture, hardware reference AEC lock, 12-LED RGB ring animation engine, and emOS integration.
亚马逊 Echo Dot 2(RS03QR)专属设备网关:7 麦克风阵列远场拾音、硬件回声消除参考锁、12 灯珠 RGB 声源定位灯环驱动与 emOS 集成。