补充 USB 传输固件的构建说明

写明只在 nand_xfer 目录用 build_app.ps1 和 flash_app.ps1，避免在仓库根目录编译主固件。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-13 22:43:42 +08:00
parent 427336659b
commit 6ea1d2a117
1 changed files with 23 additions and 1 deletions
@@ -5,7 +5,29 @@ ESP32-P4 工程，仓库里有两套程序。
 - 根目录是设备主固件。界面、蓝牙、Wi-Fi、表情包和外置 SPI NAND 都在这里。外置盘挂载点是 `/extflash`，表情文件放在 `/extflash/eaf/`。
 - `nand_xfer/` 是单独的 NAND 传输固件。电脑通过板载 USB Serial/JTAG 把文件写到同一块外置 NAND，设备侧路径同样以 `/extflash` 开头。

-分区表在 `partitions.csv`，与 IntegratedV1 相同。传输固件只覆盖 `ota_0`（偏移 `0x70000`，大小 10MB），不改 bootloader、分区表和 NVS。烧录、恢复主程序和串口协议见 `nand_xfer/README.md`。
+分区表在 `partitions.csv`，与 IntegratedV1 相同。传输固件只覆盖 `ota_0`（偏移 `0x70000`，大小 10MB），不改 bootloader、分区表和 NVS。串口协议见 `nand_xfer/README.md`。
+
+## 构建 USB 传输固件
+
+传输固件的目录是 `E:\PET\lab\kabao_usb\nand_xfer`。打开 PowerShell，在这个目录里编译：
+
+```powershell
+cd E:\PET\lab\kabao_usb\nand_xfer
+.\build_app.ps1
+```
+
+`build_app.ps1` 使用本机 ESP-IDF 5.5.4，目标芯片是 ESP32-P4。编译完成后的固件是：
+
+`E:\PET\lab\kabao_usb\nand_xfer\build_release\nand_xfer.bin`
+
+烧录前关掉「NAND 传输」窗口和串口监视器。把下面的 `COM3` 换成设备管理器里 USB Serial/JTAG 的端口：
+
+```powershell
+cd E:\PET\lab\kabao_usb\nand_xfer
+.\flash_app.ps1 -Port COM3 -AppBin .\build_release\nand_xfer.bin
+```
+
+`flash_app.ps1` 只把 `nand_xfer.bin` 写到 `0x70000`。仓库根目录 `E:\PET\lab\kabao_usb` 是设备主固件，传文件时留在 `nand_xfer` 里用上面两条脚本，不要在根目录执行 `idf.py build` 或 `idf.py flash`。

 ## 上位机