LED-Germany/03_Flash_and_Tools/Flash_Guide_CN.md

烧录与编译说明（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）

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

# 进入你的 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. 从源码编译并烧录（推荐，最稳）

在工程目录执行：

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，然后运行：

$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 监视串口日志

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。