警告

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.

# 配置其他 JTAG 接口

[English]

关于适配 OpenOCD 和 ESP32-H21 的 JTAG 接口选择问题，请参考 选择 JTAG 适配器 章节。然后按照以下步骤进行设置，使其正常工作。

## 配置 eFuse

ESP32-H21 JTAG 接口默认连接至 内置 USB_SERIAL_JTAG 外设。要使用外部 JTAG 适配器，需将 JTAG 接口切换至 GPIO 管脚。你可以使用 `idf.py` 工具来烧录 eFuse，以完成接口转换。

- 烧录 `DIS_USB_JTAG` eFuse 后，USB_SERIAL_JTAG 和 ESP32-H21 的 JTAG 接口之间的连接将被永久禁用，此后你可以将 JTAG 接口连接到 GPIO2-GPIO5。注意，烧录后，USB_SERIAL_JTAG 的 USB CDC 功能仍然可用，即仍然可以通过 USB CDC 进行烧录和查看日志。

- 烧录 `Not Updated!` eFuse 后，JTAG 接口的选择将由 strapping 管脚 GPIO25 来决定。ESP32-H21 复位时，如果该 strapping 管脚为低电平，JTAG 接口将使用 GPIO2-GPIO5；如果为高电平，USB_SERIAL_JTAG 将被用作 JTAG 接口。

警告

请注意，烧录 eFuse 是一项不可逆的操作，请在开始前谨慎考虑以上选项。

## 配置硬件

1. 找到 JTAG 接口和 ESP32-H21 板上需要相互连接并建立通信的所有管脚或信号。

   ESP32-H2 pins and JTAG signals
   ESP32-H2 Pin | JTAG Signal
   --- | ---
   MTDO / GPIO3 | TDO
   MTDI / GPIO5 | TDI
   MTCK / GPIO4 | TCK
   MTMS / GPIO2 | TMS

2. 检查 ESP32-H21 上用于 JTAG 通信的管脚是否被连接到了其它硬件上，这可能会影响 JTAG 的工作。

3. 连接 ESP32-H21 和 JTAG 接口上的管脚或信号。

## 配置驱动

你可能还需要安装软件驱动，才能使 JTAG 在计算机上正常工作，请参阅你所使用的 JTAG 适配器的有关文档，获取相关详细信息。

在 Linux 中，请务必将 udev 规则文件 复制到 `/etc/udev/rules.d` 目录中，以添加 OpenOCD udev 规则。

## 连接

将 JTAG 接口连接到计算机，打开 ESP32-H21 和 JTAG 接口板上的电源，然后检查计算机是否可以识别到 JTAG 接口。

如需继续设置调试环境，请前往 运行 OpenOCD 章节。

此文档对您有帮助吗？

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

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