Skip to content

Support JTAG debugging in Arduino IDE 2.0 #7295

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 5 commits into from
Dec 9, 2022
Merged

Support JTAG debugging in Arduino IDE 2.0 #7295

merged 5 commits into from
Dec 9, 2022

Conversation

me-no-dev
Copy link
Member

@me-no-dev me-no-dev commented Sep 23, 2022 •
edited
Loading

General Info

  • Currently the following debug methods are supported on all boards (menu option is available for the official "Dev Module" boards):
    • ESP32: FTDI Adapter (ESP-Prog or compatible)
    • ESP32-S2: FTDI Adapter (ESP-Prog or compatible)
    • ESP32-S3: Built-In USB JTAG (Requires proper USB Mode to be selected)
    • ESP32-C3: Built-In USB JTAG

Known issues

  • Debug sessions can not be restarted (not clear what is the cause yet)
  • If debug session is closed or fails, openocd is left running by the IDE and to get around that, you either need to manually kill the process or restart the IDE (Issue seems to be in cortex-debug, but newer "fixed" versions also fail)

To-Do

  • Update the release script to update the path to openocd-esp32 in platform.txt
  • Update the release script to add tools/ide-debug to the archive
  • Update the lib-builder to skip adding -Os to the build flags ref
  • Update the lib-builder to remove CONFIG_FREERTOS_WATCHPOINT_END_OF_STACK from ESP32-C3 sdkconfig ref
  • Find out what is the issue on C3 and how/when it will be fixed
  • Find out why JTAG Port menu can not update the openocd script
  • Add default OpenOCD config for all boards
  • Find out if it's possible to make debug target restart working

igrr
igrr reviewed Sep 24, 2022
View reviewed changes
@VojtechBartoska VojtechBartoska added the IDE: Arduino IDE Issue relates to Arduino IDE label Sep 26, 2022
@VojtechBartoska VojtechBartoska added this to the 2.0.6 milestone Sep 26, 2022
@VojtechBartoska VojtechBartoska added the Type: Feature request Feature request for Arduino ESP32 label Sep 26, 2022
@VojtechBartoska
Copy link
Contributor

Try to find if there is any issues upstream @VojtechBartoska

@me-no-dev me-no-dev mentioned this pull request Sep 29, 2022
Merged
@VojtechBartoska
Copy link
Contributor

  • create a Documentation/Guide, "How to debug in Arduino IDE 2.0".

@VojtechBartoska VojtechBartoska added the Priority: High 🗻 Issues with high priority which needs to be solved first. label Dec 5, 2022
@VojtechBartoska
Copy link
Contributor

@me-no-dev Can you please add some brief documentation to this? Thanks

SuGlider
SuGlider approved these changes Dec 7, 2022
View reviewed changes
Copy link
Collaborator

@SuGlider SuGlider left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@me-no-dev
I tested it using Win11, IDE 2.0.3 with these boards:

  • ESP32 using FTDI JTAG from ESP-WROVER-KIT
  • ESP32S3 and ESP32C3 using USB JTAG

All fine. It debugs using the new IDE.

@P-R-O-C-H-Y
Copy link
Member

Overview from my testing. Tested on MacOS Ventura 13.0.1

Test / Device ESP32 - DevKitC_V4 ESP32S2 - DevKitC-1_V10.1 ESP32C3 - DevKitC-2_V1.1 ESP32S3 - DevKitC-1_V1.0
JTAG used esp-prog esp-prog integrated integrated
Hit 1st breakpoint after sketch upload and debug start Yes Yes Yes Yes / sometimes missed (need to reset device and re-set breakpoint while restarting)
Breakpoint hit after device reset (debug restart) Yes Yes Yes Breakpoints need to be re-set to work
More breakpoints Sometimes issues when having more than 1 breakpoint 5 breakpoints working and fast If I have 2 breakpoints set, after device reset, when it should hit the 2nd breakpoint, error of Duplicate Breakpoint address: 0x420000da (BP 20) Error + warning when 2 breakpoints are set, but no affect on debugging.Error: [esp32s3.cpu0] DSR (8080CC19) indicates DIR instruction generated an overrun!Warn : [esp32s3.cpu0] Failed reading 32 bytes at address 0x420012ec
Debug stop / run debug Works Works Works Works
Debug stop / upload sketch / run debug Works Works Works Works
AutoStops in Setup() Yes Yes No No

@me-no-dev me-no-dev merged commit 5b61930 into master Dec 9, 2022
@me-no-dev me-no-dev deleted the feature/ide_2_debug branch December 9, 2022 22:58
@ajsb85
Copy link

ajsb85 commented Jan 5, 2023 •
edited
Loading

Hi, I found this error in the new IDE 2.0.3 and the ESP32 platform 2.0.6

Error: 226 175 libusb_helper.c:190 jtag_libusb_open(): libusb_open() failed with LIBUSB_ERROR_NOT_FOUND
Error: 227 177 esp_usb_jtag.c:651 esp_usb_jtag_init(): esp_usb_jtag: could not find or open device!

Error: 230 178 riscv.c:1752 riscv_get_gdb_arch(): Unsupported xlen: -1
Error: 231 178 esp_semihosting.c:78 target_to_esp_semihost_data(): Unknown target arch!

Full log:
https://gist.github.com/ajsb85/b21ace90737a4b946ef53a4982758742

@me-no-dev
Copy link
Member Author

@ajsb85 did you connect the hardware USB port of the C3? Log shows that computer was not able to find the port

@ajsb85
Copy link

ajsb85 commented Jan 5, 2023 •
edited
Loading

Yes (ESP32-C3: Built-In USB JTAG)

I changed the driver version after follow this procedure:

https://docs.espressif.com/projects/esp-idf/en/v5.0/esp32c3/api-guides/jtag-debugging/configure-builtin-jtag.html#configure-usb-drivers

BTW this launch.json file looks good for you?
https://gist.github.com/ajsb85/387e10bdc3075d3ba50b2157ab06822f

Now I got this error:

Failed to launch GDB: Remote replied unexpectedly to 'vMustReplyEmpty': PacketSize=4000;qXfer:memory-map:read+;qXfer:features:read+;qXfer:threads:read+;QStartNoAckMode+;vContSupported+ (from target-select extended-remote localhost:50000)

Full logs:

https://gist.github.com/ajsb85/d1a07b71d549d1f02ca01983554a1398

Thank you in advance for the support.

@me-no-dev
Copy link
Member Author

@P-R-O-C-H-Y can you have someone from debug team have a look at the logs?

@ajsb85 that is rather strange. JTAG works well on C3 here without any modifications, though since you are on Windows, I guess fixing WinUSB driver was necessary.

@SuGlider what is your experience?

@mjs513 mjs513 mentioned this pull request Jun 20, 2023
Closed
@Xylopyrographer
Copy link
Contributor

@P-R-O-C-H-Y In this comment: #7295 (comment)

  1. Did you need to install any drivers or other components on your Mac to get the ESP-PROG working?
  2. Could you confirm the pin-to-pin connections from the ESP-PROG to the ESP32 - DevKitC_V4 and the ESP32S2 - DevKitC-1_V10.1?
  3. Confirming, the ESP32 - DevKitC_V4 and ESP32S2 - DevKitC-1_V10.1 boards were connected to your Mac via the board USB connector and concurrently to the ESP-PROG USB ports?
  4. Did the power up sequence of the ESP-PROG and the boards seem to matter?
  5. Were the ESP-PROG and the boards were powered up before starting the IDE?
  6. Could you confirm the Arduino IDE version you tested on?
  7. Could you also confirm the version of the arduino-esp32 core it was tested on?
  8. Did choosing or not the "Optimize for Debugging" option matter?

I'm having very little success keeping the debugger stable with either an external FTDI device or with an integrated connection. Tested so far on an ESP32-WROOM-32 based kit and -S3 and -C3 boards.

Also keep seeing this crop up in the debugger console logs:
/Users/ficeto/Desktop/ESP32/ESP32S2/esp-idf-public/components/esp_pm/pm_impl.c: No such file or directory. (No account on my machine with user "ficeto" so something is hard coded in there somewhere...)

When this all gets sorted, it'll make good background for the Debugging Tutorial I'll write!

Appreciate your work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@igrr igrr igrr left review comments

@SuGlider SuGlider SuGlider approved these changes

@P-R-O-C-H-Y P-R-O-C-H-Y Awaiting requested review from P-R-O-C-H-Y

@PilnyTomas PilnyTomas Awaiting requested review from PilnyTomas

Assignees

@me-no-dev me-no-dev

Labels
IDE: Arduino IDE Issue relates to Arduino IDE Priority: High 🗻 Issues with high priority which needs to be solved first. Type: Feature request Feature request for Arduino ESP32
Projects
Arduino ESP32 Core Project Roadmap
Status: Done
Milestone
2.0.6
Development

Successfully merging this pull request may close these issues.
7 participants
@me-no-dev @VojtechBartoska @P-R-O-C-H-Y @ajsb85 @Xylopyrographer @igrr @SuGlider