警告

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 接口

[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` 文件夹中。

此文档对您有帮助吗？

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

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