57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
|
# 技术方案与架构说明（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/`
|