# 烧录与编译说明（Windows，ESP32-C6）

本说明适用于交付目录中的工程与固件：
- 源码：`Deliverable/01_Source/matter-light-c6-wifi`
- 预编译固件：`Deliverable/02_Firmware_Binaries/cct/*`

> 备注：本项目基于 ESP-IDF v5.2+；你当前环境若已安装 Espressif IDF（例如 v5.5.1）也可直接使用。

---

## 1. 环境准备

### 1.1 安装/启用 ESP-IDF（PowerShell）

以你机器上的默认安装路径为例（如不同请替换）：

```powershell
# 进入你的 ESP-IDF 目录后执行（不要在命令里写 cd 的话，也可以直接在该目录打开 PowerShell）
# 示例：C:\Espressif\frameworks\esp-idf-v5.5.1
. "C:\Espressif\frameworks\esp-idf-v5.5.1\export.ps1"

idf.py --version
```

### 1.2 串口与硬件

- 连接 ESP32-C6 开发板（建议 16MB Flash 版本）。
- 在设备管理器确认串口号（如 `COM4`）。

---

## 2. 从源码编译并烧录（推荐，最稳）

在工程目录执行：

```powershell
cd D:\ESP-LED\Deliverable\01_Source\matter-light-c6-wifi

# 清理并编译
idf.py fullclean
idf.py build

# 烧录并监视（将 COM4 替换成你的串口）
idf.py -p COM4 flash monitor
```

停止串口监视：按 `Ctrl+]`。

---

## 3. 直接烧录预编译 Factory 固件（无需重新编译）

预编译 Factory 固件路径：

- `Deliverable/02_Firmware_Binaries/cct/factory/bootloader.bin`
- `Deliverable/02_Firmware_Binaries/cct/factory/partition-table.bin`
- `Deliverable/02_Firmware_Binaries/cct/factory/ota_data_initial.bin`
- `Deliverable/02_Firmware_Binaries/cct/factory/light.bin`

烧录地址（来自工程构建输出 `flasher_args.json/flash_args`）：

- `0x0000`  bootloader
- `0x8000`  partition-table
- `0x1C000` ota_data_initial
- `0x20000` app (`light.bin`)

### 3.1 使用 `esptool.py` 一次性写入

确保已执行过 `export.ps1`，然后运行：

```powershell
$PORT="COM4"   # 替换为你的串口
$BAUD="921600" # 可改成 460800/115200 以提升稳定性

$BASE="D:\ESP-LED\Deliverable\02_Firmware_Binaries\cct\factory"

python -m esptool --chip esp32c6 -p $PORT -b $BAUD `
  --before default_reset --after hard_reset `
  write_flash --flash_mode dio --flash_freq 80m --flash_size 16MB `
  0x0 "$BASE\bootloader.bin" `
  0x8000 "$BASE\partition-table.bin" `
  0x1c000 "$BASE\ota_data_initial.bin" `
  0x20000 "$BASE\light.bin"
```

> 如果你的板子实际是 4MB Flash，可把 `--flash_size 16MB` 改为 `4MB`。

### 3.2 监视串口日志

```powershell
idf.py -p COM4 monitor
```

---

## 4. OTA 固件文件说明（给服务器/升级用）

OTA 文件路径：
- `Deliverable/02_Firmware_Binaries/cct/ota/light.bin`

说明：
- `light.bin` 用于 OTA 升级包（用于远程 HTTP OTA 场景的下载与升级）。

---

## 5. 常见问题

### 5.1 找不到 `python` / `idf.py`

确保已执行 `export.ps1`，且使用的是同一个 PowerShell 窗口。

### 5.2 串口被占用

关闭其它串口工具（如 Arduino 串口监视器、串口调试助手）。

### 5.3 Flash size 警告

如果日志提示“Detected size larger than size in binary image header”，请确认：
- 工程配置选择了正确的 Flash size（建议 16MB），并重新 `idf.py fullclean build`。