Jak opravit ESP32S3 JTAG: Error: esp_usb_jtag: could not find or open device!

Problém

Při pokusu použít JTAG na ESP32S3 s interním USB JTAG pomocí příkazu jako

idf_openocd.sh

idf.py openocd

idf.py openocd

vidíte chybu jako je tato:

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

Když vypíšete USB zařízení pomocí lsusb, vidíte ESP32S3 zařízení jako 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

Řešení

Problém zde je, že OpenOCD hledá 303a:1001 (viz VID set to 0x303a and PID to 0x1001, zdrojový kód na GitHubu) ale zařízení je skutečně 303a:0009.

Důvodem je, že ESP32S3 není v bootloader módu..

Potřebujete přepnout ESP32S3 do bootloader módu podržením tlačítka BOOT while stisknete tlačítko EN. To resetuje zařízení a přepne ho do bootloader módu.