Windows 环境下，使用 ESP32-S3 USB 接口进行 JTAG 调试的流程

前提

• 在 windows 上安装 esp-idf CMD 软件编译环境，可参考“Windows 上搭建 ESP-IDF SDK 编译环境 + Visual Studio Code 软件编程环境”说明。
• 硬件上使用 ESP32-S3 USB 接口与 PC 端建立连接，为方便测试，可使用官方发布的 ESP32-S3-DevKitC-1 开发板上的 USB 接口来进行测试。

JTAG 调试详细步骤说明

1 运行 openocd

• 由于 esp-idf CMD 编译环境已经安装好 openocd 的环境，因此不需要手动安装，只需要打开 esp-idf CMD 终端窗口即可。
  

• 需要找到本地 PC 端的 esp32s3-builtin.cfg 文件，保证文件路径正确
  

• 运行如下指令启动 OpenOCD 环境

openocd -f C:\Users\caiguanhong\.espressif\tools\openocd-esp32\v0.10.0-esp32-20211111\openocd-esp32\share\openocd\scripts\board\esp32s3-builtin.cfg

2 编译、下载工程固件

• 重新开启一个新的终端环境，可以再次打开 esp-idf CMD 终端窗口

idf.py build

idf.py flash

3 在当前调试工程下，创建一个名为 gdbinit 的配置文件，写入如下内容:

可参见 “使用命令行调试”说明。

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

4 准备好启动 GDB，请在新的终端环境中输入以下命令来运行待调试工程下的 build 文件夹下的 elf 文件，elf 文件路径要正确：

可参见“使用命令行调试”说明。

• 运行如下指令启用 GDB 调试

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

• 在 GDB 中断环境下，设置和清除断点

  • 使用 gdbbreak 33 命令设置断点行
  • 使用 gdb c 命令运行断点

• 更多调试指导请参见：

  • 浏览代码，查看堆栈和线程

  • 设置和清除断点

  • 暂停和恢复应用程序的运行

  • 单步执行代码

  • 查看并设置内存

  • 观察和设置程序变量

  • 设置条件断点

5 openocd 终端将打印如下日志：