# 配置 ESP32-H21 内置 JTAG 接口

[English]

ESP32-H21 内置了 JTAG 电路，无需额外的芯片即可进行调试。只需将 USB 线连接到 D+/D- 引脚即可。对于没有外露 USB 串行 JTAG 连接器的开发板，可以使用 USB 转接线。所需的连接方式将在下一节中介绍。

## 配置硬件

ESP32-H21 管脚及 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` 文件夹中。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。