# 技术方案与架构说明（ESP32-C6 Matter + ESP-NOW）

## 1. 总体目标

在 ESP32-C6 单芯片上实现：
- 遥控器侧 ESP-NOW 控制（固定信道 `channel=1`）
- Matter 侧生态接入（Apple Home 已验证）
- 远程 HTTP OTA 升级

## 2. 网络/射频架构（核心）

为满足“遥控器固件不变 + ESP-NOW 固定信道=1”的约束，采用 ESP32-C6 双射频分工：

- **Wi-Fi 2.4GHz 射频**：专用于 ESP-NOW（固定 channel=1）
- **802.15.4 射频（Thread）**：用于 Matter 网络承载
- **BLE**：用于 Matter commissioning（配网阶段）

该架构可避免 Wi-Fi STA 信道由路由器决定导致与 ESP-NOW 冲突的问题。

## 3. Matter 设备模型

- **Endpoint 1（单色灯）**：OnOff + LevelControl
- **Endpoint 2（双色温灯）**：OnOff + LevelControl + ColorControl(ColorTemperature)
- 已验证：Groups / Scenes 可创建与应用

## 4. 驱动与硬件接口

- 单色灯：LEDC PWM（RGB 三路混白）
- 双色温：SK6812 RGBW，RMT 单线驱动，使用 ColorTemperature 映射实现色温效果

## 5. ESP-NOW 与 Matter 状态同步

- 设备接收遥控器 ESP-NOW 命令（0x01..0x05/0xA5），映射为灯控动作
- 同步更新 Matter 属性，保证 App 侧状态一致
- 支持多设备联调：遥控器 Zone1/Zone2 + App 同时控制两台灯具

## 6. OTA 方案（交付采用）

交付采用 **HTTP OTA（远程服务器下载固件）**：
- 设备从 HTTP 服务器下载 `light.bin` 并写入 OTA 分区
- 通过 Matter shell 命令触发：`matter esp ota <http://url>`
- 分区表为双 OTA：`ota_0/ota_1/otadata`

详细部署说明见：`OTA_HTTP_Deploy_Guide.md`。

## 7. 配网与二维码

- 设备启动可输出 onboarding codes（QR 字符串 `MT:...` 与 manual pairing code）
- 交付提供 `SetupPayload.py` 工具用于生成/解析配网码

## 8. 工程与交付

- 源码快照：`Deliverable/01_Source/matter-light-c6-wifi`
- 固件 bin：`Deliverable/02_Firmware_Binaries/*`
- 烧录说明：`Deliverable/03_Flash_and_Tools/Flash_Guide_CN.md`
- 测试素材目录：`Deliverable/04_Test_Report/`