LED-Germany/05_Docs/Architecture.md
2026-02-26 09:59:27 +08:00

57 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 技术方案与架构说明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 PWMRGB 三路混白)
- 双色温SK6812 RGBWRMT 单线驱动,使用 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 codesQR 字符串 `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/`