Open-Source Release • Dual-Hardware Fleet Verified (Echo Dot 2 + Xiaomi LX06) 正式开源 • 双神机全屋 6 节点实机舰队验证(Echo Dot 2 + 小爱音箱 Pro LX06)

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 闭环回读控制。

⚡ LIVE MULTI-ROOM ACOUSTIC MESH ARBITRATION • 6-NODE FLEET 多房间声学 Mesh 唤醒仲裁实时拓扑 • 6 节点混合舰队(LX06 + Dot2)
PROTOCOL_VERSION = 2 • GATEWAY_VAD ACTIVE
lx06 (Living Room) Xiaomi LX06
★ ARBITRATION WINNER (Dual-Wake Coexistence) ★ 声学仲裁胜出应答(双唤醒共存模式)
SNR: +24.8 dB RMS: -18.4 dBFS
dot2-e (Living Room) Echo Dot 2
Suppressed (Cross-Unit SNR Arbiter) 同房间声学比对静默退让
SNR: +19.1 dB RMS: -23.2 dBFS
dot2-d (Kids Room) Echo Dot 2
Suppressed (Far-Field Bleed Guard) 跨房间串音抑制退让
SNR: +9.4 dB RMS: -34.0 dBFS
dot2-b / dot2-c / dot2a 3x Echo Dot 2
Idle Listening (100% On-Device KWS) 纯本地热词监听(0 云端流量)
CPU < 18% Noise: -58.2 dBFS
System Architecture 系统核心架构

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 播放,实现原厂“小爱同学”与自定义唤醒词双系统同时在线。

/data/hm/hm-bundle.tar.xz (4.84 MiB) ──unxz──► /tmp/hm/{hm-core, hm-gateway} ◄──127.0.0.1:8932──► hm-kws (Silero VAD)
🎙️

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 极致体积与神经网络级断句精度。

mic.vad.endpoint.kind = "gateway_vad" • pre-onset = 160ms
📐

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 新硬件。

Hardware Matrix 已验证硬件矩阵

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 与声学参数。

HARDCORE 7-MIC ARRAY • SIGNED OTA FLEET

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
APACHE-2.0 PROTOCOL V2 • EXTENSIBLE

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
Beginner-Friendly Onboarding 新手零门槛保姆级指南

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 全程无需刷写固件分区,随时可一行命令无痕卸载恢复纯原厂状态。

1

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。

2

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。

3

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)
1

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_... 令牌),请务必妥善保存该令牌。

2

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 即代表发声链路就绪)。

3

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。若家里有多台音箱,在「舰队」页互相添加节点即可开启多房间声学仲裁与一键配置同步!

1

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 系统底座。

2

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 你好小智
A

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 键可切换至“纯原厂小爱独占模式”,再次双击恢复双唤醒共存。

B

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 分区。

C

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% 回到纯原厂小爱状态。

Open-Source Ecosystem 开源仓库矩阵与授权策略

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 预装或闭源定制提供商业授权。