警告
This document is not updated for ESP32H21 yet, so some of the content may not be correct.
This warning was automatically inserted due to the source file being in the add_warnings_pages list.
配置 ESP32-H21 内置 JTAG 接口
ESP32-H21 内置了 JTAG 电路，无需额外的芯片即可进行调试。只需将 USB 线连接到 D+/D- 引脚即可。对于没有外露 USB 串行 JTAG 连接器的开发板，可以使用 USB 转接线。所需的连接方式将在下一节中介绍。
配置硬件
ESP32-H21 管脚 |
USB 信号 |
|---|---|
GPIO17 |
D- |
GPIO18 |
D+ |
5V |
V_BUS |
GND |
接地 |
请不要将用于 USB 通信的 ESP32-H21 管脚连接到可能会干扰 JTAG 操作的其他硬件上。
配置 USB 驱动程序
JTAG 通信在所有支持的平台上都可工作。Windows 和 Linux 需要额外步骤，具体请参考以下说明。
Windows
Windows 用户可能会遇到 LIBUSB_ERROR_NOT_FOUND 错误，可使用以下任意方法安装驱动程序以解决此问题：
在 ESP-IDF 安装管理器 (EIM) 图形用户界面 (GUI) ，点击
管理安装下方的打开管理面板，之后点击安装驱动程序：
在 EIM GUI 中安装驱动程序
在 PowerShell 运行以下命令，通过 EIM 命令行安装驱动程序：
eim install-drivers在 PowerShell 运行以下命令，通过 idf-env 安装驱动程序：
Invoke-WebRequest 'https://dl.espressif.com/dl/idf-env/idf-env.exe' -OutFile .\idf-env.exe; .\idf-env.exe driver install --espressif
Linux
在 Linux 上，需要添加 OpenOCD udev 规则。方法是将以下 udev 规则文件 放置在 /etc/udev/rules.d 文件夹中。