线下安装 · 师傅施工 + 5 句话 briefing(去 voice 版)
2026-07 重组后:用户决定不做语音助手,所以本页不再涉及 Voice PE / ESPHome / Wake word 烧录。师傅只管 绿米硬件装配 + 网络布线,软层全部由你(和我)做。详细技术接管路径见 home-ai-quickstart + §2 绿米 / Aqara:本地化接管。
0. 阶段总览(三阶段分工)
┌────────────────────────────────────────────────────────────────┐
│ 阶段 0 备料(用户自己,1-2 天) │
│ - 买齐硬件:NAS + SONOFF 协调器 + 网线 + USB-C 适配器 │
│ - NAS 装系统 + Docker,预留 mDNS │
└────────────────────────────────────────────────────────────────┘
↓
┌────────────────────────────────────────────────────────────────┐
│ 阶段 1 硬件施工(师傅,半天-1 天) │
│ - 装 Aqara Hub / 子设备入网 │
│ - 装 SONOFF Zigbee 协调器 + USB 接到 NAS │
│ - 装网线 / 强电 / 弱电箱整理 │
│ - 不动既有 Aqara Hub 固件 / 不动子设备在线 │
└────────────────────────────────────────────────────────────────┘
↓
┌────────────────────────────────────────────────────────────────┐
│ 阶段 2 软件调试(用户 + 我,30 分钟-1 小时) │
│ - Z2M Permit join + 子设备入网 │
│ - HA + Mosquitto + InfluxDB 起来 │
│ - Grafana + AppDaemon + LLM 摘要 │
│ - 触发 AppDaemon 自动化跑通("离家关空调") │
└────────────────────────────────────────────────────────────────┘
师傅只参与阶段 1;阶段 0、2 由你(和我)做。
1. 师傅一句话 briefing(直接微信转发)
目标:家里有(或新装)绿米 / Aqara 全屋子设备(墙开 / 插座 / 人体 / 传感器 / 窗帘 / 摄像头)。用户希望:
- Aqara 子设备保持原状已入网 Aqara Hub — 不动 Hub 固件、不重置、不让 Hub 进入”工厂模式”;
- 新增一根 SONOFF Zigbee 协调器(¥80-100)插到 NAS,离硬盘 30 cm 以上,用于未来 Z2M 接管;
- 所有网络设备在同一子网(mDNS 开启,关 AP 隔离);
- 不做语音助手(不买 Voice PE / ESP32-S3-BOX-3);
- 不动 NAS 上的 Docker / 软件配置。
师傅要做的 4 件事:
- 绿米子设备配对(按 Aqara 现有流程入 Hub)
- SONOFF Zigbee 协调器 ←→ NAS USB 口,走线避开硬盘电源线
- 网线 / 弱电箱整理(Cat6 到 NAS 位置)
- 施工完拍照 + 抄 HomeKit 配对码给用户
师傅不要做的 4 件事:
- 别动 Aqara Hub 固件(用户后续可能 OTA 升级)
- 别让 Aqara Hub 与 SONOFF 协调器同时入同一台子设备(会冲突)
- 别碰 NAS 上的 Docker(软件是用户自己跑)
- 别带 Voice PE / 麦克风阵列(用户已决定不上语音助手)
2. 网络拓扑 + 硬件位置(给师傅)
2.1 网络拓扑
[移动设备] ──── Wi-Fi (2.4 + 5 GHz 同一 SSID,AP 隔离关)
│
[Aqara 子设备] → [Aqara Hub 保留](弱电箱 / 不动)
↓
[HomeKit 桥→ HA homekit_controller]
↓
[摄像头 → 绿米云](用户 App 用)
↓
[NAS] 装 Docker:
- HA + Mosquitto + InfluxDB + Grafana
- USB: SONOFF Zigbee 协调器(以后给 Z2M 用)
- AI 服务: AppDaemon + Ollama (Qwen2.5-7B)
│
[分时电价服务(HA 调用电价 API 或手动配置时段)]
│
[AppDaemon 触发暖通节能 / LLM 自动总结推送钉钉 / 企业微信]
2.2 设备 / 信号覆盖关键
| 件 | 装哪 | 覆盖半径 / 备注 |
|---|---|---|
| SONOFF Zigbee 协调器 | NAS 旁边(USB 直插),离硬盘 30cm | Zigbee 单协调器 30-50m 户内 |
| Aqara Hub | 弱电箱,通风散热 + 不要贴金属 | 决定整个 Aqara 子设备网的中继覆盖 |
| Aqara 智能门锁 | 装门体内,需要预留电池更换空间 | 降云控:Hub 一定要在 5m 内 |
| 摄像头 | 门口 / 玄关,留 SD 卡 + 电源 | 走绿米云,Aqara App 实时查看 |
| 窗帘电机 | 窗框上方预留 200mm | 电源线在窗左侧为佳 |
3. 施工前用户/师傅共同确认清单
打印这份给师傅,逐项 ✓:
□ 1. 家里有稳定 Wi-Fi,且 NAS 所在位置有网线接入(推荐 Cat6 一根到弱电箱)
□ 2. NAS 已经摆好、能 ping 通、内部 IP 已知(常见 192.168.x.y)
□ 3. 强电 + 弱电箱整理好,网络设备(D-Link / TP-Link / iKuai 等)上电通电
□ 4. 房屋改造图纸 / 灯开关 / 插座点位图给师傅 一份(避免错装)
□ 5. Aqara 子设备型号表 + 数量(给师傅配对参考):
□ 6. 用户确认 Aqara Hub 保留使用,**不**断电、**不**重置、**不**让协调器"成对入网"
□ 7. USB-C / 5V 电源点(Aqara 子设备多数需 5V/2A USB,准备适配器)
□ 8. NAS 后置 USB 口预留(SONOFF 协调器插这里)
□ 9. 约定阶段 1 完成时间 + 阶段 2 软件调试时窗口
□ 10. 家里有关键钥匙留给用户(用于 Aqara Hub 配对时按按钮)
4. 师傅工作量清单(给师傅看)
[Aqara 子设备]
□ 各墙开 / 插座 / 传感器位置预埋 220V / 5V USB / 强电
□ Aqara 子设备按配对按钮依次入网 Aqara Hub(Q2H App 引导)
□ 网线 / 弱电到端点
□ 所有 Aqara 设备改名"Mbedroom_Aqara_Plug_1"风格化
[SONOFF Zigbee 协调器]
□ USB 接 NAS 后置,确认 /dev/ttyACM0 出现
□ NAS 不要关机(装调到测试完为止)
□ 协调器**暂不入网**任何子设备(等用户软件阶段再切)
[网络 + 文档]
□ 网线 / Cat6 / 弱电箱整理
□ 拍每个端点的安装照
□ 拍 NAS 后置 USB 接口
□ 把点位 + Aqara Hub PIN(HomeKit 8 位)在抄一份给用户
5. 师傅 → 用户 · 交接过的话术
师傅施工完后,师傅把这些交代给你:
- “Aqara 子设备全部入网 Hub 了,Hub 还在 QQ 楼位置(指出)接了电。摄像头走 Wi-Fi。”
- “SONOFF 协调器插 NAS 后置了,你 ls /dev/ttyACM0 看看能不能看到。没让协调器入任何子设备。”
- “HomeKit 配对码:XXXX-XXXX(HX Hub 背面)”
- “墙上的插座 / 开关都通了电,坐标:A 卧室床头 / B 客厅主灯 / C…”
你再进 Z2M Permit join + HA 配置(见 home-ai-quickstart 第 1-6 步),30 分钟搞定软件层。
6. 故障兜底(施工时遇到问题)
| 现象 | 排查 |
|---|---|
| Aqara 子设备入网失败 | 检查 Hub 距离(>5m 失败率高);更新 Aqara Hub 固件到最新版;更新后等 5 分钟重试 |
| SONOFF 协调器 ttyACM0 没出现 | NAS USB 驱动问题;Linux 内核要 >= 5.4 否则需编译;换 ITead Zigbee Stick |
| 网线 / Cat6 不通 | 用 simple line tester;漏线 / 接错是常见原因 |
| 协调器无法端接 | 是 USB 3.0 口时可能电磁干扰 —改插 USB 2.0(小心:很多 NAS 只有 USB 3.0,加一根 USB 2.0 延长线到 NAS 外) |
7. 时间估计 / 工费预算(国内)
| 件 | 单价(¥) | 备注 |
|---|---|---|
| SONOFF 协调器 | ¥80-100 | 京东 / 淘宝 |
| 网线 / Cat6 米 | ¥5/米 | 100 米 = ¥500 |
| 5V USB 适配器 × N | ¥15 / 个 | × 4-6 个 = ¥90 |
| Aqara 子设备 | 已买 | 你已有 |
| 师傅施工费(半天) | ¥500-1500 | 看城市;北上广深高,2-4 线城市 ¥300-800 |
8. 引用
- ✓ home-ai-quickstart 阶段 2 软件调试
- ⏳ 绿米 / Aqara 接管兼容矩阵 — 见本文 §2 (技术上) + 本套 home-ai-energy §2.2 智能插座