Как исправить ESP32S3 JTAG: Error: esp_usb_jtag: could not find or open device!

Проблема

При попытке использовать JTAG на ESP32S3 с внутренним USB JTAG с помощью команды, например,

idf_openocd.sh

idf.py openocd

idf.py openocd

вы видите ошибку, подобную этой:

openocd_output.txt

Executing action: openocd
Note: OpenOCD cfg not found (via env variable OPENOCD_COMMANDS nor as a --openocd-commands argument)
OpenOCD arguments default to: "-f board/esp32s3-builtin.cfg"
OpenOCD started as a background task 3169083
Executing action: post_debug
Open On-Chip Debugger v0.12.0-esp32-20250422 (2025-04-22-13:02)
Licensed under GNU GPL v2
For bug reports, read
        http://openocd.org/doc/doxygen/bugs.html
Info : only one transport option; autoselecting 'jtag'
Info : esp_usb_jtag: VID set to 0x303a and PID to 0x1001
Info : esp_usb_jtag: capabilities descriptor set to 0x2000
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Error: esp_usb_jtag: could not find or open device!
/home/uli/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250422/openocd-esp32/share/openocd/scripts/target/esp_common.cfg:9: Error:
Traceback (most recent call last):
  File "/home/uli/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250422/openocd-esp32/share/openocd/scripts/target/esp_common.cfg", line 9, in script
"openocd" exited with 1

Executing action: openocd
Note: OpenOCD cfg not found (via env variable OPENOCD_COMMANDS nor as a --openocd-commands argument)
OpenOCD arguments default to: "-f board/esp32s3-builtin.cfg"
OpenOCD started as a background task 3169083
Executing action: post_debug
Open On-Chip Debugger v0.12.0-esp32-20250422 (2025-04-22-13:02)
Licensed under GNU GPL v2
For bug reports, read
        http://openocd.org/doc/doxygen/bugs.html
Info : only one transport option; autoselecting 'jtag'
Info : esp_usb_jtag: VID set to 0x303a and PID to 0x1001
Info : esp_usb_jtag: capabilities descriptor set to 0x2000
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Error: esp_usb_jtag: could not find or open device!
/home/uli/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250422/openocd-esp32/share/openocd/scripts/target/esp_common.cfg:9: Error:
Traceback (most recent call last):
  File "/home/uli/.espressif/tools/openocd-esp32/v0.12.0-esp32-20250422/openocd-esp32/share/openocd/scripts/target/esp_common.cfg", line 9, in script
"openocd" exited with 1

При выводе списка USB-устройств с помощью lsusb вы видите устройство ESP32S3 как 303a:0009:

lsusb_output.txt

Bus 001 Device 099: ID 303a:0009 Espressif ESP32-S3

Bus 001 Device 099: ID 303a:0009 Espressif ESP32-S3

Решение

Проблема заключается в том, что OpenOCD ищет 303a:1001 (см. VID set to 0x303a and PID to 0x1001, исходный код на GitHub), но устройство фактически 303a:0009.

Причина этого в том, что ESP32S3 не находится в режиме bootloader.

Вам нужно перевести ESP32S3 в режим bootloader, удерживая кнопку BOOT при нажатии кнопки EN. Это сбросит устройство и переведёт его в режим bootloader.