# 实施计划（先探路、不行切网关）

进度：阶段 0 已交付——前端抓包固件 firmware/atmega_frontend/（只听不说版）、
采购清单 docs/purchase-list-stage0.md、现场操作单 docs/field-procedure.md。
前端最终采用 scavenrage 的 P1P2 MAX22088 收发板工程打板自焊（详见 docs/pcb-order-scavenrage.md）；4 台内机各设一个组地址（从 1-00 起顺延），已回填固件 config.h。两份固件均已本机真编译验证通过（PlatformIO）：前端 Flash 10.2%/RAM 12%；
ESP32 首编抓到 Category::Bridge 应为 Bridges 一处真错、已修正后重编通过、
firmware.bin 正常生成（build-check/ 为验证工程）。下一步：备料、焊板。

系统：室外机 LMXS5BAV ×1，内机 ×4（CDXLS36FV2C / CDXLS71FV2C），线控器 BRC1E631，
主控 ESP32-S3-N16R8，HomePod mini 作 HomeKit 中枢。

## 总思路

两段走，带止损线：
**先探路（抓包验证可行性）→ 行则自研到底，不行则切网关路线。**
探路阶段的成果（组地址、总线帧样本、前端硬件）在两条路线下都不浪费。

分工：笔者 负责固件、脚本、日志分析、文档；用户负责采购、断电接线、
现场操作线控器、回传日志与实测结果。

## 阶段 0：备料（探路档，先不买网关）

- HBS 前端：ATmega328P 模块 + MAX22088 收发（自制小板），或 P1P2MQTT 成品桥板（二选一，采购时定）
- 屏蔽双绞线 ≥0.75 mm² 一小段、接线端子、USB 5V 电源（ESP 与前端独立供电，不取总线电）
- ESP32-S3-N16R8 已有；HomeSpan 固件 v0.1 已交付（默认 TX 关闭）

## 阶段 1：设组地址（硬前置，Aqara 说明书与大金手册双重确认）

- 顺序：先把前端板挂上总线（只听不说），再逐台在线控器设地址——应对
  大金手册「无集中控制设备在场时组地址可能设不了」的警示
- BRC1E631（按同系 BRC1E62 手册）：基本画面按返回一次 + 长按返回 ≥4 秒 →
  服务设定菜单 →「Group address」→ Group（整组）→ 上下键选号 → 菜单/确定
- 4 台逐台设组地址（从 1-00 起顺延），记录对照表回填 config.h
- 若某台设不进：停下记录现象，不硬试（可能需真集控设备在场，届时并入网关采购一并解决）

## 阶段 2：只听不说抓包（固件 ENABLE_BUS_TX=0，全程不发帧）

- 前端 + ESP32 并接到任意一台内机 X1M 的 F1（橙）/F2（黄），无极性；
  接线前断空调空开，信号线离强电 ≥15 cm
- 抓三类窗口：
  1. 上电/初始化窗口（参考 Aqara：设备上电会搜总线约 2.5 分钟）
  2. 逐台动作差分：每台内机单独做 开机→改温度→改模式→改风速→关机，
     其余不动，日志按台分开存
  3. 静默基线：无人操作 10 分钟，看周期性状态帧
- 用 tools/analyze_capture.py 做汇总与差分，出帧映射表 v1：
  哪几个字节是组地址、哪几个是命令/状态、校验规律

## 阶段 3：决策点（止损线）

- 帧结构有规律（地址/命令字节可定位、校验可复现）→ 进阶段 4 自研发帧
- 抓 2–3 轮仍无规律，或帧带滚动/加密特征 → 止损，切网关路线：
  买 DTA116A51（Modbus，≤16 台，寄存器全公开）或大金 DTA117（金制/DS-Air），
  ESP32 改写 Modbus 客户端固件，复用已有开源集成 martinstafford/daikin_d3net
  的寄存器逻辑；购前先核 LMXS5BAV 组合兼容（无现成实测案例）
- 决策依据只看日志证据，不凭感觉

## 阶段 4：发帧验证（仅自研路线）

- 从最低风险动作起：单台内机设定温度 ±1 ℃，观察线控器显示与内机响应
- 逐项验证：开关、模式、温度、风速；每验过一项才解锁一项
- 全部通过后 ENABLE_BUS_TX=1，HomeSpan 4 个 Thermostat 配件上线

## 阶段 5：接入 HomeKit 与收尾

- 配对到「家庭」App（HomePod mini 中枢），逐个房间改正式名、Siri 实测
- 状态回读对齐：有人用线控器改了设置，HomeKit 显示要能跟上（靠监听帧更新）
- 故障/状态帧纳入显示；连续挂机一周稳定性观察；安装定版（位置、外壳、线缆固定）

## 风险与如实预期

- 最大不确定性在阶段 2–3：DIII-Net 帧语义无公开资料，15 年无公开 DIY 成功先例；
  探路档投入只有一块前端板和时间，止损后网关路线是确定性出口
- 组地址若必须真集控设备在场才能设，网关采购会提前到阶段 1 后
- 全程安全红线：接线断空开；TX 未验证前绝不开启；不改动原线控与空调设置（组地址除外）