目录

方法一：

• 通过 esptool 命令行烧录

方法二：

• 通过 ESP-Flash-Download-Tool 烧录

烧录地址表

烧录分区表

7 个分区文件按以下地址依次写入，总占用约 6.7 MB，匹配 8MB Flash 分区方案。

文件名	烧录地址	大小
bootloader.bin	0x0	22 KB
partition-table.bin	0x9000	3 KB
ota_data_initial.bin	0x10000	8 KB
edge_agent.bin	0x20000	2.7 MB
emote_assets.bin	0x3d6000	2.4 MB
system.bin	0x692000	900 KB
storage.bin	0x773000	564 KB

方法一：esptool 命令行烧录

完整命令

python -m esptool \
  --chip esp32s3 -b 460800 \
  --before default_reset \
  --after hard_reset write_flash \
  --flash_mode dio \
  --flash_size 8MB \
  --flash_freq 80m \
  0x0 bootloader.bin \
  0x9000 partition-table.bin \
  0x10000 ota_data_initial.bin \
  0x20000 edge_agent.bin \
  0x3d6000 emote_assets.bin \
  0x692000 system.bin \
  0x773000 storage.bin

使用 flash_args

文件夹内已附带 flash_args 清单，可一键烧录：

python -m esptool --chip esp32s3 -b 460800 write_flash "@flash_args"

烧录波特率 460800，DIO 模式 80MHz 8MB Flash，命令执行完自动硬复位。

方法二：ESP-Flash-Download-Tool 图形化烧录

步骤说明

1. 打开 ESP-Flash-Download-Tool，芯片类型选择 ESP32-S3，工作模式选 Develop（或 Load Mode）
2. 在 SPIDownload 页签逐行加载 7 个 .bin 文件，按上表填入对应地址并勾选
3. 底部参数设置：CrystalFreq 80MHz · FlashMode DIO · FlashSize 8MB
4. 选择正确的 COM 串口，波特率 460800，点击 START 等待进度条跑完
5. 显示 FINISH 绿色即为成功，掌机自动重启进入游戏画面

💡 也可加载配套的 flash_args 自动填充全部地址，或直接拖入整个固件文件夹，省去手工逐行输入。

烧录前的小贴士

• Flash 模式必须为 DIO 80MHz，FlashSize 8MB，PSRAM 配置 Octal 80MHz
• 总占用约 6.7 MB，匹配 partitions_8MB.csv 分区表，不会溢出 8MB Flash
• USB 串口选择 Serial JTAG，Windows 免驱动；首次连接需确认 COM 端口号
• 烧录失败多为波特率过高 —— 可将 -b 460800 降到 -b 115200 重试
• 屏幕旋转方案：swap_xy + mirror_x，逻辑分辨率 320×240（edge_agent 固件内置）

失败问题排查

如果烧录失败，则：

1. 检查硬件焊接，ESP32-S3 是否有 3.3V 供电，各个引脚之间有没有短接虚焊
2. 检查 USB 线缆是否支持数据传输（非纯充电线）
3. 如果烧录时出现 ........，拔掉 USB 后重新插入
4. 尝试降低波特率到 115200 重试
5. 确认 Flash 芯片型号与配置匹配（8MB / DIO / 80MHz）