# Configure ESP32-H2 Built-in JTAG Interface

[中文]

ESP32-H2 has built-in JTAG circuitry and can be debugged without any additional chip. Only a USB cable connected to the D+/D- pins is necessary. For dev kits without an exposed USB Serial Jtag connector, a USB breakout cable can be used. The necessary connections are shown in the following section.

## Configure Hardware

ESP32-H2 pins and USB signals
ESP32-H2 Pin | USB Signal
--- | ---
GPIO26 | D-
GPIO27 | D+
5V | V_BUS
GND | Ground

Please verify that the ESP32-H2 pins used for USB communication are not connected to some other HW that may disturb the JTAG operation.

## Configure USB Drivers

JTAG communication should work on all supported platforms. Windows users might get LIBUSB_ERROR_NOT_FOUND errors. Please use version 2.8 (or newer) of the ESP-IDF Tools Installer and select the driver "Espressif - WinUSB support for JTAG (ESP32-C3/S3)" in order to resolve this issue. If you do not want to re-run the installer then the same can be achieved with idf-env by running the following command from PowerShell:

    Invoke-WebRequest 'https://dl.espressif.com/dl/idf-env/idf-env.exe' -OutFile .\idf-env.exe; .\idf-env.exe driver install --espressif

On Linux adding OpenOCD udev rules is required and is done by placing the following udev rules file in the `/etc/udev/rules.d` folder.

Provide feedback about this document