# 现场操作单（阶段 1 设组地址 + 阶段 2 抓包）

现场操作，日志回传后由笔者分析。
红线：**接线前断空调空开**；前端固件为只听不说版（物理上无发送代码）；
除组地址外不改空调任何设置。

---

## 第一步：接线（约 15 分钟）

1. 关空调总空开，验电后再动手。
2. 任选一台内机（建议离路由器近、方便站人的那台），打开其接线盖找到 X1M：
   - F1 = 橙线端子，F2 = 黄线端子（图注「传送线」）
   - 不要碰 P1/P2（线控器线）和 T1/T2（强制关）
3. 屏蔽双绞线一端并接到 F1、F2（无极性，两根别接反到别的端子就行），
   另一端接前端板总线口；屏蔽层单端接地（接前端侧 GND 旁的屏蔽端）。
4. 信号线与强电线分开走，间隔 ≥15 cm 做不到就穿管。
5. 前端板 TX → ESP32 GPIO18；ESP32 GPIO17 → 前端 RX（抓包期可不接）；
   两板 GND 共地；各自 USB 5V 上电（先不合空调空开也行，先看两块板能启动）。
6. 合空开恢复空调，确认 4 台内机线控器显示正常、无故障码。

## 第二步：刷固件与自检

1. 电脑 Arduino IDE 打开 `firmware/atmega_frontend/atmega_frontend.ino`
   烧到 Nano/Uno（板型选对应型号，端口选对）。
2. 打开 `firmware/esp32s3_homekit/esp32s3_homekit.ino`，先改 `config.h`：
   填家里 2.4 GHz WiFi 名和密码；房间表名字先保持占位。
   板型选 ESP32S3 Dev Module、16MB Flash、PSRAM 打开，烧录。
3. ESP32 串口（115200）应看到 `[FE]` 前端统计行和（总线有流量时）`[BUS] NEW` 帧行。
   - 一行帧都看不到 → 先查接线与前端波形（开 RAW_EDGE_LOG 模式抓一段发回）。
   - 有帧但大量重复属正常（总线轮询）。

## 第三步：设组地址（每台内机各设一个）

在线控器 BRC1E631 上操作（步骤按同系 BRC1E62 官方说明书，菜单名以实机中文为准）：

1. 基本画面下，按一次「返回」键，再**长按「返回」≥4 秒** → 进入服务设定菜单。
2. 选「Group address（组地址/集中管理地址）」→ 按「菜单/确定」。
3. 选「Group No. setting (Group)」→ 按「菜单/确定」。
4. 用上下键选组号 → 按「菜单/确定」确认。
5. 四台依次设：**1-00、1-01、1-02、1-03**，当场记下「房间 ↔ 组号」发回给 笔者 回填固件。

注意：
- 每个房间要在**该房间自己的线控器**上设；四个号不能重复。
- 若菜单里没有组地址项、或设完不保存：停下拍照发回，不要反复硬试——
  可能是大金手册说的「无集中控制设备在场不能设」，届时等集控设备（前端已在场
  理应算数；仍不行则并入网关方案一并解决）。
- 设地址过程中 ESP32 保持抓包，日志里可能正好出现地址分配相关帧，一并留存。

## 第四步：抓包动作脚本（每台内机单独做一遍，其余台不动）

每台约 5 分钟。开始前在串口日志里打时间标记（直接发一条空行并口头报「开始 X 房间」，
事后按时间对齐即可）。动作之间各停 10 秒，让帧分得开：

1. 静默基线：全屋不动 2 分钟（只做一次，放最前面）。
2. 对目标台：开机（制冷）→ 设定 26℃ → 改 24℃ → 改 28℃ → 模式切送风 →
   切回制冷 → 风速 高→低 → 关机。
3. 上电窗口（只做一次）：断空开 10 秒再合上，完整录 3 分钟
   （设备自检/寻址流量在这段里）。

## 第五步：回传

- 把 ESP32 串口日志整段保存为文本，按「基线 / 房间名 / 上电」分开发回。
- 用 tools/analyze_capture.py 出帧映射表 v1，再做阶段 3 决策。
