ESP32-S3调试求助：ESP-PROG失败，内置JTAG启动GDB遇文件缺失

一、ESP-PROG调试失败问题解决 #

你当前的核心错误是误用了内置JTAG的配置文件启动ESP-PROG，正确操作如下：

• 替换OpenOCD启动命令：ESP-PROG需要专用接口配置，执行以下命令：

  openocd -f interface/ftdi/esp_prog.cfg -f target/esp32s3.cfg
  

• 恢复熔丝设置：STRAP_JTAG_SEL熔丝是为内置JTAG设计的，ESP-PROG无需该熔丝，执行命令恢复：

  espefuse.py burn_efuse STRAP_JTAG_SEL 0
  

• 重新检查硬件连接：确认ESP-PROG与ESP32-S3的GND共地，JTAG引脚对应无误（TDI-GPIO41、TDO-GPIO40、TCK-GPIO39、TMS-GPIO42），且VCC接3.3V。

二、内置JTAG的gdbinit文件问题 #

找不到gdbinit文件的解决方法：

• 手动创建gdbinit：在项目根目录新建gdbinit文件，写入以下内容：

  target remote :3333
  set remote hardware-watchpoint-limit 2
  mon reset halt
  flushregs
  

• 自动生成gdbinit：在项目根目录执行ESP-IDF命令生成适配文件：

  idf.py gdbinit
  

• 指定路径运行GDB：确保命令在项目根目录执行，或明确指定gdbinit路径：

  xtensa-esp32s3-elf-gdb -x ./gdbinit build/blink.elf
  

三、VSCode下ESP32-S3调试配置 #

Espressif官方支持VSCode调试，通过ESP-IDF扩展实现：

1. 安装VSCode扩展市场中的Espressif IDF扩展
2. 配置扩展：打开命令面板（Ctrl+Shift+P），运行ESP-IDF: Configure ESP-IDF Extension，选择本地ESP-IDF v5.3的安装路径
3. 生成调试配置：
   • 点击左侧调试图标，选择「创建launch.json文件」，选择「ESP-IDF」模板
   • 根据调试需求修改launch.json中的openOcdConfigs：
     • 使用ESP-PROG时，修改为：["interface/ftdi/esp_prog.cfg", "target/esp32s3.cfg"]
     • 使用内置JTAG时，保持默认：["board/esp32s3-builtin.cfg"]
4. 启动调试：点击调试按钮，扩展会自动启动OpenOCD和GDB，无需手动执行命令

内容的提问来源于stack exchange，提问作者ADL