ESP-C3入门22. 基于VSCODE使用内置JTAG调试程序
- 一、简介
- 1. 内置 jtag 介绍
- 2. OpenOCD
- 3. 准备工作
- 二、操作步骤
- 1. 接线
- 2. 在VSCode设置端口等信息
- 3. 测试编译烧录
- 三、调试程序
一、简介
1. 内置 jtag 介绍
在ESP32中，内置了一个用于JTAG调试的特殊程序，称为“ESP32 JTAG调试引导模式”。
JTAG（Joint Test Action Group）是一种用于测试和调试电路板的标准接口。在嵌入式系统开发中，JTAG可以用于芯片的调试、程序下载、固件更新等操作。ESP32的JTAG调试引导模式允许通过JTAG接口连接到芯片，以便进行硬件级别的调试和分析。
2. OpenOCD
OpenOCD是一个强大的开源调试工具，支持多种处理器架构和芯片，包括ESP32。它允许开发者通过JTAG接口连接到目标芯片，以进行调试和编程。OpenOCD提供了一组命令行工具和GDB（GNU Debugger）的集成，可以用于单步执行、断点设置、查看寄存器状态、读写内存等调试操作。
开发者可以使用OpenOCD作为调试工具，通过ESP32的JTAG接口连接到ESP32芯片，以进行嵌入式应用程序的调试。为了在OpenOCD中配置ESP32的目标，需要提供一个与目标芯片相关的配置文件（通常称为"target.cfg"或类似的名称）。这个配置文件定义了与芯片通信的JTAG引脚映射、芯片特定的调试功能和寄存器映射等信息。
使用内置 jTAG 时，这个cfg的路径位置大概是如下位置 ：
Espressif\tools\openocd-esp32\v0.12.0-esp32-20230419\openocd-esp32\share\openocd\scripts\board\esp32c3-builtin.cfg
使用VSCODE 的 IDF插件，这个位置不需要手工配置。
3. 准备工作
- ESP32-C3 开发板
- 安装好ESP-IDF环境
- 准备一个ESP32-C3的项目
- VSCODE 安装好ESP-IDF插件
在命令行输入：
openocd --version
有如下输出 ：
openocd --version
Open On-Chip Debugger v0.12.0-esp32-20230419 (2023-04-18-22:02)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
OPENOCD 需要用到 TCP 6666 端口。
二、操作步骤
1. 接线
需要一根USB线，一头插电脑，另一头按线序接MCU。
| USB 引脚 | 典型颜色 | ESP32-C3 引脚 |
|---|---|---|
| D- | 白 | GPIO18 |
| D+ | 绿 | GPIO19 |
| V_BUS | 红 | 5V |
| GND | 黑 | GND |
USB插入电脑，提示设置设备：
设置成功后，在系统设备列表可以看到 SUB JTAG/serial debug unit：
2. 在VSCode设置端口等信息
点击VSCODE下方按钮，设置对应的串口，并选择内置USB-JTAG（ESP32-C3 chip(via builtin USB-JTAG）。
禁用内存保护 ：
设置日志通过 USB Serial/JTAG 输出：
3. 测试编译烧录
点击VSCODE的 ESP-IDF Build, Flash and Monitor。
等待编译、烧录、查看USB日志输出 。
三、调试程序
点击VSCODE上的 Launch：
可以设置断点并查看寄存器值、变量值等。
