ESP-C3入门22. 基于VSCODE使用内置JTAG调试程序
- 一、简介
-
- [1. 内置 jtag 介绍](#1. 内置 jtag 介绍)
- [2. OpenOCD](#2. OpenOCD)
- [3. 准备工作](#3. 准备工作)
- 二、操作步骤
-
- [1. 接线](#1. 接线)
- [2. 在VSCode设置端口等信息](#2. 在VSCode设置端口等信息)
- [3. 测试编译烧录](#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插件
在命令行输入:
bash
openocd --version
有如下输出 :
bash
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:
可以设置断点并查看寄存器值、变量值等。