ESP32-S3 Built-in debugging support

[maxgerhardt]

Per https://community.platformio.org/t/esp32-s3-jtag-debugging-over-usb/28182

ESP32S3 boards, similiar to ESP32C3 boards in #651 (comment), have a USB JTAG configuration built into them:

https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/api-guides/jtag-debugging/index.html#selecting-jtag-adapter

PlatformIO should use https://github.com/espressif/openocd-esp32/blob/master/tcl/board/esp32s3-builtin.cfg to support it.

[Jason2866]

@maxgerhardt (not at home so asking) Is just the change "openocd_target": "esp32s3.cfg" in boards.json to interface/esp_usb_jtag.cfg not working?

[maxgerhardt]

Sadly I have no board to test, but essentially I've recommended the user to esp32s3-builtin.cfg.

[peteDDD]

Any further update on this?

[Jason2866]

Tried and does work. BUT there is general issue in Platformio at the moment (does hit ESP32 with ESP-PROG too). You can not upload and debug. Upload. After that use debug without upload. Works with S3 and C3.

[Pixel-Soup]

Hi,
I tried to run Platformio debug on the esp32-s3 with the on-chip usb jtag without success. Upload using esp-builtin works. Blink program runs fine after a manual reset. When I run the debugger, openocd initialization looks fine until it is suppose to execute tbreak setup. It does not break. If I press the "pause" button, it reports:

Error: FreeRTOS maximum used priority is unreasonably big, not proceeding: 231
Program
received signal SIGINT, Interrupt.
0x40041a76 in ?? ()

I have openocd v0.11.0-esp32-20220706. Esp-Prog works fine (on a non-S3 board), so I assume the issue is only with the S3 usb jtag. Has anyone else get theirs working? Any help would be appreciated.

[Hieromon]

Is this issue related to #793?
I too have not been able to solve this problem. I think the solution with the updated builtin.cfg is not enough and it would be undesirable to close the topic to continue the investigation. We need to narrow down the conditions under which the problem occurs.

[Pixel-Soup]

Unfortunately, my setup fails 100% of the time. Have you been able to make it work sometimes?
My Esp-prog has fail in the same way, but was corrected with a Platformio update. I see a few people reporting success with the built-in jtag, but I have not been able to duplicate their results, using their procedures.

[maxgerhardt]

After that use debug without upload

So y'all are you using

debug_tool = esp-builtin
debug_load_mode = manual

in the platformio.ini, use the regular "Upload" task, then start debugging?

[Pixel-Soup]

Yes. Also, I start the debugger using the Platformio "Debug without uploading" menu, after doing a reset with the boot button pressed to put the chip in the usb jtag mode.

[Jason2866]

@maxgerhardt @Pixel-Soup got debugging working WITH uploading in my fork for ESP32-S3 inbuilt jtag.

platform = https://github.com/tasmota/platform-espressif32/releases/download/v2.0.5.2/platform-espressif32-2.0.5.2.zip

EDIT: The issue was firmware on wrong address loaded (we have a factory firmware at 0x10000, not the firmware). Maybe you need to use our boards json. Or change yours accordingly https://github.com/arendst/Tasmota/tree/development/boards
We build all for 4MB flash and resize the filesystem right after booting Tasmota to the real flash size.

[Pixel-Soup]

I just tried that without success. Here's the messages below. The tool manager complained about the files sizes not matching, and then downloaded from another mirror site. I don't know if that is problematic, but it no longer recognizes esp-builtin as a debug tool.

=====================================================
Installing https://github.com/tasmota/arduino-esp32/releases/download/2.0.5.2/framework-arduinoespressif32.zip
Downloading [####################################] 100%
Unpacking [####################################] 100%
Tool Manager: framework-arduinoespressif32@2.0.5 has been installed!
Tool Manager: Installing espressif/toolchain-xtensa-esp32 @ 8.4.0+2021r2-patch5
Downloading [####################################] 100%

Tool Manager: Warning! Package Mirror: The size (79675042 bytes) of downloaded file 'toolchain-xtensa-esp32-windows_amd64-8.4.0+2021r2-patch5.tar.gz' is not equal to
remote size (120571045 bytes)
Tool Manager: Looking for another mirror...
Downloading [####################################] 100%
Unpacking [####################################] 100%
Tool Manager: toolchain-xtensa-esp32@8.4.0+2021r2-patch5 has been installed!

Tool Manager: Installing https://github.com/tasmota/esptool/releases/download/v4.3.1/esptool-4.3.1.zip
Downloading [####################################] 100%
Unpacking [####################################] 100%
Tool Manager: tool-esptoolpy@1.40301.221017 has been installed!
Verbose mode can be enabled via -v, --verbose option
DebugInvalidOptionsError: Unknown debug tool esp-builtin. Please use one of cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa or custom:

[Jason2866]

@Pixel-Soup Weird, since i use esp-builtin. Delete the hidden folder .platformio.
So Platformio installs everything fresh and no old stuff is left.

[Pixel-Soup]

I reinstalled Platformio and managed to get esp-builtin recognized again. Unfortunately, debugging still didn't work. The debugger runs, but seems to put the breakpoint where the code isn't running.
Can you clarify what the issue is? I didn't see any obvious settings in the Tasmota board jsons which I could incorporate to possibly fix the problem.

So far, the best combination for the S3 is platform = espressif32. The code uploads over the builtin jtag and runs. When I used the Tasmota branch, it uploads, but no longer ran.

[Jason2866]

Mhhh